Skip to content

Commit d7d0a37

Browse files
Merge pull request #216699 from MSFTandrelom/andrelom-update
updating folder references and changing wording
2 parents d740814 + 13fdff8 commit d7d0a37

File tree

2 files changed

+16
-60
lines changed

2 files changed

+16
-60
lines changed

articles/sentinel/sap/deployment-solution-configuration.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -97,21 +97,22 @@ By default, all analytics rules provided in the Microsoft Sentinel Solution for
9797
7. Function module tested
9898
8. The SAP audit log monitoring analytics rules
9999

100-
## Reduce the amount of SAP log ingestion
100+
## Enabling and disabling the ingestion of specific SAP logs
101101

102-
To reduce the number of logs ingested into the Microsoft Sentinel workspace, you can stop ingestion for a specific log. To do this, edit the *systemconfig.ini* file, and for the relevant log, change the `True` value to `False`.
102+
It is possible to enable and disable the ingestion of a specific log. To do this, edit the *systemconfig.ini* file located under /opt/sapcon/SID/ directory on the connector Virtual Machine.
103+
Inside the configuration file you can pick a relevant log, change the value to `True` to enable the log or to `False` to disable the log.
103104

104-
For example, to stop the `ABAPJobLog`, change its value to `False`:
105+
For example, to stop ingesting the `ABAPJobLog`, change its value to `False`:
105106

106107
```
107108
ABAPJobLog = False
108109
```
109-
110-
You can also [stop the user master data tables](sap-solution-deploy-alternate.md#configuring-user-master-data-collection).
110+
The list of available logs can be found in the [systemconfig.ini reference](reference-systemconfig.md#logs-activation-status-section).
111+
It is also possible to [stop ingesting the user master data tables](sap-solution-deploy-alternate.md#configuring-user-master-data-collection).
111112

112113
> [!NOTE]
113114
>
114-
> Once you stop one of the logs, the workbooks and analytics queries that use that log may not work.
115+
> Once you stop one of the logs or tables, the workbooks and analytics queries that use that log may not work.
115116
> [Understand which log each workbook uses](sap-solution-security-content.md#built-in-workbooks) and [understand which log each analytic rule uses](sap-solution-security-content.md#built-in-analytics-rules).
116117
117118
## Stop log ingestion and disable the connector

articles/sentinel/sap/sap-deploy-troubleshoot.md

Lines changed: 9 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ docker logs -f sapcon-[SID]
3838

3939
**Enable debug mode printing**:
4040

41-
1. On your VM, edit the **sapcon/[SID]/systemconfig.ini** file.
41+
1. On your VM, edit the **/opt/sapcon/[SID]/systemconfig.ini** file.
4242

4343
1. Define the **General** section if it wasn't previously defined. In this section, define `logging_debug = True`.
4444

@@ -55,7 +55,7 @@ The change takes effect two minutes after you save the file. You don't need to r
5555

5656
**Disable debug mode printing**:
5757

58-
1. On your VM, edit the **sapcon/[SID]/systemconfig.ini** file.
58+
1. On your VM, edit the **/opt/sapcon/[SID]/systemconfig.ini** file.
5959

6060
1. In the **General** section, define `logging_debug = False`.
6161

@@ -70,54 +70,9 @@ The change takes effect two minutes after you save the file. You don't need to r
7070

7171
The change takes effect two minutes after you save the file. You don't need to restart the Docker container.
7272

73-
## View all Docker execution logs
73+
## View all container execution logs
7474

75-
To view all Docker execution logs for your Microsoft Sentinel Solution for SAP data connector deployment, run one of the following commands:
76-
77-
```bash
78-
docker exec -it sapcon-[SID] bash && cd /sapcon-app/sapcon/logs
79-
```
80-
81-
or
82-
83-
```bash
84-
docker exec –it sapcon-[SID] cat /sapcon-app/sapcon/logs/[FILE_LOGNAME]
85-
```
86-
87-
Output similar to the following should be displayed:
88-
89-
```bash
90-
Logs directory:
91-
root@644c46cd82a9:/sapcon-app# ls sapcon/logs/ -l
92-
total 508
93-
-rwxr-xr-x 1 root root 0 Mar 12 09:22 ' __init__.py'
94-
-rw-r--r-- 1 root root 282 Mar 12 16:01 ABAPAppLog.log
95-
-rw-r--r-- 1 root root 1056 Mar 12 16:01 ABAPAuditLog.log
96-
-rw-r--r-- 1 root root 465 Mar 12 16:01 ABAPCRLog.log
97-
-rw-r--r-- 1 root root 515 Mar 12 16:01 ABAPChangeDocsLog.log
98-
-rw-r--r-- 1 root root 282 Mar 12 16:01 ABAPJobLog.log
99-
-rw-r--r-- 1 root root 480 Mar 12 16:01 ABAPSpoolLog.log
100-
-rw-r--r-- 1 root root 525 Mar 12 16:01 ABAPSpoolOutputLog.log
101-
-rw-r--r-- 1 root root 0 Mar 12 15:51 ABAPTableDataLog.log
102-
-rw-r--r-- 1 root root 495 Mar 12 16:01 ABAPWorkflowLog.log
103-
-rw-r--r-- 1 root root 465311 Mar 14 06:54 API.log # view this log to see submits of data into Microsoft Sentinel
104-
-rw-r--r-- 1 root root 0 Mar 12 15:51 LogsDeltaManager.log
105-
-rw-r--r-- 1 root root 0 Mar 12 15:51 PersistenceManager.log
106-
-rw-r--r-- 1 root root 4830 Mar 12 16:01 RFC.log
107-
-rw-r--r-- 1 root root 5595 Mar 12 16:03 SystemAdmin.log
108-
```
109-
110-
To copy your logs to the host operating system, run:
111-
112-
```bash
113-
docker cp sapcon-[SID]:/sapcon-app/sapcon/logs /directory
114-
```
115-
116-
For example:
117-
118-
```bash
119-
docker cp sapcon-A4H:/sapcon-app/sapcon/logs /tmp/sapcon-logs-extract
120-
```
75+
Connector execution logs for your Microsoft Sentinel Solution for SAP data connector deployment are stored in **/opt/sapcon/[SID]/log**. Log filename is **OmniLog.log**. A history of logfiles is kept, suffixed with *.<number>* such as **OmniLog.log.1**, **OmniLog.log.2** etc
12176

12277
## Review and update the Microsoft Sentinel for SAP data connector configuration
12378

@@ -139,7 +94,7 @@ The following steps reset the connector and reingest SAP logs from the last 30 m
13994
docker stop sapcon-[SID]
14095
```
14196

142-
1. Delete the **metadata.db** file from the **sapcon/[SID]** directory. Run:
97+
1. Delete the **metadata.db** file from the **/opt/sapcon/[SID]** directory. Run:
14398

14499
```bash
145100
cd /opt/sapcon/<SID>
@@ -182,7 +137,7 @@ Docker cp SDK by running docker cp nwrfc750P_8-70002752.zip /sapcon-app/inst/
182137

183138
If ABAP runtime errors appear on large systems, try setting a smaller chunk size:
184139

185-
1. Edit the **sapcon/[SID]/systemconfig.ini** file and in the **Connector Configuration** section define `timechunk = 5`.
140+
1. Edit the **/opt/sapcon/[SID]/systemconfig.ini** file and in the **Connector Configuration** section define `timechunk = 5`.
186141

187142
For example:
188143

@@ -286,7 +241,7 @@ If you attempt to retrieve an audit log, without the [required change request](p
286241

287242
While your system should automatically switch to compatibility mode if needed, you may need to switch it manually. To switch to compatibility mode manually:
288243

289-
1. Edit the **sapcon/[SID]/systemconfig.ini** file
244+
1. Edit the **/opt/sapcon/[SID]/systemconfig.ini** file
290245

291246
1. In the **Connector Configuration** section defineefine: `auditlogforcexal = True`
292247

@@ -335,10 +290,10 @@ To check for misconfigurations, run the **RSDBTIME** report in transaction **SE3
335290
docker stop sapcon-[SID]
336291
```
337292

338-
1. Delete the **metadata.db** file from the **sapcon/[SID]** directory. Run:
293+
1. Delete the **metadata.db** file from the **/opt/sapcon/[SID]** directory. Run:
339294

340295
```bash
341-
rm ~/sapcon/[SID]/metadata.db
296+
rm /opt/sapcon/[SID]/metadata.db
342297
```
343298

344299
1. Update the SAP system and the SAP host operating system to have matching settings, such as the same time zone. For more information, see the [SAP Community Wiki](https://wiki.scn.sap.com/wiki/display/Basis/Time+zone+settings%2C+SAP+vs.+OS+level).

0 commit comments

Comments
 (0)