diff --git a/man/subscription-manager.8 b/man/subscription-manager.8 index c4d9c429b6..b30df819e7 100644 --- a/man/subscription-manager.8 +++ b/man/subscription-manager.8 @@ -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. @@ -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 @@ -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 @@ -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/.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 @@ -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 @@ -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 @@ -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