(Running RT--11 UPDATE\RUN_CHAP)

(Summary of UPDATE Procedure\bold)

When you bootstrap the RT--11 UPDATE system volume, it executes an interactive dialogue. The dialogue asks a series of questions to determine which software products to update and what device you are using for the product-distribution kit. Most of the questions require only a yes or a no answer.

The updating operations are automatically initiated when RT--11 UPDATE has the information it needs. The amount of time the procedure takes depends on the media you use and the product you are updating.

(Chapter Division\bold)

This chapter is divided into five sections that explain how to run RT--11 UPDATE on different configurations. See (loc_table) to determine which section covers your configuration. (Location of UPDATE Instructions for Your Media\loc_table) (3\27\27) (Update Kit Media\Distribution Kit Media\Section to Read) (RX01, RX02, RX50\RX01, RX02, RX50\(diskettes_sec\VALUE)) (RX01, RX02, RX50\RK06, RK07, RL01, RL02\(diskhard_sec\VALUE)) (RK06, RK07, RL01, RL02\RK06, RK07, RL01, RL02\(harddisk_sec\VALUE)) (RX50 in RX33 drive\RX50 in RX33 drive\(rx50_sec\VALUE)) (TK50\TK50\(tk50_sec\VALUE)) (Conventions Used)
(2\13) ([]\Enclose possible responses from which you can choose one. The choices are separated by a slash (/).) (()\Indicate you can substitute a word or value of your choice.) (()\Represents a word or value that the UPDATE program changes during a processing operation.) (ddn:\dd represents a 2-character physical device name, and n represents the drive unit number of that device.)

Unless specified otherwise, terminate commands by pressing (RETURN). (nocontents) (#) (Update Kit and Distribution Kit on Diskettes ################### (Layered Products Only)\DISKETTES_SEC ) (contents) (Update Kit and Distribution Kit on Diskettes (Layered Products Only)\DISKETTES_SEC )

If your update and distribution kits reside on diskettes, do the following to update your distribution kit: (numbered) Insert the UPDATE system volume in any drive unit that RT--11 UPDATE supports (see (hard_sec)). Bootstrap the UPDATE system volume.

When you have bootstrapped the UPDATE system volume, the following dialogue begins: Welcome to RT-11 UPDATE (). This kit updates the following products: ( Please refer to the RT-11 Update User's Guide for assistance with this UPDATE session. Please enter today's date (dd-mmm-yy) Enter the date as (dd-mmm-yy), where (dd) represents the day, (mmm) represents the first three characters of the name of the month, and (yy) represents the year.

After you enter the date, you are asked: Have you backed up the update kit? [Y/N] Make sure you have a backup of the update kit and respond with a Y or N. (unnumbered) If you type N, a fatal error message appears on your terminal screen, the UPDATE session terminates, and the monitor prompt (.) appears. Bootstrap the RT--11 system disk again and make a backup copy of the update kit as described in (pres_sec). Then, start the UPDATE session again. If you type Y, UPDATE asks: Do you want to update ()? [Y/N] Check the name of the product you want to update and respond with a Y or N. (unnumbered) If you type N, UPDATE specifies another product. When there are no more products on the update kit to specify, the UPDATE session ends and the monitor prompt (.) appears. If you type Y, UPDATE asks: Have you backed up the () distribution kit? [Y/N] Make sure you have a backup of your distribution kit and respond with a Y or N. (unnumbered) If you type N, a fatal error message appears on your terminal screen, the UPDATE session terminates, and the monitor prompt (.) appears. Bootstrap the RT--11 system volume again and back up the distribution kit as described in the (ins_book). Then, start the UPDATE session again. If you type Y, UPDATE asks: In which device will you mount the () kit? (ddn) Type the 3-character code for the device in which you will mount the distribution kit (see (hard_sec)). The drive unit occupied by the UPDATE system volume cannot be used for the distribution kit. (unnumbered) If you specify an RX01 or RX50 device, UPDATE directs you to mount a specific update volume in the appropriate device. If the distribution kit is distributed on RX01 and RX02 diskettes and you specify an RX02 device, UPDATE prompts you: On which type of medium does the () distribution kit reside? 1 = single density (RX01) 2 = double density (RX02) Enter [1 or 2] (unnumbered\-) If the distribution kit resides on single-density diskettes, type 1. If the distribution kit resides on double-density diskettes, type 2.

Then, UPDATE prompts: Mount update () in () Continue? [Y/N] Mount the specified update volume in the appropriate device and type Y in response to the (Continue?) prompt. If you type N, UPDATE repeats the prompt.

As UPDATE reads the update data file, the following messages appear: NOW READING IN DATA FILE.... WORKING ...

UPDATE instructs you when to mount the distribution volume in the appropriate device: Mount the distribution volume (

UPDATE unprotects and deletes each module specified in the update data file and copies the updated module to the appropriate distribution volume. The following message appears as each module is updated: Now updating

When the updated modules are copied to the distribution volume, UPDATE instructs you to mount the next volume in the appropriate device. Remove the current volume, mount the specified volume, and type Y in response to the prompt. Continue to mount the diskettes and respond to the prompt in that fashion until all the updated modules are copied to the appropriate distribution volumes. When UPDATE has finished updating a product, UPDATE does the following: (unnumbered) If there are more products on the update kit to specify, UPDATE asks: Do you want to update ()? [Y/N]

If you type Y, the UPDATE session repeats for the specified product. If you type N, UPDATE specifies another product. If there are no more products on the update kit to specify, the UPDATE session ends and the following message and monitor prompt (.) appear: The UPDATE session has completed successfully. ( @ () . (nocontents) (#) (Update Kit on Diskettes---Distribution Kit on Hard Disk ######## (Layered Products Only)\DISKHARD_SEC) (contents) (Update Kit on Diskettes---Distribution Kit on Hard Disk (Layered Products Only)\DISKHARD_SEC)

If your update kit resides on diskettes and your distribution kit resides on hard disk, do the following to update your distribution kit: (numbered) Insert the UPDATE system volume in any drive unit that RT--11 UPDATE supports (see (hard_sec)). Bootstrap the UPDATE system volume.

When you have bootstrapped UPDATE, the following dialogue begins: Welcome to RT-11 UPDATE (). This kit updates the following products: ( Please refer to the RT-11 Update User's Guide for assistance with this UPDATE session. Please enter today's date (dd-mmm-yy) Enter the date as (dd-mmm-yy), where (dd) represents the day, (mmm) represents the first three characters of the name of the month, and (yy) represents the year.

After you enter the date, you are asked: Have you backed up the update kit? [Y/N] Make sure you have a backup of your update kit and respond with a Y or N. (unnumbered) If you type N, a fatal error message appears on your terminal screen, the UPDATE session terminates, and the monitor prompt (.) appears. Bootstrap the RT--11 system disk again and back up the update kit as described in (pres_sec). Then, start the UPDATE session again. If you type Y, UPDATE asks: Do you want to update ()? [Y/N] Check the name of the product you want to update and respond with a Y or N. (unnumbered) If you type N, UPDATE specifies another product. When there are no more products on the update kit to specify, the UPDATE session ends, and the monitor prompt (.) appears. If you type Y, UPDATE asks: Have you backed up the () distribution kit? [Y/N] Make sure you have a backup of your distribution kit and respond with a Y or N. (unnumbered) If you type N, a fatal error message appears on your terminal screen, the UPDATE session terminates, and the monitor prompt (.) appears. Bootstrap the RT--11 system disk again and back up the distribution kit as described in your layered-product installation guide. Then, start the UPDATE session again. If you type Y, UPDATE asks: In which device will you mount the () kit? (ddn) Type the 3-character code for the device in which you will mount the distribution kit (see (hard_sec)). UPDATE responds with the following prompt: Mount update () in () Continue? [Y/N] Mount the specified update volume in the appropriate device and type Y in response to the (Continue?) prompt.

As UPDATE reads the update data file, the following messages appear: NOW READING IN DATA FILE.... WORKING ...

UPDATE instructs you when to mount the distribution kit in the appropriate device. Mount the () distribution volume labeled (

When you have done so, UPDATE unprotects and deletes each module specified in the update data file and copies the updated module to the distribution kit. The following message appears as each module is updated: Now updating When UPDATE has finished updating a product, UPDATE does the following: (unnumbered) If there are more products on the update kit to specify, UPDATE asks: Do you want to update ()? [Y/N]

If you type Y, the UPDATE session repeats for the specified product. If you type N, UPDATE specifies another product. When there are no more products on the update kit to specify, the UPDATE session ends and the following message and monitor prompt (.) appear: The UPDATE session has completed successfully. ( @ () . (nocontents) (#) (Update Kit and Distribution Kit on Hard Disk ################# (RT--11 and Layered Products) \HARDDISK_SEC) (contents) (Update Kit and Distribution Kit on Hard Disk (RT--11 and Layered Products) \HARDDISK_SEC)

If your update and distribution kits reside on hard disk, do the following to update your distribution kit: (numbered) Insert the update kit in any drive unit that UPDATE supports (see (hard_sec)). Bootstrap the update kit.

When you have bootstrapped UPDATE, the following dialogue begins: Welcome to RT-11 UPDATE (). This kit updates the following products: ( Please refer to the RT-11 Update User's Guide for assistance with this UPDATE session. Please enter today's date (dd-mmm-yy) Enter the date as (dd-mmm-yy), where (dd) represents the day, (mmm) represents the first three characters of the name of the month, and (yy) represents the year.

Next, UPDATE asks if you have backed up your update kit: Have you backed up the update kit? [Y/N] Make sure you have a backup of the update kit and respond with a Y or N. (unnumbered) If you type N, a fatal error message appears on your terminal screen, the UPDATE session terminates, and the monitor prompt (.) appears. Bootstrap the RT--11 distribution kit again and make a backup copy of the update kit as described in (pres_sec). Then, start the UPDATE session again. If you type Y, UPDATE asks: Do you want to update ()? [Y/N] Check the name of the product you want to update and respond with a Y or N. (unnumbered) If you type N, UPDATE specifies another product. When there are no more products on the update kit to specify, the UPDATE session ends, and the monitor prompt (.) appears. If you type Y, UPDATE asks: Have you backed up the () distribution kit? [Y/N] Make sure you have a backup of the distribution kit and respond with a Y or N. (unnumbered) If you type N, a fatal error message appears on your terminal screen, the UPDATE session terminates, and the monitor prompt (.) appears. Bootstrap the RT--11 distribution kit again and make a backup copy of the distribution kit as described in Chapter 2 of the (RT--11 Update Release Notes) (See (notes_sec) for how to access the (RT--11 Update Release Notes)). Then, start the UPDATE session again. If you type Y, UPDATE asks: In which device will you mount the () kit? (ddn) Type the 3-character code for the device in which you will mount the distribution kit (see (hard_sec)). The drive unit occupied by the update kit cannot be used for the distribution kit.

As UPDATE reads the update data file, the following messages appear: NOW READING IN DATA FILE.... WORKING ...

UPDATE instructs you when to mount the distribution kit in the appropriate device: Mount the () distribution volume labeled (

UPDATE checks the volume identification number (ID) for RT--11. If the volume ID is correct, UPDATE proceeds with the UPDATE session. If the volume ID is incorrect, UPDATE displays an error message.

UPDATE unprotects and deletes each module specified in the update data file and copies the updated module to the distribution kit. The following message appears as each module is updated: Now updating

When all the updated modules for the product are copied to the distribution volumes, UPDATE automatically copies the new volume identification number to the RT--11 distribution volume and displays the message: Now updating volume identification number When UPDATE has finished updating a product, UPDATE does the following: (unnumbered) If there are more products on the update kit to specify, UPDATE asks: Do you want to update ()? [Y/N]

If you type Y, the UPDATE session repeats for the specified product. If you type N, UPDATE specifies another product. If there are no more products on the update kit to specify, the UPDATE session ends and the following message and monitor prompt (.) appear: The UPDATE session has completed successfully. ( @ () . (nocontents) (#) (Update Kit and Distribution Kit on RX50 Diskettes--- ######### Using One RX33 Diskette Drive (Layered Products Only) \RX50_SEC) (contents) (Update Kit and Distribution Kit on RX50 Diskettes---Using One RX33 Diskette Drive (Layered Products Only) \RX50_SEC)

If your update and distribution kits reside on RX50 diskettes and you have only one RX33 diskette drive, follow the procedure described in this section to update your distribution kit.

(What the Procedure Does\bold)

Because this is a single-drive update, when you have bootstrapped the UPDATE system volume, UPDATE boots VM on your system device. UPDATE then copies your update distribution kit to a logical disk on the volume you specify. After the update logical disk is created, the RX33 drive is free to update the distribution kit. UPDATE copies the files from the update logical disk to the distribution diskettes mounted in the RX33 drive.

(Procedure Prerequisites\bold)

Before you begin the UPDATE program with one RX33 diskette drive, do the following: (numbered) Make sure you are not using (have not mounted) logical disk LD0. Make sure you have the minimum number of contiguous blocks of free space specified in the (RT--11 Update Release Notes).

(Procedure\bold) (numbered) Insert update volume 1 in the RX33 diskette drive. Bootstrap update volume 1.

When you have bootstrapped update volume 1, the following dialogue begins: Determining system configuration, please wait... Welcome to RT-11 UPDATE (). This kit updates the following products: ( Please refer to the RT-11 Update User's Guide for assistance with this UPDATE session. Please enter today's date (dd-mmm-yy) Enter the date as (dd-mmm-yy), where (dd) represents the day, (mmm) represents the first three characters of the name of the month, and (yy) represents the year. UPDATE then displays the following messages: The UPDATE system is now running from Virtual Memory (VM). The update () kit will be copied to a logical disk. The device that you specify must have (). contiguous free blocks. To which device do you want the update () kit copied? (ddn) Type the 3-character code for the device to which the update kit will be copied (your fixed disk or another device that has enough contiguous free space). (unnumbered) If you specify a removable disk device, the following message appears: Mount the volume which the update () kit will be copied to in ddn: Continue? [Y/N]

Mount the specified volume in the specified device and type Y in response to the (Continue?) prompt. If you type N, UPDATE repeats the prompt. If the volume you specified does not have enough contiguous free space, these messages appear: ;?UP-E-Not enough contiguous free space on ddn: Do you want to use another device? [Y/N]

Type N if you want to end the UPDATE session and prepare your disk by using the DELETE and SQUEEZE commands. If you type Y, you are prompted again for another device and asked to mount a volume in that device. If the volume you specified has enough contiguous free space, the dialogue continues: The following procedure should produce an informational message in the form ?DUP-I-Message. No action is required as a result of this message. ....Now copying update kit () - 1 to LD0: Mount the volume labeled UPDATE () RX50 - () in ddn: Continue? [Y/N] Mount the update volume in the appropriate device and then type Y in response to the (Continue?) prompt. If you type N, UPDATE repeats the prompt. ....Now copying update kit () - () to LD0:

When the update volume is copied to the logical disk, UPDATE instructs you to mount the next volume in the same device. Remove the current update volume, mount the next specified update volume, and type Y in response to the prompt. Continue to mount the diskettes and respond to the prompt in that fashion until all the update volumes are copied to the logical disk.

UPDATE then names a product that has been updated and asks if you want to update that product. Do you want to update ()? [Y/N] Check the name of the product you want to update and respond with a Y or N. (unnumbered) If you type N, UPDATE specifies another product. When there are no more products on the update kit to specify, the UPDATE session ends, and the monitor prompt (.) appears as shown at the end of this section. If you type Y, UPDATE asks: Have you backed up the () distribution kit? [Y/N] Make sure you have a backup of the distribution kit and respond with a Y or N. (unnumbered) If you type N, a fatal error message appears on your terminal screen, the UPDATE session terminates, and the monitor prompt (.) appears. Bootstrap the RT--11 distribution kit again and make a backup copy of the product distribution kit as described in the (ins_book). Then, start the UPDATE session again. If you type Y, UPDATE proceeds to the next messages: NOW READING IN DATA FILE.... WORKING ... Mount the volume labeled () () BIN RX50 () in ddn: Continue? [Y/N] Mount the specified product volume in the appropriate device and then type Y in response to the (Continue?) prompt. If you type N, UPDATE repeats the prompt.

UPDATE unprotects and deletes each module specified in the update data file and copies the updated module to the product distribution kit. The following message appears as each module is updated: Now updating ()

When the updated modules are copied to the distribution volume, UPDATE instructs you to mount the next distribution volume in the same device. Remove the current volume, mount the specified volume, and type Y in response to the prompt. Continue to mount the diskettes and respond to the prompt in that fashion until all the updated modules are copied to the appropriate distribution volumes. When UPDATE has finished updating a product, UPDATE does the following: (unnumbered) If there are more products on the update kit to specify, UPDATE asks: Do you want to update ()? [Y/N]

If you type Y, the UPDATE session repeats for the specified product. If you type N, UPDATE specifies another product. If there are no more products on the update kit to specify, the UPDATE session ends and the following message and monitor prompt (.) appear: The UPDATE session has completed successfully. (

The UPDATE logical disk is dismounted and deleted. @ () . (contents) (Update Kit and Distribution Kit on TK50 Magtape (Layered Products Only)\TK50_SEC) (nocontents) (#) (Update Kit and Distribution Kit on TK50 Magtape ############# (Layered Products Only) \TK50_SEC)

When your update and distribution kits reside on TK50 magtape, follow the procedure described in this section to update your distribution kit.

(What the Procedure Does\bold)

When the kits reside on TK50 magtape, the UPDATE program copies the update kit to one logical disk (LD0) and the layered-product TK50 kit to another logical disk. If you specify one device for both logical disks, that device must have enough contiguous free space for both kits.

The updating is done from logical disks. During the procedure, you are instructed to mount a new TK50 to which the updated layered product is copied. Then, the UPDATE logical disk is deleted, though the layered-product logical disk remains mounted.

(Procedure Prerequisites\bold)

Before you begin the UPDATE program with a TK50 magtape, do the following: (unnumbered) Make sure you are not using (have not mounted) any logical disks. Note that logical disks are not automatically dismounted when you turn off your computer. Make sure you have the minimum number of contiguous blocks of free space specified in the (RT--11 Update Release Notes). Have a new TK50 magtape available.

(Procedure\bold) (numbered) Insert the update TK50 magtape in the magtape drive. Bootstrap the update TK50 magtape (this will take about 5 minutes): (MSBOOT V05.0x) (*)(MDUP.UP(RET)) (MDUP V05.x) (*)(/V:400.) (*)(VM0:/Z/B) (?MDUP-I-No bad blocks detected VM0:) (*)(VM0:A=MU0:)

When you have bootstrapped the update TK50 magtape, virtual memory is booted and the following dialogue begins: Welcome to RT-11 UPDATE (). This kit updates the following products: ( Please refer to the RT-11 Update User's Guide for assistance with this UPDATE session. Please enter today's date (dd-mmm-yy) Enter the date as (dd-mmm-yy), where (dd) represents the day, (mmm) represents the first three characters of the name of the month, and (yy) represents the year.

When you have done so, the following is displayed: The UPDATE system is now running from Virtual Memory (VM). The update () kit will be copied to a logical disk. The device that you specify must have (). contiguous free blocks. To which device do you want the update () kit copied? (ddn) Type the 3-character code for the device to which the update kit will be copied (your fixed disk or another device that has enough contiguous free space). (unnumbered) If you specify a removable disk device, the following message appears: Mount the volume which the update () kit will be copied to in ddn: Continue? [Y/N]

When you have mounted the volume in the specified device, type Y in response to the (Continue?) prompt. If you type N, UPDATE repeats the prompt. If the device you specified does not have enough contiguous free space, these messages appear: ;?UP-E-Not enough contiguous free space on ddn: Do you want to use another device? [Y/N]

Type N if you want to end the UPDATE session and prepare your disk by using the DELETE and SQUEEZE commands. If you type Y, you are prompted again for another device. If the device you specified has enough contiguous free space, the dialogue continues: The following procedure should produce an informational message in the form ?DUP-I-Message. No action is required as a result of this message. ?DUP-I-No bad blocks detected ddn: ....Now copying update () TK50 tape to LD0: UPDATE then asks if you want to update one of the products on the update kit: Do you want to update ()? [Y/N] (unnumbered) If you type N, UPDATE specifies another product. When there are no more products on the update kit to specify, the UPDATE session ends, and the monitor prompt (.) appears as shown at the end of this section. If you type Y, the following messages appear: The () kit will be copied to a logical disk. The device that you specify must have (). contiguous free blocks. To which device do you want the () () kit copied? (ddn) Type the 3-character code for the device to which the product kit will be copied (your fixed disk or another device that has enough contiguous free space). (unnumbered) If you specify a removable disk device, the following message appears: Mount the volume which the () () kit will be copied to in ddn: Continue? [Y/N]

When you have mounted the volume in the specified device, type Y in response to the (Continue?) prompt. If you type N, UPDATE repeats the prompt. If the device you specified does not have enough contiguous free space, these messages appear: ;?UP-E-Not enough contiguous free space on ddn: Do you want to use another device? [Y/N]

Type N if you want to end the UPDATE session and prepare your disk by using the DELETE and SQUEEZE commands. If you type Y, you are prompted again for another device. If the device you specified has enough contiguous free space, the dialogue continues: The following procedure should produce an informational message in the form ?DUP-I-Message. No action is required as a result of this message. ?DUP-I-No bad blocks detected ddn: Dismount the update TK50 and store it in a safe place. Mount the volume labeled () in MU0. Make sure the TK50 device is on line. Press RETURN when ready. Press (RETURN). (alphabetic) The product distribution is then copied to another logical disk: ....Now copying () TK50 to LDn:

The time required for copying to a logical disk varies from 5 minutes to 1 hour, depending on the product or products included in the update kit. You may or may not see the following messages, depending on the utility used for the copy operation: ?BUP-I-Restore operation started from volume 1 ?BUP-I-Copy operation is complete After the copy operation is complete, the dialogue continues: NOW READING IN DATA FILE.... WORKING ... Now updating ()

When the updated modules are copied to the logical disk, UPDATE displays messages similar to the following. The N/YY in the display represents the version number of your update release (for example, the first update release in 1989 is 1/89): The updated () kit will be copied to a new TK50. Select a blank TK50, label it "UPDATED N/YY ()" and mount it in MU0:. Please be sure the TK50 device is on line..... Please be sure your output device in MU0 is not write protected... Continue? [Y/N] Dismount the product TK50 magtape and mount a blank TK50 magtape in the same device. Respond to the (Continue?) prompt. (unnumbered) If you type N, the messages repeat to let you mount another TK50 magtape. If you type Y, the dialogue continues, and the following messages may or may not appear, depending on the utility used for initializing the TK50 magtape: The next procedure initializes MU0:. As a result, any files that currently reside in MU0 will be permanently lost. If you would like to retain these files unload MU0 and insert another TK50. Do you want to use the TK50 that is mounted in MU0? [Y/N] (unnumbered\-) If you type N, the messages repeat to let you mount still another TK50 magtape. If you type Y, the dialogue continues. The following message may or may not appear, depending on the utility used for the copy operation: ....Now copying () to MU0:

The time required for copying to a logical disk varies from 5 minutes to 1 hour, depending on the product or products included in the update kit. You may or may not see the following messages, depending on the utility used for the copy operation: ?BUP-I-Creating volume 1 ?BUP-I-Verify pass started.... ?BUP-I-Copy operation is complete When UPDATE has finished updating a product, UPDATE does the following: (unnumbered) If there are more products on the update kit to specify, UPDATE displays the question: Do you want to update ()? [Y/N]

If you type Y, the UPDATE session repeats for the specified product. If you type N, UPDATE specifies another product. If there are no more products on the update kit to specify, the UPDATE session ends and the following message and monitor prompt (.) appear: The UPDATE session has completed successfully. (

The UPDATE logical disk is dismounted and deleted. The product logical disk remains mounted and is not deleted. See the product chapter in the (RT--11 Update Release Notes) for the file name of the product logical disk. @ () .