Hot Upgrade from Release 5.x, 6.1, or 6.2


	Corporate Info \| News \| Solutions \| Products \| Partners \| Services \| Events \| Download \| How To Buy
	http://www.oracle.com/technology/documentation/index.html \| Site Map \| Search \| PDF Files \| Contact \| Glossary

Tuxedo Doc Home \| Installation \| Topic List \| Previous \| Next \| Contents

Installing the BEA Tuxedo System

During the upgrade, you must shut down the backup and master machines serially; the remainder of the configuration is unaffected.

Step 1: Hot Upgrade from Release 5.0 to Release 5.1

Make sure your environment is set up as follows:
- The configuration must include a backup machine.
- The MODEL option must be set to MP.
- The MIGRATE option must be set.
Migrate the master to the backup machine.
Shut down the configured master.
Upgrade the configured master machine to Release 5.1.
If you are using an SCO platform, you must recompile and relink application servers and clients. (Shared objects are not used on SCO platforms.)
Note: This step is not necessary on any platforms other than SCO.
Reboot the configured master.
Once the configured master is up, migrate the master control.

Now you have a configuration with the master running Release 5.1.

Step 2: Hot Upgrade from Release 5.1, 6.1, or 6.2 to Release 6.5

Preliminary Notes

This section is for customers running Release 5.1, 6.1, or 6.2.

Once you have finished migrating the master to Release 6.5 (via a hot upgrade), you will not be able to migrate it back to the acting backup until you have upgraded the backup to Release 6.5. In other words, migrating the master is an irreversible procedure; once you have completed it, you cannot change the master back to the release of the BEA Tuxedo system on which it was running previously.

When you are running tmadmin(1) on a Release 6.5 machine with a Release 5.1, 6.1, or 6.2 master, the UPGRADE file (as shown in Example) must reside in the current directory. To make sure that the files are in the current directory, run tmadmin from APPDIR.

During migration, keep in mind the following guidelines regarding the BEA Tuxedo data storage areas:

You will be instructed to remove the old TUXCONFIG file. The TUXCONFIG file is propagated automatically when the backup machine is run; therefore, you do not need to do anything.
Create the TLOG when you load the software. If you already have a TLOG, remove it.
Do not do anything with application queue spaces and queues.
If you have a BDMCONFIG file, leave it as is.

To minimize down time, we recommend installing Release 6.5 on the master and backup, and rebuilding all clients and servers in the directory on each machine that is defined by APPDIR, in parallel with the directory in which the Release 5.1, 6.1 or 6.2 clients and servers were created. (In other words, both a Release 5.1, 6.1 or 6.2 application and a Release 6.5 application should be available on each machine.) This is not a requirement, but a recommendation.

When migrating from Release 6.1 or 6.2, you must rebuild your clients and servers. Additionally, you must always rebuild if you are running a BEA Tuxedo application on an HP platform. The HP-UX shared library loader does not, by default, use the paths specified in the SHLIB_PATH environment variable when trying to locate the shared libraries needed by an executable at run time. The HP-UX shared library loader must be turned on. (This procedure is not necessary on any other platform supported by the BEA Tuxedo system.) As a result, once you have upgraded from Release 6.1 or 6.2 to Release 6.5, your application programs will not be able to find the Release 6.5 BEA Tuxedo libraries. These programs must be recompiled with the following setting.

CFLAGS=Wl,+s

This setting causes the compiler to pass the +s option to the link editor when the application is recompiled. It changes the program's default behavior during future upgrades.

Procedure

Make sure your environment is set up as follows:
- The configuration must have a backup machine.
- The MODEL option must be set to MP.
- The MIGRATE option must be set.
Shut down the backup machine.
Reboot the backup machine, using Release 6.5.
Migrate the master running Release 5.1, 6.1 or 6.2 to the backup running Release 6.5.
Shut down the machine that is now acting as the backup.
Using Release 6.5, reboot the machine that you shut down in Step 5.

Example

Suppose you have the following on a UNIX platform:

A machine called MACH1 that is configured as the master and that runs Release 5.1, 6.1 or 6.2
- A corresponding application directory called $APPDIR1
- A corresponding configuration file called $TUXCONFIG1
A machine called MACH2 that is configured as the backup
- A corresponding application directory called $APPDIR2
- A corresponding configuration files called $TUXCONFIG2

Refer to the following instruction sequence to perform a hot upgrade for your application.

MACH1> tmshutdown -B MACH2 -l MACH2
 
MACH1> Run tmconfig to reset the APPDIR, TUXCONFIG, TUXDIR for MACH2
 
       MACH2> Kill tlisten process
 
       MACH2> Load System 6.5 if it is not already loaded
 
       MACH2> cd $APPDIR2
 
       MACH2> rm $TUXCONFIG2
 
       MACH2> >UPGRADE    # Indicator that upgrade being done
 
       MACH2> Reset PATH, LD_LIBRARY_PATH, TUXCONFIG, APPDIR
 
       MACH2> Rebuild clients and servers, create TLOG
 
        MACH2> Start System 6.5 tlisten
 
MACH1> >UPGRADE    # Indicator that upgrade being done
 
MACH1> tmboot -B MACH2 -l MACH2
 
       MACH2> tmadmin
 
              master
 
              y
 
              psr
 
              q
 
       MACH2> tmshutdown -B MACH1 -l MACH1
 
       MACH2> Run tmconfig to reset the APPDIR, TUXCONFIG, TUXDIR for MACH1
 
MACH1> Kill tlisten process
 
MACH1> Load System 6.5 if it is not already loaded
 
MACH1> cd $APPDIR1
 
MACH1> rm $TUXCONFIG1
 
MACH1> Reset PATH, LD_LIBRARY_PATH, TUXCONFIG, APPDIR
 
MACH1> Rebuild clients and servers, create TLOG
 
MACH1> Start System 6.5 tlisten
 
MACH1> rm UPGRADE  # Remove indicator that upgrade being done
 
       MACH2> rm UPGRADE  # Remove indicator that upgrade being done
 
       MACH2> tmboot -B MACH1 -l MACH1