Red Hat Training

A Red Hat training course is available for Red Hat Satellite

4.4. Using the Red Hat Satellite Command Line Tool (spacecmd)

The spacecmd tool interacts with Red Hat Satellite's XML-RPC API. This provides users with a simple way of executing Satellite functionality from the command line.


An initial run of spacecmd requires your username and password. This opens a session ticket for the chosen user and all subsequent usage of spacecmd uses this session until it expires, in one hour. Change the user and password using the -u USERNAME and -p PASSWORD options.
spacecmd uses two methods of execution.

From the Interactive Shell

Run spacecmd alone to start the interactive shell.
[root@satellite57 ~]# spacecmd
Welcome to spacecmd, a command-line interface to Spacewalk.

Type: 'help' for a list of commands
      'help <cmd>' for command-specific help
      'quit' to quit

INFO: Connected to https://localhost/rpc/api as admin
spacecmd {SSM:0}>
This displays the spacecmd prompt, which also indicates the number of system attached to the System Set Manager (SSM).
To run commands, enter them into the shell. For example, to list all systems, run system_list:
spacecmd {SSM:0}> system_list
To list the base channel for a system, run system_list followed by the name of the system:
spacecmd {SSM:0}> system_listbasechannel
List all commands using the help command.

From the Terminal

Execute spacecmd commands directly from the your Linux terminal. For example, use spacecmd system_list to list all your systems:
[root@satellite57 ~]# spacecmd system_list
INFO: Connected to https://localhost/rpc/api as admin
Or list the base channel for a system with spacecmd system_listbasechannel systemname:
[root@satellite57 ~]# spacecmd system_listbasechannel
INFO: Connected to https://localhost/rpc/api as admin
List all commands with spacecmd help.