Running the Development Environment Script
Describes how to run the setup script that downloads the Docker image and launches the Docker container.
About this task
mapr_devsandbox_container_setup.sh
, downloads the Docker image
associated with the container and launches the container image that starts the
HPE Ezmeral Data Fabric cluster. It also performs
the configuration steps needed to connect local HPE Ezmeral Data Fabric clients to the HPE Ezmeral Data Fabric cluster running in the
container.Procedure
- Download mapr_devsandbox_container_setup.shmapr_devsandbox_container_setup.sh from GitHub.
-
Optional: Use a
docker pull
command to pre-download a copy of the image:
Pre-downloading is optional, but it makes the script run faster and prevents download issues when you run the script. The script checks to see if the image is already present on your system. If the image is present, the script uses the image. If it is not present, the script tries to download it.docker pull maprtech/dev-sandbox-container:7.0.0_8.1.0_ubuntu18
-
Modify the script so it is executable:
chmod +x mapr_devsandbox_container_setup.sh
-
Run the script. The following command uses the default values for the host
network interface and image. By default, the script runs the latest version of
the container,
maprtech/dev-sandbox-container:latest
, and uses host network interfaceen0
:./mapr_devsandbox_container_setup.sh
To run an earlier version, replace
latest
with the tag corresponding to the version you want to use, and pass that as an argument to the script. The following example runs the 6.2.0 version:./mapr_devsandbox_container_setup.sh -image maprtech/dev-sandbox-container:6.2.0.0_7.0.0_ubuntu18
For a list of available tags, see https://hub.docker.com/r/maprtech/dev-sandbox-container/tags/.
To use a host network interface other thanen0
for the container, run this command:$./mapr_devsandbox_container_setup.sh -nwinterface enp4s0
If you want to use a non-default image and a different interface, run a command like this:
In the preceding command,$./mapr_devsandbox_container_setup.sh -nwinterface enp4s0 -image maprtech/dev-sandbox-container:7.1.0.0_9.0.0_ubuntu18
enp4s0
is an example of a host network interface name that is likely different in your environment.NOTE The script can take 5-10 minutes to run the first time you run it. It requires downloading the Docker image from the Docker repository. -
When the Docker image is running, you see the following output:
Docker Container is coming up.... Client has been configured with the docker container. Please login to the container using (root password mapr): ssh root@localhost -p 2222 Login to the Control System at https://localhost:8443
-
Log in to the Docker container:
ssh root@localhost -p 2222
-
Wait for the
AdminApplication
java process to start by viewing the output fromjps
:root@maprdemo:~# jps 3472 WardenMain 28369 Jps 5105 CLDB 13810 RunJar 28259 FsShell 13235 AdminApplication 3232 QuorumPeerManager 12280 Drillbit 14122 RunJar
-
Generate a user ticket:
# maprlogin password [Password for user 'root' at cluster 'maprdemo.mapr.io': ] MapR credentials of user 'root' for cluster 'maprdemo.mapr.io' are written to '/tmp/maprticket_0'
-
When
AdminApplication
is running, you can access the Control System in your browser by using the following URL:https://localhost:8443
-
After all cluster services are running, you can access the file system
by using POSIX commands, with
/mapr
as your mount point. The following steps show how to determine that all services are running:
What to do next
NOTE Whenever you change your network environment, you must reconfigure your container.
Rerun the
mapr_devsandbox_container_setup.sh
script, and select
option 2 when the script shows the following
prompt:MapR sandbox container is already running.
1. Kill the earlier run and start a fresh instance
2. Reconfigure the client and the running container for any network changes
Please enter choice 1 or 2 :