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.

See Also