Mounting a Gateway Volume

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

For the syntax and parameter information, see Mounting Parameters .


Mounting Volumes for the First Time

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


When Mandatory Parameters Are Specified

When all the mandatory parameters are specified on the gymount command, the volume is mounted using those parameters. The rest of the parameters use default values, unless nfsgy has been loaded with non-default 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

dirCompFreq

Default = 0

umask

Default = 022

readOnly | readWrite

Default = readWrite

tossMetaData | noTossMetaData

Default = noTossMetadata

lowerCaseUnixNames

Default = Not enforced

readSize

Default = 32

writeSize

Default = 32

maxOutstandingPackets

Default = Infinite

logLevel value

Default = 1 (Errors)

logVerbose | logNonVerbose

Default = logNonVerbose


When Mandatory 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 non-default 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

rpcTimeOut

8

dirCompFreq

Default = 0

umask

Default = 022

readOnly | readWrite

Default = readWrite

tossMetaData | noTossMetaData

Default = noTossMetadata

lowerCaseUnixNames

Enforced

readSize

16

writeSize

16

maxOutstandingPackets

64

logLevel

4 ( Info, Warning and Errors)

logVerbose | logNonVerbose

Default = logNonVerbose


When Only Volumename Is Specified

If you specify only the Volumename, the volume does not mount because the 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


Mounting Volumes for Subsequent Times When the NFSGY.NLM Is Still Loaded

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

For a description of the mount parameters, refer to Mounting Parameters .


When Mandatory Parameters Are Specified

The volume is mounted with other parameters than the earlier mount.

However, the mounting is unsuccessful if the IPAddress or the sharedPath parameter values are not the same as in the earlier mount.


When Mandatory 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.

However, the mounting is unsuccessful if either the IPAddress or the sharedPath parameter values are not the same as in the earlier mount.


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.

However, the mounting is unsuccessful if either the IPAddress or the sharedPath parameter values are not same as in the earlier mount.