|
|
| Line 1: |
Line 1: |
| − | {{bluebanner|[[Main_Page|Home]] > [[Administration]] > [[IT_Operations_Management|IT Operations Management]] > [[ITOM_Package_Library|ITOM Package Library]] > Debian Package Management (APT) |[[:Category:ITOM|Index]]}}
| + | This document can now be found at its new location in the [https://docs.hornbill.com/itom-packages/welcome Hornbill Document Library]. |
| − | [[File:Tux.svg.png|300px]]
| |
| − | {{IntroAndLinks|Based on the APT (Advanced Package Tool), Package Management provides operations for installing, removing, and upgrading packages.
| |
| | | | |
| − | | + | [[file:hornbill-document-library.png|ITOM Package Reference|link=https://docs.hornbill.com/itom-packages/welcome]] |
| − | |
| |
| − | <!-- Related Links go here -->
| |
| − | :* [[IT_Operations_Management|IT Operations Management]]
| |
| − | :* [[Business_Process_Designer|Business Process Designer]]
| |
| − | :* [[Hornbill_KeySafe|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==
| |
| − | [[File:itomtarget_keysafe.png|300px|right]]
| |
| − | | |
| − | 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 '''[[Hornbill_KeySafe|KeySafe]]''':
| |
| − | | |
| − | * In the Admin console, navigate to: System > Security > KeySafe;
| |
| − | * Click on + then select <code>Username + Password</code>;
| |
| − | * 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_Process_Designer|Business Processes]] and/or IT Operations Management Runbooks.
| |
| − | | |
| − | | |
| − | <div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1050px">
| |
| − | ===Install Package===
| |
| − | <div class="mw-collapsible-content">
| |
| − | Install a package using apt-get install.
| |
| − | | |
| − | ==== Extra Credentials ====
| |
| − | None required.
| |
| − | | |
| − | ====Input Parameters====
| |
| − | | |
| − | * <code>package</code> '''MANDATORY''' - name of package to install
| |
| − | | |
| − | ====Output Parameters====
| |
| − | | |
| − | * <code>outcome</code> '''MANDATORY''' The outcome of the operation (OK/FAIL)
| |
| − | * <code>errors</code> Any errors returned by the operation
| |
| − | * <code>version</code>
| |
| − | | |
| − | </div></div>
| |
| − | | |
| − | <div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1050px">
| |
| − | | |
| − | ===Remove Package===
| |
| − | <div class="mw-collapsible-content">
| |
| − | Remove a package using apt-get remove.
| |
| − | | |
| − | ==== Extra Credentials ====
| |
| − | None required.
| |
| − | | |
| − | ====Input Parameters====
| |
| − | | |
| − | * <code>package</code> '''MANDATORY''' - Name of package to remove
| |
| − | | |
| − | ====Output Parameters====
| |
| − | | |
| − | * <code>outcome</code> '''MANDATORY''' The outcome of the operation (OK/FAIL)
| |
| − | * <code>errors</code> Any errors returned by the operation
| |
| − | | |
| − | </div></div>
| |
| − | | |
| − | <div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1050px">
| |
| − | | |
| − | ===Is Package Installed===
| |
| − | <div class="mw-collapsible-content">
| |
| − | Confirm the installation of a package using apt-cache, if installed the package version is returned
| |
| − | | |
| − | ==== Extra Credentials ====
| |
| − | None required.
| |
| − | | |
| − | ====Input Parameters====
| |
| − | | |
| − | * <code>PackageName</code> '''MANDATORY''' - Name of the package to check is installed
| |
| − | | |
| − | ====Output Parameters====
| |
| − | | |
| − | * <code>outcome</code> '''MANDATORY''' The outcome of the operation (OK/FAIL)
| |
| − | * <code>errors</code> Any errors returned by the operation
| |
| − | * <code>version</code> Version of the installed package
| |
| − | * <code>installed</code> Package installed (Yes/No)
| |
| − | | |
| − | </div></div>
| |
| − | | |
| − | <div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1050px">
| |
| − | | |
| − | ===Clean Package Cache===
| |
| − | <div class="mw-collapsible-content">
| |
| − | 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====
| |
| − | | |
| − | * <code>outcome</code> The outcome of the operation (OK/FAIL)
| |
| − | * <code>errors</code> Any errors returned by the operation
| |
| − | | |
| − | </div></div>
| |
| − | | |
| − | <div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1050px">
| |
| − | | |
| − | ===Auto Clean Package Cache===
| |
| − | <div class="mw-collapsible-content">
| |
| − | 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====
| |
| − | | |
| − | * <code>outcome</code> The outcome of the operation (OK/FAIL)
| |
| − | * <code>errors</code> Any errors returned by the operation
| |
| − | | |
| − | </div></div>
| |
| − | | |
| − | <div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1050px">
| |
| − | | |
| − | ===Auto Remove Packages===
| |
| − | <div class="mw-collapsible-content">
| |
| − | 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====
| |
| − | | |
| − | * <code>outcome</code> The outcome of the operation (OK/FAIL)
| |
| − | * <code>errors</code> Any errors returned by the operation
| |
| − | | |
| − | </div></div>
| |
| − | | |
| − | <div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1050px">
| |
| − | | |
| − | ===Upgrade All Packages===
| |
| − | <div class="mw-collapsible-content">
| |
| − | Update package database and upgrade all installed packages. (apt-get update && sudo apt-get upgrade -y).
| |
| − | | |
| − | ==== Extra Credentials ====
| |
| − | None required.
| |
| − | | |
| − | ====Input Parameters====
| |
| − | | |
| − | * <code>allowdowngrades</code> - Allows upgrades to continue without prompting when a package is being downgraded
| |
| − | | |
| − | ====Output Parameters====
| |
| − | | |
| − | * <code>outcome</code> The outcome of the operation (OK/FAIL)
| |
| − | * <code>errors</code> Any errors returned by the operation
| |
| − | | |
| − | </div></div>
| |
| − | | |
| − | | |
| − | [[Category:ITOM]]
| |
