- 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 a server capable of running 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
The AMI's are only provided for Openbravo customers. To get the list and AMI ids please contact Openbravo support.
AMIs are provided in the eu-west-1: Europe (Ireland) region for both amd64 (Intel/AMD and arm64 (AWS Graviton) architectures.
AWS allows to very easily copy an AMI to any destination region you have chosen (close to your location).
The older Appliance 18.04 provided only amd64 (Intel/AMD) AMI's in the following regions:
Select the region closest to your location:
- ap-northeast-1: Asia Pacific (Tokyo).
- ap-southeast-1: Asia Pacific (Singapore).
- eu-central-1: Europe (Frankfurt).
- New since 18Q4 release shipping Appliance 18.04
- eu-west-1: Europe (Ireland).
- us-west-1: US west coast (California).
- us-east-1: US east coast (Virginia).
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.
The Openbravo Appliance (since version 20.04) does NO longer contain the Openbravo application preinstalled but is just empty.
Before being able to access the Openbravo application you need to either - install Openbravo from sources - Restore a backup
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.