How to start and stop the Spectrum SS process on Linux from command line

book

Article ID: 76397

calendar_today

Updated On:

Products

CA Spectrum

Issue/Introduction

Best practice for starting and stopping the Spectrum SpectroSERVER and processd from the command line.
Database corruption may occur if the DX Spectrum processes are not properly shutdown when you either reboot or turn off the machine.
 

Environment

CA Spectrum 10.x in Linux

Resolution

 
This is the guide to stop the DX Spectrum SS and processd 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


[[email protected]_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


[[email protected]_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


- processd has 20 seconds by default to shut down child processes. In some cases, this 20 seconds may not be enough time. If this is the case, you can set the Shutdown Timeout parameter in the spectrum80.env file:

1. Locate and edit the  /opt/SPECTRUM/sppectrum80.env file by adding the following entry:

PROCESSD_SHUTDOWN_TIMEOUT=60000

This will increase the time to 60 seconds allowing processd to shutdown the Spectrum processes gracefully when the system is shutdown. You can adjust this parameter value as needed. 



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


[[email protected]_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


[[email protected]_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 DX Spectrum processes 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: 

[[email protected]_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 

[[email protected]_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://knowledge.broadcom.com/external/article?articleId=41428