 

















                     ______________________________________________
                     DCEECO1B013 Release Notes


                     These release notes describe last-minute changes,
                     fixes, and known errors.

 






              __________________________________________________________

                Digital Equipment Corporation. 1996.

              All Rights Reserved.

              This document was prepared using VAX DOCUMENT, Version
              2.1.

 













     ________________________________________________________________

                                                             Contents


           1     Kit Information..............................      1
           2     New Files....................................      1
           3     Files Patched or Replaced....................      1
           4     Configuration Note...........................      1
           5     Troubleshooting Note.........................      2
           6     Problems Addressed in This Kit...............      2
           6.1       RPC Runtime..............................      2
           6.2       dtsd.....................................      3
           6.3       dcesetup.................................      3
           6.4       idl......................................      4
           6.5       CDS......................................      4
           6.5.1       Corrected Problems.....................      4
           6.5.2       Unable to Create a CDS Replica
                       Immediately After Removing It..........      4
           6.6       Security.................................      5
           6.7       DFS Object Files.........................      5
           7     General Installation Instructions............      6
           8     Replacing Mail Executables...................      6
           9     Notice to Cell Administrators................      7















                                                                  iii

 






        1 Kit Information

              This kit is DCEECO1B013 and can be applied to DCE for
              Digital UNIX Version 1.3b (formerly DEC OSF/1 Alpha).

        2 New Files

              None.

        3 Files Patched or Replaced

              o  cdsd (executable)

              o  dtsd (executable)

              o  cm_vnodeops.o (DFS object)

              o  cm_tokens.o (DFS object)

              o  stanza.static (DFS file)

              o  dcesetup (configuration tool)

              o  idl (executable)

              o  libdce.so (shared library)

              o  mailstats (DEC OSF/1 Base OS executable)

              o  sendmail (DEC OSF/1 Base OS executable)

        4 Configuration Note

              While configuring a client based on R1.1 into a V1.3b ECO
              1 cell, you may receive informational messages, such as
              the following, regarding protocol version mismatch:

    <receive_packet> assoc->25208 Protocol version mismatch - major->5 minor->1
    <receive_packet> assoc->25808 Protocol version mismatch - major->5 minor->1

              You can ignore these messages.




                                                                       1

 






        5 Troubleshooting Note

              OSF DCE R1.1 introduced a new security group subsys/dce
              /dced-admin which was not present in previous releases
              of DCE. As a result, Digital has observed some failures
              in split server configuration attempts when the Security
              Master on Digital UNIX is pre-R1.1 (that is, prior to
              the DCE Version 2.0 on Digital UNIX product) and the Cell
              Directory Server is on another vendor's R1.1-based (or
              later) platform. One way this error is reported during the
              CDS Master Server configuration is shown in the following
              example:

                      Modifying acls on /.:/sec ...
    ERROR:   acl_edit - modifying ACLs on security objects in the name space.
                         Message from acl_edit:
                         ERROR: acl object not found (dce / sec)
                       Unable to bind to object

              This represents an invalid attempt to modify an acl on
              an object that is not created by R1.0.3-based security
              servers. Please contact the vendor where the CDS Master
              Server is being initialized if an error, similar to the
              one described, is generated.

        6 Problems Addressed in This Kit

              The following sections describe problems that were fixed
              in this release.

        6.1 RPC Runtime

              The following two RPC Runtime errors were fixed:

              o  When authenticated TCP RPC was used with varying
                 arrays containing large amounts of data, the server
                 could crash in memcpy() while trying to unmarshall
                 input arguments. The client side was not aligning data
                 correctly when marshalling.

              o  Also pertaining to authenticated TCP RPC, server-side
                 warnings of a protocol version mismatch occurred,
                 usually with versions of either "major->1 minor->5" or
                 "major->1 minor->2". The error was usually caused when
                 clients were terminated abruptly by the user. Because

        2

 






                 of the server- side corruption that would occur, a
                 number of symptoms could follow, including:

                 -  rpc lookaside list corruption warnings

                 -  Connection closed messages (RPC-054 in Encina code)

                 -  Communications error messages

                 -  A warning in the form of:

(receive_packet) assoc->460608 frag_length 4097 in header>fragbuf data size 4096
                 -  AUTH_VFY_CLIENT errors

                 -  A crash in the MD5Update() routine

        6.2 dtsd

              Corrected the problem where dtsd could not start on the
              TruCluster system because the memory channel did not
              support the DLI option. The code in the dli_unix module
              created DLI sockets over all network devices. Since the
              memory channel in the TruCluster V1.0 does not support the
              DLI option, when dtsd tried to create a DLI socket on the
              memory channel, dtsd failed and exited.

        6.3 dcesetup

              The following two dcesetup problems were fixed:

              o  V1.3 clients could not configure into a cell running
                 some vendors' R1.1 security masters because dcesetup
                 assumed that the name of the security master was .:
                 /subsys/dce/sec/master,as it had been previously. In
                 Hewlett Packard's recent R1.1 product, and in the R1.2
                 code base from OSF, the name of the security master has
                 been changed to .:/subsys/dce/sec/<hostname>.

                 The configuration tool, dcesetup, now looks under
                 the security junction for a list of security replicas
                 available in the cell and makes its determination of
                 the location of the security master based upon that
                 information.

              o  After the initial configuration, a dcesetup stop
                 command would not successfully find and kill sec_
                 clientd because it is not restarted with its full path.

                                                                       3

 






                 The reference to sec_clientd has been altered to use
                 the full pathname.

        6.4 idl

              The function registerObject now returns if it encounters
              a non-proxy object. The routine also creates a binding
              vector if necessary.

        6.5 CDS

        6.5.1 Corrected Problems

              The following problems in CDS were corrected:

              o  A database corruption bug in the CDS server that
                 sometimes resulted in cdsd crashing.

              o  The CDS simple name compare function, where one name
                 is a prefix of the other name, had a bug that caused
                 the length of the compared names to be miscalculated
                 sometimes.

              o  The bug that generated the error message "Server clocks
                 are not synchronized" even when you had only one CDS
                 server. This bug would sometimes not allow you to
                 create, delete, or modify objects.

        6.5.2 Unable to Create a CDS Replica Immediately After Removing
              It

              If you attempt to recreate a CDS replica immediately after
              removing it, you may encounter the following error:

      What is the name for this clearinghouse? (Type '?' for help) [picabo_ch]:
                Creating clearinghouse files and replica for root directory...
              *** Error skulking directory (exiting)

              The problem arises when you delete the replica and cds-
              server principal the first time. The master cds server
              still has a key reference to that old (replica) cds-
              server principal. Then, when you recreate the cds-server
              principal with the same name but different key, and you
              attempt to skulk the root directory, the master cds
              server re-uses the old ticket, encrypted under the old
              principal's key.

        4

 






              The workaround is to stop (cdscp disable server) and
              restart
              cdsd (/opt/dcelocal/bin/cdsd) on the master node, or
              wait approximately two hours for the master cds server
              to refresh its tickets.

        6.6 Security

              The following problems in Security were corrected:

              o  The command sec_admin lrep -all now correctly reports
                 state information.

              o  The segmentation violation (segvio) problem in sec_
                 salvage_db> -reconstruct.

                 A minor outstanding problem still exists with sec_
                 salvage_db> -print. It fails if more than 10 ERAs are
                 attached to a single principal.

              o  Changes to support CDE in SIA are included in this
                 release.

              o  The memory leak in gssapi was fixed.

              o  Various other gssapi memory leaks were fixed.

        6.7 DFS Object Files

              The following problems relating to DFS were corrected:

              o  The problem where the dfsbind daemon could hang on SMP
                 systems because the dfs pseudo-device is not set to
                 funnel.

              o  The problem where the DFS client crashes when accessing
                 read-only filesets from IBM and Solaris DFS servers.

              o  The problem where the ld command can hang if run over
                 DFS on Digital UNIX Version 3.2D or later. This is
                 caused by a bug that can also manifest itself in other
                 ways, including system panics.



                                                                       5

 






        7 General Installation Instructions

              To install this kit, first ensure that DCE Version 1.3b
              is installed correctly. Then, untar the kit into a local
              directory, using the following command:

              % tar xvf <tar-file-location>/DCEECO1B013.tar

              % setld -l <./output>

              The choices for subsets will be:

              o  DCE Application Dev Kit V1.3b (ECO1)

              o  DCE CDS Server V1.3b (ECO1)

              o  DCE DFS Base V1.3b (ECO1)

              o  DCE Runtime Services V1.3b (ECO1)

              o  DCE Security Services V1.3b (ECO1)

              To restart DCE, enter:

              % /usr/sbin/dcesetup start

              If you are running DCE/DFS, you will need to rebuild
              the kernel using doconfig to include the new DFS kernel
              objects. Type doconfig and choose the DCEDFS kernel option
              from the menu (along with any others you desire). Copy
              the resulting kernel to /vmunix, reboot, and run /usr/sbin
              /dfssetup to configure DFS, if it has not already been
              configured.

        8 Replacing Mail Executables

              For DEC OSF/1 versions prior to Version 3.2, there is
              a bad interaction between the sendmail command and DCE
              /SIA. If you have SIA enabled and your OS version is less
              than 3.2, you should replace the programs sendmail and
              mailstats.

              To do this, perform the following steps:

              1. Kill the running version of sendmail, as follows:

                  % ps ax | grep sendmail

                   425 ??       I        0:07.30 -accepting connections (sendmail)

                  % kill 425

        6

 






              2. Copy the two replacement mail executables to their
                 place, as follows:

                  % cp -p /opt/dce/os/* /usr/sbin

              3. Change sendmail to be a suid root executable, as
                 follows:

                  % chmod 4755 /usr/sbin/sendmail

                 This should result in the following permissions and
                 owners:

      -rwxr-xr-x   1 bin      bin        37216 Feb  27  1995 /usr/sbin/mailstats
      -rwsr-xr-x   4 root     bin       204800 Feb  27  1995 /usr/sbin/sendmail

                 If you've used a different method to copy in the new
                 executables, ensure the correct owner, group, and
                 permissions using chown, chgrp and chmod.

              4. Restart sendmail with the following command:

                  % /usr/sbin/sendmail -bd -q15m -om

                 or, by rebooting the machine to ensure that any special
                 options get enabled.

        9 Notice to Cell Administrators

              Cell administrators who choose to delegate account
              administration (as one might do in large cells) should
              be aware of an undesirable facility in the R1.0.3 code
              base from OSF. Any principal empowered to create accounts
              can use aliasing to masquerade as cell_admin. In sub-
              cell administration, ACLs on registry subdirectories are
              used to partition the registry into domains that are the
              responsibility of separate administrators. The goal is to
              prevent minor administrators from impacting the central
              administration of the cell. With this situation, however,
              all registry administrators must be trusted, not just
              those who have root authorizations. This problem has only
              recently been discovered and, at the time of this writing,
              is being discussed among OSF and its sponsors.


                                                                       7
