Installing the Oracle Tuxedo System on IBM i 6.1

This chapter contains the following topics:

•	Interoperability

•	The Installation Process

Interoperability

Oracle Tuxedo 11g Release 1 (11.1.1.2.0) running on an IBM i 6.1 platform can interoperate, as either master or non-master, with 11g Release 1 (11.1.1.2.0) running on any other supported platform. Backward compatibility (that is, interoperability between 11g Release 1 (11.1.1.2.0) and prior releases) is supported only if the master node is running 11g Release 1 (11.1.1.2.0) .

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

Note:

If remote domain is Oracle Tuxedo 6.5 on other OS, local domain on IBM i 6.1 must set environment variable whose name is <remote domainid>ISOS400 to "n".

The Installation Process

This section provides instructions for preparing your environment for the Oracle Tuxedo system, installing the Oracle Tuxedo system from a Microsoft Windows or UNIX system platform.

Before You Begin

Before you start installing the Oracle Tuxedo system, sign on to your IBM i 6.1 system and make sure you have a tuxedo user profile for Oracle Tuxedo installation. If you do not, create one now. The user defined in this profile will be the owner of all the program objects created during the installation process.

Installing from a Microsoft Windows Platform

1.	Oracle Tuxedo 11g Release 1 (11.1.1.2.0) for IBM i 6.1 is distributed in a .ZIP file. Before installation, extract this file to any directory and then start the next installation.

2.	Create a 3-line file containing the following ftp information:

open IBM i 6.1-machine-name
account-name
password

For example, suppose that (a) you are working on an IBM i 6.1 machine called lc400b.oracle.com, (b) your login is rtl, and (c) your password is rtl123. Your profile contains the following three lines:

open lc400b.oracle.com
rtl
rtl123

This file is used to automatically execute the pre-installation procedures necessary for installing Oracle Tuxedo 11g Release 1 (11.1.1.2.0) through ftp. Once the pre-installation steps are completed, the file should be removed.

Note:

A new line is required after the password line.

3.	Invoke the pre-installation batch file, preinst.bat, with the appropriate command-line arguments.

preinst.bat pkgdir tmplib tuxdir tuxlib filename

where:

•	pkgdir is the extracted ZIP file directory.

•	tmplib is the library on the IBM i 6.1 machine in which copies of the Oracle Tuxedo save files will be stored.

•	tuxdir is the IFS file system on the IBM i 6.1 machine on which the Oracle Tuxedo system will be installed.

•	tuxlib is the library on the IBM i 6.1 machine where the saved files are restored.

•	filename is the full path to a file that contains ftp account and password information for the IBM i 6.1 machine on which the Oracle Tuxedo system is installed.

4.	Run the install program on the IBM i 6.1 machine.

addlible tuxlib

call coreinst (tmplib tuxlib '/tuxdir'

'full|server|client|joltclt|atmiclt|jrly' 'y|n')

where you specify one of the following Oracle Tuxedo installation component packages:

•	full (to install Oracle Tuxedo installation component packages)

•	server (to install all Oracle Tuxedo server package)

•	client (to install only the Oracle Tuxedo all client packages)

•	joltclt (to install only the Oracle Tuxedo Jolt client)

•	atmiclt (to install only the Oracle Tuxedo ATMI client)

•	jrly (to install only the Oracle Tuxedo Jolt JRLY)

Specify one of the following for sample's installation:

•	'y' (to install samples when package type is full or server.

•	'n' (do not install samples)

Note:

The words full, server, client atmiclt, joltclt and jrly, y and n must be entered in lowercase.

During the installation process (which may take several minutes), a number of restoring X to Y messages are displayed, such as the following.

restoring service programs to tuxlib

5.	Remove all the saved files that were created in Step 3 from tmplib.

Note:

Remove tmplib, too, if it is different from tuxlib and it is no longer needed.

6.	Initialize the tlisten passwords. The tlisten password is used for authentication during the boot process of a multiple-node application. To initialize the password file, enter the following command.

call tlistpwd 'tuxdir'

where the value of tuxdir is the directory specified as tuxdir in Step 4. This command will prompt for passwords until a non-null password is entered. For further details about the password file, see tlisten in the Oracle Tuxedo Reference Manual.

7.	Before using SSL, enter the following command to configure SSL: addlible tuxlib

Note:

tuxlib: The library on the IBM i 6.1 where the save files are restored.

call sslconf ('tuxdir' 'hostname' 'portid' 'baseobj' 'filename')

tuxdir: The IFS file system (on the IBM i 6.1) where Oracle Tuxedo is installed.

hostname: The URL of the LDAP server system.

portid: A port number for the URL of the LDAP server system.

baseobj: A base object for search in LDAP server.

filename: The name of LDAP filter file, if the input is '' (null), the default value of "$tuxdir/udataobj/security/bea_ldap_filter.dat" will be used.

8.	Your installation of the Oracle Tuxedo system is now complete.

Installing from a UNIX System Platform

1.	Oracle Tuxedo 11g Release 1 (11.1.1.2.0) for IBM i 6.1 is distributed in a .ZIP file. Before installation, extract this file to any directory and then start the next installation.

2.	Set up a .netrc file to allow ftp to sign on to the IBM i 6.1 machine. For example, suppose that (a) you are working on an IBM i 6.1 machine called lc400b.oracle.com, (b) your login is rtl, and (c) your password is rtl123. Your .netrc file will contain the following three lines.

machine lc400b.oracle.com
login rtl
password rtl123

3.	Invoke the preinstallation shell, preinst.sh, with the appropriate command-line arguments:

preinst.sh mount-point tmplib tuxdir tuxlib machine, where:

•	mount-point is the extracted ZIP file directory.

•	tmplib is the library on the IBM i 6.1 where Oracle Tuxedo save files are located.

•	tuxdir is the IFS file system (on the IBM i 6.1) where Oracle Tuxedo is installed.

•	tuxlib is the library on the IBM i 6.1 where the save files are restored.

•	machine is the name of the IBM i 6.1 machine where Oracle Tuxedo is installed.

4.	Run the install program on the IBM i 6.1 machine.

addlible tuxlib

call coreinst (tmplib tuxlib '/tuxdir' 'full|server|client|joltclt|atmiclt|jrly' 'y|n')

where you specify one of the following Oracle Tuxedo installation component packages:

•	full (to install Oracle Tuxedo installation component packages)

•	server (to install all Oracle Tuxedo server package)

•	client (to install only the Oracle Tuxedo all client packages)

•	joltclt (to install only the Oracle Tuxedo Jolt client)

•	atmiclt (to install only the Oracle Tuxedo ATMI client)

•	jrly (to install only the Oracle Tuxedo Jolt JRLY)

Specify one of the following for sample's installation:

•	'y' (to install samples when package type is full or server.

•	'n' (do not install samples)

Note:

The words full, server, client atmiclt, joltclt and jrly, y and n must be entered in lowercase.

During the installation process (which may take several minutes), a number of restoring X to Y messages will be displayed, such as.

restoring service programs to tuxlib

5.	Remove all the saved files that were created in Step 3 from tmplib.

Note:

Remove tmplib, too, if it is different from tuxlib and it is no longer needed.

6.	Initialize the tlisten passwords. The tlisten passwords are used for authentication during the boot process of a multiple-node application. To initialize the password file, enter the following command.

call tlistpwd 'tuxdir'

where the value of tuxdir is the directory specified as tuxdir in Step 4. This command will prompt for passwords until a non-null password is entered. For further details about the password file, see tlisten in the Oracle Tuxedo Reference Manual.

7.	Before using SSL, enter the following command to configure SSL:

addlible tuxlib

tuxlib: The library on the IBM i 6.1 where the save files are restored.

call sslconf ('tuxdir' 'hostname' 'portid' 'baseobj' 'filename')

tuxdir: The IFS file system (on the IBM i 6.1) where Oracle Tuxedo is installed.

hostname: The URL of the LDAP server system.

portid: A port number for the URL of the LDAP server system.

baseobj: A base object for search in LDAP server.

filename: The name of LDAP filter file, if the input is '' (null), the default value of "$tuxdir/udataobj/security/bea_ldap_filter.dat" will be used.

8.	Your installation of the Oracle Tuxedo system is now complete.