Shutting Down the CollectionSpace Server
Task Description
This task shuts down the CollectionSpace server.
Prerequisites
Before shutting down the CollectionSpace server, you should be familiar with running commands at your operating system's command prompt.
In the instructions below, CSPACE_JEESERVER_HOME
is an environment variable that holds the path to your CollectionSpace server folder. You will have set this environment variable in the process of installing CollectionSpace, as described in the relevant installation guide in Installing CollectionSpace.
Procedure
To shut down the CollectionSpace server:
On Linux/Unix/Mac OS X, at your command prompt, enter:
$CSPACE_JEESERVER_HOME/bin/shutdown.sh -force
On Windows, at your command prompt, enter:
%CSPACE_JEESERVER_HOME%\bin\shutdown.bat
Validate
Check server logs
Check for a server log message indicating that the CollectionSpace server has shut down. You can look for this message in the log file $CSPACE_JEESERVER_HOME/logs/catalina.out
The shutdown message in the log file may look something like the following:
Dec 16, 2011 3:54:30 PM org.apache.coyote.http11.Http11Protocol destroy INFO: Stopping Coyote HTTP/1.1 on http-8180
The exact format of these messages may vary, depending on logging configuration.
Check the list of running processes
An entry for the CollectionSpace server process should no longer appear in your server's list of all running processes.
You can view these processes using the command line ps
command for Linux, Unix and Mac OS X systems, or the command line tasklist
or wmic
commands for Windows systems. Your operating system may also provide graphical tool(s) that you can use to view running processes. Please see your operating system documentation for details.
See Starting Up the CollectionSpace Server for an example of a process list entry for the CollectionSpace server process. Some of the words that might appear in this process list entry, that you could use to search for this process and make sure that it is no longer running, may include catalina
and tomcat
.