Difference between revisions of "Application Server Installation & Setup"

Revision as of 21:46, 7 May 2007

README

• Further requests for assistance please direct to the HELP Forum. This wiki provides only written and publishable support.
• Further private, local, or commercial assistance can be sought at World-wide Directory where consultants all over register themselves. The fee charges are up to the respective consultants and under their own responsilibity or control.
• Please adhere to our bazaar etiquette to enjoy better support from us.

Introduction

• This Install Server HELP is for setting up the Application Server as in a Client-Server System.
• It allows Clients from remote PCs connected to the server to run the ADempiere Application within a network. You can Create ADempiere Database after this.

Pre-requisite Utilities

Before starting with the installation, you should have the following installed:

• Java JDK1.5.x
• Database (i.e. Oracle 10g, Oracle 10gXE, PostgreSQL)

Start

• Delete existing jboss sub-directory
• Download and extract the current distribution file ADempiere*.zip

Note: In the example we extract it to the main drive C:\, so ADEMPIERE_HOME will be C:\Adempiere

Setting Up The ADempiere Server

You can repeat this step anytime until everything is correct, but make sure that the Application Server is shut down before you start. Otherwise you will get port errors during installation. You shut down the Application server by running the script RUN_Server2Stop.[sh|bat] from ADEMPIERE_HOME/utils.

• Run the script RUN_Setup, located at Adempiere directory. Then you can see the ADempiere Server Setup window:

Enter or update the parameters; if you need help with the meaning of them, press the Help button.

Some Common Issues & Remedies

• Application Server * Database Server is the name, URL or IP of your server PC.
• JNP Port = 1099 error means that a previous service is running. Kill it.
• Database Port = 1521 error can be solved by restarting DB machine.
• System & Database Passwords are those defined when you setup your Database.
• Mail Server is optional. RUN_Setup can still finish without it.

After you fill it, press the Test button in order to verify them. Please note until the parameters are verified, you will not be able to save them. If an entry cannot be verified, a pop-up window stating the error will be displayed. Fix it and test again. By example, the Application Server name is wrong, then you will see a message such as:

When you can see the test was ok (you can see the boxes checked: √ ) ,

• then press the Save button.
• After you accept the license, you will see the dialog:

• Press the OK button to continue and take a look into the log. Make sure that you see the BUILD SUCCESSFUL and Done, such as:

     [echo] AppsDeployment= C:\Adempiere\jboss\server\adempiere\deploy
     [copy] Copying 1 file to C:\Adempiere\jboss\server\adempiere\deploy
     [copy] Copying 1 file to C:\Adempiere\jboss\server\adempiere\deploy
     [copy] Copying 1 file to C:\Adempiere\jboss\server\adempiere\deploy
     [copy] Copying 1 file to C:\Adempiere\jboss\server\adempiere\deploy

 setupTomcat:

 setupDeploy:
     [echo] AppsDeployment= C:\Adempiere\jboss\server\adempiere\deploy

 setup:
 
BUILD SUCCESSFUL
Total time: 2 minutes 22 seconds

*** 2006-12-28 14:15:35.53 Adempiere Log (CLogConsole) ***
ErrorLevel = 0
===================================
Setup Client Environment
===================================
SET ADEMPIERE_HOME=C:\Adempiere
SET JAVA_HOME=c:\Archivos de programa\Java\jdk1.5.0_05
Path is OK = c:\Archivos de programa\Java\jdk1.5.0_05\bin;C:\Archivos de programa\Java\jdk1.5.0_05\
bin;C:\oraclexe\app\oracle\product\10.2.0\server\bin;%SystemRoot%\system32;%SystemRoot%;
%SystemRoot%\System32\Wbem
Created Shortcut Adempiere.lnk
Created Shortcut Adempiere Web Site.url
Done
.
For problems, check log file in base directory

If something is wrong, you can repeat this step anytime until everything is correct. It has no impact on a running or live ADempiere system.

Other Common Issues

Java Home Error

If you receive the following message:

You should check your java environment variables. Maybe you must set the JAVA_HOME system environment variable.

Web Port 80 Error

If you receive the following message from the installer:

Maybe you have some other web server running (or if your are using Linux you need privileges). The default ports are: 80 for http connections and 443 for SSL connections. The message that you got, means that user is not allowed to use those ports (maybe those are used), so they need to be changed. WebPort 8088 and SSL 4443 are recommended. If you are using Linux, remember that ports under 1000 need root privileges. If you are using Oracle database, port 8080 might be used.

JNP Port 1099 Error

Another possible error is Server Setup Error Error JNP Port (Not correct: JNP Port = 1099) OK

If you recieve an JNP Port = 1099 error it might be caused by another process already attached to that TCP port. Take a look what process is using this port and so you can take steps to stop it.

JNP Name Not Found Exception

This error is usually related to a dns problem, it is possible to complete the setup using ip adresses when installing with postgresql. Make sure you have a working dns environment. If you should not have a dns server, you can always add an entry in /etc/hosts(linux) or %SystemRoot%/system32/drivers/etc/hosts(windows).

Links

• Create ADempiere Database is the next thing after Install Server.
• Install Client is the Client-Server client install the next thing after Database setup.
• Initial Client Setup is the starting business setup within ADempiere.
• Installing ADempiere Tutorial on how to setup and configure ADempiere.
• Tutorials on many things from basic to advanced.