Running ArchivesSpace as a Windows service
Running ArchivesSpace as a Windows service requires some additional configuration.
You can also use Apache procrun to configure ArchivesSpace. We have
provided a service.bat script that will attempt to configure
procrun for you (under
To run this script, first you need to download procrun. Extract the files and copy the prunsrv.exe and prunmgr.exe to your ArchivesSpace directory.
You also need to be sure that Java in your system path and also to set
JAVA_HOME as a global environment variable.
To add Java to your path, edit you %PATH% environment variable to include the directory of
your java executable ( it will be something like
(x86)\Java\bin ). To add
JAVA_HOME, add a new system variable and put the
directory where java was installed ( something like
Before setting up the ArchivesSpace service, you should also configure ArchivesSpace to run against MySQL. Be sure that the MySQL connector jar file is in the lib directory, in order for the service setup script to add it to the application’s classpath.
Lastly, for the service to shutdown cleanly, uncomment and change these lines in config/config.rb:
AppConfig[:use_jetty_shutdown_handler] = true AppConfig[:jetty_shutdown_path] = "/xkcd"
This enables a shutdown hook for Jetty to respond to when the shutdown action is taken.
You can now execute the batch script from your ArchivesSpace root directory from
the command line with
launcher\service.bat. This will configure the service and
provide two executables:
ArchivesSpaceService.exe (the service) and
ArchivesSpaceServicew.exe (a GUI monitor)
There are several options to launch the service. The easiest is to open the GUI monitor and click “Launch”.
Alternatively, you can start the GUI monitor and minimize it in your system tray with:
To execute the service from the command line, you can invoke:
Log output will be placed in your ArchivesSpace log directory.
Please see the procrun documentation for more information.