Skip to content

Commit 333ba88

Browse files
Stacyrch140Stacyrch140
authored
Merge pull request #231284 from KimForss/main
Add guidance on extending
2 parents 38f1459 + d61e4d3 commit 333ba88

File tree

1 file changed

+94
-30
lines changed

1 file changed

+94
-30
lines changed

‎articles/sap/automation/configure-sap-parameters.md

Lines changed: 94 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -21,36 +21,49 @@ This table contains the default parameters defined by the framework.
2121

2222
### User IDs
2323

24+
This table contains the IDs for the SAP users and groups for the different platforms.
25+
26+
> [!div class="mx-tdCol2BreakAll "]
27+
> | Parameter | Description | Default Value |
28+
> | ------------------------------- | -------------------------------------------------------------------------- | ---------------------------- |
29+
> | HANA | | |
30+
> | `sapadm_uid` | The UID for the sapadm account. | 2100 |
31+
> | `sidadm_uid` | The UID for the sidadm account. | 2003 |
32+
> | `hdbadm_uid` | The UID for the hdbadm account. | 2200 |
33+
> | `sapinst_gid` | The GID for the sapinst group. | 2001 |
34+
> | `sapsys_gid` | The GID for the sapsys group. | 2000 |
35+
> | `hdbshm_gid` | The GID for the hdbshm group. | 2002 |
36+
> | DB2 | | |
37+
> | `db2sidadm_uid` | The UID for the db2sidadm account. | 3004 |
38+
> | `db2sapsid_uid` | The UID for the db2sapsid account. | 3005 |
39+
> | `db2sysadm_gid` | The UID for the db2sysadm group. | 3000 |
40+
> | `db2sysctrl_gid` | The UID for the db2sysctrl group. | 3001 |
41+
> | `db2sysmaint_gid` | The UID for the db2sysmaint group. | 3002 |
42+
> | `db2sysmon_gid` | The UID for the db2sysmon group. | 2003 |
43+
> | ORACLE | | |
44+
> | `orasid_uid` | The UID for the orasid account. | 3100 |
45+
> | `oracle_uid` | The UID for the oracle account. | 3101 |
46+
> | `observer_uid` | The UID for the observer account. | 4000 |
47+
> | `dba_gid` | The GID for the dba group. | 3100 |
48+
> | `oper_gid` | The GID for the oper group. | 3101 |
49+
> | `asmoper_gid` | The GID for the asmoper group. | 3102 |
50+
> | `asmadmin_gid` | The GID for the asmadmin group. | 3103 |
51+
> | `asmdba_gid` | The GID for the asmdba group. | 3104 |
52+
> | `oinstall_gid` | The GID for the oinstall group. | 3105 |
53+
> | `backupdba_gid` | The GID for the backupdba group. | 3106 |
54+
> | `dgdba_gid` | The GID for the dgdba group. | 3107 |
55+
> | `kmdba_gid` | The GID for the kmdba group. | 3108 |
56+
> | `racdba_gid` | The GID for the racdba group. | 3108 |
57+
58+
59+
### Windows parameters
60+
61+
This table contains the information pertinent to Windows deployments.
62+
2463
> [!div class="mx-tdCol2BreakAll "]
25-
> | Parameter | Description | Default Value | Type |
26-
> | ------------------------- | -------------------------------------------------------------------------- | ---------------------------- | ---------- |
27-
> | `sapadm_uid` | The UID for the sapadm account. | 2100 | Required |
28-
> | `sidadm_uid` | The UID for the sidadm account. | 2003 | Required |
29-
> | `hdbadm_uid` | The UID for the hdbadm account. | 2200 | Required |
30-
> | `sapinst_gid` | The GID for the sapinst group. | 2001 | Required |
31-
> | `sapsys_gid` | The GID for the sapsys group. | 2000 | Required |
32-
> | `hdbshm_gid` | The GID for the hdbshm group. | 2002 | Required |
33-
> | | | | |
34-
> | `db2sidadm_uid` | The UID for the db2sidadm account. | 3004 | Required |
35-
> | `db2sapsid_uid` | The UID for the db2sapsid account. | 3005 | Required |
36-
> | `db2sysadm_gid` | The UID for the db2sysadm group. | 3000 | Required |
37-
> | `db2sysctrl_gid` | The UID for the db2sysctrl group. | 3001 | Required |
38-
> | `db2sysmaint_gid` | The UID for the db2sysmaint group. | 3002 | Required |
39-
> | `db2sysmon_gid` | The UID for the db2sysmon group. | 2003 | Required |
40-
> | | | | |
41-
> | `orasid_uid` | The UID for the orasid account. | 3100 | Required |
42-
> | `oracle_uid` | The UID for the oracle account. | 3101 | Required |
43-
> | `observer_uid` | The UID for the observer account. | 4000 | Required |
44-
> | `dba_gid` | The GID for the dba group. | 3100 | Required |
45-
> | `oper_gid` | The GID for the oper group. | 3101 | Required |
46-
> | `asmoper_gid` | The GID for the asmoper group. | 3102 | Required |
47-
> | `asmadmin_gid` | The GID for the asmadmin group. | 3103 | Required |
48-
> | `asmdba_gid` | The GID for the asmdba group. | 3104 | Required |
49-
> | `oinstall_gid` | The GID for the oinstall group. | 3105 | Required |
50-
> | `backupdba_gid` | The GID for the backupdba group. | 3106 | Required |
51-
> | `dgdba_gid` | The GID for the dgdba group. | 3107 | Required |
52-
> | `kmdba_gid` | The GID for the kmdba group. | 3108 | Required |
53-
> | `racdba_gid` | The GID for the racdba group. | 3108 | Required |
64+
> | Parameter | Description | Default Value |
65+
> | ------------------------------- | -------------------------------------------------------------------------- | ---------------------------- |
66+
> | `mssserver_version` | SQL Server version | `mssserver2019` |
5467
5568

5669
## Parameters
@@ -77,16 +90,20 @@ This table contains the parameters stored in the sap-parameters.yaml file, most
7790
> | `ers_instance_number` | Defines the instance number for ERS | Required |
7891
> | `ers_lb_ip` | IP address of ERS instance | Required |
7992
> | `pas_instance_number` | Defines the instance number for PAS | Required |
93+
> | `web_sid` | The SID for the Web Dispatcher | Required if web dispatchers are deployed |
94+
> | `scs_clst_lb_ip` | IP address of Windows Cluster service | Required |
8095
8196
### Database Tier
8297

8398
> [!div class="mx-tdCol2BreakAll "]
8499
> | Parameter | Description | Type |
85100
> | ------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------- |
86101
> | `db_sid` | The SID of the SAP database | Required |
102+
> | `db_instance_number` | Defines the instance number for the database | Required |
87103
> | `db_high_availability` | Defines if the database is deployed highly available | Required |
88104
> | `db_lb_ip` | IP address of the database load balancer | Required |
89105
> | `platform` | The database platform. Valid values are: ASE, DB2, HANA, ORACLE, SQLSERVER | Required |
106+
> | `db_clst_lb_ip` | IP address of database cluster for Windows | Required |
90107
91108
### NFS
92109

@@ -98,6 +115,26 @@ This table contains the parameters stored in the sap-parameters.yaml file, most
98115
> | `sap_trans` | The NFS path for sap_trans | Required |
99116
> | `usr_sap_install_mountpoint` | The NFS path for usr/sap/install | Required |
100117
118+
### Azure NetApp Files
119+
> [!div class="mx-tdCol2BreakAll "]
120+
> | Parameter | Description | Type |
121+
> | ---------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------- |
122+
> | `hana_data` | The NFS path for hana_data volumes | Required |
123+
> | `hana_log` | The NFS path for hana_log volumes | Required |
124+
> | `hana_shared` | The NFS path for hana_shared volumes | Required |
125+
> | `usr_sap` | The NFS path for /usr/sap volumes | Required |
126+
127+
### Windows support
128+
129+
> [!div class="mx-tdCol2BreakAll "]
130+
> | Parameter | Description | Type |
131+
> | ---------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------- |
132+
> | `domain_name` | Defines the Windows domain name, for example sap.contoso.net. | Required |
133+
> | `domain` | Defines the Windows domain Netbios name, for example sap. | Optional |
134+
> | SQL | | |
135+
> | `use_sql_for_SAP` | Uses the SAP defined SQL Server media, defaults to 'true' | Optional |
136+
> | `win_cluster_share_type` | Defines the cluster type (CSD/FS), defaults to CSD | Optional |
137+
101138
### Miscellaneous
102139

103140
> [!div class="mx-tdCol2BreakAll "]
@@ -106,6 +143,7 @@ This table contains the parameters stored in the sap-parameters.yaml file, most
106143
> | `kv_name` | The name of the Azure key vault containing the system credentials | Required |
107144
> | `secret_prefix` | The prefix for the name of the secrets for the SID stored in key vault | Required |
108145
> | `upgrade_packages` | Update all installed packages on the virtual machines | Required |
146+
> | `use_msi_for_clusters` | Use managed identities for fencing | Required |
109147
110148
### Disks
111149

@@ -161,7 +199,7 @@ In order to install the Oracle backend using the SAP on Azure Deployment Automat
161199
> | `ora_release` | The Oracle release version, for example 19.0.0 | Required |
162200
> | `oracle_sbp_patch` | The Oracle SBP patch file name | Required |
163201

164-
### Shared Home support
202+
#### Shared Home support
165203

166204
To configure shared home support for Oracle, you need to add a dictionary defining the SIDs to be deployed. You can do that by adding the parameter 'MULTI_SIDS' that contains a list of the SIDs and the SID details.
167205

@@ -184,6 +222,32 @@ Each row must specify the following parameters.
184222
> | `app_inst_no` | The APP instance number for the instance | Required |
185223

186224

225+
## Overriding the default parameters
226+
227+
You can override the default parameters by either specifying them in the sap-parameters.yaml file or by passing them as command line parameters to the Ansible playbooks.
228+
229+
For example if you want to override the default value of the group ID for the sapinst group (`sapinst_gid`) parameter, you can do it by adding the following line to the sap-parameters.yaml file:
230+
231+
```yaml
232+
sapinst_gid: 1000
233+
```
234+
235+
If you want to provide them as parameters for the Ansible playbooks, you can do it by adding the following parameter to the command line:
236+
237+
```bash
238+
ansible-playbook -i hosts SID_hosts.yaml --extra-vars "sapinst_gid=1000" .....
239+
```
240+
241+
You can also override the default parameters by specifying them in the `configuration_settings' variable in your tfvars file. For example, if you want to override 'sapinst_gid' your tfvars file should contain the following line:
242+
243+
```terraform
244+
configuration_settings = {
245+
sapinst_gid = "1000"
246+
}
247+
```
248+
249+
250+
187251
## Next steps
188252

189253
> [!div class="nextstepaction"]

0 commit comments

Comments
 (0)