Shutting Down the CollectionSpace Server

Owned by Jessi Weithman
Apr 18, 2024

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

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:

03-Apr-2024 03:15:47.433 INFO [main] org.apache.coyote.AbstractProtocol.stop Stopping ProtocolHandler ["http-nio-8180"]
03-Apr-2024 03:15:47.434 INFO [main] org.apache.coyote.AbstractProtocol.destroy Destroying ProtocolHandler ["http-nio-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 in Linux. 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 collectionspace, nuxeo, and tomcat.

See Also