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)
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.
Deploying the OVF-Template: Enter the management console, select the data center where orcharhino is to be installed and select the action
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.
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.
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:
Adding a Compute Resource¶
- Click the Create Compute Resource button and select
- The form expands and provides additional input-fields for the necessary data.
- Enter the hostname and the credentials of the VMWare-server.
- Clicking the Load Datacenters button should make the available data centers selectable.
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:
- Cluster and Resource pool
- Storage: Storage Pod and Datastore
- Network interfaces: Network
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).
Create Host Groupon the host groups page (see also Host Groups).
- Choose a Name and select the Compute Resource under Deploy on as well as the Compute profile.
- Go to the Network tab and choose the Domain:
demoas well as the IPv4 Subnet:
- Go to the Operating System tab and choose the Operating System for the hosts (e.g.
Debian Stretch). Setting PXE Loader to
PXELinux BIOSshould be sufficient for most systems.
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).
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
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.