- Red Hat Enterprise Linux 7
- Red Hat Enterprise Linux 6
- Red Hat Subscription Management (RHSM)
- Red Hat Customer Portal
- How to offline register a new Red Hat Enterprise Linux system to the Customer Portal?
- How to register a system that is not connected to the internet?
- How to register a disconnected system?
- How to manually register a system to the Customer Portal?
- How to create a system profile in Red Hat Subscription Management?
- Subscription-manager list commands shows status as "Unknown" after registering systems offline
- Subscription-manager status displays error message "Unknown" even importing the correct certificates
To register an "offline" or "air-gapped" system, you need to manually create a system profile using Red Hat Subscription Management (RHSM) in the Customer Portal. This profile serves as a placeholder and will not be connected to your actual system.
Attach subscriptions: In your newly created system profile, click the Subscriptions tab, and attach any subscriptions you want to use with the system.
Download and import the entitlement certificate(s): From the "Subscriptions" tab on your system profile, click Download Certificates to download the entitlement certificate(s) for attached subscriptions. The downloaded archive will be in zip format and will be named similar to 'aaaa1111-bb22-cc33-dd44-eeeeee555555_certificates.zip'.
# unzip -l d01bcb4f-8d59-433f-xxxx-0612dd2266db_certificates.zip Archive: d01bcb4f-8d59-433f-xxxx-0612dd2266db_certificates.zip signed Candlepin export for d01bcb4f-8d59-433f-xxxx-0612dd2266db Length Date Time Name --------- ---------- ----- ---- 18091 05-07-2018 14:35 consumer_export.zip 512 05-07-2018 14:35 signature --------- ------- 18603 2 files
# unzip d01bcb4f-8d59-433f-xxxx-0612dd2266db_certificates.zip
This archive will contain another archive named 'consumer_export.zip'. Extract the content and in the
./export/entitlement_certificates/folder you will find your certificate(s) in PEM format.
# unzip -l consumer_export.zip Archive: consumer_export.zip Candlepin export for d01bcb4f-8d59-433f-xxxx-0612dd2266db Length Date Time Name --------- ---------- ----- ---- 23619 05-07-2018 14:35 export/entitlement_certificates/xxxx.pem 137 05-07-2018 14:35 export/meta.json --------- ------- 23756 2 files
# unzip consumer_export.zip
Move these to the client system's
# subscription-manager import --certificate=/tmp/Name_Of_Downloaded_Entitlement_Cert.pem e.g. : # subscription-manager import --certificate=/tmp/xxxx.pem
This completes the registration of the offline system.
- You can verify that entitlement certificates were successfully imported by reviewing:
# subscription-manager list --consumed
When you register an online system via
# subscription-manager register, it automatically creates a connected profile on the Customer Portal, whereas in offline registration, you are manually creating a disconnected profile on the Portal.
After following this procedure, your system profile in the Customer Portal will show a subscription status "Unknown" and the command
# subscription-manager status will output "Unknown." This is the expected behavior. For more information, see https://access.redhat.com/solutions/2158251
This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.