|
If you are having a problem with the installation please follow the
diagnostic procedure below. This should help to isolate the problem.
UNIX diagnostic procedure
Windows diagnostic procedure
Open a Unix shell and enter the command:
> jostraca -check
1. Jostraca not found
If you see the error message:
jostraca: No such file or directory
or
jostraca: Command not found.
then the jostraca shell script is not in your
$PATH. Repeat step 3 of
the installation instructions.
To view the folders in your $PATH, run
> echo $PATH
at the shell prompt. The jostraca shell
script should be located in one of these folders. If the setup
program does not place the jostraca shell script into a
folder in your $PATH then you will have to do this
manually.
2. Permissions
If you see the error message:
jostraca: Permission denied
then the jostraca shell script does not have execute permission.
To view the execute permission of the jostraca shell
script, run
> ls -lisa jostraca
at the shell prompt. Make
sure you are in the folder containing the jostraca shell
script. You can find this folder by running one of the following
commands:
> which jostraca
> locate jostraca
> find / -name jostraca -print
To give execute permission to the jostraca shell script,
use a command such as:
> chmod a+rx jostraca.
3. Class not found
If you see the error message:
Exception in thread "main" java.lang.NoClassDefFoundError: org/jostraca/Jostraca
then the jostraca.jar file is not in the class path
specified by the jostraca shell script.
Repeat step 3 of the installation
instructions, and look for the line beginning "Created
...". This will tell you where the jostraca shell
script has been placed. Open the jostraca shell script
file in a text editor and make sure that the class path specified
(with the option -cp to java) is correct
and contains a valid path to the jostraca.jar file.
4. Configuration not found
If you see the error message:
PROBLEM DESCRIPTION: System Configuration file '***/jostraca/conf/system.conf' does not exist.
then the jostraca shell script does not specify the
location of the jostraca distribution correctly.
Repeat step 3 of the installation
instructions, and look for the line beginning "Jostraca home folder:...".
This will tell you where the jostraca shell script thinks the Jostraca distribution
folder is. Open the jostraca shell script
file in a text editor and make sure that the argument to the -f option
specifies the location of the conf/system.conf file correctly.
The jostraca distribution folder should appear prefixed to 'conf/system.conf'.
5. Java not found
If you see the error message:
java: No such file or directory
or
java: Command not found.
then the Java programming language is either not installed, or the java
program cannot be found in your $PATH. Install Java and make sure that
it can be found on the command line by running:
> java
6. None of the above.
See below for further help.
Open a command prompt and enter the command:
> jostraca -check
1. Jostraca not found
If you see the error message:
The name specified is not recognized as an
internal or external command, operable program or batch file.
then the jostraca.bat batch file is not in your
%PATH%. Repeat step 3 of
the installation instructions.
To view the folders in your %PATH%, run
> echo %PATH%
at the command prompt. The jostraca batch
file should be located in one of these folders. If the setup
program does not place the jostraca batch file into a
folder in your %PATH% then you will have to do this
manually.
2. Class not found
If you see the error message:
Exception in thread "main" java.lang.NoClassDefFoundError: org/jostraca/Jostraca
then the jostraca.jar file is not in the class path
specified in the jostraca.bat batch file with the -cp
option to java.
Repeat step 3 of the installation
instructions, and look for the line beginning "Created
...". This will tell you where the jostraca.bat batch
file has been placed. Open the jostraca.bat batch file
in a text editor and make sure that the class path specified is
correct and contains a valid path for the jostraca.jar
file.
4. Configuration not found
If you see the error message:
PROBLEM DESCRIPTION: System Configuration file '***\jostraca\conf\system.conf' does not exist.
then the jostraca batch file does not specify the
location of the jostraca distribution correctly.
Repeat step 3 of the installation
instructions, and look for the line beginning "Jostraca home folder: ...".
This will tell you where the jostraca.bat batch file thinks the Jostraca distribution
folder is. Open the jostraca.bat batch file
file in a text editor and make sure that the argument to the -f option
specifies the location of the conf\system.conf file correctly.
The jostraca distribution folder should appear prefixed to 'conf\system.conf'.
5. Java not found
If you see the error message:
'java' is not recognized as an internal or external command,
operable program or batch file.
then the Java programming language is either not installed, or the java
program cannot be found in your %PATH%. Install Java and make sure that
it can be found on the command line by running:
> java
6. None of the above.
See below for further help.
If you would to submit a question or report a mistake in
the installation instructions, or a bug in the setup program, please
send an email to: install@jostraca.org
Thanks!
The Jostraca Team
|
