[frs-227] Using FusionReactor on the AIX operating system

Symptoms

CPU metrics are not available in FusionReactor on AIX operating systems. This is most visible from the System Metrics charts.

Analysis

FusionReactor uses a native code plugin to retrieve these system level metrics directly from the operating system.

Resolution

We have built a native plugin library to call the "libperfstat" library for direct integration into FusionReactor.
Simply follow the instructions from instructions.txt in the attached AIX-NativePlugin-301.zip to add CPU metrics on IBM AIX platforms.


Requirements

  • FusionReactor 3.0.1 or later
    • You can browse to "About" under the "FusionReactor" tab of the FusionReactor web interface to verify which version of FusionReactor you are running.
  • Performance Statistics Library 5.3.9.0 or later
    • You can check for its presence with the following command:
      	$lslpp -l bos.perf.libperfstat bos.perf.perfstat
      
    • Which should result in output simiilar to:
        Fileset                      Level  State      Description        
        ----------------------------------------------------------------------------
      Path: /usr/lib/objrepos
        bos.perf.libperfstat       5.3.9.0  COMMITTED  Performance Statistics Library
                                                       Interface
        bos.perf.perfstat          5.3.9.0  COMMITTED  Performance Statistics
                                                       Interface
       
      Path: /etc/objrepos
        bos.perf.libperfstat      5.3.0.10  COMMITTED  Performance Statistics Library
                                                       Interface
        bos.perf.perfstat          5.3.9.0  COMMITTED  Performance Statistics
                                                       Interface
      

Installation

  1. Put the library file (libFusionReactor.aix.so) into the java.library.path or LD_LIBRARY_PATH. The easiest way to do this for your entire machine is to copy the attached library into "/usr/lib" making it available to all JVM instances.
  2. Restart your instance.
  3. Verify CPU metrics are available by browsing to "System Metrics" under the "Metrics" tab of the FusionReactor web interface.

Issue Details

Type: Technote
Issue Number: FRS-227
Components: CPU + Memory, Metrics
Environment:
Resolution: Fixed
Last Updated: 20/Aug/09 5:08 PM
Affects Version: 3.0.1
Fixed Version: Pending
Server:
Platform: AIX
Related Issues:

Comments are closed.