Demo-Image Quick Start Guide

This guide describes how to install the orcharhino demo-image on your vSphere-server. It is also intended to provide the basic configuration steps needed to deploy your first host with orcharhino.

Prerequisites and System Requirements

In order to install the orcharhino demo-image on your vSphere-server, you will require the following:

  • The orcharhino demo-image ova-file (you can get access here)
  • A vSphere-server supporting VirtualHardwareVersion >= 8 (vSphere >= 5.0)
  • Sufficient system resources for orcharhino as well as any hosts you would like to deploy (see also Prerequisites and System Requirements):
    • orcharhino: 4CPUs, 12GB RAM, 100GB HDD
    • per host: min. 1CPU, 2GB RAM, 30GB HDD
  • An empty virtual network with internet-access (you will find the details on the PDF you received along with the ova-file)

Warning

Ensure the virtual network does not include any existing hosts and is not being managed by any existing DHCP-servers. orcharhino has it’s own DHCP-server to manage the network it is in.

Installing the Image on vSphere

The orcharhino demo-image is delivered in the Open Virtual Appliance format (OVA). This format ensures that all virtual hardware is already described in the package. Installation on your virtualization service is easy, but might require different steps than the ones described here depending on the used management console. The screenshots for this guide were taken on the HTML5 vSphere Client of a vSphere Server 6.5.0.

  1. Deploying the OVF-Template: Enter the management console, select the data center where orcharhino is to be installed and select the action Deploy OVF-Template....

    Select 'Deploy OVF-Template...' from the data center's actions-menu
  2. Template selection: On the following window, enter the path to the orcharhino demo-image OVA-file. It is possible to enter the URL to the OVA-file on the ATIX server.

    Select the demo-image file for deployment

Initial Configuration

After successful import and startup of the demo-image, the WebGUI of the orcharhino is available at https://192.168.153.10/. To prevent the warning about a self-signed certificate, the orcharhino’s local CA-certificate may be downloaded and installed into the browser from http://192.168.153.10/pub/katello-server-ca.crt.

Note

The login credentials for the WebGUI are on the PDF you received along with the image.

The following subsections describe the actions required in order to deploy your first host using orcharhino.

Choosing the Correct Location

Select the location main by clicking on Any location in the top bar (see also: The Context Menu) as follows:

Choose the pre-configured Location 'main'

Adding a Compute Resource

Add your vSphere-server as a new compute resource (see also Creating a Compute Resource). The compute resources page is found in The Infrastructure Menu.

  1. Click the Create Compute Resource button and select VMWare as Provider.
  2. The form expands and provides additional input-fields for the necessary data.
  3. Enter the hostname and the credentials of the VMWare-server.
  4. Clicking the Load Datacenters button should make the available data centers selectable.
Configure your vSphere-server as a 'Compute Resource'

Adjusting the Compute Profiles

Your newly created compute resource will also add some preinstalled compute profiles. These can be adjusted on the compute profiles page (see also: Compute Profiles). Click on the name of the preinstalled profile and on the next page on the name of the compute resource. On this page, the virtual-hardware for new hosts can be selected (see also Creating a Compute Profile).

The mandatory settings are:

  1. Cluster and Resource pool
  2. Storage: Storage Pod and Datastore
  3. Network interfaces: Network

Note

Make sure to assign at least 2GB of RAM, otherwise some operating-systems cannot be deployed on new hosts.

Adding a Host Group

Create a host group for easy deployment of hosts with similar configuration. This guide only shows a minimal configuration without content- or config-management (see also Content Management Guide).

  1. Click Create Host Group on the host groups page (see also Host Groups).
  2. Choose a Name and select the Compute Resource under Deploy on as well as the Compute profile.
Choose a 'name' for the new Host Group, where it should be deployed in the 'Deploy on'-field and the assigned resources by selecting a 'Compute Profile'.
  1. Go to the Network tab and choose the Domain: demo as well as the IPv4 Subnet: DEV153.
On the 'Network' tab, select 'Domain' and 'IPv4-Subnet'.
  1. Go to the Operating System tab and choose the Operating System for the hosts (e.g. Debian Stretch). Setting PXE Loader to PXELinux BIOS should be sufficient for most systems.
Select an operating system from the list and set the root password

After saving the configuration of your new host group, orcharhino is all set to deploy the first host. Also see Host Groups for further description of additional configuration-options.

Deploying a New Host

Use the Create Host menu entry in The Hosts Menu to access the create host page (see also: Create Host). Select the Host Group and the Compute Profile you created. Selecting a host group will automatically fill many of the other fields with the settings of the host group. As a result these settings should be sufficient to deploy the host. Notice that a random Name is automatically proposed (adjust as desired).

Select host group in the 'Create Host' form

Clicking the Submit button initiates deployment of the host and loads the host overview page (see also Viewing a Host).

Congratulations, your first host is being deployed by orcharhino. To view the console of the new host, click the Console button. The new page will provide a link that can be opened with the VMware Remote Console application.

After successful installation, the host overview page will show build-status as Installed.

Further Steps

Now that you have successfully deployed your first host, you may want to check out some of orcharhino’s other features. The Content Management Guide is a good place to start. Using orcharhino’s content management will allow you to deploy hosts that receive some or all of their packages via orcharhino.

The Introduction chapter of this documentation provides an overview of orcharhino and it’s features.