How to start and stop the CA Spectrum in Linux

Document ID : KB000076397
Last Modified Date : 06/04/2018
Show Technical Document Details
Introduction:
Best practice for starting and stopping the CA Spectrum from the command line.
The database corruption may occur if the CA Spectrum processes are not properly shutdown when you either reboot or turn off the machine.
 
Environment:
CA Spectrum 10.x in Linux
Instructions:
 
This is the guide to stop the CA Spectrum product on the SpectroSERVER machine.

1. Login as spectrum install owner account on the SpectroSERVER machine 

2. Navigate to the $SPECROOT/bin/ directory 

3. Run the following command to stop the SpectroSERVER (and Archive Manager): 
./stopSS.pl

4. Check whether the SpectroSERVER and Archive Manager have stopped successfully.
For SpectroSERVER check:
  • $SPECROOT/SS/VNM.OUT file
Mar 26 15:55:44 : SpectroSERVER has received shut down signal - scheduling shut down
Mar 26 15:55:44 : C:/win32app/Spectrum/SS/SpectroSERVER.exe is shutting down...
Mar 26 15:55:45 : Closing all client connections...
Mar 26 15:55:45 : Stopping CORBA communication...
Mar 26 15:55:48 : Stopping C:/win32app/Spectrum/SS/SpectroSERVER.exe activity...
 
-----  NOTE  --------------------------------------------------------------
CA Technologies recommends that the SpectroSERVER be
allowed to complete the shutdown process.
Database corruption may result if the SpectroSERVER is prematurely stopped.
-------------------------------------------------------------  NOTE  ------
 
Mar 26 15:55:48 :       waiting for model activates to complete...
Mar 26 15:55:48 :       waiting for model destroys to complete...
Mar 26 15:55:48 : Closing C:/win32app/Spectrum/SS/SpectroSERVER.exe database...
Mar 26 15:55:48 : C:/win32app/Spectrum/SS/SpectroSERVER.exe has successfully shut down.
  • ps -ef | grep -i spectroserver
[spectrum@ss_server01 bin]$ ps -ef | grep -i spectroserver
spectrum  5039  1754  0 Mar26 ?        00:16:20 /usr/Spectrum/SS/SpectroSERVER (this process should not be running)
spectrum 22541 22379  0 15:47 pts/0    00:00:00 grep --color=auto -i spectroserver

 
For Archive Manager check:
  • $SPECROOT/SS/DDM/ARCHMGR.OUT file
Mar 26 15:01:44 : ArchMgr has received shut down signal - scheduling shut down
Mar 26 15:01:44 : Closing all client connections...
Mar 26 15:01:44 : Stopping CORBA communication...
Mar 26 15:01:44 : Closing database
Mar 26 15:01:45 : ArchMgr is shutting down...
Mar 26 15:01:45 : ArchMgr has successfully shut down.
  • ps -ef | grep -i archmgr
[spectrum@ss_server01 bin]$ ps -ef | grep -i archmgr
spectrum  5097  1754  0 Mar26 ?        00:00:41 /usr/Spectrum/SS/DDM/ArchMgr (this process should not be running)
spectrum 22564 22379  0 15:49 pts/0    00:00:00 grep --color=auto -i archmgr

 
5. To stop the Spectrum Process Daemon, navigate to the $SPECROOT/lib/SDMP/ directory and run the following command: 
./processd.pl stop



6. Check whether the Spectrum Process Daemon stopped all processes by looking at the $SPECROOT/lib/SDMP/runtime/ folder. It must be empty.
If it is not empty, open the remaining *.rtt file to find the hung process and kill it manually, and then manually delete the *.rtt file.

 
This is the guide to start the CA Spectrum product on the SpectroSERVER machine.

1. Login as spectrum install owner account on the SpectroSERVER machine 

2. Navigate to the $SPECROOT/bin/ directory 

3. Run the following command to start the SpectroSERVER (and Archive Manager): 
./startSS.pl

4. Check whether the SpectroSERVER and Archive Manager have started successfully.
For SpectroSERVER check:
  • $SPECROOT/SS/VNM.OUT file
**************************************************************************
Version 10.2.3.000
 
Mar 26 09:54:03 : Validating and loading SPECTRUM Intelligence Modules.
Mar 26 09:54:04 : All SPECTRUM Intelligence Modules successfully loaded.
 
 
Mar 26 09:54:04 : Please wait. SpectroSERVER
     is loading landscape 0x1000000 at precedence 10...
 
       Number of models loaded      : 0   
       Number of models loaded      : 1000   
       Number of models loaded      : 2000   
       Number of models loaded      : 2529
 
Mar 26 09:56:44 : C:/win32app/Spectrum/SS/SpectroSERVER.exe
     is now ready on port 0xbeef...
  • ps -ef | grep -i spectroserver
[spectrum@ss_server01 bin]$ ps -ef | grep -i spectroserver
spectrum  5039  1754  0 Mar26 ?        00:16:20 /usr/Spectrum/SS/SpectroSERVER (this process should be running)
spectrum 22541 22379  0 15:47 pts/0    00:00:00 grep --color=auto -i spectroserver


For Archive Manager check:
  • $SPECROOT/SS/DDM/ARCHMGR.OUT file
Mar 26 08:18:23 : ArchMgr started as user 'spectrum'
Mar 26 08:18:23 : ArchMgr validating database.
Mar 26 08:18:36 : ArchMgr successfully connected to MySQL service
Mar 26 08:18:36 : ArchMgr loaded DDM database with landscape handle 0x1000000
 
Mar 26 08:18:38 : ArchMgr has successfully connected to the SpectroSERVER.
Mar 26 08:18:38 : ArchMgr has successfully advertised CORBA Event Service.
 
Mar 26 08:18:38 : ArchMgr is now ready on port 0xbafe, precedence 10
  • ps -ef | grep -i archmgr
[spectrum@ss_server01 bin]$ ps -ef | grep -i archmgr
spectrum  5097  1754  0 Mar26 ?        00:00:41 /usr/Spectrum/SS/DDM/ArchMgr (this process should be running)
spectrum 22564 22379  0 15:49 pts/0    00:00:00 grep --color=auto -i archmgr




This is the guide to start and stop the CA Spectrum product on the OneClick (with or without SRM - Spectrum Report Manager) web server machine.

When you stop the Spectrum Process Daemon, it will automatically stop the Tomcat and MySQL processes. 

So the first option to stop both Tomcat and MySQL processes is stopping the Spectrum Process Daemon, here are the steps: 

1. Login as root on the OneClick web server machine (you MUST be logged as root to stop the Spectrum Process Daemon process) 

2. Navigate to the $SPECROOT/lib/SDPM/ directory 

3. Run the following to stop: 
./processd.pl stop 

Run the following to start: 
./processd.pl start 

4. Run the "ps -ef" commands below to confirm if both processes were stopped successfully:
ps -ef | grep -i mysql
ps -ef | grep -i tomcat



Another option is stopping each process individually logged as spectrum install owner account. 

1. Login as spectrum install owner account on the OneClick web server machine 

2. Navigate to the $SPECROOT/tomcat/bin/ directory 

3. Run the following command to stop the Tomcat process: 
./stopTomcat.sh 

Run the following command to start the Tomcat process: 
./startTomcat.sh 

4. Navigate to the $SPECROOT/bin/ directory 

5. Run the following command to stop the MySQL process: 
./cmdC <oc_hostaname> 2 MYSQL 

Example: ./cmdC oc_server01 2 MYSQL 


Run the following command to start the MySQL process: 
./launchinstdbapp <oc_hostaname> MYSQL y MYSQL.OUT 

Example: ./launchinstdbapp oc_server01 MYSQL y MYSQL.OUT 

6. Run the "ps -ef" commands below to confirm if both processes were stopped successfully:
ps -ef | grep -i mysql
ps -ef | grep -i tomcat


This is what you get when the CA Spectrum is running: 

[spectrum@oc_server01 ~]$ ps -ef | grep tomcat 
spectrum 1612 1363 0 10:00 pts/0 00:00:00 grep --color=auto tomcat 
spectrum 3412 3402 0 Mar26 ? 00:33:38 /usr/Spectrum/Java/bin/java -Djava.util.logging.config.file=/usr/Spectrum/tomcat/conf/logging.properties -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -DOneClick -server -Xmx4096M -XX:+HeapDumpOnOutOfMemoryError -Djava.awt.headless=true -Djavax.net.ssl.trustStore=/usr/Spectrum/custom/keystore/cacerts -Dfile.encoding=UTF-8 -Dcom.sun.management.jmxremote -Dorg.apache.coyote.USE_CUSTOM_STATUS_MSG_IN_HEADER=true -Djava.endorsed.dirs=/usr/Spectrum/tomcat/lib/endorsed -classpath :/usr/Spectrum/tomcat/lib/mail.jar:/usr/Spectrum/tomcat/bin/bootstrap.jar:/usr/Spectrum/tomcat/bin/tomcat-juli.jar -Dcatalina.base=/usr/Spectrum/tomcat -Dcatalina.home=/usr/Spectrum/tomcat -Djava.io.tmpdir=/usr/Spectrum/tomcat/temp -Djava.library.path=/opt/SPECTRUM/lib:/usr/java/packages/lib/amd64:/usr/lib64:/lib64:/lib:/usr/lib:/usr/Spectrum/tomcat/bin org.apache.catalina.startup.Bootstrap start 

[spectrum@oc_server01 ~]$ ps -ef | grep -i mysql 
spectrum 1617 1363 0 10:00 pts/0 00:00:00 grep --color=auto -i mysql 
spectrum 3411 3402 0 Mar26 ? 00:04:55 /usr/Spectrum/mysql/bin//mysqld --defaults-file=/usr/Spectrum/mysql/my-spectrum.cnf 

 
Additional Information:
Title: How can I start and stop processes that are running under processd in Spectrum? 
https://comm.support.ca.com/kb/how-can-i-start-and-stop-processes-that-are-running-under-processd-in-spectrum/kb000041428