Troubleshooting

Description

Here we will provede hints for setting your aglet server.

Platform independent issue:

Most of the troubles on initial setting of Tahiti are related to the setting of its environment variables.

I can't send any agent to another server.

Check if your machine successfully converts the host-name into an Internet address. (You can use the ping command for this test.)

Fail to dispatch

When I tryed to send an aglet from a server to anther server, I get a RequestRefusedException with a code of 400. Could explain the details about this message? Here's a screen dump:

 ----START
 |
 code = 400
 message :
 Dispatch : Fail to dispatch XXXXX to
 atp://host.domain:9000/
 com.ibm.aglet.RequestRefusedException:  ERROR
   at com.ibm.aglets.LocalAgletRef.dispatch(LocalAgletRef.java:1227)
   at com.ibm.aglets.SystemMessage.handle(SystemMessage.java:131)
   at com.ibm.aglets.AgletThread.run(AgletThread.java:91)
 ----END

This is caused by a "class not found error" at the destination host. The situation was a little bit confusing.

Your aglet brought some objects which classes were defined by yourself, not system classes. (call one of that "MyClass")
At the source host, the CLASSPATH of agletsd contained a path to "MyClass".
But "MyClass" was not placed at the destination host.

In this situation, aglets runtime does not send the class "MyClass" along with the marshalled aglet object. Aglets does not send classes loaded from the system classpath (CLASSPATH). During the unmarshalling at the destination host, a "class MyClass was not found exception" will be thrown, and that error will be reported to the sender as you received.

To avoid this error,

Place the class "MyClass" on the CLASSPATH or the ALGET_EXPORT_PATH of all aglets hosts.
Or, Remove the path to "MyClass" from the CLASSPATH. And add the path to AGLET_EXPORT_PATH.

Windows related issue:

If you are using Windows/95 or Windows/NT, check whether you have properly set the CLASSPATH and other environment variables.

What is the meaning of the "out of environment space" error message in the Windows environment?

Environment variables are set in agletsd.bat. If there is not enough memory for the environment variables, the above message will appear.

You have at least two possible ways of extending the memory space:

Change the size of the argument of the /E: parameter for command.com in the config.sys shell setting. For instance, set of the size of environment variables to 512 bytes, specify.
```
   SHELL=C:\COMMAND.COM C:\ /P /E:512 
```
Change the initial size of the environment variables by accessing the property->memory menu for the MS-DOS prompt.

Tahiti complains that environment variable is not specified.

In Windows environment, you should execute "Aglets Server" from the menu Start->Program. Otherwise, you must set at least three environment variables, AGLET_HOME, JAVA_HOME, and HOME.

HOME is a variable for specifying user home directory. Aglets server store its parameters under HOME directory.

   AGLET_HOME = d:\Aglets1.0.3
   JAVA_HOME = d:\jdk1.1.6
   HOME = c:\

Unix related issue:

Bugs in Solaris JIT Compiler

Solaris JIT Compiler has a bug. Because of the bug. Aglets...