Installing the Netcool Hybrid Deployment Option Integration Kit

The Netcool Hybrid Deployment Option Integration Kit is installed into an existing DASH installation, and then configured to communicate with the Agile Service Manager services. The kit is shipped as part of the nginx container and you obtain it via HTTP by pointing to your proxy service during the installation process (rather than downloading it as a separate part).

Before you begin

Remember: You must reinstall the Netcool Hybrid Deployment Option Integration Kit each time you reinstall or upgrade Agile Service Manager.
Note: Any tasks relating to Web GUI that are mentioned here only apply if you have Web GUI installed (which must be Tivoli Netcool/OMNIbus Web GUI Version 8.1.0.21 (or later)).
Note: Ensure that you have the correct versions of all required NOI product components installed.
You must complete the following prerequisites before you can install the Netcool Hybrid Deployment Option Integration Kit.
  1. Ensure that Agile Service Manager core has been installed and is running.
  2. Ensure that WebSphere Application Server Version 8.5.5.17 has been installed. Follow the IBM Documentation instructions here: https://www.ibm.com/support/knowledgecenter/SSAW57_8.5.5/com.ibm.websphere.nd.multiplatform.doc/ae/welcome_ndmp.html
  3. Ensure that WebSphere Application Server is running during the installation of the Netcool Hybrid Deployment Option Integration Kit.
  4. Ensure that a compatible version of the IBM WebSphere Java SDK has been installed (for example together with WebSphere Application Server Version 8.5.5.17), for example at least IBM WebSphere SDK Java Technology Edition Version 7.0. Follow the IBM Documentation instructions here: https://www.ibm.com/support/knowledgecenter/SSAW57_8.5.5/com.ibm.websphere.installation.nd.doc/ae/tins_installation_jdk7_gui.html
  5. Ensure that IBM Dashboard Application Service Hub (DASH) 3.1.3.18 or later has been installed. Follow the IBM Documentation instructions for installing Jazz for Service Management (Version 1.1.3.18) here: https://www.ibm.com/support/knowledgecenter/en/SSEKCU_1.1.3.0/com.ibm.psc.doc/install/psc_c_install.html
  6. Under the Repositories tab, configure the Installation Manager repository to point at the following URL https://<ASM_HOST>/im/repository/repository.xml.
  7. The IBM Installation Manager analyzes existing installations to determine defaults, which it then presents to you during installation. To verify these defaults and change them if necessary, ensure you have the required environment information about your installation and the DASH environment to hand.

About this task

You add the Netcool Hybrid Deployment Option Integration Kit to an existing DASH installation and configure the application to communicate with the previously installed application. You use the default client ID and secret.
Important: Ensure that you are logged in as the same user who installed DASH.
The steps for starting Installation Manager differ depending on the user mode in which it was installed. The steps for installing with the Installation Manager console are common to all user modes and operating systems. Take note of the following information about permissions on the supported operating systems:
  • The Installation Manager takes account of your current umask settings when it sets the permissions mode of the files and directories that it installs.
  • If you use Administrator mode or Nonadministrator mode and your umask is 0, Installation Manager uses a umask of 22.
  • If you use Group mode, Installation Manager ignores any group bits that are set and uses a umask of 2 if the resulting value is 0.
Note: It is recommended to use Install Manager Group Mode for installation.
Respond to each Installation configuration option to ensure it matches your pre-defined Installation Information Checklist.

Procedure

  1. Change to the /eclipse subdirectory of the Installation Manager Group installation directory and use the following command to start Installation Manager: 
    ./IBMIM
  2. From the Installation Manager Main Menu, select Preferences.
  3. In the Preferences menu, select Repositories.
  4. In the Repositories menu, select Add Repository.
  5. Enter the path to the repository file on the Agile Service Manager proxy, and click OK.
  6. In the main Installation Manager window, click Install for a fresh installation.
  7. Select the Hybrid Deployment Option Integration Kit package, and click Next.
  8. Complete the following installation steps:
    Tips:
    • The Hybrid Deployment Option Integration Kit is also used in other deployments, such as OCP/CNEA installations. If you encounter optional steps or terminology not specific to your Agile Service Manager deployment of the kit as documented here, you can ignore these.
    • Use the following client ID and secret:
      hdm-client-id

      hdm-client-secret
    1. On the Installation Manager Licenses tab, read and accept the license agreement, then click Next.
    2. Select the default location, then click Next.
      The installation process moves onto the Features tab, which displays your selected version of the Netcool Hybrid Deployment Option Integration Kit, as well as the features you can install.
    3. Select Jazz for Service Management, enter the required information for the WebSphere Application Server, then click Next.
    4. Select OAuth 2.0 Configuration, and set the Redirect URL to point to <ASM_HOST>/users/api/authprovider/v1/was/return, for example https://asm-host.ibm.com/users/api/authprovider/v1/was/return
    5. Click Install to complete the installation.
      The IBM Installation Manager installs the Netcool Hybrid Deployment Option Integration Kit into your existing DASH installation.
    6. Click Finish to exit the installer.
  9. Required: Restart DASH.

What to do next

Next, you configure DASH user roles to allow users to access Agile Service Manager.