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:
Required packages
Now install the required packages: jq, xmlstarlet, qemu-utils and 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.
And then install the GPG key for INDIGO the repository:
Install the Onedock package.
Finally restart opennebula so the changes applied by the onedock installation are applied:
Manually
Once OpenNebula, Docker, a Docker Registry and the required packages have been installed, you can install ONEDock as follows (as root user):
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.
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:
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:
Required packages
Now install the required packages: jq, xmlstarlet, qemu-utils and 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.
And then install the GPG key for INDIGO the repository:
Install the Onedock package.
Finally restart opennebula so the changes applied by the onedock installation are applied:
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:
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
And to activate this alias appending the alias in the following line
Also you need to add the oneadmin
user to the docker
group, in order to be able to run docker containers.
Last updated