IP-Commkit Release Notes
Contents
1. UNIX is a registered trademark in the United States and other countries licensed exclusively through X Open Company Ltd Solaris is a registered trademark of SUN Microsystems Inc 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 IP Commkit and not versions older than build 14 Nor will it affect removal of build 15 and other builds to be installed in the future During the small time interval when a network connection between the host and the UTM module in the BNS node transitions from the down to the up state a keep alive function was not being rescheduled properly occasionally If the node s controller does not receive several consecutive keep alive messages from the IP Commkit host the controller declares the host as dead and drops all connections to the host The only workaround is to reboot the host That is unacceptable The problem has been fixed 2 2 CHANGES FOR BUILD 16 2 2 1 CHANGES AFFECTING ALL OPERATING SYSTEM VERSIONS OF IP COMMKIT Q Anew software certificate and key are required for each build for any build higher than build 14 Software certificate verification and key authentication are changed in each new build to reflect the use of certificates starting with the two digit build number See the installation section below for changes in the installation process Upgrade maintenance builds are no longer free as of January 1 2003 However a new IP Commkit maintenance build is obt2. the driver can obtain a spin lock with non exclusive access and fail to surrender it Later when the driver attempts to acquire the same lock with exclusive access a deadlock will occur the host system will hang The problem was fixed by modifying the driver software so that it will always surrender the locks it obtains 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 A panic can occur in the dkip dkhs driver Under some conditions two processors can simultaneously execute code in a critical region of the driver software This results in corruption of a data structure in the driver software and a panic when the corrupted data is accessed The problem was fixed by protecting the critical region with spin locks A page fault panic can occur in the dkhs_open routine on a multiprocessor system The problem was fixed by protecting against multiple queues owning a single channel structure 2 4 CHANGES FOR BUILD 18 2 4 1 CHANGES AFFECTING ALL OPERATING SYSTEM VERSIONS OF IP COMMKIT Hcertan packets are lost or thrown away in the IP network some circuits may become stuck in a state where they cannot be closed For the problem to occur the network connection between the host and UTM must be subject to periodic disruptions either as the result of congestion or link failures Specifically the disruption must cause the IP Commkit host to lose three consecutive keep alive messages from the UTM and as a result
3. Skip this section if your host is already using build 12 or higher For HP UX Datatek returned to the original style of release numbering beginning in build 12 Specifically the file sets in these more recent builds have a version number of 1 0 16 1 0 17 1 0 18 1 0 19 or 1 0 20 respectively In builds 11 and earlier the build scripts set the version number to 11 When attempting to install one of these later builds with the swinstall command using the instructions in the documentation the analysis phase will fail since it appears that a version number of either 1 0 16 1 0 17 1 0 18 1 0 19 or 1 0 20 is older than version 11 To avoid this problem add the option x allow_downdate true to the swinstall command For example the command line in the installation instructions would be modified as follows swinstall s tmp ipcommkit x allow_downdate true IPCOMMKIT 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 4 6 INSTRUCTIONS FOR INSTALLING BUILD 16 17 18 19 20 OR 21 ON OPEN UNIX Hosts Please review the installation instructions in the IP Commkit Installation and Administration Guide for Open UNIX 8 Version 1 0 16 before installing the product 4 6 1 REMOVING PREVIOUS BUILDS If a previous build of IP Commkit for Open UNIX 8 was installed remove the spooled package from the spool directory using the command pkgrm s var sp
4. declare the network connection to the UTM lost In addition the host must lose the network connection regain it then lose it again shortly thereafter for the problem to occur Finally the host must have virtual circuits established at the time that the network connection is first lost The problem was fixed by modifying dkux so that calls in the WAIT_AHUP state are moved to the CLOSED state instead of the ENDING state when the network connection between the host and UTM is lost The dkhs driver may get stuck in an endless loop when a burst of UDP packets is dropped on a host UTM link IP Commkit uses several protocol layers on top of UDP to communicate with the UTM module and Datakit network The first layer above UDP protects against packets delivered out of order by intervening IP network To do this IP CommkKit uses a 16 bit sequence number and an algorithm that will put a packet received out of order back into the correct order The algorithm also needs to accommodate dropped packets and large jumps in sequence numbers that occur when the UTM or host is reset The bug occurs only when there is a skip in the received sequence numbers that occurs in a particular 32 number range of 64K sequence number space While this is rare the bug effectively stops data transport on all BNS Datakit circuits and eventually causes the host to hang completely requiring a reboot The problem was fixed by modifying the dkhs driver to properly handle sequen
5. dk lib pa20_64 directory The library usr lib pa20_64 libdk sl is linked to opt dk lib pa20_64 libdk sl The library ust ccs lib pa20_64 llib Idk In is linked to opt dk lib pa20_64 llib Idk In This enhancement is not available for HP UX 10 20 since HP UX 10 20 is used only ona 32 bit host CHANGES AFFECTING NCR MP RAS VERSIONS OF IP ComMKIT ONLY A bug in the dkty module can cause a panic in unrelated STREAMs modules and drivers Specifically the dkty module frees buffers containing messages of type M_CTL AIX is a registered trademark of IBM MP RAS is a registered trademark of NCR 02 04 05 Datatek Applications Inc 2 4 6 a IP COMMKIT Version 1 0 21 then proceeds to pass a pointer to the freed buffer downstream This often results in a panic in the downstream modules and drivers since the buffer they are accessing may have been re allocated and given to another module or driver The problem was fixed by modifying the dkty module so that it will not pass the pointer to the freed buffer down stream Spin locks are held through a call to qprocsoff in the MP RAS version of IP Commkit In at least one other operating version of IP Commkit it is a violation of the DKI to hold spin locks through a call to qprocsoff It s not clear that this is also a violation of the MP RAS DKI There have been no reports of deadlocks resulting from this issue from MP RAS IP Commkit users Nonetheless the change wa
6. files cannot be unique Therefore access the appropriate directory folder on the CD for the particular version of AIX or HP software you need Note that HP UX 11i is also Known as HP UX 11 11 For maintenance upgrade builds update tar files and new software certificate numbers will be emailed to you 4 4 INSTALLATION CHANGES AFFECTING AIX HOSTS A new procedure called installp was added in build 13 to facilitate the installation of IP Commkit for AIX systems beginning with this version See section 3 5 3 of the P Commkit Installation and Administration Guide for AIX for details As noted above an installation script change was made in build 14 but requires no administrator intervention or changes in his her procedures There are no installation changes specifically for AIX for build 16 and above except in build 20 and above regarding the location of the tar file on the CD ROM 4 5 SPECIAL INSTRUCTIONS FOR INSTALLING BUILD 16 17 18 19 20 OR 21 ON HP Hosts 4 5 1 REMOVING PREVIOUS IP COMMKIT RELEASES If a version of IP Commkit was previously installed and the directory tmp ipcommkit exists and is not empty remove the contents of tmp ipcommkit directory using the following commands after logging in as root cd tmp ipcommkit pwd verify that you are in the correct directory rm rf 4 5 2 UPGRADING FROM BUILD 11 OR EARLIER The following assumes that your current version of IP Commkit is build 11 or earlier
7. never freed In a rare condition the dkhs driver can allocate a streams buffer and fail to free it This condition occurs when a call to allocb succeeds but a call to dupb following it fails The buffer provided by allocb is not freed in this case However this condition suggests that the streams buffer pool is depleted so this bug is probably insignificant The bug was discovered during code review and has never been observed in test or use The problem was fixed by freeing the buffer provided by allocb when the dupb call fails A message is printed on the console erroneously A console message is printed when the host originates a call to an endpoint that will allow the host to use an URP transmit window of greater than 2 Kbytes This is not an error condition and a console message is inappropriate For example DKAP modules can allow callers to use a transmit window of up to 32 Kbytes However the caller may use a smaller window if desired The problem was solved by removing the code that prints the message CHANGES AFFECTING AIX VERSIONS OF IP COMMKIT ONLY None CHANGES AFFECTING HP UX VERSIONS OF IP COMMKIT ONLY HP UX 11 00 and 11i customers using 64 bit hosts may now run user programs linked to 64 bit versions of the IPCommkit libraries libdk a and libdk s when the 64bit library feature is purchased at additional cost The 64 bit version of the lint library llib Idk In is also available The libraries are delivered in the opt
8. output by AIX is 1 0 21 0 Below are shown the various versions available and the corresponding tar file name 3 1 IBM AIX Q AIX V4 3 32 bit kernel aix_4 3 ipckax tar Q AIX V5 2 82 bit kernel aix_5_2 ipckax32 tar 3 2 HP UX HP UX 10 20 32 bit kernel hp_10_20 ipckhp tar HP UX 11 0 32 bit kernel hp_11_00 ipckhp32 tar HP UX 11 0 64 bit kernel hp_11_00 ipckhp64 tar HP UX 11i 82 bit kernel hp_11i ipckhp32 tar 11i is also identified by HP as 11 11 HP UX 11i 64 bit kernel hp_11i ipckhp64 tar 111 is also identified by HP as 11 11 3 3 NCR SVR4 MP RAS Q NCR Multi processor ipckmprm tar Q NCR Single Uni processor ipckmpru tar 3 4 SCO OPEN UNIX 8 Q Open UNIX 8 ipckopu8 tar 3 5 SUN SOLARIS Solaris 2 6 32 bit kernel ipcksol6 tar Solaris 7 32 64 bit kernel ipcksol7 tar Solaris 8 32 64 bit kernel ipcksol8 tar Solaris 9 32 64 bit kernel ipcksol9 tar 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 4 INSTALLATION ADDENDUM 4 1 SOFTWARE KEYS AND REGISTRATION FOR ALL OPERATING SYSTEM VERSIONS Software registration keys were added beginning with Version 1 0 12 As part of the installation of the IP Commkit software the administrator must contact Datatek and obtain the software key in order to enable the software The administrator must provide his her email address phone number and nodename for the host machine The admini
9. Dote READ ME FIRST Commit RELEASE NOTES BUILDS 15 16 17 18 19 20 amp 21 VERSION 1 0 21 ISSUE 2 721 Route 202 206 Bridgewater NJ 08807 email sales datatekcorp com http www datatekcorp com IP COMMKIT Version 1 0 21 Table of Contents IMPORTANT 1 Introduction 2 Release Changes 2 1 Changes for Build 15 2 1 1 Changes Affecting All Operating System Versions of IP CommkKit 2 1 2 Changes Affecting HP UX Versions of IP CommkKit Only 2 1 3 Changes Affecting Open UNIX 8 Versions of IP CommkKit Only 2 1 4 Changes Affecting Solaris Versions of IP CommkKit Only 2 2 Changes for Build 16 2 2 1 Changes Affecting All Operating System Versions of IP CommkKit 2 3 Changes for Build 17 2 3 1 Changes Affecting All Operating System Versions of IP CommkKit 2 3 2 Changes Affecting HP UX Versions of IP CommKit Only 2 3 3 Changes Affecting Open UNIX 8 Versions of IP CommkKit Only 2 4 Changes for Build 18 2 4 1 Changes Affecting All Operating System Versions of IP CommkKit 2 4 2 Changes Affecting AIX versions of IP CommkKit Only Changes Affecting HP UX Versions of IP CommkKit Only Changes Affecting NCR MP RAS versions of IP CommkKit Only Changes Affecting Open UNIX 8 Versions of IP CommkKit Only Changes Affecting Solaris Versions of IP CommkKit Only Changes for Build 19 Changes Affecting All Operating System Versions of IP CommkKit Changes Affecting AIX versions of IP CommKit Only Changes Affecting HP UX Versions of IP Co
10. ainable free of charge for a particular host if one of the following is true 1 The copy running on the host is still under the original 90 day warranty 2 The current host copy is covered by an extended service warranty 3 The current host copy is covered by a company wide remote technical support contract that covers IP Commkit and this host 4 A special contractual arrangement exists with Datatek Applications Inc If one of the criteria above is met for a particular host contact Datatek to receive the upgrade software and the associated new software certificate and key The existing software certificate and host uname n must be supplied Contact Datatek via email at ipcommkit datatekcorp com If none of the above criteria is applicable for an existing host an upgrade build may be purchased by contacting your Datatek product reseller 2 3 CHANGES FOR BUILD 17 2 3 1 CHANGES AFFECTING ALL OPERATING SYSTEM VERSIONS OF IP COMMKIT Q A double fault exception panic can occur while a driver dkx is in the sleep state and an interrupting signal is received The driver has been changed to handle the interrupt CHANGES AFFECTING HP UX VERSIONS OF IP COMMKIT ONLY Page fault panics can occur in the dkux module when the callback function calls streams_put with a null queue pointer This problem has been fixed CHANGES AFFECTING OPEN UNIX 8 VERSIONS OF IP COMMKIT ONLY A deadlock can occur in the dkip dkhs driver Under some conditions
11. any upgrades this LICENSE and if applicable the Certificate s of Authenticity and the recipient agrees to the terms of this LICENSE If the SOFTWARE is an upgrade any transfer must also include all prior versions of the SOFTWARE Without prejudice to any other rights Manufacturer may terminate this LICENSE if you fail to comply with the terms and conditions of this LICENSE In such event you must destroy all copies of the SOFTWARE and all of its component parts 6 2 INTELLECTUAL PROPERTY RIGHTS The SOFTWARE is licensed not sold to you The SOFTWARE is protected by copyright laws and international copyright treaties as well as other intellectual property laws and treaties You may not copy the printed materials accompanying the SOFTWARE All title and intellectual property rights in and to the content which may be accessed through use of the SOFTWARE is the property of the respective content owner and may be protected by applicable copyright or other intellectual property laws and treaties This LICENSE grants you no rights to use such content All rights not expressly granted under this LICENSE are reserved Manufacturer and its licensors if any 6 3 SOFTWARE SUPPORT SOFTWARE support is provided by Manufacturer or its affiliates or subsidiaries separate from the host computer on which it may be installed SOFTWARE support is limited to the warranty period stated below unless either a separate maintenance contract has been consummated be
12. ce number skips throughout the entire sequence number range The dkhs driver can get stuck in an endless loop when UDP driver is unlinked during data transport When IP Commkit is shut down using dkitre stop the stream connecting the dkhs driver is unlinked from the UDP IP driver If this occurs when the dkhs driver is in the process of transmitting data the driver can get stuck in an endless loop This eventually causes the host to hang requiring a reboot 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 The problem was fixed by modifying the dkhs driver to discard any data it is holding when the UDP IP driver is unlinked The dkstat command and dkhs driver have been enhanced to provide a measurement of UDP packet loss The dkstat command and dkhs drivers were modified to provide a measurement of the number of UDP packets received whose sequence number is not the next expected number Jumps in the sequence number indicate that packets have been lost or the UTM module has been reset In addition counts for total UDP packets transmitted and received and packets dropped due to buffer congestion were added Finally obsolete interface statistics left over from the fiber interface hardware were deleted An incorrect value for a process Identifier PID was shown in a report This was fixed by changing the C language data type in which the information was stored Streams buffers can be allocated and
13. ed from the Datatek web site for specific details CHANGES AFFECTING HP UX VERSIONS OF IP COMMKIT ONLY When IP Commkit is started the number of CPU s in the host machine is determined The result is compared with the number used to generate the key for the IP Commkit license for that host If the number of CPUs is greater than the number allowed by the license then the IP Commkit software will not start A message is put in the dkipd log file Number of CPU s supported is too small Otherwise the message Number of CPUs supported is OK is inserted in the log file This feature is added in this release for the HP UX and Solaris operating systems This feature will be added for other operating systems in future releases 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 CHANGES AFFECTING NCR MP RAS VERSIONS OF IP COMMKIT ONLY None CHANGES AFFECTING OPEN UNIX 8 VERSIONS OF IP COMMKIT ONLY None CHANGES AFFECTING SOLARIS VERSIONS OF IP COMMKIT ONLY As described above for HP UX operating systems the actual number of CPUs present on the host versus the number allowed by the IP Commkit license is compared If the number of CPUs is greater than the number allowed by the license then the IP Commkit software will not start A message is put in the dkipd log file Number of CPU s supported is too small Otherwise the message Number of CPUs supported is OK is inserted in the log file In a single UTM configu
14. ersions of the 64 bit kernel STREAMS drivers were included in the build 18 software package Specifically the build 17 versions of these drivers were supplied As a result kernel driver bug fixes addressed in build 18 are not present in the software package The software package was rebuilt to include the correct versions of the drivers Support is added in this release for Solaris 9 operating systems Installation uses the same procedures as Solaris 8 Hence there is no change in the user manual 2 6 CHANGES FOR BUILD 20 2 6 1 m CHANGES AFFECTING ALL OPERATING SYSTEM VERSIONS OF IP COMMKIT There are no changes that affect all operating system versions of IP Commkit However see the change made for the HP UX and Solaris systems regarding CPU count that eventually will be implemented in a future release for all other operating systems CHANGES AFFECTING AIX VERSIONS OF IP COMMKIT ONLY Customers having hosts running the AIX 5 2 operating system now can install a compatible version of IP Commkit that is IP CommkKit for AIX 5 2 The same IP Commkit features that are supported in the AIX 4 3 version are supported in the AIX 5 2 version Hence users can upgrade to newer host hardware and operating systems and continue to use their existing applications Installation of IP Commkit for AIX 5 2 uses similar procedures as AIX 4 3 Refer to the IP Commkit Installation and Administration Guide for AIX for Version 1 0 20 which can be download
15. g the command pkgrm ipcommkit 5 DOCUMENTATION Refer to the CommkKit documentation on the Datatek web site www datatekcorp com There are three different sets Q The original traditional CommKit documentation that can be accessed via the BNS amp Datakit link Q The IP Commkit Installation and Administration Guide for each type of IP Commkit Each guide modifies or supersedes portions of the traditional documentation Click on the following link http Awww datatekcorp com support support_soft_firm updates bim and select the appropriate documentation to download The version of the documentation that corresponds to this release is 1 0 16 for Open UNIX 8 systems 1 0 17 for NCR and 1 0 20 for AIX HP and SUN There were no documentation changes for build 21 A separate document called P Commkit Enhanced Security Guide provides detailed administration information for enhanced security feature 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 6 END USER LICENSE AGREEMENT FOR SOFTWARE This License Agreement License is a legal contract between you and the manufacturer Manufacturer of the software product s you acquired identified as SOFTWARE The SOFTWARE may include printed materials that accompany the SOFTWARE Any software provided along with the SOFTWARE that is associated with a separate end user license agreement is licensed to you under the terms of that license agreement By i
16. hnologies Inc licensed to Datatek Applications Inc a company independent of Lucent Technologies Inc 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 2 RELEASE CHANGES 2 1 2 1 1 a CHANGES FOR BUILD 15 CHANGES AFFECTING ALL OPERATING SYSTEM VERSIONS OF IP COMMKIT A duplicate character was sent when IP Commkit was unable to finish putting a message on the output queue The pointer to the last character in the message segment that was put on the queue was not advanced to point at the next character This resulted in the transmission of same character a poorly formed URP block a retransmission and degraded performance This problem was fixed A panic occurred on an HP 64 bit multiprocessor system during a remote execution operation dk command This situation occurred when an inbound queue was closed and a race condition existed The fix was to check that the pointer to the queue was not null i e queue closed before attempting to write the message to the queue This problem could have happened for all operating system versions of IP Commkit not just HP UX CHANGES AFFECTING HP UX VERSIONS OF IP COMMKIT ONLY A system panic occurred because a portion of the code in the dkhs driver did not protect data access by more than one processor simultaneously in a multiprocessor system This code is now safe for multiprocessor systems CHANGES AFFECTING OPEN UNIX 8 VERSIONS OF IP COMMKIT ONLY Mul
17. mmkKit Only Changes Affecting NCR MP RAS versions of IP CommkKit Only Changes Affecting Open UNIX 8 Versions of IP CommKit Only Changes Affecting Solaris Versions of IP CommkKit Only Changes for Build 20 Changes Affecting All Operating System Versions of IP CommkKit Changes Affecting AIX versions of IP CommkKit Only Changes Affecting HP UX Versions of IP CommkKit Only Changes Affecting NCR MP RAS versions of IP CommkKit Only Changes Affecting Open UNIX 8 Versions of IP CommKit Only Changes Affecting Solaris Versions of IP CommkKit Only Changes for Build 21 Changes Affecting All Operating System Versions of IP CommkKit Changes Affecting AIX versions of IP CommkKit Only Changes Affecting HP UX Versions of IP CommkKit Only Changes Affecting NCR MP RAS versions of IP CommkKit Only Changes Affecting Open UNIX 8 Versions of IP CommKit Only Changes Affecting Solaris Versions of IP CommkKit Only 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 3 4 SCO Open UNIX 8 3 5 SUN Solaris 4 Installation Addendum Software Keys and Registration For All Operating System Versions Obtaining Maintenance Releases Release Media Installation Changes Affecting AIX Hosts Special Instructions For Installing Build 16 17 18 19 20 or 21 on HP 4 5 1 Removing Previous IP CommkKit Releases 4 5 2 Upgrading from Build 11 or Earlier 4 6 Instructions For Installing Build 16 17 18 19 20 or 21 on Open Unix 4 6 1 Removing Previous Builds 4 6 2 I
18. nstalling copying downloading accessing or otherwise using the SOFTWARE you agree to be bound by the terms of this LICENSE If you do not agree to the terms of this LICENSE Manufacturer is unwilling to license the SOFTWARE to you In such event you may not use or copy the SOFTWARE and you should promptly contact Manufacturer for instructions on return of the unused product s for a refund 6 1 SOFTWARE LICENSE You may only install and use one copy of the SOFTWARE on one host computer unless otherwise licensed by Manufacturer The SOFTWARE may not be installed accessed displayed run shared or used concurrently on or from different computers including a workstation terminal or other digital electronic device Devices Notwithstanding the foregoing and except as otherwise provided below any number of Devices may access or otherwise utilize the services of the SOFTWARE You may not reverse engineer decompile or disassemble the SOFTWARE except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation The SOFTWARE is licensed as a single product Its component parts may not be separated for use on more than one host computer You may not rent lease or lend the SOFTWARE in any manner You may permanently transfer all of your rights under this LICENSE provided you retain no copies you transfer all of the SOFTWARE including all component parts the media and printed materials
19. nstalling Build 18 19 20 or 21 4 7 Instructions For Deinstalling Build 14 and Installing this Build on Solaris 5 Documentation 6 End User License Agreement for Software Software License Intellectual property Rights Software Support Export Restrictions Limited Warranty No Other Warranties Special Provisions Limitation of Liability 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 IMPORTANT The Datatek Applications Web Site and Contact Information is Documentation http www datatekcorp com Sales sales datatekcorp com IP CommkKit Support ipcommkit datatekcorp com Please review Section 4 the Installation Addendum section for the particular host type before attempting to remove a previous version of IP CommkKit or to install a new version Procedures have changed These changes are also reflected in the IP CommkKit User Manual for your operating system type IP Commkit is a trademark of Lucent Technologies Inc licensed to Datatek Applications Inc a company independent of Lucent Technologies Inc 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 1 INTRODUCTION These release notes highlight the new application features modifications known caveats and any special considerations for the IP CommKit Software package Installation and administration documentation is located on the web site listed above IP Commkit allows any computer
20. occur in the raw dkhs driver during a STREAMS close operation These operations typically occur when a virtual circuit is disconnected or when IP Commkit is shutdown The problem occurs when a timer callback routine runs concurrently with the close routine Access to a shared data structure is not properly serialized with the result that a NULL pointer is passed to an operating system routine This causes a kernel page fault and panic The code was modified to ensure that access to the shared data structure is properly controlled 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 CHANGES AFFECTING NCR MP RAS VERSIONS OF IP COMMKIT ONLY None CHANGES AFFECTING OPEN UNIX 8 VERSIONS OF IP COMMKIT ONLY A panic can occur in the remote execution dkx and TLI dktm drivers during a STREAMS unlink operation These operations typically occur when a virtual circuit is disconnected or when IP Commkit is shutdown The problem is caused by an idiosyncrasy of Open UNIX 8 and is not an issue for other IP Commkit versions The driver software was modified to work around the problem The dkserver process makes library calls to update both utmp wtmp and utmpx wtmpx This is unnecessary and wastes operating system resources The code was modified to use only the calls for updating utmpx wtmpx CHANGES AFFECTING SOLARIS VERSIONS OF IP COMMKIT ONLY This affects only the 64 bit kernel versions of Solaris 7 and 8 only Incorrect v
21. ool pkg ipcommkit Remove the package using the commands pkgrm ipcommkit shutdown y g0 i6 It is very important that the shutdown step is done 4 6 2 INSTALLING BUILD 18 19 20 OR 21 When performing the untarring of the tar files use the following command tar xfo tmp ipckopu8 tar Previously the o option was not used Use this parameter to cause the extracted files to take on the user and group identifier of the user running the program rather than those on the installation CD 4 7 INSTRUCTIONS FOR DEINSTALLING BUILD 14 AND INSTALLING THIS BUILD ON SOLARIS HOSTS There is a problem in an installation script for IP Commkit build 14 that causes the pkgrm command to leave build 14 partially installed and a subsequent pkgadd command for builds 16 and higher to fail Special procedures are required to work around this problem BEFORE removing IP Commkit build 14 1 Remove the spooled build 14 software using pkgrm s var spool pkg ipcommkit 2 Determine whether the special procedures are required log in as root cd var sadm pkg ipcommkit install read the postremove script if line 16 does not terminate with then special procedures are required 3 If special procedures are required retrieve the updated postremove file cd var sadm pkg 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 tar xf cdrom cdrom0 ipcksol8 tar ipcommkit install postremove 4 Remove IP Commkit build 14 usin
22. ration when a customer application established a call and then dropped it a subsequent call would fail unless a delay was imposed between the calls The problem was caused when the dkhs driver assigned a channel to an outgoing call but did not verify whether messages were being exchanged with the BNS Datakit node to close that channel for a previous call A messages interface between the dkhs driver and the dkux module has been implemented to prevent that failure 2 7 CHANGES FOR BUILD 21 2 7 1 m N N N DO Oo DA DO or CHANGES AFFECTING ALL OPERATING SYSTEM VERSIONS OF IP COMMKIT The I option did not work for the dkipd program This option allows one to specify an alternate location for the log files LMOS uses this option to use a non standard location for the dkipdlog file Users that use the standard default configuration are not affected Using this option is not recommended as it adds complexity to the troubleshooting process CHANGES AFFECTING AIX VERSIONS OF IP COMMKIT ONLY None CHANGES AFFECTING HP UX VERSIONS OF IP COMMKIT ONLY None CHANGES AFFECTING NCR MP RAS VERSIONS OF IP COMMKIT ONLY None CHANGES AFFECTING OPEN UNIX 8 VERSIONS OF IP COMMKIT ONLY None CHANGES AFFECTING SOLARIS VERSIONS OF IP COMMKIT ONLY None 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 3 RELEASE VERSIONS This release is collectively known as Build 21 or Version 1 0 21 Note that the version number
23. s also included in the MP RAS version to eliminate the possibility that it will cause a problem CHANGES AFFECTING OPEN UNIX 8 VERSIONS OF IP COMMKIT ONLY A kernel panic occurred when the dkip daemon dkipd exited and closed a stream It sent an _UNLINK message to the dkhs driver The driver received data associated with an unexpected queue A structure not associated with the stream was erroneously accessed and the driver caused a kernel panic To fix this problem code was added to verify that only the driver s private data structures are being accessed A deadlock occurred when transmit data was being drained due to a close of the dkhs driver A lock was released while holding a lower level lock The deadlock occurred when another thread ran in the same context and tried to acquire the lower level lock The problem was fixed by releasing the lock at a priority level that does not allow another thread to run A panic occurred when two processors tried to access the same data in the kernel at the same time The problem was fixed by making the kernel code single threaded There is little to no performance degradation CHANGES AFFECTING SOLARIS VERSIONS OF IP COMMKIT ONLY None 2 5 CHANGES FOR BUILD 19 2 5 2 5 2 a 3 a 1 LI CHANGES AFFECTING ALL OPERATING SYSTEM VERSIONS OF IP COMMKIT None CHANGES AFFECTING AIX VERSIONS OF IP COMMKIT ONLY None CHANGES AFFECTING HP UX VERSIONS OF IP COMMKIT ONLY A panic can
24. strator must also provide the software certificate number that was received with the software Each copy of the software has its own unique software certificate number that will be needed when a key is required In the past subsequent builds i e maintenance builds may have used the same software certificate and key for the same host machine However starting with build 15 each new build now requires its own software certificate and key Hence dkregister will have to be run each time a new build is installed using the new software certificate and key values Otherwise the software will not function Generally the registration step is performed immediately after the install step using the particular operating system s procedure like pkgadd swinstall or installp Refer to the P Commkit Installation and Administration Guide for your operating system for specific details Keep the new software certificate number in a safe place It is the proof of purchase POP If the software certificate is lost a new copy of the software may need to be purchased 4 2 OBTAINING MAINTENANCE RELEASES A new IP CommkKit maintenance build is obtainable free of charge for a particular host if one of the following is true 1 The copy running on the host is still under the original 90 day warranty The current host copy is covered by a service support agreement SSA The current host copy is covered by a company wide remote technical support contract tha
25. t covers IP Commkit and this host 4 A special contractual arrangement exists with Datatek Applications Inc If one of the criteria above is met for a particular host contact Datatek to receive the upgrade software and the associated new software certificate and key The existing software certificate and host uname n must be supplied Contact Datatek via email at ipcommkit datatekcorp com If none of the above criteria is applicable for an existing host an upgrade build may be purchased by contacting your Datatek product reseller 4 3 RELEASE MEDIA The software for all versions of IP Commkit that is for different operating system versions is now being released on a single CD ROM when IP Commkit is initially purchased Your software certificate Proof Of Purchase and software key apply only to the specific version of the software 1 Note that the nodename of the host may be different than the system name The system name is printed as response to the command uname with no flags For the software key the nodename is wanted which may be the same as the system name The nodename is printed in response to the command 5 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 that was purchased So copy the appropriate tar file to your target host machine Retain the CD as a backup along with the software certificate and software key Because of naming restrictions of UNIX 8 character names for HP and AIX
26. te jurisdiction to state jurisdiction 6 7 SPECIAL PROVISIONS The SOFTWARE and documentation are provided with RESTRICTED RIGHTS Use duplication or disclosure by the United States Government is subject to restrictions as set forth in subparagraph c 1 ii of the Rights in Technical Data and Software clause at DFARS 252 227 7013 or subparagraphs c 1 and 2 of the Commercial Software Restricted Rights at 48 CFR 52 227 19 as applicable Manufacturer is Datatek Applications Inc 721 Rte 202 206 Bridgewater New Jersey 08807 If you acquired the SOFTWARE in the United States of America this Software License are governed by the laws of the State of New Jersey excluding its choice of laws provisions If you acquired the SOFTWARE outside the United States of America local law may apply This LICENSE constitutes the entire understanding and agreement between you and the Manufacturer 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 in relation to the SOFTWARE and supercedes any and all prior or other communications statements documents agreements or other information between the parties with respect to the subject matter hereof 6 8 LIMITATION OF LIABILITY To the maximum extent permitted by applicable law in no event shall Manufacturer or its suppliers be liable for any damages whatsoever including without limitation special incidental consequential or indirect damages for personal injury loss of b
27. tiple warning messages during the installation step using the tar command occurred The messages were cannot get group information These messages unnecessarily and needlessly alarmed the installer Instead of the command tar xf the command to be used now is tar xfo The o flag causes the extracted tar files to take on the user and group identifier of the user running the tar program rather than the identifiers used on the CD from which the files are being extracted The instructions have been changed accordingly in the user manual CHANGES AFFECTING SOLARIS VERSIONS OF IP COMMKIT ONLY In Solaris 7 and 8 systems when IP Commkit was installed on a new host the very first time the installation procedures in the dkcust file did not work properly An interim build was sent to affected users and a permanent change incorporated in this release A problem exists in an installation script for early releases of IP Commkit build 14 that causes the pkgrm command to leave build 14 partially installed and the subsequent pkgadd command for build 15 to fail Special procedures are required to verify that your currently installed system has the problem and to workaround the problem BEFORE an attempt is made to remove build 14 of IP Commkit See the Installation Addendum section 4 6 below for more details This problem affects only the removal of build 14 of HP UX is a registered trademark of Hewlett Packard Inc Systems Division
28. tten materials for a period of ninety 90 days from the date of shipment Software support is limited to the hours of 9 AM to 5 PM ET Monday through Friday excluding Datatek observed holidays Other coverage and extended warranty may be purchased at additional cost Any implied warranties on the SOFTWARE are limited to ninety 90 days Some states jurisdictions do not allow limitations on duration of an implied warranty so the above limitation may not apply to you Manufacturer s and its suppliers entire liability and your exclusive remedy shall be at Manufacturer s option either a return of the price paid or b repair or replacement of the SOFTWARE that does not meet this Limited Warranty and which is returned to Manufacturer with a copy of your receipt This Limited Warranty is void if failure of the SOFTWARE has resulted from accident abuse or misapplication Any replacement SOFTWARE will be warranted for the remainder of the original warranty period or thirty 80 days whichever is longer 6 6 No OTHER WARRANTIES To the maximum extent permitted by applicable law manufacturer and its suppliers disclaim all other warranties either express or implied including but not limited to implied warranties of merchantability fitness for a particular purpose and non infringement with regard to the software and the accompanying written materials This limited warranty gives you specific legal rights You may have others which vary from sta
29. tween you and the manufacturer or the manufacturer has agreed in writing at the time of purchase by you of the software to an extension of the warranty Should you have any questions 02 04 05 Datatek Applications Inc IP COMMKIT Version 1 0 21 concerning this LICENSE or if you desire to contact Manufacturer for any other reason please refer to the address provided in the documentation for the SOFTWARE 6 4 EXPORT RESTRICTIONS You agree that you will not export or re export the SOFTWARE to any country person or entity subject to U S export restrictions You specifically agree not to export or re export the SOFTWARE i to any country to which the U S has embargoed or restricted the export of goods or services which as of March 1998 include but are not necessarily limited to Cuba Iran Iraq Libya North Korea Sudan and Syria or to any national of any such country wherever located who intends to transmit or transport the products back to such country ii to any person or entity who you know or have reason to know will utilize the SOFTWARE or portion thereof in the design development or production of nuclear chemical or biological weapons or iii to any person or entity who has been prohibited from participating in U S export transactions by any federal agency of the U S government 6 5 LIMITED WARRANTY Manufacturer warrants that a the SOFTWARE will perform substantially in accordance with the accompanying wri
30. usiness profits business interruption loss of business information or any other pecuniary loss arising out of the use of or inability to use this product even if Manufacturer has been advised of the possibility of such damages In any case Manufacturer s and its suppliers entire liability under any provision of this License shall be limited to the amount actually paid by you for the SOFTWARE Because some states jurisdictions do not allow the exclusion or limitation of liability for consequential or incidental damages the above limitation may not apply to you Copyright 2001 2005 Datatek Applications Inc All Rights Reserved Printed in USA 02 04 05 Datatek Applications Inc
31. with a 10Base T LAN interface to serve as a Commkit connected host in a BNS 2000 and BNS 2000 VCS a k a Datakit Il VCS network Your application software can be migrated without recompilation IP Commkit gives you access to the latest host technology protecting your investment in CO LAN and the Lucent Technologies BNS 2000 Family of Products IP Commkit simplifies your host to network connection with standard interfaces and flexible configuration options reducing the cost of operations and maintenance What is IP CommkKit IP Commkit is a new twist on the Commkit Host Interface for BNS 2000 and BNS 2000 VCS Where the Commkit Host Interface uses a fiber optic cable to connect the host computer to the BNS node IP Commkit uses a 10Base T LAN Instead of a specially developed and expensive fiber interface card in the host computer I P CommkKit uses the host s standard LAN interface card In the BNS node IP Commkit replaces the CPM Module with a UTM module All these changes are invisible to the host applications and the BNS network Your host applications and Commkit features behave identically You don t even need to recompile Host and Node Interfaces ek Commkit Host Interface BEFORE E DECH FIBER OPTIC CABLE F CPM H H LIMITED DISTANCE HS Eo VCS SEPARATION IP CommKit Host Interface e 70 100Basel 10 100Base a q 7 BNS 2000 H or BNS 2000 vcs Datakit is a registered trademark of Lucent Tec
Download Pdf Manuals
Related Search