Manage Preference Lists

Preference lists are lists of packages that affect the dependencies that are installed for systems patched by content with endpoint dependency resolution.

The following conditions apply to packages:

  • Packages included in forbidden preference lists are forbidden when dependencies are resolved.
  • Packages included in preferred preference lists are preferred over packages not in the list when dependencies are resolved.
  • Packages included higher in the preference lists are preferred over lower packages. You can manage these preference lists by using the Preference Lists Dashboard.

Using the Preference Lists Dashboard

You can navigate to the dashboard by expanding the Linux RPM Patching node and selecting the Endpoint Dependency Resolution - Preference Lists dashboard.

Figure 1. Navigate to the Endpoint Dependency Resolution - Preference Lists wizard

Navigate to the Endpoint Dependency Resolution - Preference Lists wizard

To create new Forbidden package lists, click New Forbidden Package List.

Figure 2. Preference Lists Manager

Preference Lists Manager

In the next dialog, you select a site for the preference lists. Endpoints subscribed to this site are relevant to this preference list. Choose a site and click Next.

Figure 3. Create new Forbidden Package List

Create new Forbidden Package List

After entering a name for the list, you can begin populating your preference list with packages. Type the name in the Package to Add field and click Add. As you type, autocomplete suggestions are shown. These suggestions are populated using target packages from the selected site. After completing your list, click Save, click OK, and enter your Private Key Password. A task that deploys this preference list is displayed in the navigation tree.

Figure 4. Add package

Add package

To edit a preference list, click Edit for that particular list.

Figure 5. Edit Forbidden Package List

Edit Forbidden Package List

This opens the same dialog as before and allows you to edit the name and packages in the list. Click Save. To edit the task, click Edit. To redeploy the latest version of this list to all systems that already have the list, click Edit and Redeploy. Then click OK and enter your Private Key Password.

Figure 6. Edit dialog

Edit dialog

To create a copy of a preference list, click copy for that particular list.

Figure 7. Copy button

Copy button

A dialog is created with a nearly identical set of data populated throughout the fields. The Name field has the word copy at the end. Click Save to create the new task. To delete a preference list, click Delete for that particular list.

Figure 8. Delete button

Delete button

To delete the task, click Delete. To delete the task and issue an action to remove the preference list from all endpoints that have the list, click Delete and Update.

Figure 9. Delete dialog

Delete button

Preferred package lists can be created and managed in the same way as forbidden packages lists. The controls are listed under the Preferred Package Lists tab of the Preference Lists Dashboard.

Figure 10. Preferred Package Lists tab

Preferred Package Lists tab

Packages are ordered from top to bottom in preference lists. Drag and drop packages to specify priority.

You can view deployed preference lists and their associated metadata by activating an analysis. Navigate to the analysis by clicking the Analyses node and selecting Endpoint Dependency Resolution - Preference Lists. Click the analysis and select Activate from the right-click menu.

Figure 11. List of analyses

List of analyses

After you activate the analysis, a Results tab displays in the menu. Click Results.

Figure 12. Results tab

Results tab

When you review an endpoint's properties, you can view the current preference list information on that system.

To remove a preference list from an endpoint, run either the Remove Endpoint Dependency Resolution – Remove preferred list or the Remove Endpoint Dependency Resolution – Remove forbidden list tasks.

Figure 13. Available Fixlets to remove a preference list

Available Fixlets to remove a preference list