You can use a modifiable installation script to install
and configure the IBM® Glossary
Anywhere client,
for either an initial installation or an update.
Before you begin
- You must have a user account on IBM
InfoSphere® Information Server with
an Information Governance Catalog Basic
User role or higher.
- Make sure that Glossary Anywhere is
not currently installed on the target computer. If an existing version
is installed, remove it before
installing the new version. To learn how to retain existing configuration
settings, see Retaining
settings for InfoSphere Glossary
Anywhere.
- The target computer must have a supported version of Microsoft
Windows and Microsoft .NET Framework 4.6.1 or later installed. See the InfoSphere Information Server
version 11.7.1 system requirements
for the specific versions of Windows that
are supported.
- Make sure that you have write access to the target installation
directory. To ensure this, either log in to the computer that you
are installing on as a Microsoft Windows Administrator or make
sure that the target installation directory is unlocked.
Note: If
you are not a Microsoft Windows Administrator, and the
default target installation directory is locked, you can edit the
silent installation script to change the target installation directory
to one that is unlocked.
- You must have Microsoft Windows Internet Explorer, Version
9.0 or later, installed.
- You must have a valid security certificate, either
from the target computer or from the server where IBM
InfoSphere Information Governance Catalog is
installed.
About this task
With silent installation, you can customize the installation
process by editing the example script file that is provided. For example,
you can change the target installation directory or add error codes
and messages that you want displayed. The script file also works if
you make no changes to it.
You can install the Glossary Anywhere client
and define user preferences and configuration parameters. When you
install the client, the installation process uses the configuration
parameters in the provided file config.ini. Settings
for text capture, host configuration user preferences (including language),
and search are included in this file. You can edit this file to change
the parameters. After installation, you can change the settings manually
from the Settings panel of the Glossary Anywhere user
interface.
Procedure
- Copy the Glossary Anywhere installation
files to the target computer.
- If an administrator has prepared a shared version of the installation
files, copy these prepared files to your local hard disk.
- If an administrator has not prepared a shared version of the
installation files, copy the installation files to your computer directly
from the installation media. To copy the files from the installation
media:
- Locate the compressed file in the BusinessGlossaryAnywhereClient directory
in the root of the installation media.
- Copy this file to your local hard disk.
- Uncompress the file.
- Open the file ExampleSilentInstallBGA.bat with
a text editor, make any required changes, and save the file.
By
default Glossary Anywhere is
installed in the directory C:\program files\IBM\BusinessGlossaryAnywhere. You
can change this directory, and make any other changes, by editing
the file.
- Open a Windows command
prompt window.
- In the command prompt window, navigate to the directory
containing the file.
- Type the name of the file (as provided, ExampleSilentInstallBGA.bat)
in the command prompt window.
- Follow steps 7 through 10 to confirm the connection on
each user’s computer, and make any required configuration changes
or additions.
- To confirm the connection to the glossary
of IBM
InfoSphere Information Governance Catalog,
double-click the Open Book icon in the system
tray.
If the config.ini file used
by the installation process contains valid server configuration settings, Glossary Anywhere displays
its Getting Started window. If the config.ini file
does not contain valid server configuration settings, an error message
is displayed. Follow step 5 to correct the server configuration settings
manually.
- To change the server configuration
settings, right-click the open book icon and click . Configure, or update if necessary, the server name,
server port, user name, and password. Contact your IBM
InfoSphere Information Governance Catalog administrator
or IBM
InfoSphere Information Server administrator
for this information.
- The first time that you access Glossary Anywhere,
a general error message will be displayed if the security certificate
from the server is not trusted. If you receive such a message, then
you must install a security certificate on your target computer. One
method of doing so is by following these steps with your Microsoft Windows Internet
Explorer web browser:
- Open Windows Internet
Explorer. In the address field, type the connection information to
connect to InfoSphere
Information Governance Catalog.
Use the following format:
https://host_server:port/ibm/iis/igc/
where
host_server
is
the Host Name and
port
is the
Port Number as configured in the Host Configuration tab of the
Glossary Anywhere Settings
screen.
Note: The following steps describe the procedure to follow
with Windows Internet Explorer
7.0. Other 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 Certification Path tab.
- Click the root path that is displayed at the top of
the Certification Path window.
- Click View Certificate.
- Click Install Certificate to
launch the Certificate Import Wizard.
- Follow the Certificate Import Wizard prompts, and click Finish.
You can store the certificate in any security store.
- On the Security Warning screen, click Yes to
install the certificate.
- Double click the open book icon to reopen Glossary Anywhere and
connect to the business glossary.
- Optional: Restore your original customized
files.
- Navigate to the root of the installation directory and
replace the config.ini file there with the file that you saved earlier.
-
Navigate to the directory %APPDATA%\IBM\BusinessGlossaryAnywhere and
replace the user.config and user.ext.config files there
with the files that you saved earlier.
- Optional: Change other
configuration settings.
- Right-click the Open Book icon
and click . Configure the method that you want
to use to capture text.
- Click the User Preferences tab
to define other user parameters. Click OK to
save the settings and close the configuration window.
- Click the Search Items tab to
define what business glossary content you want to include in searches.
What to do next
If users have no connection errors, they can use Glossary Anywhere.
If
users have connection errors, check the log file. Each time that the
client is started, a log file is created on the client computer. The
name of the log file is BusinessGlossaryAnywhereyyyymmddhhmmss.log,
where yyyymmddhhmmss is the year, month,
day, hour, minute, and second when the application was started. The
log file is in the directory as defined in the LogFileDirectory parameter
in the config.ini file. Verify with the InfoSphere
Information Governance Catalog administrator
that the server name, port number, user name, and password are correct.
Users
can change the text capture method, user preferences, and configuration
values at any time by using the options available from the Settings tab.