Install HDXCTL CLI

Now we need to install the Hydrolix CLI tool called hdxctl.

This tool is used to create and manage your Hydrolix data platform.

We would recommend installing it on an EC2 instance within the cloud account you are going to use for your Hydrolix environment, you can also install it to your local machine as well if you wish.

The recommended instance is a:

  • t2.micro
  • Standard disk (8GB)

With :

  • Ubuntu Server 18.04 LTS or later,
  • Python 3.6+
  • AWS CLI installed with administrator credentials or the policy applied in the previous step Prepare your AWS Account for the account.

To get the latest version you can run the following commands on your instance/local machine.

👍

Get the latest version.

$ wget -O hdxctl https://hdx-infrastructure.s3.amazonaws.com/hdxctl-v2.23.11 && chmod +x hdxctl

Move hdxctl into your executable path

👍

$ sudo mv hdxctl ~/.local/bin/

OR

$ sudo mv hdxctl /usr/local/bin/

Verify the installation using:

👍

$ hdxctl version

$ hdxctl version
2.23.11

📘

AWS Profiles and HDXCTL

The HDXCTL tool will look for your default credentials for AWS. If however you run multiple profiles you can use AWS_PROFILE or AWS Environment variables to specify the credentials you use.

For example you can use

$ export AWS_PROFILE = MyProdProfile

Hydrolix makes updates to the service and software regularly and it is advisable to check for the newest release. Release notes and previous versions can be found on the current release notes page

Congratulations that's the boring bit done! The next step is to deploy the platform! Huzzah!


Did this page help you?