Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
{{Mark|Updated with Version 9.0:}} As BaseX is distributed in different flavors, and as it may be started from different locations, it dynamically determines its home directory:
{{Mark|Updated with Version 9.0::}}
→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==
* 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 (if unassigned), from the Java system property {{Code|user.home}}. Before {{Version|9.0}}, the home directory itself was returned.
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==
[[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:
* 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 moved to the new destination.
=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]].
