Starting and stopping product components and services

Sometimes you might need to start or stop any of the BMC Atrium Orchestrator platform components and services. The following procedures detail how to start and stop services:

In these instructions, AO_HOME represents the installation directory for the BMC Atrium Orchestrator component, such as the CDP, HA-CDP, AP, LAP, OCP, repository, or dashboards.

If BMC Atrium Orchestrator (BAO) and Atrium Single Sign-On (SSO) are installed on the same server, ensure that the Atrium SSO service is running before starting BAO. For more information, see CDP-fails-to-start.

Starting and stopping BMC Atrium Single Sign-On

Use these instructions to start and stop BMC Atrium Single Sign-On.

Starting BMC Atrium SSO

BMC Atrium Single Sign-On must be running for you to use Grid Manager and the repository. You can set BMC Atrium Single Sign-On to start automatically after installation finishes, or you can use the procedure appropriate for the operating system where BMC Atrium Single Sign-On is installed to start it.

To start BMC Atrium Single Sign-On on a Windows computer

Select Settings > Control Panel > Administrative Tools > Services to open the Services window.
Right-click the BMC Atrium SSO Tomcat service and select Start.

To start BMC Atrium Single Sign-On on a Linux or UNIX computer

Open a terminal on the computer.
Change to the SSO_Home/bin directory for the BMC Atrium Single Sign-On installation.
Type SSO_HOME/bin/startup-tomcat.sh
Tomcat displays messages indicating that BMC Atrium Single Sign-On started.

Tips

If BMC Atrium Single Sign-On does not start properly, consider the following tips:

If you see a message saying that BMC Atrium Single Sign-On is not found, ensure that you are in the correct directory.
Check the grid.log file for a port conflict. If there is a port conflict, edit the AO_Home/tomcat/conf/server.xml file to change the port to an available port. Then try to restart the service.

Stopping BMC Atrium Single Sign-On

Although BMC Atrium Single Sign-On must be running for you to use Grid Manager and the repository, you might need to stop the processes. You can use the procedure appropriate for the operating system where BMC Atrium Single Sign-On is installed to stop BMC Atrium Single Sign-On processes.

To stop BMC Atrium Single Sign-On on a Windows computer

Select Settings > Control Panel > Administrative Tools > Services to open the Services window.
Right-click the BMC Atrium SSO Tomcat service and select Stop.

To stop BMC Atrium Single Sign-On on a Linux or UNIX computer

Open a terminal on the computer.
Change to the SSO_Home/bin directory for the BMC Atrium Single Sign-On installation.
Type SSO_HOME/bin/shutdown-tomcat.sh
Tomcat displays messages indicating that the server stopped.

Tip

If you see a message saying that the server is not found, ensure that you are in the correct directory.

Starting and stopping the repository

Use these instructions to start and stop the repository.

Starting the repository

You can set the repository to start automatically after installation finishes, or you can use the procedure appropriate for the operating system where the repository is installed to start it.

To start the repository on a Windows computer

Select Control Panel > Administrative Tools > Services to open the Services window.
Right-click the BMC Atrium Orchestrator Repository service and select Start.

To start the repository on a Linux or UNIX computer

Open a terminal on the computer.
Change to the AO_Home/bin directory for the Repository installation.
Type sh AO_HOME/bin/server.sh start
Tomcat displays messages indicating that the server started.

Stopping the repository

Sometimes, you might need to stop the processes for maintenance or any other purposes. You can use the procedure appropriate for the operating system where the repository is installed to stop the repository processes.

To stop the repository on a Windows computer

Select Settings > Control Panel > Administrative Tools > Services to open the Services window.
Right-click the BMC Atrium Orchestrator Repository service and select Stop.

To stop the repository on a Linux or UNIX computer

Open a terminal on the computer.
Change to the AO_Home/bin directory for the CDP installation.
Type sh AO_HOME/bin/server.sh stop
Tomcat displays messages indicating that the server stopped.

Starting and stopping the CDP, AP, or LAP

Use these instructions to start and stop the CDP, AP, or LAP.

Starting the CDP, AP, or LAP

The configuration distribution peer (CDP) must be running for you to use Grid Manager. You can set the CDP to start automatically after installation finishes, or you can use the procedure appropriate for the operating system where the CDP is installed to start it. You use the same approach to start APs and LAPs.

To start the CDP on a Windows computer

Select Control Panel > Administrative Tools > Services to open the Services window.
Right-click the appropriate service (in the following list) and select Start.
- CDP service: BMC Atrium Orchestrator Configuration Distribution Peer
- AP service: BMC Atrium Orchestrator Activity Peer
- LAP service: BMC Atrium Orchestrator Lightweight Activity Peer

To start the CDP, AP, or LAP on a Linux or UNIX computer

Open a terminal on the computer.
Change to the AO_Home/bin directory for the CDP, AP, or LAP installation.
Type sh AO_HOME/bin/server.sh start
Tomcat displays messages indicating that the server started.
Tips
If the CDP, AP, or LAP does not start properly, consider the following tips:
- If you see a message saying that the server is not found, ensure that you are in the correct directory.
- Check the grid.log file for a port conflict. If there is a port conflict, edit the AO_Home/tomcat/conf/server.xml file to change the port to an available port. Then try to restart the service.

Stopping the CDP, AP, or LAP

Although the CDP must be running for you to use Grid Manager, you might need to stop the processes. You can use the procedure appropriate for the operating system where the CDP is installed to stop the CDP processes. You use the same approach to start APs and LAPs.

To stop the CDP, AP, or LAP on a Windows computer

Select Settings > Control Panel > Administrative Tools > Services to open the Services window.
Right-click appropriate service (in the following list) and select Stop.
- CDP service: BMC Atrium Orchestrator Configuration Distribution Peer
- AP service: BMC Atrium Orchestrator Activity Peer
- LAP service: BMC Atrium Orchestrator Lightweight Activity Peer

To stop the CDP, AP, or LAP on a Linux or UNIX computer

Open a terminal on the computer.
Change to the AO_Home/bin directory for the CDP installation.
Type sh AO_HOME/bin/server.sh stop
Tomcat displays messages indicating that the server stopped.

Starting and stopping the OCP

Use these instructions to start and stop the OCP.

Starting the OCP

Use the procedure appropriate for the operating system where the OCP is installed to start the OCP.

To start the OCP on a Windows computer

Select Control Panel > Administrative Tools > Services to open the Services window.
Right-click the BMC Atrium Orchestrator Operator Control Panel service and select Start.

To start the OCP on a Linux or UNIX computer

Open a terminal on the computer.
Change to the AO_Home/bin directory for the OCP installation.
Type sh AO_HOME/bin/server.sh start
Tomcat displays messages indicating that the server started.

Stopping the OCP

Use the procedure appropriate for the operating system where the OCP is installed to stop the OCP.

To stop the OCP on a Windows computer

Select Settings > Control Panel > Administrative Tools > Services to open the Services window.
Right-click the BMC Atrium Orchestrator Operator Control Panel service and select Stop.

To stop the OCP on a Linux or UNIX computer

Open a terminal on the computer.
Change to the AO_Home/bin directory for the OCP installation.
Type sh AO_HOME/bin/server.sh stop
Tomcat displays messages indicating that the server stopped.

If the OCP is installed in the same location as the CDP, AP, or LAP, when you run the server.sh start command, the OCP and other component (for example, the CDP) will both be started. If you want to start only one component, use the Tomcat instructions Start an Existing Application.

Similarly, if the OCP is installed in the same location as the CDP, AP, or LAP, when you run the server.sh stop command, the OCP and other component (for example, the CDP) will both be stopped. If you want to stop only one component, use the Tomcat instructions Stop an Existing Application.

Starting and stopping the dashboards

Use these instructions to start and stop the dashboards.

Starting the dashboards

Use the procedure appropriate for the operating system where the dashboards are installed to start them.

To start the dashboards on a Windows computer

Select Control Panel > Administrative Tools > Services to open the Services window.
Right-click the BMC Atrium Orchestrator Dashboard Server service and select Start.

To start the dashboards on a Linux or UNIX computer

Open a terminal on the computer.
Change to the AO_Home/bin directory for the dashboard installation.
Type sh AO_HOME/bin/server.sh start
Tomcat displays messages indicating that the server started.

Stopping the dashboards

Use the procedure appropriate for the operating system where the dashboards are installed to stop them.

To stop the dashboards on a Windows computer

Select Settings > Control Panel > Administrative Tools > Services to open the Services window.
Right-click the BMC Atrium Orchestrator Dashboard Server service and select Stop.

To stop the dashboards on a Linux or UNIX computer

Open a terminal on the computer.
Change to the AO_Home/bin directory for the dashboard installation.
Type sh AO_HOME/bin/server.sh stop
Tomcat displays messages indicating that the server stopped.