Starting and Stopping Retain (Tomcat)

  • 7019531
  • 25-May-2017
  • 24-Jul-2017

Environment

Retain (build 1.6 and later) Linux, Windows, NetWare

Situation

How do I start and stop Retain?

Resolution

Retain runs under Tomcat, which runs under Java and it is made up of two main components: 

  • Retain Server
  • Retain Worker

To start, stop, or restart either one of these components (or both if they reside on the same server), you start, stop, or restart Tomcat.

Here are instructions on starting, stopping, and restarting Tomcat on Windows, Linux, and NetWare:

Windows

In Windows, it runs as a service, so simply start, stop, or restart that service.

Retain 2/3:  Apache Tomcat [n] (where "n" is the Tomcat version)

Retain 4:  Retain Tomcat [n] (where "n" is the Tomcat version)

Linux

The following commands are typed at the command prompt:

SLES 11

Start:

rcretain-tomcatx start
Stop: rcretain-tomcatx stop
Restart:

rcretain-tomcatx restart

SLES 12

Start:  systemctl start retain-tomcatX.service

Stop:  systemctl stop retain-tomcatX.service

Restart:  systemctl restart retain-tomcatX.service

Where "x" is the version of tomcat (i.e., Retain 2.x uses Tomcat5, Retain 3.x uses Tomcat7

On rare occasions, the symbolic link "rcretain-tomcat5" will not exist for some customers who may have upgraded from Retain 1.x.  In such cases:
Change directories to /etc/init.d:

Start: ./retain-tomcat5 start
Stop: ./retain-tomcat5 stop
Restart: ./retain-tomcat5 restart

*Note: This is no longer true in SLES 12

You can manually create the "rcretain-tomcat5" symbolic link so that you can use the aforementioned commands:

Type:  ln -s /etc/init.d/retain-tomcat5 /sbin/rcretain-tomcat5

Netware
The following commands are typed at the system console:

Start: tomcatx
Stop: tcxstop
Restart: tcxrestart

Where "x" is the version of tomcat (i.e., Retain 2.x uses Tomcat5, Retain 3.x uses Tomcat7)

Additional Information

This article was originally published in the GWAVA knowledgebase as article ID 1436.