TotalNET Advanced Server 5.2 Release Notes

Chapter 2 Upgrading

To upgrade to TAS 5.2, you need to run the tnconvert utility, which reads existing TAS configuration files, converts them, and saves them in the /etc/totalnet/convert directory. The tnconvert utility also prompts for and saves your new TAS 5.2 activation key. You need a new key to run tnconvert. This process generates a log file in /etc/totalnet/convert/log.tnconv. When you complete installation, the post-installation script restores the configuration files saved by tnconvert, installs the new activation key, and installs and loads any required drivers.

The tnconvert utility does not convert the administrative user and group names. You cannot use tnconvert to convert TAS 5.2 to an earlier version of TAS.

Before following the upgrading steps:

Make sure you have root access.
Make sure you have NOT removed existing TotalNET servers.
Locate your new activation key. If you have a Sun Enterprise Services upgrade contract for your additional SunLink PC clients, Sun Enterprise Services will send you the appropriate upgrade package. If you do not have an upgrade contract, contact your Sun sales representative to purchase the appropriate packages.
Read "Upgrading Overview" below for a complete description of the upgrading process.

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.

Upgrading Steps: TAS 5.x

Follow these steps to upgrade from TAS 5.x to TAS 5.2:

Back up your current version of TAS, including all volumes.

Mount the TAS 5.2 CD in the drive.

Change directory to the location of tnconvert with the following command, where mntpnt represents the mount point and OSversion represents the name of the platform to convert, from the table below:

# cd /mntpnt/TAS/OSversion

Platform	OSversion
AIX	`aix4_1_4`
Solaris on SPARC	`solaris2_5_1/sparc`
Solaris on i386	`solaris2_5_1/i386`
HP 10.10 and 10.20	`hpux10_20`
IRIX 5.3	`irix5_3`
IRIX 6.x	`irix6_x`

Run tnconvert using the format below. For a complete description of the command options, see Table 2-1.
# tnconvert [-f] [-k activation-key]
The following example shows the sequence of commands for mounting the CD and running tnconvert, for Solaris on SPARC:
# cd /cdrom/totalnet_advanced_server/TAS/solaris2_5_1/sparc # ./tnconvert
To verify the success of tnconvert, check the log.tnconv file in the /etc/totalnet/convert directory. The log file for tnconvert in TAS 5.2 contains more information than in previous releases, including each conversion step, a copy of the original configuration, and a copy of the new configuration.

Shut down TAS and TotalAdmin:

# cd TNHOME/usr/sbin
# ./tnshut
# ./tas.sh stop totaladmin

Unload the drivers:
# ./tniunload # ./atunload
If you have Solaris or AIX, or if your system runs NetBEUI, run nbuunload in addition to tniunload and atunload:
# ./nbuunload
For TAS 5.1 on Solaris, run smbmxunload if you have loaded multi-user kernel drivers:
# ./smbmxunload

Remove the old package by following the appropriate instructions in the following table:

Platform	Command/Instruction
AIX	Use `smit`.
Sparc/i386	Run the command `pkgrm TAS TASDOC` and, if you have the `TASDCE` package installed, `pkgrm TASDCE` for Sparc platforms.
HP 10.x	Run the command `swremove -x autoreboot=true TAS TASDOC`.
IRIX	Run the command `inst -a -R TAS`.

Install TAS 5.2 according to the instructions for your platform.

Run tnvolck. The example below shows the sequence of commands for running tnvolck to synchronize all volumes in TAS. For a complete description of the command options, refer to Table 2-2.
# cd TNHOME/usr/bin # ./tnvolck -a

Start the TotalNET system:
# cd TNHOME/usr/sbin # ./tnstart

Read Chapter 7, General TAS Issues.

Connect to TNAS and administer TAS by following the instructions in "Connecting to TNAS and Accessing Documentation".

You do not need to complete initial setup to upgrade.

Upgrading Steps: TAS 4.1.1

Follow these steps to upgrade from TAS 4.1.1:

Back up your current version of TAS, including all volumes.

Mount the TAS 5.2 CD in the drive.

# cd /mntpnt/TAS/OSversion

Platform	OSversion
AIX	`aix4_1_4`
Solaris on SPARC	`solaris2_5_1/sparc`
Solaris on i386	`solaris2_5_1/i386`
HP 10.10 and 10.20	`hpux10_20`
IRIX 5.3	`irix5_3`
IRIX 6.x	`irix6_x`

Run tnconvert using the format below. For a complete description of the command options, see Upgrading Overview.
# tnconvert [-f] [-k activation-key]
The following example shows the sequence of commands for mounting the CD and running tnconvert, for Solaris on SPARC:
# cd /cdrom/totalnet_advanced_server/TAS/solaris2_5_1/sparc # ./tnconvert
To verify the success of tnconvert, check the log.tnconv file in the /etc/totalnet/convert directory. The log file for tnconvert in TAS 5.2 contains more information than in previous releases, including each conversion step, a copy of the original configuration, and a copy of the new configuration.

Shut down TAS and TotalAdmin with the following sequence of commands:

For AIX:

# cd /usr/tn
# ./tnshut
# cd totaladmin/W3/bin
# ./tnadmin.sh stop

For Solaris, HP, and IRIX:

# cd /opt/TAS/tn
# ./tnshut
# cd totaladmin/W3/bin
# ./tnadmin.sh stop

Unload the drivers:

For AIX:
# cd /usr/tn # ./tniunload # ./atunload
For Solaris, HP, and IRIX:
# cd /opt/TAS/tn # ./tniunload # ./atunload
If you have Solaris or AIX, or if your system runs NetBEUI, run nbuunload in addition to tniunload and atunload:
# ./nbuunload

Remove the old package by following the appropriate instructions in the following table:

Platform	Command/Instruction
AIX	Use `smit`.
Sparc/i386	Run the command `pkgrm TAS TASDOC`.
HP 10.x	Run the command `swremove -x autoreboot=true TAS TASDOC`.
IRIX	Run the command `inst -a -R TAS`, then remove the directories `/opt/TAS/tn` and `/opt/TAS`.

Install TAS 5.2 according to the instructions for your platform.

Run atconvert using the format below. The dir variable represents the directory path of the volumes.
# cd TNHOME/usr/bin # ./atconvert dir

Run tnvolck. The example below shows the sequence of commands for running tnvolck to synchronize all volumes in TAS. See the complete description of the command options.
# ./tnvolck -a

Start the TotalNET system:
# cd TNHOME/usr/sbin # ./tnstart

Read Chapter 7, General TAS Issues.

Connect to TNAS and administer TAS by following the instructions in "Connecting to TNAS and Accessing Documentation".

You do not need to complete initial setup to upgrade.

tnvolck

Description

The tnvolck command checks files and directories under a TAS volume for the integrity of their corresponding TAS shadow files.

The filename-case attribute of a volume determines its naming convention. You need to synchronize file names only for volumes with the filename-case attribute set to lower. By default, if tnvolck needs to synchronize a file name, it prompts for user confirmation before converting the file name.

The tnvolck command checks for TAS shadow files that no longer have their corresponding UNIX base files. This condition may occur if users have moved or removed the UNIX file using UNIX commands such as mv or rm, instead of TAS commands tnmv or tnrm. The tnvolck command removes these shadow files.

The tnvolck command checks for TAS shadow files that have different owner, group and mode information than their corresponding UNIX base files. This condition may occur if users have changed the ownership and mode of the UNIX file using UNIX commands such as chown, chgrp or chmod instead of TAS commands tnchown, tnchgrp or tnchmod. The tnvolck command changes the information on the shadow files to match the information of their corresponding UNIX files.

The tnvolck command checks to see if the file's UNIX name complies with naming conventions for the TAS volume in which the file resides. If the name does not comply with the specified convention, tnvolck attempts to synchronize it.

If you specify the -p option, tnvolck preserves file name case without prompting for confirmation. Before modifying a file name or deleting a shadow file, tnvolck prompts for user confirmation.

If you specify the -y option, tnvolck behaves as if you answer yes (y) to all questions. It does not prompt for confirmation. Use this option only when you want tnvolck to synchronize shadow files.

If you specify the -n option, tnvolck behaves as if you answer no (n) to all questions. It does not prompt for confirmation. If it finds inconsistencies, tnvolck prints error messages. Use this option only when you want tnvolck to check the volume without synchronizing shadow files.

Usage

# tnvolck [-a] [-y|-n] [-p] [volume[:file]]

Options

`-a`	Run `tnvolck` on all TAS volumes except those with substitutable paths.
`-y`	Assume a yes response to all questions asked by `tnvolck`.
`-n`	Assume a no response to all questions asked by `tnvolck`.
`-p`	Suppress file name conversion.
`volume`	Specify a volume.
`file`	Specify a file name that contains a list of valid directory paths. Use this only if the volume has a substitutable path for its path attribute. The directory paths defined in this file substitute the volume's path attribute. If `tnvolck` finds a volume with substitutable path, but you specified no file, `tnvolck` prints a warning and skips that volume. For information on TAS-supported escape sequences for path substitution, refer to the `tnvolume` command description in the TAS Reference Manual, which you can access by clicking Documentation in the TotalAdmin menu frame of TNAS.

Examples

Use the following command to check and clean up shadow files in the volume myvol:
# tnvolck myvol

Use the command below to check and clean up shadow files in the volume mybin, which has a substitutable path, and replace it with the path contained in the file /tmp/mydoc.txt, an ASCII file containing a list of directory names. Each line should in /tmp/mydoc.txt should contain a directory path name. For example, the file might contain the following entries:/home/simon, /home/steven, and /home/emily.
# tnvolck mybin:/tmp/mydoc.txt

Use the following command to check and clean up all TAS volumes, as found in the TAS configuration file:
# tnvolck -a

Use the following command to check and clean up the volume saleorders and assume a yes answer to all questions:
# tnvolck -y saleorders

Use the following command to check, but not perform directory synchronization or clean-up on, the volume singular:
# tnvolck -n singular

Use the following command to check and clean up the volume spartacus and suppress the file name conversion:
# tnvolck -p spartacus