Installing Altus Director Server and Client on the EC2 Instance

To install Altus Director, perform the following tasks. You must be either running as root or using sudo to perform these tasks.

RHEL 7 and CentOS 7

  1. SSH as ec2-user (RHEL) or centos (CentOS) into the EC2 instance you created for Altus Director. If you have VPN or AWS Direct Connect, SSH to your private IP address. Otherwise, use your public IP address.
    ssh -i your_file.pem ec2-user@private_IP_address
  2. Install a supported version of the Oracle JDK or OpenJDK on the Altus Director host.

    Altus Director 6.x requires JDK version 8.

    • Oracle JDK

      For download and installation information, see Java SE Downloads on the Oracle web site.

      After you download the RPM file to the EC2 instance, install the JDK:
      sudo yum localinstall jdk-version-linux-x64.rpm
    • OpenJDK
      Use the following command to download and install OpenJDK:
      sudo yum install java-1.8.0-openjdk

      For more information, see How to download and install prebuilt OpenJDK packages.

  3. Some RHEL 7 AMIs do not include wget by default. If your RHEL AMI does not include wget, install it now:
    sudo yum install wget
  4. Add the Altus Director repository to the package manager:
    cd /etc/yum.repos.d/
    sudo wget "http://username:password@archive.cloudera.com/p/director6/6.3/redhat7/cloudera-director.repo"
  5. Install Altus Director server and client by running the following command:
    sudo yum install cloudera-director-server cloudera-director-client
  6. Start the Altus Director server by running the following command:
    sudo service cloudera-director-server start
  7. If the RHEL 7 or CentOS firewall is running on the EC2 instance where you have installed Altus Director, disable and stop the firewall with the following commands:
    sudo systemctl disable firewalld
    sudo systemctl stop firewalld

You are now ready to configure a SOCKS proxy.

RHEL 6 and CentOS 6

  1. SSH as ec2-user into the EC2 instance you created for Altus Director. If you have VPN or AWS Direct Connect, SSH to your private IP address. Otherwise, use your public IP address.
    ssh -i your_file.pem ec2-user@private_IP_address
  2. Install a supported version of the Oracle JDK or OpenJDK on the Altus Director host.

    Altus Director 6.x requires JDK version 8.

    • Oracle JDK

      For download and installation information, see Java SE Downloads on the Oracle web site.

      After you download the RPM file to the EC2 instance, install the JDK:
      sudo yum localinstall jdk-version-linux-x64.rpm
    • OpenJDK
      Use the following command to download and install OpenJDK:
      sudo yum install java-1.8.0-openjdk

      For more information, see How to download and install prebuilt OpenJDK packages.

  3. Add the Altus Director repository to the package manager:
    cd /etc/yum.repos.d/
    sudo wget "http://username:password@archive.cloudera.com/p/director6/6.3/redhat6/cloudera-director.repo"
  4. Install Altus Director server and client by running the following command:
    sudo yum install cloudera-director-server cloudera-director-client
  5. Start the Altus Director server by running the following command:
    sudo service cloudera-director-server start
  6. Save the existing iptables rule set and disable the firewall:
    sudo service iptables save
    sudo chkconfig iptables off
    sudo service iptables stop

You are now ready to configure a SOCKS proxy.

Ubuntu

  1. SSH as ubuntu into the EC2 instance you created for Altus Director. If you have VPN or AWS Direct Connect, SSH to your private IP address. Otherwise use your public IP address.
    ssh -i your_file.pem ubuntu@private_IP_address
  2. Add the Altus Director repository to the package manager and add the signing key.
    If you are on version 14.04, run the following commands:
    cd /etc/apt/sources.list.d/
    sudo curl -L "http://username:password@archive.cloudera.com/p/director6/6.3/ubuntu1404/cloudera-director.list" -O
    sudo curl -s -L "https://username:password@archive.cloudera.com/p/director6/6.3/ubuntu1404/archive.key" | sudo apt-key add -
    If you are on version 16.04, run the following commands:
    cd /etc/apt/sources.list.d/
    sudo curl -L "http://username:password@archive.cloudera.com/p/director6/6.3/ubuntu1604/cloudera-director.list" -O
    sudo curl -s -L "https://username:password@archive.cloudera.com/p/director6/6.3/ubuntu1604/archive.key" | sudo apt-key add -
  3. If you are on version 18.04, run the following commands:
    cd /etc/apt/sources.list.d/
    sudo curl -L "http://username:password@archive.cloudera.com/p/director6/6.3/ubuntu1804/cloudera-director.list" -O
    sudo curl -s -L "https://username:password@archive.cloudera.com/p/director6/6.3/ubuntu1804/archive.key" | sudo apt-key add -
  4. Install a supported version of the Oracle JDK or OpenJDK on the Altus Director host.

    Altus Director 6.x requires JDK version 8.

    • Oracle JDK

      For download and installation information, see Java SE Downloads on the Oracle web site.

      After downloading the installation file to the EC2 instance, install the JDK. The following example installs JDK version 7:
      sudo apt-get update
      sudo apt-get install oracle-j2sdk1.8
      
    • OpenJDK
      Use the following command to download and install OpenJDK:
      sudo apt-get install openjdk-8-jre

      For more information, see How to download and install prebuilt OpenJDK packages.

  5. Install Altus Director server by running the following command:
    sudo apt-get update
    sudo apt-get install cloudera-director-server cloudera-director-client
  6. Start the Altus Director server by running the following command:
    sudo service cloudera-director-server start
  7. Save the existing firewall rules and disable the firewall:
    sudo iptables-save > ~/firewall.rules
    sudo service ufw stop

You are now ready to configure a SOCKS proxy.

Installing Only Altus Director Server or Altus Director Client

The installation instructions above will install both the server and client. Cloudera recommends installing both because together they provide the full functionality of Altus Director. Optionally, you can install just the client, and configure it to interact with an Altus Director server running on another machine, rather than the default localhost. Similarly, you can install just the server, but then you will be unable to launch a cluster at the command line with a customized configuration file.

To install only the Altus Director client, run one of the following installation commands in place of the command given above:
  • For RHEL and CentoOS, run the command sudo yum install cloudera-director-client instead of sudo yum install cloudera-director-server cloudera-director-client.
  • For Ubuntu, run the command sudo apt-get install cloudera-director-client instead of sudo apt-get install cloudera-director-server cloudera-director-client.
To install only the Altus Director server, run one of the following installation commands in place of the command given above:
  • For RHEL and CentoOS, run the command sudo yum install cloudera-director-server instead of sudo yum install cloudera-director-server cloudera-director-client.
  • For Ubuntu, run the command sudo apt-get install cloudera-director-server instead of sudo apt-get install cloudera-director-server cloudera-director-client.