******************************************************************************* * * PRIMARY DISCLAIMER: * * It is not recommended that you install this fix unless specifically * instructed to do so by a qualified IBM Technical Support representative. * * Please call your appropriate support location for more information. * For instance, in the United States, you would call 1-800-CALL-AIX. * ******************************************************************************* * * * * VISIT OUR PAGES ON THE INTERNET * _______________________________ * * IBM Communications Server Support * http://www.ibm.com/software/network/commserver/support * * * +--------------------------------------------------------------------------+ * * DATE: 11/13/2003 * * DESCRIPTION: * ____________ * * README FILE FOR * * IBM Communications Server for AIX temporary fix ("fix") * * (Installs only on PTF level 6.1.0.4) * APAR: IY50234 * * This package contains APAR fixes to the product above. This * package can be distributed to any one who has a license for * this product. * *+----------------------------------------------------------------------------+ * * * PREREQUISITES : * _______________ * * IBM Communications Server for AIX, Version 6.1 * * * PTF: This fix is designed for the fileset sna.rte at the specific * level of 6.1.0.4. It is not designed for any other level of the product * and may cause irreparable damage if inappropriately applied. If you are * in need of this PTF supplement to the product before proceeding with * the download and application of this fix please go to the above support * site and refer to the Code Updates section for details on retrieving the * minimum level of maintenance for this fix. You may also choose instead * to call support directly at 1-800-CALL AIX for more information. * * * No other prerequisites are required for the installation of this fix. * *+----------------------------------------------------------------------------+ * * * PROBLEM FIXED: IY50234 * Module Name: sna_v5router * * APAR DESCRIPTION: * Crash in sna_v5router * * ERROR DESCRIPTION: * Crash in sna_v5router with stack trace: * 0xf00005c0 (excpt=20202030:40000000:0000c023:20202030:00000106) * (intpri=11) * IAR: . sna_v5router:nrm_sess_deact_work +1e0 (0586e820): lwz r3,0x10(r3) * LR: . sna_v5router:nrm_session_deactivated_proc +104 (0586f12c) * 2efe2ac8: . sna_v5router:nrm_session_deactivated_proc +104 (0586f12c) * 2efe2b18: . sna_v5router:nrm_sm_to_rm_rec +9c (0587da9c) * 2efe2b68: . sna_v5router:nrm_queue_handler +84 (0587dc14) * 2efe2bb8: . sna_v5router:nba_dispatch_input +280 (056ca500) * 2efe2c18: . sna_v5router:nba_dispatch_process +c8 (056cabc8) * 2efe2c78: . sna_v5router:nba_scheduler +200 (056cb3bc) * 2efe2cd8: . sna_v5router:vpr_stream_uw_drive_scheduler +2c (056be520) * 2efe2d18: . sna_v5router:vpr_stream_uw_svc +124 (056bea0c) * 2efe2d78: . pse:sq_wrapper +ac (015219dc) * 2efe2db8: . pse:csq_run +23c (015123d8) * 2efe2e18: . pse:csq_lateral +a4 (0151144c) * 2efe2e78: . pse:scheduled_run +c8 (015222cc) * 2efe2ed8: .Netintr+12c (000c3eb0) * 2efe2f48: .netisr_thread+18 (000c3d48) * 2efe2f88: .threadentry+18 (0008e8e0) * 2efe2fc8: .low+0 (00000000) * * PROBLEM SUMMARY: * USERS AFFECTED: all * * PROBLEM DESCRIPTION: * Crash in sna_v5router * * PROBLEM SUMMARY: * I have not been able to determine he root cause of the problem. * However I can see the following: * - 112 and 101 minutes before the crash we have had two assert * events in the function nluutil.c line 1339. These asserts imply * that we are removing an internal control block while a message * is still queued on it (an attach for an incoming APPC conversation). * It may be that an incoming conversation is not cleaned up correctly * at this time. * - The crash is directly caused by the receipt of a normal UNBIND. We * try to clean up the queued attach but in looking at the freed * control block we see reused memory and so try to dereference an * invalid pointer. * There are two possible course of action: * (1) try to get further diagnostics of the underlying problem (the * ASSERTs). To do this, run with full tracing and medium asserts, what * this does is to stop the trace when an ASSERT is hit so the sequence * that led to the ASSERT does not get overwritten by later trace data.. * (2) Produce a protective fix to prevent the crash by removing a * pointer between control blocks at the time of the ASSERT. This should * be safe and would prevent the crash. However it does not address the * root cause of the problem. * * PROBLEM CONCLUSION: * This fix does not address the root cause of the problem. * It simply tries to prevent the crash. Even with the fix * it is possible that there may be other problems with * APPC applications not completing correctly, sessions * being terminated or even later crashes. Ideally fresh * diagnostics should be captured using trace and medium * ASSERTs) to allow us to find the underlying problem. * * * Also included in this updated module are fixes for the following APARs: * iy46595 sna_v5router (requires sna_mux to be complete) * JR18207 sna_v5router * iy49236 sna_v5router (requires liblua.o to be complete) * iy50234 sna_v5router * *+----------------------------------------------------------------------------+ * * INSTALLATION INSTRUCTIONS: * __________________________ * * iy50234.tar.Z ("this fix" in the steps below) is a compressed tar archive * file containing the updated modules and this readme. * * * To install this fix: * _____________________________ * * ** Downloading the file: * * 1) Be SURE to download this fix in BINARY format. * * 2) Check the output of sum against the updated module after * uncompressing and untarring this fix. You should see: * * 14581 4293 sna_v5router * * 3) Make sure that you have backed up your system recently. * * 4) Make sure that you have copies of your configuration files saved * (the /etc/sna directory contents). * * 5) Stop SNA and proceed to the next step * * sna stop * * (IMPORTANT) - Be sure that SNA is stopped. Please issue: * * ps -ef | grep sna* * * If a sna* process exists, use the kill command on the process. * It is also recommended that, if possible you take down any * applications that may try to access CS/AIX. * * 6) Backup your previous versions of the module(s) listed in this readme * by renaming them. * * cp /usr/lib/sna/drivers/sna_v5router /usr/lib/sna/drivers/sna_v5router.original * * 7) Copy this fix's updated module into its/their place(s). * * cp sna_v5router /usr/lib/sna/drivers/sna_v5router * * 8) Shutdown and reboot your system. * * shutdown -Fr * * 9) Restart Communications Server * * sna start * snaadmin init_node (and so on)... * * +--------------------------------------------------------------------------+ * * * CONTACT FOR Support: * ____________________ * * If you have any questions, please call the IBM AIX SUPPORT CENTER * for your Country. For example in the USA call: 1-800-CALL-AIX * * * IBM COPYRIGHT INFORMATION: * __________________________ * * IBM Communications Server for AIX, Version 6.1 * * * (c)Copyright International Business Machines Corporation 1998, 1999, 2003. * All rights reserved. Note to U.S. Government Users - Documentation * related to restricted rights - Use, duplication or disclosure is * subject to restrictions set forth in GSA ADP Schedule Contract * with IBM Corp. * * * * LIMIT OF LIABILITY: * ___________________ * * License to the contained APAR fixes is conditioned upon the recipient * holding a license to the prerequisite product. The license terms * and conditions of the APAR fixes are the same as those for the * prerequisite product. Please see the product license for specifics. * *******************************************************************************