J Creating a DIGITAL UNIX Consolidated CD-ROM

J.1 Introduction

This appendix describes how to create a consolidated CD-ROM for DIGITAL UNIX Version 4.0E. A consolidated CD-ROM allows you to simultaneously upgrade the processor firmware while installing DIGITAL UNIX.

J.1.1 Description

This release includes the documentation ( disklabel(8) and mkisofs(8) reference pages) and utilities that you need to construct a consolidated DIGITAL UNIX CD-ROM in ISO 9660-compliant Rock Ridge format.

Although support for booting a consolidated distribution ISO 9660-compliant Rock Ridge format CD-ROM was added in DIGITAL UNIX Version 4.0D, the tools to create the media were not supplied until Version 4.0E was released, making Version 4.0E the minimum revision for creating a consolidated CD-ROM.

J.1.2 Requirements

To build a DIGITAL UNIX consolidated CD-ROM, the following is required:

The DIGITAL UNIX Version 4.0E Operating System CD-ROM in UFS format
The DIGITAL UNIX Documentation CD-ROM in CDFS format
The appropriate Alpha System firmware update CD-ROM

J.2 Build Instructions

The following sections explain how to prepare and build the DIGITAL UNIX consolidated CD-ROM.

J.2.1 Preparing for the Build

After you receive a new kit, perform the following steps to move the necessary files from the CD-ROM to working directories on the build machine.

Note

The examples in this document use the C shell.

Use the disklabel utility to set up a 635 Mb partition on a spare disk, starting at block 0, with a size of 1300480 512-byte blocks and a file system type of unused. Create a mount point for this partition (such as /cdimage) to use later. For example, enter the following commands to set partition c of device rz6 to start at offset 0 with a size of 1300480, and create mount point /cdimage:
% disklabel -F -r -e rz6 write new label [y] y % mkdir /cdimage
Mount the DIGITAL UNIX Version 4.0E Operating System CD-ROM to a temporary mount point (such as /mnt) and use the tar utility to copy the contents of the CD-ROM onto a suitably large directory on the system (at least 1.5Gb). Once this is done, unmount the CD-ROM. For example, using /spare as the target directory and rz4 as the CD-ROM drive, enter the following commands
% mount -r /dev/rz4c /mnt % cd /mnt % tar cf /spare/digital_unix_v40e.tar . % cd / % umount /mnt

Note
This step may take as long as 60 minutes to complete.

J.2.2 Building the Consolidated CD-ROM

Once you have completed the steps in Section J.2, perform the following steps to consolidate the necessary data to a single CD-ROM in ISO 9660-compliant Rock Ridge format:

Use the newfs command to initialize a file system on the partition reserved in step 1 of Section J.2 , and mount it to the mount point /cdimage. If you are prompted for confirmation, enter y. Use the tar utility to copy the DIGITAL UNIX base operating system image created in step 2 of Section J.2 to /cdimage. For example, using /spare as the source and rz6c as the target partition, enter the following commands:
% newfs /dev/rz6c % mount /dev/rz6c /cdimage % cd /cdimage % tar xf /spare/digital_unix_v40e.tar % cd /

Note
This step may take as long as 60 minutes to complete.
Copy the firmware images to the target directory. This is a multipart operation:
1. Mount the appropriate Alpha System firmware update CD-ROM to a temporary mount point such as /mnt. For example, using /dev/rz4c as the CD-ROM drive enter the following command:
  % mount -t cdfs -r /dev/rz4c /mnt
2. Copy the SMM table from the appropriate Alpha System firmware update CD-ROM to the target directory.
  % cp /mnt/SMMTABLE.TXT;1 /cdimage/smmtable.txt
  
  Caution
  The target file name must be in lowercase with the " ;1 " removed from the end.
3. Look in the SMM table to find the name and locations of the firmware images to be copied as follows:
  % more /mnt/SMMTABLE.TXT;1
  
  The entry for the EV5 AlphaServer 1000A platform is similar to this (the actual table entry is on one line):
```
27      5       1270,1311,1558,1580-1581        \
[ALPHA1000A]AS1000A_E5_V5_1.EXE;1       \
6       5.1     !       AlphaServer 1000A 5/xxx
```
  In this case, the firmware file on the CD-ROM is AS1000A_E5_V5_1.EXE;1.
4. Create the appropriate firmware directories in the target directory, and copy each of the platform firmware images that you want from the appropriate Alpha System firmware update CD-ROM.
  Caution
  The target file name must be in lower case with the ";1" removed from the end. Otherwise, the fwupgrade program cannot locate the firmware images. If the source file is AS1000A_E5_V5.1.EXE;1, the target file should be as1000a_e5_v5_1.exe.
  For example, using the file names on the appropriate Alpha System firmware update CD-ROM:
  % mkdir /cdimage/alpha800 % mkdir /cdimage/alpha1000a % cp /mnt/ALPHA800/AS800_V5_1.EXE;1 \ /cdimage/alpha800/as800_v5_1.exe % cp /mnt/ALPHA1000A/AS1000A_E5_V5_1.EXE;1 \ /cdimage/alpha1000a/as1000a_e5_v5_1.exe
5. Unmount and remove the Firmware CD-ROM.
  % umount /mnt
Use the mkisofs program to build the target CDFS file image of the directory structure in /cdimage. For example, using /spare as the target location for the image, enter the following command:
% /usr/bin/mkisofs -D -R -a -d -o \ /spare/consolidated_digital_unix.cdfs /cdimage/

Refer to the mkisofs(8) reference page for information about using this program.
Use the disklabel program to insert a label into the file generated in step 3.
% disklabel -r -w -t cdfs -f \ /spare/consolidate_digital_unix.cdfs \ /mdec/rzboot.cdfs /mdec/bootrz.cdfs

Refer to the disklabel(8) reference page for information about using this program.
The CD image file /spare/consolidate_digital_unix.cdfs is ready to be loaded onto a CD.

J.3 Sample Build Session

The following assumptions are made for the examples in the following sections:

The target partion is on /dev/rz6c.
The /spare directory has at least 1.5 Gb of free space.
The CD-ROM drive is /dev/rz4.

The examples in this document use the C shell.

J.3.1 Sample Preparation

This section shows an example of preparing for a build.

Log in as root:
% cd / % disklabel -F -r -e rz6 write new label? [y] y % mkdir /cdimage
Place the DIGITAL UNIX Version 4.0E Operating System CD-ROM in the CD-ROM drive:
% mount -r /dev/rz4c /mnt % cd /mnt % tar cf /spare/digital_unix_v40e.tar . % cd / % umount /mnt
Remove the DIGITAL UNIX Version 4.0E Operating System CD-ROM from the drive.

The preparatory steps are complete.

J.3.2 Sample CD-ROM Build

This section shows an example of building a CD-ROM.

Log in as root:
% cd / % newfs /dev/rz6c % mount /dev/rz6c /cdimage % cd /cdimage % tar xpf /spare/digital_unix_v40e.tar % cd /
Place the appropriate Alpha System firmware update CD-ROM in the CD-ROM drive:
% mount -t cdfs -r /dev/rz4a /mnt % cp /mnt/SMMTABLE.TXT;1 /cdimage/smmtable.txt % more /cdimage/smmtable.txt
Determine the appropriate directory and file names for the firmware images that you want:
% mkdir /cdimage/alpha800 % mkdir /cdimage/alpha1000a % cp /mnt/ALPHA800/AS800_V5_1.EXE;1 \ /cdimage/alpha800/as800_v5_1.exe % cp /mnt/ALPHA/AS1000A_E5_V5_1.EXE;1 \ /cdimage/alpha1000a/as1000a_e5_v5_1.exe % umount /mnt % /usr/bin/mkisofs -D -R -a -d -o \ /spare/consolidated_digital_unix.cdfs /cdimage/ Using OSFMANWO.000;1 for /cdimage/ALPHA/BASE/instctrl/OSFMANWOS425.scp (OSFMANWOP425.scp) Using OSFMANWO.001;1 for /cdimage/ALPHA/BASE/instctrl/OSFMANWOS425.inv (OSFMANWOP425.inv) Using OSFMANWO.002;1 for /cdimage/ALPHA/BASE/instctrl/OSFMANWOS425.ctrl (OSFMANWOP425.ctrl) . . . Using PROCFS_V.000;1 for /cdimage/usr/sys/procfs/procfs_vnops_stubs.c (procfs_vfsops_stubs.c) 3.92% done, estimate finish Thu Oct 23 15:36:59 1997 5.87% done, estimate finish Thu Oct 23 15:39:24 1997 . . . 99.74% done, estimate finish Thu Oct 23 15:41:52 1997 Total extents actually written = 255673 Total translation table size: 0 Total rockridge attributes bytes: 2066594 Total directory bytes: 4239360 Path table size(bytes): 10130 Max brk space used b9ec60 255673 extents written (499 Mb) % /disklabel -r -w -t cdfs -f \ /spare/consolidate_digital_unix.cdfs \ /mdec/rzboot.cdfs /mdec/bootrz.cdfs

The information is consolidated, and the file can be burned onto a CD-ROM.