User:Jonathanl

Jonathanl edit test

Using my User Page just to get some wiki writing done.

Contents 1 Idiot's Guide to Running Openbravo 2.50 at AWS 1.1 Prerequisites 1.2 Log in at Amazon Web Services 1.3 Security Group 1.4 Create Instance 1.5 Make a Note of Your Address 1.6 SSH to it 1.7 Install Openbravo 1.7.1 Edit Package Tool configuration 1.7.2 Update / Fetch 1.8 Web to new system 1.9 Configure New System 1.10 Delete This System

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):

1. Security Groups
2. Create Security Group
3. Fill out the form: Security Group Name as openbravosec and Description as Suits Openbravo
4. 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):

1. Launch Instances
2. Choose AMI: Select 'Community AMIs'
3. Put ccf615a5 in the search
4. Find alestic/ubuntu-9.04-jaunty-base-20091011.manifest.xml
5. 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

1. Instances
2. Click on the correct instance (make SURE you get the right one!)
3. Instance Actions / Terminate

All gone!