From the UNICON Main Menu, select Manage Services > NFS Gateway > Configure Volumes.
Complete procedure and exit.
Manage Gateway volumes using the following UNICON screens:
If you need information about a specific field on one of these screens, position the cursor in the field and press F1.
The NFS Gateway Volumes list lists the volumes that are configured as Gateways.
From the UNICON Main Menu, select Manage Services > NFS Gateway > Configure Volumes.
Complete procedure and exit.
IDXforms:Gateway volume information/IDXIDXvolumes:using the management screens:Gateway volume information form/IDXThe NFS Gateway Volume Information form displays configuration information for a specific Gateway volume. You can also use this form to display the resources used by a remote file system.
From the UNICON Main Menu, select Manage Services > NFS Gateway > Configure Volumes.
The utility displays the list of configured Gateway volumes.
Select a volume and press Enter.
The utility displays the NFS Gateway Volume Information form.
This form contains the following fields:
Remote Hostname---the hostname for the NFS server that contains the exported directory.IDXparameters:remote host name/IDXIDXremote host name parameter/IDXIDXvolume parameters:remote host name/IDX
Remote Path---the exported directory on the NFS server.IDXparameters:remote path/IDXIDXremote path parameter/IDXIDXvolume parameters:remote path/IDX
Gateway Volume Name---the name of the NetWare volume that accesses the NFS file system. The Gateway creates this volume from the information entered on this form. The volume name can contain up to 40 characters.IDXparameters:NetWare volume name/IDXIDXNetWare volume-name parameter/IDXIDXvolume parameters:NetWare volume name/IDX
UNIX UID Used for Mounting---the UID the Gateway uses when sending a mount request. Depending upon the type of NFS implementation, the NFS server might use this identification to authenticate the mount request. The default is 0, which equates to the root account if the file system is exported with the root access option (--root=hostname where hostname is the name of the NetWare server). Otherwise, 0 equates to the user account named NOBODY (UID is -2). If the file system is not exported with the root access option, change the UID to match that of the owner of the exported directory.
UNIX GID Used for Mounting---the GID the Gateway uses when sending a mount request. Currently, only VMS systems require a valid Group identification to authenticate mount requests. Change the GID to match that of the owner group of the exported directory; the default is 0, which can cause problems with some VMS installations.
RPC Retry Count---how many times the same NFS RPC is sent to an unresponsive remote server. Valid values are integers from 0 to 10. The default is 5. The NFS server might not be able to respond to the NFS request if it is too busy or if the network traffic is heavy. If the NFS server is operating but does not respond to an RPC, use a higher number for this parameter.
RPC Inter-Packet Timeout---how many seconds the Gateway waits for a response from the remote server before resending an RPC. Valid values are integers from 1 to 20. The default is 2. Increase the value of this parameter if the RPC does not get a response or if input/output failure occurs as a result of a slow network or busy NFS server.IDXparameters:RPC inter-packet timeout/IDXIDXRPC inter-packet timeout parameter/IDXIDXvolume parameters:RPC inter-packet timeout/IDX
NFS Packet Transfer Size---the NFS packet transfer size (in bytes) used when making read and write calls to the remote NFS server. Valid parameter values are integers from 512 to 8192. The default is 8192.IDXparameters:NFS Packet Transfer Size/IDXIDXNFS Packet Transfer Size parameter/IDXIDXvolume parameters:NFS Packet Transfer Size/IDX
Enable Remote NFS Server File Locking---the state of the remote NFS server file locking. When this option is set to Yes (the default), the Gateway sends a request to the remote NFS server's lock manager to manage lock control from the server. This lock control is in addition to the file locking the Gateway imposes on NetWare clients. File and record locking are then controlled on both the NetWare server and the remote NFS server.IDXparameters:enable remote NFS server file locking/IDXIDXfile locks:file locking parameter/IDXIDXvolume parameters:enable remote NFS server file locking/IDX
If this option is set to No, files and records are only locked from the NetWare side. Therefore, data integrity is guaranteed if two or more NetWare users access the file from the same NetWare server. However, another non-Gateway client can still access the same file through the remote server. For more information on file locking, "Managing the Lock Manager Service for the Gateway."
Access Control Mode---the access control mode that applies to this Gateway. Select this field to display a list of access control modes (described below). The default mode is Gateway Mode #2. For additional information on access controls and converting file characteristics, see "NFS Gateway Access Control" under "Understanding."
Rights of NDS Object Mapped to UNIX Group WORLD---the rights granted to all NetWare users who are members of the NetWare NDSTM group object mapped to the UNIX group named WORLD. By default, these rights are RWCEMF. If you accept the default rights, NetWare users have all rights except Supervisory and Access Control.
IDXvolumes:using the management screens:trustee rights granted list/IDXIDXtrustee rights/IDXTo add a right, press Enter. The utility displays the Trustee Rights list.
Press Insert and the utility displays the Available Trustee Rights list.
Highlight the rights you want to grant on the Available Trustee Rights list and press Enter. The selected rights then appear on the Trustee Rights list.
Press Esc to return to the NFS Gateway Volume Information form.
NetWare Volume on Which Shadow Files are Created---the volume where the shadow files are stored. Select this field to display a list of available volumes from which you can choose. The default volume is SYS:.
Mount Volume on StartupIDXparameters:mount volume on startup/IDXIDXmount volume on startup parameter/IDXIDXvolume parameters:mount volume on startup/IDX---whether the Gateway volume is mounted at startup. Setting this option to Yes (the default) automatically mounts the Gateway volume each time you start the Gateway service.
Make Volume Read-Only---whether users have read and write privileges. If this parameter is set to No (the default), users have read and write privileges. If this parameter is set to Yes, file access is restricted to read-only.
Enable Write Through---whether the NFS Gateway stores modified file data in cache memory for a period of time or writes modified data to the NFS server immediately. This field appears only when the Make Volume Read-Only field is set to No.
If this parameter is set to No (the default), the application that is trying to perform a write operation receives an acknowledgment from the Gateway when the request reaches the Gateway. If this parameter is set to Yes, the application receives an acknowledgment from the Gateway only after the Gateway has passed the request on to the NFS server and has been notified that the data has been successfully written to disk.
Setting this parameter to No improves performance. However, when data is stored in cache memory, there is a possibility that it could be damaged or lost if the NFS server fails before the information is written to disk.
You should set this option to Yes when you anticipate problems in saving recent changes (for example, if the disk is nearly full or the network is unreliable).
Enable Write Through when Remote Space Falls BelowIDXparameters:enable write-through/IDXIDXenable write-through parameter/IDXIDXvolume parameters:enable write-through/IDX---ensures that data does not get lost if the remote server's disk fills up. This field appears only if the Make Volume Read-Only field and the Write Through field are both set to No.
Valid parameter values are integers from 0 to 1024. The default value is 500. If the disk space on the NFS server falls below the number of kilobytes specified, the data normally stored in cache memory is instead written directly to the remote NFS server. If the NFS server disk fills up and this parameter is not set high enough, the data left in cache memory might be lost.
When enough remote disk space is recovered, the NFS Gateway reverts to storing the data in cache memory.
Number of Blocks Initially Allocated for Volume---ensures that there is enough memory allocated for NFS directory information. A larger value causes the NFS Gateway to reserve more RAM at startup for directory table expansion. The default value is 1 block of 256 kbytes.
If a large NFS Gateway volume is to be mounted, a large block of memory should be allocated. If this memory can be allocated before the gateway volume is initially mounted, it improves the performance of the system. If you are aware of the large size of the NFS Gateway volumes and if memory required for each volume can be preallocated, performance will be highly improved.
The size of the initial block of memory is selected through the NUMBER OF BLOCKS INITIALLY ALLOCATED FOR VOLUME parameter in the"NFS Gateway Volume Information Form." Select the volume that needs a larger block of memory and enter the block allocation number. (You can enter a number between 1 and 256.) For more information, see "Understanding the NFS Gateway Volume Information Form."
The initial number of blocks can be calculated as follows:
NOTE: You can determine the No of Initial Blocks for a particular volume by using the above calculation. For the entire gateway, the Total Memory Required for this Volume should be added and this value should be assigned to the MAX_MEMORY parameter in the NWPARAMS file. You can modify this parameter from UNICON by modifying the Maximum Size of Cache in the NFS Gateway Parameters form. For more details, see "NFS Gateway Parameters Form." You can also be modify this parameter directly in the NWPARAMS file. For more details, see the description and usage of this parameter in the "Parameters" section.
Example: For a directory containing 140,000 files in a volume, the initial number of blocks should be calculated as follows:
Pressing the F4 function key enables you to review the resource usage for the remote file system. The resources are used by a shadow file, which contains information that the system uses to maintain and track source data in a file system. As a file system grows, the shadow file increases, requiring more resources.
Before the resource usage can be displayed, the file system must be mounted to a volume. If the Remote Hostname, the Remote Path, and the NetWare Volume Name are displayed in the NFS Gateway Volume Information form, this indicates the file system is mounted to a volume.
An example of the displayed usage information follows:
where
Total Directories---the number of directories in the remote file system.
Extra Blocks for Directories---the number of extra blocks needed for this file system. (Each block is equal to 8 KB).
Disk Space for Shadow File---the total disk space (in kilobytes) needed for this file system.
Memory Required---the amount of memory (in kilobytes) required on the server for this file system.
If the shadow file for a Gateway volume needs more disk space than originally calculated, you might want to store the file on a different volume. Store the shadow file on a different volume by modifying the NetWare Volume On Which Shadow File is Created field on the NFS Gateway Volume Information form described on "NFS Gateway Volume Information Form."
IDXforms:default queue configuration/IDXThe Default Volume Configuration form displays default configuration information for Gateway volumes. UNICON uses this information when creating new Gateway volumes.IDXforms:default volume configuration/IDXIDXvolumes:using the management screens:default volume configuration form/IDX
From the UNICON Main Menu, select Manage Services > NFS Gateway > Set Default Volume Configuration.
This form includes the same fields as the NFS Gateway Volume Information form. For a complete description of the fields, see "NFS Gateway Volume Information Form."
Complete procedure and exit.
The mounted volumes list lists all mounted Gateway volumes and the associated remote file system.
From the UNICON Main Menu, select Manage Services > NFS Gateway > Mount/Dismount Volumes.
Complete procedure and exit.
The left column lists the names of all mounted Gateway volumes. The right column lists the path of the remote file system. The path consists of the NFS server name, a colon, and the full path of the directory.
The Dismounted Volumes list lists all dismounted volumes.
From the UNICON Main Menu, select Manage Services > NFS Gateway > Mount/Dismount Volumes.
The utility displays the mounted volumes list described above.
Press Insert.
The utility displays the Dismounted Volumes list.
The left column lists the name of the NetWare Gateway volume set up to access the remote file system. The right column lists the path of the remote file system. The path consists of the NFS server name, a colon, and the full path of the directory.
The Volume Status list displays the mount status of all Gateway volumes.
From the UNICON Main Menu, select Manage Services > NFS Gateway > View Volume Status.
Complete procedure and exit.
The left column lists the NetWare Gateway volume accessing the associated remote file system.
The middle column lists the name of the remote NFS server, followed by a colon and the full path of the remote file system.
The right column lists the status of the remote file system. When the status is Dismounted, the entry still exists for the Gateway volume and the remote file system. You can mount the Gateway volume using the Mount/Dismount Volume option.
IMPORTANT: Any NFS Gateway volume is designed to work only with a remote file system and should not be re-exported. The behavior of such a re-exported file system is not guaranteed and might lead to serious problems. We strongly recommend that NFS Gateway volumes should not be re-exported.
The Detailed Volume Status form displays detailed status information for a Gateway volume.
From the UNICON Main Menu, select Manage Services > NFS Gateway > View Volume Status.
The utility displays the Volume Status list described on "Displaying the Volume Status List."
Select a Gateway volume from the list.
The utility displays the Detailed Volume Status form.
This form contains the following fields:
Volume---the name of the NetWare Gateway volume.
Remote Path---the name of the remote NFS server, a colon, and the full path of the remote file system.
Status---whether the volume is currently mounted.
Remote NFS Server Status---the status of the remote NFS server.
Remote Lock Manager Status---the status of the Lock Manager on the remote NFS server.
Total Disk Space---the disk space used by the Gateway volume, in kilobytes.
Available Disk Space---the amount of disk space available for the Gateway volume, in kilobytes. Available disk space also displays as a percentage of the total disk space.
Total Directory Entries---the number of directory entries for the volume.
Available Directory Entries---the number of directory entries available. This information also displays as a percentage of the total directory entries.