Netra j 3.0 Installation Guide

Upgrading to Netra j 3.0

The Netra j 3.0 software includes upgrade scripts to simplify the upgrade from either Netra i 3.1-3.2.1 or Netra j 1.1-2.0.1.

Note -

When you upgrade from a localized version of Netra j or Netra i to an English only version of Netra j 3.0, all of the localization packages are deleted and the installation is in English only.

Netra j to Netra j 3.0 Upgrade Conditions

Upgrading from Netra j 1.0 is not supported; you must upgrade to Netra j 1.1 first. Additionally, HotJava Views configuration information is not preserved when upgrading from Netra j 1.1-2.0 to Netra j 3.0.

Netra i to Netra j 3.0 Upgrade Conditions

Certain conditions exist for upgrading from Netra i to Netra j 3.0.

Netra Software Notes

Network Services Administration NIS

Netra i 3.1, 3.1.1, 3.2, and 3.2.1 provide only NIS client services. Netra j 3.0 provides NIS server capabilities. To enable existing user accounts for NC log ins, you must configure the Netra j 3.0 server as the NIS master of the NIS domain that is used by the NCs. Refer to the Netra j 3.0 Administrator's Guide for more information.

Third-Party Software Notes

FireWall-First! 2.0, 3.0

Enable FireWall-First! only on Netra j 3.0 servers with more than one interface, and install it only on an interface that is not used to boot NCs. If you install it on an interface that is used to boot NCs, it will prevent the boot. You must use a Netscape(TM) browser to administer FireWall-First!. HotJava Browser cannot be used for this task.

FireWall-First! 2.0, VirusWall 1.52, WebStalker 1.0.0

These third-party security products are not supported after an upgrade from Netra i 3.1 to Netra j 3.0 on Solaris 2.6.

Netscape Enterprise Server Administration

After an upgrade, the Netscape Enterprise Server remains at port 82. However, you must use a Netscape web browser to administer this web server. HotJava Browser cannot be used for this task.

Netscape Enterprise Server htdocs Directory

Before an upgrade, make a tape backup of the Netscape Enterprise Server (NSE) htdocs directory.
- For NSE version 2.0, the directory is: /usr/local/netscape/nse-home/docs
- For NSE versions 3.0c and 3.5.1, the directory is: /opt/netscape/suitespot/docs
Restore the directory to the new document root location after the upgrade.

WebStalker 1.0.0

WebStalker 1.0.0 will not run with Sun WebServer.

WebStalker 1.1

WebStalker 1.1 requires a patch, which is installed automatically by the Netra j 3.0 installation script.

Upgrade Paths

There are two possible upgrade paths: upgrade to Netra j 3.0 and Solaris 2.6, or upgrade to Netra j 3.0 without a Solaris upgrade.

If you are upgrading to Netra j 3.0 and Solaris 2.6, follow the procedure, "To Upgrade to Netra j 3.0 and Solaris 2.6 ".
If you are upgrading to Netra j 3.0 only, follow the procedure, "To Upgrade to Netra j 3.0 Without Upgrading Solaris ".

Note -

Before upgrade, fill out the "Network Computer Configuration Form ". After upgrade, refer to "Installation and Upgrade Notes" for further information.

To Upgrade to Netra j 3.0 and Solaris 2.6

If your Netra server hardware includes a diskette drive, insert a blank formatted diskette into the drive.

As superuser, open a shell window and change to the Tools directory.
- If you downloaded the Netra j 3.0 software from the Web, type:
```
# cd /download_directory/Tools
```
- If you are installing the software from the Netra j 3.0 CD, type:
```
# cd /cdrom/cdrom0/Tools 
```

Use the save script to save the existing Netra configuration.
```
# ./netra_save 
```
Note -
If your Netra server does not have a diskette drive, the Netra configuration is saved to the local file system. You must copy the /var/tmp/netra/netraj3_0.tar file to tape or to a remote machine on the local area network.

Perform a backup of all file systems not related to the Netra software. This includes any web pages created as part of an HTML document hierarchy.

You can use the File System Backup and Restore module of the Netra administration interface to back up the file systems, if a tape drive is connected to the Netra server.

Install Solaris 2.6 from the Solaris 2.6 CD.

Follow the instructions in the Solaris Advanced Installation Guide, which is included with the Solaris 2.6 CD.

Install the Netra j 3.0 software.
```
# ./netra_install
```
For users in non-English locales, the installation script asks what locale to install. Select the most appropriate locale.

If you copied the /var/tmp/netra/netraj3_0.tar file to tape or to a remote machine in Step 3, copy the file back to the Netra server file system.

Restore the Netra configuration.
```
# ./netra_restore 
```

Refer to "Installation and Upgrade Notes", then return to here.

Restore the file systems you previously backed up.

You can use the File System Backup and Restore module of the Netra j 3.0 administration interface to restore the file systems, if a tape drive is connected to the Netra j 3.0 server.

To Upgrade to Netra j 3.0 Without Upgrading Solaris

As superuser, open a shell window and change to the Tools directory.
- If you downloaded the Netra j 3.0 software from the Web, type:
```
# cd /download_directory/Tools
```
- If you are installing the software from the Netra j 3.0 CD, type:
```
# cd /cdrom/cdrom0/Tools 
```

Use the upgrade script to save the Netra configuration, remove the existing Netra software, install Netra j 3.0, and restore the Netra configuration.
```
# ./netra_upgrade 
```
For users in non-English locales, the upgrade script asks what locale to install. Select the most appropriate locale.

Refer to the next section.