Installation from Debian Package¶
Table of Contents
Prerequisites¶
NICs¶
Start with an Ubuntu trusty(14.04) instance with 2 nics:
eth0
for thepublic
network - providing access to RackHD APIs, and providing routed (layer3) access to out of band network for machines under managementeth1
for dhcp/pxe to boot/configure the machines
edit the network:
eth0
- assign IP address as appropriate for the environment, or you can use DHCPeth1
static ( 172.31.128.0/22 )
please check the network config file: /etc/network/interfaces
. The eth1
’s ip address is 172.31.128.1
Like as follows:
auto eth1
iface eth1 inet static
address 172.31.128.1
post-up ifconfig eth1 promisc
Start with an Ubuntu xenial(16.04) instance with 2 nics:
ens160
for thepublic
network - providing access to RackHD APIs, and providing routed (layer3) access to out of band network for machines under managementens192
for dhcp/pxe to boot/configure the machines
Note
You might get different ethernet name from ens160/ens192 in your OS system. Please replace it with what you get accordingly.
Edit the network:
ens160
- assign IP address as appropriate for the environment, or you can use DHCPens192
static ( 172.31.128.0/22 )
Please check the network config file: /etc/network/interfaces
. The ens192
’s ip address is 172.31.128.1
Like as follows:
auto ens192
iface ens192 inet static
address 172.31.128.1
post-up ifconfig ens192 promisc
NodeJS¶
If Node.js is not installed
sudo apt-get remove nodejs nodejs-legacy
curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo apt-get remove nodejs nodejs-legacy
curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo apt-get remove nodejs nodejs-legacy
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs
Ensure Node.js is installed properly, example:
node -v
Install & Configure RackHD¶
After Prerequisites installation, there’re two options to install and configure RackHD from package
Either (a) or (b) can lead the way to install RackHD from debian packages.
- Install/Configure with Ansible Playbook
- Install/Configure with Step by Step Guide
Install/Configure with Ansible Playbook
(1). install git and ansible
sudo apt-get install git
sudo apt-get install ansible
(2). clone RackHD code
git clone https://github.com/RackHD/RackHD.git
The services files in /etc/init/
all need a conf file to exist in /etc/default/{service}
Touch those files to allow the upstart scripts to start automatically.
for service in $(echo "on-dhcp-proxy on-http on-tftp on-syslog on-taskgraph");
do sudo touch /etc/default/$service;
done
(3). Run the ansible playbooks
These will install the prerequisite packages, install the RackHD debian packages, and copy default configuration files
cd RackHD/packer/ansible
ansible-playbook -c local -i "local," rackhd_package.yml
(4). Verify RackHD services
All the services are started and have logs in /var/log/rackhd.
Verify with service on-[something] status
Notes:isc-dhcp-server
is installed through ansible playbook, but sometimes it won’t start on Ubuntu boot (https://ubuntuforums.org/showthread.php?t=2068111),
check if DHCP service is started:
sudo service --status-all
If isc-dhcp-server is not running, run below to start DHCP service:
sudo service isc-dhcp-server start
Install/Configure with Step by Step Guide
(1). Install the prerequisite packages:
sudo apt-get install rabbitmq-server sudo apt-get install mongodb sudo apt-get install snmp sudo apt-get install ipmitool sudo apt-get install ansible sudo apt-get install apt-mirror sudo apt-get install amtterm sudo apt-get install isc-dhcp-serverNote: MongoDB versions 2.4.9 (on Ubuntu 14.04), 2.6.10 (on Ubuntu 16.04) and 3.4.9 (on both Ubuntu 14.04 and 16.04) are verified with RackHD. For more details on how to install MongDB 3.4.9, please refer to: https://docs.mongodb.com/manual/tutorial/install-mongodb-on-ubuntu/
(2). Set up the RackHD bintray repository for use within this instance of Ubuntu
echo "deb https://dl.bintray.com/rackhd/debian trusty main" | sudo tee -a /etc/apt/sources.list
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 379CE192D401AB61
sudo apt-get update
(3). Install RackHD debian package
The services files in /etc/init/ all need a conf file to exist in /etc/default/{service} Touch those files to allow the upstart scripts to start automatically.
for service in $(echo "on-dhcp-proxy on-http on-tftp on-syslog on-taskgraph");
do sudo touch /etc/default/$service;
done
Install the RackHD Packages. Note: these packages are rebuilt on every commit to master and are not explicitly versioned, but intended as a means to install or update to the latest code most conveniently.
sudo apt-get install on-dhcp-proxy on-http on-taskgraph
sudo apt-get install on-tftp on-syslog
(4). Basic RackHD Configuration
DHCP
Update dhcpd.conf per your network configuration
# RackHD added lines
deny duplicates;
ignore-client-uids true;
subnet 172.31.128.0 netmask 255.255.240.0 {
range 172.31.128.2 172.31.143.254;
# Use this option to signal to the PXE client that we are doing proxy DHCP
option vendor-class-identifier "PXEClient";
}
Notes:sometimes isc-dhcp-server won’t start on Ubuntu boot (https://ubuntuforums.org/showthread.php?t=2068111), check if DHCP service is started:
sudo service --status-all
If isc-dhcp-server is not running, run below to start DHCP service:
sudo service isc-dhcp-server start
RACKHD APPLICATIONS
Create the required file /opt/monorail/config.json , you can use the demonstration configuration file at https://github.com/RackHD/RackHD/blob/master/packer/ansible/roles/monorail/files/config.json as a reference.
RACKHD BINARY SUPPORT FILES
Downloaded binary files from bintray.com/rackhd/binary and placed them using https://github.com/RackHD/RackHD/blob/master/packer/ansible/roles/images/tasks/main.yml as a guide.
#!/bin/bash
mkdir -p /var/renasar/on-tftp/static/tftp
cd /var/renasar/on-tftp/static/tftp
for file in $(echo "\
monorail.ipxe \
monorail-undionly.kpxe \
monorail-efi64-snponly.efi \
monorail-efi32-snponly.efi");do
wget "https://dl.bintray.com/rackhd/binary/ipxe/$file"
done
mkdir -p /var/renasar/on-http/static/http/common
cd /var/renasar/on-http/static/http/common
for file in $(echo "\
discovery.docker.tar.xz \
initrd-1.2.0-rancher \
vmlinuz-1.2.0-rancher");do
wget "https://dl.bintray.com/rackhd/binary/builds/$file"
done
All the services are started and have logs in /var/log/rackhd.
Verify with service on-[something] status
How to Erase the Database to Restart Everything¶
sudo service on-http stop sudo service on-dhcp-proxy stop sudo service on-syslog stop sudo service on-taskgraph stop sudo service on-tftp stop mongo pxe db.dropDatabase() ^D sudo service on-http start sudo service on-dhcp-proxy start sudo service on-syslog start sudo service on-taskgraph start sudo service on-tftp start