Difference between revisions of "Configuration"

From BaseX Documentation
Jump to navigation Jump to search
Line 19: Line 19:
 
==Configuration Files==
 
==Configuration Files==
  
BaseX uses three configuration files, which are stored in the [[Configuration Files#Home directory|Home directory]]:
+
BaseX uses three configuration files, which are stored in the [[Configuration Files#Home directory|Home Directory]]
 +
(note that, depending on your OS and configuration, files and folders with a '.' prefix may be hidden):
  
 
* <code>.basex</code> contains all options that are relevant for running the server or standalone versions of BaseX.
 
* <code>.basex</code> contains all options that are relevant for running the server or standalone versions of BaseX.
 
* <code>.basexgui</code> defines all options relevant to the BaseX GUI.
 
* <code>.basexgui</code> defines all options relevant to the BaseX GUI.
 
* <code>.basexperm</code> contains user name, passwords, and permissions.
 
* <code>.basexperm</code> contains user name, passwords, and permissions.
 
By default, all files stored in the home directory. They can be placed in the application directory as well.
 
  
 
==User and Log Files==
 
==User and Log Files==

Revision as of 01:11, 24 January 2011

Home Directory

As BaseX is a portable application it searches for the location of the home directory by itself.
There are three opportunities for the home directory:

  • Users home directory: In standard case the users home directory is chosen to store the BaseX configuration and database files in it. So if you didn't change anything, all the BaseX files can be found in this location.
  • Working directory: This directory is chosen if configuration files of BaseX are found in it. So move the configuration files to the working directory if you want to have it as home directory.
  • Application directory: This directory is chosen if configuration files of BaseX are found in the application directory. This is especially for people using the windows installer of BaseX.

Database Directory

A database in BaseX consists of several files, which are all bundled in a folder with the database name.
All of these files are stored in a BaseXData directory in the home directory.
The path can be changed in the following ways:

  • GUI: Choose OptionsPreferences and choose a new database path.
  • Server/Standalone: SET DBPATH [path]

Note: After having changed the database path, all existing databases have to be manually moved to the new location.

Configuration Files

BaseX uses three configuration files, which are stored in the Home Directory (note that, depending on your OS and configuration, files and folders with a '.' prefix may be hidden):

  • .basex contains all options that are relevant for running the server or standalone versions of BaseX.
  • .basexgui defines all options relevant to the BaseX GUI.
  • .basexperm contains user name, passwords, and permissions.

User and Log Files

The global users are stored in the .basexperm file in the home directory as the configuration files. Local users and permissions are stored in the meta data of the database, so they don't need an extra file.
All log files are stored in text format in the home directory BaseXData/.logs.