Autofsrename

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

Mac OS X operating systemsWhen 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 Jaguar to Jaguar_OLD. If the new file space name is too long, the suffix replaces the last characters of the file space name. For example, the mylongfilesystemname file space name is renamed to:

Mac OS X operating systems
   mylongfilesystem_OLD

Mac OS X operating systemsIf the new file space name already exists on the server, Tivoli Storage Manager renames the new file space Jaguar_OLDx, where x is a unique number.

Mac OS X operating systemsTivoli Storage Manager creates new Unicode-enabled file spaces that contain only the data specified in the current operation. For example, assume that Jaguar is the name of your startup disk and you archive all of the .log files in the /Users/user5/Documents directory. Before the archive takes place, the server renames the file space to Jaguar_OLD. The archive places the data specified in the current operation into the Unicode-enabled file space named Jaguar. The new Unicode-enabled file space now contains only the /Users/user5/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.

Mac OS X operating systemsFor example, assume that Jaguar is the name of your startup disk and you archive all of the .log files in the /Users/user5/Documents directory. Before the archive takes place, the server renames the file space to Jaguar_OLD. The archive places the data specified in the current operation into the Unicode-enabled file space named Jaguar. The new Unicode-enabled file space now contains only the /Users/user5/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.

Windows operating systemsWhen 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:

Windows operating systems
   \\your-node-name_OLD

Windows operating systemsIf 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.

Windows operating systemsTivoli Storage Manager creates 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: Windows operating systems
   arc h:\logs\*.log

Windows operating systemsBefore 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.

Note: When an existing file space is renamed during Unicode conversion, any access rules defined for the file space remain applicable to the original file space. New access rules must be defined to apply to the new Unicode file space.

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 might 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.

Windows operating systemsTo 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

Mac OS X operating systemsThe server can define the autofsrename option and override the autofsrename setting on the client.

Supported Clients

Mac OS X operating systemsThis option is valid for Mac OS X 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.

Windows operating systemsThis option is valid for all Windows clients. 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

Mac OS X operating systemsPlace this option in the dsm.sys file within a server stanza. You can set this option on the General tab, Rename non-Unicode filespaces during backup/archive drop-down list box of the Preferences editor.

Windows operating systemsPlace this option in the client options file (dsm.opt) file. You can set this option on the General tab, Rename non-Unicode filespaces during backup/archive drop-down list box of the Preferences editor.

Syntax

Read syntax diagramSkip visual syntax diagram
                 .-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:

Examples

Options file:
autofsrename yes