Ap B. SYSGEN Utility [ SPU Switchover/XL User's Guide ] MPE/iX 5.0 Documentation
SPU Switchover/XL User's Guide
Appendix B SYSGEN Utility
SYSGEN SPU Commands
The SYSGEN configuration program allows you to configure your systems for
SPU Switchover/XL. A first-level command, SPU, enters you into a
second-level menu of SPU Switchover/XL commands.
NOTE SPU configuration changes cannot be saved while there is an active
SPU Switchover/XL process running. If one exists, the SPUCONTROL
STOP command must be issued to terminate the process and its system
status message.
To enter SYSGEN and the second-level menu for the SPU Switchover/XL
commands, enter the following at the system prompt:
: SYSGEN Return
sysgen> SPU Return
The following SYSGEN SPU commands are displayed:
_____________________________________________________________
| |
| sysgen> SPU |
| |
| ** SPU Switchover commands ** |
| |
| apair (ap) asystem (as) avolset (av) dpair (dp)|
| dsystem (ds) dvolset (dv) show (sh) |
| |
| clear (cl)(c) exit (ex)(e) help (he)(h) hold (ho) |
| oclose (oc) redo |
_____________________________________________________________
Figure B-1. SYSGEN SPU Commands
Following are descriptions of how each SYSGEN SPU command is used to
configure your systems for SPU Switchover/XL.
APAIR
Adds a pair of interconnected SPUs, which have been identified with the
ASYSTEM command, to the configuration file. This command establishes a
relationship between the two SPUs.
For example, to establish the alternate system (Beta) as a backup for the
home system (Alpha), the following command is entered on the home system
(Alpha):
spu> APAIR HOME=ALPHA ALT=BETA Return
If you want the alternate system (for example, Beta) to be a home system
with the home system (for example, Alpha) as its backup, the following
command is entered on the home system (Alpha):
spu> APAIR HOME=BETA ALT=ALPHA Return
With this configuration, the home system (Alpha) and the alternate system
(Beta) have been established as equal partners (both home and alternate
to each other). If the second APAIR command was not entered, the home
system (Alpha) would have Beta as its alternate system, but the alternate
system (Beta) would not have Alpha as an alternate system.
ASYSTEM
Adds a system to the configuration file to establish its identity. This
command can be used only on the system that is being added as part of a
pair. For ease of use, it is recommended that you identify the system by
its current network services name (or a variation of it); however, the
selected name can be no more than 8 characters in length.
For example, to identify a system as Alpha, the following command is
entered on system Alpha:
spu> ASYSTEM SYSTEM=ALPHA Return
To identify a system as Beta, the following command is entered on system
Beta:
spu> ASYSTEM SYSTEM=BETA Return
NOTE The ASYSTEM command must be executed on each system; it will name
the system from which you execute the command.
AVOLSET
Defines the volume sets (disks) to be switched over to the alternate
system when the home system goes down. These are known as switchable
volume sets and must be connected to both systems through a fiber link.
They can be mirrored volume sets, but cannot be system volume sets.
Multiple switchable volume sets can be defined.
The home system for a volume set is defined with the AVOLSET command.
The system name must be known by the SPU configuration file by a previous
invocation of the ASYSTEM command.
For example, to add volume set A_DATA_SET to the home system (for
example, Alpha), issue the following command on the home system (Alpha):
spu> AVOLSET VOLSET=A_DATA_SET HOME=ALPHA Return
DPAIR
Deletes a system pair from the configuration file that was previously
added using the APAIR command.
For example, to delete the system pair Alpha (home system) and Beta
(alternate system) from the configuration file, the following command is
issued:
spu> DPAIR HOME=ALPHA ALT=BETA Return
If the systems are set up as equal partners and you want to delete both
partnerships, a second DPAIR command also must be issued:
spu> DPAIR HOME=BETA ALT=ALPHA Return
DSYSTEM
Deletes a system from the configuration file that was previously added
using the ASYSTEM command.
For example, to delete system Alpha from the configuration file, the
following command is issued:
spu> DSYSTEM SYSTEM=ALPHA Return
DVOLSET
Deletes a volume set from the configuration file that was previously
added using the AVOLSET command.
For example, to delete volume set DATA_SET from the configuration file,
issue the following command on the home system (Alpha):
spu> DVOLSET VOLSET=DATA_SET Return
HELP
Displays help information about all of the spu> commands or individual
commands. To display all of the spu> commands, enter the following
command:
spu> HELP ALL Return
Following is an example of what is displayed:
________________________________________________________________________
| |
| spu> HELP ALL |
| |
| command (abb) parameter=value |
| _____________ _______________ |
| apair (ap) home = system name |
| alt = system name |
| |
| asystem (as) system = system name |
| |
| avolset (av) volset = volume set name[,volume set name, ...]|
| home = system name |
| |
| dpair (dp) home = system name |
| alt = system name |
| |
| dsystem (ds) system = system name |
| |
| dvolset (dv) volset = volume set name[,volume set name,...] |
| |
| show (sh) [home = system name |
| alt = system name] |
| [dest = OFFLINE] |
________________________________________________________________________
Figure B-2. SYSGEN SPU HELP Command
SHOW
Shows the currently configured switchover system pairs. A system pair
can be specified by name on the command line. If no system pair is
specified, all pairs in the configuration file are listed.
For example, if the SHOW command is issued without a parameter, volume
sets are listed as shown in Figure B-3 :
__________________________________________________
| |
| spu> SHOW Return |
| |
| Home Alternate Volume Sets |
| _____ _________ ___________ |
| Alpha Beta a_production_data_set|
| a_user_vol_set |
| a_mirror_disk_set |
| |
| Beta Alpha b_test_software_set |
| b_benchmark_set |
__________________________________________________
Figure B-3. SYSGEN SPU SHOW Command
If the SHOW command is issued with the HOME parameter specified, volume
sets are listed as shown in Figure B-4 :
________________________________________________
| |
| spu> SHOW HOME=BETA ALT=ALPHA Return |
| |
| Home Alternate Volume Sets |
| ______ ________ ___________ |
| Beta Alpha b_test_software_set|
| b_benchmark_set |
________________________________________________
Figure B-4. SYSGEN SPU SHOW Command with Parameters
MPE/iX 5.0 Documentation