Chapter 15. Managing Packages

Procedure

1. In the Satellite web UI, navigate to Hosts > All Hosts and select the host you want to install packages on.
2. On the Content tab, select the Packages tab.
3. On the vertical ellipsis icon next to the upgrade button, click Install Packages.
4. In the Install packages window, select the package or packages that you want to install on the host.
5. Click Install.

API Procedure

1. Create the "job_invocation" object and place rest of the body inside this object.
2. Create the "inputs" object with the "package" field of the string type specifying the packages you want to install. If you are specifying multiple packages, separate them with a whitespace.
3. Create a "feature" field of the string type with value "katello_package_install".
4. Create a "search_query" field of the string type and input a search query matching the hosts on which you want to install the packages.

5. Optional: If you want to install packages as a specific user, create an ssh object with the following fields of the string type:

   • "effective_user" with the name of the ssh user
   • "effective_user_password" with the password of the ssh user if this password is required

6. Optional: If you want to install packages at a later time, create the "scheduling" object. The object can contain one or both of the following fields of the string type with date, time, and a timezone in the ISO 8601 format:

   • "start_at"- sets the time to install the packages
   • "start_before" - sets the latest time to install the packages. If it is not possible to install the packages by this time, then this action is cancelled.

   If you omit time, it defaults to 00:00:00. If you omit timezone, it defaults to UTC.

7. Optional: If you want to limit the number of hosts on which the job is run concurrently, create the "concurrency_control" object with the "concurrency_level" field of the integer type. Assign the number of hosts as the field value.
8. Optional: If you want to install packages at a later time and you want the host search query to be evaluated at a time of running the job, create a "targeting_type" field of the string type with the "dynamic_query" value. This is useful if you expect the result of the search query to be different at the time of running the job due to changed status of the hosts. If you omit this field, it defaults to "static_query".

9. Send a POST request with the created body to the /api/job_invocations endpoint of your Satellite Server and use a tool like python to see a formatted response.

   Example API request:

   curl https://satellite.example.com/api/job_invocations \
   -H "content-type: application/json" \
   -X POST \
   -d @Path_To_My_API_Request_Body \
   -u My_Username:My_Password | python3 -m json.tool

Procedure

1. In the Satellite web UI, navigate to Hosts > All Hosts.
2. Click the name of the host you want to modify.
3. Click the Content tab, then click the Packages tab.
4. Select Upgradable from the Status list.
5. Select the packages you want to upgrade.
6. Click the Upgrade button. You get a REX job notification once the remote execution job is complete.

API Procedure

1. Create the "job_invocation" object and place rest of the body inside this object.
2. Create the "inputs" object with the "package" field of the string type specifying the packages you want to update. If you are specifying multiple packages, separate them with a whitespace.
3. Create a "feature" field of the string type with value "katello_package_update".
4. Create a "search_query" field of the string type and input a search query matching the hosts on which you want to update the packages.

5. Optional: If you want to update packages as a specific user, create an ssh object with the following fields of the string type:

   • "effective_user" with the name of the ssh user
   • "effective_user_password" with the password of the ssh user if this password is required

6. Optional: If you want to update packages at a later time, create the "scheduling" object. The object can contain one or both of the following fields of the string type with date, time, and a timezone in the ISO 8601 format:

   • "start_at"- sets the time to update the packages
   • "start_before" - sets the latest time to update the packages. If it is not possible to update the packages by this time, then this action is cancelled.

   If you omit time, it defaults to 00:00:00. If you omit timezone, it defaults to UTC.

7. Optional: If you want to limit the number of hosts on which the job is run concurrently, create the "concurrency_control" object with the "concurrency_level" field of the integer type. Assign the number of hosts as the field value.
8. Optional: If you want to update packages at a later time and you want the host search query to be evaluated at a time of running the job, create a "targeting_type" field of the string type with the "dynamic_query" value. This is useful if you expect the result of the search query to be different at the time of running the job due to changed status of the hosts. If you omit this field, it defaults to "static_query".

9. Send a POST request with the created body to the /api/job_invocations endpoint of your Satellite Server and use a tool like python to see a formatted response.

   Example API request:

   curl https://satellite.example.com/api/job_invocations \
   -H "content-type: application/json" \
   -X POST \
   -d @Path_To_My_API_Request_Body \
   -u My_Username:My_Password | python3 -m json.tool

Procedure

1. In the Satellite web UI, navigate to Hosts > All Hosts.
2. Click the name of the host you want to modify.
3. Click the Content tab, then click the Packages tab.
4. Click the vertical ellipsis for the package you want to remove and select Remove. You get a REX job notification once the remote execution job is complete.

API Procedure

1. Create the "job_invocation" object and place rest of the body inside this object.
2. Create the "inputs" object with the "package" field of the string type specifying the packages you want to remove. If you are specifying multiple packages, separate them with a whitespace.
3. Create a "feature" field of the string type with value "katello_package_remove".
4. Create a "search_query" field of the string type and input a search query matching the hosts on which you want to remove the packages.

5. Optional: If you want to remove packages as a specific user, create an ssh object with the following fields of the string type:

   • "effective_user" with the name of the ssh user
   • "effective_user_password" with the password of the ssh user if this password is required

6. Optional: If you want to remove packages at a later time, create the "scheduling" object. The object can contain one or both of the following fields of the string type with date, time, and a timezone in the ISO 8601 format:

   • "start_at"- sets the time to remove the packages
   • "start_before" - sets the latest time to remove the packages. If it is not possible to remove the packages by this time, then this action is cancelled.

   If you omit time, it defaults to 00:00:00. If you omit timezone, it defaults to UTC.

7. Optional: If you want to limit the number of hosts on which the job is run concurrently, create the "concurrency_control" object with the "concurrency_level" field of the integer type. Assign the number of hosts as the field value.
8. Optional: If you want to remove packages at a later time and you want the host search query to be evaluated at a time of running the job, create a "targeting_type" field of the string type with the "dynamic_query" value. This is useful if you expect the result of the search query to be different at the time of running the job due to changed status of the hosts. If you omit this field, it defaults to "static_query".

9. Send a POST request with the created body to the /api/job_invocations endpoint of your Satellite Server and use a tool like python to see a formatted response.

   Example API request:

   curl https://satellite.example.com/api/job_invocations \
   -H "content-type: application/json" \
   -X POST \
   -d @Path_To_My_API_Request_Body \
   -u My_Username:My_Password | python3 -m json.tool