LUCI4HPC step by step installation

Prerequisites

A supported Linux distribution (Ubuntu 12.04 LTS server) should be installed on the server that will become the management node.
NOTE: There should be no services installed on this machine except openSSH! Only the external network interface should be configured!

Getting LUCI4HPC

Please visit http://luci.boku.ac.at, after the registration you can download the LUCI4HPC installer.

Installation

Running the LUCI4HPC installer

Set the execution flag on the LUCI4HPC installer

chmod +x luci4hpc_1.0beta1_ubuntu12.04.sh
Run the installer with superuser privileges
sudo ./luci4hpc_1.0beta1_ubuntu12.04.sh

Installation steps

License agreement:

You will have to accept the LUCI4HPC license.

Configuration:

You will have to answer a series of questions to configure your new cluster.
You will have a chance to review your choices after answering all questions.

NOTE: In the case that a default value is provided in brackets, you can just hit enter to continue to the next question and take the default value.

Questions:

 Please enter the desired ip address for the cluster: (default 10.1.1.1):
- This is the IP address of the network interface that is connected to the internal cluster network.
- In the current version this needs to be a IPv4 address.
- This will be the gateway address for all other nodes.
- This should be a non routable address (e.g. 10.0.0.0 - 10.255.255.255, 172.16.0.0 - 172.31.255.255, 192.168.0.0 - 192.168.255.255).
- The default value is 10.1.1.1 .
Please enter the desired broadcast address: (default 10.1.1.255):
- This is the corresponding broadcast address to the internal cluster IP address.
- Adjust if you have more than 254 nodes.
- The default value is 10.1.1.255 .
Please enter the desired netmask for the cluster: (default 255.255.255.0):
- This is the corresponding subnet mask to the internal cluster IP address.
- Adjust if you have more than 254 nodes.
- The default value is 255.255.255.0, which corresponds to a C-class network of maximally 254 nodes.
Please enter the desired starting address for the nodes: (default 10.1.1.2):
- This is the address of the first node that will be added.
- The default value is 10.1.1.2 , the next free address.
Please enter the desired external ip address: (default external IP):
- This is the already configured external IP address of the management node.
- The default value is taken from the first output of "ifconfig".
Please enter the desired external network interface for the cluster: (default eth0):
- This is the network interface connected to the outside network.
- The default value is eth0.
Please enter the desired internal network interface for the cluster: (default eth1):
- This is the network interface connected to the internal network of the cluster.
- The default value is eth1.
Please enter the desired name for the cluster: (default luci)
- This is the desired name of the cluster.
- This should not be a fully qualified domain name(FQDN).
Please enter the desired domain for the cluster: (default lc)
- This is the desired domain name of the cluster on the internal network.
- All nodes will be referred to as hostname.domain name .
- The management node will be called cluster name.domain name .
Please enter the desired email address from which the cluster will send emails:
- This is the e-mail address the cluster will use to send notifications to the users.
- Any e-mail account that supports SMTP can be used.
Please enter the mail server for the cluster email address:
- This is the SMTP server for the e-mail address specified in the previous step.
Does the mail server use TLS authentification?: [y/n]
- You need to specify if the SMTP server uses TLS.
Please enter the username for the mail server of the cluster email address:
- This is the username for the SMTP authentification.
Please enter the password for the mail server of the cluster email address:
- This is the password for the SMTP authentification.
- It will be stored encrypted.
Please enter the desired time server to be used:
- This is an external timer server you want to synchronize your cluster time with.
Please enter the desired locale: (default locale):
- This is the desired locale to be used for the node installation.
- The default is the locale of the management node.
Please enter the desired keyboard layout: (default keyboard layout):
- This is the desired keyboard layout to be used for the node installation.
- The default is the keyboard layout of the management node.
Please enter the desired timezone: (default timezone):
- This is the desired timezone to be used for the node installation.
- The default is the timezone of the management node.
Please enter the desired external interface for login nodes: (default eth1):
- This is the network interface of the login node(s) connected to the outside network.
- Choose this depending on where you will connect the cables to the designated login node(s).
Additional boot options for the nodes: (default vga=normal):
- Here you can specify additional boot options to be used when booting the nodes for the installation.
- Choose this depending on the needs of your nodes hardware.
- The default value is "vga=normal".
Please enter the desired session timeout for the control panel in seconds: (default 1800):
- This is the inactivity time in seconds after which you will be automatically logged out of the control panel.
- The default value is half an hour.
Please enter the desired timeout for the cache in seconds: (default 604800):
- This is the time in seconds after which a package in the cache will be considered obsolete and deleted.
- The default value is 1 week.
Please enter the desired repository to be used for the node installation: (default repository):
- This is the desired package repository which should be used by the caching service to retrieve the packages during the node installation.
- The default value is the repository used by the management node.

Installation:

After you confirm the configuration, the installer will:
- Build the directory tree
- Configure the internal interface
- Install package dependencies (openSSL and NTP)
- Configure the time server
- Configure iptables
- Download the Ubuntu netboot
- Enable IP forwarding
- Extract all files
- Write the configuration
- Create the necessary startup files

After the installation:

The installer prints a unique key which represents your management node at the end.
Enter this code when generating a license file on the LUCI4HPC website.

This completes the installation.
After you have acquired a license, you can start LUCI4HPC and add nodes.

It is recommended to configure the cluster (e.g. adding mountpoints) before adding nodes.

Back

Current version: 1.0beta1
 

Imprint