This chapter explains how to install and configure the Oracle Tuxedo system on your OpenVMS system.
The topics covered in this chapter include:
Note: | Before you begin the installation process, you may wish to review the Polycenter product installation utility (PCSI). This utility is used to install Oracle Tuxedo and you should have a working knowledge of its operation. |
Before installing Oracle Tuxedo, you must:
The following sections provide procedures for verifying this information.
Before you install Oracle Tuxedo, you must verify that the machine on which you wish to install Oracle Tuxedo meets the minimum hardware and software requirements.
Use the following procedure to verify your machine meets the requirements.
The person installing Oracle Tuxedo must log on to the machine with the user ID privileges and quotas as listed in Table 2-1
Use the following procedure to verify the user ID privileges.
product install Tuxedo /source=src_dir/destination=dest_dir
Select one of the following options:
Note: | full (to install Oracle Tuxedo installation component packages) |
Note: | server (to install all Oracle Tuxedo server package) |
Note: | full client (to install only the Oracle Tuxedo all client packages) |
Note: | jolt client (to install only the Oracle Tuxedo Jolt client) |
Note: | atmi client (to install only the Oracle Tuxedo ATMI client) |
5. The PCSI utility will install the required files. You can monitor the progress of the installation on the screen.
Before you can use Oracle Tuxedo, you must set up your environment using a DCL script named postinstall
. The DCL script performs the following tasks:
vps_daemon
processvps_daemon
if you have requested this processNote: | This script must be run each time the machine is rebooted. The Oracle Tuxedo administrator may put the DCL script into the start-up environment so that when the machine is rebooted the script will be executed. |
Before you can use Oracle Tuxedo, 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.
Setting logical names in the group table gives you the ability to run multiple versions of Oracle Tuxedo on the same platform. Subsequent versions of the Oracle Tuxedo system can be installed under different group tables.
To use this method requires that all users who want to invoke Oracle Tuxedo commands must be listed in the group table in which all the required logical names for Oracle Tuxedo reside.
Setting logical names in the system table allows you to give all users of a system access to Oracle Tuxedo. However, subsequent versions of Oracle Tuxedo cannot be installed simultaneously on the same machine.
The vps_daemon
process provides the basic infrastructure for Oracle Tuxedo client and server processes. Oracle 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 Oracle 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 Oracle Tuxedo servers and 200 Oracle Tuxedo clients.
If you want to change the default parameters (or perform other advanced configuration tasks), please consult Oracle Support.
This section explains how to configure Oracle Tuxedo once you have finished installing it.
Use the following procedure to complete the configuration process.
dest_dir
is the directory you specified during installation.
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.
tlisten
password.Note: | The DCL script will not echo the password but it will verify the password. |
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 Oracle Tuxedo installation directory. |
Note: | if you intend to use SSL encryption in your application, select 'Y' and enter the following LDAP configuration information. |
"$TUXDIR.udataobj.security]bea_ldap_filter.dat"
is usedif you want to use command, epifregedt.exe, to register the LDAP Filter File Location manually, please pay attention its format. The following example shows the correct format and incorrect format:
epifreg -u "filterFileLocation=file:////dka0/tuxedo10gr3/udataobj/security/bea_ldap_filter.dat"
epifreg -u "filterFileLocation=file:///dka0:[tuxedo10gr3.udataobj.security]bea_ldap_filter.dat"
epifreg -u "filterFileLocation=file://dka0:[tuxedo10gr3.udataobj.security]bea_ldap_filter.dat"
Oracle Tuxedo should now be fully configured and ready to run.