Opentaps Amazon EC2 Images
From Opentaps Wiki
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.
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".
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:
Then, you can specify changes to the instance's options:
After that, you need to specify a security key pair for accessing your instance:
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:
If you are creating a new security group, then first give your security group a name:
Then, add each port you need to use, like this:
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.:
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:
Wait until it shows a green button next to your instance:
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:
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:
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 firstname.lastname@example.org $ sudo su root
If you are using opentaps 1.5M1, you can login directly as root:
$ ssh ec2/mysecurekey.pem email@example.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
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.