No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

OceanStor 9000 V300R005C00 File System Feature Guide 11

Rate and give feedback :
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Application on the Mac OS X Client

Application on the Mac OS X Client

This section describes how to install DFSClient on and mount an NFS share to the Mac OS X client.

Installing DFSClient

This topic introduces the procedure of installing DFSClient on the Mac OS X client.

Prerequisites

The installation package of DFSClient has been obtained. Table 12-10 describes the installation package.

Table 12-10  Installation package list

File Name

Description

How to Obtain

OceanStor_9000_VxxxRxxxCxx_InfoTurbo.zip

the installation package of DFSClient.

For enterprise users, log in to http://support.huawei.com/enterprise. For carrier users, log in to http://support.huawei.com. Enter OceanStor 9000 in the search box, and click the path displayed below the search box to enter the product page. For enterprise users, click Software Download. For carrier users, click Software to search for and download the software of the correct version and their *.asc digital certificate files.

Digital certificate verification tool

Used to verify package integrity.

Visit http://support.huawei.com/enterprise and choose Technical Support > Tools > All Tools > Software digital signature validation tool (PGP Verify), select the latest software version and download all the documents (including tool usage description documents).

Table 12-11 lists the software tools required for installation.

Table 12-11  Tools

Tool Name

Description

FTP file upload tool (such as FileZilla)

Used to upload files to servers. When FileZilla is used, you only need to install the FileZilla client version without the need to install the FileZilla server version.

Procedure

  1. Use the digital certificate verification tool to verify package integrity.

    NOTE:

    For details, see the description document of the tool.

  2. Decompress the OceanStor_9000_VxxxRxxxCxx_InfoTurbo.zip package to obtain the OceanStor 9000 VxxxRxxxCxx_DFSClient_Mac10.10.dmg decompressed installation package of the Mac OS X client.
  3. Use the FTP file upload tool (such as FileZilla) to upload OceanStor 9000 VxxxRxxxCxx_DFSClient_Mac10.10.dmg to the installation path, such as /home, of the Mac OS X client.

    For details on how to upload a file and create a directory, see How to Use FileZilla to Upload the Installation Package to the Client?

  4. Log in to the Mac OS X client and go to the installation path, and click the dmg compression package to obtain the OceanStor 9000 VxxxRxxxCxx_DFSClient_Mac10.10.pkg file.
  5. Click OceanStor 9000 VxxxRxxxCxx_DFSClient_Mac10.10.pkg file. The Introduction page is displayed, as shown in Figure 12-15. Click Continue.

    NOTE:

    Destination Select is the system default value. The installation process skips this parameter setting automatically. The default installation path is /System/Library/Filesystems/xnfs.fs, do not change the installation directory.

    Figure 12-15  Introduction page

  6. The InstallationType page is displayed. Click Install, enter the administrator name and password to obtain the installation permission, and click Install Software, as shown in Figure 12-16. The Installation process window is displayed. You can check whether the installation succeeded on the Summary page after the process ends.

    Figure 12-16  Entering the user name and password to obtain the installation permission

  7. Run xnfs_op_tool -v to check the version of the installed software.

    -Mac-2:~ root$ xnfs_op_tool -v
    The version of xnfs client: 
    V300R005C00SCP100 (Mon Sep  7 11:55:21 CST 2015)

Follow-up Procedure

Uninstall DFSClient.

  1. Optional: Run mount to check whether there a directory to which DFSClient is mounted on the client. If you can ensure that no directory are mounted on the client, perform 2.
    • If yes, run sudo umount /local_path to unmount the directory and go to 2 to uninstall DFSClient. For details about how to unmount the directory, see directory unmounting in the follow-up procedure of Mounting an NFS Share
    • If no, go to 2 to unmount DFSClient.
  2. run the sudo /sbin/uninstall_xnfs.sh command to start script file uninstall_xnfs.sh to uninstall DFSClient.
    huaweis-Mac-2:~ huawei# sudo /sbin/uninstall_xnfs.sh 
    XNFS: begin to uninstall the xnfs .. 
    XNFS: unload the /System/Library/Filesystems/xnfs.fs/kext/xnfs.kext successful
    XNFS: uninstall the xnfs successful 
    huaweis-Mac-2:~ huawei# 
NOTE:

If there is a directory to which DFSClient is mounted on the client, DFSClient cannot be uninstalled.

Upgrade DFSClient.

  1. Optional: Run mount to check whether there a directory to which DFSClient is mounted on the client. If you can ensure that no directory are mounted on the client, perform 2.
    • If yes, run sudo umount /local_path to unmount the directory and go to 2 to upgrade DFSClient. For details about how to unmount the directory, see directory unmounting in the follow-up procedure of Mounting an NFS Share
    • If no, go to 2 to upgrade DFSClient.
  2. Navigate to the same path at http://support.huawei.com/enterprise to obtain the latest installation package and perform the upgrade by following the preceding procedure.
NOTE:

If there is a directory to which DFSClient is mounted on the client, DFSClient cannot be upgraded.

Configuring the DNS server

If you want to mount a shared directory using a domain name, ensure that the IP address of the DNS server has been configured on the client.

Prerequisites

  • When there is an external DNS server:
    • The client communicates properly with the front-end service network of OceanStor 9000 and the external DNS server. DNS servers communicate properly with the front-end service network of OceanStor 9000.
    • A conditional forwarder has been configured for the DNS server. The DNS server can forward the InfoEqualizer domain name request sent from the client to OceanStor 9000 and OceanStor 9000 sends the front-end service IP address of the node to the client. For details, see InfoEqualizer > Configuration and Management > Connecting to the External DNS Server in OceanStor 9000 Feature Guide.
  • When there is no external DNS server, the client must communicate properly with the front-end service network of OceanStor 9000.

Context

Before mounting an NFS shared directory using a domain name, you must configure the IP address of the DNS server on the client. There are two scenarios as follows:

  • Connecting to an external DNS server: Set the IP address of the DNS server on the client to the IP address of the external DNS server.
  • Not connecting to an external DNS server: Set the IP address of the DNS server on the client to the InfoEqualizer DNS IP address of OceanStor 9000.

Procedure

  1. Click the gear wheel icon (System Preferences) on the toolbar. On the window that is displayed, select Network, as shown in Figure 12-17.

    Figure 12-17  Opening the Network page

  2. On the Network page that is displayed, configure the IP address of the DNS server, as shown in Figure 12-18.

    Figure 12-18  Configuring the DNS server

Mounting an NFS Share

This section describes how to use DFSClient to mount the created NFS shared directory to the local Mac OS X client and verify that the directory is accessible.

Prerequisites

  • An NFS share has been created in OceanStor 9000. For details about how to create an NFS share, see OceanStor 9000 File System Administrator Guide.
    NOTE:
    • In NFS file sharing, to prevent users' usage of a directory from being affected by UNIX permissions, select Read, Write, and Execute for User, User Group, and Others in the Advanced window of the directory. You can choose Provisioning > Resource Manager and select the corresponding directory to view permission configurations of its attributes.
    • To allow user root to access shared directories on a client, click Advanced on the Add Client page, set Root Permission Constraint to no_root_squash. You can choose Provisioning > Share > NFS (Linux/UNIX/MAC) to select a shared directory. On the Client Information page, choose the corresponding client to view its attribute configurations.
    • During the process of creating an NFS share on DeviceManager, if you want to specify IP addresses of a client in Name or IP Address, you must add all IP addresses of the client. Otherwise, the directory may fail to be mounted. You can choose Provisioning > Share > NFS (Linux/UNIX/MAC) to select a shared directory. On the Client Information page, choose the corresponding client to view its attribute configurations.
  • The Mac OS X client communicates properly with the front-end service network of the OceanStor 9000.

Procedure

  1. Log in to the Mac OS X client as a user having administrator rights.

    NOTE:
    • User root is disabled on the Mac OS X client by default.
    • Italics in the following commands are adjustable base on site requirements.

  2. Run vim /etc/sysctl.conf to edit the sysctl.conf file. Press I to enter the editing mode. Check whether net.inet.tcp.sendspace exists in the file and perform the following operations accordingly to ensure that settings are still effective after the system is restarted.

    • If no, set net.inet.tcp.sendspace to 1048576.
    • If yes, modify net.inet.tcp.sendspace to a value equal to or higher than 1048576.
    huaweis-Mac-2:~ huawei# vim /etc/sysctl.conf
      1 net.inet.tcp.sendspace=1048576 
    ~     
    ~  
    -- INSERT --   

  3. Press Esc to exit the editing mode and enter :wq to save the settings, then press Enter.
  4. Run sudo sysctl -w net.inet.tcp.sendspace= 1048576 to make the settings take effect immediately. By doing so, services will not be interrupted as you do not need to restart the system to make the settings effective.

    huaweis-Mac-2:~ huawei# sudo sysctl -w net.inet.tcp.sendspace=1048576 
    net.inet.tcp.sendspace: 131072 -> 1048576 
    
    NOTE:

    Increasing the value of net.inet.tcp.sendspace can help buffer the TCP receiving on the Mac OS X client to support the fine-grained I/O of the Mac OS X client.

  5. Optional: Run showmount -e xxx.com to check the NFS share created in OceanStor 9000.

    xxx.com indicates the dynamic domain name or zone domain name configured in InfoEqualizer.

  6. Optional: Run mkdir /local_path to create local directory to be mounted /local_path.
  7. Mount the NFS shared directory.
    • By using the mount_xnfs command: The command is sudo mount_xnfs -o readahead=xx,rsize=xxxk,wsize=xxxk,sip=xx.xx.xx.xx_xx.xx.xx.xx_xx.xx.xx.xx xxx.com:/share_path /local_path,
      where:
      • rsize: indicates the read I/O granularity. The default value is 512 KB and the maximum value is 1024 KB.
      • wsize: indicates the write I/O granularity. The default value is 32 KB and the maximum value is 128 KB.
      • readahead: coefficient of prefetch file size. The size of the file prefetched by the Mac OS X client from the OceanStor 9000 is calculated using the following formula: Size of the file prefetched by the Mac OS X client from the OceanStor 9000 = readahead x Max (rsize,wize), Max (rsize,wize) indicates that you need to use the larger value between the rsize and wize values.Set this parameter based on services. If the running services are mainly video editing services, set the parameter to 8 to prevent OceanStor 9000 from service loads caused by unnecessary prefetching operations. If running services are mainly video playback services, set the parameter to 64. If this parameter is left empty, the maximum value is used by default.
      • sip: client IP address. Up to 16 IP addresses can be supported. To ensure system performance, specify at least two IP addresses.
      • /share_path: indicates the shared path in DeviceManager.
      NOTE:

      sudo (superuser do) is used for UNIX-like operating systems such as BSD, Mac OS X, and GNU/Linux. Users can use special permissions to execute programs through a secure way. User root is used usually. Administrators can run the sudo command to obtain the permissions of user root.

    • By creating the configuration file:
      1. Optional: Run the touch /home/mytext.conf command to create configuration file.
        [root@Client2 ~]# touch /home/mytext.conf
        
      2. Run the vim /home/mytext.conf command to edit the configuration file. Press the i key to enter the editing mode. Fill in the related information the configuration file, press Esc to exit the editing mode and enter :wq to save the file, then press Enter.
        [mount_entry]
        service_ip=xx.xxx.com
        export=/share_path
        mount_point=/local_path
        mount_option=rsize=xxxk,wsize=xxxk,sip=xx.xx.xx.xx_xx.xx.xx.xx_xx.xx.xx.xx
        [/mount_entry]
        

        The parameters are described as follows:

        • service_ip: mount domain name.
        • export: indicates the shared path in DeviceManager.
        • mount_poin: the local directory to be mounted.
        • mount_option: mount parameters.
        NOTE:

        The information must be entered in the specified format. Otherwise, the mounting will fail.

      3. Run mount_xnfs -c /home/mytext.conf to use the created configuration file to mount the NFS shared directory.
  8. Optional: Run the mount command to view all the directories that have been mounted.
  9. Run the su - xxx command to change the user account if necessary. Then run cd /local_path to enter the shared directory.

    NOTE:

    By default, the permissions of user root are restricted. Therefore, if you do not change the user account, a message may be displayed in subsequent operations, indicating that you do not have sufficient permissions.

Example

huaweis-Mac-2:~ huawei# showmount -e s.hw.com
Exports list on s.hw.com: 
/xnfs            * 
huaweis-Mac-2:~ huawei# mkdir /tmp/Mac_DFSClient
huaweis-Mac-2:~ huawei# sudo mount_xnfs -o rsize=512k,wsize=32k,sip=192.168.60.224_192.168.60.225 s.hw.com:/xnfs /tmp/Mac_DFSClient               
huaweis-Mac-2:~ huawei# mount
/dev/disk1s2 on / (hfs, local, journaled) 
devfs on /dev (devfs, local, nobrowse) 
/dev/disk0s2 on /Volumes/sys (hfs, local, journaled) map -hosts on 
/net (autofs, nosuid, automounted, nobrowse) map auto_home on 
/home (autofs, automounted, nobrowse) 
s.hw.com:/xnfs on /private/tmp/Mac_DFSClient (xnfs)
huaweis-Mac-2:~ huawei# cd /tmp/Mac_DFSClient

Follow-up Procedure

Unmount Directory

  1. Optional: Run lsof /local_path to view the process running on the mounted directory. If you can ensure that no services are running on the directory, perform 2.
    • System process: Go to 2 to unmount the directory.
    • Other application software: Exit the application software and go to 2 to unmount the directory.
    huaweis-2:~ huawei# lsof /mnt/Mac_DFSClient
    COMMAND  PID  USER  FD  TYPE  DEVICE  SIZE/OFF  NODE    NAME
    mds      53   root  15r DIR   45,3     4096    54953988 /mnt/Mac_DFSClient
    
  2. run sudo umount_xnfs /local_path. When the directory is unmounted, the link information in xnfs_client.conf of DFSClient is also deleted. The directory will not be mounted automatically when the client is restarted. If you want to reserve the configuration information in the configuration file, run the umount /local_path command to unmount the directory, so that the directory can be re-mounted when the client restarts.
NOTE:
  • Before unmount the directory, ensure that no business on the directory, or the directory may fail to be unmounted.
  • If unmount command umount /local_path is used, the directory will be unmounted but information in xnfs_client.conf of DFSClient will not be deleted.
Translation
Download
Updated: 2019-03-30

Document ID: EDOC1000101823

Views: 19366

Downloads: 99

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next