Opentaps Amazon EC2 Images

From Opentaps Wiki

Jump to: navigation, search

Contents


opentaps Amazon Elastic Computing Cloud (EC2) images allow you to get up and running with opentaps in minutes using pre-stored Amazon Machine Images (AMI's). You can use these AMI's for demo or production purposes, and you can pay for them by the hour.

To learn more about how these AMI's work, see opentaps In The Cloud. These instructions are included in the following video for how to set up opentaps in the Amazon EC2 Cloud:

IMPORTANT: Do not use the AMI's for sensitive data such as financial information or customer records unless you have secured the instance following the steps from the opentaps Professional Configuration Service .

Starting the AMI

To start using an opentaps Amazon EC2 image, you must first enable your Amazon account to use the Amazon EC2 service.

Then, go to opentaps In The Cloud and follow the links to subscribe to either the opentaps Mini or opentaps Full You must subscribe to the opentaps AMI's by placing an order here first before you can launch them.

Image:Opentaps-amazon-ec2-subscription.png

Next, login to the Amazon EC2 Management Console. Make sure that your Region is one of the following where opentaps AMI's are available:

  • US East (N. Virginia)
  • EU West (Ireland)
  • Asia Pacific (Singapore)

Click on "Launch Instance".

Image:Opentaps-amazon-ec2-launch-instance.png

Now search for opentaps under "Community AMI's" to launch it: Image:Opentaps-amazon-ec2-find-ami.png

NOTE: The opentaps 1.5 AMI images now have Tour_of_CRM2 pre-loaded, and the names are opentaps-1-5-0-crm2-mysql and opentaps-1-5-0-crm2-mysql-mini. See Set_up_CRM2 on how to set up CRM2 after you start your AMI.

If you do not see the opentaps-1-5-0-crm2-mysql or opentaps-1-5-0-crm2-mysql-mini AMI, then you did not subscribe to the opentaps AMI's. You must go back to opentaps In The Cloud and subscribe to either the opentaps Mini or opentaps Full AMI first and try again.

You will go through a serious of screens to specify the configuration of your instance. First, you need to choose the type of instance, including number of processors and memory:

Image:Opentaps-amazon-ec2-instance-type.png

Then, you can specify changes to the instance's options:

Image:Opentaps-amazon-ec2-instance-options.png

After that, you need to specify a security key pair for accessing your instance:

Image:Opentaps-amazon-ec2-key-pairs.png

Next, you need to specify a security group. You need a security group which allows access for SSH (port 22), HTTP (port 80), and HTTPS (port 443). You can either pick an existing security group, if you've already created one, or set up a new one:

Image:Opentaps-amazon-ec2-security-group-1.png

If you are creating a new security group, then first give your security group a name:

Image:Opentaps-amazon-ec2-security-group-2.png

Then, add each port you need to use, like this:

Image:Opentaps-amazon-ec2-security-group-3.png

When you've added all the ports you need, click on Continue Image:Opentaps-amazon-ec2-security-group-4.png

Now you are ready to launch your instance. Look through everything one more time and click on Launch if you're sure: Image:Opentaps-amazon-ec2-security-group-5.png

Once you've clicked Launch, Amazon should tell you that your instance is launching: Image:Opentaps-amazon-ec2-launched.png

IMPORTANT: If you did not subscribe to the opentaps AMI's first, then your AMI's could not be launched successfully. You will receive an error message like Subscription to ProductCode XXXXXXXX required.:

Image:EC2_Subscription_Required.png

You must go back to opentaps In The Cloud to purchase a subscription to an opentaps AMI first, and then try again.

Using the AMI

Once you have successfully launched your AMI, your Amazon EC2 Management Console will show that is pending:

Image:Opentaps-amazon-ec2-pending.png

Wait until it shows a green button next to your instance:

Image:Opentaps-amazon-ec2-running.png

This means that the instance is up and running. The instance should also show a public DNS address which begins with ec2-, like ec2-123-456-78-90.compute-1.amazonaws.com (In this screenshot, it is ec2-184-73-130-105.compute-1.amazonaws.com) You will be using this address to access the instance.

When the instance first starts up, opentaps will be automatically moving itself from /opt/opentaps to /mnt/opentaps. This takes approximately 5 minutes.

When it is done, you can access opentaps from your browser with its public DNS address, like this:

http://ec2-123-456-78-90.compute-1.amazonaws.com/opentaps

The initial username and password are admin/opentaps

opentaps 1.4.2 and opentaps 1.5M1 are both preloaded with Base Template data which you can customize to set up your company.

Instance vs. AMI ID

It is important to know how to identify your instance. Amazon EC2 gives you two ID's, an instance ID and an AMI ID:

Image:Opentaps-amazon-ec2-instance-ami-id.png

The instance ID, which is i-6236840f here, is a unique ID for your particular server. The AMI ID, which is ami-26ae594f, is the machine image, or AMI, you used to start your server. It corresponds to a particular snapshot of opentaps, Linux, and MySQL. This AMI could be used by many people's instances.

Managing your opentaps Instance

To manage your opentaps instance, use your Amazon .pem key and login to login. If you are using opentaps 1.4.2 or later AMI's, the Amazon base linux does not allow root login, so you must login as the ec2-user and then sudo as root:

$ ssh ec2/mysecurekey.pem ec2-user@ec2-123-456-78-90.compute-1.amazonaws.com
$ sudo su root

If you are using opentaps 1.5M1, you can login directly as root:

$ ssh ec2/mysecurekey.pem root@ec2-123-456-78-90.compute-1.amazonaws.com

By convention, opentaps will be installed in the `/mnt/opentaps` directory, so you can go to your version as the root user:

$ cd /mnt/opentaps/opentaps

and modify the configuration files.

To start, stop, or restart opentaps, you can use the /etc/init.d/opentaps script:

$ /etc/init.d/opentaps stop
$ /etc/init.d/opentaps start

Switching from Production to Demo

Starting with opentaps 1.4.2 (but not 1.5M1), the same instance can be used for both demo or production purposes. By default, opentaps 1.4.2 AMI is configured to use the Base Template database, but you can switch to the demo database with

$ /etc/init.d/opentaps switch-demo

To switch back to the Base Template database, which is recommended for configuring your production instance:

$ /etc/init.d/opentaps switch-prod

Setting up opentaps Update Service

These instructions apply to opentaps 1.4.2 and later AMI's

Your opentaps AMI comes with a free subscription to the opentaps Update Service. To register yourself, contact opentaps with your Amazon instance ID (see below):

Once we have verified your instance, you will receive a username and password for the service. Edit the file `/etc/init.d/opentaps` and put it in the fields for

$ SVN_USERNAME=
$ SVN_PASSWORD=

Then, you can update opentaps with

$ /etc/init.d/opentaps update

Completing your Setup

IMPORTANT Before using your AMI for sensitive data, you need to secure it with an SSL certificate. The opentaps Professional Configuration Service can help you secure your production instance and configure email, DNS, and performance monitoring.



© Open Source Strategies, Inc. Development of this documentation site is sponsored by Open Source Strategies, Inc.
Help support opentaps with a subscription to this documentation site.