Versions Compared

Old Version 6

changes.mady.by.user Charles Bishop

Saved on

compared with

New Version Current

changes.mady.by.user Charles Bishop

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Table of Contents

Prerequisites

...

To deploy Datameer on ICP4D, the following prerequisites must be met:

  1. Having an ICP4D account with IBM and install a working installation of ICP4D on your cluster. You must have access
  2. Having sufficient privileges to that cluster via so that you can run kubectl/helm /docker to deploy Datameer.and 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:

  1. After logging into your cluster with your ICP4D credentials in your web browser, find Datameer in the Add-ons section.
  2. Open the menu in the corner of the Datameer tile and click Get Started.
  3. You are then forwarded in your browser to this page (the one you are reading) on Datameer's website.
  4. Fill out the form to request a download token and click Submit.
  5. You will be emailed a 12 hour installation token and the instructions on how to install the product. (See below)receive an email from icp4d-help@datameer.com with a Docker download command with an access token valid for 12 hours.

Install Instructions for Datameer on ICP4D

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

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

    Panel

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

    Example:

    169.55.96.301 mycluster201 mycluster.icp

    Ensure that you have the correct Kubectl, Helm, Cloudctl, and Docker versions that you have downloaded directly from the ICP4D environment.

    Panel

    Find the the versions you need from the link below:

    <IP to your ICP4D cluster provided by IBM>:8443/api/cli/

    Below If you haven't done so already, get the kubectl/helm/cloudctl binaries corresponding to your platform. Here are the versions used to validate the 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 command line documentation for more information on those.

  3. Edit 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) Go to status bar settingsFind the Docker icon in the system status bar and click on the Preferences menu entry.
      2) Go to the Registry tabDaemon tab and find the Insecure Registries entry list.
      3) Add 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.

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

    1. Panel
      titleDocker Login Command

      docker login -u AWS -p <token issued by Datameer> 602033426343.dkr.ecr.us-east-1.amazonaws.com <paste the docker login command you received in the email from Datameer in your terminal and execute it>

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

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

    4. Panel
      titleDocker Push Command

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

  5. 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
    titleInstall Helm Command

    helm install . --tls --name=datameer

  6. Log in on your IBM ICP4D cluster using your web browser. In the Add-ons section, the corner menu of the Datameer tile Get Started link will have turned into now has the option Open. Click it to this option to open Datameer and start using the product.

...

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

Get Help Using Datameer

At Datameer, support isn't just an afterthought. Any user can leverage our ICP4D community space to correspond with other expert users and Datameer support professionals.

Ensure your success and sign up for the community today!