Netra Data Plane Software Suite 2.0 Release Notes Sun Microsystems, Inc. www.sun.com Part No. 820-3364-10 April 2008, Revision A Submit comments about this document at: http://www.sun.com/hwdocs/feedback
Copyright 2008 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual property rights relating to technology that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and in other countries. This document and the product to which it pertains are distributed under licenses restricting their use, copying, distribution, and decompilation. No part of the product or of this document may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and in other countries, exclusively licensed through X/Open Company, Ltd. Sun, Sun Microsystems, the Sun logo, Java, Netra, docs.sun.com, and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and in other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and in other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. The OPEN LOOK and Sun Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun s written license agreements. U.S. Government Rights Commercial use. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements. DOCUMENTATION IS PROVIDED AS IS AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. Copyright 2008 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, Californie 95054, États-Unis. Tous droits réservés. Sun Microsystems, Inc. possède les droits de propriété intellectuels relatifs à la technologie décrite dans ce document. En particulier, et sans limitation, ces droits de propriété intellectuels peuvent inclure un ou plusieurs des brevets américains listés sur le site http://www.sun.com/patents, un ou les plusieurs brevets supplémentaires ainsi que les demandes de brevet en attente aux les États-Unis et dans d autres pays. Ce document et le produit auquel il se rapporte sont protégés par un copyright et distribués sous licences, celles-ci en restreignent l utilisation, la copie, la distribution, et la décompilation. Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme, par quelque moyen que ce soit, sans l autorisation préalable et écrite de Sun et de ses bailleurs de licence, s il y en a. Tout logiciel tiers, sa technologie relative aux polices de caractères, comprise, est protégé par un copyright et licencié par des fournisseurs de Sun. Des parties de ce produit peuvent dériver des systèmes Berkeley BSD licenciés par l Université de Californie. UNIX est une marque déposée aux États-Unis et dans d autres pays, licenciée exclusivement par X/Open Company, Ltd. Sun, Sun Microsystems, le logo Sun, Java, Netra, docs.sun.com, et Solaris sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux États-Unis et dans d autres pays. Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux États-Unis et dans d autres pays. Les produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc. L interface utilisateur graphique OPEN LOOK et Sun a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaît les efforts de pionniers de Xerox dans la recherche et le développement du concept des interfaces utilisateur visuelles ou graphiques pour l industrie informatique. Sun détient une license non exclusive de Xerox sur l interface utilisateur graphique Xerox, cette licence couvrant également les licenciés de Sun implémentant les interfaces utilisateur graphiques OPEN LOOK et se conforment en outre aux licences écrites de Sun. LA DOCUMENTATION EST FOURNIE "EN L ÉTAT" ET TOUTES AUTRES CONDITIONS, DÉCLARATIONS ET GARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT EXCLUES DANS LA LIMITE DE LA LOI APPLICABLE, Y COMPRIS NOTAMMENT TOUTE GARANTIE IMPLICITE RELATIVE À LA QUALITÉ MARCHANDE, À L APTITUDE À UNE UTILISATION PARTICULIÈRE OU À L ABSENCE DE CONTREFAÇON. Please Recycle
Netra Data Plane Software Suite 2.0 Release Notes These Release Notes contain last minute information about the Netra Data Plane Software Suite 2.0. Netra Data Plane Software is also referred to in this document as Netra DPS. Topics include: Before Installing Netra DPS 2.0 Software on page 2 Software Notes on page 3 Configuring LM-X Licenses on page 7 Feedback and Support on page 8 Note Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources. The Netra Data Plane Software Suite 2.0 documentation set is located at: http://docs.sun.com/app/docs/prod/netra.dp 1
Before Installing Netra DPS 2.0 Software Before installing Netra DPS 2.0 software, you must remove previous versions: To remove the SUNWndps packages, as superuser, type: # /usr/sbin/pkgrm SUNWndps SUNWndpsc The Netra DPS software is removed. Note For more details about using the pkgadd and pkgrm commands, see the man pages. 2 Netra Data Plane Software Suite 2.0 Release Notes April 2008
Software Notes Open Issues CR 6529219: Compilation Fails if a Function Returns a Structure Compilation fails if a function within an application returns a structure. This situation is due in part to private functions missing from libc. Workaround: The function needs to return a pointer to the structure. CR 6578957: ipc_tx(): chaining of messages is not supported Chaining of messages using the b_next field in the mblk_t structure is not supported in this release. ipc_tx() must be called once for every message. CR 6578962: IPC channels do not recover after one link partner is rebooted When the Netra DPS run time domain is rebooted, Solaris domains with a virtual data plane channel (vdpc) client need to be rebooted before IPC channels can be reconfigured. When a Solaris domain with a vdpc client is rebooted, the Netra DPS run time domain must be rebooted as well before the IPC channels can be reconfigured. The exception to this rule is the global configuration channel (primary-gc / tnsm-gc0), which recovers when either end has rebooted. Netra Data Plane Software Suite 2.0 Release Notes 3
CR 6621350: teja_profiler_dump() can dump discrepant information to the console This bug had been resolved and will be in the next Sun Enterprise T2000 and T5220 Platform System Firmware Release. Workaround: In a guest domain, find when LDoms is used. When using the profiler on the Netra CP3260 platform, make sure that the LDoms configuration is used. CR 6635027: Code generation takes too long when an application has a large statically initialized data structure tejacc takes a long time if an application has a large statically initialized data structure. The bug is under investigation and will be fixed in the upcoming Netra Data Plane Software release. CR 6637959: ctr+c may not work properly on an application built by ipsecgw_niu_multi This behavior only occurs on the Netra CP3260 system. CR 6639121: ipfwd10g_niu under LDoms crashes when starting traffic LDoms with NIU configurations can crash when the Netra DPS domain is not kept under the first 0-4G memory range. Workaround: Create the Netra DPS domain within the address space of 4G. CR 6644168: Generated code has too many warnings tejacc generates code which mainly has two kinds of warnings (type mismatch and vfork). The bug is under investigation and will be fixed in the upcoming Netra Data Plane Software release. CR 6660105: Inconsistencies in profiler_n2.pl output The summary section of the profiler_n2.pl output shows inconsistencies. For example, the first row for each CPUID entry has bad data, the 4th column has incorrect values, and the 4th and 6th columns show the same values. 4 Netra Data Plane Software Suite 2.0 Release Notes April 2008
CR 6665170: ipfwd with nxge in LDoms multi queue configuration cannot handle traffic from multiple ports When the IP forwarding reference application is compiled for the LDoms environment on the Sun UltraSPARC T1 platform to use multiple nxge interfaces and the forwarding table updates from the fibctl environment, the application exhibits degraded performance and stops passing traffic once it receives substantial packet rates on more than one port. CR 6665699: GDB fails to connect to Netra DPS domain from Solaris domain through the gdb utility CR 6671308: ipfwd10g_niu crashes at boot time if the application is compiled for two ports with the MULTI_QS flag set All IP packet forwarding (ipfwd) applications when compiled with the IPFWD_MULTI_QS flag in Makefile.nxge crash at boot time. CR 6681093: remotecli: coredump dumps core to a different location than the one being documented Workaround: By default, the core is dumped in /tmp instead of /var/lwrtedump, therefore, you can find the core file in /tmp. CR 6681124: remotecli: Not able to quit the console mode Netra Data Plane Software Suite 2.0 Release Notes 5
GNU Project Debugger (GDB) Showcase Application Known Issues This showcase currently runs only over LDC, not over IPC, for simpler configuration. GDB does not support a 64-bit SPARC bare hardware target, although Netra DPS is running 64-bit. GDB will not display 64-bit register files returned from Netra DPS due to lack of support in GDB. Therefore, Netra DPS returns 32-bit values only by truncating the upper 32-bit value of the registers leading to possibly missing important information Backtrace does not work properly. GDB has its own algorithm to retrieve the stack trace from somewhere, and malfunctions. If you know the formula for SPARC frames, you can retrieve all the frames. but GDB does not perform this at this time. This issue is part of future work on GDB support in Netra DPS. The right algorithm is to retrieve the sp value (same as register %o6) from the output of info reg. For example, for sp = 0x10e01031, do the following math: sp - 1 + 0x800 = 0x10e01830 This gets the next level stack frame from the calculated address above and checks the value at offset 15th of 64-bit. It is the caller function address and the next level sp is located at offset 14th 64-bit. Use that value to do the same math of sp - 1 + 0x800 to go to next level trace. [Tip: do this in GDB: x/16xg 0x10e01830. The caller function is the last 64-bit value of the output and second to the last one is the next sp value]. GDB does not follow this algorithm. Continue with breakpoint GDB supports software breakpoint. It inserts a breakpoint and is followed by a step breakpoint. As a result, currently you need to type two consecutive cont in GDB to have the one single cont affect. step/next is in instruction level instead of C code level. 6 Netra Data Plane Software Suite 2.0 Release Notes April 2008
Configuring LM-X Licenses Working with Licenses Using LM-X You must have a license file to use the software. When you invoke compilation of any application, Netra DPS reads the license file. A valid license file must be present at /opt/lm-x/license. Sun Microsystems issues two kinds of licenses: Node-locked licenses (multiple user); see Node-Locked Licenses. Time bound evaluation licenses (multiple user); see Evaluation Licenses on page 8 Node-Locked Licenses A node-locked license, or uncounted license, is a license that runs on a single machine. The license file contains permission to run various tools for multiple users simultaneously. Obtaining a Node-Locked License File To obtain a license file, email the following information to NetraDPSlicense@sun.com: Name of the license user name, address, and phone number of your company Product and target processor Purchase order number The host ID of the host computer where the distribution is installed You can find the host ID by running hostid (located under /usr/bin/). Installing a Node-Locked License When you receive the license file (for example, license), simply copy it to the following folder: /opt/lm-x/ (create this folder if not present). Compiling any of the reference applications or your own application automatically finds the license file. Netra Data Plane Software Suite 2.0 Release Notes 7
Set the LM_LICENSE_FILE environment variable to include the location of the new license file. For example, in UNIX or Linux, use the setenv command in a C shell: setenv LM_LICENSE_FILE /opt/lm-x/license Evaluation Licenses An evaluation license, or counted license, is a temporary license for a specified number of days. An evaluation license allows multiple users to use a single license file on a single computer for a limit of 90 days. Obtaining an Evaluation-License File To obtain an evaluation license file, email the following information to NetraDPSlicense@sun.com: Name of the license user (or contact name) Name, address, and phone number of your company Product and target processor The host ID of the license server You can find the host ID by running hostid (located under /usr/bin/). Feedback and Support You can request Sun support and provide feedback to Sun at the following email address: ndps-feedback@sun.com 8 Netra Data Plane Software Suite 2.0 Release Notes April 2008