...
- Having an ICP4D account with IBM and a working installation of ICP4D on your cluster.
- Having sufficient privileges to that cluster so that you can run kubectl/helm and login log in to the ICP4D internal docker registry. How to do this is described in the ICP4D documentation.
Workflow
Deploying Datameer on ICP4D uses the following workflow:
- After logging into your cluster with your ICP4D credentials in your web browser, 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 this page (the one you are reading) on Datameer's website.
- Fill out the form to request a download token and click Submit.
- You will receive an email from icp4d-help@datameer.com with installation instructions and a Docker download command with an access token valid for 12 hours.
...
Download the Datameer Helm chart:
Panel 1) Get the chart archive at https://github.com/Datameer-Inc/helm/archive/master.zip
2) Unzip the file.Edit your /etc/hosts file on your system (Linux/MacOS) or equivalent (Windows) to add a DNS entry for the ICP4D cluster you'll be connecting to (this is needed for the Docker steps below):
Panel <IP to your ICP4D cluster provided by your system administrator> mycluster.icp
Example:
169.55.96.201 mycluster.icp
Ensure that you have the correct Kubectl, Helm, Cloudctl, and Docker versions that you have downloaded directly from the ICP4D environment.
Panel If you have not done that haven't done so already, get the kubectl/helm/cloudctl binaries corresponding to your platform. Here are the versions used to validate these instructions:
- Kubectl v1.11.1
- Helm v2.9.1
- Cloudctl v3.1.0-715+e4d4ee1d28cc2a588dabc0f54067841ad6c36ec9
- Docker v18.06.1-ce
Those binaries can be downloaded from the ICP4D cluster itself at:
<HTTPS address of your ICP4D cluster provided by your system administrator>:8443/api/cli/
Please refer to the ICP4D commandline command line documentation for more information on those binaries.
Below are the versions used to validate these instructions:
- Kubectl v1.11.1
- Helm v2.9.1
Cloudctl v3.
1.0-715+e4d4ee1d28cc2a588dabc0f54067841ad6c36ec9Docker v18.06.1-ceEdit your Docker configuration to allow the push to insecure registries:
Panel If using Linux, edit /etc/docker/daemon.json and add :
Panel { "insecure-registries" : ["mycluster.icp:8500"]}
If using Mac/Windows (with use of Docker Desktop)
Panel 1) Find the Docker icon in the system status bar and click on the Preferences menu entry.
2) Go to the Daemon tab and find the Insecure Registries entry list.
3) Create an entry for mycluster.icp:8500
4) Restart the Docker Daemon.NOTE: It isn't recommended to edit Docker config files manually when on Mac/Windows. It is recommended to use Docker Desktop.
From your terminal, issue the following Docker commands:
Note Before beginning these steps, ensure you have your unique installation token located in the email you received from Datameer.
Panel title Docker Login Command <paste the docker login command you received in the email from Datameer in your terminal and execute it>
Panel title Docker Pull Command docker pull 602033426343.dkr.ecr.us-east-1.amazonaws.com/ibm-icp4d/dap-7.2.7-hdp-2.6.5:2019.02.14-icp4d
Panel title Docker Tag Command docker tag
602033426343.dkr.ecr.us-east-1.amazonaws.com/ibm-icp4d/dap-7.2.7-hdp-2.6.5:2019.02.14-icp4d
mycluster.icp:8500/zen/datameer/dap-7.2.7-hdp-2.6.5:2019.02.14-icp4d
Note Panel title Docker Push Command docker push
mycluster.icp:8500/zen/datameer/
dap-7.2.7-hdp-2.6.5:2019.02.14-icp4d
From your terminal in the folder helm-master/ibm-icp4d/datameer (which you found after unzipping the Helm chart above), issue the following Helm command to deploy ICP4D:
Panel title Install Helm Command helm install . --tls --name=datameer
- Log in on your IBM ICP4D cluster using your web browser. In the Add-ons section, the corner menu of the Datameer tile now has the option Open. Click this option to open Datameer and start using the product.
...