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