Skip to content

Commit ee4f366

Browse files
authored
Merge pull request #908 from sap-linuxlab/dev
merge dev to main for release 1.5.0
2 parents c1b479e + 37a3d48 commit ee4f366

File tree

578 files changed

+12948
-5374
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

578 files changed

+12948
-5374
lines changed

.yamllint.yml

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
# SPDX-License-Identifier: Apache-2.0
12
---
23
# Based on ansible-lint config
34
extends: default
@@ -7,7 +8,9 @@ rules:
78
brackets: {max-spaces-inside: 1, level: error}
89
# colons: {max-spaces-after: -1, level: error}
910
# commas: {max-spaces-after: -1, level: error}
10-
comments: disable
11+
comments:
12+
require-starting-space: false
13+
min-spaces-from-content: 1
1114
comments-indentation: disable
1215
# document-start: disable
1316
# empty-lines: {max: 3, level: error}
@@ -19,3 +22,6 @@ rules:
1922
# new-lines: {type: unix}
2023
# trailing-spaces: disable
2124
truthy: disable
25+
octal-values:
26+
forbid-implicit-octal: true
27+
forbid-explicit-octal: true

CHANGELOG.rst

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,82 @@ community.sap_install Release Notes
55
.. contents:: Topics
66

77

8+
v1.5.0
9+
======
10+
11+
Release Summary
12+
---------------
13+
- Release Date: 2024-11-29
14+
15+
This is a minor release of the `community.sap_install` collection.
16+
17+
Major Changes
18+
-------------
19+
- feat: collection: Readme overhaul for all roles in collection (https://github.com/sap-linuxlab/community.sap_install/pull/873)
20+
- feat: sap_ha_pacemaker_cluster: JAVA HA scenarios and complete refactor of role (https://github.com/sap-linuxlab/community.sap_install/pull/882)
21+
- feat: sap_ha_pacemaker_cluster: Stonith SBD enablement (https://github.com/sap-linuxlab/community.sap_install/pull/829)
22+
- feat: sap_swpm: New improved and simplified version (https://github.com/sap-linuxlab/community.sap_install/pull/840)
23+
24+
Minor Changes
25+
-------------
26+
- feat: collection: Add playbook for direct execution (https://github.com/sap-linuxlab/community.sap_install/pull/842)
27+
- feat: sap_ha_pacemaker_cluster: New azure fence agent package for SUSE (https://github.com/sap-linuxlab/community.sap_install/pull/837)
28+
- feat: sap_ha_pacemaker_cluster: Enhance corosync totem handling with new dictionaries (https://github.com/sap-linuxlab/community.sap_install/pull/834)
29+
- feat: sap_ha_pacemaker_cluster: GCP VIP reworked, Health check names updated (https://github.com/sap-linuxlab/community.sap_install/pull/863)
30+
- feat: sap_swpm: Option to enable SWPM observer mode (https://github.com/sap-linuxlab/community.sap_install/pull/749)
31+
- feat: sap_storage_setup: Add support for HANA Scaleout NFS filesystems (https://github.com/sap-linuxlab/community.sap_install/pull/800)
32+
- feat: sap_storage_setup: Add exact size disk check on top of approximate check (https://github.com/sap-linuxlab/community.sap_install/pull/839)
33+
- feat: sap_hana_install: Implement an SAP HANA installation check only feature (https://github.com/sap-linuxlab/community.sap_install/pull/849)
34+
- collection: Add collection dependency for community.general (https://github.com/sap-linuxlab/community.sap_install/pull/808)
35+
- collection: Modify for yamllint requirements (https://github.com/sap-linuxlab/community.sap_install/pull/811)
36+
- sap_ha_pacemaker_cluster: Add override to use Classic SAPHanaSR agents (https://github.com/sap-linuxlab/community.sap_install/pull/806)
37+
- sap_ha_pacemaker_cluster: Packages on AWS for RHEL (https://github.com/sap-linuxlab/community.sap_install/pull/857)
38+
- sap_ha_pacemaker_cluster: GCP haproxy handling and new platform VIP dictionary (https://github.com/sap-linuxlab/community.sap_install/pull/862)
39+
- sap_ha_pacemaker_cluster: vip resources must be first in ASCS/ERS resource groups (https://github.com/sap-linuxlab/community.sap_install/pull/872)
40+
- sap_swpm: Remove the pids module (https://github.com/sap-linuxlab/community.sap_install/pull/786)
41+
- sap_swpm: sap_swpm_db_schema_password must be set explicitly for AAS (https://github.com/sap-linuxlab/community.sap_install/pull/760)
42+
- sap_swpm: hdbuserstore default connection should use sap_swpm_db_schema_abap_password (https://github.com/sap-linuxlab/community.sap_install/pull/748)
43+
- sap_swpm: Add default value for sap_swpm_java_scs_instance_hostname (https://github.com/sap-linuxlab/community.sap_install/pull/801)
44+
- sap_swpm: Reduce the amount of empty lines in inifile.params (https://github.com/sap-linuxlab/community.sap_install/pull/822)
45+
- sap_storage_setup: Defaults and documentation (https://github.com/sap-linuxlab/community.sap_install/pull/825)
46+
- sap_general_preconfigure: Use the package module in most cases (https://github.com/sap-linuxlab/community.sap_install/pull/758)
47+
- sap_general_preconfigure: Use FQCN for import_role (https://github.com/sap-linuxlab/community.sap_install/pull/827)
48+
- sap_hana_preconfigure: Add RHEL 8.10 and 9.4 requirements (https://github.com/sap-linuxlab/community.sap_install/pull/869)
49+
- sap_hana_preconfigure: Zypper lock handler for SUSE (https://github.com/sap-linuxlab/community.sap_install/pull/796)
50+
- sap_hana_preconfigure: Enable TSX also for RHEL 9 (https://github.com/sap-linuxlab/community.sap_install/pull/797)
51+
- sap_hana_preconfigure: Sync with SAP note 3024346 v.10 for RHEL/NetApp (https://github.com/sap-linuxlab/community.sap_install/pull/816)
52+
- sap_hana_preconfigure: Refactor remove default saptune version (https://github.com/sap-linuxlab/community.sap_install/pull/818)
53+
- sap_hana_preconfigure: Update azure override readme (https://github.com/sap-linuxlab/community.sap_install/pull/820)
54+
- sap_hana_preconfigure: Set THP to madvise from RHEL 9.2 onwards (https://github.com/sap-linuxlab/community.sap_install/pull/880)
55+
- sap_hana_preconfigure: Allow setting THP to any possible value (https://github.com/sap-linuxlab/community.sap_install/pull/886)
56+
- sap_hana_preconfigure: No longer set net.core.somaxconn in RHEL 9 (https://github.com/sap-linuxlab/community.sap_install/pull/887)
57+
- sap_hana_preconfigure: Add compat-sap-c++-13 (https://github.com/sap-linuxlab/community.sap_install/pull/895)
58+
- sap_netweaver_preconfigure: Rename package libcpupower1 for SLES4SAP 15 SP6 (https://github.com/sap-linuxlab/community.sap_install/pull/876)
59+
- sap_netweaver_preconfigure: Sync with applicable SAP notes for Adobe DS (https://github.com/sap-linuxlab/community.sap_install/pull/888)
60+
- sap_hana_install: Use polling for hdblcm (https://github.com/sap-linuxlab/community.sap_install/pull/805)
61+
- sap_hana_install: Set the install execution mode to 'optimized' (https://github.com/sap-linuxlab/community.sap_install/pull/896)
62+
- sap_install_media_detect: AWS IGW slow impacts gpg key (https://github.com/sap-linuxlab/community.sap_install/pull/772)
63+
- sap_install_media_detect: Search known subdirs on re-run (https://github.com/sap-linuxlab/community.sap_install/pull/773)
64+
- sap_install_media_detect: Append loop labels (https://github.com/sap-linuxlab/community.sap_install/pull/781)
65+
- sap_install_media_detect: Allow disabling RAR handling (https://github.com/sap-linuxlab/community.sap_install/pull/856)
66+
- sap_ha_install_anydb_ibmdb2: Append ibmcloud_vs (https://github.com/sap-linuxlab/community.sap_install/pull/815)
67+
68+
Bugfixes
69+
--------
70+
- sap_ha_pacemaker_cluster: Add python3-pip and NFS fix for Azure (https://github.com/sap-linuxlab/community.sap_install/pull/754)
71+
- sap_ha_pacemaker_cluster: Fix pcs resource restart (https://github.com/sap-linuxlab/community.sap_install/pull/769)
72+
- sap_ha_pacemaker_cluster: Fix haproxy and minor lint issues (https://github.com/sap-linuxlab/community.sap_install/pull/898)
73+
- sap_ha_pacemaker_cluster: Fix UUID discovery for IBM Cloud VS (https://github.com/sap-linuxlab/community.sap_install/pull/903)
74+
- sap_swpm: Add error notes to dev doc (https://github.com/sap-linuxlab/community.sap_install/pull/795)
75+
- sap_swpm: Fix error when observer user defined, but empty and observer mode is on (https://github.com/sap-linuxlab/community.sap_install/pull/850)
76+
- sap_swpm: Fix issues with localhost delegation on certain control nodes (https://github.com/sap-linuxlab/community.sap_install/pull/891)
77+
- sap_*_preconfigure: Fixes for testing with molecule (https://github.com/sap-linuxlab/community.sap_install/pull/807)
78+
- sap_*_preconfigure: Edge case handling for SUSE packages
79+
- sap_general_preconfigure: Reboot fix in handler (https://github.com/sap-linuxlab/community.sap_install/pull/892)
80+
- sap_ha_install_hana_hsr: Fixes to work for multiple secondaries (https://github.com/sap-linuxlab/community.sap_install/pull/866)
81+
- sap_ha_install_anydb_ibmdb2: Linting and sles bug fixes (https://github.com/sap-linuxlab/community.sap_install/pull/803)
82+
83+
884
v1.4.1
985
======
1086

README.md

Lines changed: 120 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -2,48 +2,143 @@
22

33
![Ansible Lint](https://github.com/sap-linuxlab/community.sap_install/actions/workflows/ansible-lint.yml/badge.svg?branch=main)
44

5-
This Ansible Collection executes various SAP Software installations and configuration tasks for running various SAP solutions and deployment scenarios on Linux operating systems (RHEL or SLES).
5+
## Description
66

7-
This includes handlers for SAP HANA database lifecycle manager (HDBLCM) and SAP Software Provisioning Manager (SWPM), and can be combined with other Ansible Collections to provide end-to-end automation _(e.g. provision, download, install, operations)_.
7+
This Ansible Collection executes various SAP Software installations and configuration tasks for various SAP solutions and deployment scenarios on supported Linux operating systems.
88

9+
Included roles cover range of tasks:
10+
- Preparation of Operating system and SAP installation media before installation
11+
- Installation of SAP Database, either SAP HANA or Oracle Database
12+
- Installation of SAP Products, like SAP S4HANA, SAP BW4HANA, SAP Netweaver, SAP Solution Manager and others.
13+
- Configuration of replication of SAP HANA and High Availability clusters for SAP HANA and SAP Netweaver
914

10-
**Examples of verified installations include:**
1115

16+
## Requirements
17+
18+
### Control Nodes
19+
Operating system:
20+
- Any operating system with required Python and Ansible versions.
21+
22+
Python: 3.11 or higher
23+
24+
Ansible: 9.9.x
25+
26+
Ansible-core: 2.16.x
27+
28+
**NOTE: Ansible 10 and ansible-core 2.17.x are not supported, because of breaking changes requiring higher Python version on managed nodes.**
29+
30+
### Managed Nodes
31+
Operating system:
32+
- SUSE Linux Enterprise Server for SAP applications 15 SP5+ (SLE4SAP)
33+
- Red Hat Enterprise Linux for SAP Solutions 8.x 9.x (RHEL4SAP)
34+
35+
**NOTE: Operating system needs to have access to required package repositories either directly or via subscription registration.**
36+
37+
38+
Python: 3.6 or higher
39+
40+
41+
## Installation Instructions
42+
43+
### Installation
44+
Install this collection with Ansible Galaxy command:
45+
```console
46+
ansible-galaxy collection install community.sap_install
47+
```
48+
49+
Optionally you can include collection in requirements.yml file and include it together with other collections using: `ansible-galaxy collection install -r requirements.yml`
50+
Requirements file need to be maintained in following format:
51+
```yaml
52+
collections:
53+
- name: community.sap_install
54+
```
55+
56+
### Upgrade
57+
Installed Ansible Collection will not be upgraded automatically when Ansible package is upgraded.
58+
59+
To upgrade the collection to the latest available version, run the following command:
60+
```console
61+
ansible-galaxy collection install community.sap_install --upgrade
62+
```
63+
64+
You can also install a specific version of the collection, when you encounter issues with latest version. Please report these issues in affected Role repository if that happens.
65+
Example of downgrading collection to version 1.4.0:
66+
```
67+
ansible-galaxy collection install community.sap_install:==1.4.0
68+
```
69+
70+
See [Installing collections](https://docs.ansible.com/ansible/latest/collections_guide/collections_installing.html) for more details on installation methods.
71+
72+
73+
## Use Cases
74+
75+
### Example Scenarios
76+
- Preparation of Operating system for SAP installation
77+
- Preparation of SAP installation media for SAP installation
78+
- Installation of SAP HANA (including High Availability with replication) or Oracle Database
79+
- Installation of SAP S4HANA or other SAP products
80+
- Configuration of Pacemaker cluster for SAP HANA and SAP Netweaver
81+
82+
More deployment scenarios are available in [ansible.playbooks_for_sap](https://github.com/sap-linuxlab/ansible.playbooks_for_sap) repository.
83+
84+
### Ansible Roles
85+
All included roles can be executed independently or as part of [ansible.playbooks_for_sap](https://github.com/sap-linuxlab/ansible.playbooks_for_sap) playbooks.
86+
87+
| Name | Summary |
88+
| :--- | :--- |
89+
| [sap_anydb_install_oracle](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_anydb_install_oracle) | Install Oracle DB 19.x for SAP |
90+
| [sap_general_preconfigure](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_general_preconfigure) | Configure general OS settings for SAP software |
91+
| [sap_ha_install_hana_hsr](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_ha_install_hana_hsr) | Configure and enable SAP HANA System Replication |
92+
| [sap_ha_pacemaker_cluster](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_ha_pacemaker_cluster) | Configure Pacemaker cluster for SAP HANA and SAP Netweaver |
93+
| [sap_hana_install](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_hana_install) | Install SAP HANA via HDBLCM |
94+
| [sap_hana_preconfigure](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_hana_preconfigure) | Configure OS settings for SAP HANA database server |
95+
| [sap_hostagent](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_hostagent) | Install SAP Host Agent |
96+
| [sap_install_media_detect](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_install_media_detect) | Detect and extract SAP Software installation media |
97+
| [sap_maintain_etc_hosts](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_maintain_etc_hosts) | Maintain the /etc/hosts file of an SAP software host |
98+
| [sap_netweaver_preconfigure](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_netweaver_preconfigure) | Configure OS settings for SAP NetWeaver application server |
99+
| [sap_storage_setup](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_storage_setup) | Configure storage for SAP system (Folder structure, LVM, XFS, NFS) |
100+
| [sap_swpm](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_swpm) | Install SAP Software via SWPM |
101+
102+
103+
## Testing
104+
This Ansible Collection was tested across different Operating Systems, SAP products and scenarios. You can find examples of some of them below.
105+
106+
Operating systems:
107+
- SUSE Linux Enterprise Server for SAP applications 15 SP5+ (SLE4SAP)
108+
- Red Hat Enterprise Linux for SAP Solutions 8.x 9.x (RHEL4SAP)
109+
110+
Deployment scenarios:
111+
- All scenarios included in [ansible.playbooks_for_sap](https://github.com/sap-linuxlab/ansible.playbooks_for_sap) repository
112+
113+
SAP Products:
12114
- SAP S/4HANA AnyPremise (1809, 1909, 2020, 2021, 2022, 2023) with setup as Standard, Distributed, High Availability and optional Maintenance Planner or Restore System Copy
13115
- SAP Business Suite (ECC) on HANA and SAP Business Suite (ECC) with SAP AnyDB - SAP ASE, SAP MaxDB, IBM Db2, Oracle DB
14116
- SAP BW/4HANA (2021, 2023) with setup as Standard or Scale-Out
15117
- SAP HANA 2.0 (SPS04+) with setup as Scale-Up, Scale-Out, High Availability
16118
- Other SAP installation activities; such as System Rename, System Copy Export, SAP Solution Manager and SAP Web Dispatcher
17119

120+
**NOTE: It is not possible to test every Operating System and SAP Product combination with every release. Testing is regularly done for common scenarios: SAP HANA, SAP HANA HA, SAP S4HANA Distributed HA**
18121

19-
**Please read the [full documentation](/docs#readme) for how-to guidance, requirements, and all other details. Summary documentation is below:**
122+
## Contributing
123+
You can find more information about ways you can contribute at [sap-linuxlab website](https://sap-linuxlab.github.io/initiative_contributions/).
20124

21125

22-
## Contents
126+
## Support
127+
You can report any issues using [Issues](https://github.com/sap-linuxlab/community.sap_install/issues) section.
23128

24-
Within this Ansible Collection, there are various Ansible Roles and no custom Ansible Modules.
25129

26-
### Ansible Roles
130+
## Release Notes and Roadmap
131+
You can find the release notes of this collection in [Changelog file](https://github.com/sap-linuxlab/community.sap_install/blob/main/CHANGELOG.rst)
27132

28-
| Name | Summary |
29-
| :--- | :--- |
30-
| [sap_anydb_install_oracle](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_anydb_install_oracle) | install Oracle DB 19.x for SAP |
31-
| [sap_general_preconfigure](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_general_preconfigure) | configure general OS settings for SAP software |
32-
| [sap_ha_install_hana_hsr](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_ha_install_hana_hsr) | install SAP HANA System Replication |
33-
| [sap_ha_pacemaker_cluster](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_ha_pacemaker_cluster) | install and configure pacemaker and SAP resources |
34-
| [sap_hana_install](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_hana_install) | install SAP HANA via HDBLCM |
35-
| [sap_hana_preconfigure](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_hana_preconfigure) | configure settings for SAP HANA database server |
36-
| [sap_hostagent](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_hostagent) | install SAP Host Agent |
37-
| [sap_install_media_detect](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_install_media_detect) | detect and extract SAP Software installation media |
38-
| [sap_maintain_etc_hosts](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_maintain_etc_hosts) | maintain the /etc/hosts file of an SAP software host |
39-
| [sap_netweaver_preconfigure](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_netweaver_preconfigure) | configure settings for SAP NetWeaver application server |
40-
| [sap_storage_setup](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_storage_setup) | configure storage for SAP HANA, with LVM partitions and XFS filesystem |
41-
| [sap_swpm](https://github.com/sap-linuxlab/community.sap_install/tree/main/roles/sap_swpm) | install SAP Software via SWPM |
42133

43-
## License
134+
## Further Information
44135

45-
- [Apache 2.0](./LICENSE)
136+
### Variable Precedence Rules
137+
Please follow [Ansible Precedence guidelines](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_variables.html#variable-precedence-where-should-i-put-a-variable) on how to pass variables when using this collection.
46138

47-
## Contributors
139+
### Getting Started
140+
More information on how to execute Ansible playbooks is in [Getting started guide](https://github.com/sap-linuxlab/community.sap_install/blob/main/docs/getting_started/README.md).
48141

49-
Contributors to the Ansible Roles within this Ansible Collection, are shown within [/docs/contributors](./docs/CONTRIBUTORS.md).
142+
143+
## License
144+
[Apache 2.0](https://github.com/sap-linuxlab/community.sap_install/blob/main/LICENSE)

0 commit comments

Comments
 (0)