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
-
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.
- Configure Eclipse to update publicly available components.
Do the following steps, based on the Eclipse version:
- Eclipse 3.4.2
- Click .
- Click the Available Software tab.
- 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.
- Click OK.
- Eclipse 3.5.1
- Click .
- 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.
- Click OK.
- Make sure that Contact all update sites during install
to find required software is checked.
- Add the InfoSphere Information Governance Catalog for Eclipse update
site.
- For Eclipse version 3.4.2, click .
Alternatively, for Eclipse version
3.5.1, click .
- Install either from the web update site or from the
archive update site.
- Install from the web update site
- 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.
- Click OK.
- Install from the archive update site
- In the Add Site window, click Archive.
- 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.
- 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.
- Click Install.
Follow
the remaining prompts to finish the installation.
-
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:
- 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.
- On the page that warns you about a problem with the
security certificate, click Continue to this website (Not
recommended).
- Click Certificate Error at the
top of the window, then click View certificates.
- Click the Details tab.
- Click Copy to File and then click Next.
- Select Base-64 encoded X.509 (.CER) and
then click Next.
- Store the certificate in any directory and then click Finish.
The certificate name with its full directory path is needed
in a later step.
- 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.
- 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:
- At the Enter keystore password prompt,
type changeit.
- 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:
- Start your Eclipse application.
- From the menu bar, select to see the list
of available Preference page titles.
- 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:
- Start your Eclipse application if it is not already started.
- From the menu bar, select to see the list
of available Preference page titles.
- From the list of Preference page titles, click Business
Glossary.
- Press F1 or click the Help icon ? to
display the online help for the connection settings page.
- 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 .