Configuring console integration

Edit online

To display external content from the Cloud APM console in the Jazz® for Service Management Dashboard Application Services Hub console, configure a new console integration.

For more information about configuring a new console integration, see Configuring a new console integration in the Jazz for Service Management documentation.

Note:
  • Do not use the default console integration URL as described in the Jazz for Service Management documentation. Use the following console integration URL for Cloud APM: http://fully_qualified_APM_hostname:9443/rest
  • The Role Based Access Control page cannot be used when the Cloud APM console is accessed in the Dashboard Application Services Hub console.
  • The Synthetic Script Manager page cannot be used when the Cloud APM console is accessed in the Dashboard Application Services Hub console.
  • If the Dashboard Application Services Hub is using WebSphere Application Server 8.5 Fix Pack 14 or later and the existing Cloud APM console integration stops working or you are unable to configure a new one, then complete the following steps:
    1. Verify that you are getting these errors:
      DASH Console Integration Error
      Unable to connect to the remote console. Please check the console URL externally to ensure it works.
      Cloud APM UI Server Error (messages.log)
      CWWKO0801E: Unable to initialize SSL connection. Unauthorized access was denied or security settings have expired. Exception is javax.net.ssl.SSLHandshakeException: Client requested protocol TLSv1 not enabled or not supported
    2. Change the Dashboard Application Services Hub SSL configuration to use protocol TLSv1.2:
      1. Log in to the Dashboard Application Services Hub.
      2. In the navigation pane, click Console Settings > Websphere Administrative Console and click Launch Websphere administrative console.
      3. In the WebSphere administrative console navigation pane, click Security > SSL certificate and key management > SSL configurations > NodeDefaultSSLSettings > Quality of protection (QoP) settings, open the Protocol drop-down menu, and select TLSv1.2.
      4. Open the WAS_Install_Dir/JazzSM/profile/properties/ssl.client.prop file in a text editor, locate the com.ibm.ssl.protocol=SSL_TLS entry, and update it:
        com.ibm.ssl.protocol=TLSv1.2
      5. Restart the Dashboard Application Services Hub.
    3. Add the Cloud APM server signer certificates to the NodeDefaultTrustStore:
      1. Log in to the Dashboard Application Services Hub.
      2. In the navigation pane, click Console Settings > Websphere Administrative Console and click Launch Websphere administrative console.
      3. In the WebSphere administrative console navigation pane, click Security > SSL certificate and key management > Key stores and certificates > NodeDefaultTrustStore > Signer certificates > Retrieve from port and update the following fields.
        • Host is the fully qualified host name of the Cloud APM server (APMServer.domainname.com)
        • Port is 9443
        • Alias can be anything that you choose to represent the Cloud APM server that the certificate belongs to (APMServer.domainname.com_cert)
  • If your Cloud APM server has the IBM® Cloud Application Performance Management V8.1.4.0 interim fix 9, or a later server interim fix, you must set the DASH Console Integration Enabled field to True. For more information, see Advanced Configuration, category UI Integration.