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 – Enterprise DB - Linux System

Compiere ERP & CRM - Installation Instructions – EnterpriseDB 3

Prerequisites 3
Database Installation 3

Compiere 3.0 New Installation Instructions 8

Java Installation 8
Edit the Path 8
Download Compiere 8
Complete Server Setup 13
Start Compiere 13

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 2
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
- Network set up with DNS server and a domain

Database Installation
1. Install Database – this document will use EnterpriseDB 8.2.

1) First, Log on with root permissions.

2) Get the EnterpriseDB Advanced Server 8.2 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 (e.g. edb-linux-x86_82412.bin).

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

Hint: 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 appropriate license type.

11) Select the Next button to continue.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 4
 12) Select the Oracle Configuration
(aka Redwood).
13) Select the Next button to continue.

14) Select the destination folder by

selecting the Browse button.

Hint: This document will assume

that root is the selected directory.
15) Select the Next button to continue.

16) Accept the default selections for

EnterpriseDB features and select
the Next button to continue.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 5
 17) Review the Instructions for Oracle
Client Connectivity.
18) Select the Next button to continue.

19) Enter and confirm a User ID and

Password for the System
Administrator.
20) Then select the Next button to
continue.

21) Enter and confirm a Password for

the Database Administrator.
22) Validate the location of the data
destination and WAL directories.
23) Then select the Next button to
continue.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 6
 24) Select the appropriate option
depending on the resources
available on the database server.
25) Select the Next button to continue.

26) For the Advanced Options, accept

the default options if applicable.
27) Then select the Next button to
continue.

28) Review the Installation Settings.

Select the Back button to make
changes if necessary.
29) If the Installation settings are
correct, select the Install button to
start the Installation.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 7
 30) When the Installation is complete,
the following confirmation window
will display:
31) Check the Launch Developer Studio
Option and select Finish to
complete the Installation.

32) Once the Developer Studio opens, enter the Database Administrator User ID and Password used in step 19.
Hint: This confirms the Database Installation.

Compiere 3.0 New Installation Instructions

Java Installation
1. Download and install Sun Java 1.5.0 (SDK) – also known as Sun Java JDK, Update 12, or a later version.
Tip: The Compiere Server requires the SDK (not just JRE).

Edit the Path

2. Add EnterpriseDB into the environment variable PATH
(e.g./opt/EnterpriseDB/8.2/dbserver/bin)

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

1) Download the current version of Compiere: Download Compiere. (3.0 or higher)

2) Extract the .zip file. The steps shown assume that you extract to the root directory, resulting in a
COMPIERE_HOME of C:\Compiere2 in Windows or \Compiere2 in Linux.

3) Verify that the bin directory for your database executables is included in the PATH. Also, if using Oracle XE on
Linux, run $ORACLE_HOME/bin/oracle_env.sh

4) Execute the script $COMPIERE_HOME/RUN_Setup.

Note: if the following window does not display, please ensure that the following are updated.

• Add the folder where you have installed JKD 1.5 at the beginning of the PATH system environment
variable.
• Set the JAVA_HOME system variable to the location of your java installation (e.g., ‘C:\Program
Files\Java\jdk1.5.0_12’)
• Set the COMPIERE_HOME system variable to the path of your Compiere installation (e.g.,
‘C:\Compiere2’)

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 8
 5) Select Database Type of
postgreSQL.
6) For System Password use
the Database System user
password, (part 1, step 19).

7) For Database Password,

use ‘compiere‘ (or any
password.)’

8) For Server Names, i.e.,

(Application, Database and
Mail) use the DNS name of
the server. Hint: Do not use
localhost (127.0.0.1) or IP
address.

9) Enter or update any other

Parameters as necessary.

10) Select the Help button, for

information on any field.

11) Select the Components to install. Compiere Core 3.0 is the main component that must always be installed,
but you may choose additional components provided by Compiere or any of our authorized partners.

Note: install additional components after you have already installed or migrated to the latest Compiere Core version, you
must select the Compiere Core component plus any additional components that you wish to install, and then run Migration. 

12) Select the Test button to

check the parameters.
Tip: Parameters must be
verified in order to save.

13) If an entry is unverifiable, it

will display with a red X.
Correct the entry and re-
select Test/Save.

14) Once all fields are verified,

click the Save button to
proceed.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 9
 15) At the prompt enter your company information as appropriate and verify that the common name is the address
of your application server. Once all fields are complete, click ok to continue.

16) Next, read and accept the license agreement.

Hint: You might get more than one license agreement, depending on the components that you are installing.

17) A default security key will be generated, click ‘Ok’ to continue.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 10
 18) After accepting the license agreement the following window will display:

19) Select Start Server Install.

20) Once the Server install is complete, select Create New Database.

Note: If you already have a Compiere database in your system, you will be presented with a split panel after ‘Start Server
Install”. Click the left panel if you want to replace the existing database with the new database. 

Warning: If you choose to replace the existing database, all data in the existing database will be removed.

21) Verify that you see a ‘Build Successful’ and ‘***Finished’ message at the end of this step.

LICENSE VALIDATION
If you only intend to use the Open Source Edition of Compiere 3.0, you may skip steps 21 and 22.

For customers with a valid support contract with Compiere, this is a required step to ensure that the features
associated with the support level are enabled. If you are a customer and do not have a web store login,
please contact your system administrator or Compiere Support first. If you are not a customer and would like
to obtain a trial license for the Professional Edition, use the following steps to register with Compiere:

- Go to www.compiere.com/wstore, and click Login.

- If you are a new user, click ‘New User’ and provide the required information.
- Then Login to the web store. If you are a new user you will have to validate your e-mail address by providing
the validation code that was sent to your email inbox.
22) Provide the following information exactly as it was registered in the Compiere Web store and click Check
License to validate your asset information.

- System Name (name provided in the web store registration)

- Registered Email (email address provided in the web store registration)
- Password (web store password)
Tip: During the Next steps, do not click Start Migration; simply Check License and Close the window.
Notice that internet access is required to validate the license information.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 11
 23) To verify your license, click the “Check License” button.

24) Next, review that your license information has been validated.

25) After Compiere Professional license has been verified, click the “X” to close the window.

Note: If you get the error “You do not have an appropriate license to use this feature” when starting the web UI, then
login to the server and execute utils/RUN_Support to validate again your license and restart the application server. 

26) Close any additional Setup and /or Support windows.

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 12
Complete Server Setup

4. 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

5. Start the Compiere Client

1) Start the Swing client by double clicking on the Compiere shortcut in your desktop or by executing
RUN_Compiere2 from the $COMPIERE_HOME directory.

Default users and passwords for the sample Garden World application.

- GardenUser/GardenUser - System/System
- GardenAdmin/GardenAdmin - SuperUser/System

Compiere Learning Services Copyright © 2007 Compiere Inc. – All rights reserved 13
 2) Alternatively, if you have access to the Professional Edition, you can launch the application from the browser by
using the URL: http://server:port/apps (e.g. http://mycompany.com:80/apps)

Information: For additional information see the Compiere home page http://www.compiere.com.

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