5.8.3 Hot-Upgrade Example
The following example describes a sample scenario for a hot upgrade and the sequence of steps to perform the hot upgrade.
Suppose you have the following on a UNIX platform:
- A machine called
MACH1
that is configured as theMASTER
and that runs an old release.- A corresponding application directory called
$APPDIR1
- A corresponding configuration file called
$TUXCONFIG1
- A corresponding application directory called
- A machine called
MACH2
that is configured as the backup.- A corresponding application directory called
$APPDIR2
- A corresponding configuration file called
$TUXCONFIG2
- A corresponding application directory called
The following example describes an example scenario for a hot upgrade and the sequence of steps to perform the hot upgrade:
- Ensure that your environment has been set up as follows (for
MP
mode, you must configure theUBBCONFIG
file in the$APPDIR
of theMASTER
machine).- Refer to the
ubbmp
file of the sample bank application for reference. - In the resource section of the configuration, the
BACKUP MASTER
machine must be specified. Follow the steps below:- Under the
*RESOURCES
section, select the value ofMASTER
asMACH1
,MACH2
(where,MACH2
is the backup master machine), the following is the example:MASTER MACH1,MACH2
- Under the
- In the configuration, the
MODEL
option must be set toMP
under the*RESOURCES
section. - In the configuration, the
MIGRATE
option must be set.OPTIONS LAN, MIGRATE
- Ensure that the Network section is configured with both
NADDR
andNLSADDR
(both must be on separate ports).*NETWORK MACH1 NADDR="//<MACH1_Hostname>:<naddr_port_number>" #BRIDGE="/scratch/<user_name>" NLSADDR="//<MACH1_Hostname>:<nls_port_number>" MACH2 NADDR="//<MACH2_Hostname>:<naddr_port_number>" #BRIDGE="/scratch/user_name" NLSADDR="//<MACH2_Hostname>:<nls_port_number>"
- Both the
MASTER
andBACKUP MASTER
machines must be installed with the old Tuxedo version. - Start
Tlisten
on both theMASTER
andBACKUP MASTER
machines. In the section ofUBBCONFIG
Network, you must specify the same address asNLSADDR
for thetlisten
. - Follow the
README
of the sample application to generate the server and client files, in this case "simpserv
" and "simpcl
".
- Refer to the
- Run the
Tmboot
command onMACH1
after generating thetmconfig
file from the above configuration file.MACH1> tmloadcf -y ubbmp
- The
Tmboot
on Machine1 (MASTER
machine) generates atmconfig
on theBACKUP MASTER
machine (MACH2
) - Use the following command to shut down the backup
MASTER
machine fromMACH1
:MACH1> tmshutdown -B MACH2 -l MACH2
- Use the following command to kill the
tlisten
process on the backup master machine (MACH2
)ps -ef | grep tlisten
kill -9 <pid of the tlisten got from above command>
- Install the Oracle Tuxedo 22c Release 1 (22.1.0.0.0) software on the backup
MASTER
machine. Cd $Appdir
ofMACH2
andrm tuxconfig
file.- Prior to running
tmconfig
to update theAPPDIR
,TUXCONFIG
, andTUXDIR
forMACH2
on theUBBCONFIG
file available in theMACH1
, exportEDITOR=vi
to enable editing in the vi editor:MACH1> tmconfig choose option 2)MACHINES choose option 5)Update
TA_LMID<the machine LMID for which you want an update>
(You can find the value ofLMID
in UBBCONFIG file*MACHINES
section)TA_APPDIR Value of the new appdir TA_TUXDIR Value of new tuxdir TA_TUXCONFIG value of new TUXCONFIG
TA_LMID MACH2 TA_APPDIR /scratch/<user_name>/oraHome_22c_load11/tuxedo22.1.0.0.0/samples/atmi/simpapp TA_APPDIR /scratch/<user_name>/oraHome_22c_load11/tuxedo22.1.0.0.0 TA_APPDIR /scratch/<user_name>/oraHome_22c_load11/tuxedo22.1.0.0.0/samples/atmi/tuxconfig
- Run the command
wq!
to save and exit - Select
Y
for the confirmation. For more information abouttmconfig
, see How to Run tmconfig. - Run
tmunloadcf
to verify successful update.
- Run the command
- To set
PATH, LD_LIBRARY
, andTUXDIR
to the latest release of Tuxedo, runtux.env
from the newly installed Tuxedo product inMACH2
. - Ensure
TUXCONFIG
andAPPDIR
point to the latest version of Tuxedo. - Use the following command to create a file
UPGRADE
inside the$APPDIR
ofMACH2
touch UPGRADE
- In
MACH2
, export the following Security environment variables:export LLE_DEPRECATION_WARN_LEVEL=NONE export TM_USE_OLD_CIPHER=Y export TM_ALLOW_NOTLS=Y export TM_MIN_PUB_KEY_LENGTH=0 export TM_SECURITY_CONFIG=NONE
- Start the Oracle Tuxedo 22c Release 1 (22.1.0.0.0)
tlisten
inMACH2
. - Reboot the backup
MASTER
machine using the following command fromMACH1
:MACH1> tmboot -B MACH2 -l MACH2
verify the tmconfig file generated in this process is located in $APPDIR
- Migrate the
MASTER
machine running the old release to theMASTER
machine running the latest release.After running the
MASTER
command, you must not encounter any errors and PSR displays the services running on the machine.MACH2> tmadmin master y psr q
- Use the following command to kill the
tlisten
fromMACH1
:ps -ef | grep tlisten kill -9 <pid of the tlisten got from above command>
- Ensure that Oracle Tuxedo 22c Release 1 (22.1.0.0.0) software is installed on the OLD
MASTER
machine (MACH1
). - Delete the
tuxconfig
file from $APPDIR
of theMACH1
(if it exists). - Run
tmconfig
file on theMACH 2
to reset theAPPDIR
,TUXCONFIG
, andTUXDIR
forMACH1
on theUBBCONFIG
file, and then exportEDITOR=vi
before runningtmconfig
file to enable the modification to be completed with the vi editor:MACH2> tmconfig choose option 2)MACHINES choose option 5)Update
Pass the following variables in key-value pairs with tab to update the details of a specific machine.
TA_LMID MACH1 TA_APPDIR Value of the new appdir TA_TUXDIR Value of new tuxdir TA_TUXCONFIG value of new TUXCONFIG
- Run the command
wq!
to save and exit. - Select
Y
for the confirmation. For more information abouttmconfig
, see How to Run tmconfig. - Run
tmunloadcf
to verify successful update.
- Set the
PATH, LD_LIBRARY
, andTUXDIR
to the latest release of Tuxedo inMACH1
by running thetux.env
file from the newly installed Tuxedo product. - Ensure
TUXCONFIG
andAPPDIR
point to the latest version of Tuxedo. - Export the following environment variables in
MACH1
:MACH1> export LLE_DEPRECATION_WARN_LEVEL=NONE export TM_USE_OLD_CIPHER=Y export TM_ALLOW_NOTLS=Y export TM_MIN_PUB_KEY_LENGTH=0 export TM_SECURITY_CONFIG=NONE
- Start the Oracle Tuxedo 22c tlisten in
MACH1
. - Using the following command to reboot the OLD
MASTER
machine(MACH1)
from theMACH2
:MACH2> tmboot -B MACH1 -l MACH1
Verify tmconfig is generated in $APPDIR in this process.
- Delete the
UPGRADE
command fromMACHINE2
$APPDIR
Parent topic: Performing a Hot Upgrade