Chapter 1 Installation Issues

This chapter describes problems relating to the installation of the Solaris 7 11/99 software environment.

The information in this chapter supersedes any information listed in the installation_bugs file that is part of the SUNWrdm package on the Solaris 7 11/99 CD. If you boot from the Solaris 7 11/99 CD, the installation_bugs file is located in the directory:

/cdrom/sol_7_1199_sparc/s0/Solaris_2.7/Docs/release_info/C

The default installed location for the installation_bugs file is located in the directory:

/usr/share/release_info/Solaris_2.7/C

The name of this product is Solaris 7 11/99, but code and path or package path names may use Solaris 2.7 or SunOS 5.7. Always follow the code or path as it is written.

Solaris Web Start Issues

This section only describes known installation issues that may occur when using Solaris Web Start, the browser-based program that enables you to install both the Solaris software and co-packaged software.

Limited Browser Support In Client-Server Mode

To use the client-server mode of Solaris Web Start, you must have one of the following software configurations installed on the client:

• The Solaris 2.6 or Solaris 7 operating environment with its accompanying version of the HotJava^TM, Netscape Navigator^TM 4.0, or Netscape Navigator^TM 4.5 browser

• Windows 95 with the HotJava, Netscape Navigator 4.0, or Netscape Navigator 4.5 browser

Solaris Web Start may not run or display properly with older versions of HotJava, older versions of the Navigator browser, or with Internet Explorer.

Solaris Web Start Bugs

This section only describes known installation bugs that may occur when using Solaris Web Start, the browser-based program that enables you to install both the Solaris software and co-packaged software.

Cannot Move the Root File System (4046659)

You can choose a system disk in Solaris Web Start but you cannot move the root file system off the system disk afterwards.

Workaround: If you need to do this, use the Solaris Interactive Installation program instead of Solaris Web Start.

Products May Not Use All Reserved Space (4059182)

Solaris Web Start reserves disk space based on the total requirements of all the products that you install. If you check disk space allocation after installing but before using the products, you may find a substantial amount of apparently unused space. Some of this space may be taken up when you run the software; some of it may remain unused.

Workaround: If you want to allocate less total disk space than Solaris Web Start requires, use the Solaris Interactive Installation program instead.

Installing With Solaris Web Start in Client/Server Mode May Produce Exception Messages in the HotJava Console Window (4248436)

When installing with Solaris Web Start in client/server mode, you may see the following exception messages in the HotJava console window:

sun.applet.AppletSecurityException: checkaccess.thread
		at java.lang.Throwable.<init>(Compiled Code)
		at java.lang.Exception.<init>(Compiled Code)
		at java.lang.RuntimeException.<init>(Compiled Code)
		at java.lang.SecurityException.<init>(Compiled Code)
		at	 sun.applet.AppletSecurityException.<init>(Compiled Code)
		at sun.hotjava.security.PolicyUntrusted.checkAccess(Compiled Code)
		at sun.hotjava.security.HotjavaSecurity.checkAccess(Compiled Code)
		at java.lang.Thread.checkAccess(Compiled Code)
		at java.lang.Thread.stop(Compiled Code)
		at MouseOverPanel.handleMouseEnter(Compiled Code)
		at SolsticeConfTaskPage.handleEvent(Compiled Code)
		at java.awt.Component.postEvent(Compiled Code)
		at java.awt.Component.postEvent(Compiled Code)
		at java.awt.Component.postEvent(Compiled Code)
		at java.awt.Component.postEvent(Compiled Code)
		at java.awt.Component.postEvent(Compiled Code)
		at java.awt.Component.postEvent(Compiled Code)
		at java.awt.Component.postEvent(Compiled Code)
		at java.awt.Component.postEvent(Compiled Code)
		at java.awt.Component.dispatchEventImpl(Compiled Code)
		at java.awt.Container.dispatchEventImpl(Compiled Code)
		at java.awt.Component.dispatchEvent(Compiled Code)
		at java.awt.EventDispatchThread.run(Compiled Code)
Exception occurred during event dispatching:
sun.applet.AppletSecurityException: checkaccess.thread

When exception messages appear, mouse clicks may become slow to update and some information panels may not display properly.

Workaround: To improve the responsiveness of the mouse and complete the installation process, close the HotJava Console window. Some information panels may not update properly, but this does not affect the installation process. Web Start installs the products that you selected, however, the description may be inaccurate if you have moved the cursor over more than one product.

To prevent the exception messages, do not open the HotJava Console window before or during installation.

Web Start Installer for Solaris 7 11/99 Does Not Install the Netscape Communicator CD Included With Solaris 7 8/99 (4274778)

The Web Start installer in the Solaris 7 11/99 release does not install Netscape from the Netscape^TM Communicator CD included with the Solaris 7 8/99 release. The Web Start installer will prompt you with the following message:

Insert the CD-ROM labeled 'Netscape Communicator 4.51' into the 
CD-ROM drive and continue.

The message appears until you insert the Netscape Communicator CD that is included with the Solaris 7 11/99 release or press the Skip button. If you press the Skip button, Netscape Communicator 4.51 is not installed.

Workaround: You may choose one of the following workarounds:

• If the Netscape Communicator CD included with the Solaris 7 11/99 release is available, insert the CD and continue the installation. To determine if you have the Netscape Communicator CD included with the Solaris 7 11/99 release, look for the following identifying marks:

  • The part number, located under the Sun Microsystems logo on the left side of the CD label, is 704-6912-10.

  • The following text is printed above the phrase "SPARC Platform Edition" on the right side of the CD label:

    Netscape Communicator^TM 4.51

    
    

    Java^TM Plug-In 1.1.2

    
    

    Java^TM Plug-In 1.2

    
    

• If the Netscape Communicator CD included with the Solaris 7 11/99 release is not available, manually install Netscape from the Netscape Communicator CD included with the Solaris 7 8/99 release using the installation wizard ("installer") located in the root directory of the Netscape Communicator CD.

• If you do not want to install Netscape, click on the Skip button in the Web Start installer to continue installing the Solaris 7 11/99 operating environment.

Interactive Installation Bugs

Installation Fails With a False Non-Mountable File System Error (4164303)

The following message may be displayed:

The Solaris operating environment on slice c0t0d0s0 cannot be upgraded.A file system listed in the file system table (vfstab) could not be mounted.

The installation software may interpret inodes that are stored on striped DiskSuite^TM meta devices for root inodes and attempt to mount the meta devices as upgradable slices. When this problem occurs, the mounts fail and the installation aborts.

Workaround: To install the Solaris 7 operating environment:

1. Disconnect the disks that contain DiskSuite meta devices.

2. Restart the Interactive Installation.

TotalNET Advanced Server (SunLink) Drivers Cause Panic After a Reboot (4121961)

 Warning:  mod_install: MT-unsafe driver 'tnatp' rejected panic[cpu0] /
thread=7051e040:mutex-enter:bad_mutex lp=1046aa20 owner=7051e040
thread=7051e040    

An upgrade to TotalNET Advanced Server (SunLink^TM) version 5.2 is required with the Solaris 7 operating environment because of a driver conflict. Version 5.0 and version 5.1 for the TotalNET Advanced Server cause the Solaris 7 operating environment to not boot correctly.

Workaround: Before you install the Solaris 7 operating environment, you must upgrade all installations to version 5.2 for the TotalNET Advanced Server, which is available on the Solaris Easy Access Server 2.0 CD. Follow the instructions provided to upgrade existing TotalNET Advanced Server installations.

Installation Bugs That Occur During an Interactive Installation

Erroneous Messages Indicating Packages Added a Second Time (1235464)

This appears as an attempt to install the same architecture and version of a package that is already installed. This installation overwrites this package.

When upgrading a system with the Entire Distribution plus OEM Cluster, the following packages seem to be added twice:

• SUNWolinc

• SUNWxwdim

• SUNWxwinc

• SUNWxwman

• SUNWxwpmn

• SUNWxwsrc

• SUNWolbk

• SUNWoldim

• SUNWolman

• SUNWolsrc

Installation Progress Bar May Be Inaccurate (1266156)

The "Installing Solaris Software - Progress" bar sometimes indicates that an installation is complete when it is still in progress. The install program may add packages for several minutes after the progress bar has indicated that the installation is complete. Do not rely on the progress bar to indicate that the installation is complete. The installation displays the following message when the program has completed all installation operations:

Installation complete

Installation of Diskless Client Does Not Preserve Changes in the dfstab File on a Server (4045544)

When you upgrade the Solaris operating environment on a server with diskless clients, the options on the dfstab line are not preserved for /usr. For example, if you entered the following in the dfstab file:

share -F nfs -o rw /export/exec/Solaris_2.7_sparc.all/usr

then this entry is automatically replaced with the following entry during the upgrade:

share -F nfs -o ro /export/exec/Solaris_2.7_sparc.all/usr

Workaround: Before you attempt to upgrade the Solaris operating environment on an OS server that has a diskless client or Solstice AutoClient, back up the /etc/dfs/dfstab file for the clients.

Installation Bugs That May Occur During an Upgrade

Multiple Architecture Server Cannot Be Patched (1249343)

After upgrading a server with diskless clients of more than one SPARC kernel architecture, such as a sun4u server with diskless sun4c, sun4d, and sun4m clients, the SUNWkvm packages for clients whose kernel architectures differ from that of the server cannot be patched.

Workaround: Add all of the SUNWkvm packages before applying any patches that affect them:

# pkgadd -d SUNWkvm.*

Disk Space Requirements Can Be Exaggerated By the Upgrade Process (4041733)

The upgrade program can exaggerate, by as much as 30 percent, the amount of space required for upgrades to systems with the Solaris software. Therefore, it prevents many systems from being upgraded without deselecting packages or finding more space.

Workaround: You can manually reallocate disk space among file systems or use the Software Customization menu to remove software packages that are not needed.

sun4m Solstice AutoClients Fail to Mount Cache After an Upgrade From the Solaris 2.6 Hardware: 3/98 Release (4121951)

Solstice^TM AutoClient^TM systems display the following message when rebooting:

fsck -F cachefs: Cache directory /.cache/rootcache does not exist.mount -F cachefs: cache fsck mount failedfsck -F cachefs: Cache directory /.cache/rootcache does not exist.mount -F cachefs: cache fsck mount failed

This directive indicates to the kernel that the root file system is of type cachefs. To determine whether or not a specific Solstice AutoClient system can be affected by this problem before you attempt an upgrade, examine the directory /export/root/client-name/var/sadm/pkg on the server (this is the Solstice AutoClient system's /var/sadm/pkg directory). If this directory contains a subdirectory called TADcar, the Solstice AutoClient system may be affected.

Workaround: Edit the /etc/system file for the Solstice AutoClient systems after the upgrade by appending the following line:

rootfs:cachefs

The Solstice AutoClient systems' /etc/system file is stored on the server as /etc/root/client-name/etc/system.

Clients Do Not Receive All Patches When a Server Is Upgraded (4175220)

Patches located in the Patches directory on the Solaris 7 11/99 CD are not automatically applied to clients whenever a server is upgraded.

Workaround: Apply the patches located in the Patches directory to clients after the upgrade has been completed.

SUNWcvc.u and SUNWdrr.u Packages Are Missing If You Upgrade From the Solaris 2.6 Hardware 3/98 or Solaris 2.6 5/98 Operating Environment to the Solaris 7 Operating Environment (4229675)

After you upgrade from the Solaris 2.6 Hardware 3/98 or the Solaris 2.6 5/98 operating environment and if your systems have sun4u diskless clients or Solstice AutoClient systems, then the SUNWcvc.u and SUNWdrr.u packages are not installed on diskless clients or Solstice AutoClient systems.

Workaround: After you have completed an upgrade, add the SUNWcvc.u and SUNWdrr.u packages to a sun4u diskless client or Solstice AutoClient system as follows with a client called foo:

1. Mount the Solaris 7 11/99 CD for the SPARC platform.

2. Change to the following directory:

   # cd /cdrom/sol_7_1199_sparc/s0/Solaris_2.7/Product

3. Add the following packages using the pkgadd command:

   # pkgadd -R /export/root/foo -d `pwd` SUNWcvc.u # pkgadd -R /export/root/foo -d `pwd` SUNWdrr.u

Errors May Occur During A European Upgrade (4230247, 4225787)

After upgrading from the Solaris 7 3/99, 5/99, or operating environments to the Solaris 7 11/99 operating environment, the following errors may appear in the upgrade logs:

Doing pkgadd of SUNWplow to /.
pkgadd: ERROR: unable to create package object </a/usr/openwin/share/locale/de.ISO8859-15>.
    file type <s> expected <d> actual
    unable to remove existing directory at </a/usr/openwin/share/locale/de.ISO8859-15>
....
Installation of <SUNWplow> partially failed.
pkgadd return code = 2


Doing pkgadd of SUNWpldte to /.
WARNING: /a/usr/dt/appconfig/types/de.ISO8859-15 
may not overwrite a populated directory.
......
pkgadd: ERROR: /a/usr/dt/appconfig/types/de.ISO8859-15 could not be installed.
.......
Installation of <SUNWpldte> partially failed.
pkgadd return code = 2

This warning occurs because the patch switches the affected directories listed in the upgrade logs from symbolic links to directories. The upgrade process then attempts to install an updated version of the package that does not include the change. These errors do not affect the operating environment on your system.

Workaround: Ignore these error messages.

Symbolic Links to SUNWjvrt Are Missing After Upgrading from Solaris 7 (4259033)

After upgrading from the Solaris 7 operating environment using disk space reallocation, the Java commands may not be found due to missing symbolic links.

Workaround: To restore the symbolic links, complete these steps:

1. Remove the SUNWjvdev and SUNWjvrt packages.

   # pkgrm SUNWjvdev SUNWjvrt

2. Re-install the SUNWjvrt and SUNWjvdev packages.

   # pkgadd -d /cdrom/sol_7_1199_sparc/s0/Solaris_2.7/Product SUNWjvrt SUNWjvdev

   ---

   Note -

   If your Solaris 7 11/99 software is mounted somewhere other than the CD-ROM drive, change the argument to the -d option to be the absolute path to the Solaris_2.7/Product directory.

   ---

Solaris Installation Issues

New JumpStart Behavior

When you turn on a system with the JumpStart^TM software already installed (this includes new systems and preinstalled systems on which another installation has been performed) in the Solaris 7 as well as the Solaris 2.6 operating environments, Solaris Web Start's introductory screen is displayed. You can now exit Solaris Web Start and perform a JumpStart installation.

Solaris dtlogin Screen

The Solaris 7 as well as the Solaris 2.6 operating environments default to a login screen when you initially boot your workstation, regardless of which desktop you are using. You can select your desktop from the login screen. The login screen requires the user's name and password. Your desktop is displayed upon authentication of your login name and password. For more information about the login screen, see the dtlogin man page (provided with the Solaris Common Desktop Environment (CDE) man pages) or the Common Desktop Environment: Advanced User's and System Administrator's Guide.

dtlogin Notes for System Administrators

A system administrator who is new to CDE needs to know about CDE's graphical login program, dtlogin. Review the dtconfig man pages.

Solaris Installation Bugs

The SMEvplu.u Package Does Not Install Properly When Upgrading From Solaris 2.5.1 Hardware: 11/97 With Disk Space Reallocation (4190800)

If you are running a SPARCengine^TM Ultra^TM AX system and you are upgrading from the Solaris 2.5.1 Hardware: 11/97 operating environment with Disk Space Reallocation, the SMEvplu.u package does not install properly.

The following message appears in the upgrade_log:

Doing pkgadd of SMEvplu.u to /. 
pkgadd: ERROR: SMEvplu is already installed at /usr.
Admin file will force a duplicate installation at /.

Installation of <SMEvplu> was suspended (administration).
No changes were made to the system.
pkgadd return code = 4

Workaround: Before rebooting, manually remove the exisisting SMEvplu package and install the new SMEvplu.u package.

1. Remove the incomplete SMEvplu package:

   # pkgrm -R /a SMEvplu

2. Change directories to the Solaris 7 Product directory:

   # cd /cdrom/sol_7_1199_sparc/s0/Solaris_2.7/Product

3. Add the correct SMEvplu.u package:

   # pkgadd -R /a -d `pwd` SMEvplu.u

Warnings May Occur When Creating a File System (4189127)

One of the following error messages may be displayed when creating a file system during installation:

Warning: inode blocks/cyl group (87) >= data blocks (63) in last
    cylinder group. This implies 1008 sector(s) cannot be allocated.

Or:

Warning: 1 sector(s) in last cylinder unallocated

The warning occurs when the size of the file system being created does not map exactly to the space on the disk being used. This can result in unused space on the disk that is not incorporated into the indicated file system. This unused space is not available for use by other file systems.

Workaround: Ignore the error message.

Not All Locales Supported Outside of Entire Metacluster (4181942)

All locales are supported only in the Entire Distribution and Entire Distribution plus OEM metaclusters. Subsets of these locales are supported in the Developer, End User, and Core metaclusters.

If you select a locale at the beginning of the installation that is not supported by the metacluster that you choose to install later in the installation on the metacluster selection screen, the following occur:

• Web Start installation of co-packaged products fails without installing the co-packaged products.

• You cannot open terminal windows in CDE.

For Desktop editions of the Solaris 7 11/99 operating environment, the Web Start installer installs the End User metacluster. For Server editions of the Solaris 7 11/99 operating environment, Web Start installs the Entire metacluster. You can change the defaults by selecting a Custom installation.

The following table indicates which locales are supported by each metacluster:

Workaround: To prevent the problem, install the metacluster that contains the desired locale.

To repair an existing installation in the /etc/default/init file, change the references to the unsupported locale to reference a supported locale for the installed metacluster.

Font Package Warning Occurs During Installation (4226416)

The font packages listed below in the warning messages cover all language locales, including those that may not be on your Solaris CD. If you cannot find all the packages listed in the warning message, then only install those packages that you can find on your CD.

Warning!  It is strongly recommended that the following font package be 
installed for all locales:

SUNWi1of

Warning!  It is strongly recommended that the following font packages be 
installed to support locales (other than ISO8859-1 locales) as needed:

SUNWi2of SUNWi2rf SUNWi4of SUNWi4rf SUNWi5of SUNWi7of SUNWi7rf
SUNWi9of SUNWi9rf SUNWjxcft SUNWkcoft SUNWcttf SUNWhttf SUNW5xfnt

This message is only advisory and does not indicate an installation failure.

Workaround: Installation of the font packages listed in the warning message is strongly recommended.

Installation of SUNWxilrl Partially Fails on Upgrade (4276484)

If SUNWxilrl is installed on a system being upgraded to the Solaris 7 11/99 operating environment and the /opt directory is on a file system that is being resized or moved during the upgrade, you will see the following error messages:

ERROR: attribute verification of </a/opt/SUNWits/Graphics-sw/xil/lib/libxil.so> failed
    pathname does not exist
    unable to create symbolic link to </usr/openwin/lib/libxil.so.1>
ERROR: attribute verification of </a/opt/SUNWits/Graphics-sw/xil/lib/libxil.so.1> 
failed
    pathname does not exist
    unable to create symbolic link to </usr/openwin/lib/libxil.so.1>
pkgadd: ERROR: postinstall script did not complete successfully

Installation of <SUNWxilrl> partially failed.
pkgadd return code = 2

This partial failure results in the following:

• The /opt/SUNWits/Graphics_sw/xil and /opt/SUNWits/Graphics_sw/xil/lib directories are not recreated.

• The /opt/SUNWits/Graphics_sw/xil/lib/libxil.so and /opt/SUNWits/Graphics_sw/xil/lib/libxil.so.1 symbolic links to /usr/openwin/lib/libxil.so.1 are not created.

Workaround: Recreate the directories and symlinks after the upgrade has completed.

1. Complete the upgrade.

2. Reboot the upgraded system.

3. Recreate the xil/lib directory:

   # /usr/sbin/install -d -m 0755 -u bin -g bin /opt/SUNWits/Graphics-sw/xil # /usr/sbin/install -d -m 0755 -u bin -g bin /opt/SUNWits/Graphics-sw/xil/lib

4. Recreate the symbolic links:

   # ln -s /usr/openwin/lib/libxil.so.1 /opt/SUNWits/Graphics-sw/xil/lib/libxil.so # ln -s /usr/openwin/lib/libxil.so.1 /opt/SUNWits/Graphics-sw/xil/lib/libxil.so.1

System Administration Installation Bugs

Addition of Solaris 7 Service to an OS Server Results in an Upgrade Failure Message (4171470)

When the Solaris 7 system software is added to an OS server as a service, the following error message is displayed:

celebris:  Error:  Error adding OS service Solaris 2.7 i386 i86pc: 
service modification failed.
See /var/sadm/system/logs/upgrade_log for more information
(/var/sadm/install_data/upgrade_log on Solaris 2.3 or 2.4).

Where celebris is the name of the OS server.

If you review the indicated log file, you will see that the addition of the SUNWplow package failed with the following message:

Doing pkgadd of SUNWplow to /.
ERROR: attribute verification of <export/exec/Solaris_2.7_i386.all/etc/default/init> failed
pathname does not exist

Workaround: Ignore the error message.

User Disabling of Daemons and Servers in inetd.conf Overridden by Package Instance (4220923)

The interactive installation program adds lines for the KCMS Profile Server, Font Server, CacheFS Daemon, and Kerbd Daemon even though they already exist and are commented out in /etc/inetd.conf.

Workaround: The unnecessary entries in /etc/inetd.conf can be deleted or commented out with a text editor.

64-Bit Solaris Issues

This section describes installation-related 64-bit Solaris issues.

Sun UltraSPARC System (sun4u) May Need Flash PROM (Open Boot) Upgrade

If you want to run the 64-bit Solaris operating environment on an UltraSPARC system, you may need to upgrade its Flash PROM firmware. The Solaris 7 installation programs have a new check box for adding 64-bit support. This new 64-bit support is selected by default when installing on Sun UltraSPARC systems.

If you choose to run the 32-bit Solaris operating environment on any Sun or UltraSPARC system, the Flash PROM upgrade is not needed.

The following table lists the UltraSPARC (sun4u) systems that are affected and the minimum firmware versions needed. If the system is not listed in the table, it does not need a Boot PROM upgrade. Use uname -i to check the system type. Use prtconf -V to identify the firmware version.

For instructions on performing the Flash PROM update using the Solaris CD, refer to the Solaris 7 Sun Hardware Platform Guide. If you do not have this manual, it can be obtained at http://docs.sun.com.

AnswerBook2 Documentation Installation Bugs

Installing SUNWab2u Before SUNWab2r and SUNWab2s Causes Problems (4230969)

Installing the SUNWab2u package before the other AnswerBook2 packages, SUNWab2r and SUNWab2s, causes the following:

• Warning messages will display during the installation

• The scan option will not find any AnswerBook1 collections

• Links between books will attempt to retrieve the book from docs.sun.com, rather than from the local server

Workaround: Use the installer (Web Start utility) or the pkgrm command to remove the SUNWab2u, SUNWab2r, and SUNWab2s packages.

To install the packages in the correct order, use the installer (Web Start utility).

If you install the packages manually using the pkgadd command, install them in the following order:

1. SUNWab2r

2. SUNWab2s

3. SUNWab2u

Solstice AutoClient Installation Issue

The Solstice AutoClient product is not included in the SEAS 3.0 product shipped with the Solaris 7 11/99 release. If you have installed diskless clients and AutoClient systems, you can continue to use those systems. You can manage those systems using an earlier release of Solstice AdminSuite.