Compiere ERP & CRM Installation Instructions Linux System - EnterpriseDB

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 10) Select the Redwood Configuration. 11) Select the Next button to 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 14) Accept the default selections and select the Next button to 15) Enter the email and the password defined when registering at www.enterprisedb.com. 16) Then select the Next button to 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 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 22) Select the appropriate option depending on the resources available on the database server. 23) Then select the Next button to 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 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 reselect 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