Difference between revisions of "Configuration"

From BaseX Documentation
Jump to navigation Jump to search
Line 12: Line 12:
 
All of these files are stored in a <code>BaseXData</code> directory in the home directory. <br />
 
All of these files are stored in a <code>BaseXData</code> directory in the home directory. <br />
 
The path can be changed in the following ways:
 
The path can be changed in the following ways:
*[[GUI Tutorial|GUI]]: Choose ''Options'' → ''Preferences'' and choose a new database path
+
*[[GUI Tutorial|GUI]]: Choose ''Options'' → ''Preferences'' and choose a new database path.
 
*[[Server Tutorial|Server]]/[[Standalone Tutorial|Standalone]]: <code>SET DBPATH [path]</code>
 
*[[Server Tutorial|Server]]/[[Standalone Tutorial|Standalone]]: <code>SET DBPATH [path]</code>
  

Revision as of 01:08, 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:

  • .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.

By default, all files stored in the home directory. They can be placed in the application directory as well.

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.