Skip to content

Commit

Permalink
docs: remove references to removed commands
Browse files Browse the repository at this point in the history
This patch removes remaining references to commands that were deprecated and removed.

 * Removed references to 'redeem' command
 * Removed references to 'attach' command
 * Fixed numbering for list of supported commands
 * Rephrased deprecated command section message
 * Update activation key messaging
 * Removed deprecated commands list
 * Adjusted wording slightly around attaching subscriptions
 * Removed 'subscribe' from deprecated commands
 * Removed references to '--auto-attach/--servicelevel' register options

Card ID: CCT-545
  • Loading branch information
DuckBoss committed Sep 4, 2024
1 parent 00deef2 commit cd51a18
Showing 1 changed file with 21 additions and 79 deletions.
100 changes: 21 additions & 79 deletions man/subscription-manager.8
Original file line number Diff line number Diff line change
Expand Up @@ -26,12 +26,8 @@ is the command-line based client for the Red Hat Subscription Manager tool.
Subscription Manager performs several key operations:
.IP
* It registers systems to the Red Hat subscription management service and adds the system to the inventory. Once a system is registered, it can receive updates based on its subscriptions to any kind of software products.
.IP
* It lists both available and used subscriptions.
.IP
* It allows administrators to both attach specific subscriptions to a system and remove those subscriptions.
.PP
Subscription Manager can be used to auto-attach subscriptions to a system, as well. The
The
.B subscription-manager
command can even be invoked as part of a kickstart process.

Expand Down Expand Up @@ -77,60 +73,55 @@ must be passed as system arguments in a non-interactive session.
2. unregister

.IP
4. auto-attach
3. auto-attach

.IP
5. remove
4. release

.IP
6. release
5. list

.IP
9. list
6. refresh

.IP
10. refresh
7. environments

.IP
11. environments
8. repos

.IP
12. repos
9. orgs

.IP
13. orgs
10. plugins

.IP
14. plugins
11. identity

.IP
15. identity
12. facts

.IP
16. facts
13. clean

.IP
17. clean
14. config

.IP
18. config
15. version

.IP
19. version
16. status

.IP
20. status
17. syspurpose

.IP
21. syspurpose

.IP
22. repo-override
18. repo-override

.RE

Following commands were deprecated: unsubscribe

.SS COMMON OPTIONS
.TP
.B -h, --help
Expand Down Expand Up @@ -235,7 +226,7 @@ Gives a comma-separated list of product keys to apply specific subscriptions to
.IP
When the
.B --activationkey
option is used, it is not necessary to use the
option is used, it is not possible to use the
.B --username
and
.B --password
Expand Down Expand Up @@ -299,33 +290,6 @@ Disables the auto-attach option for the system. If auto-attach is disabled, then
.B --show
Shows whether auto-attach is enabled on the systems.

.SS REMOVE OPTIONS
The
.B remove
command removes a subscription from the system. (This does not uninstall the associated products.)

.TP
.B --serial=SERIALNUMBER
Gives the serial number of the subscription certificate for the specific product to remove from the system. Subscription certificates attached to a system are in a certificate, in
.B /etc/pki/entitlement/<serial_number>.pem.
To remove multiple subscriptions, use the
.B --serial
option multiple times.

.TP
.B --pool=POOLID
Removes all subscription certificates for the specified pool id from the system.
To remove multiple sets of subscriptions, use the
.B --pool
option multiple times.

.TP
.B --all
Removes
.I all
of the subscriptions attached to a system.


.SS RELEASE OPTIONS
The
.B release
Expand Down Expand Up @@ -900,11 +864,7 @@ Overall Status: Insufficient
.RE

.SS DEPRECATED COMMANDS
As the structures of subscription configuration have changed, some of the original management commands have become obsolete. These commands have been replaced with updated commands.

.TP
.B unsubscribe
This has been replaced with \fBremove\fP.
No commands are currently deprecated.

.SH USAGE
.B subscription-manager
Expand Down Expand Up @@ -1017,14 +977,11 @@ subscription-manager unregister
.fi
.RE

.SS LISTING, ATTACHING, AND REMOVING SUBSCRIPTIONS FOR PRODUCTS
.SS LISTING SUBSCRIPTIONS FOR PRODUCTS
A
.I subscription
is essentially the right to install, use, and receive updates for a Red Hat product. (Sometimes multiple individual software products are bundled together into a single subscription.) When a system is registered, the subscription management service is aware of the system and has a list of all of the possible product subscriptions that the system can install and use. A subscription is applied to a system when the system is
.I attached
to the subscription pool that makes that product available. A system releases or
.I removes
that subscription (meaning, it removes that subscription so that another system can use that subscription count).
attached to the subscription pool that makes that product available.

.PP The
.B list
Expand Down Expand Up @@ -1099,21 +1056,6 @@ Ends: 08/31/2015
.fi
.RE

.PP
Removing subscription from a system releases the subscription back into the pool. The system remains registered with the subscription management service. Each product has an identifying X.509 certificate installed with it. To remove a subscription for a specific product, specify the serial number (or numbers, in multiple \fB--serial\fP options) of the certificate:

.RS
.nf
subscription-manager remove --serial=1128750306742160
.fi
.RE

.PP
Giving the
.B remove
command with the
.B --all
option removes every subscription the system has used.

.SS VIEWING LOCAL SUBSCRIPTION & CONTENT PROVIDER INFORMATION
Red Hat has a hosted environment, through the Customer Portal, that provides centralized access to subscription management and content repositories. However, organizations can use other tools -- like Subscription Manager -- for content hosting and subscription management. With a local content provider, the organization, environments, repositories, and other structural configuration is performed in the content provider. Red Hat Subscription Manager can be used to display this information, using the
Expand Down

0 comments on commit cd51a18

Please sign in to comment.