Chapter 1 Getting Started

Starting the Jaguar server

Before you can develop EAServer applications, you must start the preconfigured Jaguar server.

Starting the preconfigured server in Windows

If the preconfigured server is not installed as an NT service, you can start it using the Windows Start menu, under Start | Programs | Sybase | EAServer 4.1.1. Choose one of these options:
- Jaguar Server - starts the server using JDK 1.3 and the Java HotSpot Client virtual machine (VM).
- Jaguar Server (JDK 1.2) - starts the server using JDK 1.2 and the Java HotSpot Server VM.
- Jaguar Server (debug) - starts the debug-mode server using JDK 1.3 and the classic Java VM.
- Jaguar Server (debug JDK 1.2) - starts the debug-mode server using JDK 1.2 and the classic Java VM.

Slow server start-up The HotSpot Server compiler precompiles classes into memory at server start-up time. You should expect heavy CPU usage as the server starts, and the server may take longer to boot.

Starting the preconfigured server in UNIX

Add the location of the X-Windows xterm utility to your path variable. For example:
```
set path = ($path /usr/local/SUNWmotif/bin/)
```
Edit the $JAGUAR/bin/setenv.sh shell script. Change the JAGUAR variable to the EAServer home directory.

You can run the Jaguar server in different modes, debug and normal, using different Java runtime versions and different Java VMs. Change to the $JAGUAR/bin directory and run the serverstart.sh script using this syntax:

serverstart.sh [-jvmtype classic | client | server] [-jdk12 | -jdk13] \
               [-debug] [-xterm]

Option	Description
-jvmtype [classic \| client \| server]	Specify which Java VM to use: Classic - classic Java VM Client - HotSpot Client VM Server - HotSpot Server VM On Solaris, if you use JDK 1.2, you must run the classic Java VM; if you use JDK 1.3, you can run either of the HotSpot VMs.
-jdk12 \| -jdk13	Specify the JDK version; the default is 1.3.
-debug	Run the server in debug mode.
-xterm	Run the server in a new window opened by xterm.

When you run serverstart.sh without any options, the Jaguar server runs with JDK 1.3 and the HotSpot Client VM.

Debug servers Debug-mode servers allow you to remotely debug components from tools that support EAServer component debugging, such as PowerBuilder or PowerJ. You cannot run the debug-mode server unless you installed the debug libraries and binaries. The debug server cannot run as an NT service.

To start a user-defined server, you must first create the server. For instructions, see "Creating or deleting a server".