Anaplan Connect Quick Start Guide - Linux & macOS Installation

AnaplanOEG
AnaplanOEG
edited December 2023 in Best Practices

This Anaplan Connect Quick Start guide is specifically for the macOS and Linux platforms. Its purpose is to help you swiftly set up and get started with Anaplan Connect on these operating systems. Please follow the steps below to guide you through the installation process. If you are utilizing macOS, kindly refer to the Anaplan Connect Quickstart for Windows.

Step #1: Check to see if Java is installed.

  1. In your macOS environment, open a terminal and enter the following:
    java -version
  2. If you receive a similar message, then Java is not installed.
    image.png
  3. Please proceed to Step #2

Step #2: Install Java (via automatic installer)

  1. Open the URL: https://www.azul.com/downloads/?version=java-17-lts&package=jdk#zulu
  2. Please note the following:
    1. The browser will detect your operating system and try to download the latest version of Azul Open JDK (Java Development Kit). At the time this article was published, the latest version is 17.0.7.
    2. The downloaded file will be dependent on your operating system. For example, a "dmg" image will be downloaded if the host operating system is macOS.
  3. Run the downloaded installer file. Note that you may require administrative privileges in order to install the file. If you cannot install it, please follow the instructions in the next section, Step #3: Install Java (via manual deployment).
  4. An Installation Wizard will start to display. Follow the steps and accept the defaults.
  5. Assuming the installation was successful, open a new Terminal and enter the following:
    java -version
    If the installation is successful, the following will appear:
    image.png
  6. Change to your home directory with the command:
    cd ~
  7. Create a new directory called automation
    Note: If preferable, this can be done in another drive or location, but please substitute your location with the locations in these instructions.

Step #3: Install Java (via manual deployment)

  1. Open the URL: https://adoptium.net/temurin/releases/?version=17
  2. Depending on your operating equipment, make the appropriate selections. Note that "Apple Silicon" will require the "aarch64" selection.
    image.png
  3. Download the “.tar.gz” file.
  4. Change to your home directory with the command:
    cd ~
  5. Create a new directory called automation:
    mkdir automation
    Note: If preferable, this can be done in another drive or location, but please substitute your location with the locations in these instructions.
  6. Under the automation directory, create another directory called java
  7. Move the downloaded file to this location:
    mv ~/Downloads/OpenJDK17U-jre_aarch64_mac_hotspot_17.0.7_7.tar.gz ~/automation/java/)
    Note: the name of the file might be different
  8. Unpack the file:
    tar -xzvf OpenJDK17U-jre_aarch64_mac_hotspot_17.0.7_7.tar.gz
  9. Once the extraction is complete, navigate to where the “java.exe” is located.
    cd /Users/qeddy/automation/java/jdk-17.0.7+7-jre/Contents/Home/bin
  10. Enter the following to check if Java launches correctly:
    ./java -version
  11. If the manual deployment was successful, the following will appear:
    image.png

Step #4: Download and Deploy Anaplan Connect

  1. Open the URL:   https://help.anaplan.com/downloads-7a2d4e0a-6bf1-421f-8bac-edf266302088
  2. Scroll to the section “Anaplan Connect (API client)” and download the “Latest” release. Optionally, download the corresponding User Guide.
  3. Move the file “anaplan_connect_4.2.1.zip” (this version may vary) under a new directory named anaplan-connect under the automation directory:
    mv ~/Downloads/anaplan_connect_4.2.1.zip ~/automation/anaplan-connect/
  4. Unzip the downloaded Anaplan Connect file:
    unzip ~/automation/anaplan-connect/anaplan_connect_4.2.1.zip
  5. Change the working directory to where Anaplan Connect was unpacked:
    cd ~/automation/anaplan-connect/
  6. If you had to install Java via the manual deployment, then the following extra step is required:
    1. Edit the file AnaplanClient.sh:
      open -e ./AnaplanClient.sh
    2. Edit the line starting with _java= and add the full path to the java executable. Please be sure to include the java in the path like the following example:
      image.png
    3. Save the edited file and close TextEdit.
  7. Check if Anaplan Connect is successfully deployed. At the Command Prompt, ensure you are in the directory ~/automation/anaplan-connect/ and type in
    ./AnaplanClient.sh
  8. If the following is returned, then Anaplan Connect was successfully deployed:
    image.png

Author: Quin Eddy, @QuinE - Director of Data Integration, Operational Excellence Group (OEG)

Tagged:

Categories