The software described in this documentation is either no longer supported or is in extended support.
Oracle recommends that you upgrade to a current supported release.

9.2 Subscribing Client Systems to Software Channels Using spacecmd

To list the base and child software channels to which a system is subscribed, use the system_listbasechannel and system_listchildchannels commands.

spacecmd {SSM:0}> system_listbasechannel svr1.mydom.com
ol6-x86_64
spacecmd {SSM:0}> system_listchildchannels svr1.mydom.com
ksplice-ol6-x86_64
ol6_x86_64_addons
ol6_x86_64_spacewalk24_client
ol6_x86_64_uekr3_latest

To list the available child channels of a base channel, use the softwarechannel_listchildchannels command.

spacecmd {SSM:0}> softwarechannel_listchildchannels oraclelinux6-x86_64
ksplice-ol6-x86_64
ol6_x86_64_addons
ol6_x86_64_playground
ol6_x86_64_spacewalk24_client
ol6_x86_64_spacewalk24_server
ol6_x86_64_uekr3_latest

To add or remove child channels, use the system_addchildchannels and system_removechildchannels commands.

spacecmd {SSM:0}> system_removechildchannels svr1.mydom.com ol6_x86_64_addons
Systems
-------
svr1.mydom.com

Removing Channels
-----------------
ol6_x86_64_addons

Is this ok [y/N]: y

spacecmd {SSM:0}> system_addchildchannels svr2.mydom.com ol6_x86_64_playground
Systems
-------
svr2.mydom.com

Adding Channels
---------------
ol6_x86_64_playground

Is this ok [y/N]: y

To list the available base channels, use the softwarechannel_listbasechannels command.

spacecmd {SSM:0}> softwarechannel_listbasechannels
oraclelinux7u0-x86_64
oraclelinux7u1-x86_64

To change the base channel to which a system is subscribed, use the system_setbasechannel command.

spacecmd {SSM:0}> system_setbasechannel svr5.mydom.com oraclelinux7u1-x86_64
System:           svr5.mydom.com
Old Base Channel: oraclelinux7u0-x86_64
New Base Channel: oraclelinux7u1-x86_64

Is this ok [y/N]: y
Note

Changing the base software channel unsubscribes a system from all other software channels.

You can change the subscribed channels for multiple systems by specifying the following arguments in place of a system name:

channel:channel_name

Matches systems that are subscribed to the specified software channel.

group:group_name

Specifies the systems in the named system group, for example:

spacecmd {SSM:0}> system_removechildchannels group:group3 ol6_x86_64_playground
Systems
-------
svr1.mydom.com
svr2.mydom.com

Removing Channels
-----------------
ol6_x86_64_playground

Is this ok [y/N]: y

search:criterion:value

Matches systems that match a search criterion. See Section 8.3, “Searching for Systems Using spacecmd”.

ssm

Specifies the systems that are currently in the system set.