Difference between revisions of "Yum Package Management (RPM)"

From Hornbill
Jump to navigation Jump to search
m (SteveGoldthorpe moved page Yum Package manager (RPM) to Yum Package Management (RPM): Consistent naming convention)
(Replaced content with "This document can now be found at its new location in the [https://docs.hornbill.com/itom-packages/welcome Hornbill Document Library]. file:hornbill-document-librar...")
Tag: Replaced
Line 1: Line 1:
{{bluebanner|[[Main_Page|Home]] > [[Administration]] > [[IT_Operations_Management|IT Operations Management]] > [[ITOM_Package_Library|ITOM Package Library]] > Yum Package manager (RPM) |[[: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|Package management allowing for installing, deleting, querying, and managing Red Hat Enterprise Linux RPM software packages.
 
|
 
<!-- Related Links go here -->
 
:* [[IT_Operations_Management|IT Operations Management]]
 
:* [[Business_Process_Designer|Business Process Designer]]
 
:* [[Hornbill_KeySafe|KeySafe]]
 
}}
 
  
==Target Environment Requirements==
+
    [[file:hornbill-document-library.png|ITOM Package Reference|link=https://docs.hornbill.com/itom-packages/welcome]]
 
 
=== Credentials ===
 
 
 
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 Yum Package manager (RPM) 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 yum 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>version</code> 
 
* <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">
 
===Remove Package===
 
<div class="mw-collapsible-content">
 
Remove a package using yum 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 yum info, 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>version</code> 
 
* <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">
 
===Clean Package Cache===
 
<div class="mw-collapsible-content">
 
Removes the content of the yum cache (yum clean).  The type of data must be specified (default is packages), with the full list of options are: [all | headers | metadata | packages]
 
 
==== Extra Credentials ====
 
None required.
 
 
 
====Input Parameters====
 
 
 
* <code>type</code> '''MANDATORY''' - Remove [all|headers|metadata|packages]
 
 
 
====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 has updated packages. (yum 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. (yum update )
 
 
==== 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>
 
 
 
 
 
[[Category:ITOM]]
 

Revision as of 14:50, 12 February 2024

This document can now be found at its new location in the Hornbill Document Library.

   ITOM Package Reference