General Installation of Opentaps

General Installation of Opentaps

Installing opentaps ERP + CRM is fairly easy, and you do not need root user privileges. These instructions will help you get started running opentaps ERP + CRM on both Unix/Linux and Windows operating systems.

Prerequisites

The first step is to make sure that you have the correct Java Virtual Machine installed. For opentaps 0.8.x and 0.9.x, you must use Java 1.4.2. For opentaps 1.0.x, you must use Java 5. opentaps 1.4 works with both Java 5 or Java 6. In both cases, you must use the Sun Java SDK, not GNU gcj which may have been supplied with Fedora Core or Ubuntu or the Java Runtime JRE supplied with Windows.

To determine what version of Java you are using, type the following command:

$ java -version

For opentaps 0.8.x and opentaps 0.9.x, you must see something like this: Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_xxxx)

For opentaps 1.0.x, you must see something like the following: Java(TM) 2 RuntimeEnvironment, Standard Edition (build 1.5.xxxx)

You must not see anything like gij (GNU libgcj) version 4.0.1 20050727 (Red Hat 4.0.1-5)

or anything that says "JRE".

If you do not see the correct JVM, you must go download it from Sun.

Next, you should unzip the opentaps ERP + CRM .zip file you have just downloaded and go into the directory where it is unzipped:

$ cd opentaps

Starting on Unix/Linux

If you are using a Unix/Linux system, you should make the startup scripts executable:

$ chmod u+x startofbiz.sh $ chmod u+x stopofbiz.sh

IMPORTANT: If your system already has gcj and you just installed new Sun JVM, you must tell opentaps ERP + CRM to use the Sun JVM instead of the GCJ JVM in /bin/java by specifying where the JVM is:

$ export JAVA_HOME=/usr/java/j2sdk_xxxx/

(or whichever directory your Sun JVM was installed.) You can even put this directive into startofbiz.sh and stopofbiz.sh

To start the opentaps server,

$ ./startofbiz.sh

The server is started as a background process, and the logs are piped to a file called "console.log" in the logs/ sub-directory for opentaps 0.8.x and 0.9.x and runtime/logs sub-directory for opentaps 1.0.x To see the logs,

$ tail -f runtime/logs/console.log

or

$ tail -f logs/console.log

To stop the opentaps ERP + CRM server,

$ ./stopofbiz.sh

To start the Point Of Sales terminal, instead of using startofbiz.sh and stopofbiz.sh, use

$ java -jar ofbiz.jar -pos

Starting on Windows

IMPORTANT: If you are using Windows, you may run into problems with having paths with directories that have spaces in the name, such as "C:\Documents and Settings". You can avoid these problems by unzipping in your C:\ directory.

IMPORTANT: opentaps ERP + CRM runs as a server on your computer and needs to access a number of ports. If you are having start up problems, try re-configuring or temporarily disabling your firewall.

If you are using Windows, call up a command line terminal (Windows > Run Program > "cmd") From the terminal, go to your opentaps ERP + CRM directory

C:> cd c:\opentaps

You may need set a variable called JAVA_HOME first to tell Windows where Java is located:

C:> set JAVA_HOME=c:\java_x.x.x

Or which ever directory Java was installed in.

Now run the batch file to start the opentaps ERP + CRM server:

C:\opentaps> startofbiz.bat

The server will run in the terminal. Alternatively, you can create a Windows shortcut to the startofbiz.bat and place it on your desktop.

If you want to start the Point Of Sales system, use this command instead:

C:\opentaps> java -jar ofbiz.jar -pos

Mac OS X Users

A recent update to OS X 10.4.6 has made Java 5 the default JVM. To use Java 1.4.2 for opentaps 0.8.x or 0.9.x, set your JAVA_HOME to the correct path:

$ export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.4.2/Home

You can also use /Applications/Utilities/Java/J2SE 5.0/Java Preferences.app to set your preferred Java environment.

Accessing the Server

To access the opentaps ERP + CRM server, open any browser and type in the following:

   * For version 1.4: http://localhost:8080/opentaps
   * For version 1.0 and earlier: http://localhost:8080/

With opentaps 1.4, you will see a greeting page which prompts you to login. The applications you can access are displayed as icons:

In earlier versions of opentaps, you will see a menu in your browser which shows you all the applications available.