Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

Table of Contents

Prerequisites/workflow

  1. Set up an ICP4D account with IBM and install ICP4D on your cluster. You must have access to that cluster via kubectl/helm/docker to deploy Datameer.
  2. After logging into your cluster with your ICP4D credentials in your web browser, find Datameer in the Add-ons section.
  3. Open the menu in the corner of the Datameer tile and click Get Started.
  4. You are then forwarded in your browser to Datameer's website.
  5. Fill out the form to request a download token and click Submit .
  6. You will be emailed a 12 hour installation token and the instructions on how to install the product. (See below)

Install Instructions for Datameer on ICP4D

  1. Download the Datameer Helm chart:

    1) Get the chart archive at https://github.com/Datameer-Inc/helm/archive/master.zip
    2) Unzip the file.

  2. 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):

    <IP to your ICP4D cluster provided by IBM> mycluster.icp

    Example:

    169.55.96.301 mycluster.icp

  3. 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/

    Below are the versions used to validate the instructions:

    • Kubectl v1.11.1
    • Helm v2.9.1
    • Cloudctl v3.1.0-715+e4d4ee1d28cc2a588dabc0f54067841ad6c36ec9
    • Docker v18.06.1-ce

  4. 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.

  5. 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.

    1. Docker Login Command

      docker login -u AWS -p <token issued by Datameer> 602033426343.dkr.ecr.us-east-1.amazonaws.com

    2. 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

    3. 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

       Ensure you are now authenticated to your IBM ICP4D cluster utilizing the cloudctl command provided to you by IBM or your cluster administrator.

    4. Docker Push Command

      docker push mycluster.icp:8500/zen/datameer/dap-7.2.7-hdp-2.6.5:2019.02.14-icp4d

  6. 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:

    Install Helm Command

    helm install . --name=datameer

  7. Log in on your IBM ICP4D cluster. In the Add-ons section, the corner of the Datameer tile Get Started link will have turned into Open. Click it to open Datameer and start using the product.

Using Datameer

After you have successfully logged in, check out some tutorials on using Datameer.


  • No labels