[Top] [Prev] [Next] [Bottom]

2. Installing the BEA TUXEDO System on OpenVMS

This chapter explains how to install and configure the BEA TUXEDO system on your OpenVMS system.

The topics covered in this chapter include:

Preparing to Install the BEA TUXEDO System

Note: Before you begin the installation process, you may wish to review the Polycenter product installation utility (PCSI). This utility is used to install the BEA TUXEDO system and you should have a working knowledge of its operation.

Before installing the BEA TUXEDO system, you must:

The following sections provide procedures for verifying this information.

Verifying the Hardware and Software Configuration

Before you install the BEA TUXEDO system, you must verify that the machine on which you wish to install the BEA TUXEDO system meets the minimum hardware and software requirements.

Use the following procedure to verify your machine meets the requirements.

  1. Review the hardware and software configuration of the machine on which you wish to install the BEA TUXEDO system.

  2. Compare your configuration with the hardware and software requirements described in "Platform Requirements."

  3. Verify that the machine on which you wish to install the BEA TUXEDO system has at least 30 megabytes of available disk space.

Verifying the User ID Privileges and Quotas

The person installing the BEA TUXEDO system must log on to the machine with the following user ID privileges and quotas.

User ID Privileges User ID Quotas

CMKRNL

ASTLM: 400

SETPRV

BIOLM: 500

SYSLCK

DIOLM: 500

SYSNAM

ENGLM: 500

SYSGBL

FILLM: 500

PRMGBL

BYTLM: 5000000

DETACH

DGFLQUOTA: 30000

PRCLM: 5

TQELM: 500

WSDEFAULT: 512

WSEXTENT: 8192

WSQUOTA: 1024

Use the following procedure to verify the user ID privileges.

  1. Open the user account file for editing.

  2. Enter the following line in the user account file.

    set proc/priv=all

Installing the BEA TUXEDO System

  1. Log on to the machine using the user ID that you verified in "Verifying the User ID Privileges and Quotas."

  2. Mount the BEA TUXEDO CD-ROM using the following command. 

    mount/media_format=cdrom/undefined_fat=(fixed:none:8192) - /override=identification device

    where device is equal to the device specification of your CD-ROM.

  3. Start the product installation utility (PCSI): 

    product install TUXEDO /source=device:[000000...]/destination=dest_dir

    where

  4. The PCSI utility will ask you about the type of installation you want to perform. Select one or more of the following options:

  5. The PCSI utility will install the required files. You can monitor the progress of the installation on the screen.

Setting Up Your Environment

Before you can use the BEA TUXEDO system, you must set up your environment using a DCL script named postinstall. The DCL script performs the following tasks:

Logical Names

Before you can use the BEA TUXEDO system, you must set several logical names. The OpenVMS operating system allows you to set logical names in either the group table or the system table.

Group Table

Setting logical names in the group table gives you the ability to run multiple versions of the BEA TUXEDO system on the same platform. Subsequent versions of the BEA TUXEDO system can be installed under different group tables.

To use this method requires that all users who want to invoke BEA TUXEDO commands must be listed in the group table in which all the required logical names for the BEA TUXEDO system reside.

System Table

Setting logical names in the system table allows you to give all users of a system access to the BEA TUXEDO system. However, subsequent versions of the BEA TUXEDO system cannot be installed simultaneously on the same machine.

vps_daemon Process

The vps_daemon process provides the basic infrastructure for BEA TUXEDO client and server processes. BEA TUXEDO client and server processes use the vps_daemon process to perform data exchange, synchronization, monitoring, and network communication functions. The vps_daemon process also allocates the resources needed for BEA TUXEDO client and server processes to perform these functions.

The vps_daemon process requires that the logical name VPS_INITPATH point to a valid file containing the configuration parameters for the process. This file, vps_init.txt, is located in the udataobj directory and should not be modified. The parameters in this file are comparable to the IPC (Inter Process Communication) tunable parameters on the UNIX platform and to the IPC parameters on the Windows NT platform. The default parameters in vps_init.txt are capable of supporting approximately 50 BEA TUXEDO servers and 200 BEA TUXEDO clients.

If you want to change the default parameters (or perform other advanced configuration tasks), please consult BEA Support.

BEA TUXEDO License File

The BEA TUXEDO license file, LIC.TXT, is installed in the udataobj directory of the BEA TUXEDO installation directory. This file should have read permissions for system, user, group, and world.

The BEA TUXEDO license file contains the signature that indicates the number of users the installation can support. The BEA TUXEDO system cannot function without this file, which is delivered separately from the BEA TUXEDO CD-ROM.

Configuring the BEA TUXEDO System

This section explains how to configure the BEA TUXEDO system once you have finished installing it.

Preparing for Configuration

Before you begin the configuration procedure, verify that you have the following:

Configuration Instructions

Use the following procedure to complete the configuration process.

  1. Change the current directory to the dest_dir.bin directory, where dest_dir is the directory you specified during installation.

  2. On the command line, enter the following command.

    set default device:[dest_dir.BIN]

    where device is the device specification of your file system and dest_dir is the directory you specified during installation.

  3. On the command line, enter the following command.

    @postinstall

  4. The DCL script will prompt you for information on configuring the BEA TUXEDO system at the group level or at the system level.

  5. If this is not a workstation-only installation, the DCL script will prompt you for the tlisten password.

    Note: The DCL script will not echo the password but it will verify the password.

  6. The DCL script will prompt you for the location of the license file. The license file, LIC.TXT, is installed in the udataobj directory of the BEA TUXEDO installation directory. For example, if the BEA TUXEDO system is installed in DKA100:[TUXDIR] then the license file is in DKA100:[TUXDIR.UDATAOBJ].

  7. The DCL script will prompt you to indicate if the script should start the vps_daemon process.

    Note: If you choose not to start the vps_daemon process, then you will have to manually start the process. The vps_daemon.exe file is located in the BIN directory of the BEA TUXEDO installation directory.

Now the BEA TUXEDO system is fully configured and ready to run.

Installing the BEA TUXEDO Link-Level Encryption Packages

The following sections explain how to install link-level encryption packages.

Preparing to Install a Link-Level Encryption Package

Before you install a link-level encryption package, you must do the following.

  1. Verify that the BEA TUXEDO system is installed.

  2. Verify the full path name of the directory where the BEA TUXEDO system is installed.

  3. Stop all application servers and clients.

Installing the 56-bit Link-Level Encryption Package

  1. Log on to the machine with the user ID that you used to install the BEA TUXEDO system.

  2. Mount the BEA TUXEDO CD-ROM using the following command. 

    mount/media_format=cdrom/undefined_fat=(fixed:none:8192) - /override=identification device

    where device is equal to the device specification of your CD-ROM.

  3. Start the product installation utility (PCSI): 

    product install TUXEDO_ENC40 /source=device:[000000...]/destination=dest_dir

    where

  4. Go to the BIN directory under the BEA TUXEDO installation directory and enter the following command.

    @inst_enc40

Installing the 128-bit Link-Level Encryption Package

  1. Log on to the machine with the user ID that you used to install the BEA TUXEDO system.

  2. Mount the BEA TUXEDO CD-ROM using the following command. 

    mount/media_format=cdrom/undefined_fat=(fixed:none:8192) - /override=identification device

    where device is equal to the device specification of your CD-ROM.

  3. Start the product installation utility (PCSI): 

    product install TUXEDO_ENC128 /source=device:[000000...]/destination=dest_dir

    where

  4. Go to the BIN directory under the BEA TUXEDO installation directory and enter the following command.

    @inst_enc128


[Top] [Prev] [Next] [Bottom]