Tracing Errors in Adempiere and Correcting them!


Errors in Setup

The following errors can be faced while Setup and given are the ways to correct them:

  • Application Server or 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. Also, since this is the first port that is tested, it could also mean that you have a mismatch between your host name (in the hosts file) and your actual IP address. Fix it in “/etc/hosts” (linux)
  • 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.


Java Home Error

The error faced when u click on Test

If you receive the following message:


You should check your java environment variables. Check that the JAVA_HOME system environment variable points to the correct directory. Set the PATH in such case and if everything fails try to install JAVA again. The error should be removed in such case.


Web Port Error

If you receive the following message from the installer:


it is likely that you have some other web server running or, if you are using Linux, you need the appropriate privileges.

The default ports are: 80 for http connections and 443 for SSL connections. This message means that the user is not allowed to use the port, likely because it is already used by another application. Change the port to something else. Web Port 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 JNP Port (Not correct: JNP Port = 1099) OK

The JNP Port = 1099 error can be caused by another process which is already attached to that TCP port. Take a look what process is using this port and so you can take steps to stop it. It can also be caused by a mismatch between your IP address and the entry in your hosts file.


JNP Name Not Found Exception

This error is usually related to a DNS problem. It is possible to complete the setup using IP addresses when installing with PostgreSQL. Make sure you have a working DNS environment or add an entry in /etc/hosts(linux) or %SystemRoot%/system32/drivers/etc/hosts(windows).


Errors Faced in LinuX

  1. When deploying build on Linux and faced any unknown Exception like some java Jar missing in deployment , re install the JAVA as it is the only way out for the problems with the missing JAR’s .

Such Errors are faced due to discrepancy in JRE and JDK of Java, or only JRE is installed and hence error is coming. ReInstall the JAVA and such errors will be removed.

  1. In case of Software on Linux we need to take care that complete commands must be executed i.e rpm must be executed in case of Linux in rpm files and for further commands Google can be referred.
  2. In case of errors faced in the linux Distro stick to the community for genuine Solutions and remedies.
  3. Before Solving or searching for any error make sure that the environment is correct and all the PATH of the variables are correctly set. This can be achieved by the following commands:
    1. Find JAVA version by the following command in linux or windows

                  i.      java –version

  1. Make sure that the JAVA version is greater than or equal to .
  2. If JAVA version is less than mentioned version , make sure that latest version of Java is installed on client system
  3. Once JAVA is installed if we are still getting the version as 1.5.0 or anything else less than 1.6 we need to do the following:

                            i.      IN WINDOWS

  1. Set the path for the latest version of JAVA by right clicking the My Computer and hence changing the variable.

                          ii.      IN LINUX

  1. Go into the directory of new installed JAVA

[root@localhost /]# cd usr/java/jdk1.6.0_45/

  1. Once u are in directory you need to run the following command

[root@localhost jdk1.6.0_45]# alternatives –config java

  1.  This will provide us with all the options of java installed, if the current java i.e the latest version of JAVA is not shown then do the following:

[root@localhost jdk1.6.0_45]# alternatives –install /usr/bin/java java /usr/java/jdk1.6.0_45/bin/java 2

4.   This will give the following screen to us: Select the new version of JAVA here

[root@localhost jdk1.6.0_45]# alternatives –config java

There are 2 programs which provide ‘java’.

  Selection    Command


*+ 1           /usr/lib/jvm/jre-1.5.0-gcj/bin/java

   2           /usr/java/jdk1.6.0_45/bin/java


Enter to keep the current selection[+], or type selection number: 2


  1. Run the following commands after wards to set the JAVA_HOME and PATH Variable

[root@localhost jdk1.6.0_45]# alternatives –install /usr/bin/jar jar /usr/java/jdk1.6.0_45/bin/jar 2


[root@localhost jdk1.6.0_45]# alternatives –install /usr/bin/javac javac /usr/java/jdk1.6.0_45/bin/javac 2


[root@localhost jdk1.6.0_45]# alternatives –set jar /usr/java/jdk1.6.0_45/bin/jar


 [root@localhost jdk1.6.0_45]# alternatives –set javac /usr/java/jdk1.6.0_45/bin/javac 

  1.   If we run java –version now we see the changes in the version and it will give
  2.  In case of all the software which work on JAVA jar files , in case of any error first check the java version and environment variables.
  3. In Order to set Permgen Variable in linux we need to edit the file and run.conf file .In file we need to add the following line after the Ipv4 line.
  4. In order to find the IPv4 line , search IPv4 in file and add the following line after it.

JAVA_OPTS=”$JAVA_OPTS -XX:MaxPermSize=256m”

  1. Once the following line is added in the file then the Perm Size is increased to 256 MB, which prevents the Out of Memory: Permgen Space error.
  2. In case of Setup screen not shown while deploying build, the root cause of such error is invalid java home. Check the JAVA_HOME variable from the error console and correct it.
  3. Such Error can be found in the error console window, cut copy that path and try running on CMD to find the validity of the path.
  4. In such a case Export the JAVA_HOME again and correct the entry.
  5. Do close all the old Console Windows as they will show the old JAVA_HOME, in order to find out whether or not the JAVA_HOME is changed , open a new console and writeecho JAVA_HOME.
  6. While using the Linux Setup do note that in order to run the files, the specified command must be run to make the command run. For e.g.

sh ./<File Name or Process Name with extension>

  1. While running a JAR File like SyncMan , the following command will be used

Java –jar <Filename.jar>

  1. If faced access errors do make all the files executable in linux which can be done by the following command

chmod 0755 *.sh






                -Adempiere Support {India Portal}

About This Author

Post A Reply