User:Jonathanl
Jonathanl edit test
Using my User Page just to get some wiki writing done.
Contents |
Idiot's Guide to Running Openbravo 2.50 at AWS
If you want to try Openbravo on a server you control, there can be a lot of operating system and other compatibility questions to solve. These notes will walk you through getting a cheap, disposable, Openbravo 2.50 ERP system right away.
This is for testing purposes only: don't do anything serious with this. If it crashes all the data will be gone, for example. It's up to you to work out how to make it fit for your purposes.
These instructions
- Are exact and step-by-step
- Run Openbravo ERP 2.50 from the Ubuntu Partner Repository
- Use Ubuntu 9.04 'base'
- Run at Amazon AWS
This method is
- Cheap and quick (Timed at 31m 42s from start to finish)
- Precise and easy if you can follow the prerequesites
- For those who know how to use a Unix shell and edit files
- For those who know little or nothing about Linux management or Openbravo
To repeat: this is for learning about how to get a running system so you can evaluate, for example, the security requirements, or what kind of disaster recovery might be possible.
USE ENTIRELY AT YOUR OWN RISK.
And just to repeat the obvious: don't put your real company financial information into this until you've got a secure installation.
Prerequisites
You must know how to use a Unix command line and have
- a working Amazaon Web Services account
- be able to create instances
- be able to ssh to them
You will be able to learn these from Amazon's Getting Started tutorial: http://docs.amazonwebservices.com/AWSEC2/latest/GettingStartedGuide/
Log in at Amazon Web Services
Log in on AWS Management Console https://console.aws.amazon.com/ec2/home
Security Group
The following tells you something that WORKS but it is NOT SECURE: follow these instructions at your own risk.
You will need to do better than this if you are doing anything other than playing for the sake of education. But it's perfectly okay to use if you are just building a play system.
Create a new security group 'openbravosec':On EC2 Management Console (US-East):
- Security Groups
- Create Security Group
- Fill out the form: Security Group Name as
openbravosec
and Description asSuits Openbravo
- Create
For it to work you will need to able to SSH to the computer (to do the installation) and also web to the (slightly unusual) port 8880.
Select it from the list of security groups and edit the Allowed Connections table until it looks like this:
Connection Method | Protocol | From Port | To Port | Source (IP or Group) |
---|---|---|---|---|
SSH | tcp | 22 | 22 | 0.0.0.0/0 |
Custom | tcp | 8880 | 8880 | 0.0.0.0/0 |
The SSH line is what you use to get to the command line of the new running instance to set things up; the Port 8880 line is what is used to connect to the running Openbravo over the web.
(Good idea: don't use 0.0.0.0/0 but instead use 12.34.56.78/32 where you use the real IP address you will ssh/web from: ie, your laptop.)
You can edit the security group after you launch an instance and the effects will take place immediately to the running instances.
Create Instance
We are going to create an AWS instance with the image ami-ccf615a5, which is Ubuntu 9.04 base image from Alestic, a well-known image.
On EC2 Management Console (US-East):- Launch Instances
- Choose AMI: Select 'Community AMIs'
- Put
ccf615a5
in the search - Find
alestic/ubuntu-9.04-jaunty-base-20091011.manifest.xml
- Select
Check details on second page match those in the image to the right.
1. AMI is critical. (Many other AMIs will work, but if you use this exact one the following instructions will be exactly right.)
2. Choose a 'Small' CPU.
3. Your keypair will probably be different: just so long as you know how to use the ssh to connect to your new instance. (See prerequesites.)
4. Choose 'openbravosec' (which you made above) for the security group.
Wait a minute until your instance starts running.
Make a Note of Your Address
On the control panel find your 'Public DNS' which will be something like this:
ec2-75-101-247-75.compute-1.amazonaws.com
(If you know how to do it, it's a good idea to map one of your 'Elastic IP' Addresses to this instance, which will mean you can use the same address even if you restart a new instance. If you are able, you then put this 'elastic' address into your own DNS as openbravotest.yourcompany.com.)
When the notes below refer to your address, it means this 'Public DNS' name.
SSH to it
You will need to be able to ssh to your new computer. If you don't know how to do this, go back to 'Prerequesites' above.
You'll ssh to your own address that you noted above.
On a unix computer we do
ssh root@ec2-75-101-247-75.compute-1.amazonaws.com
Here's the output which ends with a root prompt '#'.
sshout% ssh root@ec2-75-101-247-75.compute-1.amazonaws.com The authenticity of host 'ec2-75-101-247-75.compute-1.amazonaws.com (75.101.247. 75)' can't be established. DSA key fingerprint is 2a:ba:b9:14:b4:5b:47:30:7b:45:91:55:95:8f:8a:11. Are you sure you want to continue connecting (yes/no)? yes Warning: Permanently added 'ec2-75-101-247-75.compute-1.amazonaws.com' (DSA) to the list of known hosts. Linux ip-10-212-147-2 2.6.21.7-2.fc8xen-ec2-v1.0 #2 SMP Tue Sep 1 10:04:29 EDT 2 009 i686 The programs included with the Ubuntu system are free software; the exact distribution terms for each program are described in the individual files in /usr/share/doc/*/copyright. Ubuntu comes with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law. To access official Ubuntu documentation, please visit: http://help.ubuntu.com/ Amazon EC2 Ubuntu 9.04 jaunty AMI built by Eric Hammond http://alestic.com http://ec2ubuntu-group.notlong.com root@ip-10-212-147-2:~#
The prompt ending with #
is your root prompt.
Install Openbravo
These notes are essentially condensed from ERP/2.50/Openbravo_ERP_Installation.
Edit Package Tool configuration
We need to tell the package manager where to find software from partners such as Openbravo.
Cut and paste the following two lines into your root shell:
echo 'deb http://archive.canonical.com/ubuntu jaunty partner' >> /etc/apt/sources.list echo 'deb-src http://archive.canonical.com/ubuntu jaunty partner' >> /etc/apt/sources.list
If you have a different version of Linux you will need to do something different.
Update / Fetch
We need to update the list of software available, which takes about 15 seconds.
At your root prompt:
apt-get update
We need to install the Openbravo software, which will take a few minutes:
At your root prompt:
apt-get -y install openbravo-erp
You will get a couple of license agreements to confirm. Use Tab to select '<Ok>' or '<Yes>' and press return.
Operating System Distributor License for Java v1.1 (DLJ) ...
In order to install this package, you must agree to its license terms, ...
Configuration is now complete, and the build process will now begin. A ... Begin compilation?
The compilation takes about 25 minutes from beginning to end: this is the time to get a cup of tea.
Once you are back to your root prompt you can logout
logout
Web to new system
Put your address followed by :8880/openbravo into your browser.
Mine is:
ec2-75-101-247-75.compute-1.amazonaws.com:8880/openbravo
After about two seconds you should get a login page. If it's blank but your browser says it's connecting, check your security settings in AWS (see above).
You will get an Openbravo login page (green), log in as user 'Openbravo' with password 'openbravo'. Both are case-sensitive: note the capital O on the username but not the password.
After about two seconds you will get
- a 'Heartbeat Configuration' popup -- click 'disable'.
- a 'Registration' popup -- click 'decline'
At the top left you will see an icon of a person, the (confusing) username 'Openbravo' and the logout red X.
Configure New System
This is the point where the real work starts.
http://wiki.openbravo.com/wiki/Little_setup_guide
http://opensourceerpguru.com/2008/01/24/openbravo-configuration-initial-setup/
Delete This System
When you are done experimenting, you will need to delete the instance and all the data. Remember you're paying by the hour, currently $0.085/hour or $2.04/day.
The following destroys all the configuration and data: if you have anything you wish to keep you'd better find a way to save it before continuing
In EC2 Management Console
- Instances
- Click on the correct instance (make SURE you get the right one!)
- Instance Actions / Terminate
All gone!