FILE: INSTALL

The following is the procedure for upgrading a Sun386i system with a hard disk.

===============================================================================
Note: Unless you know what you're doing, update all of the Sun386i systems on
your network, especially if it is a YP network. Failures can result if you try
to run 4.0.1 clients with 4.0.2 servers and vice-versa.
===============================================================================

-------------------------------------------------------------------------------
Note: If you have previously edited the /etc/exports file or the /etc/fstab file
and you have disabled (added the # symbol in front of) any line containing
either of these strings of text:

	sun386.sunos4.0.1

	sun386.sunos4.0.2beta

you must re-edit the file(s), removing those comment signs to ensure a
successful upgrade.
------------------------------------------------------------------------------

1. Halt your system.

	superuser> sync;sync;halt

2. Boot you system in single user mode.

	>b -s

3. When you see the # prompt, enter the following command:

	# fsck -y -w

If any problems are found in fsck, be sure to fix them before proceeding!

4. Then enter these commands at the # prompt:

	# mount -at 4.2
	# mount -at lo
	# cd /

5. Insert the upgrade diskette No.1 of 7 and enter the following command:

	# bar xvpfZT /dev/rfd0c ./tmp

Type the above exactly as shown. Note the "0" is a zero.
Bar will list th t(files as it extracts them.

6. Change to the /tmp directory.

	# cd /tmp

7. To begin the installation program, enter the following command:

	# install_update

-----------------------------------------------------------------------------
NOTE: Do not abort the installation after you start it by pressing the
[Stop/L-1]A keys. This can create partial system files on your disk and will
prevent you from rebooting it. The installation procedure will ask you to
confirm or quit at intervals, and it is safe to quit at these times.
--------------------------------------------------------------------------

You will see the message:

	
	This script will upgrade '<systemname>'ok from 4.0.1 to 4.0.2
	Are you sure you want to do this? (y/n)

8. Enter y to proceed.

Next the installation program checks to see if you have room on the hard disk
for the installation.

	Checking to see if enough file space ...

Next you will be asked to identify the type of upgrade media you have:

	What kind of media are you using to install the upgrade?
	1 - Diskette
	2 - 1/4 inch Tape
	3 - Quit the installation now
	Enter [1-3]

9. Enter the appropriate number (1)

You'll see the message:

	Would you like to see the list of files as they are upgraded? (y/n)

10. If you want to see the list, enter y.
Note that entering y adds as much as 30 minutes to installation time.
Next you'll see th message:

	You may now make a back-up of the files that will be changed in
	going from 4.0.1 to 4.0.2. You are encouraged to do so, since it
	will allow you to return to the original 4.0.1 version if anything
	goes wrong during the installation process.

Note: If you are upgrading from 4.0.2beta, this option is not available.

If you decide to go ahead with the back-up, be sure to supply back-up media
that is write-enabled.

11. Enter y to proceed with the backup.

The screen message will ask you to identify the type of back-up media that
you have (diskettes or tape) then guide you through the back-up procedure.

Note: Ignore messages from either the bar or tar command during the back-up
procedure that indicate that certain files cannot be found.

When the back-up procedure is complete the installation begins.

As the installation progresses, you'll see these messages:

	Finished validating VERSION files
	finished upgrading links.

Note: At this point if you have a slave server that supports diskless clients,
you will see a message advising you to update the /etc/bootparams file on the
YP master. If you have to perform this step, do so at the end of the
installation, after you reboot the system. This procedure is explained in
the note below.

Finally, you will see the message:

	Finished upgrading /etc/fstab and /etc/exports.

12. When prompted, insert the 4.0.2 Upgrade diskettes and enter y to
complete the installation.

When the installation is complete, you will see the message:

	The 4.0.2 upgrade has successfully been installed.

13. Remove the diskette from the drive.

14. Restart the system.

	# reboot

--------------------------------------------------------------------------
Note: For any slave server that has diskless clients, you must edit the
/etc/bootparams file on the YP master and rebuild YP as follows:

a. As superuser, open the /etc/bootparams file
b. Edit the file so that every lines starting with the system name that
   contains 4.0.1 (or 4.0.2beta) - now reads 4.0.2
c. Save the file
d. Change to the /var/yp directory
e. Enter: make
   You can ignore the error message that follows:
   Error talking to systemname: port map failure (host is down?)
f. Exit superuser.
----------------------------------------------------------------------------

15. Power up any diskless clients of the newly upgraded system.

16. If you powered down any network clients because the system you're
upgrading is the only YP server, power them up now.

============================================================================
IMPORTANT: Updating DOS Windows after the Upgrade

The final phase of the upgrade process is for each user to update DOS windows
and icons that appear on the Sunview Desktop.

1. Have each user log in on the upgraded system and quit any DOS windows
and icons that appear on the Sunview Desktop.

2. Have each user enter the following in the Command Tool window:

	system:1} dos -c dosupdate

You'll see a DOS window open, execute a number of commands, and then disappear.
This step updates (upgrades) each user's personal copy of the 4.0.2 DOS system
files.

==============================================================================
==============================================================================
Note: Installing Clusters after the upgrade

If you decide to install one of the changed optional clusters after you have
upgraded to 4.0.2, you will be prompted for two sets of software when you
begin to install the cluster:

* The 4.0.1 diskette or tape that contains the cluster

* The 4.0.2 upgrade media

==============================================================================
