Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

sap_swpm: add error notes to dev doc #795

Merged
merged 1 commit into from
Jul 8, 2024
Merged

sap_swpm: add error notes to dev doc #795

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
235 changes: 232 additions & 3 deletions docs/developer_notes/sap_swmp_dev.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
# sap_swpm Ansible Role DEVELOPER NOTES

## Errors with missing signature files for installation media
## Common Errors

After SWPM 1.0 SP22 and SAP SWPM 2.0 SP00, all SAP Software installation media requires a separate signature file (SIGNATURE.SMF). The signature file is missing in older installation media.
### Error - Missing signature files for installation media

For example, IDES for SAP ECC 6.0 EhP8. See the following error message and SAP Note 2622019 - "EXPORT_1 is not signed" error during IDES installation.
```shell
INFO
DU at '/software_path/51052029_1/EXP1' is not signed.
Expand All @@ -16,6 +15,236 @@ SOLUTION: Ensure that you use the latest available version of Installation Expor
Not accepted
```

After SWPM 1.0 SP22 and SAP SWPM 2.0 SP00, all SAP Software installation media requires a separate signature file (SIGNATURE.SMF). The signature file is missing in older installation media.

For example, IDES for SAP ECC 6.0 EhP8. See the following error message and SAP Note 2622019 - "EXPORT_1 is not signed" error during IDES installation.


### Error - NIECONN_REFUSED

```shell
FAIL: NIECONN_REFUSED
```

During SAP SWPM execution, it is common to see this **FALSE positive** error message. This is often due to restart of SAP NetWeaver AS in the installation procedures.

If this error occurs and SAP SWPM does not succeed, execute `sapcontrol -nr <Instance_Number> -function StartService <SAPSID>` to ensure that sapstartsrv is running and debug the underlying cause of the error; such as Network Port blocked, incorrect /etc/hosts file etc that is causing issues starting SAP NetWeaver AS.


### Error - Unprivileged users have permissions

```shell
Group of installation directory '/xxxxx/' is root, not sapinst.

Unprivileged users have permissions 'rx' instead of no permissions at all on directory 'xxxxx/'
```

During SAP SWPM execution, user group permissions on directories are verified.

If this error occurs, verify with `getent group` to ensure sapinst has more users than root; such as: `sapinst:x:<<NUMBER>>:root,<<SID>>adm`

To resolve, ensure the SWPM Unattended Parameter `nwUsers.sapsysGID` is set but remove any value from it. For example, in `sap_swpm` Ansible Role with default mode execution:
```yaml
sap_swpm_sapadm_uid: ""
sap_swpm_sapsys_gid: ""
sap_swpm_sidadm_uid: ""
```


### Error - No Profile used

```shell
sapparam(1c): No Profile used
```

During SAP SWPM execution, a target profile directory is created (auto-populated by the `sap_swpm` Ansible Role).

If this error occurs, it may cause additional errors such as `getProfileDir reported an error: Empty directory name is not allowed`.

To resolve, ensure the SWPM Unattended Parameter `NW_readProfileDir.profileDir` is set and has been provided a string path with the SAP System ID (e.g. `/sapmnt/<SID>/profile`). For example, in `sap_swpm` Ansible Role with default mode execution:
```yaml
sap_swpm_sid: "S01"
sap_swpm_inifile_list:
- nw_config_other
...

```

Alternatively, use Shell environment variable named `SAPSYSTEMNAME=` when executing `./sapinst`.


### Error - Wrong password for SYSTEM user of the SYSTEMDB Tenant for SAP HANA MDC

```shell
NW_GetSidNoProfiles | NW_getDBInfo | NW_HDB_getDBInfo

Error code FCO-00011 and MUT-03025

The step getDBInfoMultiDbSystemDB reported an error:
The database connection with database user SYSTEM cannot be set up.
Check that the database is online and the password of user SYSTEM is correct.
```

During SAP SWPM execution, a connection to the SAP HANA MDC SystemDB Tenant is required.

To resolve, ensure the SWPM Unattended Parameter `NW_HDB_getDBInfo.systemDbPassword` is set and correct. For example, in `sap_swpm` Ansible Role with default mode execution:
```yaml
sap_swpm_db_systemdb_password: "Password"
```


### Error - Wrong password for SYSTEM user of the target SAP HANA MDC Tenant

```shell
NW_GetSidNoProfiles | NW_getDBInfo | NW_HDB_getDBInfo

Error code FCO-00011 and MUT-03025

The step getDBInfo reported an error:
The database connection with database user SYSTEM cannot be set up.
Check that the database is online and the password of user SYSTEM is correct.
```

During SAP SWPM execution, a connection to the SAP HANA MDC Tenant target and database schema (e.g. `SAPHANADB` or `SAPABAP1`) is required.

To resolve, ensure the SWPM Unattended Parameter `storageBasedCopy.hdb.systemPassword` and `NW_HDB_getDBInfo.systemPassword` is set and correct. For example, in `sap_swpm` Ansible Role with default mode execution:
```yaml
sap_swpm_db_system_password: "Password"
```

This may also occur after System Copy Database Backup Restore when the wrong password is given for SYSTEM user of the Database Schema (e.g. `SAPHANADB` or `SAPABAP1`). Such as the error below:

```Shell
NW_CreateDBandLoad | NW_CreateDB | NW_HDB_DB

The step RevalidateSystemuserPassword reported an error:
Start SAPinst in interactive mode to solve this problem.
```

To resolve, ensure the SWPM Unattended Parameter `HDB_Schema_Check_Dialogs.schemaPassword` is correctly set. For example, in `sap_swpm` Ansible Role with default mode execution:
```yaml
sap_swpm_db_system_password: "Password"
sap_swpm_db_schema_password: "Password"
```


### Error - Wrong password for SYSTEM user of Database Schema for the SAP HANA Backup file

```shell
NW_CreateDBandLoad | NW_CreateDB | NW_HDB_DB

The step RevalidateSchemauserPassword reported an error:
The database connection with database user SYSTEM cannot be set up.
Check that the database is online and the password of user SYSTEM is correct.
```

During SAP SWPM execution, when using a Database Backup File the SYSTEM user of the Database Schema within the backup (e.g. `SAPHANADB`, or `SAPABAP1`) is required.

To resolve, ensure the SWPM Unattended Parameter `NW_HDB_getDBInfo.systemPasswordBackup` value is the correct password. For example, in `sap_swpm` Ansible Role with default mode execution:
```yaml
sap_swpm_backup_system_password: "Password"
```


### Error - Wrong password for DDIC user of Database Schema for the SAP HANA Backup file

```shell
NW_CI_Instance | abapReports | NW_DDIC_Password

ERROR (root/sapinst) id=rfcmod.jsco.wrongPassword
The step checkDDIC000Password was executed with status ERROR
The password you specified for user DDIC is wrong.
<p> SOLUTION: Enter the correct password. </p>
```

During SAP SWPM execution, when using a Database Backup File the DDIC user of the Database Schema within the backup (e.g. `SAPHANADB`, or `SAPABAP1`) is required after the data load occurs.

To resolve, ensure the SWPM Unattended Parameter `NW_DDIC_Password.ddic000Password` value is the correct password. For example, in `sap_swpm` Ansible Role with default mode execution:
```yaml
sap_swpm_ddic_000_password: "Password"
```


### Error - Wrong schema name for database connection set up

```shell
The database connection with database user SYSTEM cannot be set up.
Check that the database is online and the password of the user SYSTEM is correct
```

During SAP SWPM execution, when using a Database Backup File Database Schema name is required after the data load occurs.

To resolve, ensure the SWPM Unattended Parameter for the Database Schema (e.g. `HDB_Schema_Check_Dialogs.schemaName` for SAP HANA) is set and provided with the correct schema name (e.g. `SAPHANADB` , `SAPABAP1` based upon different SAP Software and versions). For example, in `sap_swpm` Ansible Role with default mode execution:
```yaml
sap_swpm_db_schema: "SAPABAP1"
```


### Error - Wrong domain name

```shell
NW_GetSidNoProfiles | NW_getFQDN

The step askFQDN reported an error:
Cannot resolve host 'xxxxxx' by name
```

During SAP SWPM execution, the FQDN is used for connections.

To resolve, ensure the SWPM Unattended Parameter `NW_getFQDN.FQDN` for the FQDN is correct. For example, in `sap_swpm` Ansible Role with default mode execution:
```yaml
sap_swpm_set_fqdn: true
sap_swpm_fqdn: "name.internal.corp"
```


### Error - Restricted file permissions for current working directory

```shell
NW_First_Steps | Preinstall

The step checkInstDirPermissions was executed with status ERROR
The installation directory /xxxxx is not owned by group <i>sapinst</i>.
<p> SOLUTION: SAPinst will set the appropriate permission on the directory if you choose <i>Ok</i>. </p>
```

During SAP SWPM execution, the current working directory should be `0755` permission.

This should be achieved automatically by the `sap_swpm` Ansible Role, whereby the variable `sap_swpm_sapinst_path: /path_here` is set to `0755` prior to execution of `sapinst`.


### Error - Incomplete parameters for Database Backup Restore and connection set up

```shell
NWCreateDBandLoad | hdb_recovery_dialogs

The step ask_recovery_connect_data_existing_database reported an error
```

During SAP SWPM execution, when using a Database Backup File additional variables are required for the data load.

To resolve, ensure the SWPM Unattended PArameters below are set:
```shell
HDB_Recovery_Dialogs.backupLocation = ""
HDB_Recovery_Dialogs.backupName = ""
HDB_Recovery_Dialogs.sapControlWsdlUrl = "http://HOST:PORT/SAPControl?wsdl"
HDB_Recovery_Dialogs.sidAdmName = ""
HDB_Recovery_Dialogs.sidAdmPassword = ""
```

For example, in `sap_swpm` Ansible Role with default mode execution:
```yaml
sap_swpm_backup_location: ""
sap_swpm_backup_prefix: ""
sap_swpm_db_host: ""
sap_swpm_db_instance_nr: ""
sap_swpm_db_sid: ""
sap_swpm_db_sidadm_password: ""
```


---


## SAP SWPM for SAP NWAS JAVA installations

Expand Down
Loading