Documentation

Amazon Web Services (AWS)

Download (pdf)

Introduction

Amazon Web Services (AWS) offers a suite of cloud-computing services that make up an on-demand computing platform.

Support

HUBzero

Trouble tickets are generally answered 9AM - 5PM EST, weekends and holidays excluded. Even though we try our best to assist you quickly, please allow 24-48 hours to hear back from us.

https://hubzero.org/support/ticket/new

AWS Infrastructure

AWS Support is a one-on-one, fast-response support channel that is staffed 24x7x365 with experienced and technical support engineers. The service helps customers of all sizes and technical abilities to successfully utilize the products and features provided by Amazon Web Services.

https://aws.amazon.com/contact-us/

Standing up a Hub on AWS

Download: Download Instructions

In order to stand up a Hub on Amazon Web Services (AWS) you must have an AWS account that has been registered and confirmed.

Sign in to AWS

  1. Navigate to https://aws.amazon.com/marketplace/
  2. Sign in to your AWS account
  3. Click Amazon Web Services Home
  4. Click Sign In to the Console
  5. Under AWS Services, click EC2

 

Create Key Pair

keypair

  1. On the EC2 Dashboard under Network & Security, click Key Pairs
    1. If Key Pair hasn't been previously setup, you will need to set one up for Amazon
  2. Click on Create Key Pair
  3. In the Key pair name field, type XXXX(Name your Key) and click Create
  4. Save the file to your browser
  5. Verify that your Key Pair was created 

 

Set-up Your Hubzero Instance

searchhubzero

t2.micro

navigatehome

  1. Navigate back to https://aws.amazon.com/marketplace/
  2. Search for hubzero in the Shop All Categories 
  3. Your search should return "Hubzero Platform for Scientific Collaboration"
  4. Click on the title of the Hubzero instance
  5. On the product description page, determine your region and then click Continue
  6. Click on 1-Click Launch and verify that your instance type is t2.micro
  7. Scroll to the bottom and verify that AWS key is present
  8. Verify that you are okay with the prices and click Launch with 1-click
  9. You will receive a confirmation page
    1. You will have to wait a couple of minutes as your instance is deployed on EC2. You should receive an email once your instance is ready.
  10. When your instance is ready, return to the Product Page

 

Check-out Your Hubzero Instance

  1. Sign in and navigate to EC2 and your EC2 Dashboard
  2. Under Resources select Running Instances
  3. Click on Public DNS and read the documentation grab 
  4. Navigate back to EC2 and click on Actions then click Instance Settings
  5. Under Instance Settings click on Get System Log
  6. Grab your secure admin password by scrolling to the bottom
  7. Navigate back to your instance and click Jump to Your Hub
  8. Check-out your instance's interface and read the documentation

 

Login to Your Instance's /administrator interface

  1. When you're ready Jump to the /administrator interface
  2. Login with the username admin and your secure password
    1. Your browser might flag the site as a failed connection
      1. Remove the :80 from the URL and refresh the browser
      2. Then when you receive the "Your connection is not secure" click Advanced then Add Exception
      3. Confirm your location and either get a Certificate for your instance or click Confirm Security Exception
      4. Continue logging into the /administrator interface and start configuring your instance

 

Congratulations on setting up a Hub!

 

Third Party Email

Background

Hubs are configured to send and receive email directly. However depending on server configuration, some mail servers on the internet may view an email message sent by your hub as SPAM. This can happen for a variety of reasons, ranging from partially setup machines used in development environments, servers that do not have DNS names properly established, MTAs that are not properly configured, etc.

Often you can find and fix specific issues it can help save your hub's email from your users' SPAM folders, but sometimes in cloud environments, your server is assigned an IP address from a pool of addresses where a previous user has used an IP addresses in that range to SPAM in the past, so your IP address itself of your server is blacklisted by various SPAM tracking software packages.

Often using a third party email provider such as Amazon SES or Mandrill can help rescue your outgoing email from your users' SPAM folders. This is an especially important issue for hubs that even occasionally send legitimate mass email to their users.

Steps for configuring EXIM with Mandrill

Setup an account with Mandrill. The free tier of service from Mandril will allow for up to 12000 email per month with no charges.

Login/sudo to your Debian machine as root.

% dpkg-reconfigure exim4-config

Mail Server configuration (page 1)

mail sent by smarthost; received via SMTP or fetchmail

Mail Server configuration (page 2)

enter the fully qualified domain name (FQDN) of the host (example.com)

IP-addresses to listen on for incoming SMTP connections

enter 127.0.0.1

Other Destinations for which mail is accepted

blank

Machines to relay mail for

blank

IP address or host name of the outgoing smarthost

smtp.mandrilllapp.com::587

“Hide local mail name in outgoing mail?”

<NO>

Keep number of DNS-queries minimal (Dial-on-Demand)

<NO>

“Delivery method for local mail”

mbox format in /var/mail/

“Split configuration into small files"

<YES>

root and postmaster mail recipient

 - leave blank

 

Create a file /etc/exim4/passwd.client file as root

% nano /etc/exim4/passwd.client

 

Enter the following line at the end of the file:

*.mandrillapp.com:SMTP Username:API Key

Note: Go to your mandril app and select the ‘Settings” page from your dashboard to get your SMTP Username and API Key.

 

Make sure the group and permissions are properly set on the passwd.client file

% chgrp Debian-exim /etc/exim4/passwd.client
% chmod 640 /etc/exim4/passwd.client

 

Suggestions on Expanding Volume

Not a procedure recommended for non-system administrators to try to preform. If you have further questions or need help, contact AWS for help

 

Expanding Volume:

  1. Shutdown the instance
  2. Snapshot the volume
  3. Create a new volume from the snapshot (and be sure to specify a large enough size here)
  4. Detach the old volume from the instance
  5. Attach the new volume to temporary instance
  6. In the temp instance, mount the new volume, and run resize2fs so it grows to take advantage of the entire partition space
  7. Shutdown temp instance
  8. Remount the new volume to the original instance
  9. Reboot original instance

 

Helpful AWS Documents:

http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-expand-volume.html

http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-expand-volume.html#recognize-expanded-volume-linux

 

You can also create a new volume, and then remount part of the root filesystem there. I usually move /home to the new partition. In this case, they'd probably want to move /var/ there, but it depends on what is taking up the most space on their system. This procedure is outlined here:

http://unix.stackexchange.com/questions/131311/moving-var-home-to-separate-partition 

Last modified: