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

1. Installing and Upgrading the BEA TUXEDO System on Windows NT


This chapter contains installation prerequisites and instructions for installing the BEA TUXEDO system on Windows NT. It also contains information on upgrading an existing BEA TUXEDO system.

Interoperability

BEA TUXEDO Release 6.5 running on a Windows NT platform can interoperate, as either master or non-master, with Release 6.5 running on any other supported platform.

All workstation platforms that are currently supported work with this release.

Installing BEA TUXEDO for Windows NT

Hardware Requirements

Software Requirements

The Installation Process

During installation, the following activities occur:

BEA TUXEDO System Libraries

During the installation of BEA TUXEDO Release 6.5 on Windows NT, the system environment is modified. One of these modifications is the PATH environment variable. When an application is loaded, the link loader checks the local directory, followed by the system PATH, user PATH, and finally the path set in autoexec.bat (if applicable). Because different versions of a DLL can exist in a system, it is critical to verify that the correct DLL version is loaded.

You do this by ensuring that the first BEA TUXEDO system-related pathname in your system path is the pathname for the root directory of the BEA TUXEDO software or %TUXDIR%. To do this, perform the following steps.

  1. Select StartControl PanelSystemEnvironment.

  2. Scroll through system variables to ensure that the first instance of TUXDIR points to BEA TUXEDO Release 6.5.

  3. Set Variable and Value as necessary and click OK.

  4. Restart the computer.

A further complication is that a DLL may be loaded in memory. As applications are loaded, they first attach to the library in memory, which may cause applications to attempt to load the incorrect DLL version. To prevent this, shut down all BEA TUXEDO processes before installing Release 6.5. (Microsoft's© Resource Kit for Windows NT provides additional information.)

Logging in as Administrator

To install the BEA TUXEDO system on Windows NT correctly, the person installing the application needs to log in with the user ID of Administrator.

If someone logs in from a non-administrator account, the TUXIPC service will not have an entry in the registry. The BEA TUXEDO system is still functional, however, because TUXIPC runs as a process, but all applications terminate when the user logs off.

Types of Installation

You can install all or part of the BEA TUXEDO software CD-ROM. Specifically, you can install any of the following:

The documentation is installed from a separate documentation CD-ROM.

Registry Contents

As part of the installation process, the BEA TUXEDO IPC Helper Service is installed as an NT Service; general installation information as well as the IPC parameters are installed in the registry. The layout of the registry is as follows:

HKEY_LOCAL_MACHINE\Software\BEA Systems\TUXEDO\6.5\

Product information, such as the major and minor version numbers of the release, user and company names, is stored under the Release 6.5 key.

Values for the BEA TUXEDO IPC Helper Service, as well as the locations of TUXDIR, NLSPATH, ULOGDIR, ULOGPFX, and ULOGOUT, are stored under the Environment key. You can tune the IPC values based on your application needs. (Refer to the control panel applet described in Chapter 3, "Configuring the BEA TUXEDO System for Windows NT.")

The Security key has the following requirements:

Using The Security Key to Restrict Access

Native clients are advised to call tpinit()with the cltname set to tpsysadm in order to have access to BEA TUXEDO functionality. However, because tpsysadm is a trusted user this results in a bypass of the APP_PW/USER_AUTH authentication.

To prevent this lapse in security the administrator should do the following:

  1. In the Run dialog box, enter

     regedt32

    Click OK.

  2. Select HKEY_LOCAL_MACHINESoftwareBEA SystemsTUXEDO6.5

  3. Select SECURITYPermissions

  4. Revoke control for Everyone and allow access only to users with administrative privileges.

How to Install the BEA TUXEDO System for Windows NT

  1. Log in to Windows NT with the user name of Administrator.

  2. Insert the BEA TUXEDO CD-ROM in the CD-ROM drive and select StartProgramsWindows NT Explorer.

  3. Select the CD-ROM icon and choose one of the following actions.

    To Install Select

    The server version of the BEA TUXEDO system

    WINNTServersetup.exe

    Workstation client software

    WINNTWSDisk1setup.exe

  4. Follow the window prompts.

  5. After you get a message that the installation was successful, reboot the machine.

    Note: You can also select StartRun or begin installing from a command prompt. Both installations prompt you for the license diskette before installing.

How to Upgrade an Existing BEA TUXEDO System for Windows NT

Prerequisite

If you are upgrading from an existing BEA TUXEDO system, and are using the BEA TUXEDO IPC Helper Service, you must stop the service and then proceed with the installation procedure.

  1. Disable the BEA TUXEDO IPC Helper Service by selecting StartSettingsControl PanelServices.

  2. From the Services dialog box, select TUXEDO IPC Helper and then select Stop.

  3. Insert the BEA TUXEDO CD-ROM in the CD-ROM drive and select StartProgramsWindows NT Explorer.

  4. Select the CD-ROM icon and choose one of the following actions.

    To Install Select

    The server version of the BEA TUXEDO system

    WINNTServersetup.exe

    Workstation client software

    WINNTWSDisk1setup.exe

  5. Follow the window prompts.

  6. After you get a message that the installation was successful, reboot the machine.

    Note: To ensure proper operation, regenerate any applicable TUXCONFIG files.



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