Chapter 1 Introduction to Jaguar CTS

Starting Jaguar

Before you can work through the tutorials, run the sample applications, or develop Jaguar applications, you must start the preconfigured Jaguar server.

Starting servers that are not installed as NT services

If the preconfigured server is not installed as an NT service, you can start it using the Windows Start menu, under Start | Programs | Sybase | Jaguar CTS. Choose one of the options below: Jaguar Server -

Starts the normal-mode server using JDK 1.1.
Jaguar Server (JDK 1.2) - Starts the normal-mode server using JDK 1.2.
Jaguar Server (debug) - Starts the debug-mode server using JDK 1.1.
Jaguar Server (debub JDK 1.2) - Starts the debug-mode server using JDK 1.2.

Debug and JDK 1.2 servers Debug-mode servers allow you to remotely debug components from tools that support Jaguar 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.Jaguar can run with your choice of Java runtime engines, including Sun JDK 1.1 or 1.2, or the Microsoft Java Virtual Machine. You must run Jaguar with JDK 1.2 to use the full set of available features. Web applications, Java Server Pages, and EJB 1.1 components require JDK 1.2.

To start a user-defined server, you must first create a server. See "Creating or deleting a server" in the Jaguar CTS System Administration Guide for instructions. Then change to the %JAGUAR% directory, and run one of the following commands, where Server_name is the name of the Jaguar server you want to start:

To start the server in normal mode using JDK 1.1:
```
bin\serverstart Server_name
```
To start the server in normal mode using JDK 1.2:
```
devbin\serverstart_jdk12 Server_name
```
To start the server in debug mode using JDK 1.1:
```
devbin\serverstart_dev Server_name
```
To start the server in debug mode using JDK 1.1:
```
devbin\serverstart_jdk12_dev Server_name
```

Starting servers that are installed as NT services

If a Jaguar server is installed as an NT service, the server is started automatically whenever you start NT. To start a service manually, you can use the Services dialog in the Windows NT Control Panel, as follows:

On the NT desktop, select Start | Settings | Control Panel.
Double-click the Services icon.
In the list of Services, find the name of your Jaguar server (for example, the preconfigured server is "Jaguar"). To stop the server, highlight the server name and click Stop. To start the server, highlight the name and click Start.

You can also run this command in the Jaguar bin subdirectory:

serverstart servicename -start

where servicename is the name of the server. To stop the server, use:

serverstart servicename -stop

Installing servers as NT services

You should install production servers as NT services, so the Jaguar server starts automatically when NT starts. Do not install development servers as NT services, since you will often want to run the debug server on your development machine, and the debug server cannot be run as an NT service.

To install a server as an NT service:

If the server is not running, start it on the desktop.
Start Jaguar Manager and connect to the server using Jaguar Manager. See Starting Jaguar Manager and Security Manager for instructions.
In Jaguar Manager, display the Server Properties dialog box by highlighting the server's icon and choosing File | Server Properties. On the Java VM tab, select the Java runtime to be used by the server.

Some Jaguar features require JDK 1.2 You must run Jaguar with JDK 1.2 to use the full set of available features. Web applications, Java Server Pages, and EJB 1.1 components require JDK 1.2.
Shut down the Jaguar server by highlighting its icon and choosing File | Shutdown.
Depending on which JDK you configured, run one of the following commands in the Jaguar bin subdirectory, specifying the server name in place of server:

For JDK 1.2:
```
serverstart_jdk12 server -install
```
For JDK 1.1:
```
serverstart server -install
```
For the Microsoft Java Virtual Machine:
```
serverstart_msvm server -install
```

To remove a server from the list of NT services:

Run the command:

serverstart servicename -remove

where servicename is the name of the server as displayed in the Services dialog in the Windows NT Control Panel.

Edit service names separately If you delete a server definition in Jaguar Manager after installing an NT service for that server, run the serverstart command to remove the server from the list of services.

Complete syntax for serverstart

This section lists the complete syntax of the serverstartXXX batch files, located in the Jaguar bin subdirectory.

serverstartXXX [ servername [ options ]]

where

XXX specifies the JDK.
servername specifies the name of the Jaguar server to start, as displayed in Jaguar Manager. You must supply a server name if you supply options. If you do not specify any arguments, the default behavior matches the following command, which starts the preconfigured Jaguar server in a console window:
```
serverstart Jaguar -c
```
option is one of:
- -c (the default) starts the server as a console application. You must use this option if you have not installed the server as an NT service.
- -install installs the specified server as an NT Service.
- -remove uninstalls the specified server from the list of NT Services.
- -removeandinstall reinstalls the specified server into the list of NT Services.
- -start starts a server that has been installed as an NT service. When installed as an NT service, Jaguar starts automatically when NT starts. Use this option only after you have stopped or shut down the server.
- -stop shuts down a server that has been installed an NT service. Use this option to restart the server. You can also stop the server using the NT Services dialog in the Control Panel, or from Jaguar Manager.
- -v prints server version information to the console, then exits.

Using the JagRepair server

You can use the JagRepair server when you are unable to start your Jaguar server; for example, if you have specified incorrect Object Transaction Service (OTS) settings which prevents the server from starting and makes it impossible to correct the problem. The JagRepair server is read-only and provided for repair purposes only.

To start and connect to the JagRepair server:

At the command line, enter:
```
 %JAGUAR%\bin\serverstart JagRepair
```
Start Jaguar Manager.
Select Tools | Connect | Jaguar Manager and enter:
- jagadmin as the User Name
- localhost as the Host Name
- 9000 as the Port Number
Click Connect.

Setting the BOOTCLASSPATH and BOOTLIBRARYPATH variables

When you are running the JDK 1.2 Jaguar server, you may need to edit the BOOTLIBRARYPATH and BOOTCLASSPATH environment variables.

Set BOOTLIBRARYPATH if you use Java classes that call native code in DLLs or shared libraries. Add the locations of these DLLs or libraries to the BOOTLIBRARYPATH environment variable. The syntax for setting this environment variable is the same as for setting the PATH variable.

Set BOOTCLASSPATH if your Jaguar components require Java classes that are not in the standard Jaguar locations (the Jaguar html/classes and java/classes subdirectories). For Java components and Web applications, you can also specify classes to be loaded on a per-component or per-Web-application basis. See the Jaguar CTS Programmer's Guide for more information.

Setting the JAGUAR_RANDOMSEED variable

Jaguar requires a random seed to initialize the random number generation used in cryptographic algorithms. The data used as the seed for the random number generation depends on your platform. On NT, Jaguar accesses the contents of the HKEY_PERFORMANCE_DATA Registry entry. On UNIX machines, Jaguar accesses the process, virtual memory, and network statistics. However, you can set the JAGUAR_RANDOMSEED variable to improve Jaguar server performance without diminishing the randomness of the seeding data.

JAGUAR_RANDOMSEED determines the algorithm as follows:

If you set the variable to the name of an accessible file, Jaguar reads this file to obtain random seeding data. Use this technique to avoid using system performance data as the seed. You must specify the name of a file that contains frequently changing contents, such as the access log of a busy server.
If you set the variable to a value that does not match the name of an accessible file, Jaguar obtains seeding data by calling a sequence of system routines to obtain performance data.

To set JAGUAR_RANDOMSEED:

Identify a file that contains suitably random data, such as the access log of a busy server.

The file can contain text or binary data, but the contents should change randomly and often. The file must be accessible from the machine and account that are used to run the Jaguar server.
Create a new system environment variable called JAGUAR_RANDOMSEED and set its value to the full path of this file.
Restart the Jaguar server.