JTransit Documentation: Common Error Messages
Contents
Installation Error Messages
Error parsing JSP page /test.jsp Compiler error: sun/tools/javac/Main (Unsupported major.minor version 48.0)
This is due to running Orion with a different version of the JDK than the version of the tools.jar file in the orion root directory. Copy the tools.jar from the new JDK into the orion root dir and restart Orion and the problem should go away.
Syntax error in source /test.jsp.java:28: Class jtransit.core.Env not found. (JSP page line 14)
If you try to execute JSP pages that use the JTransit JSP integration API, your servlet container needs to include the jtransit-runtime.jar file in its classpath. The easiest way to do this is to copy the jtransit-runtime.jar file (and required third-party jar files) into the WEB-INF/lib directory under the webroot that contains the JSP pages. If you start Orion using the included start-orion.bat or start-orion.sh script (in the jtransit folder) all required files are copied for you. The default location of the webroot is in jtransit/webroot, and the jar files get copied into jtransit/webroot/WEB-INF/lib. The test.jsp page is located in jtransit/webroot.
Compiler Error Messages
Illegal start of expression
The problem is most likely a missing end tag, for example a missing </@IF>, </@ROWS>, or </@FOR>. Look at the line number in which the error occurs and you should be able to locate the problem in your code. The error might also be found one line before it occurs.
Failed to load Main-Class manifest attribute from compiler.jar
Several things can cause this error. First, make sure you have the proper JDK version installed by typing "java -version" from a DOS prompt or terminal window; if less than 1.3.1_01, you need to install the correct JDK from java.sun.com. Second, be sure you're in the correct directory containing the compiler.jar file, and that there is a lib subdirectory containing all the required .jar files for the compiler (Acme, jakarta-oro-2.0.3, js, jtransit-runtime, log4j, velocity-deb-1.2, and xerces as of this writing), before typing the command to start the compiler.
If that doesn't help, try starting over. Make sure you follow the following steps exactly as outlined here (these instructions are for Windows only):
- Delete or move the jtransit, tomcat, and orion directories from the ROOT of your C: drive.
- Re-unzip the jtransit-frontline.zip file at the root of C:.
- Make sure you DON'T have ANYTHING in your CLASSPATH environment variable (except maybe BeanHandler.jar for Tango Editor if you need it). You can verify this by typing "echo %CLASSPATH%" at a DOS prompt.
- When you install the JDK on XP it doesn't put "javac" in your PATH, which is required for the JTransit compiler. Add the path to the javac command. You can verify this step by typing "javac" at a DOS prompt; if it doesn't find the command you need to fix your PATH.
- Run FrontLine and fill out the forms again and let it install everything, then just quit FrontLine with CTRL+C.
- Type "java -jar compiler.jar" from the C:\jtransit directory and it should successfully build the jtdc.taf file.
- You should also go to C:\orion and type "java -jar orion.jar -install" to make sure Orion is happy before doing anything else.
If that works, you can move the three directories to any other location you wish, with the caveat that the .bat files in the jtransit directory won't work without modification (they assume everything is installed in C:\). Of course, using those .bat files is optional anyway.
FrontLine Error Messages
When I type "java -jar frontline.jar" I get: Exception in thread "main" java.util.zip.ZipException: No such file or directory
You must be in the same directory as the frontline.jar file and it must be called frontline.jar for FrontLine to start properly using the "java -jar frontline.jar" command. This is usually in the jtransit directory you unpacked from the jtransit-frontline.zip file.
error FL-001: can't startup or reconfigure JTransit FrontLine: can't locate config file: frontline.xml; will check again in 60 seconds
You must be in the same directory as the frontline.xml file and it must be called frontline.xml for FrontLine to start properly using the "java -jar frontline.jar" command. If you want to move the frontline.xml file to a different location and/or rename it, you can specify the frontline.configUrl system property when starting up FrontLine. For example, if your frontline.xml file is called config/fl.xml, you would start FrontLine by typing "java -Dfrontline.configUrl=config/fl.xml -jar frontline.jar".
error: can't configure JTransit FrontLine: java.lang.Exception: error FL-002: You must specify an admin-email value in the frontline.xml config file before using FrontLine. Be sure to configure the correct mailServer parameter as well to point to an operational SMTP mail server, so you can receive important informational emails from this FrontLine instance: reload will be attempted in 60 seconds
This means you must edit the frontline.xml file located in the main jtransit directory. Look near the beginning for admin-email="", and enter your email address between the quotes, as in, admin-email="me@mycompany.com". You should also, as the message states, enter a valid mail server hostname in the mailServer parameter (near the middle of the frontline.xml file). The default setting looks like <parameter param-name="mailServer" param-value="127.0.0.1"/>, so you should change the 127.0.0.1 to the IP address or hostname of your SMTP mail server. Save the file and restart FrontLine or wait until it automatically reloads the changes.
main WARN can't start SMTP server: java.net.BindException: Permission denied
This indicates that you do not have root permission on the server and therefore can't start the embedded SMTP server (part of FrontLine) on port 25. You can solve this in three ways. Either run FrontLine as root, comment out the SMTP server config in the frontline.xml file, or change the port to one higher than 1024 (which doesn't require root access to bind on most systems; this is also done in the frontline.xml file).
main WARN can't start POP3 server: java.net.BindException: Permission denied
See the previous error about inability to start the SMTP server, because the solution is similar. POP3's default port is 110 which also requires root permission to bind.
main WARN can't start FTP server: java.net.BindException: Permission denied
See the previous error about inability to start the SMTP server, because the solution is similar. FTP's default port is 21 which also requires root permission to bind.
Errors on Mac OS X
When starting up Orion I always get "Stack Overflow Error". If I remove the jtransit-runtime.jar file from the WEB-INF/lib directory the problem goes away.
Some versions of the Mac JVM on OS X have this bug in their just-in-time compiler. Starting Orion with the -Xint switch (which makes the JVM run in interpreted mode only) clears up the problem. So use either "java -Xint -jar orion.jar" or "java -server -Xint -jar orion.jar" to start Orion.
|
