Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
A database in BaseX [[Databases]] consists of several binary files, which . These are located in a directory named by the name of the database.If the user’s home directory has been chosen as base directory, the The database directories will be planted in a{{Code|BaseXData}} directory. Otherwise, the root directory will be is named {{Code|data}}.
→Home Directory
* <code>.basexgui</code> defines all options relevant to the BaseX GUI.
* <code>.basexhistory</code> contains commands that have been typed in most recently.
* An empty <code>.basexhome</code> file can be created by added to a user directory to mark a folder it as [[#Home Directory|home directory]]. Its contents do not matter, so it is usually empty.
Note that:
==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 '''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 chosen 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 foundin that directory.* 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 (defined in if unassigned) the Java system property {{Code|user.home}}) is chosen.
If BaseX is used in an embedded environment (such as a servlet in a [[Web Application]]), it may not immediately be clear what which directory was chosen. In this case, you You can run the XQuery expression <code>Q{org.basex.util.Prop}USERHOMEHOMEDIR()</code> to find out.
==Database Directory==
The database path can be changed as follows:
* GUI: Choose ''Options'' → ''Preferences'' and choose a new database path.
* General: edit the <code>[[Options#DBPATH{{Option|DBPATH]]</code> }} option in the {{Code|.basex}} configuration file
'''Note:''' Existing databases will not automatically be automatically moved to the new destination.
==Log Files==
=Changelog=
;Version 9.0
* Updated: Detection and configuration of home directory and subdirectories.
;Version 8.0
;Version 7.7
* Updated: the The {{Code|.basexhome}} file marks a folder as [[#Home Directory|home directory]].
