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. You can check system requirements on the Software Product Compatibility Reports website. Search for InfoSphere Information Server, and specify
the product version.
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 might fail 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_3.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_3.zip is /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 |
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 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 |
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
|
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
|
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 |
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 |
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 if HTTPS is configured.
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 .