This Ansible Collection provides roles and modules to automate interaction with SAP Launchpad API, primarily focusing on downloading software and files from the SAP Software Download Center and Maintenance Planner.
Included role and modules cover range of options:
- Preparation of environment before download.
- Download of specific SAP Software files.
- Download of alternative SAP Software files if specific was not available.
- Download of SAP Software files from existing Maintenance Plan transaction.
- Download of Stack file from existing Maintenance Plan transaction.
- Register Systems and License Keys
- Query registered Systems
| Type | Version |
|---|---|
| Operating system | Any operating system with required Python and Ansible versions |
| Python | 3.11 or higher |
| Ansible | 9.9 or higher |
| Ansible-core | 2.16 or higher |
| Type | Version |
|---|---|
| Operating system | SUSE Linux Enterprise Server 15 SP5+, 16 Red Hat Enterprise Linux 8.x, 9.x, 10.x |
| Python | 3.11 or higher (SUSE) 3.9 or higher (Red Hat) |
NOTE: Operating system needs to have access to required package repositories either directly or via subscription registration.
Install this collection with Ansible Galaxy command:
ansible-galaxy collection install community.sap_launchpadOptionally you can include collection in requirements.yml file and include it together with other collections using: ansible-galaxy collection install -r requirements.yml
Requirements file need to be maintained in following format:
collections:
- name: community.sap_launchpadInstalled 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_launchpad --upgradeYou 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_launchpad:==1.0.0
See Installing collections for more details on installation methods.
| Name | Summary |
|---|---|
| sap_launchpad.software_center_download | Search and download SAP Software file |
| sap_launchpad.maintenance_planner_files | Get list of files from Maintenance Planner |
| sap_launchpad.maintenance_planner_stack_xml_download | Get stack file from Maintenance Planner |
| Name | Summary |
|---|---|
| sap_software_download | Prepare environment and download SAP Software files or Maintenance Plan transaction files |
This Ansible Collection was tested across different Operating Systems and SAP products.
| Type | Version |
|---|---|
| Operating system | SUSE Linux Enterprise Server 15 SP5+, 16 Red Hat Enterprise Linux 8.x, 9.x, 10.x |
| Python | 3.11, 3.12 |
| Ansible | 9, 10, 11 |
| Ansible-core | 2.16, 2.17, 2.18 |
You can find more information about ways you can contribute at sap-linuxlab website.
You can report any issues using Issues section.
You can find the release notes of this collection in Changelog file
SAP software files must be obtained from SAP directly, and requires valid license agreements with SAP in order to access these files.
An SAP Company Number (SCN) contains one or more Installation Number/s, providing licenses for specified SAP Software. When an SAP User ID is created within the SAP Customer Number (SCN), the administrator must provide SAP Download authorizations for the SAP User ID.
When an SAP User ID (e.g. S-User) is enabled with and part of an SAP Universal ID, then the sap_launchpad Ansible Collection must use:
- the SAP User ID
- the password for login with the SAP Universal ID
In addition, if a SAP Universal ID is used then the recommendation is to check and reset the SAP User ID ‘Account Password’ in the SAP Universal ID Account Manager, which will help to avoid any potential conflicts.
For further information regarding connection errors, please see the FAQ section Errors with prefix 'SAP SSO authentication failed - '.
Multi Factor Authentication is not supported.
Please follow Ansible Precedence guidelines on how to pass variables when using this collection.