ERP 2.50:Virtual appliances/it

Contents 1 Introduzione 2 Informazione Generale 2.1 Software Incluso 2.2 Requisiti Minimi 2.2.1 VMware 2.2.2 Xen 2.2.3 QEMU 2.2.4 Parallels 2.2.5 VirtualBox 2.3 Informazione login di Openbravo ERP 2.4 Passwords Linux 2.5 Accesso Diretto al database 2.5.1 Linux, MAC e *BSD 2.5.2 Windows 2.6 Misc 3 Installazione e utilizzo 3.1 Passi Comuni 3.2 VMware 3.3 Xen 3.3.1 Esecuzione su Amazon EC2 3.4 QEMU 3.5 Parallels 3.6 VirtualBox 4 Changelog 5 Support

Introduzione

Una virtual appliance è un'application minima preinstallata e preconfigurata e un sistema operativo, progettato per essere eseguito sotto VMware, Xen o ogni altra tecnologia di virtualizazione . Il progetto Openbravo ERP fornisce apparati virtuali per semplificare il processo di valutazione . Per facilitare questo processo, questi apparati includono un semplice database chiamato BigBazaar.

L'immagine dell'apparato è in SourceForge download area.

Informazione Generale

Software Incluso

L'apparato include il seguente software :

• Openbravo ERP 2.35 MP5.
• PostgreSQL 8.2.7.
• Sun JDK 1.5.0_15.
• Apache Ant 1.7.0.
• Apache httpd 2.0.61.
• Apache Tomcat 5.5.26.
• mod_jk 1.2.26.
• OpenSSH 4.9p1 (client and server).

Requisiti Minimi

VMware

• Versioni Supportate : VMWare Player 1.x, 2.x, VMware Server, VMware WorkStation o VMware Fusion.
• Nome del File : OpenbravoERP-2.40-x86.vmware.tar.gz
• Spazio libero Allocato: 5GB.
• Memoria RAM Allocata: 512MB.
• Spazio swap Allocato : 128MB.
• Networking: bridged.

Xen

• Versioni Supportate : Xen 3.0.3 or higher. Can be deployed into Amazon EC2.
• Nome del File : OpenbravoERP-2.40-x86.xen.tar.gz
• Spazio libero Allocato: 5GB.
• Spazio swap Allocato: 128MB.

QEMU

• Versioni Supportate : QEMU 0.8 or higher. Optionally use KQEMU to increase performance.
• Nome del File : OpenbravoERP-2.40-x86.qemu-parallels.gz
• Spazio libero Allocato: 5GB
• Spazio swap Allocato: 128MB

Parallels

• Versioni Supportate : Parallels Workstation, Desktop or Server.
• Nome del File : OpenbravoERP-2.40-x86.qemu-parallels.gz
• Spazio libero Allocato : 5GB
• Spazio swap Allocato : 128MB

VirtualBox

• Versioni Supportate : VirtualBox or VirtualBox-OSE.
• Nome del File : OpenbravoERP-2.40-x86.virtualbox.gz
• Spazio libero Allocato: 5GB.
• Spazio swap Allocato: 128MB.

Informazione login di Openbravo ERP

Inserire l'indirizzo IP indicato alla fine del processo di boot. Per loggarsi in Openbravo ERP:

utente: Openbravo

password: openbravo

Notare che entrambe sono case sensitive.

Passwords Linux

• Accesso root : passwordless, login come root e settare la password con 'passwd'. Non si può eseguire ssh come root finchè questa password è settata.
• Accesso SSH : utente openbravo e password openbravo. Questo utentesi logga automaticamente nella directory /opt/AppsOpenbravo .

Notare che queste passwords non sono usate per fare il login in Openbravo ERP, ma in Linux.

Accesso Diretto al database

For security reasons the appliance runs a firewall (iptables) that blocks every external access except to the HTTP (80) and HTTPS (443) ports. So in order to connect to the database using an external tool, such as PgAdmin3, it is necessary to establish a SSH tunnel, described as follows.

Linux, MAC e *BSD

1. Open a command-line terminal and type the following command, replacing ip_address with the correct IP address.:

ssh -N -L 5453:localhost:5432 openbravo@ip_address

1. This forwards the appliance's PostgreSQL port into the 5433 port of the user's local client machine, tunneled over a SSH connection.
2. Type the openbravo user's password and leave this terminal opened.
3. Open the PostgreSQL client (e.g. PgAdmin3), specify the following connection settings and click OK:
   • Name: OpenbravoERP
   • Host: localhost
   • Port: 5433
   • Username: tad
   • Password: tad

The connection will be available as long as the previous SSH connection is opened.

Windows

Use PuTTY to connect to PostgreSQL in Windows. PuTTY is an open source and free SSH client:

1. Select Session'
2. In the Host Name' box, enter IP Address of the Openbravo Network machine.
3. Select Connection -> SSH -> Tunnels.
4. In the Source port field, enter 5433.
5. In the Destination field, enter localhost:5432.
6. Click Add.
7. Click Open to open the ssh connection.
8. Type the openbravo user name and its password and leave this terminal opened.

Misc

• Il contesto tomcat si trova in /var/lib/tomcat/webapps/openbravo.

Installazione e utilizzo

Passi Comuni

1. Download a virtualization program. See below for specific instructions on VMware, Xen, QEMU, Parallels and VirtualBox.
2. Download the virtual appliance and open it with the virtualization program.
3. The following message is shown at the end of the boot process, indicating the URL to access Openbravo ERP with your web browser:

Welcome to Openbravo ERP Community

To login to Openbravo ERP use your web browser to go to http://<IP_ADDRESS>

VMware

Use VMware Player (freeware) to run pre-built virtual machines on your desktop. To get the Openbravo appliance running, follow these steps:

• Download and install VMware Player. There are versions for Microsoft Windows and Linux. On Macs, VMware Fusion needs to be downloaded and installed.

• Download the latest version of the Openbravo VMware image and unpack the files.

• Run VMware Player (or VMware Fusion on a Mac) and select the decompressed .vmx file.

• If there is DHCP on your network, no further steps are required. The final boot message within the virtual machine play window will indicate the URL to access Openbravo from your browser.

If there is no DHCP you have two options:

1. Change the networking option within the VMware player to NAT and restart the virtual machine. This will create an internal subnet within your computer through which you will be able to access the virtual machine. Note that this way, Openbravo will not have access to the internet.
2. Or login as root (passwordless) and type the following commands to set a specific ip IP_ADDRESS and a gateway IP_GATEWAY:

$ /sbin/ifconfig eth0 IP_ADDRESS netmask 255.255.255.0 up
$ /sbin/route add default gw IP_GATEWAY

Finally to make it available to the internet, assign some DNS servers to it:

$ echo "nameserver IP_DNS1" >> /etc/resolv.conf
$ echo "nameserver IP_DNS2" >> /etc/resolv.conf

Once the IP address is set, open http://<IP_ADDRESS> to access Openbravo ERP in a web browser (see above).

Xen

Xen is an open source and free virtualization software. To get the Openbravo appliance running, follow these steps.

Esecuzione su Amazon EC2

Follow these steps to deploy the Xen appliance into Amazon EC2. Make sure all the used environment variables are correctly configured:

• First, bundle the image:

$ ec2-bundle-image -i OpenbravoERP-2.40-x86.fs -k $EC2_PRIVATE_KEY -c $EC2_CERT -u $EC2_USER_ID

• Upload the image into a Amazon S3 bucket:

$ ec2-upload-bundle -b OpenbravoERP -m /tmp/OpenbravoERP-2.40-x86.fs.manifest.xml -a $EC2_ACCESS_KEY -s $EC2_SECRET_KEY

• Register the image:

$ ec2-register OpenbravoERP/OpenbravoERP-2.40-x86.fs.manifest.xml
ami-xxxxxx

• Use the ami-xxxxxx returned by this command to run the instance:

$ ec2-run-instances ami-xxxxxx

QEMU

The installation and its networking configuration are out of the scope of this document. Assuming it is ready, run the following command:

$ qemu -hda OpenbravoERP-2.40-x86.qemu-parallels -m 512 -net tap -net nic

Parallels

Decompress OpenbravoERP-2.40-x86.qemu-parallels.gz and open the OpenbravoERP-2.40-x86.qemu-parallels file with Parallels.

VirtualBox

• Decompress OpenbravoERP-2.40-x86.virtualbox.gz, this will result in the OpenbravoERP-2.40-x86.virtualbox.vdi file.
• Open VirtualBox and click on Machine -> New. Enter Openbravo ERP Community in the Name and select Linux 2.6 in OS Type. Click on Next.
• Select 512MB of Base Memory Size. Click on Next. In case you are using the 2.50alpha-r1 appliance, select 1024MB.
• Click on Existing to add the image. Then Add, and browse to select the OpenbravoERP-2.40-x86.virtualbox.vdi file. Click on Select, then on Next and finally in Finish.

In order to use Openbravo ERP it is necessary to access the virtual appliance through the network. Follow the official user manual to configure this network, specially the Introduction to Host Interface Networking (HIF) section. There are specific instructions for Linux (Debian/Ubuntu), Mac OSX and Windows.

Changelog

Version 2.35 MP5

• Openbravo ERP: upgrade to 2.35 Maintenance Pack 5. Add delay to init script to avoid errors on low memory systems.
• Conary: upgrade to 2.0.16.
• Cyrus-SASL: upgrade to 2.1.21.
• distro-release: update strings to "2.35 MP5".

Version 2.35 MP4

• Openbravo ERP: upgrade to 2.35 Maintenance Pack 4. Create initial database from a dump file with demo data. Include database structure XML files in database directory.
• PostgreSQL: upgrade to 8.2.7. Fix autovacuum issue.
• Apache Tomcat: upgrade to 5.5.26.
• Sun JDK: upgrade to 1.5.0_15.
• Include only apr and apr-util 0.9.x. Apache 2.0.x doesn't support apr 1.2.x and tomcat-native anyway.
• Linux kernel: upgrade to 2.6.24.7.
• Open VMware Tools: upgrade to 2008.05.02_90473.
• Conary: upgrade to 2.0.14.
• OpenSSH: upgrade to 4.9p1.
• distro-release: update strings to "2.35 MP4". Modify welcome message.

Version 2.35 MP1

• Openbravo ERP: upgrade to 2.35 Maintenance Pack 1. Create initial database from XML files.
• PostgreSQL: upgrade to 8.2.6. Enable autovacuum.
• Apache Tomcat: decrease maximum memory allocation to 384MB. Add the tmptomcat hourly cron script to prevent the deletion of /var/tmp/tomcat by tmpwatch.
• distro-release: update strings to "2.35 MP1".
• iptables: accept external PostgreSQL connections, port 5432.
• mod_jk: upgrade to 1.2.26.
• apr: upgrade to 1.2.12.
• apr-util: upgrade to 1.2.12.
• Add lftp.
• Add slocate.
• Add rsync.
• Add two branches to installLabelPath: conary.rpath.com@rpl:1 and addons.rpath.com@rpl:1.
• Linux kernel: upgrade to 2.6.22.16.

Version 2.35

Initial VMware and Xen virtual images:

• Openbravo ERP 2.35.
• Apache Tomcat 5.5.25.
• Apache httpd 2.0.61.
• PostgreSQL 8.2.5.
• Apache Ant 1.7.0.
• Linux kernel: upgrade to 2.6.22.13.
• mod_jk 1.2.23.
• apr 1.2.8.
• apr-util 1.2.8.
• VMware appliance: Open VMware Tools 2007.10.08.

Support

For any questions or doubts about the virtual appliances, post your questions in the Help forum. Or join the #openbravo IRC channel in freenode.

If you think you've found a bug, report it through issues.openbravo.com.

Categories: Templates | Italian