Getting Started-JetNet

Appendix B. Troubleshooting

This section describes problems you might encounter when setting up the Panther environment, or when running Panther, and tells you where to look for more information.

Error Files

The following files are used to record errors in the various Panther components. If you have problems during the setup procedure, check the directory from which you run the tutorial (proltut) for the existence of any of the files below and check its contents.

If these files provide no clear direction, contact Prolifics Technical Support Services.

Setup and Connection Problems

This section describes some of the more common areas where you might encounter problems while setting up the Panther environment or using Panther, and provides hints for resolving them. If you need more assistance, contact Prolifics Customer Support.

Starting the application or servers

Booting the application

If you are unable to boot your application with rbboot (indicated by a FAILURE message), check the ULOG.* file in the proltut directory. Usually, a failure at this point indicates inadequate IPC resources. If the ULOG indicates IPC resource errors, refer to the JetNet Guide/Oracle Tuxedo Guide for more information.

If only the server running the proserv executable fails to start, check the stderr and stdout files.

Before attempting to restart the application, you need to shut down the servers, even if you received errors, by typing (in the window in which you ran rbboot):


This utility shuts down the Panther application, including all active servers.

Activating a server

If you are unable to activate an application server using the JetNet Manager, check the following files in your proltut directory on the server, in the order in which they are listed:

stderr, stdout, and ULOG.*.

Setting up the Web application server

If you are unable to start the Web application server from your Web browser, check the files ULOG.* and error.log in the proltut directory.

If you have any problems that require changes to the proltut.ini file, or if error.log contains an error message indicating that you failed to connect to the server, you must stop and restart your Web application server to have the changes take effect. Shut down the server by typing:

$SMBASE/util/monitor -stop proltut

Starting the client

Starting a UNIX client

If you are unable to start a Panther client workstation when typing prodev at the command line, make sure you have applied the client environment settings to the current window by typing:

. ./

Connecting the client

Connecting to the server remotely

If you receive an error message when you attempt to connect to the middleware from a PC client and cancel out of the Connect dialog, the editor workspace opens but you are not connected to the server. Check that the application and its servers are running and if not, start them up using rbboot. Once they have successfully started, choose FileOpenMiddleware Session in the editor. You will also need to open the remote libraries and remote repositories.

Connecting to the server locally

If you attempt to open a middleware session on a local UNIX client and receive the message that the TUXCONFIG file does not exist, most likely your SMRBCONFIG setting does not exactly match the Local JetNet Configuration File value in JetMan. The usual cause of this is that the value of SMRBCONFIG in contains a symbolic link as part of your home directory location, and that JetMan used the actual disk location.

Accessing remote libraries