Running the Unwired Orchestrator Server in Java Debug Mode

This topic describes how to enable the JPDA (Java Platform Debug Architecture) interface in EAServer to allow debugging of Java Services that are deployed to the Unwired Orchestrator runtime environment.

To configure remote Java debugging in Unwired Orchestrator:

Start the Unwired Orchestrator server. Choose from the following:
- Starting the Unwired Orchestrator Developer Edition Server
- Starting the Unwired Orchestrator Production Edition Server
Start EAServer Manager. Choose from the following:
- Selecting the shortcut Start|Programs|Sybase|Sybase WorkSpace|EAServer 5.3|EAServer Manager
- Running jagmgr.bat, located in the DevRuntimes\EAServer\bin subdirectory of your Sybase WorkSpace installation
Connect to the server by choosing Tools | Connect | EAServer Manager. The table below describes the default connection settings. You can change these settings as described in the EAServer System Administration Guide.
EAServer Manager default connection settings
Setting Value
Host Name The name of your machine.
Port 9000
User Name jagadmin
Password None.
Configure the JPDA port for the server. Display the Jaguar server properties by:
1. Expanding the Servers node.
2. Right-clicking the Jaguar server icon and choosing Properties.
On the Java Debug tab, select Use JPDA and enter the number of a free port for the JPDA connection. Click OK to apply the change.
Restart the Unwired Orchestrator servers in debug mode as follows:
1. Shut down the Unwired Orchestrator servers. Choose from the following:
  - Stopping the Unwired Orchestrator Developer Edition Server
  - Stopping Unwired Orchestrator Production Edition Server
2. Start the Jaguar server in debug mode. Open a command window in the DevRuntimes\EAServer\bin directory of your Unwired Orchestrator installation, then run this command:
```
serverstart -jdk14 -debug
```
  The -jdk14 option specifies that the server use version 1.4 of the Java Development Kit, which is required to support Web services. The -debug option enables support for remote debugging.
3. Verify that a message like this appears in the console output, with the JPDA port number that you configured:
```
Listening for transport dt_socket at address: port
                        
                              
```
4. Restart the Unwired Orchestrator servers. Choose from the following:
  - Starting the Unwired Orchestrator Developer Edition Server
  - Starting the Unwired Orchestrator Production Edition Server
    The start-up script detects that EAServer is already running and starts the other servers required for the runtime environment.

Setting	Value
Host Name	The name of your machine.
Port	`9000`
User Name	`jagadmin`
Password	None.

Debugging a Java Service

See Chapter 3, "Creating and Configuring Servers," in the EAServer System Administration Guide under the Sybase WorkSpace Server Administration collection.