home *** CD-ROM | disk | FTP | other *** search
/ OS/2 the Most Complete Collection / OS2_The_Most_Complete_Collection_Powersource.iso / protocol / nfs20c1.exe / NFSCSD.DOC < prev    next >
Text File  |  1994-06-13  |  24KB  |  532 lines
  1.  
  2.                   *************************************
  3.          ********* UN57064 CORRECTIVE SERVICE DISKETTE *********
  4.                   *************************************
  5.  
  6.   TCP/IP 2.0 for OS/2 NFS Corrective Service Diskette Information
  7.  
  8.  
  9.      This README file for the corrective service diskette (CSD) reflects
  10.      new and changed functions for the TCP/IP 2.0 for OS/2 Network File
  11.      System (TM) kit.
  12.  
  13.      Note:  You must install the Base Kit CSD (UN56401) before you
  14.             install this CSD.
  15.  
  16.  
  17.  
  18.   ---------------------------------------------------------------------
  19.      Topics incuded in this CSD are:
  20.  
  21.  
  22.         1. Installing this CSD
  23.         2. Previous CSD Information
  24.         3. Obtaining Future CSDs Electronically
  25.         4. Changes to NFSSTART
  26.         5. Changes to EXPORTS File
  27.         6. The MOUNT Command
  28.         7. The UMOUNT Command
  29.         8. NFS Security
  30.         9. The NFSCLEAN Command
  31.        10. APAR Fixes
  32.  
  33.  
  34.  
  35.   ---------------------------------------------------------------------
  36.    1. Installing this CSD
  37.  
  38.  
  39.      To install this CSD from a diskette at your workstation, insert the
  40.      diskette into your A: drive and enter:
  41.  
  42.              A:>TCPINST
  43.  
  44.  
  45.  
  46.   ---------------------------------------------------------------------
  47.    2. Previous CSD Information
  48.  
  49.  
  50.      This CSD incorporates the corrective service and new functions
  51.      that were previously released in CSD UN52836.  Please see the file
  52.      README.BAS in the <tcpip>\DOC directory for a description of the
  53.      functions that were originally released in UN52836.
  54.  
  55.  
  56.  
  57.   ---------------------------------------------------------------------
  58.    3. Obtaining Future CSDs Electronically
  59.  
  60.  
  61.      You can obtain Corrective Service Diskettes (CSDs) electronically
  62.      by:
  63.  
  64.         o   Using FTP to access SOFTWARE.WATSON.IBM.COM as Anonymous.
  65.  
  66.             NOTE:  Fixes for TCP/IP for OS/2 are located in the
  67.                    pub\tcpip\os2 directory.
  68.  
  69.         o   Establishing a modem connection to the NCSBBS bulletin board
  70.             at 1-919-517-0001.
  71.  
  72.             NOTE:  Set your modem settings to: none,8,1.
  73.  
  74.      The latest CSDs for TCP/IP Version 2.0 for OS/2 are shown in the
  75.      following table:
  76.  
  77.         +=============================+===========================+
  78.         | KIT NAME                    | PACKAGE NAME              |
  79.         +=============================+===========================+
  80.         | Applications Kit            | APP20CSD.PKG              |
  81.         +-----------------------------+---------------------------+
  82.         | Base Kit                    | TCP20CSD.PKG              |
  83.         +-----------------------------+---------------------------+
  84.         | Domain Name Server Kit      | DNS20CSD.PKG              |
  85.         +-----------------------------+---------------------------+
  86.         | DOS/Windows Access Kit      | DOS20CSD.PKG              |
  87.         +-----------------------------+---------------------------+
  88.         | Extended Networking Kit     | XNT20CSD.PKG              |
  89.         +-----------------------------+---------------------------+
  90.         | NetBIOS Kit                 | NET20CSD.PKG              |
  91.         +-----------------------------+---------------------------+
  92.         | Network File System Kit     | NFS20CSD.PKG              |
  93.         +-----------------------------+---------------------------+
  94.         | OSF/Motif Kit               | MOT20CSD.PKG              |
  95.         +-----------------------------+---------------------------+
  96.         | Programmer's Tool Kit       | PGM20CSD.PKG              |
  97.         +-----------------------------+---------------------------+
  98.         | X Window System Client Kit  | XCL20CSD.PKG              |
  99.         +-----------------------------+---------------------------+
  100.         | X Window System Server Kit  | PMX20CSD.PKG              |
  101.         +-----------------------------+---------------------------+
  102.  
  103.  
  104.  
  105.            *************************************************
  106.   ********* UN57064 CORRECTIVE SERVICE DISKETTE STARTS HERE *********
  107.            *************************************************
  108.  
  109.  
  110.   ---------------------------------------------------------------------
  111.    4. Changes to NFSSTART
  112.  
  113.  
  114.      NFSSTART is now an executable file instead of a command file.  Now,
  115.      when entering this command in the TCPSTART.CMD file, it should be
  116.      entered as:
  117.  
  118.             nfsstart
  119.  
  120.      instead of the previous format:
  121.  
  122.             call nfsstart.cmd
  123.  
  124.      Note:  To avoid conflicting commands and to preserve changes you
  125.             may have made to NFSSTART.CMD, the installation program
  126.             automatically renames NFSSTART.CMD to NFSSTART.BAK when
  127.             you install this CSD. You must make changes to your
  128.             TCPSTART.CMD file to ensure that NFS starts properly.
  129.             There are two ways to make the changes to TCPSTART.CMD:
  130.  
  131.                - Open and save the Configuration Notebook (run and save
  132.                  TCPIPCFG.EXE)
  133.  
  134.                - Manually edit TCPSTART.CMD to call NFSSTART.EXE instead
  135.                  of the old NFSSTART.CMD
  136.  
  137.  
  138.  
  139.   ---------------------------------------------------------------------
  140.    5. Changes to EXPORTS File
  141.  
  142.      The hostname field of the NFSD EXPORTS file now accepts
  143.      dotted-decimal IP addresses as well as hostnames.  Dotted-decimal
  144.      addresses have the advantage of not requiring the resolver during
  145.      initialization.
  146.  
  147.      In addition, to be more efficient, NFSD now converts the hostnames
  148.      in the EXPORTS file to IP addresses while the EXPORTS file is being
  149.      read rather than every time a mount request arrives.
  150.  
  151.  
  152.  
  153.   ---------------------------------------------------------------------
  154.    6. The MOUNT Command
  155.  
  156.  
  157.      The MOUNT command's -u and -g parameters have been modified to
  158.      accept a wider range of values.
  159.  
  160.  
  161.      >>--mount--.-----.--.-----------------.--.-----.--.--------.-->
  162.                 '- -c-'  '- -v--.--------.-'  '- -a-'  '- -uuid-'
  163.                                 '-passwd-'
  164.  
  165.      >----.--------.--.------------.--.-----------.--.-----.------->
  166.           '- -ggid-'  '- -lloginid-'  '- -ppasswd-'  '- -s-'
  167.  
  168.      >-- drive_letter-- host_name:exported_file_system------------><
  169.  
  170.  
  171.      -uuid     Specifies the user ID (uid).  The uid must be a number
  172.                between -2 147 483 647 and +2 147 483 647.
  173.  
  174.                Note:  The range of values for the uid includes spaces
  175.                       for readability.  When entering your uid, you
  176.                       should not include any spaces.
  177.  
  178.      -ggid     Specifies the group ID (gid).  The gid must be a number
  179.                between -2 147 483 647 and +2 147 483 647.  The GID value
  180.                is passed to the NFS server for authentication.
  181.  
  182.                Note:  The range of values for the gid includes spaces
  183.                       for readability.  When entering your gid, you
  184.                       should not include any spaces.
  185.  
  186.      Notes:
  187.        1.  If the client is mounting an OS/2 server, a UID and GID are
  188.            still needed for the connection, but are not used for
  189.            security.
  190.        2.  The OS/2 NFS client supports versions 1 and 2 of the PCNFSD
  191.            protocol.  NFS determines which version is running each time
  192.            you issue a MOUNT command.
  193.        3.  If you use PCNFSD when using the MOUNT command and
  194.            PCNFSD returns -2, -2 for the UID and GID, (indicating the
  195.            'nobody' user), you can still mount a directory.
  196.  
  197.  
  198.  
  199.   ---------------------------------------------------------------------
  200.    7. The UMOUNT Command
  201.  
  202.  
  203.      The following warning has been added to the UMOUNT command
  204.      description:
  205.  
  206.      Warning:  To avoid unpredictable results, wait until all processing
  207.                stops before unmounting a drive.
  208.  
  209.  
  210.  
  211.   ---------------------------------------------------------------------
  212.    8. NFS Security
  213.  
  214.  
  215.      The NFS server protects files by limiting access to directories
  216.      through:
  217.  
  218.           - The EXPORTS file
  219.           - PCNFSD
  220.  
  221.   ----------------------
  222.    8.1 The EXPORTS file
  223.  
  224.      The \TCPIP\ETC\EXPORTS file (on the OS/2 NFS server) must list each
  225.      directory to be made available to NFS clients.  If a directory is
  226.      listed, all of its files and subdirectories are available to the NFS
  227.      client.  However, the EXPORTS file allows the NFS server's
  228.      administrator to limit client access to directories (based upon the
  229.      client's IP address or hostname).  The following is an example of
  230.      the contents of an EXPORTS file:
  231.  
  232.           d:\share\joe         joe.somewhere.com
  233.           d:\share\mary        pink.triangle.edu
  234.  
  235.      In this example, a user would have to use a machine with an
  236.      address of joe.somewhere.com to access any of the files and
  237.      subdirectories under the d:\share\joe directory.  Similarly, to
  238.      access any files under d:\share\mary, requests would need to
  239.      originate from the machine using an address of pink.triangle.com.
  240.  
  241.      Note: The hostname field of the NFSD EXPORTS file now accepts
  242.            dotted-decimal IP addresses as well as hostnames.
  243.            Dotted-decimal addresses have the advantage of not requiring
  244.            the resolver during initialization.
  245.  
  246.   ----------------------
  247.    8.2 PCNFSD
  248.  
  249.      NFS also provides security by enforcing authentication through
  250.      PCNFSD.  PCNFSD is a server which maps a valid login name and
  251.      password to a uid (user ID).
  252.  
  253.      When the OS/2 NFS client issues a MOUNT command to access an NFS
  254.      server's directories, the MOUNT command checks to see if PCNFSD is
  255.      available.  If it is, the OS/2 MOUNT command prompts you for your
  256.      login name and password which it then passes to PCNFSD.  If PCNFSD
  257.      authenticates the login name and password, it passes back the
  258.      associated uid.  The OS/2 NFS client then uses that uid for each NFS
  259.      request, ignoring any previously specified uid.  If PCNFSD reports
  260.      that the login name or password is invalid, the MOUNT command is
  261.      terminated and access to the server's files is denied.
  262.  
  263.      PCNFSD uses the PASSWD file, located in the directory specified by
  264.      the ETC environment variable.  Each line in the PASSWD file contains
  265.      a user's:
  266.  
  267.           - Login name
  268.           - Password
  269.           - User id (uid)
  270.           - Group id (gid)
  271.           - Full name
  272.           - Home directory
  273.           - Login shell
  274.  
  275.      As additional security, the password is encrypted in the file using
  276.      a randomly chosen encryption key.  Because each machine uses a
  277.      different key, a user can use the same password on different
  278.      machines with no loss of security.  The user's full name, home
  279.      directory, and login shell fields are provided only for Unix
  280.      compatibility, and are not used by OS/2.
  281.  
  282.      Notes:
  283.        1. You can update the PASSWD file using the PASSWD command.
  284.           You should not edit the PASSWD file manually because of its
  285.           specific syntax.
  286.  
  287.        2. If the PASSWD file contains path information in one or
  288.           more of its fields, the colon normally used as part of the
  289.           OS/2 path will appear in the PASSWD file as a semicolon.
  290.           This is normal, and is due to the fact that PASSWD uses the
  291.           colon character to separate the fields.
  292.  
  293.   ----------------------
  294.    8.3 Starting and Running PCNFSD
  295.  
  296.      You can start PCNFSD from an OS/2 command line, or you can set up
  297.      PCNFSD to autostart.  The PCNFSD syntax is:
  298.  
  299.      >>--pcnfsd------------------------------------------------------><
  300.  
  301.  
  302.      Note:  Because TCPIPCFG does not currently recognize PCNFSD, every
  303.             time you run TCPIPCFG, it will remove PCNFSD from TCPSTART.
  304.             Therefore, you should start PCNFSD from the TCPEXIT.CMD file
  305.             located in \TCPIP\BIN.  If this file exists, TCPSTART.CMD
  306.             executes it as its final action.
  307.  
  308.      After you start PCNFSD, all error messages and warnings are logged
  309.      to SYSLOGD (if running).  Whenever a client's authentication fails,
  310.      a message is logged to SYSLOGD.  If a client repeatedly fails to
  311.      authenticate, you should consider investigating the problem, because
  312.      it could be an unauthorized attempt to access your data.
  313.  
  314.   ----------------------
  315.    8.4 The PASSWD Command
  316.  
  317.      Use the PASSWD command to create the PASSWD file, and to add or
  318.      modify the information in that file.
  319.  
  320.      Note:  The OS/2 PASSWD file is compatible with any non-System 5 Unix
  321.             PASSWD file.  System 5 based Unix shadows passwords in a
  322.             different file.
  323.  
  324.      >>--passwd--.-----.-- login_name--------------------------------><
  325.                  |- -a-|
  326.                  |- -f-|
  327.                  '- -s-'
  328.  
  329.  
  330.      -a          Specifies that PASSWD is to add information for the
  331.                  user (login_name) to the PASSWD file.  After you press
  332.                  Enter, PASSWD prompts you for the user's:
  333.  
  334.                      -  Password (twice, for verification)
  335.                      -  Uid
  336.                      -  Gid
  337.                      -  Full name
  338.                      -  Home directory
  339.                      -  Login shell
  340.  
  341.                  The login name and its associated uid must be unique.
  342.                  If either the login name or the uid is already listed
  343.                  in the PASSWD file, PASSWD does not change the file.
  344.  
  345.      -f          Specifies that you are changing the FINGER information
  346.                  for the specified user.  This parameter is provided for
  347.                  Unix compatibility and is not used by OS/2.
  348.  
  349.                  Note:  The FINGER command displays information about
  350.                         users on a remote host.  On Unix, finger
  351.                         information for a login name reveals information
  352.                         about the person to whom that login name belongs.
  353.                         It can include the user's full name, office,
  354.                         telephone number, and other information deemed
  355.                         appropriate by the user.
  356.  
  357.      -s          Specifies that you are changing the default shell for
  358.                  the specified user.  This parameter is provided for
  359.                  Unix compatibility and is not used by OS/2.
  360.  
  361.      login_name  Specifies the user's login name.
  362.  
  363.                  If you do not specify other parameters with login_name,
  364.                  PASSWD allows you to change the specified user's
  365.                  password.  PASSWD first requests the current password to
  366.                  verify that the user has the authority to change the
  367.                  password.  PASSWD then requests the new password twice,
  368.                  the second time as verification.
  369.  
  370.   ----------------------
  371.    8.5 SYSLOGD
  372.  
  373.      If you are running SYSLOGD, applications can record error messages
  374.      and warnings for future reference.  Messages can be:
  375.  
  376.           - Recorded in a file on your local host
  377.           - Forwarded to a central location
  378.  
  379.      If everyone forwards the messages to a central location, the system
  380.      administrator can browse and discover problem areas easily instead
  381.      of logging onto each host to check the SYSLOG message depository.
  382.  
  383.      You can start SYSLOGD from an OS/2 command line, or you can set up
  384.      SYSLOGD to autostart.  The SYSLOGD syntax is:
  385.  
  386.      >>--syslogd--.------------.-------------------------------------><
  387.                   '- -t target-'
  388.  
  389.      -t target   Specifies the target host, where target can be:
  390.  
  391.                  o   A fully qualified path name
  392.                  o   An IP address
  393.                  o   An IP host name
  394.  
  395.      If target specifies a fully-qualified filename, SYSLOGD will append
  396.      all messages to that file.  If target is an IP address or IP
  397.      hostname, SYSLOGD forwards all messages to that host's SYSLOGD.  If
  398.      the -t option is not specified, SYSLOGD defaults to a file called
  399.      SYSLOG.MSG in the \TCPIP\ETC subdirectory.
  400.  
  401.      You should inspect the target file occasionally, because the file
  402.      will grow depending on which applications are running and how many
  403.      messages they record.  In addition, you should monitor all recorded
  404.      program errors (for example, authentication failures).
  405.  
  406.      Note:  Because TCPIPCFG does not currently recognize SYSLOGD, every
  407.             time you run TCPIPCFG, it will remove SYSLOGD from TCPSTART.
  408.             Therefore, you should start SYSLOGD from the TCPEXIT.CMD file
  409.             located in the \TCPIP\BIN subdirectory.  If this file exists,
  410.             TCPSTART.CMD executes it as its final action.
  411.  
  412.  
  413.  
  414.   ---------------------------------------------------------------------
  415.    9. NFSCLEAN Command
  416.  
  417.  
  418.      The description of the NFSCLEAN command function as stated in the
  419.      Command Reference is incorrect.  The following replaces the original
  420.      description:
  421.  
  422.           If NFS has been stopped without unmounting all attached drives,
  423.           use the NFSCLEAN command to unmount drives that are still
  424.           attached.
  425.  
  426.  
  427.  
  428.   ---------------------------------------------------------------------
  429.   10. APAR Fixes
  430.  
  431.  
  432.      The following is a list of APARs fixed since this release became
  433.      available.  APARs are grouped numerically by CSD.
  434.  
  435.   ----------------------
  436.   10.1 APARs Fixed in This CSD (UN57064)
  437.  
  438.      +============+=============+=======================================+
  439.      |            | MODULES     |                                       |
  440.      | APAR       | AFFECTED    | DESCRIPTION                           |
  441.      +============+=============+=======================================+
  442.      | PN46796    | NFSCTL.EXE  | Fixed:  Symbolically linked           |
  443.      |            |             | directories could not be linked by    |
  444.      |            |             | applications.                         |
  445.      +------------+-------------+---------------------------------------+
  446.      | PN46880    | NFSD.EXE    | Fixed:  User starts the NFS client,   |
  447.      |            |             | connects to the SERVER, and receives  |
  448.      |            |             | error messages, resulting in an abend.|
  449.      +------------+-------------+---------------------------------------+
  450.      | PN48329    | NFSCTL.EXE  | Fixed:  NFSCTL receives divide by     |
  451.      |            |             | zero error msg and terminates.        |
  452.      +------------+-------------+---------------------------------------+
  453.      | PN48338    | NFSD.EXE    | Fixed:  NFSD will hang when client    |
  454.      |            |             | tried to access file dated 1/1/80.    |
  455.      +------------+-------------+---------------------------------------+
  456.      | PN49844    | NFSD.EXE    | Fixed:  Wrong error code returned     |
  457.      |            |             | if MKDIR invoked when directory       |
  458.      |            |             | already exists.                       |
  459.      +------------+-------------+---------------------------------------+
  460.      | PN50108    | NFSCTL.EXE  | Fixed:  DOS LAN requestor deleted     |
  461.      |            |             | wrong files through an NFS mounted    |
  462.      |            |             | drive.                                |
  463.      +------------+-------------+---------------------------------------+
  464.      | PN50393    | NFSD.EXE    | Fixed:  Unable to access              |
  465.      |            |             | two-directory deep filesystem if a    |
  466.      |            |             | client name is specified in EXPORTS   |
  467.      |            |             | file.                                 |
  468.      +------------+-------------+---------------------------------------+
  469.      | PN52057    | NFS200.IFS  | Fixed:  DOSQUERYPATHINFO level 7      |
  470.      |            |             | request not fixed in UN52836.         |
  471.      +------------+-------------+---------------------------------------+
  472.      | PN52251    | NFSCTL.EXE  | Fixed:  Unable to set access rights   |
  473.      |            |             | on NFS mounted drive.                 |
  474.      +------------+-------------+---------------------------------------+
  475.      | PN53322    | NFSCTL.EXE  | Fixed:  Some applications cannot save |
  476.      |            |             | files to an NFS mounted drive.        |
  477.      +------------+-------------+---------------------------------------+
  478.      | PN54375    | NFSCTL.EXE  | Fixed: DIR of an NFS drive on some    |
  479.      |            |             | servers would return the '.'          |
  480.      |            |             | directory and then give back an       |
  481.      |            |             | error code.                           |
  482.      +------------+-------------+---------------------------------------+
  483.      | PN55249    | NFSCTL.EXE  | Fixed:  MS Word can't save a document |
  484.      |            |             | when file sharing is enabled.         |
  485.      +------------+-------------+---------------------------------------+
  486.      | PN55250    | NFSCTL.EXE  | Fixed:  NFS can only mount/unmount    |
  487.      |            |             | about 7000 times.                     |
  488.      +------------+-------------+---------------------------------------+
  489.  
  490.   ----------------------
  491.   10.2 The following APARs were fixed in CSD UN52836.  These
  492.       changes are included in this CSD as well.
  493.  
  494.      +============+=============+=======================================+
  495.      |            | MODULES     |                                       |
  496.      | APAR       | AFFECTED    | DESCRIPTION                           |
  497.      +============+=============+=======================================+
  498.      | PN45546    | NFSCTL.EXE  | Fixed: Copying over a file with a     |
  499.      |            |             | different UID but the same GID will   |
  500.      |            |             | not work.                             |
  501.      +------------+-------------+---------------------------------------+
  502.      | PN45780    | NFSCTL.EXE  | Fixed: A date of 1/1/80 and a time    |
  503.      |            |             | between midnight and 1 AM caused a    |
  504.      |            |             | trap.                                 |
  505.      +------------+-------------+---------------------------------------+
  506.      | PN46618    | NFSBIOD.EXE | Fixed: NFS limited to 40 mounts.      |
  507.      +------------+-------------+---------------------------------------+
  508.      | PN46869    | NFSCTL.EXE  | Fixed: Directory gets SYS0005 if      |
  509.      |            | NFSDIR.EXE  | there are files you do not have       |
  510.      |            |             | access to.                            |
  511.      +------------+-------------+---------------------------------------+
  512.      | PN46970    | NFSCTL.EXE  | Fixed: In NFS, XCOPY with wildcard    |
  513.      |            |             | characters only (*.*) fails.          |
  514.      +------------+-------------+---------------------------------------+
  515.      | PN47285    | NFSCTL.EXE  | Fixed: NFS client does not handle     |
  516.      |            |             | daylight savings time correctly.      |
  517.      +------------+-------------+---------------------------------------+
  518.      | PN47491    | UMOUNT.EXE  | Fixed: When a user unmounts an        |
  519.      |            |             | RS/6000, the ETC/RMTAB file is not    |
  520.      |            |             | being updated on the RISC/6000.       |
  521.      +------------+-------------+---------------------------------------+
  522.      | PN48574    | NFSCTL.EXE  | Fixed: NFSCTL does not support        |
  523.      |            |             | DosQueryPathInfo level 7.             |
  524.      +------------+-------------+---------------------------------------+
  525.      | PN48770    | NFSCTL.EXE  | Fixed: Mounting a server when client  |
  526.      |            | MOUNT.EXE   | uses 4OS2 results in files not        |
  527.      |            |             | displaying with DIR command.          |
  528.      +------------+-------------+---------------------------------------+
  529.  
  530.  
  531.  
  532.