Installation Guide

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Installing the Oracle Tuxedo Mainframe Adapter for OSI TP Product

This section covers the following information:

 

Pre-Installation Considerations

Complete the following tasks prior to installing the TMA OSI TP product:

Configuring the Environment to Install TMA OSI TP

Before installing the TMA OSI TP product, you must ensure that the Oracle Tuxedo system is installed and configured properly for your environment. Refer to your Tuxedo documentation for more information about setting the Tuxedo environment variables.

A JDK is required by the InstallAnywhere installation product to install TMA OSI TP 10.0. A JDK is installed with Tuxedo 10.0. Verify that the system PATH environment variable is set to the correct version of the JDK installed by Tuxedo 10.0.

In addition to the Tuxedo environment variables, the TMA OSI TP system requires an additional environment variable, OSIRUNDIR, before you can boot the gateway or run the osiadmin utility. Refer to the Oracle Tuxedo Mainframe Adapter for OSI TP User Guide for more information about the osiadmin utility. If you do not set the OSIRUNDIR environment variable before you boot the gateway, you will receive a message telling you to set OSIRUNDIR. This environment variable specifies the path that the TMA gateway uses for runtime files. You can set the OSIRUNDIR environment variable through a script, a command line entry, or, for Windows 2003 operating systems, through the Windows System Properties in the Control Panel. The variable value should include the path and directory as appropriate for your operating system.

Upgrading from eLink OSI TP 1.3

If you are upgrading from eLink OSI TP 1.3 to Oracle Tuxedo Mainframe Adapter for OSI TP 10.0, you must modify your existing dmconfig file to be compatible with the new format. The osiadmin utility performs this upgrade automatically with the importcfg command. It is recommended that you use the osiadmin utility, but you may also upgrade by manually editing your dmconfig file. Refer to the Oracle Tuxedo Mainframe Adapter for OSI TP User Guide for more information about using the osiadmin utility and about manually editing the dmconfig file.

Oracle Tuxedo Mainframe Adapter for OSI TP 10.0 is a full replacement for eLink OSI TP 1.3 and the Unisys Protocol Stack (OSI TP and ULS). ULS on UNIX-based systems and Oracle Tuxedo Mainframe Adapter for OSI TP 10.0 both use port 102 by default. Consider this default setting when configuring the port number of your updated dmconfig file. Beginning with eLink OSI TP 4.1, you can configure a port number other than 102. This option allows you to run your eLink OSI TP 1.3 gateway while you are upgrading. If you will be using port 102 in your TMA OSI TP 10.0 dmconfig file, you must shutdown ULS before attempting to tmboot TMA OSI TP 10.0. If you are running eLink OSI TP 1.3, uninstall eLink OSI TP and the Unisys OSI TP protocol stack including the Unisys Upper Layer Services.

When you are upgrading from a previous release of the eLink OSI TP product, you must shut down all Domain administrative and gateway servers within an application domain, particularly the following:

Upgrading from eLink OSI TP 4.0

If you are upgrading from eLink OSI TP 4.0, you do not need to modify your udmconfig input file. Perform a dmloadcf of the udmconfig file to create the dmconfig binary file, BDMCONFIG. If you are running eLink OSI TP 4.0, uninstall eLink OSI TP 4.0

Note: Beginning with eLink OSI TP 4.1, the version 4.0 udmloadcf utility, the BUDMCONFIG binary file and the eLink OSI TP Administrative Server UDADM no longer exist. The function performed by the version 4.0 udmloadcf command is now done by the dmloadcf command. The information contained in the version 4.0 BUDMCONFIG file is now incorporated within the BDMCONFIG file. If your ubbconfig contains the UDMADM Server, delete it and perform a tmloadcf of the modified ubbconfig file.

 

Installing Oracle TMA OSI TP on UNIX Platforms in Console Mode

To install the Tuxedo Mainframe Adapter for OSITP Gateway on non-mainframe UNIX in console mode, you run one of the following .bin programs as appropriate for your operating system:

UNIX Platform
.bin File
AIX 5.3
tmaosi100_32_aix_53_ppc.bin
Solaris
tmaosi100_32_sol_9_sp.bin

Perform the following steps to install the Tuxedo Mainframe Adapter for OSITP software in console mode:

  1. Insert the Tuxedo Mainframe Adapter for OSITP CD-ROM in your CD device.
  2. Log on as root.
    3. $ su -
    Password:
  3. Mount the CD-ROM. Mount commands vary depending on your system configuration. Refer to your System Administrator for the specific command for your system. Use a command similar to the following example to mount the CD-ROM.
    4. # mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt
  4. Change the directory to the unix directory on your CD-ROM device. For example,
    5. # cd /mnt/
  5. List the CD-ROM contents.
    6. # ls
    tmaosi100_32_aix_53_ppc.bin
    tmaosi100_32_sol_9_sp.bin
    tmaosi100_32_win_2k3_x86.exe
  6. Execute the appropriate installation program for your operating system in character-based mode. For example, execute the AIX 53 program to install only the Tuxedo Mainframe Adapter for OSITP Gateway:
    7. # sh tmaosi100_32_aix_53_ppc.bin -i console
  7. The installation program runs and prompts you for responses (see Listing 0-1 for an example).
    8. Listing 0-1 UNIX Console Mode Installation Example, Gateway on AIX 53 
    Preparing to install...
    Preparing CONSOLE Mode Installation...

    ==============================================================================
    BEA Tuxedo Mainframe Adapter OSITP (created with InstallAnywhere by Zero G)
    ------------------------------------------------------------------------------
    ==============================================================================
    Introduction
    ------------

    InstallAnywhere will guide you through the installation of Tuxedo Mainframe
    Adapter for OSITP 10.0.

    It is strongly recommended that you quit all programs before continuing with
    this installation.

    Respond to each prompt to proceed to the next step in the installation.  If you
    want to change something on a previous step, type 'back'.

    You may cancel this installation at any time by typing 'quit'.

    PRESS <ENTER> TO CONTINUE: ENTER

    ==============================================================================
    Choose BEA Home Directory
    -------------------------

        1- Create a New BEA Home
        2- Use Existing BEA Home

    Enter a number: 2
        1- /bea/
        2- /bea/tux100
        
    Existing BEA Home: 2

    ==============================================================================
    Pre-Installation Summary
    ------------------------

    Please Review the Following Before Continuing:

    Product Name:
        Tuxedo Mainframe Adapter for OSITP

    Install Folder:
        /bea/tux100

    Java VM to be Used by Installed Product:

        /bea/tux100/jre

    Product Version
        10.0

    Disk Space Information (for Installation Target):
        Required: 7,117,715 bytes
        Available: 531,012,902,912 bytes

    PRESS <ENTER> TO CONTINUE: ENTER

    ==============================================================================
    Installing...
    -------------

     [==================|==================|==================|==================]
     [------------------|------------------|------------------|------------------]

    Press <ENTER> to continue.:
    ==============================================================================
    Install Complete
    ----------------

    Congratulations. 'Tuxedo Mainframe Adapter for OSITP 10.0' has been successfully installed to:

       /bea/tux100
    PRESS <ENTER> TO EXIT THE INSTALLER: ENTER

Distribution Libraries and Executables for AIX

The TMA OSI TP CD-ROM contains the following libraries and executable programs for the AIX 5.3 operating system:

Table 1 TMA OSI TP Distribution Libraries for AIX 5.3
Directory
Files
/bin
getulogpfx
GWOSITP
osiadmin
osiltmain
portproxy
prdebuginfo
setPROXYpriv
/lib
libgwo.so
libnwunisys.so
libtasn1.so
/locale/C
LIBGWO.text
LIBGWO_CAT
libnwunisys.cat
/udataobj
gbebc2u.fld
jbis82u.fld
ksc2u.fld
u2gbebc.fld
u2jbis8.fld
u2ksc.fld

Distribution Libraries and Executables for Solaris

The TMA OSI TP CD-ROM contains the following libraries and executable programs for the Solaris operating system:

Table 2 TMA OSI TP Distribution Libraries for Solaris
Directory
Files
/bin
getulogpfx
GWOSITP
osiadmin
osiltmain
portproxy
prdebuginfo
setPROXYpriv
/lib
libgwo.so
libnwunisys.so
libtasn1.so
/locale/C
LIBGWO.text
LIBGWO_CAT
libnwunisys.cat
/udataobj
gbebc2u.fld
jbis82u.fld
ksc2u.fld
u2gbebc.fld
u2jbis8.fld
u2ksc.fld

Note: The $TUXDIR/bin/portproxy executable listens on privileged ports (< 1024) on behalf of GWOSITP. The script $TUXDIR/bin/setPROXYpriv is used to set the appropriate permissions. For UNIX platforms, please login as root and run setPROXYpriv manually after the installation.

 

Installing Oracle TMA OSI TP in Graphics Mode

Perform the following steps to install the Tuxedo Mainframe Adapter for OSITP Gateway on a Windows or UNIX platform in Graphics Mode:

  1. Insert the Tuxedo Mainframe Adapter for OSITP CD-ROM in your CD device.
  2. Do one of the following, depending on your platform:

    3. On Windows:

    1. Choose StartArrow symbolRun. The Run dialog displays.
    2. Click Browse to navigate to the CD-ROM drive.
    3. Select the tmaosi100_32_win_2k3_x86.exe program.
    4. Click Open. The selected path and executable appear in the Run dialog.
    5. Click OK to begin the installation. The Introduction screen displays.
      6. Note: All screen illustrations in this section are for Windows 2003.

      On UNIX:

    6. Log on as root to install the Tuxedo Mainframe Adapter for OSITP software.
      7. $ su -
      Password:
    7. Mount the CD-ROM. Mount commands vary depending on your system configuration. Refer to your System Administrator for the specific command for your system. Use a command similar to the following command to mount the CD-ROM on any UNIX system.
      8. > mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt
    8. Change the directory on your CD-ROM device. For example,
      9. > cd /mnt/
    9. List the CD-ROM contents.
      10. # ls
      tmaosi100_32_aix_53_ppc.bin
      tmaosi100_32_sol_9_sp.bin
      tmaosi100_32_win_2k3_x86.exe
    10. Execute the appropriate installation program for your operating system. For example, execute the AIX program:
      11. /mnt/> sh tmaosi100_32_aix_53_ppc.bin

      The Introduction screen displays.

  3. Click Next to proceed with the installation. The Choose BEA Home Directory screen displays.
  4. Select a New or Existing BEA Home option to specify the BEA Home directory (the default is c:\bea). The BEA Home directory is the root directory in which you install all Oracle products. This directory was set up when you installed Tuxedo.

    5. If you want to create a new BEA Home directory, follow these steps:

    1. Select the Create a New BEA Home option.
    2. Accept the default location for your BEA Home directory or click Browse to specify a different location. If you accept the default location, your BEA Home directory will be c:\bea, and your Tuxedo Mainframe Adapter for OSITP software default installation directory will be the Tuxedo 10.0 Home directory.
    3. Click Next to proceed with the installation.

      4. If you already have one or more BEA Home directories on your system, you can use one of those directories as follows:

    4. Select the Use Existing BEA Home option.
    5. Select a BEA Home directory from the list displayed to the right of the options. All valid BEA Home directories are displayed in this list. Valid BEA Home directories are directories where Oracle products have been installed using the standard installation program.
    6. Click Next to proceed with the installation.
  5. If the installation program encounters a previous version of Tuxedo Mainframe Adapter for OSITP in the selected BEA Home directory, the Previous Installation Found message box displays .

    6. From this message box, do one of the following:

    • Click Continue to install over the previous version.
    • Click Cancel to return to the Choose BEA Home Directory Screen and select another directory.
    • Click Exit to exit the installation program.
  6. If you do not have a successful installation of Tuxedo 10.0 in the BEA Home directory, the Tuxedo 10.0 Not Found! message box displays

    7. From this message box, do one of the following:

    • Click Exit to exit the installation program so you can install Tuxedo 10.0.
    • Click Previous to return to the Choose BEA Home Directory Screen and select another directory.
  7. If you have a successful installation of Tuxedo 10..0, the pre-installaton Summary screen displays,

    8. From this message box, do one of the following:

    • Click Next to begin installing
    • Click Previous to return to the Choose BEA Home Directory Screen and select another directory.
  8. Then Installing Tuxedo Mainframe Adapter message srceen displays
  9. After the product is installed, the Install Complete screen displays
  10. Click Done to exit the installation program.

Distribution Libraries and Executables for Windows 2003 Advanced Server

The TMA OSI TP CD-ROM contains the following libraries and executable programs for Windows 2003 operating systems. After installing the TMA OSI TP product, verify that these files and programs are installed on your system.

Table 3 TMA OSI TP Distribution Libraries for Windows 2003 Advanced Server
Directory
Files
/bin
DbgHelp.dll
gwo.dll
GWOSITP.exe
nwunisys.dll
osiadmin.exe
osilt.dll
osiltmain.exe
osiltpp.dll
osiltppmain.exe
osimsg.dll
Psapi.dll
tasn1.dll
/locale/C
LIBGWO.text
LIBGWO_CAT
/udataobj
gbebc2u.fld
jbis82u.fld
ksc2u.fld
u2gbebc.fld
u2jbis8.fld
u2ksc.fld
$TUXDIR/tma/osi/
samples/simpapp
dmconfig
ubbsimple
tailor.txt

Uninstalling Oracle TMA OSI TP on UNIX Platforms in Console Mode

To remove Tuxedo Mainframe Adapter for OSITP from a UNIX platform:

  1. Change directories to your uninstaller_TMAOSI directory with a command similar to the following example:
    2. > cd /bea/tux100/uninstaller_TMAOSI
  2. Start the uninstall program with the following command:
    3. /bea/tux100/uninstaller_TMAOSI> sh UninstallTMAOSI -i console

    Listing 0-1 displays an Tuxedo Mainframe Adapter for OSITP uninstallation.

    Note: The single-dash bar just beneath the double-dash bar in Listing 0-1 is a progress indicator. When the single-dash bar becomes the same length as the double-dash bar, uninstallation is complete.
    Listing 0-1 UNIX Console Mode Uninstall Example 
    Preparing CONSOLE Uninstall...
    ==============================================================================
    BEA Tuxedo Mainframe Adapter for OSITP (InstallAnywhere Uninstaller by Zero G)
    ------------------------------------------------------------------------------

    Uninstall Tuxedo Mainframe Adapter for OSITP 10.0
    ----------------------------------------------
    About to uninstall...

       BEA Tuxedo Mainframe Adapter for OSITP 10.0

    This will remove features installed by InstallAnywhere.  It will not remove files and folders created after the installation.

    PRESS <ENTER> TO CONTINUE: <ENTER>

    ==============================================================================
    Uninstalling...
    ------------

     [==================|==================|==================|==================]
     [------------------|------------------|------------------|------------------]

    ==============================================================================
    Uninstall Complete
    ------------------

    All items were successfully uninstalled.

    PRESS <ENTER> TO EXIT THE UNINSTALLER: <ENTER>

Uninstalling Oracle TMA OSI TP in Graphics Mode

Perform the following steps to remove the Tuxedo Mainframe Adapter for OSITP software from a Windows or UNIX platform:

Note: Make sure that TMA OSI TP is shut down before you uninstall.
  1. Choose StartArrow symbolProgramsArrow symbolBEA WebLogic E-Business PlatformArrow symbolTuxedo Mainframe Adapter for OSITP 10.0Arrow symbolUninstall BEA Tuxedo Mainframe Adapter for OSITP from the Start menu. The Tuxedo Mainframe Adapter for OSITP Uninstaller screen displays
  2. Click Uninstall to start removing Tuxedo Mainframe Adapter for OSITP. When the process is complete, the Uninstall complete screen displays.
  3. Click Exit to complete the uninstallation.
Note: Some files may not be removed because they are required for another Oracle product.

  Back to Top       Previous  Next