Registering hosts and setting up host integration

Download the bootstrap.py script using wget:

$ wget https://orcharhino.example.com/pub/bootstrap.py

Use the --help option to display a list of mandatory options:

$ python bootstrap.py --help

Register an existing host to orcharhino:

$ ./bootstrap.py \
--fqdn "my-host.example.com" \
--skip "puppet" \
-L "Munich" \
-a "red_hat_enterprise_linux" \
-g "Red Hat Enterprise Linux" \
-l "admin" \
-o "Example" \
-p "password" \
-s "orcharhino.example.com"

Install sudo on your managed host:

$ dnf install -y sudo

Add your custom user:

$ useradd -m My_Custom_User

Set up SSH for your custom user:

$ mkdir -p ~My_Custom_User/.ssh
$ chmod 0700 ~My_Custom_User/.ssh
$ chown -R My_Custom_User: ~My_Custom_User/.ssh

Add your custom user to the sudoers file:

$ echo "My_Custom_User ALL = (root) NOPASSWD : ALL" >> /etc/sudoers
$ echo "Defaults:_My_Custom_User_ My_Custom_User_Password" >> /etc/sudoers

Run the bootstrap.py script:

$ ./bootstrap.py --force

Navigate to Hosts > All Hosts and select your host.

In the Select Action menu, click Disassociate Hosts.

Navigate to Infrastructure > Compute Resources and select your compute resource.

Click Associate VMs.

In case your orcharhino Server or orcharhino Proxies run on the same compute resource, disassociate the VMs on the All Hosts page again.

Install subscription-manager on your host:

$ dnf install subscription-manager

Install the necessary certificates to connect to orcharhino:

$ rpm -Uvh http://orcharhino.example.com/pub/katello-ca-consumer-latest.noarch.rpm

Register your host with an activation key:

$ subscription-manager register \
--activationkey="Myred_hat_enterprise_linux_Activation_Key_" \
--name="red_hat_enterprise_linux.example.com" \
--org="My_Organization"

Install katello-host-tools on your host:

$ dnf install katello-host-tools katello-host-tools-tracer

To use remote execution, add the SSH public key from orcharhino Server. For more information, see Adding SSH Keys for Remote Execution.

Create the required directory:

$ mkdir -p ~root/.ssh

Add the SSH public key from your orcharhino:

$ cat << EOF >> ~root/.ssh/authorized_keys
ssh-rsa My_SSH_Public_Key foreman-proxy@orcharhino.example.com
EOF

On your managed hosts, view the MAC address, IP address, and device identifier of the network interface providing a connection to your orcharhino:

$ ip a

Navigate to Hosts > All Hosts, select your host, and click Edit.

On the Interfaces tab, click Edit and enter the MAC address, IPv4 address, and the device identifier.

Click Submit to save your changes.

Navigate to Hosts > All hosts and tick the checkbox of your host.

In the Select Action drop down menu, click Disassociate Hosts.

Navigate to Infrastructure > Compute Resources and select the compute resource your host runs on.

On the Compute Resources tab, click Associate VMs.

Optional: Navigate to Hosts > All Hosts, select your host, and verify your change by changing the power status of the host.

On the content host, install the katello-host-tools-tracer RPM package:

$ yum install katello-host-tools-tracer

Enter the following command:

$ katello-tracer-upload

In the orcharhino management UI, navigate to Hosts > All Hosts, then click the required host name.

Click the Traces tab to view Traces. If it is not installed, an Enable Traces button initiates a remote execution job that installs the package.

In the orcharhino management UI, navigate to Configure > Global Parameters to add host parameters globally. Alternatively, you can navigate to Configure > Host Groups and edit or create a host group to add host parameters only to a host group.

Enable the Puppet agent using a host parameter in global parameters or a host group. Add a host parameter named enable-puppet7, select the boolean type, and set the value to true.

Specify configuration for the Puppet agent using the following host parameters in global parameters or a host group:

Navigate to Hosts > Register Host and register your host using an appropriate activation key. For more information, see Registering Hosts in Managing Hosts.

Navigate to Infrastructure > orcharhino Proxies.

From the list in the Actions column for the required orcharhino Proxy Server, select Certificates.

Click Sign to the right of the required host to sign the SSL certificate for the Puppet agent.

Log in to the host as the root user.

Install the Puppet agent package:

$ dnf install puppet-agent

Add the Puppet agent to PATH in your current shell using the following script:

. /etc/profile.d/puppet-agent.sh

Configure the Puppet agent. Set the environment parameter to the name of the Puppet environment to which the host belongs:

$ puppet config set server orcharhino.example.com --section agent
$ puppet config set environment My_Puppet_Environment --section agent

Start the Puppet agent service:

$ puppet resource service puppet ensure=running enable=true

Create a certificate for the host:

$ puppet ssl bootstrap

In the orcharhino management UI, navigate to Infrastructure > orcharhino Proxies.

From the list in the Actions column for the required orcharhino Proxy Server, select Certificates.

Click Sign to the right of the required host to sign the SSL certificate for the Puppet agent.

On the host, run the Puppet agent again:

$ puppet ssl bootstrap