Configuring the UniCluster Repositories and Install UniCluster

From UniCluster

Configuring the UniCluster Repositories and Install UniCluster

# rpm -ivh unicluster-repo-4.1.1-0.noarch.rpm
  • When the rpm installs it will give you a warning reminding you to use your unicluster.org username and password to access the UniCluster repository
  • Run the uninetwork-register configuration script
# cd /opt/tortuga/sbin
# ./uninetwork-register
 To register you will need to sign up for a free account on http://www.unicluster.org
 and have Internet access.


 Do you wish to proceed   [yes]: yes


 Please enter your unicluster.org username: bbryce
 Please enter your unicluster.org password:
 Please re-enter your unicluster.org password:

 Username and Password verified.
  • Download the UniCluster rpms from the repository. This can take some time if you have a slow connection.
# yum install unicluster
  • When yum finishes installing the rpms source the unicluster environment
# source /opt/tortuga/bin/tortugaenv.sh
  • Run the unicluster-setup script
# cd /opt/tortuga/sbin
# ./unicluster-setup


UniCluster Setup

Installer Node Information:

    +------------------+--------------------------------+
    | Full Hostname    | univatest                      |
    | Short Hostname   | univatest                      |
    | Timezone         | America/New_York               |
    | UTC time         | 1                              |
    | Gateway          |                                |
    | DNS Servers      | 172.16.254.2                   |
    | DNS Search Order | localdomain                    |
    | Language         | en                             |
    | Keyboard         | us                             |
    +------------------+--------------------------------+

Detected Network Interfaces:

    +------------+-------------------+-------------------+
    | Interface  | eth0              | eth1              |
    +------------+-------------------+-------------------+
    | Type       | DHCP              | STATIC            |
    | Enabled    | YES               | YES               |
    | IP Address | 172.16.254.133    | 192.168.1.100     |
    | Network    | 172.16.254.0      | 192.168.1.0       |
    | Netmask    | 255.255.255.0     | 255.255.255.0     |
    | MAC Addr   | 00:0C:29:E4:50:00 | 00:0C:29:E4:50:0A |
    +------------+-------------------+-------------------+


WARNING: eth1 is the only enabled network interface
         with a static IP address.

UniCluster will run a DHCP server on eth1 to provision compute
nodes.  If there are existing devices on the 192.168.1.0 network that
use DHCP, this may disrupt operations.

Do you want to continue [no]: yes
  • Choose the firewall setting for your cluster. Option #3 NAT routing is the typical setup for a Beowulf cluster. Option #2 creates a completely private cluster.

How do you want to configure the installer node's Firewall:

  1. Disabled (no firewall)
  2. Enabled (no routing)
  3. Enabled with NAT Routing
  4. Enabled with Direct Routing

Select Firewall Mode [2]: 
  • Enter the name of the cluster. This is the name used by tools such as the batch system.

This node will function as the primary installer for this cluster.

Enter the Cluster Name to assign to this cluster [My Cluster]: billcluster

Using Cluster Name [billcluster]
  • Choose a name for the cluster DNS zone. All machines in the cluster will belong to this DNS domain. Do not choose an existing DNS domain name already in use in your company.
UniCluster creates a DNS domain for all nodes it installs.
This node will function as a primary DNS server for this domain.

Enter the DNS Domain to create for this cluster [example.com]: billz

Using DNS Domain [billz]
  • Choose a path for the cluster Operating System repositories. UniCluster stores all of the OS repositories in this location.

UniCluster requires a 10GB Depot Directory for storage.

Enter the path to the Depot [/depot]: 
  • Insert the OS media you downloaded from the internet in the Before you start section of these instructions. If you have the OS on CD/DVD just press enter. If you downloaded an ISO but did not burn it to disk then provide the path to the ISO.

The OS Media is needed at this time.  You must insert the OS media for the machine you are running on.  That is if you are installing on CentOS 64bit you will need the CentOS 64 bit DVD.

Is the OS Media on Disc, ISO, or Filesystem? [disc]: 

Using Media Location [disc]
Insert the OS media into the drive and press Enter to continue: 
Copying the media.  Please wait this will take some time!
0%.. 10%.. 20%.. 30%.. 40%.. 50%.. 60%.. 70%.. 80%.. 90%.. 100%
0%.. 
  • Creating the cluster repository and building the images may take a long time, sometimes as much as 20 minutes. If you are installing on a virtual machine it is much slower than real hardware.
  • When the installation script finishes you should see the following message:

Congratulations!  You should be able to install compute nodes on:

   Network 192.168.1.0 on interface eth1

Please see http://univatest to view the documentation for the cluster.

UniCluster is now installed on the frontend. If you open a browser and navigate to http://localhost you will see the homepage of the cluster. The next section of this install guide describes how to add kits to the installer node and configure them.


Continue to the next step: Configuring The Installer Node