Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 17. 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 10 system, but system purpose is not configured.
  • You are logged in as a root user.

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: 

    # subscription-manager status
+-------------------------------------------+
   System Status Details
+-------------------------------------------+
Overall Status: Registered
    Copy to Clipboard Toggle word wrap

    For more information on the subscriptions services, see the Getting Started with the Subscriptions Service guide.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat