Source code for SlipStream ~Okeanos connector.
The connector is in version 0.5.0-SNAPSHOT, based on SlipStrtream version 2.3.4-SNAPSHOT. We use Java 1.7.
| Capability | Status |
|---|---|
| Run Image | ✓ |
| Run Deployment | ✓ |
| Build Image | #4 |
| Volatile disk | ✓ |
| VM resize (CPU/RAM) | ✓ |
| VM extra disk attach/detach | ✓ |
In the Slipstream Server installation script, you must set
RELEASE=false
so that the snapshot repositories are picked up. The current version of the connector is 0.5.0-SNAPSHOT, as given in
the pom.xml. After the SlipStream Server installation, just run
$ yum install slipstream-connector-okeanos
$ yum install slipstream-connector-okeanos-python
and then restart the SlipStream Server via
$ service slipstream restart
for the java code (the Java part of the connector) to take effect.
In order for the ~Okeanos connector to be fully functional, you need to install the ~Okeanos python support library, named kamaki, in the machine that hosts the SlipStream Server.
$ pip install kamaki==0.13.3
As of 2014-09-18, a VM image that is to be used as an Orchestrator must have preinstalled software in it. We call these images CELAR-certified. The rationale is to move ad-hoc and distribution-sensitive code out of the connector, in order to minimize complexity. For the time being, we provide a recipe for an Ubuntu-based such image here.
An Ubuntu public image with the above characteristics is already published in ~Okeanos production:
$ kamaki image info fe31fced-a3cf-49c6-b43b-f58f5235ba45
name: CELAR-Ubuntu-14.04-LTS
checksum: e3069718eaf4990fbc2805ce3d42dffa4bee5aed7f5ee664486a7f1dc455e217
updated-at: 2014-09-18 12:10:58
created-at: 2014-09-18 12:10:58
id: fe31fced-a3cf-49c6-b43b-f58f5235ba45
deleted-at:
location: pithos://fc95f201-d5a9-46fa-8ede-b8983b420a40/images/CELAR-Ubuntu-14.04-LTS
is-public: True
owner: fc95f201-d5a9-46fa-8ede-b8983b420a40 ([email protected])
disk-format: diskdump
size: 2.15GiB
properties:
PARTITION_TABLE: msdos
OSFAMILY: linux
DESCRIPTION: Ubuntu 14.04.1 LTS
OS: ubuntu
ROOT_PARTITION: 1
USERS: user
container-format: bare
The upcoming version 0.16 of Synnefo, the IaaS software that ~Okeanos is based on and which is needed to support the Add Extra Volatile Disk feature, introduces a breaking change in the kamaki software. This is reported and explained in the respective ticket The new SSL authentication handling breaks software using kamaki, opened 2014-10-15.
The breaking change is always present if kamaki is installed via pip and you will see the following or similar behavior in the command line:
$ kamaki image list
Unknown Error: [Errno 185090050] _ssl.c:330: error:0B084002:x509 certificate routines:X509_load_cert_crl_file:system lib
Please refer to the above ticket and its comments for an explanation and further pointers to documentation.
By installing kamaki via pip the procedure in only manual and you need to set a path for the certificates. The command
$ kamaki config get ca_certs
will normally output
ca_certs not found
since no path has been automatically set by the installation procedure of kamaki.
In order to overcome this in my Mac dev box + Homebrew, I install openssl:
$ brew install openssl
which places the certificates in /usr/local/etc/openssl/cert.pem and then:
$ kamaki config set ca_certs /usr/local/etc/openssl/cert.pem
A similar procedure applies to other environments. After that we are back to normal:
$ kamaki config get ca_certs
/usr/local/etc/openssl/cert.pem
$ kamaki image list
fe31fced-a3cf-49c6-b43b-f58f5235ba45 CELAR-Ubuntu-14.04-LTS
status: available
container_format: bare
disk_format: diskdump
size: 2.15GiB
...
Please see celar-ubuntu-14.04-LTS for the correct procedure regarding our CELAR-certified Ubuntu VM image.
This software is under Apache v2