- Intended for production and testing.
Openbravo builds the Openbravo Appliance also as Amazon EC2 AMI (Amazon Machine Images), so that you can just start a new instance and have Openbravo up and running in a matter of minutes.
This getting started instructions will guide you through the process of setting up and running an Openbravo Amazon EC2 instance. For the end of this guide you can expect the following achievements:
- Set up an Amazon EC2 account (if you don't have one).
- Run an Openbravo instance.
- Learn how to make full backups (snapshots) and how to restore them.
Sign up for EC2
To use Amazon EC2 you need an AWS (Amazon Web Services) account. If you don't already have one, you'll be prompted to create one when you sign up for Amazon EC2. To sign up for Amazon EC2:
- Go to http://aws.amazon.com/ec2 and click Sign Up for Amazon EC2.
- Follow the on-screen instructions.
Things to think before start
Select the instance type based on the estimated cpu and ram that you will need support, recommendation is start with smaller ones, and increase as you see that it don't fit. Since the change from one type to another is quite easy and fast: stop, change, start , so matter of few mins.
You can take a look to Openbravo sizing guide.
Choose your AMI
For see the list of provided AMI's, click here to select your AMI. Be sure to choose your desired geography.
Select the region closest to your location:
- ap-northeast-1: Asia Pacific (Tokyo).
- ap-southeast-1: Asia Pacific (Singapore).
- eu-west-1: Europe (Ireland).
- us-west-1: US west coast (California).
- us-east-1: US east coast (Virginia).
The only AMI provided by Openbravo is 64 bits and hvm, that allows you to start the new types of instances of Amazon EC2 that also has better prices than old options.
Note 32 bits are not provided since the small amount of ram of 32 bits instances, plus 32 bits instances in EC2 are quite few and small and if choosen one, later can not be changed to any 64 bits instance
From the AWS Management Console, click Sign in to the AWS Console and log in with the email address and password you used when signing up for Amazon EC2.
From the Amazon EC2 Console Dashboard, select the Region you would like to use (e.g. US East). Then click Launch Instance to start the Request Instances Wizard.
Click on the Community AMIs tab and enter the AMI you've selected in the previous step.
After you select an AMI, the wizard steps to the Instance Details page. This is where you control settings such as the number and size of instances to launch.
Select your instance type
Now select the instance type you've chosen before, based on your requirements.
After clicking on Continue you'll be asked for advanced instance options. You can accept the default options and click Continue once again.
Set a name
Now you can optionally set a name to the instance, so that you can easily identify it in the instance list.
Create a key pair
Next, the wizard displays the Create Key Pair page. A key pair is a security credential similar to a password, which you use to securely connect to your instance after it's running. If you're new to Amazon EC2 and haven't created any key pairs yet, when the wizard displays the Create Key Pair page, the Create a new Key Pair button is selected by default. We assume you'll want a new key pair.
- On the Create Key Pair page, enter a name for your key pair (e.g., johndoe). This will be the name of the private key file associated with the pair (with a .pem extension).
- Click Create & Download your Key Pair. You're prompted to save the private key from the key pair to your system.
- Save the private key in a safe place on your system. Note the location because you'll need to use the key soon to connect to the instance.
Create a security group
A security group defines firewall rules for your instances. These rules specify which incoming network traffic should be delivered to your instance (e.g., accept web traffic on port 80). All other traffic is ignored. You can modify rules for a group at any time. The new rules are automatically enforced for all running instances.
If you're new to Amazon EC2 and haven't set up any security groups yet, you'll need to create one:
- Enter a name and a description for the group.
- Add at least the following ports to the group: 22 (SSH), 80 (HTTP), 443 (HTTPS) and all ICMP.
Review your settings and launch the instance and click on Launch. Click Close to close the confirmation page, and then click Instances in the left navigation panel. This page lists your running instances.
It takes a short time for an instance to launch. The instance's status will be pending while it's launching.
After a short period, your instance's status switches to running. You can click Refresh to refresh the display.
To access Openbravo type http://ip-address/openbravo in your web browser. Use Openbravo as the username and openbravo as the password.
NOTE: The username is Openbravo, with an uppercase O. The password is openbravo, with a lowercase o. The system is case-sensitive, and you need to type both data elements correctly to access it.
Accessing the System via SSH
To access the system via SSH the key pair which has been created earlier is needed. To be specific the private key file which has been downloaded earlier is required.
To use that private the following command needs to be made non-public so other users then the owner of the file cannot access it. This step is needed as otherwise the ssh client will not accept the file.
chmod 400 johndoe.pem
After this the following command can be used to access the instance.
For the Openbravo appliance:
ssh -i johndoe.pem openbravo@ip-address
Backups in EC2
A good backup option could be just after setup everything take a backup of the machine and later rely on daily (or your preferred frequency) normal Appliance backups with syncronization to S3. Probably you want also to enable the backups rotation.