Back to top

Any data within brackets indicate values you need to determine. 

# From pr-holonet/iridium-to-twilio

region= '[ Your AWS account region here ]'
stack_name='[ Your stack name here ]'
bucket_name='[ Your AWS bucket name here ]'
rockblock_username='[Your RockBLOCK username]'
rockblock_password='[Your RockBLOCK password]'
twilio_account='[Your Twilio account ID]'
twilio_auth_token='[Your Twilio auth token]'
twilio_phone_no='+15556667777' [phone number registered with Twilio]

# Delete the existing stack if necessary.  Usually you don't need to do this.
# aws cloudformation delete-stack --stack-name "$stack_name"

# Package the template and the code.  This copies the code to an S3 bucket.
aws cloudformation package \
    --template-file holonet-handler.yaml \
    --output-template-file holonet-handler.packaged.yaml \
    --s3-bucket "$bucket_name"

# Deploy the package.
aws cloudformation deploy \
    --capabilities CAPABILITY_NAMED_IAM \
    --template-file holonet-handler.packaged.yaml \
    --stack-name "$stack_name" \
    --parameter-overrides RockBlockUsername="$rockblock_username" \
                          RockBlockPassword="$rockblock_password" \
                          TwilioAuthToken="$twilio_auth_token" \
                          TwilioAccountSid="$twilio_account" \
                          TwilioPhoneNumber="$twilio_phone_no"

Next, you'll want to get the REST API ID for your AWS Lambda function. We will use this to create the URL that you will give Rock7 Core and Twilio to send any data they receive. 

1. Get the REST API ID

   # Get REST API URL.
   aws apigateway get-rest-apis 

• You will get a JSON formated output. Look for the item whose name matches your stack name. Within that item, note the id parameter and write the value down. 
• Assign that value to the variable "rest_api_id"

2. Now put all the info together and print the URL to your function

   handler_url="https://$rest_api_id.execute-api.$region.amazonaws.com/Prod/holonet-handler"
   echo "Endpoint is $handler_url"

3. Done! 

Your Lambda function should now be active and running.

Note the URL of the ENDPOINT. You'll need it for the Rock7 Core service and for Twilio.

Back to top

Here you will register and activate your Rockblock MK II. You will also set the connection to the AWS servers.

Remember, for the system to work the following assumptions are made:

• You have a Rockblock MK II on hand
• You will purchase data credits for the account after registration of the Rockblock
• You will activate the account after registration of the Rockblock

Back to top

Go to your Rock7 Core services account:

1. Click on "My Rockblock" on the menu at the left
2. Enter your Rockblock MK II registration code
3. Click "Add"
4. Done!

Back to top

1. Click on "Credits and Line Rental
2. Select the number of months to keep the unit active for
3. Select the number of credits to purchase

Your Rockblock should be active and operational within the hour. 

Back to top

1. Create a new "Delivery Group" with a name of your choice

2. Paste the ENDPOINT value you got at the end of STEP 6 when setting up your AWS stack into the "Delivery Addresses" field.

Back to top

2 out of 3 down. Do a *small* victory dance. The cloud infrastructure is *almost* done.

Back to top

Twilio will take care of message routing across the telephone network. It also assigns your PR-Holonet unit its telephone number. 

Again, you'll need your credit card to:

• Purchase a phone number that supports sms messages
• Purchase enough credits to send and receive messages

Friendly reminder:

Again, any costs incurred in efforts to build and own PR-Holonet are your own.

Final stretch!

Back to top

Here's a quick tutorial on creating a Twilio account and getting your Twilio phone number.

MAKE SURE IT SUPPORTS SMS

Back to top

Once you have:

• Your Twilio account
• Your SMS supported phone number

You need to setup the handler URL in Twilio. 

To do this:

1. Login to Twilio

2. Click on "Console" on the top bar to the right

3. Click on "Phone Numbers" on the menu bar at the far left

4. Click on your Twilio Phone number
5. Scroll all the way down to the "Messaging" section

6. Select "Webhooks" for the "Configure with" field
7. Paste your AWS ENDPOINT URL in that field

8. SAVE

Back to top

If you did not know your Rockblock IMEI and Twilio phone number when you installed, configured, and launched the AWS stack, now is the time to put those in. 

Redo steps 5 and 6 again, this time with the correct values. 

After this, your cloud is ready to go!

--> Go to Part A Step 5