Pathway/XM System Management Manual

Managing a Pathway/XM Environment
Compaq NonStop™ Pathway/XM System Management Manual—426761-001
7-20
Migrating Configurations Online
currently active configuration to the new configuration. You can execute the migration
plan online whenever you are ready.
This allows you to create a new configuration on a development system, move the new
SuperCTL file to the production system, and then migrate to the new configuration. For
example, you might need to add more terminals to your configuration, or you might
want to reorganize which servers or terminals are in various groups.
In this release, an online migration plan can perform the following:
•
Add new objects of any type
•
Delete objects of any type
•
Modify Node objects
•
Modify distributed SERVER objects
You must stop all other object types before the migration plan can execute. Once all
PLAN objects have completed successfully, you must restart the objects.
To migrate to a different configuration while your current Pathway/XM environment is
running, do the following:
1. Create a new configuration source file (you can use a text editor to enter the
configuration statements or use the Pathway/XM Analyst tool). The file must
include an INVENTORY statement that specifies the currently active SuperCTL file
(the one to be replaced). The INVENTORY statement can be located anywhere in
the file.
The INVENTORY statement compares the currently active SuperCTL file with the
new SuperCTL file and generates a migration plan. This plan consists of one or
more PLAN objects, each containing specific tasks to be later performed by the
START PLAN command (tasks such as deleting or adding objects or modifying
objects).
If you are working on a development system, you can make a binary copy of the
current production SuperCTL file and put it on the development system.
2. Move the new SuperCTL file to the active Pathway/XM system. Execute PXMCHK
to verify all referenced names. If errors are returned, correct the new configuration
and run PXMCHK again. Repeat this process until PXMCHK runs with no errors.
3. Use PXMCOM to open the new SuperCTL file.
4. Execute INFO PLAN *,DETAIL to obtain a detailed listing of all the migration
PLAN objects generated by the INVENTORY statement. This shows the changes
that each PLAN object will make when it is started.
5. Stop all of the following object types before executing any PLAN objects that
reference these types: TCP, TERM, DIRECT SERVER CLASSES, REPLICATED
SERVER CLASSES.
6. Use START PLAN * to execute all PLAN objects in the correct order. (If you
execute each plan individually, you must execute them in the order they are listed by
the INVENTORY statement.)