Compiere ERP & CRM Installation Instructions

Linux System - EnterpriseDB

Compiere Learning Services Division

Copyright © 2007 Compiere, inc. All rights reserved

www.compiere.com
 Table of Contents
Compiere ERP & CRM Installation Instructions

1 Database Installation 2

2 Java Installation 7

3 Edit the Path 7

4 Download Compiere 7

5 Create Compiere Database 8

6 Complete Server Setup 9

7 Start Compiere 9

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 1
Compiere ERP & CRM - Installation Instructions – EnterpriseDB
PREREQUISITES
- Database approved Linux Operating System
- Disk Space: > 5 GB (includes database)
- Swap Space: > 1GB
- Recommended: Hardware RAID 10
- Memory: > 512 MB - Recommended: > 1 GB
- TCP/IP connection

Note: It will ease the installation tremendously, if you have your network set up with DNS server and a domain (actually a
must for non-Windows environments). Check with your system administrator - do NOT use IP addresses, but names!

DATABASE INSTALLATION
1. Install Database – this document will use EnterpriseDB 8.1.

1) First, Log on with root permissions.

2) Get the EnterpriseDB Advanced Server 8.1 for Linux x86 installer
from the following EnterpriseDB website:
http://www.enterprisedb.com/products/download.do
3) Download the file appropriate for your OS and uncompress the
tar file.

4) Run the script pre-Install.sh to confirm that the proper versions of

the system libraries are installed.

5) Run the installer edb-linux-x86_81825.bin.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 2
 6) The welcome page displays.

Note: you may be using a later

version.

7) Select the Next button to continue

with the Installation.

8) Review and accept the License

agreement.

9) Then select the Next button to

continue.

10) Select the Redwood Configuration.

11) Select the Next button to continue.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 3
 12) Select the destination folder by
selecting the Browse button.

Note: This document will assume that

root is the selected directory.

13) Select the Next button to continue.

14) Accept the default selections and

select the Next button to continue.

15) Enter the email and the password

defined when registering at
www.enterprisedb.com.

16) Then select the Next button to

continue.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 4
 17) Enter and confirm a Password for the
System Administrator.

18) Then select the Next button to

continue.

19) Enter and confirm a Password for the

Database Administrator.

Note: It is acceptable to use the

System Administrator Password
entered in Step 17. (This is optional)

20) Validate the location of the data

destination and WAL directories.

21) Then select the Next button to

continue.

22) Select the appropriate option

depending on the resources available
on the database server.

23) Then select the Next button to

continue.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 5
 24) For the Advanced Options, accept the
default options if applicable.

25) Then select the Next button to

continue.

26) Review the Installation Settings.

Select the Back button to make
changes if necessary.

27) If the Installation settings are correct,

select the Install button to start the
Installation.

28) When the Installation is complete, the

following confirmation window will
display:

29) Check the Launch Developer Studio

Option and select Finish to complete
the Installation.

30) Once the Developer Studio opens, enter the System Administrator User ID and Password entered in step 19.
Note: This confirms the Database Installation.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 6
JAVA INSTALLATION
2. Download and install Sun Java 1.5.0 (SDK) – also known as Sun Java JDK, Update 12, or a later version.
Note: The Compiere Server requires the SDK (not just JRE).
EDIT THE PATH

3. Add EnterpriseDB into the environment variable PATH

Hint: Add EnterpriseDB path to the end of the PATH environment variable (e.g./opt/EnterpriseDB/8.1/dbserver/bin)

DOWNLOAD COMPIERE

4. Install /Setup Compiere Server (this includes the Client as well)

1) Download the current version of Compiere: Download Compiere.

2) Extract the .zip file. The steps shown assume that you extract to the root directory, resulting in a
COMPIERE_HOME of /Compiere2.

3) Execute $COMPIERE_HOME/RUN_Setup.sh.
Note: if the following window does not appear, please ensure that the following are updated.

• Add "/usr/java/jdk1.5.0_10\bin;/Compiere2/lib;" at the beginning of the PATH system environment variable

• Set the JAVA_HOME system environment variable to "/usr/java/jdk1.5.0_10"
• Set the COMPIERE_HOME system environment variable to "/Compiere2"

4) Select Database Type of

postgreSQL.

5) For System Password use

the Database System user
password, (part 1, step 19).

6) For Database Password, use

‘compiere‘ (or any password.)’

7) Enter or update any other

Parameters as necessary.

8) Select the Help button, for

information on any field.

9) Select the Test button to

check the parameters.

Note: Parameters must be

verified in order to save.

10) Select the Save button.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 7
 11) If an entry is unverifiable, it
will display with a red X.
Correct the entry and re-
select Test/Save.

12) After correcting

(and accepting the license
agreement) the following
window will display:

13) Select OK to complete the

Server Setup.

14) Verify that you see a ‘Build Successful’ and ‘Done’ message at the end of this step.

15) The RUN_Setup procedure can be run multiple times until everything is correct.

CREATE COMPIERE DATABASE

5. Create the Compiere Database

1) Create the Compiere database by running the script COMPIERE_HOME/utils/RUN_ImportCompiere.sh.

2) Notice the process begins.

3) Once the script finishes, the

database will be in place.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 8
COMPLETE SERVER SETUP

6. Start the Compiere Application Server

1) You can now start the JBoss based Compiere Application Server via RUN_Server2 in the
$COMPIERE_HOME/utils directory.

2) There should be no errors. Check the logs in $COMPIERE_HOME/jboss/server/compiere/logs to verify this.

3) Common problems include ports already in use

17:41:09,085 ERROR [NamingService] Could not start on port 1099

java.net.BindException: Address already in use: JVM_Bind
at java.net.PlainSocketImpl.socketBind(Native Method)
There is another program using port 1099; Stop it and restart Run_Server2 or setup Compiere to use
another port in RUN_setup.
Likely port conflicts:

• 80 - You have some other web server running (or you need privileges under Linux/Unix)
• 8080 - The Oracle Database uses that
• 1099 - Often used by IDEs for debugging

START COMPIERE

7. Start the Compiere Client

1) You can now start the Compiere Client via RUN_Compiere2 in the $COMPIERE_HOME directory.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 9