This procedure must be used if your system is currently running ptx/SVM V2.x and you want to upgrade DYNIX/ptx and/or layered products on an alternate disk.
ATTENTION If you are upgrading from DYNIX/ptx V4.4.x, the "Software Patches for Upgrading from DYNIX/ptx V4.4.x/V4.5.x to V4.5.x/V4.6.x" CD must be installed before the upgrade to V4.5.3. Consult the README file on the CD for more information.
If /var/ees is created as a separate filesystem, it must not be under SVM control.
Following is a summary of the upgrade procedure.
Perform the pre-installation tasks described in Part 1 of the "Upgrade Checklist" in Chapter 1. Be sure to back up the root filesystem and record the system bootflags.
Break the ptx/SVM mirror of the root volume. (If the root volume is not mirrored, you will need to create a mirror.) See "Prepare for the Installation" in this chapter.
ATTENTION If you need to increase the size of the root partition, follow the instructions in Appendix C instead of using the "Prepare for the Installation" section.
Install the new software. See "Install Software With the ALT DISK DELTA Procedure" in this chapter. Build the kernel, but do not have ptx/INSTALL reboot the system.
Complete the installation as described in Part 3 of the "Upgrade Checklist" in Chapter 1.
Be sure to return the device used for the installation to the rootdg (see "Prepare to Reboot the System" in this chapter) before you reboot the system.
When you have completed the installation on the Symmetry system, reestablish the mirror. See "Mirror the Original Root Partition to the Upgraded Root Volume" in this chapter.
ATTENTION If you need to increase the size of the root partition, follow the instructions in Appendix C instead of using the information in this section.
Complete the following steps to prepare your system for the installation:
If your root volume is not mirrored, create a mirror on another partition. The partition must be on a local bus and be the same size as the original root plex. This partition will be used as the alternate disk partition during the software installation.
To mirror the root volume, complete the following steps. In the following example, the mirror is created on partition sd3s0:
# vxdisk -f init sd3s0
# vxdg adddisk sd3s0
# vxassist mirror ROOTVOL sd3s0
This procedure takes approximately five minutes. The following message may appear during the procedure; it can be ignored.
vxbootsetup: NOTE: Root file system is not defined on a volume.
Determine the location of the current root partition and the partition that will be used for the alternate disk installation. The alternate disk partition must be a mirror of the root volume. It cannot be the partition from which the system is currently booted.
To determine the current root partition, enter the following command.
# bfget -r
root_dev=sd0s0:0:0
ATTENTION bfget reports the current bootflag setting for the boot disk. If the installation fails and is restarted, the bootflag may have already been reset to the alternate disk.
To determine the partition to be used for the alternate disk installation, enter the following command.
# vxprint -ht -g rootdg ROOTVOL
Select the plex that is not associated with the boot disk.
Disassociate the selected mirrored plex from the root volume. Before performing this step, ensure that your system is as idle as possible to avoid filesystem corruption on the alternate disk. (Later in this procedure, you will run fsck to verify the integrity of that filesystem.)
# sync; sync; vxplex dis ROOTVOL-sd3s0
Remove the plex and subdisk from the rootdg's records:
# vxedit -r rm ROOTVOL-sd3s0
Remove the disk media record from the rootdg.
# vxdg rmdisk sd3s0
ATTENTION If you should need to reboot the system after this point, you must boot on your current boot device, not on the new alternate disk. This may require changing your current boot flags to match those recorded earlier. (You cannot boot from the alternate disk until you have completed step 3 in the later section "Prepare to Reboot the System.")
Check the integrity of the filesystem on the newly detached device. If you are using an EFS filesystem, include the -F efs option.
ATTENTION If the device has not previously been devbuilt, run the devbuild vtoc <device_name> command on the device before invoking fsck.
# fsck -y /dev/rdsk/sd3s0
Mount the partition to be used for the install as /mnt. If you are using an EFS filesystem, include the -F efs option.
# /etc/mount /dev/dsk/sd3s0 /mnt
Perform the installation as described in the next section, "Install Software with the ALT DISK DELTA Procedure." Build the default kernel, but do not have ptx/INSTALL reboot the system.
ATTENTION The SequentLINK product cannot be installed with the ALT DISK DELTA procedure. Use the ROOT procedure to install this product after updating the base operating system.
If /usr/ssw is a separate filesystem, the cfwdl-Compatible Firmware Bundle product cannot be installed with the ALT DISK DELTA procedure. Use the ROOT procedure to install the product after updating the base operating system. Refer to the cfwdl-Compatible Firmware Bundle Release Notes to determine whether you need any of the firmware provided with this product.
ATTENTION Be sure to delete any unsupported products before starting the installation. See Table 2-3, "Software to Deinstall."
To install software packages, use the following procedure. You must be root to perform the installation.
Insert the distribution CD into the CD-ROM drive.
Issue the menu command to start ptx/ADMIN; then go to the Software Management Menu.
Use System Administration -> Software Management
ATTENTION If the menu system does not display properly, suspend or leave the menu system and type the following command: stty -tabs
If you want to check the contents of the CD, select the "List Software Packages Available on Installation Distribution" option.
Select the Install Software Package option.
Specify the installation source, which can be either CD-ROM, nfs, or directory.
Installation Source Type Enter installation source type ___________
Specify the location of the installation source on the screen that appears next:
If the source is CD-ROM, enter the name of the CD-ROM device, such as cd0.
If the source is nfs, specify the remote host and directory containing the software. For example, if you are installing software from a CD-ROM on a remote machine, specify the mount point of thecd device as the directory.
If the source is directory, specify the pathname to the directory.
On the Installation Type window, select the ALT DISK DELTA installation type.
Installation Type Installation Type Description ________________________________________________________________________ ROOT Install on current root, /usr partitions # ALT DISK DELTA Install on mounted alternate root partition INIT ALT DISK DELTA Make copies of current partitions and install on it SCRATCH Initial install on alternate disk #
The Change Installation Disk form will ask you to specify the root partition on the alternate disk (for example, /dev//dsk/sd3s0). The alternate disk must be a local disk attached directly to the CSM. The disk you specify is considered to be the installation disk for the Software Management menu options listed on the form.
Change Installation Disk Enter root partition on alternate disk _______ (use the form /dev/dsk/sd0s0). If the corresponding /usr directory is on a separate partition, that partition must be mounted before using this form. The alternate-disk mountpoint must be in the root directory (/mnt is valid; /a/mnt is not). The current installation root disk is disk_name The installation disk value affects these menu selections: Install SW Pkg, Remove SW Pkg, List SW Pkg, Check SW Pkg, and View/Edit Preview Log. The installation disk value stays in effect until changed.
If the CD contains a version of ptx/INSTALL that is newer than the version currently on your system, the new version will be installed automatically.
At the next screen, answer N.
C2-Certifiable Product Installation Install only those products which N are C2-Certifiable? (Y/N) Enter 'Y' to install only products which are C2-Certifiable
Do not answer Y; DYNIX/ptx V4.5.x has not been certified for C2-level security.
Select the software packages to be installed from the Select Software Packages window. You can select multiple packages. The packages can be both new installations and updates to existing products. Following is an example of this window.
Select Software Packages Part Number Name Description Version ________________________________________________________________ 1003-xxxxx-xx base DYNIX/ptx(R) Base V4.5.3 # 1003-xxxxx-xx base_comms ptx/BaseComms V1.2.1 N 1003-xxxxx-xx nfs ptx/NFS V4.7.2
ATTENTION ptx/SPDRIVERS should be installed before you build the kernel. You will see warnings if this product is not installed.
If you are not already running the latest versions of the CSM and QCIC software, be sure to install them. These versions are required to boot the system without the distribution CD.
ATTENTION Do not install the Fibre Channel Switch software. This software is used only on IBM xSeries 430 and NUMA-Q 2000 systems.
Certain software products require that you enter a license password into the system nodelock file before the product can be installed. If the license password has already been entered, the letter L will precede the entry for that product in the Select Software Packages window. If the license password has not been entered, the letter N will appear. License passwords are not required for products that do not specify one of these letters.
ATTENTION If you selected several products that require licenses, it might take a few minutes for the next installation screen to appear.
If you have selected a software package that requires a license password but you have not yet entered the password into the system nodelock file, a window listing the name of the product will be displayed. Select either "enter the license for that product" or "deselect the product."
If you choose to enter the license password, the following form will be displayed. You must enter the license password, the expiration date, and the license checksum. The other values will be filled in for you. (The license information for the products you have purchased is located in the license folder shipped with your software.)
Add Installation License Enter the product name ________ Enter the product version ________ Enter the node ID ________ Enter the vendor ID ________ Enter the license password ________ Enter the expiration date ________ Enter the license checksum ________
The license entries you specify are added to the system nodelock file, /var/netls/nodelock.
Some software products are automatically installed when you select another product. For example, if you are installing the base operating system, products such as ptx/BaseComms and ptx/edb will automatically be installed. If you did not select the automatically installed products on the Select Software Packages screen, ptx/INSTALL will now display a list of products to be installed. The list includes both the products you selected and products that are automatically installed. The letter A precedes the automatically installed products. This screen does not appear if you selected the automatically installed products on the Select Software Packages screen.
Confirm: Products to be installed Part Number Name Description Version _______________________________________________________________________ 1003-xxxxx-xx base DYNIX/ptx(R) Base V4.5.3 # A 1003-xxxxx-xx base_comms ptx/BaseComms V1.2.1 1003-xxxxx-xx nfs ptx/NFS V4.7.2 A = automatically included. SELECT does not alter product list - use CANCEL
ptx/INSTALL now determines whether the products currently on the system are compatible with the products being installed. When a product requires that another product be installed, ptx/INSTALL also verifies that the required product has been selected for installation. If certain products are not compatible or if required products have not been selected, the following form will appear. You can either reselect products or abort the installation.
Compatibility Error View compatibility errors? (Y/N) _ Enter 'Y' to display the product incompatibilities identified. You can then reselect products to install and continue the installation. Answer 'N' to abort installation
ptx/INSTALL requires additional information to install certain layered products. At this point, you will be asked for that information. For example, a product might include optional components; you will need to specify whether you want to install those components. Most of these screens are self-explanatory.
If you are installing ptx/LICENSE, refer to the ptx/LICENSE Release Notes for a description of the installation and configuration screens that appear. In particular, do not configure ptx/LICENSE if ptx/TCP/IP is not already configured for networking on your system.
ptx/INSTALL now verifies that there is adequate filesystem space to install the selected products.
ATTENTION The installation will require approximately 150 MB of disk space in addition to the amount calculated by ptx/INSTALL.
If there is not enough space, ptx/INSTALL halts the installation and displays the following form. Enter Y at the prompt to review any problems.
Disk Space Error View info on disk space insufficiencies? ___ Enter 'Y' to display products whose disk space requirements will not be met. Enter 'N' to abort the installation. You may restart the installation once the disk space requirements for all selected products have been resolved.
When adequate disk space is available, you can resume the installation by selecting the Install Software Package option from the Software Management menu.
ptx/INSTALL now creates a preview log for each product to be installed. The preview log specifies whether file conflicts exist for the product. File conflicts can occur when the version of a file currently on the system differs from the original file, from the version of the file on the CD, or from both. You will need to resolve certain file conflicts manually. You can either halt the installation and resolve those file conflicts now, or continue with the installation and resolve the conflicts after the software is installed.
Appendix B lists file conflicts that may occur for DYNIX/ptx and ptx/TCP/IP. Be sure to review this information to help you determine whether you want to resolve file conflicts now or after the installation is complete.
Conflict File Resolution Resolve files in conflict now? (Y/N) __ Enter 'Y' to preload conflict files and temporarily exit to view preview logs and resolve files in conflict. Enter 'N' to continue with installation, and resolve files in conflict after the installation is completed.
To resolve any conflicts after the installation is complete, answer N on the form. The installation will continue as specified in the preview logs for the selected products and the old files will be moved to the <product_name>/oldfiles directories.
To resolve the conflicts now, answer Y on the form. The files in conflict will then be preloaded and the installation will exit. To locate file conflicts, use the View/Edit Preview Logs menu option from the Software Management menu to examine the preview logs. For details about the preview logs and resolving conflicts, refer to Appendix B.
If conflicts were found, the following form will specify where the files in conflict will be preloaded. You can change the locations for preloading new conflict files and saving the currently installed version (the old version) of conflict files.
The default locations for new and old versions of conflict files are /usr/options/<product>/newfiles.<installation_date-time> and /usr/options/<product>/oldfiles.<installation_date-time>.
Conflict File Parent Directories Enter the parent directory for ____________ preloading new versions of files in conflict (For each product selected, a subdirectory of the form 'PRODUCT_NAME/ newfiles.<installation_date_time>' will be created) Enter parent directory for saving ____________ old versions of files in conflict (For each product selected, a subdirectory of the form 'PRODUCT_NAME/ oldfiles.<installation_date_time>' will be created)
If you exited the installation to resolve conflicts, you can resume the installation by selecting the Install Software Package option from the Software Management menu.
ptx/INSTALL now determines whether the kernel needs to be recompiled after the installation is complete. Typically, this is needed only when the products to be installed contain kernel components. You can override the value specified on the form.
We recommend that you answer Y on the form. ptx/INSTALL will then build a default kernel that includes the layered products you have installed. This kernel is needed to boot the operating system properly.
The default kernel will not include any local kernel modifications that you have made. After booting the system, you can build your custom kernel and then reboot with that kernel.
Configure and compile a kernel with default parameters Configure and compile a default kernel ____ following installation? (Y/N)
If you chose to have ptx/INSTALL compile the default kernel, the following form appears. The name you specify at the first prompt cannot be std, mfg, or mod.
Configure a kernel with default parameters Enter a unique name to associate with default this kernel and all its associated configuration files Choose a kernel environment type ___ T for TIMESHARE P for PARALLEL C for COMMERCIAL Configure for audit? (Y/N) ___ Enter a short description of this kernel _______ The starting machine type _______ The starting architecture type _______ The starting configuration type _______
If the following situation applies to your installation, the Crosstools Source Type form shown next will appear: you have installed the base operating system on an alternate disk; you are now installing a layered product from another CD on the alternate disk; the layered product includes kernel components but the CD it is on does not include the V4.5.3 kernel compilation tools; you specified that the default kernel should be compiled.
Crosstools Source Type Enter crosstools source type ______ Supported types: CD-ROM, nfs, directory, or NONE (crosstools source only)
Because the tools needed to compile the V4.5.3 kernel are not available, the form allows you to specify an alternate source for the tools. If you have another CD-ROM drive, insert the CD containing DYNIX/ptx V4.5.3 into that drive and enter CD-ROM as the crosstools source type on the form. You will then be asked to specify the name of the CD-ROM device, such as cd1.
If you do not have another CD-ROM drive, use Cancel to exit the installation; then start the installation again. The "Configure and compile a kernel with default parameters" form will be displayed. Enter N at the prompt and compile the default kernel manually when the installation is complete.
Specify whether you want to rebuild the man pages database and reboot the operating system on the installation disk after the software installation is complete.
Rebuilding the man pages takes several minutes. You can also build the man pages at a later time using one of the methods described in the ptx/INSTALL Software Installation Guide.
ATTENTION Do not have ptx/INSTALL reboot the kernel.
Installation Options Rebuild manpages following installation?(Y/N) __ Reboot on installation disk after __ installation? (Y/N) This is the last screen for installation Entering "Run" from this screen will start the installation of files for all selected products.
ptx/INSTALL will now perform the software installation.
ATTENTION If you are performing the installation while booted on DYNIX/ptx V4.4.x, then as layered products are installed, you will see error messages such as the following:
./command.sh[104]:6255 Memory fault(coredump)As long as you have installed ptx/LIP, you can ignore these messages. With ptx/LIP installed, the failed commands will be rerun automatically when the system is booted.
ATTENTION The installation procedure sets both the permanent and the temporary bootpaths to point to the new root disk. If you installed software on an alternate disk, the ptx/ADMIN Set Boot Strings and Flags menu option will not report the updated permanent bootpath until after the system is rebooted. To check the updated bootflags, use the /etc/bootflags command.
If you are upgrading from DYNIX/ptx V4.4.x, a problem in ptx/INSTALL prevents a necessary symbolic link from being created for ptx/SVM. During the installation, the following errors are displayed about this problem:
Installing ptx/SVM /mnt/usr/lib/vxvm/type/fsgen/fs.d/efs/vxsync: No such file or directory /mnt/usr/lib/vxvm/type/fsgen/fs.d/efs/vxsync: No such file or directory Tue Mar 06 15:22:01 PST 2001 svm files are installed successfully
To complete the ptx/SVM installation, you must manually create the necessary symbolic link with the proper owner and group permissions before the system is rebooted on the new root partition:
# ln -s /bin/sync /mnt/usr/lib/vxvm/type/fsgen/fs.d/efs/vxsync
# chown bin:bin /mnt/usr/lib/vxvm/type/fsgen/fs.d/efs/vxsync
ATTENTION If you do not establish this symbolic link, plexes in volumes on EFS filesystems might not be properly synchronized to contain the most recent data when they are detached from the volume.
If you want to install the Volume 2 CD before rebooting the system, run the devdestroy command on the CD-ROM device and then remove the Volume 1 CD. The following example is for the cd0 device:
# /etc/devdestroy /dev/rdsk/cd0
If ptx/INSTALL has already destroyed the device at the completion of the installation, you will see a message about being unable to find the device in the table of built devices.
You do not need to run devdestroy before removing the Volume 2 CD, as it is in ISO-9660 format.
Before rebooting the system, the device where the installation was performed must be returned to the rootdg:
Unmount the alternate disk partition.
# umount /mnt
Reinitialize the private area for the new boot partition:
# vxdisk -f init sd3s0
Add the boot partition as a media record in the rootdg:
# vxdg adddisk sd3s0
Determine the bootpath of the partition containing the newly installed software:
# dumpconf -b sd3s0
Check the bootflags. In the output from the bootflags command, the n0= value should point to the bootpath determined in the previous step.
# /etc/bootflags
If the bootpath is not correct, use the following command to change it:
# /etc/bootflags n0='bootpath'
Also ensure that the loaderPath is correct.
Shut down the operating system.
#shutdown -i0 -g grace_period
If you have new versions of the system firmware, install it as described in the corresponding release notes.
Reboot the operating system. You will see a message such as the following when ptx/SVM starts:
SVM starting in boot mode... Jul 9 17:21:50 vxvm:vxconfigd: Group rootdg: Duplicate virtual device number(s) : Jul 9 17:21:50 vxvm:vxconfigd: Volume ROOTVOLremapped from 121,5 to 121 ,4194302
Return to the "Upgrade Checklist" in Chapter 1 and complete the installation.
If you want to remove the distribution CD from the drive before booting the system, you can. However, the system will boot properly if the distribution CD is left in the drive during the boot operation.
Previously, the documentation instructed you to devdestroy the cd device after the software was installed. This is no longer necessary as ptx/INSTALL now executes any devdestory action that may be required as part of the installation.
ATTENTION If you increased the size of the root partition, do not attempt to mirror the original ROOTVOL plex with the new ROOTVOL. The old plex is now smaller than the new ROOTVOL. You will need to install a new VTOC on the old root disk before creating the ROOTVOL mirror.
When you have completed the installation on the Symmetry system, you can reestablish the root mirror and then reboot on the original boot plex. Complete the following steps:
Remove the old root volume, which is now known as ROOTVOL%1. (If you have multiple boot partitions, this can be a number other than %1, for example ROOTVOL%2.)
Create the new half of the root mirror. (Wait for vxassist to complete before rebooting in step 4). The following example assumes sd0s0 was the original root partition; be sure to specify the correct name. (This name was returned by the bfget -r command in the earlier section "Prepare for the Installation.")
# vxassist mirror ROOTVOL sd0s0
If the following message appears, it can be ignored.
vxbootsetup: NOTE: Root file system is not defined on a volume.
Use ptx/ADMIN to set the bootflags to point to the original root disk. Be sure to specify the correct partition name.
Use System Administration -> System Setup -> Set Boot Flags and Strings
Reboot the system.
We strongly recommend that you mirror the root volume at all times. However, if the root volume was previously unmirrored and you want to continue with that method of operation, enter the following commands to break the mirror. In the commands, plex is the plex associated with the partition that is not being used to boot the system. In the third command, specify the media record associated with that partition.
# vxplex -o norestr dis plex
# vxedit -r rm plex
# vxdg rmdisk media_record
When the CSM software is installed, you may see a message stating that /usr/ssw is not mounted. The message can incorrectly appear even though /usr/ssw is mounted. Also, the complete message is not displayed.
The message is as follows:
ERROR:
A filesystem on a CSM SCSI channel 0 qd or sd disk in the address
range [0..7] must be mounted on /usr/ssw before this software
can be installed. Consult the CSM SW Installation Guide.
It is recommended that the installation be aborted
at this point. However you can continue if you
have a special reason to.
To abort the installation, press Return. If you are sure that /usr/ssw is mounted, enter N. The remainder of the message will then be displayed as shown below and the installation will continue.
Abort installation of CSM firmware? [yes] Checking /usr/ssw
The incomplete message will be repeated later in the installation. Answer N again to finish the installation.