mount

Mounts a client instance of the SAN File System.

Read syntax diagramSkip visual syntax diagram
>>-mount--+-server_name-------+--mount_point--+-----+----------->
          '-server_IP_address-'               '- -r-'

>--+-----+------------------------------------------------------>
   '- -m-'

>--+-------------------------------------------------------------------------------------------------------------------------------------------------------+-><
   |         .-,--------------------------------------------------------------------------------------------------------------------------------------.    |
   |         V                                                                                                                                        |    |
   '- -o--'----alternate=--+-name-------+--client=--name--device=--pattern--port=--number--batchsize=--number--+-forcedirectio-+--+-closenowrite----+-+--'-'
                           '-IP_address-'                                                                      '-nodirectio----'  +-closesyncdata---+
                                                                                                                                  +-closesyncall----+
                                                                                                                                  '-closeasyncwrite-'

Parameters

server_name
Specifies the host name of a metadata server in the SAN File System. The metadata server that you specify informs the global namespace image of all other metadata servers.
server_IP_address
Specifies the IP address, in dotted decimal notation, of a metadata server in the SAN File System.
mount_point
Specifies the directory on which the client instance is mounted.
–r
Sets the global namespace image to read only. If specified, an attempt to update data or metadata in the global namespace fails, and accessing a file-system object does not update its access-time attribute.
–m
Specifies not to record the mount in the /etc/mtab file.

If –m is not specified, the mount command adds an entry to the /etc/mtab file describing the global namespace image if the mount is successful. It then locks the file using the /etc/mtab~ lock file while it attempts the mount and updates /etc/mtab. If specified, this command does not attempt to lock or update /etc/mtab.

Note that /etc/mtab is obsolete and would only need to be updated if it might be referred to by existing applications. /proc/mounts contains more reliable information, straight from the kernel itself.

–o
Specifies options that are specific to SAN File System. Enclose the options in single quotes and separate the options with a comma and no space.
alternate= name| IP_address
Specifies the host name or the IP address, in dotted decimal notation, of an alternate metadata server in the SAN File System if the metadata server specified by the –server parameter does not respond.
client= name
Identifies the unique name of the virtual client to which you want to mount the global namespace. The client must be up and running. The default client name is the host name of the client system.
device= pattern
Specifies the devices (also called disks or LUNs) that are usable for I/O operations. The default is /dev/dsk/c*t*d*s2. For SDD devices, specify /dev/dsk/vpath*c.
port= number
Specifies the port number of the specified metadata server to which the client should connect. The default is 1700.
batchsize= number
Specifies the maximum number of SAN File System messages that can be batched together in a single network request to the metadata server.
forcedirectio
Causes all file access on this mount instance to use direct I/O.
nodirectio
Inhibits the use of direct I/O on this mount instance.
closenowrite
Specifies that when a file is closed, the system not attempt to write any unwritten data back to disk at that time. Solaris flushing mechanisms or pageout operations will force the data to disk.
closesyncdata
Specifies that only file data, not metadata, be written back to disk when a file is closed. Metadata will be cached and written automatically or by user request using the /bin/sync command.
closesyncall
Specifies that file data and metadata be written back to disk when a file is closed.
closeasyncwrite
Specifies that file data and metadata be asynchronously written back to disk when a file is closed. The operations to write the data to disk start when the file is closed. However, the close() call does not wait for the operations to complete; it returns prior to all data being written to disk.

Prerequisites

You must have root privileges to use this command.

Description

This command creates an image of the global namespace on the client system by mounting a directory. The global namespace maintains a list of its directories that are available to the clients. When a client mounts a directory in the global namespace, that directory and its subdirectories become part of the client's directory hierarchy.

To unmount the global namespace, use the Solaris umount command.

Example

Mount the global namespace The following example mounts the global namespace:
mount MDS1 /mnt/sanfs -o 'alternate=MDS2,alternate=MDS3,device=/dev/dsk/c1t2d*s2'

Parent topic: Solaris-client commands

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