Red Hat Satellite 6 Administration

You can review and modify the Capsule Server name and URL.

In the Satellite web UI, navigate to the Infrastructure → Capsules menu. Notice that the menu shows only the Capsules that are configured for the currently selected organization and location. Click the Edit button to start editing the Capsule Server settings. The Capsule tab opens by default, and you can set the following parameters:

You can review and modify the assigned organizations for your Capsule Server by selecting the Organizations tab in the edit menu. The table on the left provides a list of available organizations. The table on the right provides a list of the assigned organizations for your Capsule Server. Click the organization name to assign it to the capsule. Selecting one organization that is already assigned in the table on the right removes the entry. Click Submit to accept the changes.

Figure 6.1: Edit Organization menu

You can review and modify the assigned locations for your Capsule Server by selecting the Locations tab in the edit menu. As in the Organizations menu, the table on the left provides a list of available locations and the table on the right provides a list of the assigned locations for your Capsule Server. Click an available location name in the left table to move it to the right table to assign it to the capsule. Selecting one location that is already assigned in the table on the right removes the entry and moves it back to the left table. Click Submit to accept the changes.

Figure 6.2: Edit Location menu

You can review your Capsule Server features, services, and their related information.

Figure 6.3: Capsule active features

To modify or configure your Capsule Server services, use the command line. The satellite-installer command configures Satellite infrastructure servers, and specifies the services to install and enable, for both Satellite Servers and Capsule Servers.

On the command, you use the --scenario option to specify which server type to configure. To list the available scenarios, use the satellite-installer --list-scenarios command.

You can enable or disable each available service with a service-specific option. For example, you can enable the TFTP service by using the --foreman-proxy-tftp true option. When enabled for the first time, each service has parameters to set. You can disable or re-enable services as needed, without clearing or resetting service parameters.

To list the available services and parameters, use the --help option with the selected scenario. To see Satellite Server services and options, use the --scenario satellite option. To see Capsule Server service and options, use the --scenario capsule option.

The following command shows a list of the services that you can enable for the Capsule Server scenario. Note the use of the grep and cut commands for brevity in the command output.

[root@capsule ~]# satellite-installer --scenario capsule --help \
| grep Enable | cut -d" " -f5
--[no-]enable-certs
--[no-]enable-foreman-proxy
--[no-]enable-foreman-proxy-content
--[no-]enable-foreman-proxy-plugin-ansible
--[no-]enable-foreman-proxy-plugin-dhcp-infoblox
--[no-]enable-foreman-proxy-plugin-dhcp-remote-isc
--[no-]enable-foreman-proxy-plugin-discovery
--[no-]enable-foreman-proxy-plugin-dns-infoblox
--[no-]enable-foreman-proxy-plugin-openscap
--[no-]enable-foreman-proxy-plugin-remote-execution-ssh
--[no-]enable-foreman-proxy-plugin-shellhooks
--[no-]enable-puppet
--foreman-proxy-bmc
--foreman-proxy-dhcp
--foreman-proxy-dns
--foreman-proxy-http
--foreman-proxy-httpboot
--foreman-proxy-logs
--foreman-proxy-puppet
--foreman-proxy-puppetca
--foreman-proxy-realm
--foreman-proxy-registration
--foreman-proxy-ssl
--foreman-proxy-templates
--foreman-proxy-tftp
--foreman-proxy-content-enable-ansible
--foreman-proxy-content-enable-deb
--foreman-proxy-content-enable-docker
--foreman-proxy-content-enable-file
--foreman-proxy-content-enable-katello-agent
--foreman-proxy-content-enable-yum
--foreman-proxy-plugin-remote-execution-ssh-ssh-kerberos-auth

The following command shows a list of the parameters for the TFTP service for the Capsule Server scenario.

[root@capsule ~]# satellite-installer --scenario capsule --help \
| grep foreman-proxy-tftp | cut -d" " -f5
--foreman-proxy-tftp
--foreman-proxy-tftp-dirs
--foreman-proxy-tftp-listen-on
--foreman-proxy-tftp-manage-wget
--foreman-proxy-tftp-managed
--foreman-proxy-tftp-replace-grub2-cfg
--foreman-proxy-tftp-root
--foreman-proxy-tftp-servername
--foreman-proxy-tftp-syslinux-filenames

You can run the satellite-installer command many times to enable new services, to modify existing service parameters, or to disable services. The command modifies only the options that you include on the current command execution. You can also run the command to enable, modify, or disable several services at the same time. When you enable new services, the command must include the required parameters for the service to function.

For example, the following satellite-installer command enables and configures the TFTP, DNS, and DHCP services on the Capsule Server:

[root@capsule ~]# satellite-installer --scenario capsule \
 --foreman-proxy-tftp true \
 --foreman-proxy-tftp-managed true \
 --foreman-proxy-tftp-servername capsule.lab.example.com \
 --foreman-proxy-dns true \
 --foreman-proxy-dns-managed true \
 --foreman-proxy-dns-interface eth1 \
 --foreman-proxy-dns-zone lab.example.com \
 --foreman-proxy-dns-forwarders 172.25.251.1 \
 --foreman-proxy-dns-reverse 251.25.172.in-addr.arpa \
 --foreman-proxy-dhcp true \
 --foreman-proxy-dhcp-managed true \
 --foreman-proxy-dhcp-interface eth1 \
 --foreman-proxy-dhcp-range "172.25.251.100 172.25.251.150" \
 --foreman-proxy-dhcp-gateway 172.25.251.1 \
 --foreman-proxy-dhcp-nameservers 172.25.251.2
...output omitted...

  The full log is at /var/log/foreman-installer/capsule.log

After you configure additional services, verify that these services display in the Satellite UI within the Overview and Services tabs.