Upgrading Overview

Read this section before following "Upgrading Steps: TAS 5.x" or "Upgrading Steps: TAS 4.1.1". Upgrading steps include the following tasks:

TAS File Conversion

The tnconvert utility upgrades TAS configuration files. It reads the files, converts them, writes the output to a log file at /etc/totalnet/convert, and saves your new activation key. With tnconvert, you may use the options in the table below. You will find the exact command-line format for tnconvert in the appropriate step of your Upgrading Steps section.

Table 2-1 tconvert command options

-f	Prevents tnconvert from prompting you to resolve conflicts. If you use this option, tnconvert resolves conflicts using pre-defined default values. If you do not use this option, tnconvert prompts you to resolve conflicts.
-k activation-key	Allows you to avoid a prompt for the new activation key. Supply your activation key in place of the activation-key variable. If you do not use this option, tnconvert prompts for the new key.

Package Removal and Installation

To remove your old TAS packages and install the new ones, you will complete the following tasks:

• TAS system shutdown

• unloading the drivers

• package removal

• TAS 5.2 installation, according to the instructions for your platform

File Synchronization

The tnvolck command, located in the TNHOME/usr/bin directory, checks TAS shadow files. With it, you may use the options in the table below. You will find the exact command-line format for tnvolck in the appropriate step of your Upgrading Steps section. For details, see the complete description of tnvolck.

Table 2-2 tnvolck command options

-a	Checks all defined TAS volumes, except those with substitutable paths. If you use this option, you do not need to specify a volume and file.
-y	Causes tnvolck to assume you answer yes to all questions and want it to make the default or indicated changes to your files and directories (see -p below).
-n	Causes tnvolck to assume you answer no to all questions. This allows you to use tnvolck to check the volume without making any changes to it.
-p	Causes tnvolck to keep the existing case in file names, even if the names contain mixed cases. Use this option only if you have set the volume's filename-case attribute to lower case. If you do not specify this option, tnvolck prompts for confirmation before converting the file name to lower-case.
volume	Represents the volumes to convert. If you use the same volume name twice, tnvolck only scans the volume first.
file	Allows you to run tnvolck on a volume with a substitutable path. This option contains a list of directory names for tnvolck to use for that volume. If tnvolck comes across a volume with a substitutable path, but you have specified no file, tnvolck prints a warning and skips that volume. For more information on TAS support of substitutable paths, refer to the description of tnvolume in TAS Reference Manual, which you can access by clicking Documentation in the TotalAdmin menu frame of TNAS.

The tnvolck command uses the value of each volume's path attribute as a starting point for the volume check, unless the volume has a substitutable path. It checks each file and directory under the path. If two volumes resolve to the same path, tnvolck checks the path only once. If one path contains another path, you only need to supply the name of the volume with the higher-level path, since tnvolck checks subdirectories. If two volumes resolve to the same path, or if one contains another, and they have different file-name cases, tnvolck prints an error message and skips both volumes.

Conversion of TAS 4.1.1 Macintosh Volumes

The atconvert utility converts all TAS 4.1.1 Macintosh volumes on your system to the TAS 5.2 format. With it, you use the dir variable, which represents the directory path of the volumes. You will find the exact command-line format for atconvert in the appropriate step of your Upgrading Steps section. It may take several minutes for the files in a large volume to convert to the new shadow file directory structure. For more information, refer to the description of atconvert in TAS Reference Manual, which you can access by clicking Documentation in the TotalAdmin menu frame of TNAS.