You are previewing IBM Intelligent Operations Center 1.6 Programming Guide.
O'Reilly logo
IBM Intelligent Operations Center 1.6 Programming Guide

Book Description

IBM® Intelligent Operations Center is an integrated solution. It provides a rich set of capabilities and line of business tools that business users with domain expertise and no technical background can use without customization.

IBM Intelligent Operations Center also provides services and extension points that developers can use to extend the IBM Intelligent Operations Center standard functions and develop capabilities specific to the domain and client requirements.

IBM Intelligent Operations Center includes an application-based programming model that supports all the interactions with the solution components. The programming model is based on industry standard Representational State Transfer (REST) and Java technologies. IBM Intelligent Operations Center includes a full set of REST and Java application programming interfaces (APIs) that provide a simplified development environment and make the platform easy to extend and customize for a large community of developers.

This IBM Redbooks® publication gives a broad understanding of the IBM Intelligent Operations Center 1.6.0.1 programming model and available extension points. Many of the chapters describe working examples and usage scenarios that demonstrate how to extend the IBM Intelligent Operations Center base platform. This book includes sample code that can be downloaded from the IBM Redbooks website.

The target audience for this book consists of solution architects, developers, technical consultants, and solution administrators who will learn the following information:

  • The options available to extend the IBM Intelligent Operations Center solution programmatically

  • How to configure customizations tailored to specific customer requirements

  • How to use the available configuration tools to configure the solution without requiring programming


  • Readers of this book will benefit from the IBM Redbooks publication IBM® Intelligent Operations Center 1.5 to 1.6 Migration Guide , SG24-8202.

    Table of Contents

    1. Front cover
    2. Notices
      1. Trademarks
    3. Preface
      1. Authors
      2. Now you can become a published author, too!
      3. Comments welcome
      4. Stay connected to IBM Redbooks
    4. Chapter 1. IBM Intelligent Operations Center programming model overview
      1. 1.1 IBM Intelligent Operations Center components
      2. 1.2 IBM Intelligent Operations Center services API
        1. 1.2.1 IBM Intelligent Operations Center services API design
      3. 1.3 REST services
        1. 1.3.1 Resource URIs
        2. 1.3.2 REST services access
        3. 1.3.3 Authentication
        4. 1.3.4 Client-side service invocation sample
        5. 1.3.5 General guidelines
        6. 1.3.6 Http response status codes
      4. 1.4 RestStore
        1. 1.4.1 Purpose
        2. 1.4.2 Benefits
        3. 1.4.3 Design
        4. 1.4.4 Using RestStore
      5. 1.5 Java APIs
        1. 1.5.1 Implementation details
        2. 1.5.2 Server-side service invocation sample
      6. 1.6 Session persistence
      7. 1.7 List of IBM Intelligent Operations Center services
      8. 1.8 Extension points
      9. 1.9 Programming considerations for high availability
    5. Chapter 2. Sample scenario
      1. 2.1 Sample scenario overview
      2. 2.2 Planning for the event
      3. 2.3 During the event
        1. 2.3.1 Keeping track of crowd sizes
        2. 2.3.2 Keeping track of first aid incidents
        3. 2.3.3 Responding to incidents
      4. 2.4 After the event
    6. Chapter 3. Integrating with data sources
      1. 3.1 The data import process
        1. 3.1.1 Data import process overview
      2. 3.2 Configuring data sources
        1. 3.2.1 Key considerations when planning to import data into IBM Intelligent Operations Center
        2. 3.2.2 Use case overview
        3. 3.2.3 Database table data source
        4. 3.2.4 CSV data source
        5. 3.2.5 CAP data source
        6. 3.2.6 User interface entry data source
      3. 3.3 Using APIs to send data into the system
        1. 3.3.1 API overview
        2. 3.3.2 Sending data items using the API
      4. 3.4 Extension points
        1. 3.4.1 External service URL data sources
        2. 3.4.2 Extension properties in the resource definition
      5. 3.5 Troubleshooting data sources
        1. 3.5.1 Data items do not reach data source target table in the system database
        2. 3.5.2 Data stops to be imported after a database failure
        3. 3.5.3 Things to check if data items are not displayed on the map
    7. Chapter 4. Tracking key performance indicators
      1. 4.1 Overview
        1. 4.1.1 Terminology
        2. 4.1.2 IBM Intelligent Operations Center capabilities
        3. 4.1.3 Types of KPIs
        4. 4.1.4 Tooling choices
      2. 4.2 Use case overview
        1. 4.2.1 Actors
        2. 4.2.2 Desired outcome
        3. 4.2.3 IBM Intelligent Operations Center programming artifacts
      3. 4.3 Setting up the development environment
      4. 4.4 Implementation summary
      5. 4.5 Implementation details
        1. 4.5.1 Identifying input data
        2. 4.5.2 Defining the monitor model
        3. 4.5.3 Creating the KPI
        4. 4.5.4 Establishing KPI relationships
        5. 4.5.5 Visualizing the new KPI
      6. 4.6 Problem determination
        1. 4.6.1 IBM Intelligent Operations Center configuration
        2. 4.6.2 IBM Business Monitor configuration
        3. 4.6.3 IBM Business Monitor credentials
        4. 4.6.4 IBM Business Monitor SSL certificates
        5. 4.6.5 Message routing
      7. 4.7 Programmatic access to KPIs
      8. 4.8 Additional considerations
        1. 4.8.1 Tips and good practices
        2. 4.8.2 Performance considerations
    8. Chapter 5. Driving standard operating procedures
      1. 5.1 Managing SOPs in IBM Intelligent Operations Center
        1. 5.1.1 Roles and permissions
        2. 5.1.2 Configuring SOP definitions
        3. 5.1.3 Editing definitions
        4. 5.1.4 Working with drafts and submitting for approval
        5. 5.1.5 Approving or disapproving drafts
        6. 5.1.6 Launching SOPs
        7. 5.1.7 Viewing SOP instances
        8. 5.1.8 Reverting to a specific version
        9. 5.1.9 Exporting and importing SOPs
      2. 5.2 Configuring activities for different scenarios
        1. 5.2.1 Configuring activities to execute sequentially
        2. 5.2.2 Configuring required activities
        3. 5.2.3 Configuring manual activities
        4. 5.2.4 Configuring automation activities
        5. 5.2.5 Configuring If-Then-Else activities
        6. 5.2.6 Configuring notification activities
        7. 5.2.7 Configuring REST service activities
        8. 5.2.8 Configuring SOP activities
      3. 5.3 SOP REST service
        1. 5.3.1 Retrieving all SOP definitions
        2. 5.3.2 Retrieving an SOP definition
        3. 5.3.3 Retrieving activity definitions
        4. 5.3.4 Working with SOP instances
        5. 5.3.5 Working with activity instances
        6. 5.3.6 Using REST services to analyze the historical executions of an SOP
      4. 5.4 Use case overview
        1. 5.4.1 Actors
        2. 5.4.2 Desired outcome
        3. 5.4.3 IBM Intelligent Operations Center programming artifacts
      5. 5.5 Manage event SOP
        1. 5.5.1 Implementation summary
        2. 5.5.2 Implementation details
        3. 5.5.3 Querying SOP instance data
      6. 5.6 Manage crowd incident SOP
        1. 5.6.1 Implementation summary
        2. 5.6.2 Implementation details
    9. Chapter 6. Customizing the operations display
      1. 6.1 User interface customization overview
        1. 6.1.1 Content panel customization
        2. 6.1.2 Creating custom data source actions
        3. 6.1.3 Adding custom filter-driven results charts
        4. 6.1.4 Customizing preview cards
        5. 6.1.5 Creating custom portlets
        6. 6.1.6 Adding custom help links
        7. 6.1.7 Customizing the More Actions menu
        8. 6.1.8 Creating custom portal pages
      2. 6.2 Customizing the content panel
        1. 6.2.1 Implementation summary
        2. 6.2.2 Setting up the development environment
        3. 6.2.3 Implementation details
      3. 6.3 Creating custom data source actions
        1. 6.3.1 Implementation summary
        2. 6.3.2 Setting up the development environment
        3. 6.3.3 Implementation details
        4. 6.3.4 Visualizing the results
      4. 6.4 Adding filter-driven result charts
        1. 6.4.1 Custom filter-driven result chart creation example
      5. 6.5 Customizing preview cards
        1. 6.5.1 Implementation summary
        2. 6.5.2 Setting up the development environment
        3. 6.5.3 Implementation details
      6. 6.6 Creating custom portlets
        1. 6.6.1 Custom portlet development environment
        2. 6.6.2 Deploying custom portlets
        3. 6.6.3 Using RestStore
        4. 6.6.4 Using the translation widget and internationalization service
      7. 6.7 Adding custom help links
        1. 6.7.1 Adding an Eclipse plug-in with custom help articles
        2. 6.7.2 Creating a new Help menu item and adding it to the Help menu
      8. 6.8 Customizing the More Actions menu
      9. 6.9 Creating custom solution pages
        1. 6.9.1 IBM Intelligent Operations Center solution themes
        2. 6.9.2 Creating custom portal pages
        3. 6.9.3 Change the city name on the top of the user interface
        4. 6.9.4 Customizing titles and IBM logos in IBM Intelligent Operations Center
    10. Chapter 7. Visualizing information with maps
      1. 7.1 GIS terminology
        1. 7.1.1 Generic GIS terminology
        2. 7.1.2 GIS terminology specific to IBM Intelligent Operations Center
      2. 7.2 Creating maps
        1. 7.2.1 Creating a base map
        2. 7.2.2 Creating location maps
        3. 7.2.3 Configuring map settings
        4. 7.2.4 Map extension points
      3. 7.3 Use case overview
        1. 7.3.1 Actors
        2. 7.3.2 Desired outcome
        3. 7.3.3 IBM Intelligent Operations Center programming artifacts
      4. 7.4 Implementation summary
      5. 7.5 Implementation details
        1. 7.5.1 Adding data sources
        2. 7.5.2 Creating emergency events
        3. 7.5.3 Finding nearby medical units
    11. Chapter 8. Developing mobile applications
      1. 8.1 Technology overview
        1. 8.1.1 IBM Intelligent Operations Center REST services
        2. 8.1.2 IBM Worklight
      2. 8.2 Use case overview
        1. 8.2.1 Actors
        2. 8.2.2 Desired outcome
        3. 8.2.3 IBM Intelligent Operations Center programming artifacts
      3. 8.3 Implementation summary
        1. 8.3.1 Setting up the development environment
      4. 8.4 Implementation details
        1. 8.4.1 Creating a new IBM Worklight project
        2. 8.4.2 Building the IBM Worklight adapters
      5. 8.5 Deploying the artifacts
        1. 8.5.1 Building and deploying mobile devices
        2. 8.5.2 Deploying server-side components
      6. 8.6 Visualizing the results
    12. Chapter 9. Integrating with external systems
      1. 9.1 Overview
      2. 9.2 Integration with IBM SmartCloud Control Desk through SOP automation activity
        1. 9.2.1 Actors
        2. 9.2.2 Desired outcome
        3. 9.2.3 IBM Intelligent Operations Center programming artifacts
        4. 9.2.4 Implementation summary
        5. 9.2.5 Implementation details
        6. 9.2.6 Verify IBM SmartCloud Control Desk settings for web service access
        7. 9.2.7 Create the SOP to trigger the job plan through automation activity
      3. 9.3 Integration through REST service activity
      4. 9.4 Routing data to the integration topic
        1. 9.4.1 Desired outcome
        2. 9.4.2 IBM Intelligent Operations Center programming artifacts
        3. 9.4.3 Implementation summary
        4. 9.4.4 Implementation details
      5. 9.5 Using an external service URL
        1. 9.5.1 Custom service requirements
        2. 9.5.2 Adding an external service URL
      6. 9.6 Other options for integration
    13. Chapter 10. Creating and viewing reports
      1. 10.1 Cognos reports versus Dojo charts
      2. 10.2 Use case overview
        1. 10.2.1 Actors
        2. 10.2.2 Desired outcome
        3. 10.2.3 IBM Intelligent Operations Center programming artifacts
      3. 10.3 Setting up the development environment
      4. 10.4 Implementation summary
      5. 10.5 Implementation details
        1. 10.5.1 Verify the prerequisite configuration
        2. 10.5.2 Determine the column names from the data source
        3. 10.5.3 Create the simple report
        4. 10.5.4 Create a report across multiple data sources
      6. 10.6 Deploying Cognos reports
      7. 10.7 Displaying Cognos reports
      8. 10.8 Problem determination
      9. 10.9 Additional considerations
    14. Appendix A. Development tools
      1. Development activities and tools
      2. Setting up IBM Rational Application Developer for WebSphere Software 8.5
      3. Installing and configuring IBM Cognos Framework Manager
    15. Appendix B. Samples provided with this book
      1. Extracting the samples compressed file
      2. Integrating with data sources samples
      3. Integrating with external systems samples
      4. Developing mobile application samples
      5. IBM Intelligent Operations Center programming model overview samples
      6. Customizing the operations display samples
      7. Key considerations for using Rational Application Developer
      8. Importing the sample projects into IBM Rational Application Developer workspace
    16. Appendix C. Additional material
      1. Locating the web material
      2. Using the web material
    17. Related publications
      1. IBM Redbooks
      2. Online resources
      3. Help from IBM
    18. Back cover
    19. IBM System x Reference Architecture for Hadoop: IBM InfoSphere BigInsights Reference Architecture
      1. Introduction
      2. Business problem and business value
      3. Reference architecture use
      4. Requirements
      5. InfoSphere BigInsights predefined configuration
      6. InfoSphere BigInsights HBase predefined configuration
      7. Deployment considerations
      8. Customizing the predefined configurations
      9. Predefined configuration bill of materials
      10. References
      11. The team who wrote this paper
      12. Now you can become a published author, too!
      13. Stay connected to IBM Redbooks
    20. Notices
      1. Trademarks