Instructions for Using MU-LOC on Amazon Web Services (AWS)


Step 1: Create an AWS account and/or login to your AWS account

For a first time user, you can create an Amazon Web Services (AWS) account at https://aws.amazon.com/.

Login to your AWS account, and set your region to US West (Oregon). The region list is located to the right of your account information on the navigation bar.

Click Services and select EC2 under Compute.

Change AWS Region Select EC2 Service

Step 2: Launch a MU-LOC instance

Click AMIs under IMAGES on the left panel. In the search area, select Public images, type in ami-12f37d6a, and press "Enter" button to search. You should see the AMI name of MU-LOC_AWS. Select this AMI and click Launch.

Search MU-LOC AMI

Step 3: Configure and connect to your instance

For 2. Choose an Instance Type: select g2.2xlarge. Then click Next. This page lists the pricing information for each instance type: https://aws.amazon.com/ec2/pricing/on-demand/.

For 3. Configure Instance Details: you can use the default options. Then click Next.

For 4. Add Storage: set Size (GiB) to 30. Then click Next.

For 5. Add Tags: you can use the default options. Then click Next.

For 6. Configure Security Group: you can use the default options. Then click Review and Launch.

For 7. Review Instance Launch: you can leave all the defaults and click Launch.

After clicking Launch, you need to select an existing key pair or create a new key pair. For first time users, select Create a new key pair from the drop-down menu, enter a name, and click Download Key Pair. After that, check the box and click Launch Instances.

After launching instances, click View Instances, and you will be able to monitor all your instances. It may take a few minutes to set up your instance. Once it is available, select your instance and click Connect. Follow the instructions to ssh into your instance.

Note that you may need to change the user from root to ubuntu to access your instance. For the example instance shown below, use the following command:

ssh -i "NingZhang-PC-Ubuntu.pem" ubuntu@ec2-35-164-12-232.us-west-2.compute.amazonaws.com
Select Instance Type Add Storage Add Storage Add Storage

Step 4: Upload or download files

You probably need to upload (e.g. your input sequences, etc.) and/or download files (e.g. MU-LOC program, your prediction results, etc.). We provide here an example of using FileZilla to upload and download files.

Open FileZilla, and click Edit > Settings. Locate SFTP on the left panel, and click Add keyfile... on the right panel. Select your AWS key pair, and click Yes to convert it to the format FileZilla supports.

Click File > Site Manager..., and click New Site. For the example instance shown above,

for Host, enter ec2-35-164-12-232.us-west-2.compute.amazonaws.com;

for Protocol, select SFTP - SSH File Transfer Protocol;

for Logon Type, select Normal;

for User, enter ubuntu, and leave the Password empty.

Click Connect to access your instance for file upload/download.


Step 5: Running MU-LOC on AWS

After a successful login to your instance, you can run MU-LOC on AWS. We have added MU-LOC to the PATH, and MU-LOC can be called directly: e.g. run_muloc.py -h to display help messages.

We also have a copy of MU-LOC program at /home/ubuntu/mu-loc.tar.gz.

In addition, we provide a test file at /home/ubuntu/test_muloc/seq.fasta to check if MU-LOC is able to run successfully.

If you feel your instance is running slow, you can try restarting it from the previous monitor page (click Actions > Instance State > Reboot, or Stop and Start).