CentOS Installation¶

Setup Mirror¶

A mirror should be setup firstly before installation.

Local ISO mirror: Download CentOS ISO image, mount ISO image in a local server as the repository, http service for this repository is provided so that a node could access without proxy.
Local sync mirror: Sync public site’s mirror repository to local, http service for this repository is provided so that a node could access without proxy.
Public mirror: The node could access a public or remote site’s mirror repository with proxy.

mkdir ~/iso && cd !/iso

# Download iso file
# You can choose a mirror in this site:
# http://isoredirect.centos.org/centos/7/isos/x86_64/CentOS-7-x86_64-DVD-1708.iso
# There are three type of ISOs (DVD ISO, Everything ISO, Minimal ISO), Minimal ISO is not supported

wget http://mirror.math.princeton.edu/pub/centos/7/isos/x86_64/CentOS-7-x86_64-DVD-1708.iso

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

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

# Mount iso
sudo mount CentOS-7-x86_64-DVD-1708.iso /var/mirrors/centos

# Replace {on-http-dir} with your own
sudo ln -s /var/mirrors/centos {on-http-dir}/static/http/mirrors/

For CentOS local mirror, the mirrors are easily made by syncing public CentOS mirror site, on any recent distribution of CentOS:

# Replace x with your own version

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

Add following block into httpProxies in /opt/monorail/config.json, and restart on-http service.

{
  "localPath": "/centos",
  "server": "http://mirror.centos.org/",
  "remotePath": "/centos/"
},

Call API to Install OS¶

Get payload example:

wget https://raw.githubusercontent.com/RackHD/RackHD/master/example/samples/install_centos_7_payload_minimal.json

Remember to replace version and repo with your own, see fileServerAddress and fileServerPort in /opt/monorail/config.json

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_centos_payload_minimal.json \
    127.0.0.1:9090/api/current/nodes/{node-id}/workflows?name=Graph.InstallCentos | jq '.'

Note

For more detail about payload file please refer to Non-Windows OS Installation Workflow Payload