HP 3000 Manuals HP 3000 Manuals
Using DIRMIG
Follow these steps to correctly start DIRMIG:
1. Log on as MANAGER.SYS,PUB. Confirm that you have both SM and OP
capabilities.
2. Ensure that all other jobs and sessions are logged off before
running DIRMIG.
3. If device class TAPE is not configured on your system, create a
file equation to redirect MAGTAPE (DIRMIG's formal designator for
the tape device) to the device class or logical device number of
your configured tape drive. For example:
:FILE MYTAPE;DEV=MAGTAPE
:FILE MYTAPE=*MYTAPE
4. If device class LP is not configured for your system, create a
file equation to redirect LIST (DIRMIG's formal designator for the
offline listing device) to the device class or logical device
number for your line printer or an alternate device (refer to
"Redirecting DIRMIG Output").
5. Enter :RUN DIRMIG.PUB.SYS. DIRMIG displays the Main Menu where you
can select your migration options.
Under subsequent headings you will find discussions on how to use
DIRMIG's menu-driven interface to select, then implement, the MPE V/E
operating environment migration options of your choice:
1. Selecting Your Migration Options from the Main Menu
2. Migrating Without Dialog
3. Migrating With Dialog
4. Migrating Global RINs
5. Migrating User-Logging Identifiers
6. Migrating the Directory
7. Migrating Private Volume Environments
8. Migrating UDCs and User Files
Selecting Your Migration Options from the Main Menu
Once you have successfully passed DIRMIG's security checks, DIRMIG
displays first the product banner and the Main Menu (shown in Figure G-2
). From this menu, you can select the directory migration path you
wish.
________________________________________________________________________
| |
| |
| ============================================================ |
| DIRMIG.PUB.SYS HP30362A.00.00 (c) HEWLETT PACKARD CO., 1987. |
| MPE/iX Migration Utility. WED, SEP 23, 1987, 4:55 PM |
| ============================================================ |
| Current Log File: DIRLOGO3.PUB.SYS |
| |
| CHOOSE FROM MIGRATION OPTIONS BELOW: |
| 0 - EXIT |
| 1 - HELP |
| 2 - COMPLETE MIGRATION (No Dialog) |
| 3 - COMPLETE MIGRATION (With Dialog) |
| 4 - RINS |
| 5 - USER LOGGING ID'S |
| 6 - DIRECTORY |
| 7 - PRIVATE VOLUME ENVIRONMENT |
| ENTER MIGRATION OPTION (S) |
| .. |
| |
________________________________________________________________________
Figure G-2. DIRMIG Main Menu
You are being asked which migration paths you want to take. At the ENTER
MIGRATION OPTION(S) prompt, you can select options 0, 1, 2, and 3 by
themselves or select one or more of options 4, 5, 6, and 7 in the
following formats:
* Option numbers separated by commas. The example below indicates
you selected options 4, 6, and 7:
ENTER MIGRATION OPTION(S)
..4, 6, 7
* Option number separated by a "/" to show a range of selections.
The example below indicates you selected options 4, 5, 6, and 7:
ENTER MIGRATION OPTION(S)
..4/7
If you select a migration path that requires the SYSDUMP tape (options 2,
3, 4, 5, or 6), DIRMIG instructs you to mount the SYSDUMP tape and place
it online:
MOUNT MPE SYSDUMP TAPE AND PLACE TAPE DRIVE ON-LINE.
Mount and place online the MPE V/E SYSDUMP tape created during the
preparation stage of the migration process on a reel-to-reel magnetic
tape drive.
* If you select option 0 from the Main Menu, DIRMIG terminates. No
migration occurs.
* If you select option 1 from the Main Menu, the HELP facility is
invoked. When you exit the HELP facility you return to the Main
Menu.
* If you select option 2 from the Main Menu, DIRMIG proceeds to
migrate the entire MPE V/E operating environment found on the
SYSDUMP tape without allowing user interaction. Refer to
"Migrating Without Dialog".
* If you select option 3 from the Main Menu, DIRMIG enables you to
step through each of the optional menus in turn so that you can
implement your own migration strategy. Refer to "Migrating with
Dialog".
* If you select option 4 from the Main Menu, you proceed directly to
the Global RIN Migration Menu. Refer to "Migrating Global RINs".
* If you select option 5 from the Main Menu, you proceed directly to
the User-Logging ID Migration Menu. Refer to "Migrating
User-Logging Identifiers".
* If you select option 6 from the Main Menu, you proceed directly to
the Directory Migration Menu. Refer to "Migrating the Directory".
If you choose to migrate one or more accounts, the UDC
Environment/User Files Migration Menu is displayed. Refer to
"Migrating UDC Environments and User Files".
* If you select option 7 from the Main Menu, you proceed directly to
the Private Volume Migration Menu. Refer to "Migrating Private
Volume Environments".
NOTE You can select option 7 from the Main Menu only if the
file PVASSIST.PUB.SYS has already been created by DIRMIG.
PVASSIST.PUB.SYS is created when DIRMIG encounters the first volume
set definition when migrating accounts during directory migration.
That volume set definition, and subsequent volume set definitions,
are appended to PVASSIST.PUB.SYS. Future executions of DIRMIG will
append volume set definitions to this file.
Migrating Without Dialog
If you select option 2 from the Main Menu, DIRMIG proceeds to migrate the
entire operating environment found on the SYSDUMP tape. DIRMIG
accomplishes the following tasks without interactive dialog:
* Migrates all MPE V/E global RINs.
* Migrates all MPE V/E user-logging identifiers.
* Migrates the entire MPE V/E system domain directory/UDC
environment.
* Restores all user files residing on the tapes (except the MPE/iX
reserved groups and accounts MPEiX.SYS, CONFIG.SYS, DIAG.SYS,
CONFG950.SYS, and CONFG925.SYS)
* Writes volume set information to PVASSIST.PUB.SYS and generates a
PVSUMARY.PUB.SYS command file for all volume sets found. (Refer
to "Migrating Private Volume Environments" for details about
PVASSIST and PVSUMARY files.)
Migrating With Dialog
If you select option 3 from the Main Menu, DIRMIG enables you to step
through each of the following menus in turn so that you can choose your
own migration path. Once you are finished with each optional menu,
DIRMIG moves you to the next menu on the path:
1. Global RIN Migration Menu (refer to "Migrating Global RINs").
2. User-Logging ID Migration Menu (refer to "Migrating User-Logging
Identifiers").
3. Directory Migration Menu (refer to "Migrating the Directory").
4. Private Volume Migration Menu is displayed only if the file
PVASSIST.PUB.SYS exists (refer to "Migrating Private Volume
Environments").
5. UDC Environment/User Files Migration Menu is displayed only if one
or more accounts were migrated using DIRMIG's Directory Migration
Menu (refer to "Migrating the UDC Environment and User Files").
Migrating Global RINs
DIRMIG displays the RIN Migration Menu shown in Example G-2 after one of
the following actions has occurred:
* You selected option 3 from the Main Menu; this is the first menu
DIRMIG displays after you select option 3 from the Main Menu.
* You selected option 4 from the Main Menu.
Selecting Your Menu Option.
From the RIN Migration Menu (shown in Figure G-3 ), you can choose the
global RIN migration option you wish.
___________________________________________________
| |
| |
| RIN MIGRATION |
| ------------- |
| CHOOSE FROM RIN OPTIONS BELOW: |
| |
| 0 - EXIT / (No RIN Migration) |
| 1 - HELP |
| 2 - LIST GLOBAL RINS |
| 3 - DELETE GLOBAL RINS |
| 4 - MIGRATE RINs |
| |
| ENTER RIN OPTION |
| >> |
| |
___________________________________________________
Figure G-3. RIN Migration Menu
DIRMIG prompts you to select one of the above options. Entering only a
Return at the ENTER RIN OPTION prompt returns you to the same prompt.
The following headings explain the different options available to you
through the RIN Migration Menu.
Exit/No RIN Migration (Option 0).
If you select option 0 from the RIN Migration Menu, DIRMIG does not
migrate RINs. DIRMIG's next action is dependent upon which option you
previously selected from the Main Menu:
* If you selected option 3 from the Main Menu, DIRMIG takes you to
the next menu in the migration path, the User-Logging ID Migration
Menu (refer to "Migrating User-Logging Identifiers").
* If you selected only option 4 from the Main Menu, DIRMIG
terminates.
HELP (Option 1).
If you select option 1 from the RIN Migration Menu, the HELP facility is
invoked. When you exit the HELP facility, you return to the ENTER RIN
OPTION prompt of the RIN Migration Menu.
List Global RINs (Option 2).
If you select option 2 from the RIN Migration Menu, DIRMIG displays, in
MPE V/E SYSDUMP format, all global RINs DIRMIG previously copied to an
MPE/iX table structure from the SYSDUMP tape (minus any RINs you may have
deleted using option 3 of this menu). When DIRMIG finishes listing
global RINs, you return to the ENTER RIN OPTION prompt of the RIN
Migration menu.
If you are running DIRMIG interactively, DIRMIG enables you to redirect
output to an offline listing by prompting you with the following message:
OFFLINE LISTING (YES/[NO])?
>>
* If you enter Y or YES at the prompt, DIRMIG redirects output to
the device associated with the file LIST. The default device
specification for LIST is LP, but a file equation can be created
prior to running DIRMIG that redirects output to an alternate
device (refer to "Redirecting DIRMIG Output").
* If you enter N, NO, or Return, or if DIRMIG is running in batch
mode, output is directed to $STDLIST.
Delete Global RINs (Option 3).
If you select option 3 from the RIN Migration Menu, DIRMIG allows you to
select the global RINs you do not want migrated to MPE/iX. DIRMIG issues
the prompt:
ENTER RIN NUMBER(S)>>
At this prompt, you can use one of the following formats to specify the
RINs you do not want migrated:
* One RIN per line.
* Multiple RINs as well as ranges (using the symbol "/") on the same
line separated by commas, for example:
ENTER RIN NUMBER(S)>> 2,4,7/11,20,55,70/200
When you follow the specified RIN(S) by pressing Return, DIRMIG confirms
the deletion of each RIN number before redisplaying the prompt ENTER RIN
NUMBER(S)>> (thus enabling you to specify more RINs you want deleted).
For example:
RIN - 2 DELETED
RIN - 4 DELETED
RIN - 7 DELETED
RIN - 8 DELETED
:
When you enter only Return at the ENTER RIN NUMBER(S)>> prompt, DIRMIG
takes you back to the ENTER RIN OPTION prompt of the RIN Migration Menu.
NOTE Deleting RINs and compacting the resultant RIN table is
time-consuming. For example, compacting a RIN table of 1024 RINs
may take up to 30 minutes.
Migrate RINs (Option 4).
When you select option 4 from the RIN Migration Menu, DIRMIG migrates to
MPE/iX the global RINs copied from the SYSDUMP tape (minus any RINs you
may have deleted). Once migration is successful, DIRMIG displays the
message:
RIN MIGRATION SUCCESSFUL
NOTE DIRMIG overwrites all global RIN data existing on the MPE/iX system
with the MPE V/E global RIN data you migrated using DIRMIG's RIN
Migration Menu.
DIRMIG's next action is dependent upon which option you previously
selected in the Main Menu:
* If you selected option 3 from the Main Menu, DIRMIG takes you to
the next menu in the migration path, the User-Logging ID Migration
Menu (refer to "Migrating User-Logging Identifiers").
* If you selected only option 4 from the Main Menu, DIRMIG
terminates.
Migrating User-Logging Identifiers
DIRMIG displays the User-Logging ID Migration Menu shown in Example G-3
after one of the following actions has occurred:
* You selected option 3 from the Main Menu; this is the second menu
DIRMIG displays after you select option 3 from the Main Menu.
* You selected option 5 from the Main Menu.
Selecting Your Menu Option.
From the User-Logging ID Migration Menu (shown in Figure G-4 ), you
can choose the user-logging identifier migration option you wish.
__________________________________________________________
| |
| |
| USER-LOGGING ID MIGRATION |
| ------------------------- |
| CHOOSE FROM USER-LOGGING OPTIONS BELOW: |
| |
| 0 - EXIT/ (No Logging ID Migration) |
| 1 - HELP |
| 2 - LIST USER-LOGGING IDs |
| 3 - MIGRATE USER-LOGGING IDs |
| |
| ENTER USER-LOGGING OPTION |
| >> |
| |
__________________________________________________________
Figure G-4. User-Logging ID Menu
DIRMIG prompts you to select one of the above options. If you enter only
Return at the ENTER USER-LOGGING OPTION prompt, DIRMIG returns you to the
same prompt. The following headings explain the different options
available to you through the User-Logging ID Migration Menu.
Exit/No Logging ID Migration (Option 0).
If you select option 0 from the User-Logging ID Migration Menu, DIRMIG
does not migrate user-logging identifiers. DIRMIG's next action is
dependent upon which option you previously selected in the Main Menu:
* If you selected option 3 from the Main Menu, DIRMIG takes you to
the next menu in the migration path, the Directory Migration Menu
(refer to "Migrating the Directory").
* If you selected only option 5 from the Main Menu, DIRMIG
terminates.
HELP (Option 1).
If you select option 1 from the User-Logging ID Migration Menu, the HELP
facility is invoked. When you exit the HELP facility, you return to the
ENTER USER-LOGGING OPTION prompt of the User-Logging ID Migration Menu.
List User-Logging IDs (Option 2).
If you select option 2 from the User-Logging ID Migration Menu, DIRMIG
displays, in MPE V/E :LISTLOG format, all user-logging identifiers found
on the SYSDUMP tape. When DIRMIG finishes listing user-logging
identifiers, you return to the ENTER USER-LOGGING OPTION prompt of the
User-Logging ID Migration Menu.
If you are running DIRMIG interactively, DIRMIG enables you to redirect
output to an offline listing by prompting you with:
OFFLINE LISTING (YES/[NO])?
>>
* If you enter Y or YES at the prompt, DIRMIG redirects output to
the device associated with the file LIST. The default device
specification for LIST is LP, but a file equation can be created
prior to running DIRMIG that redirects output to an alternate
device (refer to "Redirecting DIRMIG Output").
* If you enter N, NO, or [Return], or if DIRMIG is running in batch
mode, output is directed to $STDLIST.
Migrate User-Logging IDs (Option 3).
If you select option 3 from the User-Logging ID Migration Menu, DIRMIG
migrates to MPE/iX all user-logging identifiers found on the MPE V/E
SYSDUMP tape. Once migration is successful, DIRMIG displays the message:
USER-LOGGING ID MIGRATION SUCCESSFUL
NOTE DIRMIG overwrites all user-logging identifier information existing
on the MPE/iX system with the user-logging identifier information
from the MPE V/E SYSDUMP tape.
DIRMIG's next action is dependent upon which option you previously
selected in the Main Menu:
* If you selected option 3 from the Main Menu, DIRMIG takes you to
the next menu in the migration path, the Directory Migration Menu
(refer to "Migrating the Directory").
* If you selected only option 5 from the Main Menu, DIRMIG
terminates.
Migrating the Directory
DIRMIG displays the Directory Migration Menu shown in Example G-4 after
one of the following actions has occurred:
* You selected option 3 from the Main Menu; this is the third menu
DIRMIG displays when option 3 is selected.
* You selected option 6 from the Main Menu.
Selecting Your Menu Option.
From the Directory Migration Menu (shown in Figure G-5 ), you can
choose the directory migration option you wish.
____________________________________________________________________
| |
| |
| DIRECTORY MIGRATION |
| ------------------- |
| CHOOSE FROM DIRECTORY OPTIONS BELOW: |
| |
| 0 - EXIT/(No Directory Migration) |
| 1 - HELP |
| 2 - LIST ACCOUNTS |
| 3 - COMPLETE MIGRATION (All Accounts) |
| 4 - PARTIAL MIGRATION (Specified Accounts) |
| |
| ENTER DIRECTORY OPTION |
| >> |
| |
____________________________________________________________________
Figure G-5. Directory Migration Menu
DIRMIG prompts you to select one of the above options. If you enter only
Return at the ENTER DIRECTORY OPTION prompt, DIRMIG returns you to the
same prompt. The following headings explain the different options
available to you through the Directory Migration Menu.
Exit/No Directory Migration (Option 0).
If you select option 0 from the Directory Migration Menu, DIRMIG does not
migrate MPE V/E directory structures. DIRMIG's next action is dependent
upon which option you previously selected in the Main Menu:
* If you selected option 3 from the Main Menu, DIRMIG takes you to
the next menu in the migration path, the Private Volume Migration
Menu ("refer to Migrating Private Volume Environments") only if
the file PVASSIST.PUB.SYS exists. If PVASSIST.PUB.SYS does not
exist, DIRMIG terminates.
* If you selected only option 6 from the Main Menu, DIRMIG
terminates.
HELP (Option 1).
If you select option 1 from the Directory Migration Menu, the HELP
facility is invoked. When you exit the HELP facility, you return to the
ENTER DIRECTORY OPTION prompt of the Directory Migration Menu.
List Accounts (Option 2).
If you select option 2 from the Directory Migration Menu, DIRMIG displays
the names of all accounts located on the SYSDUMP tape. When DIRMIG
finishes listing account names, you return to the ENTER DIRECTORY OPTION
prompt of the Directory Migration Menu.
If you are running DIRMIG interactively, DIRMIG enables you to redirect
output to an offline listing by prompting you with:
OFFLINE LISTING (YES/[NO])?
>>
* If you enter Y or YES at the prompt, DIRMIG redirects output to
the device associated with the file LIST. The default device
specification for LIST is LP, but a file equation can be created
prior to running DIRMIG that redirects output to an alternate
device (refer to "Redirecting DIRMIG Output").
* If you enter N, NO or Return, or if DIRMIG is running in batch
mode, output is directed to $STDLIST.
Migration of Accounts (Options 3, 4).
If you select option 3 (Complete Migration of All Accounts) or Option 4
(Partial Migration of Specified Accounts) from the Directory Migration
Menu, DIRMIG follows a two-step process for account migration:
1. Selects the accounts to migrate.
2. Migrates the accounts.
The only difference between option 3 and option 4 of the Directory
Migration Menu concerns how DIRMIG selects accounts to migrate. The
differences between option 3 and option 4 are discussed below.
Complete Migration of all Accounts..
If you select option 3 from the Directory Migration Menu, DIRMIG selects
for migration to MPE/iX the entire directory structure found on the MPE
V/E SYSDUMP tape. After the selection is made, DIRMIG follows the
process described below in "Completing Account Migration".
Partial Migration of Specified Accounts.
If you select option 4 from the Directory Migration Menu, DIRMIG allows
you to migrate selected MPE V/E account structures. DIRMIG issues the
prompt:
ENTER ACCOUNT SET(S) TO BE MIGRATED
>>
At this prompt you can enter subsets, in the form of "accountsets", of
the MPE V/E structure at the account level, followed by Return (you
cannot specify group and user subsets). If you enter only Return at this
prompt (without specifying any accountsets), DIRMIG returns you to the
ENTER DIRECTORY OPTION prompt of the Directory Migration Menu.
Accountsets are defined to be one or more MPE V/E account names, where:
* MPE wild cards are allowed; for example, M@ specifies all accounts
beginning with the letter "M".
* Minus subsets are allowed; for example A@ACCT@ specifies all
accounts beginning with the letter "A" except those accounts
beginning with the four-letter string "ACCT".
* Accountsets must be separated by commas.
* You can enter as many accountsets as desired up to a maximum of
280 characters.
After you have indicated to DIRMIG the accounts you want migrated, DIRMIG
follows the process described below in "Completing Account Migration".
Completing Account Migration.
After DIRMIG has selected the directory structure to be migrated (but
before directory migration proceeds), DIRMIG allows you to specify
whether or not you want DIRMIG to overwrite current MPE/iX directory
information with MPE V/E directory information whenever account/group
names conflict. DIRMIG displays this prompt:
OVERRIDE DISC DIRECTORY INFORMATION
IF DIRECTORY ENTRIES FROM TAPE CONFLICT (YES/[NO])? >>
* If you enter Y or YES at the prompt, DIRMIG will overwrite MPE/iX
directory information with the already-selected directory
information provided on the MPE V/E SYSDUMP tape whenever
account/group names conflict (exist both on the MPE/iX system disk
and on the SYSDUMP tape). All files associated with the
overwritten accounts are lost.
For example, if the account XTRA exists on the MPE/iX system disk
and also resides in the MPE V/E directory, the account password,
capabilities, and resource accounting limits obtained from the
SYSDUMP tape for account XTRA are used. Likewise, all user and
group structures for account XTRA are migrated.
* If you enter N, NO, or Return, DIRMIG does not overwrite MPE/iX
directory information when account/group names conflict.
NOTE The following MPE/iX reserved groups and accounts are not
overwritten even when you enter Y or YES at the above prompt and
there is a conflict:
MPEiX.SYS
CONFIG.SYS
CONFG950.SYS
CONFG925.SYS DIAG.SYS
DIAG.SYS
DIRMIG migrates each account, followed by the groups within the account.
When a group associated with a private volume has been migrated, that
group's volume set information is saved to PVASSIST.PUB.SYS. After the
account's groups are migrated, the account's users are migrated. DIRMIG
confirms directory migration with progress messages, for example:
__________________________________________________________________
| |
| |
| DIRECTORY MIGRATION IN PROGRESS |
| |
| SUCCESSFULLY MIGRATED ACCOUNT account |
| |
| ACCOUNT account NOT SUCCESSFULLY MIGRATED (DUE TO ERRORS) |
| |
| ACCOUNT account NOT MIGRATED (CURRENTLY EXISTS ON SYSTEM) |
| |
| ACCOUNT account NOT MIGRATED (RESERVED BY HP) |
| |
| DIRECTORY MIGRATION COMPLETED |
| |
__________________________________________________________________
Figure G-6. DIRMIG Progress Messages
If the MPE V/E SYSDUMP tape is MPE version G.03.00 (VMIT) or later,
encrypted passwords may exist in the account, group, or user directory
entries.
Since the MPE/iX system does not support encrypted passwords, DIRMIG must
replace the encrypted passwords it encounters with passwords that are
supported. When DIRMIG encounters this situation, it displays this
prompt:
MPE DIRECTORY MAY CONTAIN ENCRYPTED PASSWORDS.
ENTER PASSWORD TO BE SUBSTITUTED
>>
If you supply an MPE/iX supported password (eight or less alphanumeric
characters, beginning with an alphabetical character) at this prompt,
DIRMIG replaces all encrypted passwords it encounters on the SYSDUMP tape
with the password you specified.
If you enter blanks or Return, DIRMIG replaces each encrypted password
with the name of the object being migrated. For example, if account XTRA
contains an encrypted password, then XTRA is the replacement password for
the XTRA account.
After migration has completed, individual users can reset the replaced
passwords as necessary.
DIRMIG's next action is dependent upon the following considerations:
* If you selected option 3 from the Main Menu and volume set
definitions were appended to the file PVASSIST.PUB.SYS when you
migrated one or more accounts to MPE/iX , DIRMIG takes you to the
next menu in the migration path, the Private Volume Migration Menu
(refer to "Migrating Private Volume Environments").
* If you selected option 6 from the main menu, DIRMIG takes you
directly to the UDC Environment/User Files Migration Menu (refer
to "Migrating the UDC Environment and User Files").