Enea Log Analyzer 2.9 Release Information 20151111_1815
Enea Log Analyzer 2.9 Release Information Copyright Copyright Enea Software AB 2015. This User Documentation consists of confidential information and is protected by Trade Secret Law. This notice of copyright does not indicate any actual or intended publication of this information. Except to the extent expressly stipulated in any software license agreement covering this User Documentation and/or corresponding software, no part of this User Documentation may be reproduced, transmitted, stored in a retrieval system, or translated, in any form or by any means, without the prior written permission of Enea Software AB. However, permission to print copies for personal use is hereby granted. Disclaimer The information in this User Documentation is subject to change without notice, and unless stipulated in any software license agreement covering this User Documentation and/or corresponding software, should not be construed as a commitment of Enea Software AB. Trademarks Enea, Enea OSE, and Polyhedra are the registered trademarks of Enea AB and its subsidiaries. Enea OSE ck, Enea OSE Epsilon, Enea Element, Enea Optima, Enea Linux, Enea LINX, Enea LWRT, Enea Accelerator, Polyhedra Flash DBMS, Polyhedra Lite, Enea dspeed, Accelerating Network Convergence, Device Software Optimized, and Embedded for Leaders are unregistered trademarks of Enea AB or its subsidiaries. Any other company, product or service names mentioned in this document are the registered or unregistered trademarks of their respective owner. Acknowledgements and Open Source License Conditions Information is found in the Release Information manual. Enea Software AB 2015 20151111_1815 ii
Table of Contents 1 - Introduction... 4 2 - About This Release... 5 2.1 - User Documentation... 5 2.2 - System Requirements... 5 2.2.1 - Platform Installation... 5 2.2.2 - Supported Hosts... 6 2.2.3 - Host Memory Requirements... 6 2.2.4 - Supported OSE Releases... 6 2.2.5 - Supported OSEck Releases... 6 2.2.6 - Supported OSE Target Architectures... 6 2.2.7 - Supported OSEck Target Architectures... 7 2.3 - Components Included in This Release... 7 3 - Additions and Changes... 8 3.1 - User Documentation... 8 3.2 - New Delivery Model... 8 3.3 - Eclipse Base platform, Java and Optima Upgrade... 8 3.4 - No Longer Included with Log Analyzer... 8 3.5 - Discontinued Support... 8 3.6 - Various Bug fixes... 8 4 - Known Problems and Limitations... 9 4.1 - Text Browser limitations... 9 4.2 - Gantt Chart limitations... 9 4.3 - Sequence Diagram limitations... 9 4.4 - Generic Import Wizard limitations... 9 4.5 - Preferences limitations... 9 4.6 - Views not cleared... 9 4.7 - Empty views when reopened... 9 5 - Contacting Enea Support... 10 5.1 - Request for Product Support... 10 5.2 - Support Issue Information... 11 5.3 - Software Updates... 12 5.4 - Extended Support Services... 12 6 - Acknowledgements and Open Source License Conditions... 13 Enea Software AB 2015 20151111_1815 iii
1. Introduction 1. Introduction The following is described in this document: Chapter 2, About This Release [5] provides general information about this release. Chapter 3, Additions and Changes [8] provides an overview of the changes from the previous Log Analyzer release. Chapter 4, Known Problems and Limitations [9] describes known problems and limitations in this release. Chapter 5, Contacting Enea Support [10] provides information on how to contact Enea Support. Chapter 6, Acknowledgements and Open Source License Conditions [13] provides information about acknowledgements and any open source licenses. Enea Software AB 2015 20151111_1815 4
2. About This Release 2. About This Release Enea Log Analyzer 2.9 is a tool for analyzing Enea OSE and Enea OSE ck operating systems event logs, Black Box Recorder event logs and user-defined event logs. This Log Analyzer release contains: Black Box Recorder and user-defined event logs analyzing feature. FLEXlm license required. PMD/XML Event Importer feature for analyzing OSE/OSEck event logs. All user documentation in Eclipse Help online format. The user documentation is also available in PDF for online reading or printing. Black Box Recorder, a compact, efficient, OS-independent and reliable black-box event recorder for embedded software. FLEXlm License Manager (only required if a local license server is needed) 2.1 User Documentation This release contains the following user documentation: Log Analyzer Release Information (this document) Log Analyzer User's Guide Log Analyzer Plug-in Developer's Guide (only available in Eclipse Help format) Products Installation Guide History information for Log Analyzer The user documentation is available in the following formats: Eclipse Help (online documentation) PDF (for online reading or printing) Note: The user documentation in Eclipse Help format is automatically installed inside Eclipse when Log Analyzer plugins are installed. Printed manuals are not available. 2.2 System Requirements 2.2.1 Platform Installation See Section 2.2.2, Supported Hosts [6] below. Log Analyzer 2.9 requires that the user installs the following versions of Eclipse and Optima (optional): Eclipse Standard 4.3.2 for their host environment. This is installed from http://www.eclipse.org/downloads/packages/release/kepler/sr2 Optima 2.9 (optional - needed only if PMD/XML Event Importers feature is installed). Optima is installed using the Eclipse Installation Engine from http://update.enea.com/optima/2.9/ according to the steps in the Products Installation Guide, which also describes the initial configuration. Log Analyzer 2.9 is installed using the Eclipse Installation Engine from http://update.enea.com/loganalyzer/2.9/ according to the steps in the Products Installation Guide, which also describes the initial configuration. Enea Software AB 2015 20151111_1815 5
2. About This Release 2.2.2 Supported Hosts The following host operating systems are supported for all tools: Windows 7 64-bit Suse Linux Enterprise Desktop 11 SP3 64-bit Red Hat Linux Desktop 6.4 64-bit Ubuntu 14.04.1 LTS 64-bit 2.2.2.1 Special Host Requirements When running Log Analyzer, please make sure to set the LD_LIBRARY_PATH environment variable to include the /usr/local/lib directory. All supported Linux distributions contain GNOME/GTK and the runtime environment for GNOME and GTK must be installed. The Linux standard distributions need added libraries. Before installing Log Analyzer, it is recommended to update the host according to the "General Host Requirements - Linux" section in the Products Installation Guide, which lists needed packages. 2.2.3 Host Memory Requirements The following memory requirements shall be enough to run Log Analyzer: Typically about 500 MB of free hard disk space is required (exact amount depends on what is installed). 4 GB RAM for Windows 7 hosts is recommended. 2 GB RAM for all other hosts is recommended. 2.2.4 Supported OSE Releases Log Analyzer supports the following OSE releases: OSE 5.8 OSE 5.7 OSE 5.6 OSE 5.5 Note For OSE 5.4 and earlier refer to the Log Analyzer in Optima 2.8 release. 2.2.5 Supported OSEck Releases Log Analyzer supports the following OSEck releases: OSEck 4.1 OSEck 4.0 OSEck 3.3 2.2.6 Supported OSE Target Architectures Log Analyzer supports the following OSE target architectures: ARM PowerPC Enea Software AB 2015 20151111_1815 6
2. About This Release 2.2.7 Supported OSEck Target Architectures Log Analyzer supports the following OSEck target architectures: Texas Instruments TMS320c64x+ Texas Instruments TMS320c674x Texas Instruments TMS320c66x LSI Logic SP26xx LSI Logic SP27xx Freescale MSC8144 Freescale MSC8156 Freescale MSC8157 2.3 Components Included in This Release This release includes the following Log Analyzer components: Log Analyzer Eclipse plugins 2.9.0 The BlackBox Recorder 1.4.0 FLEXlm License Manager 11.4 (only required if a local license server is needed) The Log Analyzer Eclipse plugins are tested with this configuration. Java Runtime Environment 1.8 Eclipse Platform 4.3.2 Optima Tools Suite 2.9 Enea Software AB 2015 20151111_1815 7
3. Additions and Changes 3. Additions and Changes From version 2.9, the Log Analyzer is delivered separately. Previously the Log Analyzer was delivered within the Optima distribution (in Optima 2.8 and earlier). 3.1 User Documentation The Log Analyzer User's Guide has been updated. The Log Analyzer Release Information has been added. 3.2 New Delivery Model Log Analyzer 2.9 is delivered through the Eclipse Installation Engine from an Enea update site. 3.3 Eclipse Base platform, Java and Optima Upgrade Log Analyzer has been updated to support the Eclipse Base Platform 4.3.2 (previously 3.8.1), Java 1.8 (previously 1.6) and Optima Tools Suite 2.9 (previously 2.8). Added support for the 64-bit Eclipse Base Platform. 3.4 No Longer Included with Log Analyzer The Log Analyzer 2.9 distribution no longer contains: The Eclipse Base Platform. The user has to download and install the Eclipse Base Platform. The Enea Optima Tools Suite. The user has to install Optima in their Eclipse Base Platform. 3.5 Discontinued Support In Log Analyzer 2.9, support is discontinued for: Log Analyzer no longer includes any support for Linux Trace Toolkit Next Generation (LTTng) traces. 3.6 Various Bug fixes The Log Analyzer user interface has been enhanced. Enea Software AB 2015 20151111_1815 8
4. Known Problems and Limitations 4. Known Problems and Limitations This chapter describes known problems and limitations at release date. 4.1 Text Browser limitations Hitting the end key in "Text Browser" view" on SLED 11 does not display the arrow on the last event. However, the last event is selected and it is listed as such in the properties view. Hitting the end key again will display the arrow correctly but is collapses the listing from the properties view 4.2 Gantt Chart limitations When scrolling through the Black Box Recorder event log Gantt Chart, the chart is incorrectly redrawn, i.e. it does not occupy the whole drawing area. The range selector markers reset when moving the sash (filter screen). 4.3 Sequence Diagram limitations "Add" amd "Add all" buttons in "Configure Order" window have the right edges cut. 4.4 Generic Import Wizard limitations When importing an existent configuration xml file, only the "Fields" tab is populated, the "Filters" tab remains empty. If repeating the operation, the filters are also correctly imported. 4.5 Preferences limitations "Restore Defaults" button does not work for either "Gantt Chart" and "Misc" preferences pages. 4.6 Views not cleared "Assertion result", "Search" and "Plot" views are not cleared after deconfigure. 4.7 Empty views when reopened "Logset Overview" and "Logmarks" views are empty after being closed and reopened or when Log Analyzer is being restarted. A workaround for this is to open/select any browser (such as Test Browser, Timeline Browser or Gantt Chart). Enea Software AB 2015 20151111_1815 9
5. Contacting Enea Support 5. Contacting Enea Support Technical support for all Enea licensed and supported products can be requested via EneaIssues (https:// eneaissues.enea.com), via e-mail mailto:support@enea.com or telephone. Addresses and phone numbers for local support can be found at: http://www.enea.com/support. 5.1 Request for Product Support Before reporting a problem or defect to the Enea Global Support, please perform the following checks: Check the user documentation for the Enea product(s), including trouble shooting sections. Check if the issue you request support for is supported by Enea (see the release documentation about which components are included in your delivery). Check any information found via http://www.enea.com/support. Check whether the problem is specifically related to your application or if it is an error generated by an Enea product. In order to effectively resolve reported problems, we kindly ask Enea's customers to provide Enea Global Support with sufficient information to identify and isolate the specific problem or defect. We recommend using EneaIssues (https://eneaissues.enea.com), also available at http://www.enea.com/support. Report a bug, ask for a new feature, or just ask a question. See Section 5.2, Support Issue Information [11], listing information to provide in a support issue to ensure the issue can be processed as fast as possible. Below are some further explanations. If possible, please try to provide relevant and basic information such as the following: Name of the software product component. Version Number. Error Messages. Documented sequence of events to reproduce the problem. Please also communicate the severity level of this problem or defect to Enea Global Support for priority purposes. Currently, the following levels of severity are defined: Minor - The Product(s) functionality operates abnormally. If the Error occurs during the development phase of a Customer's product, the development, integration, or testing is inconvenienced. Alternately, the Customer requires information or assistance with respect to the Product(s) capabilities, installation, or configuration. Serious - The Product(s) functionality operates with severely reduced capacity causing significant impact to business operations. If the Error occurs during the development phase of a Customer's product, the Error has serious impacts on the development, integration, or testing. A workaround may be available. Critical (showstopper) - The Product(s) functionality is inoperable causing critical impact to business operations, if the functionality is not restored quickly. If the Error occurs during the development phase of a Customer's product, the Error hinders all of the Customer's development, integration, or testing. No viable workaround is known. Each reported issue is assigned a problem identification number and is managed using a defect tracking system, EneaIssues. Once a problem has been received, Enea Global Support will send a receipt for the issue. An external user's guide for EneaIssues is available at http://www.enea.com/issuetrackingguide. Enea Software AB 2015 20151111_1815 10
5. Contacting Enea Support 5.2 Support Issue Information The following information is to be provided by a customer in a support issue (https://eneaissues.enea.com), to enable Enea support to process the issue in fastest possible way. The customer could copy this text, add information and paste it into the issue report description (* denotes mandatory information). 1. * Problem title (Well describing the problem, please avoid using customer specific words). 2. Basic information (should be accurate and detailed - mandatory if issue is critical). How is the problem affecting your business? Problem impact? On which level in the system does it occur [in operation/upstart/upgrade]? Is the problem preventing you from shipping your product? Is the problem located in development, at applications or at an end customer? 3. * Question, probable Bug or New Feature [not part of current product definition] (Q, B or FR). 4. * Estimated Problem severity: Critical (A), Serious (B) or Minor(C). Critical (showstopper) - The system is unusable until a fix is available. Serious - A component of the system is unusable until a fix is available. Minor - Little or no impact on the use of the product. 5. * Enea Product and Version, detailed enough to identify exactly which version is used. Product release and if applicable, component version. See below. Possibly customer specific component? Development Host platform and Host OS version (if applicable)? Target architecture e.g. PPC440EP Bamboo (if applicable)? Compiler/toolset, compiler flags and version? 6. * Problem description (Should be accurate, detailed and explain the problem in terms of Enea product concepts and components. Customer specific abbreviations or words should be avoided or explained). 7. * Describe if the problem can be reproduced/verified: Is the problem reproducible (frequency => x out of y times)? Is the problem reproducible with the latest product release? See below. Do you have a workaround? - if yes, please clarify. 8. Information to help identify the cause of the problem: A reasonable investigation of the issue that makes you believe the problem is with the Enea product. Please provide a step by step guide with necessary reference/sample code to recreate the problem. What pre-conditions are necessary to recreate the fault? Does the error origin from the host or target? Append applicable files - see below. What drivers are involved? Have any drivers been modified? Wireshark traces or information from probes like RiskWatch. Append applicable files - see below 9. Product specific information and appended files: Product release (e.g. OSE release N.N.n, Enea-Linux-<date>), component version or baseline. Reproducable (or not) with latest release (e.g. baseline BLxxxxxx or Enea-Linux-<date>). Configuration files (Y/N)? File names: Trace log files (Y/N)? File names: dmesg files (Y/N)? File names: Kernel Ooops and/or core.<pid> files (Y/N)? File names: List file with what-strings for relevant libraries or executables. File name: Ramlog files and/or PMD (Post Mortem Dump) files (Y/N)? - if applicable, include the time of the error and your own analysis and include corresponding.elf files. File names:.elf files (Y/N)? File names: Enea Software AB 2015 20151111_1815 11
5. Contacting Enea Support 5.3 Software Updates Major product releases are currently scheduled regularly. Major releases include cumulative upgrades containing corrections to Enea licensed products and new functionality included in the licensed products. Maintenance updates and patches are provided for corrections to known problems and are available upon request. Some special products, existing in many variants for different ranges of targets and supported major products, can be updated and provided depending on demands, instead of regularly. Please contact Enea Global Support for further information. 5.4 Extended Support Services Extended maintenance options are available for an additional fee that is determined based on the selected services. Potential Extended Support Services could include on-site support, support reviews, and a higher grade of support. Enea Software AB 2015 20151111_1815 12
6. Acknowledgements and Open Source License Conditions 6. Acknowledgements and Open Source License Conditions Some of the Enea Software AB products contain software under various forms of open source licences. Information about these and required acknowledgements texts are delivered in one or more documents. The documents are located in the installed directory <ECLIPSE_HOME>/log_analyzer_files/doc/ackn/. Many of these licenses require due credit to be given and/or the particular license conditions to be reproduced in the documentation. Please contact Enea for further information. Enea Software AB 2015 20151111_1815 13