# 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>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.itconductor.com/user-guide/automation/start-stop.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
