Database Reference
In-Depth Information
Windows Linux and Other Unix
eXist ships with a third-party tool from Tanuki Software called the
Java Service
Wrapper
. eXist uses the open source GPLv2 version of the Java Service Wrapper,
which is written in C and Java. The C component provides native integration with
specific operating systems, while the Java component provides abstractions atop the
C component to allow you to use the same configuration and management options
across all platforms.
eXist provides configuration files and scripts for the Java Service Wrapper that allow
you to easily install eXist as a service on any platform that the tool supports—i.e.,
Windows, Linux (x86), and Mac OS X. The Java Service Wrapper can also support
IBM AIX (PPC), z/OS, z/Linux, FreeBSD (x86), HPUX, and Linux (PPC, ARM) by
way of a
Delta Pack
that can be downloaded from the Tanuki Software website. While
the Java Service Wrapper also supports Solaris, eXist provides its own solution for the
Solaris platform, as discussed in
“Solaris” on page 406
.
A preconfigured Java Service Wrapper ships with eXist and is provided in the
$EXIST_HOME/tools/wrapper
folder. Before installing eXist as a service, you should
consider the access rights that eXist has to your system and the security concerns of
running eXist as a service, as discussed in
“Reducing Collateral Damage” on page
175
.
To install eXist as a service on Windows platforms, you can execute the following
command from a Windows console (
cmd.exe
):
C:\>
%EXIST_HOME%
\tools\wrapper\bin\install.bat
After successful installation as a service on Windows, eXist will show up in the Win‐
dows Services as “eXist Native XML Database.”
To install eXist on Linux, Mac OS X, and other Unix platforms, you can execute the
following command from a terminal as
root
or an equally privileged user:
#
$EXIST_HOME/tools/wrapper/bin/install.sh
After successful installation as a service, eXist will be installed as the named service
eXist-db
. You should then be able to manage the service with your platform's service
management tools. On Linux this would typically be the
service
and/or
chkconfig
commands; for example, running
service eXist-db status
should report the run‐
ning status of eXist.
When you are installing on Linux, if your distribution uses the
Upstart event-based startup system (e.g., Ubuntu, Linux Mint,
ChromeOS, RHEL/CentOS 6, Scientific Linux, and Oracle Linux),
you should edit
$EXIST_HOME/tools/wrapper/bin/install.sh
before
running it and set the flag
USE_UPSTART
to
true
.
Search WWH ::
Custom Search