Debian Package Management (APT)

Home > Administration > IT Operations Management > ITOM Package Library > Debian Package Management (APT)

Index

Introduction Based on the APT (Advanced Package Tool), Package Management provides operations for installing, removing, and upgrading packages.

Related Articles IT Operations Management Business Process Designer KeySafe

Target Environment Requirements

Credentials

Except for the Is Package Installed operation, Accounts used when executing jobs against operations contained within this package must adhere to the following requirements:

• The target machine must have a local admin user that will be used for running the operations;
• SSH Remote Login must be enabled for the user above user
• Configuration for the user must be added to the sudoers file on the target machine, to allow the above user to sudo without a password (example: __someadminuser ALL = (ALL) NOPASSWD:ALL__).

KeySafe Configuration

When creating SIS jobs for operations contained within this package, they need to be run on the target machine as a user who has the correct privileges on the target.

To configure your Target Machine account authentication in KeySafe:

• In the Admin console, navigate to: System > Security > KeySafe;
• Click on + then select Username + Password;
• Give the KeySafe Key a Title (this is the name/identifier for the target machine account as you will see it when creating an IT Automation Job, or adding an IT Automation node to a Business Process or Runbook);
• Optionally add a description;
• Populate the Username field with the domain/local account username for the account being used on the target machine;
• Populate the Password field with the password for the above account;
• Select Create Key to save.

Once you have created your KeySafe Key, you can then use it when creating IT Automation Jobs from this package. See screenshots to the right for examples.

Package Operations

The Debian Package Management (APT) package contains the following operations, than can be used to create ITOM Jobs directly, or included in your Business Processes and/or IT Operations Management Runbooks.

Install Package

Install a package using apt-get install.

Extra Credentials

None required.

Input Parameters

• package MANDATORY - name of package to install

Output Parameters

• outcome MANDATORY The outcome of the operation (OK/FAIL)
• errors Any errors returned by the operation
• version

Remove Package

Remove a package using apt-get remove.

Extra Credentials

None required.

Input Parameters

• package MANDATORY - Name of package to remove

Output Parameters

• outcome MANDATORY The outcome of the operation (OK/FAIL)
• errors Any errors returned by the operation

Is Package Installed

Confirm the installation of a package using apt-cache, if installed the package version is returned

Extra Credentials

None required.

Input Parameters

• PackageName MANDATORY - Name of the package to check is installed

Output Parameters

• outcome MANDATORY The outcome of the operation (OK/FAIL)
• errors Any errors returned by the operation
• version Version of the installed package
• installed Package installed (Yes/No)

Clean Package Cache

Removes the content of the /var/cache/apt/archives directory, except the lock file. (apt-get clean)

Extra Credentials

None required.

Input Parameters

No input parameters

Output Parameters

• outcome The outcome of the operation (OK/FAIL)
• errors Any errors returned by the operation

Auto Clean Package Cache

Removes the packages that are not possible to download from the repositories. (apt-get autoclean)

Extra Credentials

None required.

Input Parameters

No input parameters

Output Parameters

• outcome The outcome of the operation (OK/FAIL)
• errors Any errors returned by the operation

Auto Remove Packages

Remove packages installed to meet the dependencies of other packages, but are no longer needed because either the program has been uninstalled or got updated packages. (apt-get autoremove)

Extra Credentials

None required.

Input Parameters

No input parameters

Output Parameters

• outcome The outcome of the operation (OK/FAIL)
• errors Any errors returned by the operation

Upgrade All Packages

Update package database and upgrade all installed packages. (apt-get update && sudo apt-get upgrade -y).

Extra Credentials

None required.

Input Parameters

• allowdowngrades - Allows upgrades to continue without prompting when a package is being downgraded

Output Parameters

• outcome The outcome of the operation (OK/FAIL)
• errors Any errors returned by the operation