Installing RUCKUS IoT Insights on Amazon Web Service

Installing RUCKUS IoT Insights under Amazon Web Service (AWS) requires the set-up of two parts. First, you must set up an AWS account. Next, the AWS command line interface must be configured. Finally, you install RUCKUS IoT Insights.

Setting Up an AWS Account

Complete the following steps to set up an AWS account.
  1. Login into the AWS console using the url https://aws.amazon.com/console/
  2. Select Services > Security > Identity and Compliance > IAM.
  3. Click Users in the left pane.
    1. Under the User name column, select a user from the group of users.
    2. Click the Security Credentials tab.
    3. In the Access Key section, click Create Access Key.
    4. Click Download .CSV file.
  4. Select Roles in the left pane and create a new role called vmimport.
  5. Select the vmimport role and attach the following policies:
  6. Edit the vmimport policy JSON file {} as per the following code.
  7. Download the access keys (excel file).
  8. Select Roles in the left pane, and create a new role called “vmimport”
    {
    "Version": "2012-10-17",
    "Statement": [
    {
    "Effect": "Allow",
    "Action": [
    "s3:ListBucket",
    "s3:GetBucketLocation"
    ],
    "Resource": [
    "arn:aws:s3:::$iotctl"
    ]
    },
    {
    "Effect": "Allow",
    "Action": [
    "s3:GetObject"
    ],
    "Resource": [
    "arn:aws:s3:::$iotctl/*"
    ]
    },
    {
    "Effect": "Allow",
    "Action": [
    "ec2:ModifySnapshotAttribute",
    "ec2:CopySnapshot",
    "ec2:RegisterImage",
    "ec2:Describe*"
    ],
    "Resource": "*"
    }
    ]
    }
  9. Select System > S3.
  10. Create an S3 bucket iotcl.
  11. Download the IoT Insights OVA file from the RUCKUS Support site https://support.ruckuswireless.com.
  12. Upload the Insights2 .ova file to the iotctl s3 bucket.

Configuring the AWS Command Line Interface

Before completing the command line interface (CLI) steps, ensure you have the login details for the AWS account and access keys.
  1. Open the command prompt, and enter the following commands:
    • sudo apt-get update
    • sudo apt-get install awscli
    • aws --version
  2. Configure the AWS CLI access keys shown in the following figure.
    Note: Ensure the region name that is entered is the same as in the AWS account setup.
  3. Create a JSON file called "import.json". The file must contain the attributes shown in the following figure.
    Note: Replace the "S3Key" with the correct file name of the Insights2.OVA file.
  4. Enter the command aws ec2 import-image --cli-input-json file://import.json command to attach the policy to the role previously created.
  5. Enter the command aws ec2 describe-import-image-tasks –import-task-ids “import-ami-of662ebae1a3c5ed4" command to monitor the status of the imported Insights2 OVA image.
  6. When the status shows “completed”, the Insights2 instance is installed in your AWS account. Refer to Services > EC2 > Instances.
  7. After configuring the AWS, refer to the topic Installing RUCKUS IoT Insights to complete the installation process.