Table of Contents
Prerequisites/Workflow
- Set up an ICP4D account with IBM .
- After logging into your cluster with your ICP4D credentials, find Datameer in the Add-ons section.
- Open the menu in the corner of the Datameer tile and click Get Started.
- You are then forwarded in your browser to Datameer.com to the ICP4D download form. Fill out the form and click Submit .
- Within a few minutes you will be emailed a 12 hour installation token and the instructions on how to install the product. (See below)
Install Instructions for ICP4D
Download the Datameer Helm chart:
1) Go to https://github.com/Datameer-Inc/helm
2) Click Download or Clone.
3) Click Download Zip.
4) Unzip the file.Edit your <file path>/etc/hosts file on your system:
<IP to your ICP4D cluster provided by IBM> mycluster.icp
Example:
127.0.0.1 mycluster.icp
Ensure that you have the correct Kubectl, Helm, Cloudctl, and Docker versions that you have downloaded directly from the ICP4D environment.
Find the the versions you need from the link below:
<IP to your ICP4D cluster provided by IBM>:8443/api/cli/
Examples:
- Kubectl v1.11.1
- Helm v2.9.1
- Cloudctl v3.1.0
- Docker v1.8.0
Edit your Docker configuration to allow the push to insecure registries:
If using Linux, edit /etc/docker/daemon.json and add :
{ "insecure-registries" : ["mycluster.icp:8500"]}
Mac/Windows (with use of Docker Desktop)
1) Go to status bar settings.
2) Go to the Registry tab.
3) Add an entry for mycluster.icp:8500
4) Restart the Docker Daemon.NOTE: It isn't recommended to edit config files manually when on Mac/Windows. It is recommended to use Docker Desktop.
From your terminal, issue the following Docker commands:
Before beginning these steps, ensure you have your unique installation token located in the email you received from Datameer.
- Docker Login Command
docker login -u AWS -p <token issued by Datameer> https://602033426343.dkr.ecr.us-west-2.amazonaws.com
- Docker Pull Command
docker pull 602033426343.dkr.ecr.us-west-2.amazonaws.com/devops-ecr/dap-7.2.7-emr-5.11
- Docker Tag Command
docker tag 602033426343.dkr.ecr.us-west-2.amazonaws.com/devops-ecr/<Datameer version> mycluster.icp:8500/zen/datameer/dap-7.2.7-emr-5.11
Ensure you are now authenticated to your IBM ICP4D cluster utilizing the Cloudctl command provided to you by IBM.
- Docker Push Command
docker push mycluster.icp:8500/zen/datameer/dap-7.2.7-emr-5.11
From your terminal in the folder helm/dap-icp4d, issue the following Helm command to deploy ICP4D:
Install Helm Commandhelm install . --name=dap-icp4d
- Log in on your IBM ICP4D cluster and select Datameer to start using the product.
Using Datameer
After you have successfully logged in, check out some tutorials on using Datameer.