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 "ubuntu" \
-g "Ubuntu" \
-l "admin" \
-o "Example" \
-p "password" \
--deps-repository-url https://orcharhino.example.com/pulp/content/Example/Library/custom/ubuntu_Client/ubuntu_22.04/ \
--deps-repository-gpg-key https://orcharhino.example.com/pub/pulp_deb_signing.key \
-s "orcharhino.example.com"

Install sudo on your managed host:

# apt 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.

Add the GPG public key used to sign deb packages from your orcharhino Server to download the orcharhino Client for Ubuntu:

# apt-get install gnupg
# mkdir -p /etc/apt/trusted.gpg.d
# wget "https://orcharhino.example.com/pub/pulp_deb_signing.key" -O - | apt-key add -

Create a repository file which contains the orcharhino Client for Ubuntu:

# mkdir -p /etc/apt/sources.list.d
# cat > /etc/apt/sources.list.d/orcharhino.list <<'EOF'
deb http://orcharhino.example.com/pulp/content/Example/Library/custom/ubuntu_orcharhino_Client/ubuntu_orcharhino_Client/ default all
EOF

Install apt-transport-katello and katello-upload-profile. This depends on and automatically installs subscription-manager for Ubuntu, which replaces the katello-host-tools:

# apt-get update
# apt-get install apt-transport-katello katello-upload-profile

Download and execute a script from your orcharhino Server to install all necessary certificates:

# wget --no-check-certificate -O - https://orcharhino.example.com/pub/katello-rhsm-consumer | /bin/bash -x 2> /root/katello-rhsm-consumer.log

Register your host with an activation key:

# subscription-manager register \
--activationkey="Myubuntu_Activation_Key_" \
--name="ubuntu.example.com" \
--org="My_Organization"

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.

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, 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:

# apt 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, 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