Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
* The '''current working directory''' will If BaseX is used in an embedded environment (such as a servlet in a [[Web Application]]), it may not immediately be selected if the configuration files are found in this clear which directorywas chosen. This way, you You can define local settings, which will be ignored if you run BaseX from another directorythe XQuery expression <code>Q{org.* Second, the '''application directory''' is checked for configuration filesbasex. This directory will be your home directory if you have used the Windows Installer to get BaseX runningutil.* In all other cases, the '''user's home directory''' is chosen Prop}HOMEDIR()</code> to store the BaseX configuration and database filesfind out.
A database in BaseX [[Databases]] consists of several binary files, which . These are all bundled located in a folder with directory named by the name of the database name.By default, all of these files are stored in a The database root directory in the home directory, which is named<code>BaseXData</code>. If you use the Windows installer, this directory will be named <code>{{Code|data</code>,and reside in the application directory}}.
Note* Updated: After having changed {{Code|.basexperm}} is obsolete. Users are now stored in {{Code|users.xml}} in the database path, all existing databases have to be manually moved to the new locationdirectory (see [[User Management]] for more information).
==User and Log Files==Global users, along with their passwords and permissions, are stored in the <code>.basexperm</code> file in the [[#Home Directory|home directory]]. Local users and permissions are stored inside the database files.Log files are stored in text format in the home directory <code>BaseXData/.logs</code> (see [[Logging]] for more information);Version 7.7
→Home Directory
==Configuration Files==
BaseX uses three maintains some configuration files, which are stored in the project’s [[#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>.basexgui</code> defines all options relevant to the BaseX GUI.
* <code>.basexpermbasexhistory</code> contains user name, passwords, and permissions (see commands that have been typed in most recently.* An empty <code>.basexhome</code> file can be added to a directory to mark it as [[#User and Log FilesHome Directory|last paragraphhome 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 <code>web.basexeventsxml</code> contains all existing events (see [[Events]])file.
==Home Directory==
As BaseX is a portable applicationdistributed 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. Three potential choices for * 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 {{Code|basex}} subdirectory in the '''user home directory''' will be returned. The user home directory exist:is retrieved via the {{Code|HOME}} environment variable, or (if unassigned) the Java system property {{Code|user.home}}.
==Database Directory==
The database path can be changed as follows:
*[[GUI Tutorial|GUI]]: Choose ''Options'' → ''Preferences'' and choose a new database path.*[[Server TutorialGeneral: edit the {{Option|Server]]/[[Standalone TutorialDBPATH}} option in the {{Code|Standalone]].basex}} configuration file '''Note: ''' Existing databases will not automatically be moved to the new destination. ==Log Files== Log files are stored in text format in a <code>SET DBPATH [path].logs</code>sub-directory of the database folder (see [[Logging]] for more information). =Changelog= ;Version 9.0 * Updated: Detection and configuration of home directory and subdirectories. ;Version 8.0
* Updated: The {{Code|.basexhome}} file marks a folder as [[Category: Internal#Home Directory|home directory]].
