Starting an AIX client

This topic provides information for starting an AIX® client.

Context

You can use the setupstclient command or a series of manual steps to start an AIX 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. Change to the base/client/bin directory, where base is the base directory (for example, cd /usr/tank/client/bin).
    2. Type ./setupstclient and press Enter to start the setup guide.
    3. 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 stfsdriver –load <PATH to kernel extension> and press Enter to load the kernel extension into AIX.
      An example would be:
      # /usr/tank/client/bin/stfsdriver -load /usr/tank/client/bin/stfs
      
      HSTDR0029I The kernel extension was successfully loaded from file /usr/tank/client/bin/stfs
      
      kernel module ID (kmid) = 6700d00.
      
      HSTDR0030I File system driver is initialized and ready to handle file-system type 20. 
    4. Type ./stfsclient –create [client_name] server_IP_address[:port] –converter 8859-1 [–device=pat=pattern –kmname kernel_extension | –device=dir=device_directory –kmname kernel_extension] 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.
      kernel_extension
      The path to kernel extension, as previously specified to the stfsdriver command.
      An example would be:
      # /usr/tank/client/bin/stfsclient -create Client.policy_basic.1 192.168.10.35:1700 -converter=8859-1 -nettype tcp -kmname /usr/tank/client/bin/stfs
      
      HSTCL0086I Created a client with the client identifier F100009E.
      
      HSTCL0068I Establishing 48 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. The default is the host name of the client machine.
      mount_point
      The directory that you specified in step 2.a.

Parent topic: Starting a client

Related concepts
Clients

Related tasks
Stopping an AIX client

Related reference
setupstclient
stfsclient
stfsdriver
stfsmount

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