A Creating a Consolidated Firmware CD-ROM

A consolidated firmware CD-ROM lets you upgrade your processor firmware at the same time that you install the operating system. This appendix describes how to create a consolidated firmware CD-ROM, which requires the operating system CD-ROM in UFS format and the required Alpha Systems Firmware CD-ROM. The following information is included in this appendix:

How to prepare for the build (Section A.1.1)

How to build the consolidated firmware CD-ROM (Section A.1.2)

Sample sessions for both the build preparation (Section A.2.1) and the actual building (Section A.2.2) of the consolidated firmware CD-ROM

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

A.1 Build Instructions

The following sections describe how to prepare and build a consolidated firmware CD-ROM.

Note

The examples in this appendix use the C shell.

A.1.1 Prepare for the Build Session

After you receive a new kit, follow these steps to move the necessary files from the CD-ROM to working directories on the build machine:

Log in as root or use the su command to gain superuser privileges.

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, to set partition a of dsk6 starting at offset 0 with a size of 1300480, and create mount point /cdimage:
```
% disklabel -F -r -e /dev/disk/dsk6
write new label [y] y
% mkdir /cdimage
```

Mount the operating system CD-ROM to a temporary mount point (such as /mnt) and use the tar command to copy the contents of the CD-ROM onto a suitably large directory on the system (at least 1.5 Gb). After this is done, unmount the CD-ROM.

Note

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

For example, using /spare as the target directory and /dev/disk/cdrom4 as the CD-ROM drive:
```
% mount -r /dev/disk/cdrom4a /mnt
% cd /mnt
% tar cf /spare/os_copy.tar .
% cd /
% umount /mnt
```

A.1.2 Build the Consolidated Firmware CD-ROM

After you have completed the steps in Section A.1.1, follow these steps to consolidate the necessary data to a single CD-ROM in ISO9660-compliant format:

Log in as root or use the su command to gain superuser privileges.

Use the newfs command to initialize a file system on the partition reserved in Step 2 of Section A.1.1 and mount it to the mount point /cdimage. If you are prompted for confirmation, enter y. Use the tar utility to copy the base operating system image created in Step 3 of Section A.1.1 to /cdimage.

Note

This step may take as long as 60 minutes to complete.
For example, using /spare as the source and dsk6c as the target partition:
```
% newfs /dev/disk/dsk6c
% mount /dev/disk/dsk6c /cdimage
% cd /cdimage
% tar xpf /spare/os_copy.tar
% cd /
```

Optionally use the following multiple step operation to copy the firmware images to the target directory:
1. Mount the Alpha Systems Firmware CD-ROM to a temporary mount point such as /mnt. For example, using /dev/disk/cdrom4a as the CD-ROM drive:
```
% mount -t cdfs -r /dev/disk/cdrom4a /mnt
```
2. Copy the System Marketing Model (SMM) table from the Alpha Systems Firmware CD-ROM to the target directory. The SSM table maps system models to firmware image files.
```
% cp /mnt/SMMTABLE.TXT\;1 /cdimage/smmtable.txt
```
  Caution
  
  The target file name must be in lower case 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 by entering the following command:
```
% more /cdimage/smmtable.txt
```
  As an example, the entry for the EV5 AlphaServer 1000A platform is similar to the following example (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 example, the firmware file on the CD-ROM is AS1000A_E5_V5_1.EXE;1.
4. Create the required firmware directories in the target directory, and copy each of the platform firmware images that you want from the Alpha Systems Firmware 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 is as1000a_e5_v5_1.exe.
  
  For example, using the file names on the Alpha Systems Firmware CD-ROM:
```
% mkdir /cdimage/alpha800
% mkdir /cdimage/alpha1000a
% mkdir /cdimage/as4x00
% 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
% cp /mnt/AS4X00/AS4X00_IMAGE.EXE\;1 \
     /cdimage/as4x00/as4x00_image.exe
```
5. Unmount and remove the firmware CD-ROM.
```
% umount /mnt
```
Note

You cannot repackage firmware or software unless you have a specific licensing agreement with the manufacturer that allows you to do so.

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:
```
% /usr/sbin/mkisofs -D -R -a -d -o \
 /spare/cons_oper_sys.cdfs /cdimage/
```
Refer to the mkisofs(8) reference page for more information.

Use the disklabel command to insert a label into the file generated in Step 4.
```
% disklabel -r -w -t cdfs -f \
 /spare/cons_oper_sys.cdfs \
 /mdec/rzboot.cdfs /mdec/bootrz.cdfs
```
Refer to the disklabel(8) reference page for more information.

The CD image file /spare/cons_oper_sys.cdfs is ready to be written to a CD-ROM.

A.2 Sample Build Session

The following assumptions are made for the examples in this section:

The target partition is on /dev/disk/dsk6c.

The /spare directory has at least 1.5 Gb of free space.

The CD-ROM drive is /dev/disk/cdrom4.

Note

The examples in this appendix use the C shell.

A.2.1 Preparing for the Build Session

Follow these steps to prepare for the CD-ROM build session:

Log in as root or use the su command to gain superuser privileges.

Enter the following commands:

% cd /
% disklabel -F -r -e /dev/disk/dsk6
write new label? [y] y
% mkdir /cdimage

Place the operating system CD-ROM into the CD-ROM drive, and enter the following commands:

% mount -r /dev/disk/cdrom4a /mnt
% cd /mnt
% tar cf /spare/os_copy.tar .
% cd /
% umount /mnt

Remove the operating system CD-ROM from the drive. The preparatory steps are complete.

A.2.2 Building the Consolidated Firmware CD-ROM

Follow these steps to build a consolidated firmware CD-ROM:

Log in as root or use the su command to gain superuser privileges.

Enter the following commands:

% cd /
% newfs /dev/disk/dsk6c
% mount /dev/disk/dsk6c /cdimage
% cd /cdimage
% tar xpf /spare/os_copy.tar
% cd /

Place the Alpha Systems Firmware CD-ROM into the CD-ROM drive, and enter the following command:

% mount -t cdfs -r /dev/disk/cdrom4a /mnt
% cp /mnt/SMMTABLE.TXT\;1 /cdimage/smmtable.txt
% more /cdimage/smmtable.txt

Review the output to determine the required directory and file names for the firmware images that you want.

The following example uses the same firmware images as Step 3 d of Section A.1.2:

% mkdir /cdimage/alpha800
% mkdir /cdimage/alpha1000a
% mkdir /cdimage/as4x00
% 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
% cp /mnt/AS4X00/AS4X00_IMAGE.EXE\;1 \
     /cdimage/as4x00/as4x00_image.exe
% umount /mnt

Remove the Alpha Systems Firmware CD-ROM and enter the following commands:

% /usr/sbin/mkisofs -D -R -a -d -o \
 /spare/cons_oper_sys.cdfs /cdimage/

Output is similar to the following:

Using OSFMANWO.000;1 for \ 
/cdimage/ALPHA/BASE/instctrl/OSFMANWOS505.scp \
(OSFMANWOP505.scp)
	Using OSFMANWO.001;1 for \
/cdimage/ALPHA/BASE/instctrl/OSFMANWOS505.inv \
	(OSFMANWOP505.inv)
	Using OSFMANWO.002;1 for \
 /cdimage/ALPHA/BASE/instctrl/OSFMANWOS505.ctrl \
	(OSFMANWOP505.ctrl)
                .
                .
                .
	Using PROCFS_V.000;1 for \
 /cdimage/usr/sys/procfs/procfs_vnops_stubs.c	\
(procfs_vfsops_stubs.c)
	  3.92% done, estimate finish Fri May 19 15:36:59
	  5.87% done, estimate finish Fri May 19 15:39:24
                .
                .
                .
	 99.74% done, estimate finish Fri May 19 15:41:52
	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)

Note

The backslashes ( \ ) in the previous example indicate line continuation and are not present in the output.

Enter the following commands:

% disklabel -r -w -t cdfs -f \ 
 /spare/cons_oper_sys.cdfs \ 
 /mdec/rzboot.cdfs /mdec/bootrz.cdfs

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