PJ40871: UPGRADE OPENLDAP TO NEWER MAINTENANCE LEVEL

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • See problem summary.
    

Local fix

  • na
    

Problem summary

  • APAR NUMBER:  PJ40871
    PRODUCT:  z/TPF
    FUNCTIONAL AREA:  Open LDAP Support
    SHIPPED IN PUT:  10
    
    ABSTRACT:
    zTPF OpenLDAP support for OpenLDAP 2.4.35 with Berkeley
    Database (BDB) 5.3.21.
    
    PACKAGE CONTENTS:
    Source Segments:
    (C) base/cntl/tpf_bdb.cntl
    (C) base/cntl/tpf_ldap.cntl
    (C) base/include/tpf/c_proc.h
    (C) base/include/tpf/i_netd.h
    (C) base/macro/iproc.mac
    (C) base/openldap/cats.mak
    (C) base/openldap/ccmp.mak
    (N) base/openldap/cdac.mak
    (C) base/openldap/cdbr.mak
    (C) base/openldap/cdel.mak
    (C) base/openldap/clap.mak
    (C) base/openldap/cllb.mak
    (C) base/openldap/cmdr.mak
    (C) base/openldap/cmod.mak
    (C) base/openldap/cpas.mak
    (C) base/openldap/cser.mak
    (C) base/openldap/cwai.mak
    (N) base/openldap/headers/ac/socket.h
    (N) base/openldap/headers/ac/syslog.h
    (N) base/openldap/headers/ac/time.h
    (C) base/openldap/headers/db_config.h
    (C) base/openldap/headers/lber.h
    (C) base/openldap/headers/ldap.h
    (N) base/openldap/headers/ldap_log.h
    (N) base/openldap/headers/lutil.h
    (N) base/openldap/headers/portable.h
    (C) base/openldap/ldap_etoa.c
    (N) base/openldap/ldap_tpf.c
    (N) base/openldap/ztpf_files/usr/bin/db_archive
    (C) base/rt/cinet5.c
    (C) base/rt/cinet7.c
    (N) base/rt/crt0_bdb.c
    (C) base/rt/crt0_ldap.c
    (C) base/rt/crt0_ldap_client.c
    (C) base/rt/tpflinkobjs.mak
    (C) tpftools/include_ztpf/maketpf.env_cats
    (C) tpftools/include_ztpf/maketpf.env_ldap
    (C) tpftools/include_ztpf/maketpf.env_ldap_client
    
    Object Only Binaries:
    None.
    
    Configuration Independent Binaries:
    (C) base/lib/libCLTY.so
    (C) base/lib/libtpflinkobjs.a
    (C) base/load/CLTY.so
    (C) base/load/CLTZ.so
    (C) base/obj/cinet5.o
    (C) base/obj/cinet7.o
    (N) base/obj/crt0_bdb.o
    (C) base/obj/crt0_ldap.o
    (C) base/obj/crt0_ldap_client.o
    
    Support Files:
    base/lst/cinet5.lst
    base/lst/cinet7.lst
    base/lst/crt0_bdb.lst
    base/lst/crt0_ldap.lst
    base/lst/crt0_ldap_client.lst
    base/lst/CLTY.map
    base/lst/CLTZ.map
    
    OTHER BINARIES TO BUILD: YES
    (N) opensource/ldap/output/obj/ldap_tpf.o
    (C) <sys>/load/IPAT.so
    (C) opensource/lib/libCATS.so
    (C) opensource/lib/libCLLB.so
    (C) opensource/load/CATS.so
    (C) opensource/load/CCMP.so
    (N) opensource/load/CDAC.so
    (C) opensource/load/CDBR.so
    (C) opensource/load/CDEL.so
    (C) opensource/load/CLAP.so
    (C) opensource/load/CLLB.so
    (C) opensource/load/CMDR.so
    (C) opensource/load/CMOD.so
    (C) opensource/load/CPAS.so
    (C) opensource/load/CSER.so
    (C) opensource/load/CWAI.so
    (N) opensource/ldap/output/obj/force_build.o
    (C) opensource/bdb/output/obj/db_recover.o
    (C) <sys>/obj/ipat.o
    
    COMMENTS:
    This project upgrades zTPF to use OpenLDAP 2.4.35 and Berkeley
    Database 5.3.21. The following items were addressed:
    1) Multiple master support - previous OpenLDAP version 2.4.6
    contained numerous bugs.
    2) There were no Data Collection/Data Reduction counters
    specifically to support OpenLDAP messages.
    3) No mechanism existed on zTPF to ensure that a server remains
    active in a multiple server environment if zTPF automatically
    recycled a server.
    4) zTPF support for OpenLDAP did not take advantage of relative
    path names in .mak files, forcing segment names to be renamed
    to be unique.
    5) Berkeley Database db_archive utility was not supported on
    zTPF.
    6) Numerous code modifications in the ported code made it
    difficult to migrate to newer versions of OpenLDAP and BDB.
    

Problem conclusion

  • SOLUTION:
    zTPF OpenLDAP support has been updated to support OpenLDAP
    2.4.35 and Berkeley Database 5.3.21. The following additional
    items are now supported:
    1) With the latest version of OpenLDAP, a more reliable
    multiple master support is now supported.
    2) Data Collection/Data Reduction counters have been added to
    support OpenLDAP messages. The TCP/IP network services database
    file (/etc/services) needs to be updated with an entry for
    OpenLDAP and any associated port being used (typically 389).
    Please see zTPF TCP/IP network services database support
    documentation for more information about how to use this file.
    3) When OpenLDAP servers are automatically recycled by zTPF,
    for example when ZOLDR support activates a new program used by
    OpenLDAP, zTPF will automatically serialize recycling of zTPF
    OpenLDAP servers to ensure that a server remains active in a
    multiple server environment.
    4) OpenLDAP .mak files have been updated to use relative path
    names.
    5) The Berkeley Database db_archive utility has been added to
    allow better management of Berkeley Database log files.
    6) zTPF modifications have been removed from the ported code to
    not tie zTPF support to a specific version.
    Important note: Co-requisites for this APAR are OpenLDAP 2.4.35
    and Berkeley Database 5.3.21 which will need to be downloaded
    directly from www.openldap.org and www.oracle.com websites,
    respectively. This APAR is not compatible with the previous
    versions of OpenLDAP and Berkeley Database supported on zTPF
    and downloaded from the zTPF web page. Please see zTPF Support
    for OpenLDAP User's Guide for more information about installing
    these products. These new versions will work with any previous
    OpenLDAP database that was created with the previous versions.
    
    COREQS: YES
    1) OpenLDAP 2.4.35 and Berkeley Database 5.3.21. 2) PJ41135 3)
    PJ41130 4) PJ41321
    
    MIGRATION CONSIDERATIONS: YES
    Application programming interface (API) changes:
    ZFILE db_archive
    Hardware, software, and configuration changes:
    As noted in the Solution section of this APEDIT, new versions
    of OpenLDAP and Berkeley Database need to be downloaded and
    built for zTPF.
    Communications changes:
    As mentioned in the Solution section above, file /etc/services
    needs to be updated for OpenLDAP in order for Data
    Collection/Date Reduction to count OpenLDAP messages.
    Build and load process changes:
    Please see zTPF Support for OpenLDAP User's Guide for
    information about installing and building OpenLDAP and Berkeley
    Database on zTPF.
    Installation validation:
    Starting an OpenLDAP server with a debug level of 256 will send
    debug messages to the console.  A version is included in the
    debug messages that can be used to verify the correct version
    is loaded on zTPF.  For example, define the OpenLDAP server
    using the following command and then start it:
    ZINET ADD S-ldap PGM-Clap MODEL-DAEMON USER-root act-oper
    XPARM--f /test/slapd.conf -d 256
    A debug level of 256 would typically be used to debug a
    problem.
    
    BUILD COMMANDS AND INSTRUCTIONS: YES
    #maketpf commands for linux
    maketpf -f tpflinkobjs crt0_bdb.o crt0_ldap.o crt0_ldap_client.o
    maketpf tpflinkobjs link
    maketpf -f CLTY cinet5.o
    maketpf -f CLTZ cinet7.o
    maketpf -f IPAT
    maketpf CLTY link TPF_VERIFY_LINK_REFS=NO
    maketpf CLTZ link
    maketpf -f CATS
    maketpf -f CDBR
    maketpf -f CDAC
    maketpf -f CLLB
    maketpf -f CLAP
    maketpf -f CWAI
    maketpf -f CSER
    maketpf -f CPAS
    maketpf -f CMDR
    maketpf -f CMOD
    maketpf -f CDEL
    maketpf -f CCMP
    maketpf CLTY link
    
    ipat tpfstub
    
    UPDATED INFORMATION UNITS: YES
    z/TPF and z/TPFDF Migration Guide: PUT 2 and Later
    z/TPF and z/TPFDF System Installation and Support Reference
    z/TPF Operations
    z/TPF Support for OpenLDAP User's Guide
    z/TPF System Performance and Measurement Reference
    
    See your IBM representative if you need additional information.
    
    DOWNLOAD INSTRUCTIONS:
    http://www.ibm.com/software/htp/tpf/maint/maintztpf.html
    
    APAR URL:
    http://www.ibm.com/software/htp/tpf/ztpfmaint/put10/PJ40871.htm
    

Temporary fix

Comments

APAR Information

  • APAR number

    PJ40871

  • Reported component name

    Z/TPF

  • Reported component ID

    5748T1501

  • Reported release

    110

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-02-27

  • Closed date

    2013-08-22

  • Last modified date

    2013-08-23

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Publications Referenced
SK2T8062        

Fix information

  • Fixed component name

    Z/TPF

  • Fixed component ID

    5748T1501

Applicable component levels

  • R110 PSY

       UP



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

TPF
z/TPF

Software version:

110

Reference #:

PJ40871

Modified date:

2013-08-23

Translate my page

Machine Translation

Content navigation