Standard deployment procedure

1 Presentation
2 Preparation
3 Setup a cvs repository
4 Setup database
- 4.1 PostgreSQL
5 Setup integration environment
6 Setup production environment
7 Setup backup environment

[edit]

Presentation

When we deploy neogia in production site, we generally setup three environments:

an integration environment that is used to validate all developments before they will be used in production
a production environment
a backup environment which is a copy of the production one

To keep a trace of all specific modifications brought to neogia, we use a cvs repository.

This guide is based on the deployment on Linux, this choice being the majority choice. Neogia is however installable on any OS having a virtual machine java (JVM) and the necessary tools installed.

[edit]

Preparation

Check prerequisite softwares are installed:
- ssh
- cvs
- java (1.4 or 1.5 - Sun, Blackdown)
- ant
- postgresql

Select an install location

INSTALL_ROOT=/opt/neogia

Change user for root

su

Create a user

useradd neogia

Select a path for installation

INSTALL_ROOT=/opt/neogia

Create directory

mkdir $INSTALL_ROOT
chown neogia:users $INSTALL_ROOT

Change user for new one

su neogia

[edit]

Setup a cvs repository

create repository

mkdir -p ${install.dir}/cvsroot/neogia
cvs -d ${install.dir}/cvsroot/neogia init

[edit]

Setup database

[edit]

PostgreSQL

set up user ofbiz with password ofbiz, and make it owner of database ofbiz. edit pg_hba.conf to give it password access
Get PostgreSQL JDBC jars and put it into $INSTALL_DIR/framework/entity/lib/jdbc
Edit framework/entity/config/entityengine.xml:
- Change:


   <delegator name="default" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main" distributed-cache-clear-enabled="false">
       <group-map group-name="org.ofbiz" datasource-name="localderby"/>
       <group-map group-name="org.ofbiz.odbc" datasource-name="localderbyodbc"/>
   </delegator>

To:


   <delegator name="default" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main" distributed-cache-clear-enabled="false">
       <group-map group-name="org.ofbiz" datasource-name="localpostgres"/>
       <group-map group-name="org.ofbiz.odbc" datasource-name="localderbyodbc"/>
   </delegator>