6.13.2. OS Installation¶

6.13.2.1. Setting up RackHD OS repository with image service¶

Image servie provides a convinient method for users to setup OS repository, details please refer to https://github.com/RackHD/image-service. Alternatively, users could setup the repos by executing Configuring RackHD OS Mirrors and Making the Mirrors.

6.13.2.2. Configuring RackHD OS Mirrors¶

Setting up a Windows OS repo

• Mounting the OS Image:

Windows’ installation requires that Windows OS’ ISO image must be mounted to a directory accessable to the node. In the example below a windows server 2012 ISO image is being mounted to a directory name Licensedwin2012

sudo mount -o loop /var/renasar/on-http/static/http/W2K2012_2015-06-08_1040.iso /var/renasar/on-http/static/http/Licensedwin2012

• Export the directory

Edit the samba config file in order to export the shared directory

sudo nano /etc/samba/smb.conf

[windowsServer2012]
    comment = not windows server 201
    path = /var/renasar/on-http/static/http/Licensedwin2012
    browseable = yes
    guest ok = yes
    writable = no
    printable = no

• Restart the samba share

sudo service samba restart

MIRRORS

Mirrors may not be something you need to configure if you’re utilizing the proxy capabilities of RackHD. If you previously configured proxies to support OS installation workflows, then those should be configured to provide access to the files needed. If you do not, or can not, utilize proxies, then you can host the OS installation files directly on the same instance with RackHD. The following instructions show how to create OS installation mirrors in support of the existing workflows.

Set the Links to the Mirrors:

sudo ln -s /var/mirrors/ubuntu <on-http directory>/static/http/ubuntu
sudo ln -s /var/mirrors/ubuntu/14.04/mirror/mirror.pnl.gov/ubuntu/ <on-http directory>/static/http/trusty
sudo ln -s /var/mirrors/centos <on-http directory>/static/http/centos
sudo ln -s /var/mirrors/suse <on-http directory>/static/http/suse

6.13.2.3. Making the Mirrors¶

Centos 6.5

Notes: Because CentOS 6.5 was deprecated by provider, the following rsync source is not available to make mirror. Just leave it for an example.

sudo rsync --progress -av --delete --delete-excluded --exclude "local*" \
--exclude "i386" rsync://centos.eecs.wsu.edu/centos/6.5/ /var/mirrors/centos/6.5

Centos 7.0

sudo rsync --progress -av --delete --delete-excluded --exclude "local*" \
--exclude "i386" rsync://centos.eecs.wsu.edu/centos/7/ /var/mirrors/centos/7

OpenSuse 12.3

sudo rsync --progress -av --delete --delete-excluded --exclude "local*" --exclude "i386" --exclude "i586" --exclude "i686" rsync://mirror.clarkson.edu/opensuse/distribution/12.3/ /var/mirrors/suse/distribution/12.3
sudo rsync --progress -av --delete --delete-excluded --exclude "local*" --exclude "i386" --exclude "i586" --exclude "i686" rsync://mirror.clarkson.edu/opensuse/update/12.3 /var/mirrors/suse/update
sudo rsync --progress -av --delete --delete-excluded --exclude "local*" --exclude "i386" --exclude "i586" --exclude "i686" rsync://mirror.clarkson.edu/opensuse/update/12.3-non-oss /var/mirrors/suse/update

OpenSuse 13.1

sudo rsync --progress -av --delete --delete-excluded --exclude "local*" --exclude "i386" --exclude "i586" --exclude "i686" rsync://mirror.clarkson.edu/opensuse/distribution/13.1/ /var/mirrors/suse/distribution/13.1
sudo rsync --progress -av --delete --delete-excluded --exclude "local*" --exclude "i386" --exclude "i586" --exclude "i686" rsync://mirror.clarkson.edu/opensuse/update/13.1 /var/mirrors/suse/update
sudo rsync --progress -av --delete --delete-excluded --exclude "local*" --exclude "i386" --exclude "i586" --exclude "i686" rsync://mirror.clarkson.edu/opensuse/update/13.1-non-oss /var/mirrors/suse/update

OpenSuse 13.2

sudo rsync --progress -av --delete --delete-excluded --exclude "local*" --exclude "i386" --exclude "i586" --exclude "i686" rsync://mirror.clarkson.edu/opensuse/distribution/13.2/ /var/mirrors/suse/distribution/13.2
sudo rsync --progress -av --delete --delete-excluded --exclude "local*" --exclude "i386" --exclude "i586" --exclude "i686" rsync://mirror.clarkson.edu/opensuse/update/13.2 /var/mirrors/suse/update
sudo rsync --progress -av --delete --delete-excluded --exclude "local*" --exclude "i386" --exclude "i586" --exclude "i686" rsync://mirror.clarkson.edu/opensuse/update/13.2-non-oss /var/mirrors/suse/update

Ubuntu

[IMPORTANT] DNS server is required in Ubuntu installation, make sure you have put following lines in /etc/dhcp/dhcpd.conf. 172.31.128.1 is a default option in RackHD

option domain-name-servers 172.31.128.1;
option routers 172.31.128.254;

[Method-1] For iso installation, see this payload https://github.com/RackHD/RackHD/blob/master/example/samples/install_ubuntu_payload_iso_minimal.json Remember to replace {{ file.server }} with your own, see ‘fileServerAddress’ and ‘fileServerPort’ in /opt/monorail/config.json

mkdir ~/iso && cd !/iso

# Download iso file
wget http://releases.ubuntu.com/13.04/ubuntu-14.04.5-server-amd64.iso

# Create mirror folder
mkdir -p /var/mirrors/ubuntu

# Replace {on-http-dir} with your own
mkdir -p {on-http-dir}/static/http/mirrors

# Mount iso
sudo mount ubuntu-14.04.5-server-amd64.iso /var/mirrors/ubuntu

sudo ln -s /var/mirrors/ubuntu {on-http-dir}/static/http/mirrors/

# Create workflow
# Replace the 9090 port if you are using other ports
# You can configure the port in /opt/monorail/config.json -> 'httpEndPoints' -> 'northbound-api-router'
curl -X POST -H 'Content-Type: application/json' -d @install_ubuntu_payload_iso_minimal.json 127.0.0.1:9090/api/current/nodes/{node-id}/workflows?name=Graph.InstallUbuntu | jq '.'

[Method-2] For live installation, see this payload https://github.com/RackHD/RackHD/blob/master/example/samples/install_ubuntu_payload_minimal.json Remember to replace repo with your own {fileServerAddress}:{fileServerPort}/ubuntu, you can find the proper parameters in /opt/monorail/config.json

Add following block into httpProxies in /opt/monorail/config.json

{
  "localPath": "/ubuntu",
  "server": "http://us.archive.ubuntu.com/",
  "remotePath": "/ubuntu/"
}

# Create workflow
# Replace the 9090 port if you are using other ports
# You can configure the port in /opt/monorail/config.json -> 'httpEndPoints' -> 'northbound-api-router'
curl -X POST -H 'Content-Type: application/json' -d @install_ubuntu_payload_minimal.json 127.0.0.1:9090/api/current/nodes/{node-id}/workflows?name=Graph.InstallUbuntu | jq '.'

[Method-3] For the Ubuntu repo, you need some additional installation. The mirrors are easily made on Ubuntu, but not so easily replicated on other OS. On any recent distribution of Ubuntu:

    # make the mirror directory (can sometimes hit a permissions issue)
    sudo mkdir -p /var/mirrors/ubuntu/14.04/mirror
    # create a file in /etc/apt/mirror.list (config below)
    sudo vi /etc/apt/mirror.list
    # run the mirror
    sudo apt-mirror


############# config ##################
#
set base_path    /var/mirrors/ubuntu/14.04
#
# set mirror_path  $base_path/mirror
# set skel_path    $base_path/skel
# set var_path     $base_path/var
# set cleanscript $var_path/clean.sh
# set defaultarch  <running host architecture>
# set postmirror_script $var_path/postmirror.sh
# set run_postmirror 0
set nthreads     20
set _tilde 0
#
############# end config ##############

deb-amd64 http://mirror.pnl.gov/ubuntu trusty main
deb-amd64 http://mirror.pnl.gov/ubuntu trusty-updates main
deb-amd64 http://mirror.pnl.gov/ubuntu trusty-security main
clean http://mirror.pnl.gov/ubuntu

#end of file
###################

Debian For live installation, see this payload https://github.com/RackHD/RackHD/blob/master/example/samples/install_debian_payload_minimal.json Remember to replace repo with your own {fileServerAddress}:{fileServerPort}/debian, you can find the proper parameters in /opt/monorail/config.json

Add following block into httpProxies in /opt/monorail/config.json

{
  "localPath": "/debian",
  "server": "http://ftp.us.debian.org/",
  "remotePath": "/debian/"
}

# Create workflow
# Replace the 9090 port if you are using other ports
# You can configure the port in /opt/monorail/config.json -> 'httpEndPoints' -> 'northbound-api-router'
curl -X POST -H 'Content-Type: application/json' -d @install_debian_payload_minimal.json 127.0.0.1:9090/api/current/nodes/{node-id}/workflows?name=Graph.InstallDebian | jq '.'

Reference: Here are some useful links to vendor’s official website about Mirros setup.

• CentOS: Creating Local Mirrors for Updates or Installs

6.13.2.4. Supported OS Installation Workflows¶

Supported OSes and their workflows are listed in table, and the listed versions have been verified by RackHD, but not limited to these, this table will be updated when more versions are verified.

6.13.2.5. OS Installation Workflow APIs¶

An example of starting an OS installation workflow for CentOS:

curl -X POST \
     -H 'Content-Type: application/json' \
     -d @params.json \
     <server>/api/current/nodes/<identifier>/workflows?name=Graph.InstallCentOS

An example of params.json with minimal parameters for installing CentOS workflow:

{
    "options": {
        "defaults": {
            "version": "7",
            "repo": "http://172.31.128.1:9080/mirrors/centos/7/os/x86_64"
        }
    }
}

An example of params.json with full set of parameters for installing CentOS workflow:

{
    "options": {
        "defaults": {
            "version": "7",
            "repo": "http://172.31.128.1:9080/mirrors/centos/7/os/x86_64",
            "rootPassword": "root12345",
            "hostname": "rackhd-node",
            "domain": "abc.com",
            "users": [
                {
                    "name": "rackhd1",
                    "password": "123456",
                    "uid": 1010,
                    "sshKey": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDJQ631/sw3D40h/6JfA+PFVy5Ofz6eu7caxbv0zdw4fTJsrFcOliHZTEtAvqx7Oa8gqSC6d7v61M0croQxtt1DGUcH2G4yhfdZOlK4pr5McwtX0T/APACdAr1HtP7Bt7u43mgHpUG4bHGc+NoY7cWCISkxl4apkYWbvcoJy/5bQn0uRgLuHUNXxK/XuLT5vG76xxY+1xRa5+OIoJ6l78nglNGrj2V+jH3+9yZxI43S9I3NOCl4BvX5Cp3CFMHyt80gk2yM1BJpQZZ4GHewkI/XOIFPU3rR5+toEYXHz7kzykZsqt1PtbaTwG3TX9GJI4C7aWyH9H+9Bt76vH/pLBIn rackhd@rackhd-demo"
                },
                {
                    "name": "rackhd2",
                    "password": "123456",
                    "uid": 1011,
                    "sshKey": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDJQ631/sw3D40h/6JfA+PFVy5Ofz6eu7caxbv0zdw4fTJsrFcOliHZTEtAvqx7Oa8gqSC6d7v61M0croQxtt1DGUcH2G4yhfdZOlK4pr5McwtX0T/APACdAr1HtP7Bt7u43mgHpUG4bHGc+NoY7cWCISkxl4apkYWbvcoJy/5bQn0uRgLuHUNXxK/XuLT5vG76xxY+1xRa5+OIoJ6l78nglNGrj2V+jH3+9yZxI43S9I3NOCl4BvX5Cp3CFMHyt80gk2yM1BJpQZZ4GHewkI/XOIFPU3rR5+toEYXHz7kzykZsqt1PtbaTwG3TX9GJI4C7aWyH9H+9Bt76vH/pLBIn rackhd@rackhd-demo"
                }
            ],
            "rootSshKey": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDJQ631/sw3D40h/6JfA+PFVy5Ofz6eu7caxbv0zdw4fTJsrFcOliHZTEtAvqx7Oa8gqSC6d7v61M0croQxtt1DGUcH2G4yhfdZOlK4pr5McwtX0T/APACdAr1HtP7Bt7u43mgHpUG4bHGc+NoY7cWCISkxl4apkYWbvcoJy/5bQn0uRgLuHUNXxK/XuLT5vG76xxY+1xRa5+OIoJ6l78nglNGrj2V+jH3+9yZxI43S9I3NOCl4BvX5Cp3CFMHyt80gk2yM1BJpQZZ4GHewkI/XOIFPU3rR5+toEYXHz7kzykZsqt1PtbaTwG3TX9GJI4C7aWyH9H+9Bt76vH/pLBIn rackhd@rackhd-demo",
            "dnsServers": ["172.12.88.91", "192.168.20.77"],
            "networkDevices": [
                {
                    "device": "eth0",
                    "ipv4": {
                        "ipAddr": "192.168.1.29",
                        "gateway": "192.168.1.1",
                        "netmask": "255.255.255.0",
                        "vlanIds": [104, 105]
                    },
                    "ipv6": {
                        "ipAddr": "fec0::6ab4:0:5efe:157.60.14.21",
                        "gateway": "fe80::5efe:131.107.25.1",
                        "netmask": "ffff.ffff.ffff.ffff.0.0.0.0",
                        "vlanIds": [101, 106]
                    }
                },
                {
                    "device": "eth1",
                    "ipv4": {
                        "ipAddr": "192.168.11.89",
                        "gateway": "192.168.11.1",
                        "netmask": "255.255.255.0",
                        "vlanIds": [105, 109]
                    },
                    "ipv6": {
                        "ipAddr": "fec0::6ab4:0:5efe:159.45.14.11",
                        "gateway": "fe80::5efe:131.107.25.100",
                        "netmask": "ffff.ffff.ffff.ffff.0.0.0.0",
                        "vlanIds": [106, 108]
                    }
                }
            ],
            "kvm": true,
            "installDisk": "/dev/sda",
            "installPartitions": [
                {
                    "mountPoint": "/boot",
                    "size": "500",
                    "fsType": "ext3"
                },
                {
                    "mountPoint": "swap",
                    "size": "500",
                    "fsType": "swap"
                },
                {
                    "mountPoint": "/",
                    "size": "auto",
                    "fsType": "ext3"
                }
            ]
        }
    }
}

There are few more payload examples at https://github.com/RackHD/RackHD/tree/master/example/samples.

Check the active workflow running on a node

curl <server>/api/current/nodes/<identifier>/workflows?active=true

Deprecated 1.1 API - Check the active workflow running on a node

curl <server>/api/1.1/nodes/<identifier>/workflows/active

Stop the currently active workflow on a node:

curl -X PUT \
-H 'Content-Type: application/json' \
-d '{"command": "cancel"}' \
<server>/api/current/nodes/<id>/workflows/action

Deprecated 1.1 API - Stop the active workflow to cancel OS installation:

curl -X DELETE <server>/api/1.1/nodes/<identifier>/workflows/active

6.13.2.6. Non-Windows OS Installation Workflow Payload¶

All parameters descriptions of OS installation workflow payload are listed below, they are fit for use with all supported OSes except for CoreOS (see note below).

NOTE: The CoreOS installer is pretty basic, and only supports certain parameters shown below. Configurations not directly supported by RackHD may still be made via a custom Ignition template. Typical parameters for CoreOS include: version, repo, and installScriptUri*|*ignitionScriptUri and optionally vaultToken and grubLinuxAppend.

For users in payload:

For networkDevices in payload, both ipv4 and ipv6 are supported

For installPartitions in payload:

• Debian/Ubuntu installation requires boot, root and swap partitions, make sure your auto sized partition must be the last partition.

For ipv4 or ipv6 configurations:

For switchDevices (ESXi only) in payload:

For bonds (RHEL/CentOS only) in payload:

For bondvlaninterfaces in payload, both ipv4 and ipv6 are supported

6.13.2.7. Windows OS Installation Workflow Payload¶

Example of minimum payload https://github.com/RackHD/RackHD/blob/master/example/samples/install_windows_payload_minimal.json

Example of full payload https://github.com/RackHD/RackHD/blob/master/example/samples/install_windows_payload_full.json