Attach Existing Hosts Guide

In most data center environments, orcharhino needs to manage hosts which are already installed and are used in production. To do so, the existing hosts need to be attached to orcharhino, which will then serve as a repository source. There are bootstrap scripts available for the most important operating systems at https://orcharhino.local/pub/ to perform this task.

Note

You need to have root access on the host you want to attach to orcharhino. This host needs to be able to communicate with orcharhino via HTTP(s). Consider creating a backup or snapshot of your host before running any bootstrap scripts.

Debian/Ubuntu Hosts

As previously mentioned, you need to open a root shell on the host which you want to attach to orcharhino.

Note

There are some prerequisites in order to use the bootstrap script:

  • The activation key for the Debian/Ubuntu host needs to exist and needs to contain the necessary software content for this host (see Activation Keys and Content Hosts).
  • The Debian/Ubuntu orcharhino client repository needs to exist and be reachable.

Note

The bootstrap script will merely install the software needed to register a host with orcharhino. Additional steps may be necessary to complete the process. In the case of virtual machines, you will need to manually “associate” the host with orcharhino by using the Associate Host button on the relevant compute resource overview page. (See also Viewing a Virtual Machine). This will create a link between the virtual machine host and the host entry on orcharhino.

Download the bootstrap script for Debian/Ubuntu using curl, wget, or similar:

wget https://orcharhino.local/pub/deb_bootstrap.sh

The help instructions will display a list of needed options:

bash deb_bootrap.sh help

The following example uses the activation key debian_key (-a), the orcharhino client URL http://orcharhino.local/pulp/deb/ATIX/Library/custom/Debian_Client/Debian_Client_9/ (-c), and the organization ATIX (-o) to attach the host to the orcharhino on orcharhino.local. It also uses (-t) to tidy up all other repositories which are not managed through orcharhino.

Use the following dry run for an opportunity to double check your selected options:

bash deb_bootstrap.sh -a debian_key -c http://orcharhino.local/pulp/deb/ATIX/Library/custom/Debian_Client/Debian_Client_9/ -o ATIX -t -h orcharhino.local

To actually run the script, append doit to the previous command:

bash deb_bootstrap.sh -a debian_key -c http://orcharhino.local/pulp/deb/ATIX/Library/custom/Debian_Client/Debian_Client_9/ -o ATIX -t -h orcharhino.local doit

SLES Hosts

As previously mentioned, you need to open a root shell on the host which you want to attach to orcharhino.

Note

There are some prerequisites in order to use the bootstrap script:

  • The activation key for the SLES host needs to exist and needs to contain the necessary software content for this host (see Activation Keys and Content Hosts).
  • The SLES orcharhino client Repository needs to exist and be reachable.
  • SLES Base (= Pool) and SLES Update repositories need to exist and be reachable. (e.g. share them by mounting the ISO image file on an HTTP Server).

Note

The bootstrap script will merely install the software needed to register a host with orcharhino. Additional steps may be necessary to complete the process. In the case of virtual machines, you will need to manually “associate” the host with orcharhino by using the Associate Host button on the relevant compute resource overview page. (See also Viewing a Virtual Machine). This will create a link between the virtual machine host and the host entry on orcharhino.

Download the bootstrap script for SLES using curl, wget, or similar:

wget https://orcharhino.local/pub/sles_bootstrap.sh

The help instructions will display a list of needed options:

bash sles_bootstrap.sh help

The following example uses the activation key sles_key (-a), the orcharhino client URL http://orcharhino.local/pulp/deb/ATIX/Library/custom/SLES_Client/SLES_Client_12SP2/ (-c), the organization ATIX (-o), the SLES 12 SP2 Base Repository http://iso-file-server.local/pub/SLES12-SP2-Pool_for_sle-12-x86_64 (-b), the SLES 12 SP2 SP2 Update repository http://iso-file-server.local/pub/SLES12-SP2-Updates_for_sle-12-x86_64 (-u) to attach the host on the orcharhino on orcharhino.local.

Use the following dry run for an opportunity to double check your selected options:

bash sles_bootstrap.sh -a sles_key -c http://orcharhino.local/pulp/repos/ATIX/Library/custom/SLES_Client/SLES_Client_12SP2/ -h orcharhino.local -o ATIX -b http://iso-file-server.local/pub/SLES12-SP2-Pool_for_sle-12-x86_64 -u http://iso-file-server.local/pub/SLES12-SP2-Updates_for_sle-12-x86_64

To actually run the script, append doit to the previous command:

bash sles_bootstrap.sh -a sles_key -c http://orcharhino.local/pulp/repos/ATIX/Library/custom/SLES_Client/SLES_Client_12SP2/ -h orcharhino.local -o ATIX -b http://iso-file-server.local/pub/SLES12-SP2-Pool_for_sle-12-x86_64 -u http://iso-file-server.local/pub/SLES12-SP2-Updates_for_sle-12-x86_64 doit

Red Hat/CentOS Hosts

As previously mentioned, you need to open a root shell on the host which you want to attach to orcharhino.

Note

There are some prerequisites in order to use the bootstrap script:

  • The activation key for the Red Hat/CentOS host needs to exist and needs to contain the necessary software content for this host (See Activation Keys and Content Hosts).
  • To be able to use the full registration so that orcharhino manages the host completely, a host group must be configured accordingly (See Host Groups).

Download the bootstrap script for Red Hat/CentOS using curl, wget, or similar:

wget https://orcharhino.local/pub/bootstrap.py

The help instructions will display a list of needed options:

python bootstrap.py --help

The following example uses the activation key centos_key (-a) and the organization ATIX (-o) to attach the host to the orcharhino on orcharhino.local (-s), but skips the options to manage the host via DHCP, provisioning, puppet, etc. This achieves the same result as the deb_bootstrap.sh/sles_bootstrap.sh examples above.

python bootstrap.py -s orcharhino.local -o "ATIX" -a centos_key --skip-foreman

To fully register the host, so that orcharhino also manages DHCP and provisioning for that host, use the following command:

python bootstrap.py -l admin -s orcharhino.local -o "ATIX" -L "MUC" -a centos_key -g centos

In addition to the options of the previous example, this also uses the location MUC (-L), and the host group centos (-g), using the admin user (-l). The script will prompt for the admin password to log in to orcharhino and create the appropriate host configuration.