Ubuntu 14
Front-end node
Prerrequisites
OpenNebula
You have to install OpenNebula (i.e. installing the opennebula-node package, the shared directories, the network bridge, etc.). That means that the OpenNebula node should be installed as if it was going to run KVM Virtual Machines. You can follow the instructions in the official OpenNebula documentation.
Docker
Then you have to install Docker, according to the official Docker documentation.
Warning
We recommend using docker version 1.9. If you use docker engine versions greater than 1.9, we can not ensure that OneDock works correctly. If you have doubts about installing an scpecific version of docker, please check the installation scripts in this repository: install/ubuntu/install-docker
You need to install a Docker Registry v2.0 that is usable from all the nodes. Its name must be included in the variable LOCAL_SERVER
in the file /var/lib/one/remotes/onedock.conf
.
REMEMBER to install the certificates of your Docker registry in the proper directories. The most easy way to install the certificate is to copy it into the folder /etc/docker/certs.d/$HOSTNAME:5000/
. But you should copy it for the whole system in case that you want to use other commands (e.g. curl).
For the case of ubuntu, you can use a code like this:
$ mkdir -p /etc/docker/certs.d/onedockdemo:5000/
$ cp domain.crt /usr/local/share/ca-certificates/
$ cp domain.crt /etc/docker/certs.d/onedockdemo:5000/
$ update-ca-certificates
Required packages
Now install the required packages: jq, xmlstarlet, qemu-utils and bridge-utils.
$ apt-get -y install jq xmlstarlet qemu-utils bridge-utils.
Installation of ONEDock and activating it in ONE
From package
You have to enable the INDIGO - DataCloud packages repositories. See full instructions here. Briefly you have to download the list file from INDIGO SW Repository in your /etc/apt/sources.list.d folder.
$ cd /etc/apt/sources.list.d
$ wget http://repo.indigo-datacloud.eu/repos/1/indigo1-ubuntu14_04.list
And then install the GPG key for INDIGO the repository:
$ wget -q -O - http://repo.indigo-datacloud.eu/repository/RPM-GPG-KEY-indigodc | sudo apt-key add -
Install the Onedock package.
$ apt update
$ apt install onedock-master
Finally restart opennebula so the changes applied by the onedock installation are applied:
$ sudo service opennebula restart
Manually
Once OpenNebula, Docker, a Docker Registry and the required packages have been installed, you can install ONEDock as follows (as root user):
$ cd /tmp/
$ git clone https://github.com/indigo-dc/onedock
$ cd onedock
$ ./setup_files.sh
ONEDock will be installed. Then you should adjust the variables in /var/lib/one/remotes/onedock.conf
according to your deployment. In particular:
LOCAL_SERVER points to the local docker registry
DATASTORE_DATA_PATH points to the folder in which the images in the docker registry are stored
In order to activate ONEDock in ONE, you just need to update the /etc/one/oned.conf file.
$ cat >> /etc/one/oned.conf << EOF
IM_MAD = [
name = "onedock",
executable = "one_im_ssh",
arguments = "-r 3 -t 15 onedock" ]
VM_MAD = [
name = "onedock",
executable = "one_vmm_exec",
arguments = "-t 15 -r 0 onedock",
type = "xml" ]
TM_MAD_CONF = [
name = "onedock", ln_target = "SYSTEM", clone_target = "SYSTEM", shared = "yes"
]
EOF
Then you must add onedock to be available as transfer manager and datastore. Please locate the proper lines in /etc/one/oned.conf file and append the onedock
keyword. In the default installation, the result will be similar to the next one:
TM_MAD = [
executable = "one_tm",
arguments = "-t 15 -d dummy,lvm,shared,fs_lvm,qcow2,ssh,vmfs,ceph,dev,onedock"
]
DATASTORE_MAD = [
executable = "one_datastore",
arguments = "-t 15 -d dummy,fs,vmfs,lvm,ceph,dev,onedock"
]
Computing nodes
Prerrequisites
OpenNebula
You have to install OpenNebula (i.e. installing the opennebula-node package, the shared directories, the network bridge, etc.). That means that the OpenNebula node should be installed as if it was going to run KVM Virtual Machines. You can follow the instructions in the official OpenNebula documentation (e.g. for Ubuntu).
Docker
Then you have to install Docker, according to the official documentation (e.g. for Ubuntu).
Warning
We recommend using docker version 1.9. If you use docker engine versions greater than 1.9, we can not ensure that OneDock works correctly. If you have doubts about installing an scpecific version of docker, please check the installation scripts in this repository: install/ubuntu/install-docker
REMEMBER to install the certificates of your Docker registry in the proper directories. The most easy way to install the certificate is to copy it into the folder /etc/docker/certs.d/$HOSTNAME:5000/
. But you should copy it for the whole system in case that you want to use other commands (e.g. curl).
For the case of ubuntu, you can use a code like this:
$ mkdir -p /etc/docker/certs.d/onedockdemo:5000/
$ cp domain.crt /usr/local/share/ca-certificates/
$ cp domain.crt /etc/docker/certs.d/onedockdemo:5000/
$ update-ca-certificates
Required packages
Now install the required packages: jq, xmlstarlet, qemu-utils and bridge-utils.
$ apt-get -y install jq xmlstarlet qemu-utils bridge-utils.
Installation of ONEDock and activating it in ONE
From package
You have to enable the INDIGO - DataCloud packages repositories. See full instructions here. Briefly you have to download the list file from INDIGO SW Repository in your /etc/apt/sources.list.d folder.
$ cd /etc/apt/sources.list.d
$ wget http://repo.indigo-datacloud.eu/repos/1/indigo1-ubuntu14_04.list
And then install the GPG key for INDIGO the repository:
$ wget -q -O - http://repo.indigo-datacloud.eu/repository/RPM-GPG-KEY-indigodc | sudo apt-key add -
Install the Onedock package.
$ apt update
$ apt install onedock-node
Finally restart opennebula so the changes applied by the onedock installation are applied:
$ sudo service opennebula restart
Manually
If you prefer you can try yo install onedock manually using following code. This step is very dependent from your installation and you should check out what are you doing:
# The oneadmin user should be able to run docker
$ usermod -aG docker oneadmin
# Starting the nbd module and setting it persistent
$ modprobe nbd max_part=16
$ echo "nbd" >> /etc/modules
$ cat > /etc/modprobe.d/nbd.conf <<\EOT
options nbd max_part=16
EOT
# Creating a bridge for the ONE network
$ cat > /etc/network/interfaces <<\EOT
auto lo
iface lo inet loopback
auto br0
iface br0 inet dhcp
bridge_ports eth0
bridge_stp off
bridge_maxwait 0
bridge_fd 0
EOT
Preparing ONE for ONEDock
You need to update the file /etc/sudoers.d/opennebula
to add the file that will configure the network. You need to add the line
Cmnd_Alias ONEDOCK = /var/tmp/one/docker-manage-network, /usr/bin/qemu-nbd
And to activate this alias appending the alias in the following line
oneadmin ALL=(ALL) NOPASSWD: ONE_MISC, ONE_NET, ONE_LVM, ONE_ISCSI, ONE_OVS, ONE_XEN, ONEDOCK
Also you need to add the oneadmin
user to the docker
group, in order to be able to run docker containers.
$ usermod -aG docker oneadmin
Last updated