mesostest/ibm-mesos repository overview

Installing IBM Platform Computing Connector for Apache Mesos (Docker install) A pre-built Docker image is available that can be used to set up an environment that contains IBM Mesos, IBM EGO and the IBM Platform Computing Connector for Apache Mesos . In order to use the pre-built Docker image, you need to accept the License Agreement. • To accept the License Agreement, you need to add an environment variable –e LICENSE=accept to docker run command. • To view the License Agreement, you need to add two environment variables –e LICENSE=view and –e HOST_LANG=$LANG to docker run command. A simple command to view the License Agreement is docker run --rm -e LICENSE=accept -e HOST_LANG=$LANG mesostest/ibm-mesos, where HOST_LANG is your Docker host language. If the License Agreement was not translated to your language, you will see the English version of License Agreement.

Pre-requisites • At least two hosts, one for master, one for agent. • The two hosts' FQDN should be resolvable from each other. • The two hosts should be accessible from each other.

Installing on a master host Perform the following steps on your master host:

1. Pull docker image $ sudo docker pull mesostest/ibm-mesos

2. Verify that the image is successfully downloaded $ docker images

3. Create a docker container for the Mesos and EGO master

$ sudo docker run -d --privileged --net=host –e LICENSE=accept mesostest/ibm-mesos master --work_dir=/var/lib/mesos --log_dir=/var/log/mesos Note : • The Mesos --master flag is completely compatible with Apache Mesos, you can find all options here: http://mesos.apache.org/documentation/latest/configuration/⁠. • The --modules and --allocator options are built into the docker image and cannot be changed. • It is recommended that you persist Mesos work and log dir on docker host with --volume option in docker run command. If there is error which caused Mesos docker container stopped, you can get Mesos log, find why and start it if necessary.

Installing on an agent host Perform the following steps on your agent host:

1. Pull the docker image $ sudo docker pull mesostest/ibm-mesos

2. Verify that the image is successfully downloaded $ sudo docker images

3. Create a docker container for the Mesos and EGO agents

$ sudo docker run -d --net=host --privileged -e EGO_MASTER_LIST=mesos-master.fqdn –e LICENSE=accept mesostest/ibm-mesos agent --master=mesos-master.fqdn:5050 --log_dir=/var/log/mesos

Where mesos-master.fqdn is the fully qualified domain name for your Mesos master
        Alternatively, you may create both Mesos and Docker containerizers:

$ sudo docker run -d --net=host --privileged -e EGO_MASTER_LIST=mesos-master.fqdn -v /var/run/docker.sock:/var/run/docker.sock –e LICENSE=accept mesostest/ibm-mesos agent --master=mesos-master.fqdn:5050 --log_dir=/var/log/mesos --containerizers=mesos,docker Note:

1. The Mesos agent option is also completely compatible with Mesos community, you can find all options here: http://mesos.apache.org/documentation/latest/configuration/⁠.
2. /var/run/docker.sock is Docker socket file. When use Docker containerizer, you should make sure your Docker version is compatible with the built-in Docker version in this image. You can run docker run --rm –e LICENSE=accept mesostest/ibm-mesos docker --version command to check built-in Docker version.

Verifying install When you create a docker container, Mesos services will automatically start up.

1. Launch the Mesos UI. From a browser, go to http://:5050.

2. Click the EGO tab to navigate to the EGO Platform Management Console. o Default user: Admin o Default password: Admin

Additional information: Mesos frameworks require the libmesos.so mesos library to access Mesos common objects and to reference Mesos APIs. This library is located inside /opt/ibm/mesos/lib/. You can extract this library from the Docker image with following command: $ sudo docker run --rm -v /tmp/data:/data –e LICENSE=accept mesostest/ibm-mesos cp /opt/ibm/mesos/lib/libmesos.so /data $ ls /tmp/data/libmesos.so