How to Migrate Server Groups from One Machine to Another


	BEA Home \| Events \| Solutions \| Partners \| Products \| Services \| Download \| Developer Center \| WebSUPPORT
	http://www.oracle.com/technology/documentation/index.html \| Site Map \| Search \| PDF Files \| Contact \| Glossary

Tuxedo Documentation \| Administering a BEA Tuxedo Application at Run Time \| Local Topics \| Previous Topic \| Next Topic \| Contents

Use the LMID parameter to name the processor on which the server group(s) have been running. The alternate location must be the same for all server groups on the LMID.
In the RESOURCES section of the UBBCONFIG file, set the following parameters:
- Set RESTART=Y for each server on the machine indicated by the LMID.
- Specify the MIGRATE options.
Shut down all server groups and mark the servers in the groups as restartable by entering the following command:
```
tmshutdown -R
```
Use the tmadmin(1) migratemach (migm) command to migrate all server groups from one machine to another when the primary machine must be shut down for maintenance or when the primary machine is no longer accessible. (The command takes one logical machine identifier as an argument.)

How to Migrate Machines When the Alternate Machine Is Accessible from the Primary Machine

To migrate a machine when the alternate machine is accessible from the primary machine, complete the following procedure.

Shut down the MASTER machine by entering the following command on that machine:
```
tmshutdown -R -1 primary_machine
```
On the MASTER machine, start a tmadmin session by entering the following command:
```
tmadmin
```
At the tmadmin prompt, migrate the appropriate machine by entering the following command:
```
migratemach primary_machine
```
If necessary, migrate the transaction log.
If necessary, migrate the application data.

How to Migrate Machines When the Alternate Machine Is Not Accessible from the Primary Machine

To migrate a machine when the alternate machine is not accessible from the primary machine, switch the MASTER and BACKUP machines, if necessary.

On the alternate machine, start a tmadmin session by entering the following command:
```
tmadmin
```
Request cleanup and restart of the primary machine that require these operations by entering the following command:
```
pclean primary_machine
```
Transfer the appropriate server group to a configured alternate machine by entering the following command:
```
migratemach primary_machine
```
Boot the newly migrated server group by entering the following command:
```
boot -l alternate_machine
```

Examples of Migrating a Machine

The following sample session shows how to migrate machines. In the first example, the alternate machine is accessible from the primary machine.

Migrating a Machine When the Alternate Machine Is Accessible from the Primary Machine

$ tmshutdown -R -l SITE1
Shutting down server processes...
Server ID = 1 Group ID = GROUP1 machine = SITE1: shutdown 
succeeded 1 process stopped.
$ tmadmin
tmadmin - Copyright © 1987-1990 AT&T; 1991-1993 USL. 
> migm SITE1
migm successfully completed
> q

In the second example, the alternate machine is not accessible from the primary machine.

Migrating a Machine When the Alternate Machine Is Not Accessible from the Primary Machine

$ tmadmin
tmadmin - Copyright © 1987-1990 AT&T; 1991-1993 USL.
>pclean SITE1
Cleaning the DBBL.
Pausing 10 seconds waiting for system to stabilize.
3 SITE1 servers removed from bulletin board
> migm SITE1
migm successfully completed.
> boot -l SITE1
Booting server processes ...
exec simpserv -A :
on SITE2 -- process id=22782 ... Started.
1 process started.
>q