Release 4.0  Copyright ã1996 by NeXT Software, Inc.  All Rights Reserved.

NeXT System Administration Release Notes: 
Upgrading Remotely Across a Network

If your network contains a number of computers you want to upgrade to OPENSTEP Release 4.0, you can set up an upgrade server that you can use in place of the OPENSTEP CD-ROM when you upgrade individual computers on the network. If your network contains a number of computers with identical configurations of hardware and OPENSTEP software, you can also use the RemoteUpgrade utility to upgrade as many as 20 computers simultaneously.

This document describes how to set up an upgrade server and how to use the RemoteUpgrade utility. Upgrading a computer from an upgrade server using the Upgrader application is described in Upgrading to OPENSTEP Release 4.0. 

ÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐ
Caution: If you plan to upgrade more than one computer, start with a computer that isn't critical to your network's operation. Upgrading a test computer minimizes the time needed to diagnose and fix 
problems. Once you're confident that you're ready to install Release 4.0 on all your computers, you can upgrade more important ones.
ÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐ

Setting up an upgrade server

You set up an upgrade server by selecting each computer you want to act as a server, installing OPENSTEP Release 4.0 on it, copying the contents of the OPENSTEP CD-ROM into a directory on the server, and then using NFSManager to export that directory.

1.	Select each computer you want to set up as an upgrade server.

	You need to at least one upgrade server on each subnet. You can use any kind of computer (Intel-based, NeXT, or SPARC as an upgrade server for any other kind of computer.

	Because you will copy the contents of the OPENSTEP CD-ROM onto it, an upgrade server needs about 300 megabytes of free disk space. You also need to connect a CD-ROM drive to the server to complete these instructions.

	If you plan to use an upgrade server to upgrade Intel-based or NeXT computers, you NFS-export a copy of the OPENSTEP CD-ROM.

2.	Upgrade the software on the upgrade server to OPENSTEP Release 4.0, using the OPENSTEP CD-ROM.

	You can follow the instructions in Upgrading to OPENSTEP Release 4.0 to upgrade from any earlier version of OPENSTEP Release 3. Or you can install OPENSTEP Release 4.0 from scratch, as described in Installing and Configuring OPENSTEP Release 4.0.

3.	Log into the server as root and create a directory where you will copy the contents of the OPENSTEP CD-ROM.

	You can create a directory on the server's startup disk or use all or part of another disk (or partition) that's connected to the server.

4.	Insert the OPENSTEP CD-ROM in the CD-ROM drive and use the following command to copy the contents of the CD-ROM into the directory you created:

	ditto /OPENSTEP_4.0 /UpgradeDirectory

	Replace /UpgradeDirectory with the name of the directory you created in step 3.

5.	Start up NFSManager (it's in /NextAdmin).

6.	Drag the directory you created in step 3 from the File Viewer to the icon well in NFSManager's Exported Directories window.

7.	Choose ªRead-onlyº from the upper pop-up list.

8.	Check ªAllow unknown users.º

9.	Choose ªUser with uid:º from the lower pop-up list and type 0 in the field next to it. 

ÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐ
Caution: Setting the ªUser with uidº option to 0 removes security from the upgrade server's file system. Make sure that you've selected a computer where this lack of security is appropriate and that you reset this option when you're done using the server for upgrading. 
ÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐ

	¬

10.	Choose Import To from the NFSManager menu and in the panel that opens, select the domain that contains the computers you want to upgrade. Then click OK.

	,

	If you're on a small network, the NetInfo domain of the computers you're upgrading is probably the root NetInfo domain, named ª/º.

11.	Click the Add button in NFSManager's Imported Directories window and in the panel that opens, type the host name of the upgrade server in the upper field and the pathname of the directory you created in step 3 in the lower field. Then click OK.

	¬

12.	Quit NFSManager and restart the upgrade server.

The computer is now ready to use as a network upgrade server.

Preparing to use the RemoteUpgrade utility

Before you can use the RemoteUpgrade utility to upgrade multiple, identically configured computers, you need to upgrade one of those computers to create files the RemoteUpgrade utility uses as templates. You also need to alter a file on each computer you want to upgrade so you can execute programs as root when you're logged into another computer.
	
1.	Use the Upgrader application to upgrade one of the identically configured computers (we'll refer to this as the template computer).

	Using the Upgrade application is described in Upgrading to OPENSTEP Release 4.0.

2.	Create a directory called RemoteUpgradeFiles on a partition that is NFS-mounted by all the computers you want to upgrade with the RemoteUpgrade utility.

3.	Copy the files /Release4.0.uplan and /Release4.0.uplan.bom from the template computer into the RemoteUpgradeFiles directory.

4.	Copy the /UpdatedBoms directory from the template computer into the RemoteUpgradeFiles directory.

5.	Copy the RemoteUpgrade utility from /Upgrader.app/Default.upgrade/RemoteUpgrade on the OPENSTEP CD-ROM into the RemoteUpgradeFiles directory.

6.	Add a line containing the host name of the computer on which you will be running the RemoteUpgrade utility to the /.rhosts file on each computer you want to upgrade.

	For more information on the /.rhosts file, see the UNIX manual page for hosts.equiv.  

Upgrading multiple computers with the RemoteUpgrade utility

Once you've set up an upgrade server, created the template files, and prepared the computers you want to upgrade (as described in the previous two sections), you can use the RemoteUpgrade utility to upgrade multiple, identically configured computers.

ÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐ
Caution: The RemoteUpgrade utility is for quickly upgrading a network of computers with identical hardware and software configurations. If you use this utility to upgrade computers that don't have identical configurations, the upgrades may not be successfulÐin this case, use the Upgrader application on each individual computer instead.
ÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐÐ

1.	Become root in a Terminal window on the computer whose host name you added to the /.rhosts files of the computers you want to upgrade.

2.	Run RemoteUpgrade once for each computer you want to upgrade, using the following syntax:

	Path/RemoteUpgrade ComputerToUpgrade PathToUpgradeDirectory
	
	where Path is the full NFS-mounted path (visible from the computer you want to upgrade) to the RemoteUpgradeFiles directory you created in the previous section, ComputerToUpgrade is the host name of the computer you want to upgrade, and PathToUpgradeDirectory is the NFS-mounted path to the directory on the upgrade server you created in the first section of this documentÐthe directory that contains a copy of the OPENSTEP CD-ROM.

Note: Don't try to upgrade more than 20 computers at a time, to avoid overwhelming the capacity of the network. Otherwise, network performance degradation could cause the upgrades to fail.