Difference between revisions of "Configuration"
m (Text replacement - "ub-director" to "ubdirector") |
|||
(23 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | This | + | This page is part of the [[Getting Started]] Section. It gives some insight into the configuration of BaseX. |
− | It gives some | ||
==Configuration Files== | ==Configuration Files== | ||
Line 8: | Line 7: | ||
* <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>.basexhistory</code> contains commands that have been typed in most recently. | * <code>.basexhistory</code> contains commands that have been typed in most recently. | ||
− | * <code>.basexhome</code> can be | + | * An empty <code>.basexhome</code> file can be added to a directory to mark it as [[#Home Directory|home directory]]. |
− | |||
− | Note that | + | Note that: |
+ | |||
+ | * Depending on your OS and configuration, files and folders with a '.' prefix may be hidden. | ||
+ | * In the [[Web Application]] context, options can be defined in the <code>web.xml</code> file. | ||
==Home Directory== | ==Home Directory== | ||
− | As BaseX is distributed in different flavors, and may be started from different locations, it dynamically determines its home directory: | + | As BaseX is distributed in different flavors, and as it may be started from different locations, it dynamically determines its home directory: |
− | * First, the '''system property''' {{Code|org.basex.path}} is checked. If it contains a value, it is chosen as directory path. | + | * First, the '''Java system property''' {{Code|org.basex.path}} is checked. If it contains a value, it is chosen as directory path. |
− | * If not, the '''current user directory''' (defined by the system property {{Code|user.dir}}) is | + | * If not, the '''current user directory''' (defined by the system property {{Code|user.dir}}) is selected if the {{Code|.basex}} or {{Code|.basexhome}} file is found in this directory. |
− | * | + | * If not, the '''application directory''' (the folder in which BaseX is located) is chosen if one of these two files is found in that directory. |
− | * In all other cases, the '''user | + | * In all other cases, a {{Code|basex}} subdirectory in the '''user home directory''' will be returned. The user home directory is retrieved via the {{Code|HOME}} environment variable, or (if unassigned) the Java system property {{Code|user.home}}. |
+ | |||
+ | If BaseX is used in an embedded environment (such as a servlet in a [[Web Application]]), it may not immediately be clear which directory was picked. You can run the XQuery expression <code>Q{java:org.basex.util.Prop}HOMEDIR()</code> to find out. | ||
==Database Directory== | ==Database Directory== | ||
− | + | [[Databases]] consists of several binary files. These are located in a directory named by the name of the database. The database root directory is named {{Code|data}}. | |
− | |||
− | |||
The database path can be changed as follows: | The database path can be changed as follows: | ||
* GUI: Choose ''Options'' → ''Preferences'' and choose a new database path. | * GUI: Choose ''Options'' → ''Preferences'' and choose a new database path. | ||
− | * General: edit the | + | * General: edit the {{Option|DBPATH}} option in the {{Code|.basex}} configuration file |
− | '''Note:''' Existing databases will not be | + | '''Note:''' Existing databases will not automatically be moved to the new destination. |
==Log Files== | ==Log Files== | ||
− | Log files are stored in text format in a <code>.logs</code> | + | Log files are stored in text format in a <code>.logs</code> subdirectory of the database folder (see [[Logging]] for more information). |
=Changelog= | =Changelog= | ||
+ | |||
+ | ;Version 9.0 | ||
+ | |||
+ | * Updated: Detection and configuration of home directory and subdirectories. | ||
;Version 8.0 | ;Version 8.0 | ||
− | * Updated: {{Code|.basexperm}} is obsolete. | + | * Updated: {{Code|.basexperm}} is obsolete. Users are now stored in {{Code|users.xml}} in the database directory (see [[User Management]] for more information). |
;Version 7.7 | ;Version 7.7 | ||
− | * Updated: | + | * Updated: The {{Code|.basexhome}} file marks a folder as [[#Home Directory|home directory]]. |
− | |||
− |
Latest revision as of 15:59, 25 July 2022
This page is part of the Getting Started Section. It gives some insight into the configuration of BaseX.
Configuration Files[edit]
BaseX maintains some configuration files, which are stored in the project’s Home Directory:
.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..basexhistory
contains commands that have been typed in most recently.- An empty
.basexhome
file can be added to a directory to mark it as home directory.
Note that:
- Depending on your OS and configuration, files and folders with a '.' prefix may be hidden.
- In the Web Application context, options can be defined in the
web.xml
file.
Home Directory[edit]
As BaseX is distributed in different flavors, and as it may be started from different locations, it dynamically determines its home directory:
- First, the Java system property
org.basex.path
is checked. If it contains a value, it is chosen as directory path. - If not, the current user directory (defined by the system property
user.dir
) is selected if the.basex
or.basexhome
file is found in this directory. - If not, the application directory (the folder in which BaseX is located) is chosen if one of these two files is found in that directory.
- In all other cases, a
basex
subdirectory in the user home directory will be returned. The user home directory is retrieved via theHOME
environment variable, or (if unassigned) the Java system propertyuser.home
.
If BaseX is used in an embedded environment (such as a servlet in a Web Application), it may not immediately be clear which directory was picked. You can run the XQuery expression Q{java:org.basex.util.Prop}HOMEDIR()
to find out.
Database Directory[edit]
Databases consists of several binary files. These are located in a directory named by the name of the database. The database root directory is named data
.
The database path can be changed as follows:
- GUI: Choose Options → Preferences and choose a new database path.
- General: edit the
DBPATH
option in the.basex
configuration file
Note: Existing databases will not automatically be moved to the new destination.
Log Files[edit]
Log files are stored in text format in a .logs
subdirectory of the database folder (see Logging for more information).
Changelog[edit]
- Version 9.0
- Updated: Detection and configuration of home directory and subdirectories.
- Version 8.0
- Updated:
.basexperm
is obsolete. Users are now stored inusers.xml
in the database directory (see User Management for more information).
- Version 7.7
- Updated: The
.basexhome
file marks a folder as home directory.