AWS Setup for Smart Labels

This feature is powered by Rekognition, Amazon's machine-learning image analysis tool. If you are hosting NetX on-premise, there are a few extra steps to complete before your site is ready to use Smart Labels.

Before you begin

Smart Labels requires an AWS account that has been granted access to the Rekognition service. For instructions on how to create an account and configure it for Rekognition, see https://docs.aws.amazon.com/rekognition/latest/dg/getting-started.html. Once your credentials have been created, will need to save the following information for use in configuring your site for Smart Labels:

• aws_access_key_id
• aws_secret_access_key
• region

Configuring NetX to use AWS credentials

Once you have generated your access key ID, secret access key, and specified a region, you will need to enter these credentials into your Tomcat environment variables so that NetX can connect to the Rekognition service.

Access key ID and Secret Access Key information is highly sensitive. We recommend that you secure the configuration files listed below from unauthorized access.

Windows

1. Open the Tomcat Service Manager application, typically located here: C:\Program Files\NetXposure\bin\netxw.exe

2. Under the Java tab, in the Java Options field, add the following lines (substitute your actual credentials after the = signs):

   -DAWS_ACCESS_KEY_ID=your_access_key
   -DAWS_SECRET_ACCESS_KEY=your_secret_access_key
   -DAWS_DEFAULT_REGION=your_region

   Your entry should appear as shown below (with the credential/region values entered instead of blank):
   
3. When finished, click OK or Apply to save your settings and restart NetX.

Linux

1. Open the setenv.sh file, typically located here: opt/netx/bin/setenv.sh

2. Add the following lines to the bottom of the file (substitute your actual credentials inside the quote marks):

   export AWS_ACCESS_KEY_ID="your_access_key"
   export AWS_SECRET_ACCESS_KEY="your_secret_access_key"
   export AWS_DEFAULT_REGION="your_region"

3. When finished, save the file and restart NetX.

Enabling smart labels

Once your environment variables have been created and NetX has been restarted, see Smart Labels for instructions on how to enable the feature on your site.