Page Comparison

...

• Amazon Account

• HiveMQ License (optional)

• Install Amazon CLI

  • The AWS Command Line Interface is an open-source tool that enables you to interact with AWS services using commands in your command-line shell.
    To install the AWS CLI on macOS with Homebrew, open a terminal and enter the following. For other operating systems, see AWS CLI installation.

    Code Block
    brew install awscli

  • Verify AWS CLI Installation: Open a new terminal or command prompt and run the following command. This should display the installed AWS CLI version.(For us , its aws-cli/2.15.17 Python/3.11.7 Darwin/23.3.0 source/arm64 prompt/off)

    Code Block
    aws --version

• Configure AWS CLI: After installing the AWS CLI, do the following steps to configure it. (For more information, see Configure the AWS CLI in the AWS Command Line Interface User Guide.)

  • If you do not have existing access keys, please use the steps here to create new access key and note it or download the csv file.

  • Run the following command

    Code Block
    aws configure

    • Optionally, you can configure a named profile, such as --profile cluster-admin. If you configure a named profile in the AWS CLI, you must always pass this flag in subsequent commands. E.g. aws configure --profile cluster-admin

  • This command will prompt you to enter the following information:

    • AWS Access Key ID: Enter your AWS access key.

    • AWS Secret Access Key: Enter your AWS secret key.

    • Default region name: Enter the AWS region you want to use (e.g., us-eastwest-1).

    • Default output format: You can leave this as json.
      For example:

      Code Block
      AWS Access Key ID [None]: AKIAI#####LE AWS Secret Access Key [None]: wJal####KEY Default region name [None]: us-eastwest-1 Default output format [None]: json

• EKS CLI (eksctl)
  eksctl is a command line tool for working with EKS clusters that automates many individual tasks. To install the AWS CLI on macOS with Homebrew, open a terminal and enter the following. For other operating systems, see the installation in eksctl documentation.

  Code Block
  brew tap weaveworks/tap && brew install weaveworks/tap/eksctl

• Kubectl, Helm and MQTT CLI https://hivemq.atlassian.net/wiki/spaces/HMS/pages/2700902571

...

1. Create a New IAM User

   1. Run the following command to create a new IAM user:

      Code Block
      aws iam create-user --user-name hivemq-user

   2. Attach AdministratorAccess Policy

      Run the following command to attach the AdministratorAccess policy to the newly created user:

      Code Block
      aws iam attach-user-policy --user-name hivemq-user --policy-arn arn:aws:iam::aws:policy/AdministratorAccess

   3. Create Access Key

      Run the following command to create an access key for the user:

      Code Block
      aws iam create-access-key --user-name hivemq-user

   4. Following is the output displayed after the successful creation of the access key, Please copy and save AccessKeyId and SecretAccessKey values for the next steps.

      Code Block
      {     "AccessKey": {         "UserName": "test-user",         "AccessKeyId": "AKIXXXXXXF2PH",         "Status": "Active",         "SecretAccessKey": "cRIs2aXXXXXXAEi",         "CreateDate": "2024-02-01T11:10:59+00:00"     } }

   5. Run the following command:

      Code Block
      aws configure

      1. Optionally, you can configure a named profile, such as --profile cluster-admin. If you configure a named profile in the AWS CLI, you must always pass this flag in subsequent commands.

   6. This command will prompt you to enter the following information:

      1. AWS Access Key ID: Enter your AWS access key.

      2. AWS Secret Access Key: Enter your AWS secret key.

      3. Default region name: Enter the AWS region you want to use (e.g., us-eastwest-1).

      4. Default output format: You can leave this as json.
         For example:

         Code Block
         AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY Default region name [None]: us-eastwest-1 Default output format [None]: json

...

1. To create an EKS cluster with all the necessary resources for your cluster, enter the following command with the desired location (in this procedure, we use eu-eastwest-1) and instance type c5.2xlarge (8 CPUs, 16 GiB RAM), enter the following command and wait until the process completes. Processing time take up to ~5 minutes and can vary:

eksctl create cluster \
  --name HiveMQCluster \
  --region eu-eastwest-1 \
  --node-type c5.2xlarge \
  --version 1.27 \
  --nodes 4

...