TITLE
    AWS 95: Diagnosing Problems Using Upgrade.report (5/94)
Article ID:
Created:
Modified: 		15490
5/31/94
5/31/94
TOPIC


    This article describes how to diagnose problems which may occur during the installation of the Apple WorkGroup Server 95 (AWS 95) upgrade, using Upgrade.report file.

DISCUSSION


    The Upgrade.report file is created by the UNIX portion of the AWS 95 SW Upgrade Installer and can be useful in diagnosing problems which may occur during installation. The UNIX shell script is launched by the Macintosh Installer and unpacks the cpio archive placed in /tmp by the Mac Installer (along with the UNIX installation script), rebuilds the UNIX kernel and performs other configuration tasks. The Upgrade.report file contains the standard output and error output from the installation script.

    The following is a description of the Upgrade.report file contents. For a complete understanding of the installer's actions, you need to examine the installer shell script itself. As you read the description below, you may find it helpful to have a copy of a successful upgrade report to follow along with.

    The Upgrade.report file is re-created each time an installation is performed. Any previous Upgrade.report files are lost.

    * First, the installation script version number is displayed along with the
    current date & time and the machine configuration as reported by
    uname(1).

    * The current kernel configuration parameters, see kconfig(1m). The
    installer attempts to preserve these configuration parameters (see
    below), paying special attention to the NBUF parameter.

    * A list of files from the cpio archive, reported by cpio as they are
    installed. You may see error reports regarding missing directories if
    the server does not have the development tools packages installed; this
    is ok.

    * The modification time of /etc/init is reset; it represents the volume
    creation date for the virtual UNIX volume, '/'.

    * Next you may see reports of kernel configuration files being re-linked.

    * The output of the autoconfig(1m) command showing which modules are
    installed in the kernel.

    * Depending on the server configuration, the text files /etc/inittab and
    /usr/lib/sendmail.cf may be modified. The installer script displays the
    changes in diff(1) format and leaves the original file in
    "filename".orig.

    * Any custom values of the kernel configuration are restored and output.

    * Finally, the script displays the contents of the Macintosh Installer's
    temporary directory and removes the directory and its contents.


    Support Information Services

Document Information
Product Area: Computers
Category: Workgroup Servers
Sub Category: Workgroup Server 95

Copyright © 2000 Apple Computer, Inc. All rights reserved.