[xngr-user] FAQ: Start-Up Problems

[Edwin D. <eda...@cl...>]

Hi,

An overview about what to do when the eXchaNGeR browser does not run
immediately 'out of the box'.

Make sure you know the error message! For Windows users this means to run
xngr.bat from the command-prompt.

ERRORS:
-------
[1] Java cannot be found.
[2] -jar: illegal argument.
[3] Exception in thread main" java.lang.NoClassDefFoundError: ???
[4] Exception in thread "main" java.util.zip.ZipException: ???


[1] Java cannot be found.
-------------------------
1) Add the java installation directory to your path, to avoid
   the same problem with other Java programs.
   Goto [Control Panel - System] or change the .cshrc or
   .profile file for Linux/Unix users.
2) Or change the xngr.bat / xngr.sh file to point directly to
   the java installation directory.
   [JAVA_DIR]java -Djava.security.policy=policy -jar xngr-browser.jar

   Where the java directory could be:
   [JAVA_DIR] = c:\jdk1.4\bin\


[2] -jar: illegal argument
--------------------------
The -jar argument is standard since JDK 1.2.2, the currently installed
version must be an older version of Java, to test this, try typing
"java -version" on the command-line.

To solve this, install a newer version from the SUN website:
http://java.sun.com/j2se/1.4/

If a newer version is already available, make sure to point the PATH to the
correct JDK! See [1]


[3] Exception in thread "main" java.lang.NoClassDefFoundError: ???
------------------------------------------------------------------
The problem is that the eXchaNGeR application can't find some of its library
(.jar) files.

Make sure when unzipping the setup file to keep the same directory structure
as in the original zip file!

To check wether this is the case, go to the xngr installation directory and
find out if there is a directory called lib. All the .jar files except for
the "xngr-browser.jar" should be in this directory. If the directory does
not exist or the .jar files are not in the lib directory, install the
eXchaNGeR application again.


[4] Exception in thread "main" java.util.zip.ZipException: ???
--------------------------------------------------------------
The xngr-browser.jar file cannot be found!

This can happen when the xngr.bat / xngr.sh file is not invoked from the
eXchaNGeR installation directory.

1) Make sure the xngr-browser.jar file is available,
   if not reinstall the xngr application.
2) Invoke the xngr.bat / xngr.sh file from the eXchaNGeR
   installation directory! (make sure the working
   directory is set correctly for a Windows shortcut!)


Hope this solves some of your problems,
Edwin