Skip to content

sap-linuxlab/community.sap_operations

Repository files navigation

community.sap_operations Ansible Collection

Ansible Lint

Description

This Ansible Collection executes various SAP Systems operational tasks, including:

  • Start, Stop and Restart of SAP Systems consisting of SAP Netweaver and SAP HANA.
  • Configuration of firewall with predefined ports for SAP products.
  • Configuration of SAP HANA Backint backups and their execution and cleanup.
  • Manages parameters in SAP profile files.
  • Execution of SAP HANA Replication takeover action in replicated environment.

Requirements

Component Control Node Managed Node
Operating System Any OS Red Hat Enterprise Linux for SAP Solutions 8.x, 9.x and 10.x
SUSE Linux Enterprise Server for SAP applications 15 SP5, 15 SP6, 15 SP7 and 16.0
Python 3.11 or higher 3.9 or higher
Ansible-Core 2.18 or higher N/A
Ansible 12 or higher N/A

Managed Node Registration
Operating system needs to have access to required package repositories either directly or via subscription registration.

Additional notes:

  • Version Compatibility: For a detailed mapping of supported Python versions and Ansible-Core life cycles, refer to the official Ansible-Core Support Matrix.
  • Control Node Permissions: Ensure the user executing the playbooks has the necessary SSH keys and sudo privileges configured for the target environment.

Installation Instructions

Installation

Install this collection with Ansible Galaxy command:

ansible-galaxy collection install community.sap_operations

Upgrade

Installed Ansible Collection will not be upgraded automatically when Ansible package is upgraded.

To upgrade the collection to the latest available version, run the following command:

ansible-galaxy collection install community.sap_operations --upgrade

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. Example of downgrading collection to version 1.0.0:

ansible-galaxy collection install community.sap_operations:==1.0.0

See Installing collections for more details on installation methods.

Use Cases

Ansible Roles

Name Summary
sap_control Executes predefined sapcontrol operations
sap_firewall Configures firewall with recommended rules for SAP Systems or custom ports
sap_hana_backint Executes range of actions to operate SAP HANA Backint Agents across different Cloud platforms
sap_hana_sr_takeover Executes Takeover operation on SAP HANA System with configured SAP HANA System Replication (HSR)
sap_profile_update Manages parameters in SAP profile files

Deprecated Roles

Name Summary
os_ansible_user Removed in favor of built in Ansible Module ansible.builtin.user
os_etchosts Removed in favor of Ansible Role community.sap_install.sap_maintain_etc_hosts
os_knownhosts Removed in favor of built in Ansible Module ansible.builtin.known_hosts
sap_fapolicy Removed in favor of Ansible Role linux_system_roles.fapolicyd
sap_rfc Deprecated because of SAP discontinued development and maintenance of the PyRFC library in 2024
sap_rhsm Removed in favor of Ansible Role linux_system_roles.rhc

Ansible Modules

NOTE: All included modules were deprecated in 2.0.0 release.

Testing

This Ansible Collection was tested across different Operating Systems, SAP products and scenarios. You can find examples of some of them below.

Operating systems:

  • Red Hat Enterprise Linux for SAP Solutions 8.x, 9.x and 10.x
  • SUSE Linux Enterprise Server for SAP applications 15 SP7 and 16.0

SAP Products:

  • SAP S/4HANA AnyPremise 2023
  • SAP BW/4HANA 2023
  • SAP HANA 2.0 SPS08

Contributing

For information on how to contribute, please see our contribution guidelines.

Contributors

We welcome contributions to this collection. For a list of all contributors and information on how you can get involved, please see our CONTRIBUTORS document.

Support

You can report any issues using Issues section.

Release Notes and Roadmap

You can find the release notes of this collection in Changelog file

Further Information

Variable Precedence Rules

Please follow Ansible Precedence guidelines on how to pass variables when using this collection.

License

Apache 2.0

About

Automation for SAP - Collection of Ansible Roles for various operational tasks with SAP Systems

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages