Installing IBM InfoSphere Information Governance Catalog for Eclipse

InfoSphere® Information Governance Catalog for Eclipse provides an Eclipse plug-in component so that you can access business glossary content directly from Eclipse-based applications.

Before you begin

Make sure that your system meets requirements. See system requirements.

The version of InfoSphere Information Governance Catalog for Eclipse must be the same as the version of IBM® InfoSphere Information Governance Catalog on the InfoSphere Information Server host that you connect to. If the versions are different, the business glossary content fails to download.

If you are working with Eclipse applications other than IBM InfoSphere Data Architect or a Rational® Software Architect product, make sure that your Eclipse application is set up to automatically install publicly available Eclipse components. These Eclipse components are provided with InfoSphere Data Architect and Rational Software Architect products. If your installation of Eclipse does not include them, you might need to update the Eclipse plug-ins that correspond to your version of Eclipse. You must follow different steps depending on the version of Eclipse that is installed.

About this task

The installation file, BGE_ALL_11_5.zip, is on the software media.

You can install InfoSphere Information Governance Catalog for Eclipse from either of the following locations:
Web update site
When you install InfoSphere Information Governance Catalog, a web update site with the InfoSphere Information Governance Catalog for Eclipse installation files is created. The web update site for BGE_ALL_11_5.zip is https://host_server:port/ibm/iis/igc/bge/update.
Archive update site
Copy the installation file that you need from the software media to a directory on your hard disk. The archive update site is that directory.
Tip: If you are an administrator who provides the client to multiple users, copy the file to a shared directory that can be accessed by all users.

The client consists of the Eclipse features that are described in the following table. Depending on your needs, you can install all of the features or a subset of them.
Feature name Description Feature dependencies Can be installed into these products
IBM InfoSphere Information Governance Catalog Core Users can view business glossary from within their Eclipse-based application. The feature also includes the InfoSphere Information Governance Catalog for Eclipse Core API. None
  • IBM InfoSphere Data Architect
  • IBM Rational Software Architect
  • IBM InfoSphere Warehouse
IBM InfoSphere Information Governance Catalog UML Profile Users can apply the Business Glossary profile to their UML model and to view preexisting term assignments. The feature also includes the InfoSphere Information Governance Catalog for Eclipse UML Profile API. None Rational Software Architect
IBM InfoSphere Information Governance Catalog UML Integration Users can incorporate term information into UML model elements, including assigning terms to model elements.
  • InfoSphere Information Governance Catalog Core
  • InfoSphere Information Governance Catalog UML Profile
Rational Software Architect
IBM InfoSphere Information Governance Catalog Data Model Integration Users can incorporate term information into logical and physical data model elements, including assigning terms to model elements.
  • InfoSphere Information Governance Catalog Core
  • InfoSphere Information Governance Catalog UML Profile
InfoSphere Data Architect
IBM InfoSphere Information Governance Catalog Physical Model Integration Users can incorporate term information and can assign terms to physical data model elements. InfoSphere Information Governance Catalog Core
  • InfoSphere Data Architect
  • InfoSphere Warehouse
IBM InfoSphere Information Governance Catalog Business Process Model Integration Users can define the process workflow for users, create logic inside a business process, and integrate with other applications and data sources. InfoSphere Information Governance Catalog Core Rational Software Architect

Procedure

  1. Start the Eclipse application as an Administrator in Microsoft Windows.
    If the Eclipse application is started by a user with a non-administrator role, the InfoSphere Information Governance Catalog for Eclipse might not get installed correctly into the Eclipse application.
  2. Configure Eclipse to update publicly available components. Do the following steps, based on the Eclipse version:
    Eclipse 3.4.2
    1. Click Help > Software Updates.
    2. Click the Available Software tab.
    3. Click Manage Sites. Make sure that the Ganymede Update Site is in the list of Available Software Sites, and selected. If the Ganymede Update Site is not in the list, click Add and enter http://download.eclipse.org/releases/ganymede in the Location field.
    4. Click OK.
    Eclipse 3.5.1
    1. Click Help > Install New Software.
    2. Click the Available Software Sites hyperlink. Make sure that the Galileo Update Site is in the list of Available Software Sites and is enabled. If the Galileo Update Site is not in the list, click Add and enter http://download.eclipse.org/releases/galileo in the Location field.
    3. Click OK.
    4. Make sure that Contact all update sites during install to find required software is checked.
  3. Add the InfoSphere Information Governance Catalog for Eclipse update site.
    1. For Eclipse version 3.4.2, click Help > Software Updates > Add Site.

      Alternatively, for Eclipse version 3.5.1, click Help > Install New Software > Add.

    2. Install either from the web update site or from the archive update site.
      Install from the web update site
      1. In the Add Site window, type the installation URL: http://host_server:9080/ibm/iis/igc/bge/update
        host_server
        If your installation has separate front-end dispatcher, use the host name of the front-end dispatcher.
        If your installation does not have a separate front-end dispatcher, use the host name of the services tier computer.
      2. Click OK.
      Install from the archive update site
      1. In the Add Site window, click Archive.
      2. Navigate to the installation file in the archive update site. Click OK.

        The InfoSphere Information Governance Catalog for Eclipse features are added to the list of available software.

    3. Navigate to the site that you added and expand the contents. Select the check boxes for each of the dependent features you want to install.
      For details about feature dependencies, see the Feature dependencies column in the table.

      If you use Eclipse 3.5.1, make sure that Group items by category check box is not selected.

    4. Click Install.
      Follow the remaining prompts to finish the installation.
  4. The first time that you connect to the server, if the certificate from the server is not trusted, a message about HTTPS might be displayed. If you receive such a message, then you must install a security certificate by following these steps:
    1. Open Microsoft Windows Internet Explorer. In the address field, type the connection information to connect to InfoSphere Information Governance Catalog.
      Use the format: https://host_server:port/ibm/iis/igc/
      host_server
      If your installation has a separate front-end dispatcher, use the host name of the front-end dispatcher.
      If your installation does not have a separate front-end dispatcher, use the host name of the services tier computer.
      port
      If your installation has a separate front-end dispatcher, use the HTTPS port of the front-end dispatcher.
      If your installation does not have a separate front-end dispatcher, use the WebSphere® Application Server secure transport port (HTTPS).
      Note: The following steps describe the procedure to follow with Windows Internet Explorer. Internet Explorer versions might require slightly different steps.
    2. On the page that warns you about a problem with the security certificate, click Continue to this website (Not recommended).
    3. Click Certificate Error at the top of the window, then click View certificates.
    4. Click the Details tab.
    5. Click Copy to File and then click Next.
    6. Select Base-64 encoded X.509 (.CER) and then click Next.
    7. Store the certificate in any directory and then click Finish.
      The certificate name with its full directory path is needed in a later step.
    8. In a command prompt window, go to the directory of the JRE binary that is associated with the Eclipse application such as InfoSphere Data Architect or IBM Rational Software Architect.
      An example of the directory might be C:\Program Files\IBM\SDP\jdk\jre\bin.
    9. Run the command:

      keytool -import -v -file "certificate_name" -keystore ..\lib\security\cacerts

      The file certificate_name is the certificate name with its full directory path. You must enclose the file in quotation marks (").

      An example of the command might be
      keytool -import -v -file "C:\SSL\bge_certificate" -keystore ..\lib\security\cacerts
      The keystore utility accesses the certificate and prepares to import it. Enter the following information:
      1. At the Enter keystore password prompt, type changeit.
      2. At the Trust this certificate prompt, type Y.
      The certificate is installed and added to the keystore.

What to do next

Validate that InfoSphere Information Governance Catalog for Eclipse is installed, and then configure the client to connect to InfoSphere Information Governance Catalog.

To validate that the InfoSphere Information Governance Catalog for Eclipse is installed:

  1. Start your Eclipse application.
  2. From the menu bar, select Window > Preferences to see the list of available Preference page titles.
  3. Check that Business Glossary is one of the Preference page titles that are listed in the left pane. If it is visible, then InfoSphere Information Governance Catalog for Eclipse was installed.
To connect to InfoSphere Information Governance Catalog:
  1. Start your Eclipse application if it is not already started.
  2. From the menu bar, select Window > Preferences to see the list of available Preference page titles.
  3. From the list of Preference page titles, click Business Glossary.
  4. Press F1 or click the Help icon ? to display the online help for the connection settings page.
  5. Follow the instructions in the online help to fill out the connection settings.

To learn how to use the client, review the documentation by clicking Help > Help Contents > IBM InfoSphere Information Governance Catalog for Eclipse > Overview.