IBM Dashboard Application Services Hub integration IBM SmartCloud Application Performance Management UI
by user
Comments
Transcript
IBM Dashboard Application Services Hub integration IBM SmartCloud Application Performance Management UI
IBM SmartCloud Application Performance Management UI Version 7.7 IBM Dashboard Application Services Hub integration IBM SmartCloud Application Performance Management UI Version 7.7 IBM Dashboard Application Services Hub integration Note Before you use this information and the product it supports, read the information in “Notices” on page 15. This edition applies to version 7.7 of the IBM SmartCloud Application Performance Management UI and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright IBM Corporation 2013. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Chapter 1. About this publication . . . . 1 Intended audience . . . . . . . . . Publications . . . . . . . . . . . IBM SmartCloud Application Performance Management UI library . . . . . . . Related publications . . . . . . . . Accessing terminology online . . . . . Ordering publications . . . . . . . Accessibility . . . . . . . . . . . Tivoli technical training. . . . . . . . Tivoli user groups . . . . . . . . . Support information . . . . . . . . . Conventions used in this publication . . . Typeface conventions . . . . . . . Variables and paths that are dependent on operating system . . . . . . . . . © Copyright IBM Corp. 2013 . . . . . . . . . . . . . . . . . . . . . . . . your . . . 1 . 1 . . . . . . . . . . 1 1 2 2 3 3 3 3 4 4 . 5 Chapter 2. IBM Dashboard Application Services Hub integration . . . . . . . 7 Setting up Single Sign-On domain . . . . . . . 7 Configuring SSL key and LTPA key. . . . . . . 8 Configuring the authorization realm and the roles of the administrative user . . . . . . . . . . . 9 Integrating SmartCloud Application Performance Management UI in the IBM Dashboard Application Services Hub console . . . . . . . . . . . 10 Accessibility . . . . . . . . . . . . 13 Notices . . . . . . . . . . . . . . 15 Privacy policy considerations Trademarks . . . . . . . . . . . . . . . . . . . . . 17 . 17 iii iv IBM SmartCloud Application Performance Management UI: IBM Dashboard Application Services Hub integration Chapter 1. About this publication Use this publication to learn more about IBM SmartCloud® Application Performance Management UI Version 7.7. Intended audience This publication is for administrators and system programmers who use IBM SmartCloud Application Performance Management UI. Readers must be familiar with the following products: v IBM® Tivoli® Monitoring v IBM Tivoli Composite Application Manager for Applications v IBM Tivoli Composite Application Manager for Microsoft Applications v IBM Tivoli Composite Application Manager for Transactions Publications This section lists publications in the IBM SmartCloud Application Performance Management UI library and related documents. This section also describes how to access Tivoli publications online and how to order Tivoli publications. IBM SmartCloud Application Performance Management UI library The following documents are available in the IBM SmartCloud Application Performance Management UI library: v IBM SmartCloud Application Performance Management UI Version 7.7, User's Guide SC22-5490 Provides information about how to install, configure, and use the SmartCloud Application Performance Management UI component. Related publications The following documents also provide useful information: v IBM SmartCloud Application Performance Management, Standard Edition Offering Guide, SC22-5488 Provides general information about the component products of IBM SmartCloud Application Performance Management, Standard Edition. v IBM SmartCloud Application Performance Management, Standard Edition Quick Start Guide, CF3YPML Provides information about typical installation of IBM SmartCloud Application Performance Management, Standard Edition. v IBM SmartCloud Application Performance Management, Entry Edition Offering Guide, SC27-6201 Provides general information about the component products of IBM SmartCloud Application Performance Management, Entry Edition. v IBM SmartCloud Application Performance Management, Entry Edition Quick Start Guide, CF3YQML © Copyright IBM Corp. 2013 1 Provides information about typical installation of IBM SmartCloud Application Performance Management, Entry Edition. v IBM SmartCloud Application Performance Management Entry Edition - VM Image, Installation and Deployment Guide, SC27-5334 Provides information about how to install and deploy IBM SmartCloud Application Performance Management Entry Edition - VM Image, and how to use it to monitor your IBM business integration systems. v IBM SmartCloud Application Performance Management Entry Edition - VM Image, Offering Guide, SC22-5489 Provides general information about the component products of IBM SmartCloud Application Performance Management Entry Edition - VM Image. v IBM SmartCloud Application Performance Management Entry Edition - VM Image, Quick Start Guide, CF3P5ML Provides information about typical installation of IBM SmartCloud Application Performance Management Entry Edition - VM Image. The following documents are available from the IBM SmartCloud Application Performance Management wiki (https://www.ibm.com/developerworks/ community/groups/service/html/communityview?communityUuid=0587adbc8477-431f-8c689226adea11ed#fullpageWidgetId=W42ce7c6afdb9_42c2_a9ea_e1ba310bea8c). You can also find these documents in the Files section of the Application Performance Management developerWorks® community (https://www.ibm.com/ developerworks/community/groups/service/html/ communityview?communityUuid=0587adbc-8477-431f-8c689226adea11ed#fullpageWidgetId=W42ce7c6afdb9_42c2_a9ea_e1ba310bea8c): v IBM SmartCloud Application Performance Management UI Troubleshooting Reference, SC22-5490-01-T Provides general troubleshooting information for the IBM SmartCloud Application Performance Management UI component. v IBM SmartCloud Application Performance Management UI Reference, SC22-5490-01-R Provides reference information for the IBM SmartCloud Application Performance Management UI component. v IBM SmartCloud Application Performance Management Entry Edition - VM Image Reference, SC27-5334-01-R Provides reference information for the IBM SmartCloud Application Performance Management Entry Edition - VM Image product. Accessing terminology online The IBM Terminology website consolidates the terminology from IBM product libraries in one convenient location. You can access the Terminology website at http://www.ibm.com/software/globalization/terminology Ordering publications You can order many Tivoli publications online at http:// www.elink.ibmlink.ibm.com/publications/servlet/pbi.wss. You can also order by telephone by calling one of these numbers: v In the United States: 800-879-2755 v In Canada: 800-426-4968 2 IBM SmartCloud Application Performance Management UI: IBM Dashboard Application Services Hub integration In other countries, contact your software account representative to order Tivoli publications. To locate the telephone number of your local representative, perform the following steps: 1. Go to http://www.elink.ibmlink.ibm.com/publications/servlet/pbi.wss. 2. Select your country from the list and click Go. 3. Click About this site in the main panel to see an information page that includes the telephone number of your local representative. Accessibility Accessibility features help users with a physical disability, such as restricted mobility or limited vision, to use software products successfully. With this product, you can use assistive technologies to hear and navigate the interface. You can also use the keyboard instead of the mouse to operate all features of the graphical user interface. For more information about accessibility, see the Accessibility Appendix and the accessibility section in the overview chapter of theIBM SmartCloud Application Performance Management UI, User's Guide. Tivoli technical training For Tivoli technical training information, see the following IBM Tivoli Education website at http://www.ibm.com/software/tivoli/education. Tivoli user groups Tivoli user groups are independent, user-run membership organizations that provide Tivoli users with information to assist them in the implementation of Tivoli Software solutions. Through these groups, members can share information and learn from the knowledge and experience of other Tivoli users. Tivoli user groups include the following members and groups: v 23,000+ members v 144+ groups Access the link for the Tivoli Users Group at www.tivoli-ug.org. Support information If you have a problem with your IBM software, you want to resolve it quickly. IBM provides the following ways for you to obtain the support you need: Online Access the IBM Software Support site at http://www.ibm.com/software/ support/probsub.html . IBM Support Assistant The IBM Support Assistant is a free local software serviceability workbench that helps you resolve questions and problems with IBM software products. The Support Assistant provides quick access to support-related information and serviceability tools for problem determination. To install the Support Assistant software, go to http://www.ibm.com/software/ support/isa. Troubleshooting For more information about resolving problems, see the IBM SmartCloud Chapter 1. About this publication 3 Application Performance Management UI wiki at https://www.ibm.com/ developerworks/community/wikis/home?lang=en#!/wiki/IBM %20SmartCloud%20Application%20Performance%20Management/page/SC %20APM%20UI. A troubleshooting guide is also available from the Files section of the Application Performance Management developerWorks community:https://www.ibm.com/developerworks/community/groups/ service/html/communityview?communityUuid=0587adbc-8477-431f-8c689226adea11ed#fullpageWidgetId=W42ce7c6afdb9_42c2_a9ea_e1ba310bea8c Conventions used in this publication Several conventions are used in this publication for special terms, actions, commands, and paths that are dependent on your operating system Typeface conventions This publication uses the following typeface conventions: Bold v Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text v Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip:, and Operating system considerations:) v Keywords and parameters in text Italic v Citations (examples: titles of publications, diskettes, and CDs v Words that are defined in text (example: a nonswitched line is called a point-to-point line) v Emphasis of words and letters (words as words example: "Use the word that to introduce a restrictive clause."; letters as letters example: "The LUN address must start with the letter L.") v New terms in text (except in a definition list): a view is a frame in a workspace that contains data. v Variables and values you must provide: ... where myname represents.... Monospace v Examples and code examples v File names, programming keywords, and other elements that are difficult to distinguish from surrounding text v Message text and prompts addressed to the user v Text that the user must type v Values for arguments or command options Bold monospace v Command names, and names of macros and utilities that you can type as commands v Environment variable names in text v Keywords v Parameter names in text: API structure parameters, command parameters and arguments, and configuration parameters v Process names 4 IBM SmartCloud Application Performance Management UI: IBM Dashboard Application Services Hub integration v Registry variable names in text v Script names Variables and paths that are dependent on your operating system This publication uses the UNIX convention for specifying environment variables and for directory notation. When you use the Windows command line, replace $variable with % variable% for environment variables and replace each forward slash (/) with a backslash (\) in directory paths. The names of environment variables are not always the same in the Windows and UNIX environments. For example, %TEMP% in Windows environments is equivalent to $TMPDIR in UNIX environments. Note: If you are using the bash shell on a Windows system, you can use the UNIX conventions. Chapter 1. About this publication 5 6 IBM SmartCloud Application Performance Management UI: IBM Dashboard Application Services Hub integration Chapter 2. IBM Dashboard Application Services Hub integration IBM SmartCloud Application Performance Management UI can be integrated with IBM Dashboard Application Services Hub version 3.2.0.2 or later. After integration, you can start SmartCloud Application Performance Management UI tasks in IBM Dashboard Application Services Hub console. Before you begin For the integration to work properly, you must have Single Sign-On (SSO) configured on both servers and use the same user repository. Ensure that the SSO domain names are the same on both servers, and that the domain name has at least two dots. Note: Ensure that the time difference between the server that is hosting IBM Dashboard Application Services Hub and the server that is hosting SmartCloud Application Performance Management UI is smaller than the Timeout value for forwarded credentials between servers configured in Lightweight Third Party Authentication. For more information about this timeout value, see Configuring the Lightweight Third Party Authentication mechanism (http://pic.dhe.ibm.com/ infocenter/wasinfo/v6r1/index.jsp?topic=%2Fcom.ibm.websphere.express.doc %2Finfo%2Fexp%2Fae%2Ftsec_ltpa.html). About this task Complete the following tasks to integrate SmartCloud Application Performance Management UI with IBM Dashboard Application Services Hub. 1. Configuring SSL key and LTPA key 2. Setting up Single Sign-On domain 3. Configuring the authorization realm and the roles of the administrative user. 4. Integrating SmartCloud Application Performance Management UI in IBM Dashboard Application Services Hub console. (http://pic.dhe.ibm.com/infocenter/tivihelp/v3r1/topic/ com.ibm.psc.doc_1.1.0.2/psc_ic-homepage.html) Visit the information center for more information about Jazz for Service Management. (http://www.ibm.com/support/docview.wss?uid=swg24035741) View the read me file on Fix Central for instructions on how to download Jazz for Service Management, which includes Dashboard Application Services Hub. Setting up Single Sign-On domain Set up the same Single Sign-On domain for both SmartCloud Application Performance Management UI and IBM Dashboard Application Services Hub. Before you begin Ensure that SmartCloud Application Performance Management UI uses the same domain as IBM Dashboard Application Services Hub. © Copyright IBM Corp. 2013 7 Procedure 1. Log in to IBM Dashboard Application Services Hub with the administrative user. The default administrative user is tipadmin. 2. Click the settings icon and click WebSphere Administrative Console. In the WebSphere Administrative Console tab, click Launch WebSphere administrative console to open WebSphere Integrated Solutions Console. 3. Go to Security > Global Security > Web Security > Single sign-on (SSO). Enable SSO and specify the domain name. 4. Restart IBM Dashboard Application Services Hub server for the changes to take effect. Results The SSO domain is configured for both SmartCloud Application Performance Management UI and IBM Dashboard Application Services Hub. Configuring SSL key and LTPA key Configure the SSL key in IBM Dashboard Application Services Hub. Also export IBM Dashboard Application Services Hub LTPA key and import it into SmartCloud Application Performance Management UI for the integration to work properly. Procedure 1. Log in to IBM Dashboard Application Services Hub with the administrative user. The default administrative user is tipadmin. 2. Click the settings icon and clickWebSphere Administrative Console. In the WebSphere Administrative Console tab, click Launch WebSphere administrative console to open WebSphere Integrated Solutions Console. 3. Click Security and then SSL certificate and key management. On the right panel, click Key stores and certificates link, and then click NodeDefaultTrustStore. 4. Under Additional Properties, click Signer certificates link, and then click Retrieve from port. 5. Specify the fully qualified server name of the SmartCloud Application Performance Management UI server in Host field, the port number of SmartCloud Application Performance Management UI in Port field. Specify a name in Alias field. 6. Ensure the SmartCloud Application Performance Management UI server is running, and click Retrieve signer information. 7. Verify the certificate information and click Apply. 8. Go to Security and then Global Security. On the right panel, click the LTPA link. 9. Specify the password and Fully qualified key file name . Click Export keys to export the key. 10. On SmartCloud Application Performance Management UI server, run one of the following commands to stop the SmartCloud Application Performance Management UI server. v On a Linux system APMUI_home/bin/ server stop apmui v On a Windows system 8 IBM SmartCloud Application Performance Management UI: IBM Dashboard Application Services Hub integration APMUI_home\bin\ server stop apmui Where APMUI_home is the installation path of SmartCloud Application Performance Management UI. 11. Copy the exported key file to the SmartCloud Application Performance Management UI server. Put the key file in APMUI_home\usr\servers\apmui\ resources\security on Windows systems, or in APMUI_home/usr/servers/ apmui/resources/security on Linux systems. 12. Back up the existing key file first and then delete the existing key file. Rename the new key file that you copy from IBM Dashboard Application Services Hub server as ltpa.keys. 13. Modify the APMUI_home\usr\servers\apmui\server.xml file on Windows systems, or the APMUI_home/usr/servers/apmui/server.xml file on Linux systems. Add the line <ltpa keysPassword="" /> according to the following example, and specify a value for parameter keysPassword. <httpSession invalidateOnUnauthorizedSessionRequestException="true"/> <ltpa keysPassword="" /> Note: The value of keysPassword must be the password that you specify for exporting LTPA key. This password can be encoded with the SecurityUtility tool in the APMUI_home/bin directory. For more information about the SecurityUtility tool, see the Configuring role-based authorization section of the SmartCloud Application Performance Management UI User's Guide. 14. Start SmartCloud Application Performance Management UI for the changes to take effect. v On a Linux system APMUI_home/bin/ server start apmui v On a Windows system APMUI_home\bin\ server start apmui Results The SSL key and LTPA key are properly configured. Configuring the authorization realm and the roles of the administrative user Configure SmartCloud Application Performance Management UI to use the same realm as IBM Dashboard Application Services Hub. Add the administrative user of IBM Dashboard Application Services Hub into SmartCloud Application Performance Management UI roles. Procedure 1. On the SmartCloud Application Performance Management UI server, modify the user and role. v For basic registry users, a. Modify the APMUI_home\usr\servers\apmui\basicRegistry.xml file on Windows systems, or the APMUI_home/usr/servers/apmui/ basicRegistry.xml file on Linux systems. Change the value of realm to the same realm name as IBM Dashboard Application Services Hub. By default the realm of IBM Dashboard Application Services Hub is Chapter 2. IBM Dashboard Application Services Hub integration 9 defaultWimFileBasedRealm. Add the administrative user of IBM Dashboard Application Services Hub to the basicRegistry element. If the administrative user is not tipadmin, change the uid value to the administrative user name, and change the password accordingly. See the following example. <basicRegistry id="basic" realm="defaultWimFileBasedRealm"> <user name="uid=tipadmin,o=defaultWIMFileBasedRealm" password="tippass" /> </basicRegistry> b. Modify the APMUI_home\usr\servers\apmui\server.xml file on Windows systems, or the APMUI_home/usr/servers/apmui/server.xml file on Linux systems. Add the IBM Dashboard Application Services Hub administrative user to all roles in SmartCloud Application Performance Management UI. See the following example. <security-role name="ConsoleUser"> <user name="uid=tipadmin,o=defaultWIMFileBasedRealm" /> </security-role> <security-role name="tomcat"> <user name="uid=tipadmin,o=defaultWIMFileBasedRealm" /> </security-role> v For LDAP users, a. Modify the APMUI_home\usr\shared\config\ldapRegistry.xml file on Windows systems, or the APMUI_home/usr/shared/config/ ldapRegistry.xml file on Linux systems. Ensure that the realm name is the same as the realm of IBM Dashboard Application Services Hub. b. Modify the APMUI_home\usr\servers\apmui\server.xml file on Windows systems, or the APMUI_home/usr/servers/apmui/server.xml file on Linux systems. Add the IBM Dashboard Application Services Hub administrative user to all roles in SmartCloud Application Performance Management UI. See the following example. <security-role name="ConsoleUser"> <user name="uid=tipadmin,o=SampleLDAPRealm" /> </security-role> <security-role name="tomcat"> <user name="uid=tipadmin,o=SampleLDAPRealm" /> </security-role> 2. Save the changes and restart the SmartCloud Application Performance Management UI server for the changes to take effect. Results The authorization realm and the roles of the administrative user are configured. Integrating SmartCloud Application Performance Management UI in the IBM Dashboard Application Services Hub console You can integrate SmartCloud Application Performance Management UI with IBM Dashboard Application Services Hub and start SmartCloud Application Performance Management UI tasks in the IBM Dashboard Application Services Hub console. 10 IBM SmartCloud Application Performance Management UI: IBM Dashboard Application Services Hub integration About this task Note: You must use URLs with a fully qualified domain name that contains the SSO domain name when you access the IBM Dashboard Application Services Hub console or specify SmartCloud Application Performance Management UI URL in the Console Integration part. Procedure 1. Log in to IBM Dashboard Application Services Hub console with the administrative user. 2. Click the settings icon and go to Console Integration. 3. Click the New icon to start integration. 4. Give the new integration a name and specify the URL of SmartCloud Application Performance Management UI REST interface https:// APMUI_host:APMUI_port/rest. Where APMUI_host is the fully qualified server name of the server that is hosting SmartCloud Application Performance Management UI and APMUI_port is the port number of SmartCloud Application Performance Management UI 5. Click Test to check the connection status. 6. Click Save to create the integration. Results In the IBM Dashboard Application Services Hub navigation tree, a Console Integrations icon appears. All Console Integrations and their tasks are stored in here. You can click these integrated tasks and start the task inside the IBM Dashboard Application Services Hub content area. Chapter 2. IBM Dashboard Application Services Hub integration 11 12 IBM SmartCloud Application Performance Management UI: IBM Dashboard Application Services Hub integration Accessibility Accessibility features help users with physical disabilities, such as restricted mobility or limited vision, to use software products successfully. The major accessibility features in this product enable users in the following ways: v Use assistive technologies, such as screen-reader software and digital speech synthesizer, to hear what is displayed on the screen. Consult the product documentation of the assistive technology for details on using those technologies with this product. v Operate specific or equivalent features using only the keyboard. v Magnify what is displayed on the screen. In addition, the product documentation was modified to include the following features to aid accessibility: v All documentation is available in both HTML and convertible PDF formats to give the maximum opportunity for users to apply screen-reader software. v All images in the documentation are provided with alternative text so that users with vision impairments can understand the contents of the images. Navigating the interface using the keyboard Standard shortcut and accelerator keys are used by the product and are documented by the operating system. For more information, see the documentation that is provided by your operating system. Magnifying what is displayed on the screen You can enlarge information in the product windows with facilities that are provided by the operating systems on which the product is run. For example, in a Microsoft Windows environment, you can lower the resolution of the screen to enlarge the font sizes of the text on the screen. For more information, see the documentation that is provided by your operating system. © Copyright IBM Corp. 2013 13 14 IBM SmartCloud Application Performance Management UI: IBM Dashboard Application Services Hub integration Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement might not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. © Copyright IBM Corp. 2013 15 IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary. This information is for planning purposes only. The information herein is subject to change before the products described become available. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to 16 IBM SmartCloud Application Performance Management UI: IBM Dashboard Application Services Hub integration IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM‘s application programming interfaces. Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows: © IBM 2013. Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. 2013. All rights reserved. If you are viewing this information in softcopy form, the photographs and color illustrations might not be displayed. Privacy policy considerations IBM Software products, including software as a service solutions, (“Software Offerings”) may use cookies or other technologies to collect product usage information, to help improve the end user experience, to tailor interactions with the end user, or for other purposes. In many cases no personally identifiable information is collected by the Software Offerings. Some of our Software Offerings can help enable you to collect personally identifiable information. If this Software Offering uses cookies to collect personally identifiable information, specific information about this offering’s use of cookies is set forth below. Depending upon the configurations deployed, this Software Offering may use session cookies that collect each user’s name for purposes of session management, authentication, and single sign-on configuration. These cookies can be disabled, but disabling them will also likely eliminate the functionality they enable. If the configurations deployed for this Software Offering provide you as customer the ability to collect personally identifiable information from end users via cookies and other technologies, you should seek your own legal advice about any laws applicable to such data collection, including any requirements for notice and consent. For more information about the use of various technologies, including cookies, for these purposes, See IBM’s Privacy Policy at http://www.ibm.com/privacy and IBM’s Online Privacy Statement at http://www.ibm.com/privacy/details the section entitled “Cookies, Web Beacons and Other Technologies” and the “IBM Software Products and Software-as-a-Service Privacy Statement” at http://www.ibm.com/software/info/product-privacy. Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml. Notices 17 Intel, Intel logo, and Intel Xeon, are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Java™ and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others. 18 IBM SmartCloud Application Performance Management UI: IBM Dashboard Application Services Hub integration Printed in USA