Running the Zeppelin Docker Image

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

If you are running the MapR Data Science Refinery 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.
  1. Determine what parameters you want to pass to Docker
    Note: You cannot access the container as user 'root'. 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 using one of the following options:

    Specify all your parameters in the command line:

    docker run -it <parameters> \
       maprtech/data-science-refinery:v1.3_6.1.0_6.0.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.3_6.1.0_6.0.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
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.