diff --git a/README.md b/README.md index 236055d..48a752c 100644 --- a/README.md +++ b/README.md @@ -29,20 +29,88 @@ Added role to download SAP SWDC downloadbasket content. Added role to download SAP software from SWDC. -# Ansible Collection - sap.sap_operations +# sap.sap_operations -This collection contains modules and plugins to assist in automating SAP day 2 operations with Ansible. +Ansible collection to automate SAP operations -## Installation and Usage +## Description + +Ansible roles, modules and plugins to automate SAP operations. + +Following use cases are covered in this collection: + +- SAP HANA Automation + +- SAP Netweaver Automation + +- SAP ABAP automation + +- SAP Software Download Automation + +- SAP host automation (sap host agent related functionality) + +- Automation for pacemaker cluster in context of SAP (HANA and NW clusters) + +- SAP BTP automation + +See playbook examples in playbook folder. + +## Installation ```bash ansible-galaxy collection install sap.sap_operations + +ansible-galaxy collection install sap.sap_operations --upgrade ``` Role `prepare` will make sure that all necessary package dependencies are installed on RHEL host, so content from this collection can be executed. Please see documentation for role `prepare`. +## Use cases + +- SAP HANA update + +- SAP NW kernel update + +- get information about current SAP landscape + +- manage SAP BTP global account and subaccounts + +- download SAP software from SWDC + +- install SAP cloud connector + +- manage SAP license information + +- start / stop / restart SAP system + +- get status and configuration information about SAP clusters + +- manage SAP ASCS and ERS locks + +- manage SAP transport requests in ABAP systems + +- get configuration information from SAP ABAP system + +- run non invasive SAP quality checks and get results + +- run non invasive cluster configuration checks + +- unpack SAP software from archives + +- validate SAP system id (SID) + +## Testing + +Collection tested automatically using ansible molecule and Azure molecule driver + +Ansible plugins and modules are covered with python unit and integration tests. + +Test cover RHEL 7, RHEL 8 and RHEL 9 - supported versions. + +Supported (and thus tested) ansible-core and python versions on controller and managed hosts see below. + ## Requirements ### Ansible @@ -53,7 +121,41 @@ ansible-core 2.15 ansible-core 2.16 -### Python +ansible-core 2.17 + +## Contributing + +Contributions are accepted at - galaxy branch. + +See details in that repository. + +## Support + +This collection is community supported. + +If support is needed, please use collection from AAP. + + + +## Release Notes and Roadmap + +## Related Information + +Collection documentation located at + + + +## License Information + +GPL-3.0-only + +GNU General Public License v3.0 + +See for details + +2022 - 2024 (c) Project Atmosphere + +### Python supported versions Ansible collection is designed to work with following python versions on controller host @@ -98,9 +200,3 @@ Not all python and ansible version combination are expected to work. Please use Collection is supported as part of Red Hat Ansible Automation Platform subscription with limitations described in Ansible Automation support policy. - -## LICENSE - -GNU General Public License v3.0 - -See for details diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 9b0660a..95b2913 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -2,129 +2,145 @@ **Topics** -- v1\.30\.1 +- v1\.30\.2 - Release Summary - Minor Changes -- v1\.30\.0 +- v1\.30\.1 - Release Summary - - Major Changes - Minor Changes -- v1\.29\.0 +- v1\.30\.0 - Release Summary -- v1\.28\.0 - - Release Summary - - Major Changes + - Major Changes - Minor Changes -- v1\.27\.0 +- v1\.29\.0 + - Release Summary +- v1\.28\.0 - Release Summary + - Major Changes - Minor Changes -- v1\.26\.0 +- v1\.27\.0 - Release Summary -- v1\.25\.0 + - Minor Changes +- v1\.26\.0 - Release Summary -- v1\.24\.0 +- v1\.25\.0 - Release Summary -- v1\.23\.1 +- v1\.24\.0 - Release Summary +- v1\.23\.1 + - Release Summary - Major Changes - v1\.23\.0 - - Release Summary + - Release Summary - Major Changes - v1\.22\.1 - - Release Summary - - Minor Changes -- v1\.22\.0 - Release Summary + - Minor Changes +- v1\.22\.0 + - Release Summary - v1\.21\.0 - v1\.20\.0 - - Release Summary + - Release Summary - Major Changes - v1\.19\.0 - - Release Summary + - Release Summary - Major Changes - v1\.18\.0 - v1\.17\.0 - - Release Summary + - Release Summary - Major Changes - v1\.16\.0 - v1\.15\.1 - - Release Summary - - Minor Changes -- v1\.15\.0 - Release Summary + - Minor Changes +- v1\.15\.0 + - Release Summary - Major Changes - v1\.14\.1 - - Release Summary - - Minor Changes + - Release Summary + - Minor Changes - v1\.14\.0 - v1\.13\.0 - - Release Summary + - Release Summary - Major Changes - v1\.12\.0 - - Release Summary -- v1\.11\.0 - Release Summary - - Minor Changes -- v1\.10\.0 +- v1\.11\.0 - Release Summary -- v1\.9\.1 - - Release Summary - Minor Changes -- v1\.9\.0 +- v1\.10\.0 + - Release Summary +- v1\.9\.1 - Release Summary + - Minor Changes +- v1\.9\.0 + - Release Summary - Major Changes - v1\.3\.2 - - Release Summary - - Minor Changes -- v1\.3\.1 - Release Summary - Minor Changes -- v1\.3\.0 +- v1\.3\.1 - Release Summary - Minor Changes -- v1\.2\.2 +- v1\.3\.0 - Release Summary - Minor Changes -- v1\.2\.1 +- v1\.2\.2 - Release Summary - Minor Changes -- v1\.2\.0 +- v1\.2\.1 - Release Summary + - Minor Changes +- v1\.2\.0 + - Release Summary - Major Changes - v1\.1\.2 - - Release Summary - - Minor Changes -- v1\.1\.1 - Release Summary - Minor Changes -- v1\.1\.0 +- v1\.1\.1 - Release Summary -- v1\.0\.5 - - Release Summary - Minor Changes -- v1\.0\.4 +- v1\.1\.0 + - Release Summary +- v1\.0\.5 - Release Summary - - Major Changes - Minor Changes -- v1\.0\.3 +- v1\.0\.4 - Release Summary + - Major Changes - Minor Changes -- v1\.0\.2 +- v1\.0\.3 - Release Summary + - Minor Changes +- v1\.0\.2 + - Release Summary - Major Changes - v1\.0\.0 - - Release Summary + - Release Summary - Major Changes + +## v1\.30\.2 + + +### Release Summary + +Lifecycle release + + +### Minor Changes + +* update collection readme file as per recommendations from Ansible Partners organization + ## v1\.30\.1 - + ### Release Summary Bugfix release - + ### Minor Changes * add additional checks to roles sapjvm and cloudconnector to detect if download failed @@ -134,7 +150,7 @@ Bugfix release ## v1\.30\.0 - + ### Release Summary Feature release @@ -145,7 +161,7 @@ Feature release * role \- download \- download SAP software from SWDC * role \- downloadbasket \- download SAP SWDC download basket content - + ### Minor Changes * fix issue with missing python3\-suds package on RHEL 9 @@ -153,7 +169,7 @@ Feature release ## v1\.29\.0 - + ### Release Summary Feature release @@ -161,7 +177,7 @@ Feature release ## v1\.28\.0 - + ### Release Summary Feature and bugfix release @@ -172,7 +188,7 @@ Feature and bugfix release * add role powershell \- to manage powershell installation * add role quality \- run SAP quality checks on Azure hosts - + ### Minor Changes * fix issue with host\_info module @@ -182,12 +198,12 @@ Feature and bugfix release ## v1\.27\.0 - + ### Release Summary Feature release - + ### Minor Changes * Add tags to collection metadata @@ -196,7 +212,7 @@ Feature release ## v1\.26\.0 - + ### Release Summary Feature release @@ -204,7 +220,7 @@ Feature release ## v1\.25\.0 - + ### Release Summary Feature release @@ -212,7 +228,7 @@ Feature release ## v1\.24\.0 - + ### Release Summary Feature release @@ -220,7 +236,7 @@ Feature release ## v1\.23\.1 - + ### Release Summary Documentation release @@ -233,7 +249,7 @@ Documentation release ## v1\.23\.0 - + ### Release Summary Maintenance release @@ -246,12 +262,12 @@ Maintenance release ## v1\.22\.1 - + ### Release Summary Documentation release - + ### Minor Changes * generate CHANGELOG in MD format @@ -260,7 +276,7 @@ Documentation release ## v1\.22\.0 - + ### Release Summary Feature release @@ -271,7 +287,7 @@ Feature release ## v1\.20\.0 - + ### Release Summary Feature release @@ -284,7 +300,7 @@ Feature release ## v1\.19\.0 - + ### Release Summary Feature release @@ -300,7 +316,7 @@ Feature release ## v1\.17\.0 - + ### Release Summary Feature release @@ -316,12 +332,12 @@ Feature release ## v1\.15\.1 - + ### Release Summary Bugfix release - + ### Minor Changes * Update documentation for several modules @@ -329,7 +345,7 @@ Bugfix release ## v1\.15\.0 - + ### Release Summary Feature release @@ -342,12 +358,12 @@ Feature release ## v1\.14\.1 - + ### Release Summary Bug fix release - + ### Minor Changes * Fix ansible\-lint errors @@ -359,7 +375,7 @@ Bug fix release ## v1\.13\.0 - + ### Release Summary Feature release @@ -372,7 +388,7 @@ Feature release ## v1\.12\.0 - + ### Release Summary Feature release @@ -380,12 +396,12 @@ Feature release ## v1\.11\.0 - + ### Release Summary Feature release - + ### Minor Changes * Add role pcs\_config\_checks @@ -393,7 +409,7 @@ Feature release ## v1\.10\.0 - + ### Release Summary Feature release @@ -401,12 +417,12 @@ Feature release ## v1\.9\.1 - + ### Release Summary Bug fix release - + ### Minor Changes * Fix bug with hana\_update role @@ -415,7 +431,7 @@ Bug fix release ## v1\.9\.0 - + ### Release Summary Lifecycle release @@ -433,12 +449,12 @@ Lifecycle release ## v1\.3\.2 - + ### Release Summary Bugfix release - + ### Minor Changes * Resolve sanity errors for python 2\.7 and lower versions of python 3 @@ -446,12 +462,12 @@ Bugfix release ## v1\.3\.1 - + ### Release Summary Bugfix release - + ### Minor Changes * Resolve syntax issues with hana\_update role @@ -459,12 +475,12 @@ Bugfix release ## v1\.3\.0 - + ### Release Summary Feature release - + ### Minor Changes * Add functionality to release different content to AAP and Ansible galaxy @@ -474,12 +490,12 @@ Feature release ## v1\.2\.2 - + ### Release Summary Feature release - + ### Minor Changes * Small changes to role argument\_specs \- fixes documentation linting errors @@ -487,12 +503,12 @@ Feature release ## v1\.2\.1 - + ### Release Summary Feature release - + ### Minor Changes * Collection automatically uploaded to Ansible Galaxy and AAP @@ -500,7 +516,7 @@ Feature release ## v1\.2\.0 - + ### Release Summary Feature release @@ -513,12 +529,12 @@ Feature release ## v1\.1\.2 - + ### Release Summary Bug Fix Release - + ### Minor Changes * Fix issue with role prepare @@ -526,12 +542,12 @@ Bug Fix Release ## v1\.1\.1 - + ### Release Summary Bug Fix Release - + ### Minor Changes * Fix issue with module host\_info \- module failed if SAP HANA databases installed \(incorrect indexing\) @@ -542,7 +558,7 @@ Bug Fix Release ## v1\.1\.0 - + ### Release Summary Feature Release @@ -550,12 +566,12 @@ Feature Release ## v1\.0\.5 - + ### Release Summary Bug fix release - + ### Minor Changes * Documentation added for roles hana\_update and prepare @@ -563,7 +579,7 @@ Bug fix release ## v1\.0\.4 - + ### Release Summary Two roles are added hana\_update and prepare @@ -574,7 +590,7 @@ Two roles are added hana\_update and + ### Minor Changes * GitHub action to publish collection @@ -582,12 +598,12 @@ Two roles are added hana\_update and ## v1\.0\.3 - + ### Release Summary Using changelog fragments to build collection changelog\. - + ### Minor Changes * Improvements in the collection build and publish process\. @@ -596,7 +612,7 @@ Using changelog fragments to build collection changelog\. ## v1\.0\.2 - + ### Release Summary First release of SAP Operations collection\. @@ -613,7 +629,7 @@ First release of SAP Operations collection\. ## v1\.0\.0 - + ### Release Summary First release of SAP Operations collection\. diff --git a/galaxy.yml b/galaxy.yml index 64430c1..2200c44 100644 --- a/galaxy.yml +++ b/galaxy.yml @@ -24,7 +24,7 @@ namespace: sap name: sap_operations -version: 1.30.1 +version: 1.30.2 readme: README.md