Starting a Linux client

This topic provides information for starting a Linux™ client.

Context

You can use the setupstclient command or a series of manual steps to start a Linux client. After the setupstclient command runs successfully, during any subsequent reboot, the client driver is loaded, the SAN File System client is created, and the file system is mounted.

Steps

  1. If you are using the setupstclient command:
    1. Type setupstclient and press Enter to start the setup guide.
    2. Enter the appropriate information, when prompted, to set up the virtual client.
  2. To manually start the client:
    1. Create a directory to use as the mount point (for example, mkdir /mnt/sanfs).
    2. Change to the base/client/bin directory, where base is the base directory (for example, chdir /usr/tank/client/bin).
    3. Type insmod driver_file_name and press Enter to load the kernel extension into Linux.

      For example, typing insmod usr/tank/client/bin/stfs.o would load the driver file stfs.o from the directory usr/tank/client/bin.

    4. Type ./stfsclient –create [client_name] server_IP_address[:port] –converter 8859-1 [–devices=pat=pattern] and press Enter to create an instance of the SAN File System client, called virtual client, where
      client_name
      The name of the SAN File System client. The default is the host name of the client machine.
      server_IP_address
      The IP address of the metadata server machine.
      port
      The port of the metadata server machine. The default port is 1700.
      –devices=pat=pattern
      The candidate list is made up of those devices that have device-special files whose file name matches the specified pattern. The default is –devices=pat=/dev/sd*[a-z], where * represents any alphabetic characters (a-z). Enclose the pattern in single quotes so the shell does not expand the asterisk characters. For SDD devices, specify –devices=pat=/dev/vpath*.
      An example would be:
      # /usr/tank/client/bin/stfsclient -create fvt4-c5-lin.3 192.168.10.35:1700 -converter=8859-1 -nettype tcp -device=dir=/dev/tank
      
      HSTCL0031I The client named fvt4-c5-lin.3 was created with client identifier 37798000 for SAN File System metadata server at IP address 192.168.10.35, port 1700.
      
      HSTCL0068I Establishing 20 candidate SAN File System user data disk devices. 
    5. Type ./stfsmount client_name mount_point and press Enter to mount the specified file system, where
      client_name
      The name of the client that you specified in step 2.d.
      mount_point
      The directory that you specified in step 2.a.
      An example would be:
      # /usr/tank/client/bin/stfsmount fvt4-c5-lin /mnt/sanfs
      
      HSTMO0015I Mounted SAN File System client fvt4-c5-lin of file-system type
      
      sanfs over directory /mnt/sanfs in read-write mode.

Parent topic: Starting a client

Related concepts
Clients

Related tasks
Stopping a Linux client

Related reference
insmod
setupstclient
stfsclient
stfsmount

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