Intel(R) Cluster Checker 3.0.1 for Linux* - Release Notes ------------------------------------------------------------------------------- CONTENTS -------- 1. OVERVIEW 2. NEW FEATURES 3. SYSTEM REQUIREMENTS 4. INSTALLATION NOTES 5. DOCUMENTATION 6. KNOWN LIMITATIONS AND TROUBLESHOOTING 7. TECHNICAL SUPPORT 8. DISCLAIMER AND LEGAL INFORMATION ------------------------------------------------------------------------------- 1. OVERVIEW ------------------------------------------------------------------------------- Intel(R) Cluster Checker verifies the configuration and performance of Linux*-based clusters and checks the cluster's compliance with the Intel(R) Cluster Ready Specification. ------------------------------------------------------------------------------- 1.1. RELATED PRODUCTS AND SERVICES ------------------------------------------------------------------------------- Information about Intel(R) software development products is available at http://www.intel.com/software/products. These are some of the products related to Intel(R) Cluster Checker: o Intel(R) Cluster Ready is a program designed to provide a common platform solution to build clustered applications. It helps organizations build, seamlessly deploy, and manage compatible and consistent applications using a clustered foundation. This program can significantly simplify the work of platform integrators, applications developers, and cluster component vendors. http://www.intel.com/go/cluster o The Intel(R) C++ and Fortran Compilers include advanced optimization and multithreading capabilities, highly optimized performance libraries, and analysis tools for creating fast reliable multithreaded applications. http://www.intel.com/software/products/compilers o The Intel(R) MPI Library for Linux*, the Intel(R) Trace Analyzer and Collector for Linux, and the Intel(R) Math Kernel Library Cluster Edition for Linux* are the most awarded development tools. They create, analyze, and optimize high-performance applications on clusters of Intel(R) processor-based systems. http://www.intel.com/software/products ------------------------------------------------------------------------------- 2. NEW FEATURES ------------------------------------------------------------------------------- Intel(R) Cluster Checker 3.0 has been re-architected and re-implemented as an expert system, improving scalability, extensibility, ease of use, and diagnostic capability. The key changes relative to the previous versions of Intel(R) Cluster Checker are: - Data collection and analysis have been split into separate steps. Note: the 'clck' script is provided to emulate the combined data collection and analysis behavior of previous versions. - Data is stored in a database rather than being discarded after each run. - The root causes of some issues can be diagnosed and reported, with recommendations to remedy the problem. - An API is provided to embed Intel(R) Cluster Checker capabilities into user code. - The ability to extend and enhance the checking capability is provided. ------------------------------------------------------------------------------- 2.1 WHAT'S NEW IN 3.0.1 ------------------------------------------------------------------------------- - Added clck-analyze command line options to enable / disable checks, set the checking mode, and control the output. - Updated the samples and Developer's Guide documentation. - Bug fixes ------------------------------------------------------------------------------- 3. SYSTEM REQUIREMENTS ------------------------------------------------------------------------------- The following sections describe hardware and software requirements. ------------------------------------------------------------------------------- 3.1. HARDWARE ------------------------------------------------------------------------------- - Intel(R) Xeon(R) processor (Intel(R) 64 architecture) - 1 GB of RAM recommended - 160 MB of free hard disk space required for installation ------------------------------------------------------------------------------- 3.2. SOFTWARE ------------------------------------------------------------------------------- Operating Systems: - Red Hat* Enterprise Linux* 6 and 7 - SUSE* Linux* Enterprise Server 11 and 12 - CentOS 6 and 7 Runtimes: - Intel(R) MPI Library Note: while the full SDK versions of these components fulfill the requirement, only the runtime is required. ------------------------------------------------------------------------------- 4. INSTALLATION NOTES ------------------------------------------------------------------------------- Intel(R) Cluster Checker is distributed as part of Intel(R) Parallel Studio XE 2016 Cluster Edition and also as a standalone package. To install Intel(R) Cluster Checker as part of Intel(R) Parallel Studio XE 2016 Cluster Edition, please refer to the Intel(R) Parallel Studio XE 2016 Cluster Edition documentation. To install the standalone package, run the following commands: % tar -xzf l_clck_p_3.0.1..tgz -C /tmp % cd /tmp/l_clck_p_3.0.1. % ./install.sh Notes: - The default Intel(R) Cluster Checker install path is /opt/intel/clck/3.0.1.. - Intel(R) Cluster Checker needs to be installed on all nodes. This can either be accomplished either by installing into a shared directory or by installing a local copy on each node. Both options are supported by the installer. ------------------------------------------------------------------------------- 5. DOCUMENTATION ------------------------------------------------------------------------------- This release of Intel(R) Cluster Checker includes the following documentation: The Getting Started Guide walks through using Intel(R) Cluster Checker for the first time. The Intel(R) Cluster Checker User's Guide contains information on how to use Intel(R) Cluster Checker. It describes the basic usage models and the basic steps using the tool. The Intel(R) Cluster Checker Developer's Guide contains information on how to extend Intel(R) Cluster Checker. It describes how to embed Intel(R) Cluster Checker functionality into other applications and how to add new checks to the tool or modify existing checks. The Intel(R) Cluster Checker Reference Manual contains information on specific configuration options. It describes environment variables and configuration options that influence checking behavior. The Intel(R) Cluster Checker API reference describes the API that may be used to embed Intel(R) Cluster Checker functionality into other software programs. The documentation can be found in the doc sub-directory. ------------------------------------------------------------------------------- 6. KNOWN LIMITATIONS AND TROUBLESHOOTING ------------------------------------------------------------------------------- The following is a list of known issues in this release. Since this is pre-release software, it may be subject to many unknown issues as well. - Data collection behavior and functionality o When using on-demand data collection, the nodefile must be located in a shared, writable directory. o XML comments may not be used inside the tag of etc/clckd.xml. o Databases located on NFS file systems mounted with the "nolock" option are not supported. Not all data from concurrent data collection instances per database will be written to the database and the database may become corrupted. A single data collector instance per database can usually be used successfully in this case. o The 'iozone' data provider does not execute correctly on diskless clusters. - Analysis behavior and functionality o Clusters containing dual port InfiniBand* adapters where the second port is unused should suppress the 'infiniband-port-physical-state-not-linkup' and 'infiniband-port-state-not-active' signs. See Chapter 4 of the User's Guide for more information on how to suppress signs. o If distribution of measured performance is very narrow, performance outliers may be incorrectly identified. The number of median average deviations may be increased to prevent the outliers from being flagged. o The Intel(R) Cluster Ready Specification requires that the runtime libraries of the Intel tools are installed in specific, non-default locations. Either download and install the separate Intel(R) Cluster Runtimes, or, to fulfill these requirements with Intel(R) Parallel Studio XE 2016 Cluster Edition, manually create symbolic links using the following commands. % mkdir -p /opt/intel/cc/16.0.0 % ln -s /opt/intel/bin /opt/intel/cc/16.0.0/ % ln -s /opt/intel/lib/ia32 /opt/intel/cc/16.0.0/lib % mkdir -p /opt/intel/cce/16.0.0 % ln -s /opt/intel/bin /opt/intel/cce/16.0.0/ % ln -s /opt/intel/lib/intel64 /opt/intel/cce/16.0.0/lib % mkdir -p /opt/intel/fc/16.0.0 % ln -s /opt/intel/bin /opt/intel/fc/16.0.0/ % ln -s /opt/intel/lib/ia32 /opt/intel/fc/16.0.0/lib % mkdir -p /opt/intel/fce/16.0.0 % ln -s /opt/intel/bin /opt/intel/fce/16.0.0/ % ln -s /opt/intel/lib/intel64 /opt/intel/fce/16.0.0/lib % mkdir -p /opt/intel/cmkl % ln -s /opt/intel/mkl /opt/intel/cmkl/11.3.0 ------------------------------------------------------------------------------- 7. TECHNICAL SUPPORT ------------------------------------------------------------------------------- To receive technical support and technical information for the tools provided in this product, including FAQ's and product updates, register for an Intel(R) Premier Support account at the Intel(R) Registration Center. NOTE: Registering for support varies for release products or pre-release products (alpha, beta, etc.) - only released products have support web pages on http://support.intel.com/. To register for an account, please visit the Intel(R) Registration Center web site at http://www.intel.com/software/products/registrationcenter/index.htm. If you have forgotten your password, please e-mail a request to: quadsupport@mailbox.intel.com. Please do not e-mail your technical issue to this e-mail address. The support web site, http://premier.intel.com, provides top technical issues, frequently asked questions, product documentation, and product errata. Your feedback is very important to us! Contact Intel(R) Customer Support via e-mail at quadsupport@mailbox.intel.com ------------------------------------------------------------------------------- 8. DISCLAIMER AND LEGAL INFORMATION ------------------------------------------------------------------------------- Copyright (c) 2006-2015, Intel Corporation. All rights reserved. INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL(R) PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. Intel products are not intended for use in medical, life saving, life sustaining, critical control or safety systems, or in nuclear facility applications. Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined." Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with this information. The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request. Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order. Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-548-4725, or by visiting Intel's Web Site. Optimization Notice ------------------- Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice. Notice revision #20110804