Chapter 3 Creating and Configuring Servers

Operating system configuration

Configuring environment variables

1. Create a user_setenv.bat (Windows) or user_setenv.sh (UNIX) file in EAServer's bin subdirectory.
2. Edit the file and set environment variables such as CLASSPATH, BOOTCLASSPATH, or BOOTLIBRARYPATH here. The file is read when you start the server.

Setting the BOOTCLASSPATH and BOOTLIBRARYPATH variables

When you are running EAServer with JDK 1.2 or later, you may need to edit the BOOTLIBRARYPATH and BOOTCLASSPATH environment variables. You can set these variables in the user_setenv.bat or user_setenv.sh file.

1. 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.
2. Set BOOTCLASSPATH if your EAServer components require Java classes that are not in the standard 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 EAServer Programmer's Guide for more information.

Setting the JAGUAR_RANDOMSEED variable

EAServer 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 UNIX machines, EAServer accesses the process, virtual memory, and network statistics. On Windows, EAServer accesses the contents of the HKEY_PERFORMANCE_DATA Registry entry. If this Registry entry does not exist on your machine, you do not need to add it. You can set the JAGUAR_RANDOMSEED variable to improve EAServer 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, EAServer 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, EAServer obtains seeding data by calling a sequence of system routines to obtain performance data.

To set JAGUAR_RANDOMSEED:

1. 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 EAServer.
2. Create a new system environment variable called JAGUAR_RANDOMSEED and set its value to the full path of this file.
3. Restart the server.

Copyright © 2002 Sybase, Inc. All rights reserved.