community.sap.sapcar_extract module – Manages SAP SAPCAR archives

Note

This module is part of the community.sap collection (version 1.0.0).

You might already have this collection installed if you are using the ansible package. 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 community.sap.

To use it in a playbook, specify: community.sap.sapcar_extract.

New in version 0.1.0: of community.sap

Synopsis

  • Provides support for unpacking sar/car files with the SAPCAR binary from SAP and pulling information back into Ansible.

Parameters

Parameter

Comments

binary_path

path

The path to the SAPCAR binary, for example, /home/dummy/sapcar or https://myserver/SAPCAR. If this parameter is not provided, the module will look in PATH.

dest

path

The destination where SAPCAR extracts the SAR file. Missing folders will be created. If this parameter is not provided, it will unpack in the same folder as the SAR file.

manifest

string

The name of the manifest.

Default: “SIGNATURE.SMF”

path

path / required

The path to the SAR/CAR file.

remove

boolean

If true, the SAR/CAR file will be removed. This should be used with caution!

Choices:

  • no ← (default)

  • yes

security_library

path

The path to the security library, for example, /usr/sap/hostctrl/exe/libsapcrytp.so, for signature operations.

signature

boolean

If true, the signature will be extracted.

Choices:

  • no ← (default)

  • yes

Notes

Note

  • Always returns changed=true in check_mode.

Examples

- name: Extract SAR file
  community.sap.sapcar_extract:
    path: "~/source/hana.sar"

- name: Extract SAR file with destination
  community.sap.sapcar_extract:
    path: "~/source/hana.sar"
    dest: "~/test/"

- name: Extract SAR file with destination and download from webserver can be a fileshare as well
  community.sap.sapcar_extract:
    path: "~/source/hana.sar"
    dest: "~/dest/"
    binary_path: "https://myserver/SAPCAR"

- name: Extract SAR file and delete SAR after extract
  community.sap.sapcar_extract:
    path: "~/source/hana.sar"
    remove: true

- name: Extract SAR file with manifest
  community.sap.sapcar_extract:
    path: "~/source/hana.sar"
    signature: true

- name: Extract SAR file with manifest and rename it
  community.sap.sapcar_extract:
    path: "~/source/hana.sar"
    manifest: "MyNewSignature.SMF"
    signature: true

Authors

  • Rainer Leber (@RainerLeber)