Chapter Contents

Previous

Next
Installing and Administering the NFS Client

Diagnosing Problems

The first step in identifying problems is to look carefully at the diagnostics that are produced by the debugger at the point where the failure occurred. Depending on whether the messages are generated by the debugger or by the library, the messages may be printed in the log window, or they may be printed in line mode after erasing the debugger screen.

Many user problems are caused by incorrect installation of system software. These problems can often be diagnosed by understanding what is missing. Sometimes a configuration file is missing. Other times an environment variable definition is needed, or a REXX EXEC is not placed where it will be accessed.

In other cases, problems are caused by network and server failures. For server problems and failures on remote systems, the RPCINFO and SHOWMNT commands are useful. Both SHOWMNT and RPCINFO are compatible with the equivalent commands under UNIX.

If you are having problems during the NFS login or the remote mounting process, set the _SASC_NFS_VERBOSE evironment variable to 1. This produces additional diagnostic information during the NFS login process and the remote directory mount process.

Beginning with SAS/C Release 7.00 the SAS/C CSL NFS client library function NFSLOGIN has been changed to allow communication with NFS login servers that use port 2049 as well as one of the reserved ports. Port 2049 has been registered by Sun Microsystems for use by NFS.

The NFSLOGIN function was also enhanced to allow the installation to specify a specific port to be used for communication with the NFS login server. After customization, the NFSLOGIN function will communicate with the NFS login server that uses the specified port. No other port will be accepted.

Note:    See the installation instructions for information on customizing the desired port.  [cautionend]
To provide more diagnostic information, the NFS login process and the mount remote directory process have been enhanced to display informative messages about the activity of each process. To enable the display of these messages, define the environment variable _SASC_NFS_VERBOSE. When _SASC_NFS_VERBOSE is defined as 1, the informative message will be produced.

Output similar to the following will be produced by the NFSLOGIN function when the NFSLOGIN command is executed:

nfslogin solgnu
nfslogin -s nfsloginhost.mysite -u myuserid -p mypassword
NFSLOGIN - NFSLOGINHOST IP ADDRESS: 10.23.149.16
NFSLOGIN - RACF Resource          : P10.23.149.16
NFSLOGIN - RACF access to Resource: allowed
NFSLOGIN - NFSLOGIN Server        : PCNFSD
NFSLOGIN - Username               : myuserid
NFSLOGIN - PCNFSD Program Number  : 150001
NFSLOGIN - Port returned          : 924
NFSLOGIN - Port checking          : reserved or 2049
NFSLOGIN - PCNFSD Version         : 2
NFSLOGIN - NFS_LOGINKEY : f75cf6f3f66ff4f45cf1f0.........
NFSLOGIN - NFS_LOGINDATE: 12/3/1999
NFSLOGIN - NFS_UID      : 2447
NFSLOGIN - NFS_GID      : 105
NFSLOGIN - NFS_GID_LIST :
NFSLOGIN -   GID_LIST item 0 value: 44
Login succeeded.

Output similar to the following is produced by the ls command during the mount process:

ls
MOUNT    - mount - ftstab used : //DDN:ETCFSTAB
MOUNT    - mount - device      :
MOUNT    -   >>>>krups.unx:/vol/vol0/u/userid
MOUNT    - mount - mountpoint  :/
MOUNT    -        Host(krups.unx), MOUNTPROG(100005), MOUNTVERS(1)
MOUNT    - mount: successful
MOUNT    - mount - device      :
MOUNT    -   >>>>krups.unx:/vol/vol0/u/sasctg/playpen_700_mvs
MOUNT    - mount - mountpoint  :/unix_mount_point1
MOUNT    -        Host(krups.unx), MOUNTPROG(100005), MOUNTVERS(1)
MOUNT    - mount: successful
MOUNT    - mount - device      :
MOUNT    -   >>>>d5412.us:c:/C++_Samples
MOUNT    - mount - mountpoint  :/pc_mount_point1
MOUNT    -        Host(d5412.us), MOUNTPROG(100005), MOUNTVERS(1)
MOUNT    - mount: successful
MOUNT    - mount - device      :
MOUNT    -   >>>>krups.unx:/vol/vol0/u/sasctg/
MOUNT    - mount - mountpoint  :/unix_mount_point2
MOUNT    -        Host(krups.unx), MOUNTPROG(100005), MOUNTVERS(1)
MOUNT    - mount: successful

Typically, NFS login servers use a reserved port (<=1023) or port 2049 for communication with a client. If your NFS login server uses some other port you may specify the correct port by using the zap provided in Usage Note 1900. The RPCINFO command can be used to determine which port is being used by the NFS login server.

For true network problems, SNMP or other network diagnostic facilities are most useful.


Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.