Skip to content

Commit dda01a3

Browse files
author
Suzi Zuber
committed
Update provider-netweaver.md
1 parent 0405ff3 commit dda01a3

File tree

1 file changed

+25
-25
lines changed

1 file changed

+25
-25
lines changed

articles/sap/monitor/provider-netweaver.md

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -5,22 +5,22 @@ author: MightySuz
55
ms.service: sap-on-azure
66
ms.subservice: sap-monitor
77
ms.topic: article
8-
ms.date: 11/02/2022
8+
ms.date: 08/22/2024
99
ms.author: sujaj
1010
#Customer intent: As a developer, I want to configure a SAP NetWeaver provider so that I can use Azure Monitor for SAP solutions.
1111
---
1212

1313

1414
# Configure SAP NetWeaver for Azure Monitor for SAP solutions
1515

16-
In this how-to guide, you'll learn to configure the SAP NetWeaver provider for use with *Azure Monitor for SAP solutions*.
16+
In this how-to guide, learn how to configure the SAP NetWeaver provider for use with *Azure Monitor for SAP solutions*.
1717

1818
User can select between the two connection types when configuring SAP Netweaver provider to collect information from SAP system. Metrics are collected by using
1919

2020
- **SAP Control** - The SAP start service provides multiple services, including monitoring the SAP system. Both versions of Azure Monitor for SAP solutions use **SAP Control**, which is a SOAP web service interface that exposes these capabilities. The **SAP Control** interface [differentiates between protected and unprotected web service methods](https://wiki.scn.sap.com/wiki/display/SI/Protected+web+methods+of+sapstartsrv). It's necessary to unprotect some methods to use Azure Monitor for SAP solutions with NetWeaver.
2121
- **SAP RFC** - Azure Monitor for SAP solutions also provides ability to collect additional information from the SAP system using Standard SAP RFC. It's available only as part of Azure Monitor for SAP solution.
2222

23-
You can collect the below metric using SAP NetWeaver Provider
23+
You can collect the following metric using SAP NetWeaver Provider:
2424

2525
- SAP system and application server availability (for example Instance process availability of dispatcher,ICM,Gateway,Message server,Enqueue Server,IGS Watchdog) (SAP Control)
2626
- Work process usage statistics and trends (SAP Control)
@@ -46,7 +46,7 @@ You can collect the below metric using SAP NetWeaver Provider
4646

4747
## Configure NetWeaver for Azure Monitor for SAP solutions
4848

49-
To configure the NetWeaver provider for the current Azure Monitor for SAP solutions version, you'll need to:
49+
To configure the NetWeaver provider for the current Azure Monitor for SAP solutions version, you need to do the following:
5050

5151
1. [Prerequisite - Unprotect methods for metrics](#prerequisite-unprotect-methods-for-metrics)
5252
1. [Prerequisite to enable RFC metrics](#prerequisite-to-enable-rfc-metrics)
@@ -90,8 +90,8 @@ to unprotect the web-methods in the SAP Windows virtual machine.
9090
9191
### Prerequisite to enable RFC metrics
9292
93-
RFC metrics are only supported for **AS ABAP applications** and do not apply to SAP JAVA systems. This step is **mandatory** when the connection type selected is **SOAP+RFC**.
94-
Below steps need to be performed as a pre-requisite to enable RFC
93+
RFC metrics are only supported for **AS ABAP applications** and don't apply to SAP JAVA systems. This step is **mandatory** when the connection type selected is **SOAP+RFC**.
94+
Below steps need to be performed as a prerequisite to enable RFC
9595
9696
1. **Create or upload role** in the SAP NW ABAP system. Azure Monitor for SAP solutions requires this role to connect to SAP. The role uses the least privileged access. Download and unzip [Z_AMS_NETWEAVER_MONITORING.zip](https://github.com/MicrosoftDocs/azure-docs-pr/files/12528831/Z_AMS_NETWEAVER_MONITORING.zip)
9797
@@ -112,29 +112,29 @@ Below steps need to be performed as a pre-requisite to enable RFC
112112
4. **Enable SICF Services** to access the RFC via the SAP Internet Communication Framework (ICF)
113113
1. Go to transaction code **SICF**.
114114
1. Go to the service path `/default_host/sap/bc/soap/`.
115-
1. Activate the services **wsdl**, **wsdl11** and **RFC**.
115+
1. Activate the services **wsdl**, **wsdl11, and **RFC**.
116116
117-
It's also recommended to check that you enabled the ICF ports.
117+
It's recommended to check that you enabled the ICF ports.
118118
119-
4. **SMON** - Enable **SMON** to monitor the system performance.Make sure the version of **ST-PI** is **SAPK-74005INSTPI**.
120-
You'll see empty visualization as part of the workbook when it isn't configured.
119+
4. **SMON** - Enable **SMON** to monitor the system performance. Make sure the version of **ST-PI** is **SAPK-74005INSTPI**.
120+
You see empty visualization as part of the workbook when it isn't configured.
121121
122122
1. Enable the **SDF/SMON** snapshot service for your system. Turn on daily monitoring. For instructions, see [SAP Note 2651881](https://userapps.support.sap.com/sap/support/knowledge/2651881).
123123
2. Configure **SDF/SMON** metrics to be aggregated every minute.
124124
3. Recommended scheduling **SDF/SMON** as a background job in your target SAP client each minute.
125-
4. If you notice empty visualization as part of the workbook tab "System Performance - CPU and Memory (/SDF/SMON)", please apply the below SAP note:
126-
1. Release 740 SAPKB74006-SAPKB74025 - Release 755 Until SAPK-75502INSAPBASIS. For specific support package versions please refer to the SAP NOTE.- [SAP Note 2246160](https://launchpad.support.sap.com/#/notes/2246160).
127-
2. If the metric collection does not work with the above note then please try - [SAP Note 3268727](https://launchpad.support.sap.com/#/notes/3268727)
125+
4. If you notice empty visualization as part of the workbook tab "System Performance - CPU and Memory (/SDF/SMON)", apply the following SAP note:
126+
1. Release 740 SAPKB74006-SAPKB74025 - Release 755 Until SAPK-75502INSAPBASIS. For specific support package versions, refer to the SAP NOTE.- [SAP Note 2246160](https://launchpad.support.sap.com/#/notes/2246160).
127+
2. If the metric collection doesn't work with the previous note, try - [SAP Note 3268727](https://launchpad.support.sap.com/#/notes/3268727)
128128
129129
6. **To enable secure communication**
130130
131-
To [enable TLS 1.2 or higher](enable-tls-azure-monitor-sap-solutions.md) with SAP NetWeaver provider please execute steps mentioned on this [SAP document](https://help.sap.com/docs/ABAP_PLATFORM_NEW/e73bba71770e4c0ca5fb2a3c17e8e229/4923501ebf5a1902e10000000a42189c.html?version=201909.002)
131+
To [enable TLS 1.2 or higher](enable-tls-azure-monitor-sap-solutions.md) with SAP NetWeaver provider, execute the steps mentioned in the [SAP document](https://help.sap.com/docs/ABAP_PLATFORM_NEW/e73bba71770e4c0ca5fb2a3c17e8e229/4923501ebf5a1902e10000000a42189c.html?version=201909.002)
132132
133133
**Check if SAP systems are configured for secure communication using TLS 1.2 or higher**
134134
135135
1. Go to transaction RZ10.
136-
2. Open DEFAULT profile, select Extended Maintenance and click change.
137-
3. Below configuration is for TLS1.2 the bit mask will be 544: PFS. If TLS version is higher, then bit mask will be greater than 544.
136+
2. Open DEFAULT profile, select Extended Maintenance and select change.
137+
3. The following configuration is for TLS1.2, the bit mask will be 544: PFS. If the TLS version is higher, the bit mask will be greater than 544.
138138
139139
![tlsimage1](https://user-images.githubusercontent.com/74435183/219510020-0b26dacd-be34-4441-bf44-f3198338d416.png)
140140
@@ -160,24 +160,24 @@ Ensure all the prerequisites are successfully completed. To add the NetWeaver pr
160160
3. For **System ID (SID)**, enter the three-character SAP system identifier.
161161
4. For **Application Server**, enter the IP address or the fully qualified domain name (FQDN) of the SAP NetWeaver system to monitor. For example, `sapservername.contoso.com` where `sapservername` is the hostname and `contoso.com` is the domain. If you're using a hostname, make sure there's connectivity from the virtual network that you used to create the Azure Monitor for SAP solutions resource.
162162
5. For **Instance number**, specify the instance number of SAP NetWeaver (00-99)
163-
6. For **Connection type** - select either [SOAP](#prerequisite-unprotect-methods-for-metrics) + [RFC](#prerequisite-to-enable-rfc-metrics) or [SOAP](#prerequisite-unprotect-methods-for-metrics) based on the metric collected (refer above section for details)
163+
6. For **Connection type** - select either [SOAP](#prerequisite-unprotect-methods-for-metrics) + [RFC](#prerequisite-to-enable-rfc-metrics) or [SOAP](#prerequisite-unprotect-methods-for-metrics) based on the metric collected (refer to the previous section for details)
164164
7. For **SAP client ID**, provide the SAP client identifier.
165165
8. For **SAP ICM HTTP Port**, enter the port that the ICM is using, for example, 80(NN) where (NN) is the instance number.
166166
9. For **SAP username**, enter the name of the user that you created to connect to the SAP system.
167167
10. For **SAP password**, enter the password for the user.
168168
11. For **Host file entries**, provide the DNS mappings for all SAP VMs associated with the SID
169169
Enter **all SAP application servers and ASCS** host file entries in **Host file entries**. Enter host file mappings in comma-separated format. The expected format for each entry is IP address, FQDN, hostname. For example: **192.X.X.X sapservername.contoso.com sapservername,192.X.X.X sapservername2.contoso.com sapservername2**.
170-
To determine all SAP hostnames associated with the SID, Sign in to the SAP system using the `sidadm` user. Then, run the following command (or) you can leverage the script below to generate the hostfile entries.
170+
To determine all SAP hostnames associated with the SID, Sign in to the SAP system using the `sidadm` user. Then, run the following command (or) you can use the following script to generate the host file entries.
171171
172172
Command to find a list of instances associated with a given SID
173173
174174
```bash
175175
/usr/sap/hostctrl/exe/sapcontrol -nr <instancenumber> -function GetSystemInstanceList
176176
```
177177
178-
**Scripts to generate hostfile entries**
178+
**Scripts to generate host file entries**
179179
180-
We highly recommend following the detailed instructions in the [link](https://github.com/Azure/Azure-Monitor-for-SAP-solutions-preview/tree/main/Provider_Pre_Requisites/SAP_NetWeaver_Pre_Requisites/GenerateHostfileMappings) for generating hostfile entries. These entries are crucial for the successful creation of the Netweaver provider for your SAP system.
180+
We highly recommend following the detailed instructions in the [link](https://github.com/Azure/Azure-Monitor-for-SAP-solutions-preview/tree/main/Provider_Pre_Requisites/SAP_NetWeaver_Pre_Requisites/GenerateHostfileMappings) for generating host file entries. These entries are crucial for the successful creation of the Netweaver provider for your SAP system.
181181
182182
## Troubleshooting for SAP Netweaver Provider
183183
@@ -186,8 +186,8 @@ Ensure all the prerequisites are successfully completed. To add the NetWeaver pr
186186
1. **Unable to reach the SAP hostname. ErrorCode: SOAPApiConnectionError**
187187
188188
1. Check the input hostname, instance number, and host file mappings for the hostname provided.
189-
2. Follow the instruction for determining the [hostfile entries](#adding-netweaver-provider) Host file entries section.
190-
3. Ensure the NSG/firewall is not blocking the port – 5XX13 or 5XX14. (XX - SAP Instance Number)
189+
2. Follow the instruction for determining the [host file entries](#adding-netweaver-provider) Host file entries section.
190+
3. Ensure the NSG/firewall isn't blocking the port – 5XX13 or 5XX14. (XX - SAP Instance Number)
191191
4. Check if AMS and SAP VMs are in the same vNet or are attached using vNet peering.
192192
193193
If not attached, see the following [link](/azure/virtual-network/tutorial-connect-virtual-networks-portal) to connect vNets:
@@ -252,10 +252,10 @@ Ensure all the prerequisites are successfully completed. To add the NetWeaver pr
252252
253253
2. Batch job metrics
254254
255-
If you notice empty visualization as part of the workbook tab "Application Performance -Batch Jobs (SM37)", please apply the below SAP note
255+
If you notice empty visualization as part of the workbook tab "Application Performance -Batch Jobs (SM37)", apply the following SAP note
256256
[SAP Note 2469926](https://launchpad.support.sap.com/#/notes/2469926) in your SAP System.
257257
258-
After you apply this OSS note you need to execute the RFC function module - BAPI_XMI_LOGON_WS with the following parameters:
258+
Once you apply the OSS note, you need to execute the RFC function module - BAPI_XMI_LOGON_WS with the following parameters:
259259
260260
This function module has the same parameters as BAPI_XMI_LOGON but stores them in the table BTCOPTIONS.
261261
@@ -266,7 +266,7 @@ Ensure all the prerequisites are successfully completed. To add the NetWeaver pr
266266
267267
4. SWNC metrics
268268
269-
To ensure a successful retrieval of the SWNC metrics, it is essential to confirm that both the SAP system and the operating system (OS) have synchronized times.
269+
To ensure a successful retrieval of the SWNC metrics, you must confirm that the SAP system and the operating system (OS) have synchronized times.
270270
271271
## Next steps
272272

0 commit comments

Comments
 (0)