attachfileset

Attaches an existing detached fileset to a specific point in the global namespace or moves an already attached fileset to a new attach location.

Read syntax diagramSkip visual syntax diagram
>>-attachfileset--+--------+-- -attach--location---------------->
                  +- -?----+
                  +- -h----+
                  '- -help-'

>-- -dir--directory_name--+-fileset_name-+---------------------><
                          '- - ----------'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–attach location
Specifies the directory path at which to attach the fileset. The root fileset in the global namespace must be included in the directory path. For example, to attach the fileset to the /home location, specify –attach sanfs/home. To attach the fileset directly to the root of the global namespace, use –attach sanfs.

Use only forward slashes (/) in the directory path for delimiters.

This directory must already exist.

Note: The name of the root fileset is the same as the name of the cluster. This name is "sanfs."
–dir directory_name
Specifies the directory name for the root of the fileset directory tree. The directory name must not already exist. This directory can be up to 256 characters in length.

The directory must not contain backslash (\) or forward slash (/) characters as delimiters.

The attach point (location/directory_name) appears as a drive and directory on clients for Windows® or as a file system for clients based on UNIX®. It is recommended that you map the name of the directory to its associated fileset by using the same name as the fileset plus an additional suffix to distinguish it as the directory and not the fileset. For example, if you want to attach the fileset named work to the root of the global namespace, you would specify "sanfs" for the location and specify "work_ap" for the directory_name. On a client for Windows, the "work_ap" directory would appear under the "sanfs" drive.

fileset_name
Specifies the name of the fileset to attach.
Specifies that in single-shot command mode you want this command to receive from the input stream (stdin) the name of the fileset to attach.

Prerequisites

You must have Administrator privileges to use the command.

You must be logged in to the operating system on the engine hosting the master metadata server to run this command.

Description

You make a fileset part of the global namespace by attaching it to a specific location. To a client, this attach point looks like a regular directory.

Example

Attaching a fileset The following example attaches fileset cntA to the sanfs/homes location in the global namespace using cntA_ap as its directory name.
sfscli> attachfileset -attach sanfs/homes -dir cntA_ap cntA
Fileset cntA attached to directory sanfs/homes/cntA_ap.

Parent topic: Administrative commands

Related tasks
Attaching a fileset

Related reference
autofilesetserver
chfileset
detachfileset
lsfileset
mkfileset
reportfilesetuse
rmfileset
setfilesetserver
statfileset

Library | Support | Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.
IBM TotalStorage SAN File System v2.2