sap.sap_operations.unpack role – Role to unpack *.sar and *.zip files.

Note

This role is part of the sap.sap_operations collection.

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install sap.sap_operations.

To use it in a playbook, specify: sap.sap_operations.unpack.

Entry point main – Role to unpack *.sar and *.zip files.

Synopsis

  • Role to unpack *.sar and *.zip files.

  • This role is NOT idempotent for *.sar files. Meaning it will unpack all the *.sar files every time role is executed.

  • For unpacking *.zip files Ansible module ansible.builtin.unarchive is used and this module is idempotent.

  • Role prerequisites: * ‘unzip’ is installed (will not be installed by this role), if ‘unzip’ command is missing, role will fail. * SAPCAR should be installed in ‘sap_operations_sapcar_exe_path’ (default value /usr/sap/sapcar/sapcar). If SAPCAR is not installed at ‘sap_operations_sapcar_exe_path’ role will fail. Ansible user has to have permissions to execute SAPCAR. ```

Parameters

Parameter

Comments

unpack_destination

string / required

Folder where files will be unpacked. If folder does not exist, it will be created. Ansible user has to have permissions to create the folder and write to the folder if it already exists.

unpack_manifest

boolean

Flag to unpack SAPCAR archives using option “-manifest SIGNATURE.SMF”. If set to true option “-manifest SIGNATURE.SMF” will be used

Choices:

  • false

  • true ← (default)

unpack_sapcar_exe_path

string

Path to SAPCAR executable file. SAPCAR should be installed as a prerequisite for this role. This variable is equivalent to sap_operations collection variable ‘sap_operations_sapcar_exe_path’.

Default: "/usr/sap/sapcar/sapcar"

unpack_source

list / elements=string / required

List or str value - files and/or folders that should be unpacked. Folder and/or files that are missing or cannot be accessed will be ignored. Only files on first level in directory will be processed, role does not look recursively in the directory.