Chapter 2. Installing Jolt

01) alpha/dux40/6.2  02) alpha/dux40/6.3  03) hp/hp1010/6.1    
04) hp/hp1010/6.2    05) hp/hp1010/6.3    06) hp/hp1020/6.1    
07) hp/hp1020/6.2    08) hp/hp1020/6.3    09) ibm/aix414/6.1   
10) ibm/aix414/6.2   11) ibm/aix414/6.3   12) ibm/aix42/6.1    
13) ibm/aix42/6.2    14) ibm/aix42/6.3    15) seq/dynix42/6.1  
16) seq/dynix42/6.2  17) seq/dynix42/6.3  18) sgi/irix62/6.1   
19) sgi/irix62/6.2   20) sgi/irix62/6.3   21) sun5x/sol24/6.1  
22) sun5x/sol24/6.2  23) sun5x/sol25/6.1  24) sun5x/sol25/6.2  
25) sun5x/sol251/6.1 26) sun5x/sol251/6.2 27) sun5x/sol251/6.3 
28) uw/uw21/6.1      29) uw/uw21/6.2      30) uw/uw21/6.3      
Install which platform's files? [01-30, q to quit, l for list]: 22
** You have chosen to install from sun5x/sol24/6.2 **

You are prompted to review the directory containing the BEA Jolt system. If correct, type y for "yes," or n for "no" or q to "quit." Press Enter.

BEA Jolt Release 1.1
This directory contains the BEA Jolt System for
Solaris 2.4 on SPARC
Is this correct? [y,n,q]: y
To terminate the installation at any time
press the interrupt key,
typically <del>, <break>, or <ctrl+c>.

Type BEA Jolt to install the BEA Jolt package. Press Enter.

The following packages are available:

  1	jolt		BEA Jolt
Select the package(s) you wish to install (or 'all' to install
all packages) (default: all) [?,??,q]: 1
BEA Jolt
(sparc) Release 1.1
Copyright (c) 1997 BEA Systems, Inc.
Portions * Copyright 1986-1997 RSA Data Security, Inc.
All Rights Reserved.
Distributed under license by BEA Systems, Inc.
TUXEDO is a registered trademark.
BEA Jolt is a trademark of BEA Systems, Inc.

Type the number of the installation option you prefer. The Jolt Server is installed in an existing TUXEDO directory. You must install TUXEDO prior to installing Jolt.

The following installation options are available:
  1	all		Install the full Jolt System
  2	server		Install the server only
  3	client		Install the client only
  4	rad		Install the relay back-end only
  5	doc		Install the documentation
Select an option (default: all) [?,??,q]: 1
Note that the jolt server will be installed into an existing
TUXEDO directory.  You MUST have previously installed TUXEDO
version 6.1, 6.2, or 6.3 to attempt this installation.
Base directory of existing TUXEDO installation [?,q]: /usr/jolt/T6.2
Determining if sufficient space is available ...
1118 blocks are required
167860 blocks are available to /usr/jolt/T6.2
Using /usr/jolt/T6.2 as the TUXEDO base directory
The client software should be installed either on your web
server machine, or a machine easily accessible to your web
server machine, as the class files must be downloaded.
JOLTDIR below refers to the directory in which your java
related files are stored.  It is the directory which contains
the directory 'classes', not the classes directory itself!
JOLTDIR (default: /usr/jolt/T6.2/udataobj/jolt) [?,q]: 
Determining if sufficient space is available ...
1118 blocks are required
167860 blocks are available to /usr/jolt/T6.2/udataobj/jolt
Using /usr/jolt/T6.2/udataobj/jolt as the Jolt client tree
Unloading /host/sansei/cdrom/sun5x/sol24/6.2/jolt/joltall.Z ...
bin/JREPSVR
bin/JSL
bin/JSH
bin/joutil
bin/JRAD
udataobj/jrep.f16
udataobj/jwsladmin.f32
udataobj/jrepository
udataobj/jolt/client/Atm.html
udataobj/jolt/client/RE.html
udataobj/jolt/client/jolt.zip
udataobj/jolt/client/audio/dot.au
udataobj/jolt/client/audio/ring.au
udataobj/jolt/client/audio/splat.au
udataobj/jolt/client/images/beaLogo.gif
.

udataobj/jolt/relay/jrly
udataobj/jolt/relay/jrly.config
locale/C/JOLT_CAT
locale/C/JOLT.text
locale/C/JRAD_CAT
locale/C/JRAD.text
lib/libjconv.so
lib/libjnwi.so
include/jotypes.h
2280 blocks
... finished

Type your Jolt serial number and press Enter. Type your Jolt license token number and press Enter. The script continues with the installation process until the status message, "Installation of BEA Jolt was successful," displays.

Serial number [?,q]: <enter BEA-provided serial number>
License token [?,q]: <enter BEA-provided license token>
LICUTIL is /usr/jolt/T6.2/bin/joutil
users=0
pbtype=SDK
expdate=9801
serial=<BEA serial number displays>
token=<BEA license token displays>
lictype=a
Activating the license for software in /usr/jolt/T6.2 ...
... finished
Changing file permissions...
... finished
Installation of BEA Jolt was successful

The script returns to the installation prompt. Type q to quit.

The following packages are available:
  1	jolt		BEA Jolt
Select the package(s) you wish to install (or 'all' to install
all packages) (default: all) [?,??,q]: q
Please don't forget to fill out and send in your registration card

When the installation is complete, unmount the CD-ROM.

The installation is now complete.

Windows NT Installation Instructions

The Jolt NT Installer provides a set of step-by-step installation windows to help you quickly install your Jolt product. These windows automate the details of your installation process and prompt you through the entire installation. You can cancel the installation at any time.

If you are installing the Jolt package from a CD-ROM, use Windows Explorer or a similar utility. Select the setup.exe program in the NT directory that matches your platform and TUXEDO version when you insert the CD-ROM. Refer to Figure 2-1 for additional information on the directory structure.

When you see the Welcome window shown in Figure 2-2, select the Next button to proceed with the installation.

Figure 2-2 Jolt Welcome Window
Use the scroll bar or the Page Down key to read the Software License Agreement. To continue with the Jolt installation, you must accept the terms of the license agreement. If you accept the terms, select Yes to continue with the installation. If you do not accept the terms, select No and the installation stops.

Figure 2-3 Software License Agreement
At the User Registration window, type your name and company. Use the Tab key to navigate through the text fields. Select Next after you enter the information.

Figure 2-4 User Registration Window
At the Registration Confirmation window, review the information. If the information is correct, select Yes to continue with the installation. If the information is not correct, select No to return to the User Registration window and change the registration information.

Figure 2-5 Registration Confirmation

At the Installation Selection window, select the modules to install (in this case, Jolt Server, Jolt Client, and Jolt Documentation).

This window also allow you to choose a destination directory. To do this, select Browse and choose a distention path. To continue with the installation, select Next.

Figure 2-6 Installation Selection Window

**Table 2-1 Setup Type Window**
Setup Type...	Installs...
Jolt Server	Jolt server only (review license)
Jolt Client	Jolt client only
Jolt Relay Back-End	Jolt Internet Relay on the back-end server only
Jolt Relay Front-End	Jolt Internet Relay on the front-end server only
Jolt Documentation	HTML-based documentation

The selection works as a toggle. With the mouse, click the left mouse button once to select and once to deselect. Press the Tab key once to highlight and select. Press it again to highlight and select the next item in the list.
To make your selection, click on the space to the left of the text representing your choice. The window displays a checkmark to the left of your selection.

To deselect a component, click on the checkmark to the left of your choice and the checkmark is removed.
To choose a different destination directory, select Browse and choose a destination path.

Note: The destination path must be the TUXEDO directory.

Select Disk Space to check the available and required disk space on a particular drive. Figure 2-7 shows the available disk space. Select OK to continue. Select Cancel to return to the Installation Selection window.

Figure 2-7 Available Disk Space
All Jolt system files are installed in directories relative to the destination directory. Jolt installs all system files in tthe default directory displayed on the window. If the default directory is not the directory that contains your TUXEDO system, change the directory.
In Figure 2-6, Jolt Server, Jolt Client, Jolt Documentation are selected for installation. Figure 2-8 shows the window used to install the first selected module (in this case, the Jolt Server). To change the directory, select Browse or type the directory path. Select Next to continue with the installation.

Figure 2-8 Choose Destination Location Window for Jolt Server
Figure 2-9 shows the window used to install the next selected module (in this case, the Jolt Client). To change the directory, select Browse or type the directory path. Select Next to continue with the installation.

Figure 2-9 Choose Destination Location Window for Client Software
You are prompted to install the final module (in this case, the Jolt Documentation). To change the directory, select Browse or type the directory path. Select Next to continue with the installation.

Figure 2-10 Choose Destination Location Window for Jolt Documentation
When the selected modules are installed, you are prompted to install your Jolt license. The prompt is shown in Figure 2-11.

Figure 2-11 Install License Window
Select Yes to install the Jolt license.
If you are installing Jolt 1.1 for TUXEDO 6.1 or 6.2, a window displays prompting you to enter your serial number and license key. If you are installing Jolt 1.1 for TUXEDO 6.3, the Insert License Disk window shown in Figure 2-12 displays, and you are prompted to insert your license disk.

Figure 2-12 Insert License Disk Window
Type the designated path or select Browse and select OK.
When all files are installed, the Setup Complete window displays. Select a Jolt application by choosing an icon from the window.

Licensing your Jolt Software

The licensing scheme used by Jolt 1.1 depends on the version of TUXEDO used with Jolt. Know the following information before running this command:

Your version of TUXEDO
Your TUXEDO directory (TUXDIR) from the installation. This is the directory that contains the TUXEDO directories (bin, udataobj, etc.).
Your serial number (included with your Jolt software)
Your license key or token (included with your Jolt software)

Licensing Jolt 1.1 for TUXEDO 6.1 and 6.2

Jolt 1.1 for TUXEDO 6.1 and 6.2 uses a combination of a serial number and a token number (or license key) to enable a license. This information is included with the Jolt software when it is shipped to you. The installation programs (install.sh for UNIX or setup.exe for NT) prompt you for the serial number and token at installation time. Refer to "UNIX System Installation Script" and "Windows NT Installation Instructions" for additional information.

Enter the serial number and token number exactly as they are displayed on the license provided by BEA.

Licensing Jolt 1.1 for TUXEDO 6.3

Jolt 1.1 for TUXEDO 6.3 uses a digitally signed license file to enable a license. This file is provided on a floppy disk that is shipped with your Jolt software. The UNIX installation program (install.sh) does not install the license automatically. The NT installation program (setup.exe) prompts you for the location of the Jolt license file. If you provide the necessary information, the installation program installs the license file for you. If you do not install the license file during installation, follow the steps to install Jolt manually.

UNIX Licensing Instructions

Identify you current TUXEDO license file. This is located in TUXDIR/udataobj/lic.txt.

Make a copy of this file:

cd $TUXDIR/udataobj

cp lic.txt lic.txt.bak

Check that you have completed step 2. Verify the copy using OS-specific commands (e.g., diff on UNIX systems).
Append the contents of the Jolt license file to the TUXEDO license file:
```
cat /dev/diskette/joltlic.txt >> lic.txt
```

NT Licensing Instructions

Identify you current TUXEDO license file. This is located in %TUXDIR%\udataobj\lic.txt.

Make a copy of this file:

cd %TUXDIR%\udataobj

copy lic.txt lic.txt.bak

Check that you have a completed step 2. Verify the copy using OS-specific commands.
Append the contents of the Jolt license file to the TUXEDO license file:
```
copy lic.txt + a:\joltlic.txt
```
A text editor can be used to copy and paste the contents of the Jolt license file into the TUXEDO license file.
Note: The digital signature is 64 characters long. Every character must match exactly or the license is not valid.

If you do not complete the steps for licensing the Jolt software during installation, you can license the software at any time by following the steps in the "Licensing Upgrades Instructions."

Licensing Upgrades Instructions

If you are using Jolt 1.1 on TUXEDO 6.1 or 6.2, and you need to upgrade your license, follow these step.

Note: These instructions are for NT. Use the UNIX equivalents for UNIX platforms.

Bring up an NT command prompt window.
Type the following:
```
SET TUXDIR=<the name of your TUXEDO directory>
SET SERNUM=<your serial number>
SET LICENSE=<your license key>
CD %TUXDIR%
CD BIN
JOUTIL -r %TUXDIR% -b -l %LICENSE% -s %SERNUM% -T SDK
```
For example, if TUXEDO is installed in the directory, /opt/BEAItuxedo, your serial number is 0123456789, and your license key is 0A1B2C3D4E5F9999, execute the following commands:
```
SET TUXDIR=/opt/BEAItuxedo
SET SERNUM=0123456789 
SET LICENSE=0A1B2C3D4E5F9999
CD %TUXDIR%
CD BIN
JOUTIL -r %TUXDIR% -b -l %LICENSE% -s %SERNUM% -T SDK
```
Note: The "-l" above is a lowercase "L" not the numeral "1" (one). Your Jolt executables are now properly licensed. JOUTIL responds with an error if your serial number or license key is incorrect. If you receive an error, ensure that you have the correct serial number and license key.

Using the Jolt Online Documentation

Accompanying your Jolt software is an online, HTML-based, documentation set to assist you with using BEA Jolt 1.1. The Jolt product CD-ROM contains the HTML version of the Jolt User's Guide.

Figure 2-13 is an example of the Jolt online documentation window. Table 2-2 describes the online documentation browser application components shown in Figure 2-13.

Figure 2-13 Jolt User's Guide Online Documentation Window

**Table 2-2 Jolt User's Guide Online Documentation Window Parts**
Part	Function
1 Table of Contents	View the online documentation Table of Contents. All topics are hypertext links. Selecting the topic accesses the accompanying documentation.
2 Documentation Window	View the online documentation contents.
3 Topic Buttons	Access a subject area by selecting the topic button: JOLT INTRO - Introduction to the Jolt product and its features. INSTALL CONFIG - Description of the Jolt installation and configuration process. REPOSITORY EDITOR - Instructions for using the Jolt Repository Editor and Bulk Loader. CLASS LIBRARY - Instructions for using the Jolt Class Library. SYSTEM MESSAGES - Jolt system message reference.