Configuring System Purpose using the command line

6.6.5. Configuring System Purpose

System Purpose enables the entitlement server to determine and automatically attach the most accurate subscription to satisfy the intended use of your RHEL 8 system.

6.6.5.1. Introduction to System Purpose

The System Purpose tool ensures that you are provided with the subscription you have purchased. By supplying the necessary information - Role, Service Level Agreement, and Usage - you enable the system to auto-attach the most appropriate subscription. The System Purpose tool also ensures that existing customers can continue using the same subscription that they have already purchased.

You can enter the System Purpose data in the following ways:

• During image creation.
• During installation using the installation program graphical user interface.
• Using Kickstart automation scripts.
• Using the syspurpose command-line (CLI) tool, provided by the python3-syspurpose.rpm package.

To record the intended purpose of your system, you can configure the following components of System Purpose:

• Role

  This component allows you to indicate the primary purpose of the system. The available roles are:

  • Red Hat Enterprise Linux Server
  • Red Hat Enterprise Linux Workstation
  • Red Hat Enterprise Linux Compute Node

• Service Level Agreement

  This component allows you to indicate the required Service Level Agreement (SLA):

  • Premium
  • Standard
  • Self-Support

• Usage

  This component allows you to indicate the required system usage:

  • Production
  • Development/Test
  • Disaster Recovery

The values entered through System Purpose are used by the entitlement server upon registration to find the most suitable subscription for your system. For more information, see Configuring System Purpose using the graphical user interface

NOTE

System Purpose is an optional feature of the RHEL installation program. To enable this feature after the installation completes, use the syspurpose CLI. Note that configuring system purpose is strongly recommended.

Additional resources

• For more information about Image Builder, see the Composing a customized RHEL system image document.
• For more information about Kickstart, see the Performing an advanced RHEL installation document.
• For more information about Subscription Manager, see the Using and Configuring Red Hat Subscription Manager document.

6.6.5.2. Configuring System Purpose using the graphical user interface

The installation program GUI installer screen offers an option to configure System Purpose while installing Red Hat Enterprise Linux 8.

Follow this procedure to make the System Purpose data available to the Subscription Manager, to auto-attach the subscription to the system:

Procedure

1. The Installation Summary window is open.
2. Click System Purpose. Select the system role that you require from the Role pane.
3. Select the service level agreement that you require from the Red Hat Service Level Agreement pane.
4. Select the usage type that you require from the Usage pane.
5. Click Done to apply the settings, and return to the Installation Summary window.

NOTE

If you choose an incorrect attribute when configuring System Purpose, the system will always grant the subscription you have purchased. This can be fixed at any time.

6.6.5.3. System Purpose status

The System Purpose status changes according to the number of attributes matched against the set of attached subscriptions. The possible statuses are:

• Matched

  All attributes of specified System Purpose have been covered by one of the attached subscriptions.

• Mismatched

  One or more specified attributes of System Purpose are not covered by the attached subscription. In such case, details about each attribute of System Purpose that is mismatched are provided.

• Not specified

  None of the attributes were specified for the system.

  NOTE

  Even if the System Purpose status returns as mismatched or not specified, you are still granted with the subscription you have purchased. You can fix the incorrect attribute added to System Purpose at any time using the CLI.

7.5. Configuring System Purpose using the command line

The syspurpose is a tool provided by the python3_syspurpose.rpm package. It enables you to set, add, unset or remove attributes from System Purpose.

Therefore, the tool provides the entitlement server with the most appropriate auto-attach while still satisfying the intent of the subscription for which you have purchased.

Follow the steps in this procedure to configure System Purpose after installation using the syspurpose command-line tool.

Prerequisites

• Your RHEL 8 system is installed and registered.
• You are able to log as a root user.
• The python3_syspurpose.rpm package is available on your system.

Procedure

1. From a terminal window, run the following command to set the intended role of the system:

   # syspurpose set-role "VALUE"

   Replace VALUE with the role that you want to assign:

   • Red Hat Enterprise Linux Server
   • Red Hat Enterprise Linux Workstation
   • Red Hat Enterprise Linux Compute Node

   For example:

   # syspurpose set-role "Red Hat Enterprise Linux Server"

   NOTE

   To unset the role, run:

   # syspurpose unset-role

2. Run the following command to set the intended Service Level Agreement(SLA) of the system:

   # syspurpose set-sla "VALUE"

   Replace VALUE with the SLA that you want to assign:

   • Premium
   • Standard
   • Self-Support

   For example:

   # syspurpose set-sla "Standard"

   NOTE

   To unset the SLA, run:

   # syspurpose unset-sla

3. Run the following command to set the intended usage of the system:

   # syspurpose set-usage "VALUE"

   Replace VALUE with the usage that you want to assign:

   • Production
   • Development/Test

   • Disaster Recovery

     For example:

     # syspurpose set-usage "Production"

     NOTE

     To unset the usage, run:

     # syspurpose unset-usage

4. Optionally, run the following command to show the system purpose properties that are currently set:

   # syspurpose show

   For more information on syspurpose, access the man page with the man syspurpose command.

   # man syspurpose

7.5.1. Redefining subscriptions using the syspurpose tool

Using the syspurpose command-line tool to set the role, SLA, and usage influences the subscriptions that are auto-attached to the system.

If your system is registered and has subscriptions that do not satisfy the required system purpose, follow this procedure:

Procedure

1. Remove attached subscriptions:

   # subscription-manager remove --all

2. Use the syspurpose command-line tool to set the system purpose that you require, as described in link:(add link to procedure referencing the previous part of the text in the second step of the procedure.)

3. Entitle the system with the updated system purpose attributes.

   # subscription-manager attach --auto

   //you can run the `subscription-manager remove --all` command to remove attached subscriptions. You can then use the `syspurpose` command-line tool to set the system purpose that you require, and run `subscription-manager attach --auto` to entitle the system with the updated system purpose attributes.

转载至https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/performing_a_standard_rhel_installation/index