6.4 Mounting a Gateway Volume

Before you mount a volume, we recommend that you understand the mounting process of gymount.nlm in two scenarios:

For syntax and parameter information, see Section 6.1, Managing Volume-Specific Mount Parameters.

6.4.1 Mounting Volumes for the First Time

This section describes the effect of mounting a volume for the first time in the following scenarios:

When Mandatory Parameters Are Specified

When all the mandatory parameters are specified with the gymount command, the volume is mounted using those parameters. The rest of the parameters use default values, unless nfsgy has been loaded with nondefault parameters that override the gymount default values.

For example, the following syntax mounts GWVol3 with mandatory parameters:

gymount GWVOLv3 172.16.0.0 /home/xyz

This mounts the GWVol3 with the mandatory parameters that are specified and it uses the default values for the parameters that have not been specified.

The following table lists the volume attributes for each parameter.

Parameters

Volume Attributes

Volumename

GWVOLv3

IPAddress

172.16.0.0

sharedPath

/home/xyz

shadowVolume

Default = sys:

nfsVersion

Default = 3

mountUID

Default = 0

mountGid

Default = 1

anonUid

Default = 55555

anonGid

Default = 55555

rpcRetries

Default = 3

rpcTimeOut

Default = 1

dynamicRPCTimeout | nodynamicRPCTimeout

Default = dynamicRPCTimeout

dirCompFreq

Default = 0

umask

Default = 022

readOnly | readWrite

Default = readWrite

tossMetaData | noTossMetaData

Default = noTossMetadata

lowerCaseUnixNames| noLowerCaseUnixNames

Default = noLowerCaseUnixNames

forceAnonUidGid | noForceAnonUidGid

Default = noForceAnonUidGid

readSize

Default = 32

writeSize

Default = 32

maxOutstandingPackets

Default = Infinite

dynamicMOP | noDynamicMOP

Default = noDynamicMOP

showDotFiles | hideDotFiles

Default = showDotFiles

logLevel value

Default = 1 (Errors)

logVerbose | logNonVerbose

Default = logNonVerbose

entryInNCF | noEntryInNCF

Default = noEntryInNCF

When Mandatory Parameters and Some Optional Parameters Are Specified

When you specify some of the optional parameters, the rest of the optional parameters use their default values, unless nfsgy has been loaded with nondefault parameters that override the gymount defaults.

For example, the following syntax mounts Volume22 with some of the optional parameters:

gymount Volume22 172.16.0.0 /home/xyz -nfsVersion 3 -rpcTimeOut 8                -lowerCaseUnixNames -readSize 16 -writeSize 16 -maxOutstandingPackets 64      -logLevel 4

The following table lists the volume attribute for each parameter.

Parameters

Volume Attributes

Volumename

volume22

IPAddress

172.16.0.0

sharedPath

/home/xyz

shadowVolume

Default = sys:

nfsVersion

3

mountUID

Default=0

mountgid

Default = 1

anonUid

Default = 55555

anonGid

Default = 55555

rpcRetries

Default = 3

dynamicRPCTimeout | nodynamicRPCTimeout

Default = dynamicRPCTimeout

rpcTimeOut

8

dirCompFreq

Default = 0

umask

Default = 022

readOnly | readWrite

Default = readWrite

tossMetaData | noTossMetaData

Default = noTossMetadata

lowerCaseUnixNames|nolowerCaseUnixNames

lowerCaseUnixNames

forceAnonUidGid | noForceAnonUidGid

Default = noForceAnonUidGid

readSize

16

writeSize

16

maxOutstandingPackets

64

dynamicMOP | noDynamicMOP

Default = noDynamicMOP

showDotFiles | hideDotFiles

Default = showDotFiles

logLevel

4 ( Info, Warning and Errors)

logVerbose | logNonVerbose

Default = logNonVerbose

entryInNCF | noEntryInNCF

Default = noEntryInNCF

When Only Volumename Is Specified

If you specify only the Volumename, the volume does not mount because IPAddress and sharedPath parameters are mandatory when mounting the volume for the first time.

For example, the volume does not mount if you use the following syntax to mount GWVol12 without specifying the IP address or the shared path:

gymount GWVol2

6.4.2 Subsequent Mounting When Nfsgy.nlm Is Still Loaded

This section describes the effect of mounting a volume after the first time when nfsgy.nlm is still loaded in the following scenarios:

For a description of the mount parameters, refer to Section 6.1, Managing Volume-Specific Mount Parameters.

When Mandatory Parameters Are Specified

The volume is mounted with the new parameters specified.

When Mandatory Parameters and Some Optional Parameters Are Specified

The volume is mounted with the new values of parameters that are specified. The parameters that are not specified in this mount but were specified in the first mount remain unchanged.

When Only Volumename Is Specified

The volume is mounted successfully with the same parameter values as specified in the previous mount.

The parameter values specified in the previous mount are retained when the NFS Gateway is still loaded. However, if you unload and reload the NFS Gateway, then the parameter values are not retained and you must specify the mandatory parameters along with the volume name.

When Mandatory and All Optional Parameters Are Specified

The parameters specified in the previous mount are overwritten and the volume is mounted with the new set of mount parameters.