# Start/Stop Automation

IT-Conductor allows users to automate the Start/Stop process of SAP and non-SAP systems. It can be applied to a single system or multiple systems and can be manually executed or scheduled. This feature is highly adaptable to any customer environment and can be a crucial component of IT maintenance operations.

For instance, a single process definition can be created to initiate the Start/Stop activity of all the SAP and non-SAP systems at a specific time.

### Prerequisites

* The system should be registered in IT-Conductor for monitoring.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FJkfW5EOx3k4h7gaQ7fAZ%2Fimage.png?alt=media&#x26;token=b2e64915-584d-4d5f-9421-377726269e97" alt=""><figcaption><p>Figure 1: SAP Systems in IT-Conductor Service Grid</p></figcaption></figure>

* A [Robot User](https://docs.itconductor.com/user-guide/account-administration/create-robot-users) should be created and associated with the application/DB/OS users with assigned roles/privileges to execute the local action on the system to be stopped/started.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FEmOPTpaMQJaZN1HUMytC%2Fimage.png?alt=media&#x26;token=c57683e2-c953-45d9-b13c-e8dda4df1d81" alt=""><figcaption><p>Figure 2: Start/Stop Process Definitions</p></figcaption></figure>

* The ownership of the process definition should be assigned to the [Robot User](https://docs.itconductor.com/user-guide/account-administration/create-robot-users).
* The customer must have an OS user capable of using SAPControl from the command line to start/stop SAP systems.

### Start/Stop Automation in Action

To see the Start/Stop Automation in action, let's have an SAP system with a HANA database running on AWS as an example.

#### Start System Process Definition

The following process definition is the workflow developed to automate the start process of the HANA database.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fsma2rVlRGydsccsBpGeH%2Fimage.png?alt=media&#x26;token=e362da49-55a8-4394-be00-f5f1ee42bef4" alt=""><figcaption><p>Figure 3: SAP HANA DB Start Process Definition</p></figcaption></figure>

#### Run/Schedule Start System

The process definition can be triggered to run immediately or scheduled to run at a later time.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2Fl2H0vol3rccsyOhkl3NA%2Fimage.png?alt=media&#x26;token=960771ad-3c0a-4c0e-bddb-32f462a69149" alt=""><figcaption><p>Figure 4: Run/Schedule Start Process Definition</p></figcaption></figure>

{% hint style="info" %}
**Note:** The [Robot User](https://docs.itconductor.com/user-guide/account-administration/create-robot-users) created as a pre-requisite requirement should be available as an option in the Owner attribute.
{% endhint %}

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FCp4KTFGVfQyfSwh1ZiEJ%2Fimage.png?alt=media&#x26;token=3e38580f-a47e-4b21-a89e-c56aca014c61" alt=""><figcaption><p>Figure 5: Process Created Message Box</p></figcaption></figure>

#### Start Process Execution <a href="#start-system" id="start-system"></a>

Once the process is instantiated, the process starts the VM where the system is running.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F6grQXYDrkVex2p50yolH%2Fimage.png?alt=media&#x26;token=b80fb4bd-d6cc-4526-ae01-0acf5d625ca3" alt=""><figcaption><p>Figure 6: VM in AWS</p></figcaption></figure>

The "Start" activity should contain the work queue linked to the AWS Account.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FcTxknEjbLG7RkHDVbLsi%2Fimage.png?alt=media&#x26;token=16dc3a6c-1538-46f4-b994-caadc2da2803" alt=""><figcaption><p>Figure 7: Start Activity</p></figcaption></figure>

{% hint style="info" %}
**Note:** For this automation, an object for the work queue must have been previously created in order to link IT-Conductor to the AWS Account. This object allows IT-Conductor to start or stop the VM as part of the process definition.
{% endhint %}

The "Modify Start HANA System" activity starts the HANA Instance running on the VM. This activity executes an SSH Command on the VM via the SAP Hostagent.&#x20;

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FUZ5UUsVlr4m1VsSex6xj%2Fimage.png?alt=media&#x26;token=c44ecda1-1a80-43a2-a2cf-c6c8d306c755" alt=""><figcaption><p>Figure 8: Start HANA System Activity</p></figcaption></figure>

In Figure 8, there is only one tenant in a multi-tenant HANA system. Thus, a single start of the HANA system will start the tenant.

{% hint style="info" %}
**Note:** IT-Conductor also supports start/stop operations for a specific tenant in a multi-tenant system with support for SQL commands executed against the HANA SYSTEMDB database to control an individual tenant.
{% endhint %}

Once the HANA System is running, the process executes the "Start OZ3" activity to start the SAP System via SSH command.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F3j27gq5JmRoNNAPj0Iae%2Fimage.png?alt=media&#x26;token=e0ff0159-de9d-4411-961d-1965e56c6b11" alt=""><figcaption><p>Figure 9: Start OZ3 Activity</p></figcaption></figure>

The status of each activity will be indicated by a change in activity color.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FLFlJa7MGGoGGEdbVXxJL%2FIT-Conductor%20Activity%20Status%20Color%20Codes.png?alt=media&#x26;token=e8f7a1e7-0ecf-4cae-b991-428f013d182d" alt=""><figcaption><p>Figure 10: IT-Conductor Activity Status Color Codes</p></figcaption></figure>

The Activity Log will be available for review after process definition completion.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FAijYfVBOaRz1byphLyp8%2Fimage.png?alt=media&#x26;token=9b1cd61a-61c1-4baa-b987-e825e376f68b" alt=""><figcaption><p>Figure 11: Activity Log</p></figcaption></figure>

Once the process has ended, all system components are discoverable again in IT-Conductor.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FymVBMALmX0XWO0KjwU3r%2Fimage.png?alt=media&#x26;token=bd5dee89-dd4c-4d29-b14f-8ac5bc23bb2b" alt=""><figcaption><p>Figure 12: OZ3 Availability</p></figcaption></figure>

#### Stop System Process Definition

The following process definition is the workflow developed to automate the stop process of the HANA database.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FTyLLA6w0SmWvIzRB6Jpu%2Fimage.png?alt=media&#x26;token=79a195e6-5832-470b-9ec4-2c2047dba196" alt=""><figcaption><p>Figure 13: SAP HANA DB Stop Process Definition</p></figcaption></figure>

#### Run/Schedule Stop System

Similar to the Start process definition, the Stop process definition can be triggered to run immediately or scheduled to run at a later time.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FopIKLwkpJeQXgPynHrzz%2FRun_Schedule%20Stop%20Process%20Definition.png?alt=media&#x26;token=677612c2-dc12-4db7-a27a-56d5c532d82c" alt=""><figcaption><p>Figure 14: Run/Schedule Stop Process Definition</p></figcaption></figure>

#### Stop Process Execution

Once the process is instantiated, the process stops the VM where the system is running.

The "Stop OZ3" activity stops the SAP System using SSH commands:

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FVNl02C8KBXOH0RuaCaly%2Fimage.png?alt=media&#x26;token=75a9a2ac-d86d-44a4-ba6e-fe469b267949" alt=""><figcaption><p>Figure 15: Stop OZ3 Activity</p></figcaption></figure>

The "Stop HANA System" activity stops the HANA system. IT-Conductor also supports the stopping of a specific tenant via SQL command executed on the HANA SYSTEMDB database.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FLDLi83r4y7GOSYeV4zUN%2Fimage.png?alt=media&#x26;token=812ae66a-6cc4-4c94-a0bc-1f88fe1d5f65" alt=""><figcaption><p>Figure 16: Stop HANA System Activity</p></figcaption></figure>

The status of each activity will be indicated by a change in activity color similar to Figure 10.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2F6OqmAcDFY92sdU0wts8H%2Fimage.png?alt=media&#x26;token=12bbbcd2-a9d8-42d3-9b5c-a232944c6e8b" alt=""><figcaption><p>Figure 17: Completed Stop Process Definition</p></figcaption></figure>

## SAP Start/Stop Automation Dashboard <a href="#dashboard" id="dashboard"></a>

A customized dashboard can be designed to showcase the Stop/Start Automation wizards, Execution Config, Process instances, and the health status of the Systems when they are up and running and when they are shut down.

<figure><img src="https://377464071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXhp08OmU8050PePmMgDt%2Fuploads%2FxFWp6JAqyGtDPfTlZJjL%2Fimage.png?alt=media&#x26;token=12b64599-aee3-4222-8cd9-e93dcd89dd6b" alt=""><figcaption><p>Figure 18: Stop/Start Automation Dashboard</p></figcaption></figure>

### Video

{% embed url="<https://youtu.be/rWEu7SoXG6U>" %}
