Difference between revisions of "Start Scripts"
m (Text replacement - "</syntaxhighlight>" to "</pre>") Tags: Mobile web edit Mobile edit |
|||
Line 27: | Line 27: | ||
REM Run code | REM Run code | ||
java -cp "%CP%" %BASEX_JVM% org.basex.BaseX %* | java -cp "%CP%" %BASEX_JVM% org.basex.BaseX %* | ||
− | </ | + | </pre> |
==Linux/Mac: {{Code|basex}}== | ==Linux/Mac: {{Code|basex}}== | ||
Line 51: | Line 51: | ||
# Run code | # Run code | ||
java -cp "$CP" $BASEX_JVM org.basex.BaseX "$@" | java -cp "$CP" $BASEX_JVM org.basex.BaseX "$@" | ||
− | </ | + | </pre> |
=GUI, Server, Client= | =GUI, Server, Client= | ||
Line 76: | Line 76: | ||
REM Run code | REM Run code | ||
java -cp "%CP%" %BASEX_JVM% org.basex.BaseXHTTP %* | java -cp "%CP%" %BASEX_JVM% org.basex.BaseXHTTP %* | ||
− | </ | + | </pre> |
==Linux/Mac: {{Code|basexhttp}}== | ==Linux/Mac: {{Code|basexhttp}}== | ||
Line 100: | Line 100: | ||
# Run code | # Run code | ||
java -cp "$CP" $BASEX_JVM org.basex.BaseXHTTP "$@" | java -cp "$CP" $BASEX_JVM org.basex.BaseXHTTP "$@" | ||
− | </ | + | </pre> |
=Included Start Scripts= | =Included Start Scripts= |
Revision as of 18:35, 1 December 2023
BaseX can be started in different ways. The Windows and ZIP distributions include various start scripts, which are presented in the following, and which can also be maintained separately.
- We recommend you to manually add the
bin
directory of your BaseX instance to the PATH variable of your environment. - If you use the Windows installer, that’s done automatically.
- You can copy the start scripts to another location in your file system. After that, you should edit the scripts and assign the BaseX directory to the
MAIN
variable. - If you are compiling the source code with Maven, you can launch BaseX via the scripts in the basex-core/etc and basex-api/etc subdirectories of the project.
If BaseX terminates with an Out of Memory
or Java heap space
error, you can assign more RAM via the -Xmx
flag (see below). A conservative value was chosen in our distributions to ensure that BaseX will also run on older JVMs.
Contents
Standalone
Use the following scripts to launch the standalone version of BaseX:
Windows: basex.bat
<syntaxhighlight lang="batch"> @echo off setLocal EnableDelayedExpansion
REM Path to core and library classes set MAIN=%~dp0/.. set CP=%MAIN%/BaseX.jar;%MAIN%/lib/*;%MAIN%/lib/custom/*
REM Options for virtual machine set BASEX_JVM=-Xmx1200m %BASEX_JVM%
REM Run code java -cp "%CP%" %BASEX_JVM% org.basex.BaseX %*
Linux/Mac: basex
<syntaxhighlight lang="bash">
- !/usr/bin/env bash
- Path to this script
FILE="${BASH_SOURCE[0]}" while [ -h "$FILE" ] ; do
SRC="$(readlink "$FILE")" FILE="$( cd -P "$(dirname "$FILE")" && \ cd -P "$(dirname "$SRC")" && pwd )/$(basename "$SRC")"
done MAIN="$( cd -P "$(dirname "$FILE")/.." && pwd )"
- Core and library classes
CP=$MAIN/BaseX.jar:$MAIN/lib/*:$MAIN/lib/custom/*:$CLASSPATH
- Options for virtual machine (can be extended by global options)
BASEX_JVM="-Xmx2g $BASEX_JVM"
- Run code
java -cp "$CP" $BASEX_JVM org.basex.BaseX "$@"
GUI, Server, Client
If you would like to launch the GUI, Server or Client version of BaseX, please replace the class name in org.basex.BaseX
with either BaseXGUI
, BaseXServer
or BaseXClient
.
HTTP Server
The scripts for running Web Applications can be found below:
Windows: basexhttp.bat
<syntaxhighlight lang="batch"> @echo off setLocal EnableDelayedExpansion
REM Path to core and library classes set MAIN=%~dp0/.. set CP=%MAIN%/BaseX.jar;%MAIN%/lib/*;%MAIN%/lib/custom/*
REM Options for virtual machine set BASEX_JVM=-Xmx1200m %BASEX_JVM%
REM Run code java -cp "%CP%" %BASEX_JVM% org.basex.BaseXHTTP %*
Linux/Mac: basexhttp
<syntaxhighlight lang="bash">
- !/usr/bin/env bash
- Path to this script
FILE="${BASH_SOURCE[0]}" while [ -h "$FILE" ] ; do
SRC="$(readlink "$FILE")" FILE="$( cd -P "$(dirname "$FILE")" && \ cd -P "$(dirname "$SRC")" && pwd )/$(basename "$SRC")"
done MAIN="$( cd -P "$(dirname "$FILE")/.." && pwd )"
- API, core, and library classes
CP=$MAIN/BaseX.jar:$MAIN/lib/*:$MAIN/lib/custom/*:$CLASSPATH
- Options for virtual machine (can be extended by global options)
BASEX_JVM="-Xmx2g $BASEX_JVM"
- Run code
java -cp "$CP" $BASEX_JVM org.basex.BaseXHTTP "$@"
Included Start Scripts
The BaseX Windows and ZIP distributions include the following start scripts:
Windows | Linux/Mac | Description |
---|---|---|
basex.bat
|
basex
|
Launches the BaseX standalone mode. |
basexclient.bat
|
basexclient
|
Starts a BaseX client. |
basexgui.bat
|
basexgui
|
Starts the BaseX GUI. |
basexhttp.bat
|
basexhttp
|
Starts the BaseX HTTP Server. |
basexserver.bat
|
basexserver
|
Starts the BaseX database server. |
For the BaseX HTTP and database server, additional stop scripts are available:
Windows | Linux/Mac | Description |
---|---|---|
basexhttpstop.bat
|
basexhttpstop
|
Stops the BaseX HTTP Server. |
basexserverstop.bat
|
basexserverstop
|
Stops the BaseX database server. |
Changelog
- Version 7.5
- Updated: Static dependencies removed from Windows batch scripts.
- Version 7.2
- Updated: The
BaseXHTTP
start class moved fromorg.basex.api
toorg.basex
.
- Version 7.0
- Updated: The
basexjaxrx
scripts have been replaced with thebasexhttp
scripts.