Skip to content

Commit 6c8eec2

Browse files
authored
Merge pull request #313294 from jad0126/sap-solutions-quickstarts
[AQ] edit pass: sap-solutions-quickstarts
2 parents 52fad0d + 8f305b0 commit 6c8eec2

4 files changed

Lines changed: 248 additions & 236 deletions

File tree

Lines changed: 52 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Quickstart - Start and stop SAP systems from Azure Center for SAP solutions with CLI
3-
description: Learn how to start or stop an SAP system through the Virtual Instance for SAP solutions (VIS) resource in Azure Center for SAP solutions through Azure CLI.
2+
title: Start or Stop SAP Systems with the Azure CLI
3+
description: Learn how to start or stop an SAP system in Azure Center for SAP solutions by using the Azure CLI.
44
ms.service: sap-on-azure
55
ms.subservice: center-sap-solutions
66
ms.custom: devx-track-azurecli
@@ -9,74 +9,77 @@ ms.date: 05/04/2023
99
ms.author: kanamudu
1010
author: kalyaninamuduri
1111
#Customer intent: As a developer, I want to start and stop SAP systems in Azure Center for SAP solutions so that I can control instances through the Virtual Instance for SAP resource.
12-
# Customer intent: As an SAP system administrator, I want to start and stop SAP systems using the Azure CLI, so that I can efficiently manage system resources and ensure optimal performance of my applications.
12+
#Customer intent: As an SAP system administrator, I want to start and stop SAP systems by using the Azure CLI, so that I can efficiently manage system resources and optimize performance of my applications.
1313
---
14-
# Quickstart: Start and stop SAP systems from Azure Center for SAP solutions with CLI
14+
# Start and stop SAP systems in Azure Center for SAP solutions with the Azure CLI
1515

16-
The Azure CLI is used to create and manage Azure resources from the command line or in scripts.
16+
Use the Azure CLI to create and manage Azure resources from the command line or in scripts.
1717

18-
In this how-to guide, you'll learn how to start and stop your SAP systems through the *Virtual Instance for SAP solutions (VIS)* resource in *Azure Center for SAP solutions* using the Azure CLI.
18+
In this guide, you learn to start and stop your SAP systems through the Virtual Instance for SAP solutions (VIS) resource in Azure Center for SAP solutions. You can start and stop SAP systems by using the Azure CLI or by using Azure PowerShell. This article shows you the steps to use the Azure CLI.
1919

2020
Through the Azure CLI, you can start and stop:
2121

22-
- The entire SAP Application tier, which includes ABAP SAP Central Services (ASCS) and Application Server instances.
23-
- Individual SAP instances, which include Central Services and Application server instances.
24-
- HANA Database
25-
- You can start and stop instances in the following types of deployments:
26-
- Single-Server
27-
- High Availability (HA)
28-
- Distributed Non-HA
29-
- SAP systems that run on Windows and, RHEL and SUSE Linux operating systems.
30-
- SAP HA systems that use SUSE and RHEL Pacemaker clustering software and Windows Server Failover Clustering (WSFC). Other certified cluster software isn't currently supported.
22+
- The entire SAP application tier, which includes Advanced Business Application Programming SAP Central Services (ASCS) and application server instances.
23+
- Individual SAP instances, which include Central Services and application server instances.
24+
- A HANA database.
25+
- Instances in the following types of deployments:
26+
- Single-server.
27+
- High availability (HA).
28+
- Distributed non-HA.
29+
- SAP systems that run on Windows.
30+
- SAP systems that run on RHEL and SUSE Linux operating systems.
31+
- SAP HA systems that use RHEL and SUSE Pacemaker clustering software and Windows Server Failover Clustering. Other certified cluster software isn't currently supported.
3132

3233
## Prerequisites
33-
- An SAP system that you've [created in Azure Center for SAP solutions](prepare-network.md) or [registered with Azure Center for SAP solutions](register-existing-system.md) as a *Virtual Instance for SAP solutions* resource.
34-
- Check that your Azure account has **Azure Center for SAP solutions administrator** or equivalent role access on the Virtual Instance for SAP solutions resources. You can learn more about the granular permissions that govern Start and Stop actions on the VIS, individual SAP instances and HANA Database [in this article](manage-with-azure-rbac.md#start-sap-system).
35-
- For the start operation to work, the underlying virtual machines (VMs) of the SAP instances must be running. This capability starts or stops the SAP application instances, not the VMs that make up the SAP system resources.
36-
- The `sapstartsrv` service must be running on all VMs related to the SAP system.
37-
- For HA deployments, the HA interface cluster connector for SAP (`sap_vendor_cluster_connector`) must be installed on the ASCS instance. For more information, see the [SUSE connector specifications](https://www.suse.com/c/sap-netweaver-suse-cluster-integration-new-sap_suse_cluster_connector-version-3-0-0/) and [RHEL connector specifications](https://access.redhat.com/solutions/3606101).
38-
- The Stop operation function for the HANA Database can only be initiated when the cluster maintenance mode is in **Disabled** status. Similarly, the Start operation function can only be initiated when the cluster maintenance mode is in **Enabled** status.
3934

40-
## Start SAP system
41-
To Start an SAP system represented as a *Virtual Instance for SAP solutions* resource:
35+
To start and stop on the VIS solutions resource, you must:
4236

43-
Use the [az workloads sap-virtual-instance start](/cli/azure/workloads/sap-virtual-instance#az-workloads-sap-virtual-instance-start) command:
37+
- Use an SAP system that you [created in Azure Center for SAP solutions](prepare-network.md) or [registered with Azure Center for SAP solutions](register-existing-system.md) as a VIS resource.
4438

45-
Option 1:
39+
- Confirm that your Azure account has the following role, or equivalent role access on the VIS resource: Azure Center for SAP solutions administrator. For more information about the granular permissions that govern start and stop actions on the VIS, individual SAP instances, and HANA database, see [Start SAP system](manage-with-azure-rbac.md#start-sap-system).
4640

47-
Use the Virtual Instance for SAP solutions resource Name and ResourceGroupName to identify the system you intend to start.
41+
- Confirm that the underlying virtual machines (VMs) of the SAP instances are running. This capability starts or stops the SAP application instances, not the VMs that make up the SAP system resources.
4842

49-
```azurecli-interactive
50-
az workloads sap-virtual-instance start -g <Resource-group-name> -n <ResourceName>
51-
```
52-
Option 2:
43+
- Confirm that the `sapstartsrv` service is running on all VMs related to the SAP system.
5344

54-
Use the `id` parameter and pass the resource ID of the Virtual Instance for SAP solutions resource you intend to start.
55-
56-
```azurecli-interactive
57-
az workloads sap-virtual-instance start --id <ResourceID>
58-
```
45+
- For HA deployments, install the HA interface cluster connector for SAP (`sap_vendor_cluster_connector`) on the ASCS instance. For more information, see the [SUSE connector specifications](https://www.suse.com/c/sap-netweaver-suse-cluster-integration-new-sap_suse_cluster_connector-version-3-0-0/) and [RHEL connector specifications](https://access.redhat.com/solutions/3606101).
46+
47+
- For start operations, ensure that the cluster maintenance mode is in the **Enabled** status. The start operation function for the HANA database can only be initiated when the cluster maintenance mode is enabled.
48+
49+
- For stop operations, ensure that the cluster maintenance mode is in the **Disabled** status. The stop operation function for the HANA database can only be initiated when the cluster maintenance mode is disabled.
50+
51+
## Start an SAP system
52+
53+
To start an SAP system represented as a Virtual Instance for SAP solutions resource, use the [az workloads sap-virtual-instance start](/cli/azure/workloads/sap-virtual-instance#az-workloads-sap-virtual-instance-start) command. Choose one of the following options:
5954

60-
## Stop SAP system
55+
- Use the Virtual Instance for SAP solutions resource `ResourceName` and `ResourceGroupName` to identify the system that you want to start.
6156

62-
To stop an SAP system represented as a *Virtual Instance for SAP solutions* resource:
57+
```azurecli-interactive
58+
az workloads sap-virtual-instance start -g <Resource-group-name> -n <ResourceName>
59+
```
60+
61+
- Use the `id` parameter and pass the resource ID of the Virtual Instance for SAP solutions resource that you want to start.
62+
63+
```azurecli-interactive
64+
az workloads sap-virtual-instance start --id <ResourceID>
65+
```
6366

64-
Use the [az workloads sap-virtual-instance stop](/cli/azure/workloads/sap-virtual-instance#az-workloads-sap-virtual-instance-stop) command:
67+
## Stop an SAP system
6568

66-
Option 1:
69+
To stop an SAP system represented as a Virtual Instance for SAP solutions resource, use the [az workloads sap-virtual-instance stop](/cli/azure/workloads/sap-virtual-instance#az-workloads-sap-virtual-instance-stop) command. Choose one of the following options:
6770

68-
Use the Virtual Instance for SAP solutions resource Name and ResourceGroupName to identify the system you intend to stop.
71+
- Use the Virtual Instance for SAP solutions `ResourceName` and `ResourceGroupName` to identify the system that you want to stop.
6972

70-
```azurecli-interactive
73+
```azurecli-interactive
7174
az workloads sap-virtual-instance stop -g <Resource-group-name> -n <ResourceName>
72-
```
73-
Option 2:
75+
```
7476

75-
Use the `id` parameter and pass the resource ID of the Virtual Instance for SAP solutions resource you intend to stop.
76-
77-
```azurecli-interactive
77+
- Use the `id` parameter and pass the resource ID of the Virtual Instance for SAP solutions resource that you want to stop.
78+
79+
```azurecli-interactive
7880
az workloads sap-virtual-instance stop --id <ResourceID>
79-
```
80-
81-
## Next steps
81+
```
82+
83+
## Related content
84+
8285
- [Monitor SAP system from the Azure portal](monitor-portal.md)
Lines changed: 46 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,88 +1,85 @@
11
---
2-
title: Quickstart - Start and stop SAP systems from Azure Center for SAP solutions with PowerShell
3-
description: Learn how to start or stop an SAP system through the Virtual Instance for SAP solutions (VIS) resource in Azure Center for SAP solutions through Azure PowerShell module.
2+
title: Start or Stop SAP Systems with Azure PowerShell
3+
description: Learn how to start or stop an SAP system in Azure Center for SAP solutions by using an Azure PowerShell module.
44
ms.service: sap-on-azure
5-
ms.subservice: center-sap-solutions
5+
ms.subservice: center-sap-solutions
66
ms.custom: devx-track-azurepowershell
77
ms.topic: how-to
88
ms.date: 05/04/2023
99
ms.author: kanamudu
1010
author: kalyaninamuduri
1111
#Customer intent: As a developer, I want to start and stop SAP systems in Azure Center for SAP solutions so that I can control instances through the Virtual Instance for SAP resource.
12-
# Customer intent: As a system administrator, I want to use PowerShell to start and stop SAP systems in Azure Center for SAP solutions, so that I can efficiently manage application instances and optimize resource utilization.
12+
#Customer intent: As a system administrator, I want to use Azure PowerShell to start and stop SAP systems in Azure Center for SAP solutions, so that I can efficiently manage application instances and optimize use of resources.
1313
---
14-
# Quickstart: Start and stop SAP systems from Azure Center for SAP solutions with PowerShell
14+
# Start and stop SAP systems in Azure Center for SAP solutions with Azure PowerShell
1515

16-
The [Azure PowerShell AZ](/powershell/azure/new-azureps-module-az) module is used to create and manage Azure resources from the command line or in scripts.
16+
Use the [Az PowerShell module](/powershell/azure/new-azureps-module-az) to create and manage Azure resources from the command line or in scripts.
1717

18-
In this how-to guide, you'll learn to start and stop your SAP systems through the *Virtual Instance for SAP solutions (VIS)* resource in *Azure Center for SAP solutions* using PowerShell.
18+
In this guide, you learn to start and stop your SAP systems through the Virtual Instance for SAP solutions (VIS) resource in Azure Center for SAP solutions. You can start and stop SAP systems by using the Azure CLI or by using Azure PowerShell. This article shows you the steps to use Azure PowerShell.
1919

2020
Through the Azure PowerShell module, you can start and stop:
2121

22-
- The entire SAP Application tier, which includes ABAP SAP Central Services (ASCS) and Application Server instances.
23-
- Individual SAP instances, which include Central Services and Application server instances.
24-
- HANA Database
25-
- You can start and stop instances in the following types of deployments:
26-
- Single-Server
27-
- High Availability (HA)
28-
- Distributed Non-HA
29-
- SAP systems that run on Windows and, RHEL and SUSE Linux operating systems.
30-
- SAP HA systems that use SUSE and RHEL Pacemaker clustering software and Windows Server Failover Clustering (WSFC). Other certified cluster software isn't currently supported.
22+
- The entire SAP application tier, which includes Advanced Business Application Programming SAP Central Services (ASCS) and application server instances.
23+
- Individual SAP instances, which include Central Services and application server instances.
24+
- A HANA database.
25+
- Instances in the following types of deployments:
26+
- Single-server.
27+
- High availability (HA).
28+
- Distributed non-HA.
29+
- SAP systems that run on Windows.
30+
- SAP systems that run on RHEL and SUSE Linux operating systems.
31+
- SAP HA systems that use RHEL and SUSE Pacemaker clustering software and Windows Server Failover Clustering. Other certified cluster software isn't currently supported.
3132

3233
## Prerequisites
3334

34-
The following are prerequisites that you need to ensure before using the Start or Stop capability on the Virtual Instance for SAP solutions resource.
35-
- An SAP system that you've [created in Azure Center for SAP solutions](prepare-network.md) or [registered with Azure Center for SAP solutions](register-existing-system.md) as a *Virtual Instance for SAP solutions* resource.
36-
- Check that your Azure account has **Azure Center for SAP solutions administrator** or equivalent role access on the Virtual Instance for SAP solutions resources. You can learn more about the granular permissions that govern Start and Stop actions on the VIS, individual SAP instances and HANA Database [in this article](manage-with-azure-rbac.md#start-sap-system).
37-
- For the start operation to work, the underlying virtual machines (VMs) of the SAP instances must be running. This capability starts or stops the SAP application instances, not the VMs that make up the SAP system resources.
38-
- The `sapstartsrv` service must be running on all VMs related to the SAP system.
39-
- For HA deployments, the HA interface cluster connector for SAP (`sap_vendor_cluster_connector`) must be installed on the ASCS instance. For more information, see the [SUSE connector specifications](https://www.suse.com/c/sap-netweaver-suse-cluster-integration-new-sap_suse_cluster_connector-version-3-0-0/) and [RHEL connector specifications](https://access.redhat.com/solutions/3606101).
40-
- The Stop operation function for the HANA Database can only be initiated when the cluster maintenance mode is in **Disabled** status. Similarly, Start operation can only be initiated when the cluster maintenance mode is in **Enabled** status.
35+
To start and stop on the VIS solutions resource, you must:
4136

42-
## Start SAP system
37+
- Use an SAP system that you've [created in Azure Center for SAP solutions](prepare-network.md) or [registered with Azure Center for SAP solutions](register-existing-system.md) as a VIS resource.
4338

44-
To Start an SAP system represented as a *Virtual Instance for SAP solutions* resource:
39+
- Confirm that your Azure account has the following role, or equivalent role access on the VIS resource: Azure Center for SAP solutions administrator. For more information about the granular permissions that govern start and stop actions on the VIS, individual SAP instances, and HANA database, see [Start SAP system](manage-with-azure-rbac.md#start-sap-system).
4540

46-
Use the [Start-AzWorkloadsSapVirtualInstance](/powershell/module/az.workloads/Start-AzWorkloadsSapVirtualInstance) command:
41+
- Confirm that the underlying virtual machines (VMs) of the SAP instances are running. This capability starts or stops the SAP application instances, not the VMs that make up the SAP system resources.
4742

48-
Option 1:
43+
- Confirm that the `sapstartsrv` service is running on all VMs related to the SAP system.
4944

50-
Use the Virtual Instance for SAP solutions resource Name and ResourceGroupName to identify the system you intend to start.
45+
- For HA deployments, install the HA interface cluster connector for SAP (`sap_vendor_cluster_connector`) on the ASCS instance. For more information, see the [SUSE connector specifications](https://www.suse.com/c/sap-netweaver-suse-cluster-integration-new-sap_suse_cluster_connector-version-3-0-0/) and [RHEL connector specifications](https://access.redhat.com/solutions/3606101).
5146

52-
```powershell
53-
Start-AzWorkloadsSapVirtualInstance -Name DB0 -ResourceGroupName db0-vis-rg `
54-
```
47+
- For start operations, ensure that the cluster maintenance mode is in the **Enabled** status. The start operation function for the HANA database can only be initiated when the cluster maintenance mode is enabled.
5548

56-
Option 2:
49+
- For stop operations, ensure that the cluster maintenance mode is in the **Disabled** status. The stop operation function for the HANA database can only be initiated when the cluster maintenance mode is disabled.
5750

58-
Use the InputObject parameter and pass the resource ID of the Virtual Instance for SAP solutions resource you intend to start.
51+
## Start an SAP system
5952

60-
```powershell
61-
Start-AzWorkloadsSapVirtualInstance -InputObject /subscriptions/sub1/resourceGroups/rg1/providers/Microsoft.Workloads/sapVirtualInstances/DB0 `
62-
```
53+
To start an SAP system represented as a Virtual Instance for SAP solutions resource, use the [Start-AzWorkloadsSapVirtualInstance](/powershell/module/az.workloads/Start-AzWorkloadsSapVirtualInstance) command. Choose one of the following options:
6354

64-
## Stop SAP system
55+
- Use the Virtual Instance for SAP solutions resource `Name` and `ResourceGroupName` to identify the system that you want to start.
6556

66-
To stop an SAP system represented as a *Virtual Instance for SAP solutions* resource:
57+
```powershell
58+
Start-AzWorkloadsSapVirtualInstance -Name DB0 -ResourceGroupName db0-vis-rg `
59+
```
6760

68-
Use the [Stop-AzWorkloadsSapVirtualInstance](/powershell/module/az.workloads/Stop-AzWorkloadsSapVirtualInstance) command:
61+
- Use the `InputObject` parameter and pass the resource ID of the Virtual Instance for SAP solutions resource that you want to start.
6962

70-
Option 1:
63+
```powershell
64+
Start-AzWorkloadsSapVirtualInstance -InputObject /subscriptions/sub1/resourceGroups/rg1/providers/Microsoft.Workloads/sapVirtualInstances/DB0 `
65+
```
7166

72-
Use the Virtual Instance for SAP solutions resource Name and ResourceGroupName to identify the system you intend to stop.
67+
## Stop an SAP system
7368

74-
```powershell
75-
Stop-AzWorkloadsSapVirtualInstance -Name DB0 -ResourceGroupName db0-vis-rg `
76-
```
69+
To stop an SAP system represented as a Virtual Instance for SAP solutions resource, use the [Stop-AzWorkloadsSapVirtualInstance](/powershell/module/az.workloads/Stop-AzWorkloadsSapVirtualInstance) command. Choose one of the following options:
70+
71+
- Use the Virtual Instance for SAP solutions resource `Name` and `ResourceGroupName` to identify the system that you want to stop.
7772

78-
Option 2:
73+
```powershell
74+
Stop-AzWorkloadsSapVirtualInstance -Name DB0 -ResourceGroupName db0-vis-rg `
75+
```
7976

80-
Use the InputObject parameter and pass the resource ID of the Virtual Instance for SAP solutions resource you intend to stop.
77+
- Use the `InputObject` parameter and pass the resource ID of the Virtual Instance for SAP solutions resource that you want to stop.
8178

82-
```powershell
79+
```powershell
8380
Stop-AzWorkloadsSapVirtualInstance -InputObject /subscriptions/sub1/resourceGroups/rg1/providers/Microsoft.Workloads/sapVirtualInstances/DB0 `
84-
```
81+
```
8582

86-
## Next steps
83+
## Related content
8784

8885
- [Monitor SAP system from the Azure portal](monitor-portal.md)

0 commit comments

Comments
 (0)