Tivoli Header

Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide

Autofsrename

The autofsrename option renames an existing file space on a server so that a Unicode-enabled file space with the original name can be created for the current operation.

When you specify autofsrename yes in your client options file, and the server value of autofsrename is set to client, Tivoli Storage Manager generates a unique name by appending _OLD to the file space name you specify in the current operation. For example, Tivoli Storage Manager renames the file space \\your-node-name\h$ to \\your-node-name\h$_OLD. If the new file space name is too long, the suffix replaces the last characters of the file space name, as follows:

   \\your-node-name_OLD

If the new file space name already exists on the server, Tivoli Storage Manager renames the new file space \\your-node-name_OLDx, where x is a unique number.

Tivoli Storage Manager proceeds to create new Unicode-enabled file spaces that contain only the data specified in the current operation. For example, to archive files from your H-disk named \\your-node\h$, issue the following archive command:

   arc h:\logs\*.log

Before the archive takes place, the server renames the file space to \\your-node\h$_OLD. The archive places the data specified in the current operation into the Unicode-enabled file space named \\your-node\h$. The new Unicode-enabled file space now contains only the \logs directory and the *.log files specified in the operation. Tivoli Storage Manager stores all subsequent full and partial incremental, selective backup, and archive data in the new Unicode-enabled file spaces.

Renamed file spaces remain on the server as stabilized file spaces. These file spaces contain all the original data, which you can restore as long as they remain on the server.

After installation perform a full incremental backup and rename all existing file spaces that are not Unicode enabled and back up the files and directories within them under the new Unicode-enabled file spaces. This operation requires increased processing time and storage on the server.

File spaces that are not Unicode enabled can be viewed in the character set of the locale from which Tivoli Storage Manager backed up the files. A workstation running in a different locale may be unable to view or restore from these file spaces. Unicode-enabled file spaces that are backed up in one locale are visible in all other locales, provided that the workstation has the proper fonts installed. For more information on migrating to Unicode-enabled file spaces, see Migrating to the Unicode-Enabled Client.

To restore or retrieve from a file space that is not Unicode enabled, specify the source on the server and the destination on the client. See Restoring from File Spaces that are not Unicode Enabled for information on how to restore from file spaces that are not Unicode enabled. See Retrieving from File Spaces that are not Unicode Enabled for information on how to retrieve from file spaces that are not Unicode enabled.

Supported Clients

This option is valid for Windows NT, 2000, XP, and Windows.Net clients only. The server can define the autofsrename option and override the autofsrename setting on the client. The Tivoli Storage Manager Client API does not support this option.

Options File

Place this option in the client options file dsm.opt.

Syntax

                .-Prompt-.
>>-AUTOFsrename-+--------+-------------------------------------><
                +-Yes----+
                '-No-----'
 
 

Parameters

Yes
Specifies that Tivoli Storage Manager automatically renames all file spaces that are not Unicode enabled in the current backup or archive operation.

No
Specifies that Tivoli Storage Manager does not rename file spaces that are not Unicode enabled in the current backup or archive operation.

Prompt
Specifies that Tivoli Storage Manager prompts you whether to rename the file spaces that are not Unicode enabled in the current operation. This is the default.

Considerations:

  1. This option applies when the server sets the autofsrename option to client.
  2. When the client scheduler is running, the default behavior is to not prompt. The next interactive session prompts you to rename the file space.
  3. The client prompts one time per file space only. If you specify no at the prompt, the client cannot rename the file spaces later. However, the Tivoli Storage Manager administrator can rename the file spaces on the server.
  4. When backing up files to a file space that is not Unicode enabled, the Unicode-enabled client skips the files and directories with names containing characters from a code page that is different from the current locale.
  5. If files and directories with names containing characters from a code page other than the current locale were previously backed up with a client that was not Unicode enabled, they may be expired. The Unicode-enabled client expires these files if you do not migrate the file space to a Unicode-enabled file space. You can back up and archived these files to a Unicode-enabled file space.

Examples

Options file:
autofsrename yes


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]