Running the Zeppelin Docker Image

About this task

To run a Docker image, you use the docker run command. You must specify various parameters, including parameters indicating the MapR Data Platform cluster you want to access from your notebook. You must also specify a user name and password. Only that user can access the running container.

If you are running the MapR Data Science Refinery software as a Kubernetes service, follow the steps at Running MapR Data Science Refinery as a Kubernetes Service.

IMPORTANT If you plan to use the FUSE-based POSIX client, make sure you have a MapR POSIX Client for Containers license on your MapR cluster before performing the steps described in this topic.

Procedure

  1. Determine what parameters you want to pass to Docker
    NOTE You cannot access the container as the root user. Make sure to specify an alternative user name for the MAPR_CONTAINER_USER environment variable.
  2. Pass the parameters you have selected to docker run by using one of the following options:

    Specify all your parameters in the command line:

    docker run -it <parameters> \
       maprtech/data-science-refinery:v1.4.1_6.1.0_6.3.0_centos7

    Specify your environment variable (-e) parameters in a file and the remaining parameters in the command line.

    Pass the file to docker run using --env-file.

    In the following example, the file env.list contains your environment variable parameters:

    docker run -it --env-file ./env.list \
       -p 9995:9995 \
       -p 10000-10010:10000-10010 \
       -p 11000-11010:11000-11010 \
       -v /home/mapruser1/mapr_ticket:/tmp/mapr_ticket:ro \
       --cap-add SYS_ADMIN \
       --cap-add SYS_RESOURCE \
       --device /dev/fuse \
       --security-opt apparmor:unconfined \
       maprtech/data-science-refinery:v1.4.1_6.1.0_6.3.0_centos7

    The following shows an example of the contents of env.list:

    HOST_IP=172.24.9.151
    MAPR_CLUSTER=my.cluster.com
    MAPR_CLDB_HOSTS=172.24.11.84,172.24.8.72,172.24.9.248
    MAPR_CONTAINER_USER=mapuser1
    MAPR_CONTAINER_PASSWORD=SeCreTpAsSw0
    MAPR_CONTAINER_GROUP=mapr
    MAPR_CONTAINER_UID=5000
    MAPR_CONTAINER_GID=5000
    MAPR_TICKETFILE_LOCATION=/tmp/mapr_ticket
    MAPR_MOUNT_PATH=/mapr
    MAPR_HS_HOST=172.24.9.248
    ZEPPELIN_NOTEBOOK_DIR=/mapr/my.cluster.com/user/mapruser1/notebook
    MAPR_TZ=US/Pacific
  3. Verify that Zeppelin is running:
    docker ps

What to do next

If you want to run a second Docker image on a host machine, follow the instructions at Running Multiple Zeppelin Containers on a Single Host.