Red Hat Summit Red Hat SummitSuporteConsoleDesenvolvedoresComeçar um testeContato

Este conteúdo não está disponível no idioma selecionado.

Chapter 16. Configuring System Purpose using the subscription-manager command-line tool

System purpose is a feature of the Red Hat Enterprise Linux installation to help RHEL customers get the benefit of our subscription experience and services offered in the Red Hat Hybrid Cloud Console, a dashboard-based, Software-as-a-Service (SaaS) application that enables you to view subscription usage in your Red Hat account.

You can configure system purpose attributes either on the activation keys or by using the subscription manager tool.

Prerequisites

  • You have installed and registered your Red Hat Enterprise Linux 8 system, but system purpose is not configured.

  • You are logged in as a root user.

    Note

    In the entitlement mode, if your system is registered but has subscriptions that do not satisfy the required purpose, you can run the subscription-manager remove --all command to remove attached subscriptions. You can then use the command-line subscription-manager syspurpose {role, usage, service-level} tools to set the required purpose attributes, and lastly run subscription-manager attach --auto to re-entitle the system with considerations for the updated attributes. Whereas, in the SCA enabled account, you can directly update the system purpose details post registration without making an update to the subscriptions in the system.

Procedure

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

    # subscription-manager syspurpose role --set "VALUE"
    Copy to Clipboard Toggle word wrap

    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: 

    # subscription-manager syspurpose role --set "Red Hat Enterprise Linux Server"
    Copy to Clipboard Toggle word wrap

    1. Optional: Before setting a value, see the available roles supported by the subscriptions for your organization: 

      # subscription-manager syspurpose role --list
      Copy to Clipboard Toggle word wrap

    2. Optional: Run the following command to unset the role: 

      # subscription-manager syspurpose role --unset
      Copy to Clipboard Toggle word wrap

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

    # subscription-manager syspurpose service-level --set "VALUE"
    Copy to Clipboard Toggle word wrap

    Replace VALUE with the SLA that you want to assign:

    • Premium
    • Standard
    • Self-Support

    For example: 

    # subscription-manager syspurpose service-level --set "Standard"
    Copy to Clipboard Toggle word wrap

    1. Optional: Before setting a value, see the available service-levels supported by the subscriptions for your organization: 

      # subscription-manager syspurpose service-level --list
      Copy to Clipboard Toggle word wrap

    2. Optional: Run the following command to unset the SLA: 

      # subscription-manager syspurpose service-level --unset
      Copy to Clipboard Toggle word wrap

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

    # subscription-manager syspurpose usage --set "VALUE"
    Copy to Clipboard Toggle word wrap

    Replace VALUE with the usage that you want to assign:

    • Production
    • Disaster Recovery
    • Development/Test

    For example: 

    # subscription-manager syspurpose usage --set "Production"
    Copy to Clipboard Toggle word wrap

    1. Optional: Before setting a value, see the available usages supported by the subscriptions for your organization: 

      # subscription-manager syspurpose usage --list
      Copy to Clipboard Toggle word wrap

    2. Optional: Run the following command to unset the usage: 

      # subscription-manager syspurpose usage --unset
      Copy to Clipboard Toggle word wrap

  4. Run the following command to show the current system purpose properties: 

    # subscription-manager syspurpose --show
    Copy to Clipboard Toggle word wrap

    1. Optional: For more detailed syntax information run the following command to access the subscription-manager man page and browse to the SYSPURPOSE OPTIONS: 

      # man subscription-manager
      Copy to Clipboard Toggle word wrap

Verification

  • To verify the system’s subscription status in a system registered with an account having entitlement mode enabled: 

    # subscription-manager status
+-------------------------------------------+
   System Status Details
+-------------------------------------------+
Overall Status: Current

System Purpose Status: Matched
    Copy to Clipboard Toggle word wrap
    • An overall status Current means that all of the installed products are covered by the subscription(s) attached and entitlements to access their content set repositories has been granted.
    • A system purpose status Matched means that all of the system purpose attributes (role, usage, service-level) that were set on the system are satisfied by the subscription(s) attached.
    • When the status information is not ideal, additional information is displayed to help the system administrator decide what corrections to make to the attached subscriptions to cover the installed products and intended system purpose.

  • To verify the system’s subscription status in a system registered with an account having SCA mode enabled: 

    # subscription-manager status
+-------------------------------------------+
   System Status Details
+-------------------------------------------+
Overall Status: Disabled
Content Access Mode is set to Simple Content Access. This host has access to content, regardless of subscription status.
System Purpose Status: Disabled
    Copy to Clipboard Toggle word wrap
    • In SCA mode, ​​subscriptions are no longer required to be attached to individual systems. Hence, both the overall status and system purpose status are displayed as Disabled . However, the technical, business, and operational use cases supplied by system purpose attributes are important to the subscriptions service. Without these attributes, the subscriptions service data is less accurate.
Voltar ao topo
Red Hat logoGithubredditYoutubeTwitter

Aprender

Experimente, compre e venda

Comunidades

Sobre a documentação da Red Hat

Ajudamos os usuários da Red Hat a inovar e atingir seus objetivos com nossos produtos e serviços com conteúdo em que podem confiar. Explore nossas atualizações recentes.

Tornando o open source mais inclusivo

A Red Hat está comprometida em substituir a linguagem problemática em nosso código, documentação e propriedades da web. Para mais detalhes veja o Blog da Red Hat.

Sobre a Red Hat

Fornecemos soluções robustas que facilitam o trabalho das empresas em plataformas e ambientes, desde o data center principal até a borda da rede.

Theme

© 2025 Red Hat