The Tivoli® Directory Integrator installer allows you to install Tivoli Directory Integrator 7.0 in its entirety, only
those Tivoli Directory Integrator components that you need, upgrade a previous version of Tivoli Directory Integrator (versions 6.0, 6.1 or 6.1.1), or add features to an existing Tivoli Directory Integrator 7.0
installation.
Note:
IBM® Tivoli Directory Integrator does not support the Configuration
Editor (CE) on the following operating systems:
Installing Tivoli Directory Integrator V7.0 uninstalls a previous version; the uninstall
does not remove any files that the user has created. User created
files are still available after the new installation completes. Configuration
files such as global.properties and am_config.properties are migrated to Tivoli Directory Integrator 7.0, keeping any custom configuration changes that have
been made. The Tivoli Directory Integrator 7.0 installation continues to use
the features available in previous versions of Tivoli Directory Integrator:
You can launch the IBM Tivoli Directory Integrator 7.0 Installer by using one of the following
methods:
Launch the installer from the Launchpad
The Tivoli Directory Integrator Launchpad provides essential getting started installation
information and links to more detailed information on various installation,
migration, and post installation topics. In addition, Launchpad allows
you to launch the Tivoli Directory Integrator installer.
Notes:
The Launchpad is not available on z/OS and i5/OS.
Using the Launchpad requires that you have a supported Web browser
installed and configured; if this is not the case, you cannot use
the Launchpad. However, you can still use the platform-specific
installer directly; see Using the platform-specific TDI installer for instructions on
how to use theTivoli Directory Integrator Installer.
Note:
Open the Tivoli Directory Integrator Launchpad by typing the following command at the
command prompt:
For Windows platforms, type:
Launchpad.bat
For all other platforms, type:
Launchpad.sh
The menu on the left of the Launchpad allows you to navigate
the Launchpad windows. Click a menu item to view information about
it. The following menu items are available:
Welcome
The installation Welcome window contains links to:
IBM Tivoli Directory IntegratorWeb site
7.0 Documentation
Support Web site
Tivoli Directory Integrator news group
The following options on the left are TDI Launchpad windows:
Release Information
This window contains a list of some of the new and improved
features available this release, as well as links to documentation
about the release.
Prerequisite Information
This window contains links to information about platform support
and hardware requirements.
Installation scenarios
This window contains a description of the TDI components available
for installation. You can install some or all of these components
during installation. This window also contains a description of the
Password Synchronization Plug-ins components available for
installation.
Migration Information
This window contains a link to information about migrating from Tivoli Directory Integrator 6.0
or 6.1.X to 7.0. It also contains information about migrating the
Derby System Store.
Install IBM Tivoli Directory Integrator
This window contains links to the IBM Tivoli Directory Integrator Installer, as well
as links to installation, migration and supported platforms documentation.
See Using the platform-specific TDI installer for instructions on how to use the IBM Tivoli Directory Integrator Installer.
Install IBM Tivoli Directory Integrator Password Synchronization Plug-ins
This window contains links to the IBM Tivoli Directory Integrator Password Synchronizer
Plug-ins Installer, as well as links to installation and supported
platforms documentation.
Note:
This window is not available
on Linux PPC and Linux 390 platforms.
Exit
Exits the Launchpad, without installing anything.
On the installation window, click IBM Tivoli Directory Integrator Installer.
This launches the installer. See Using the platform-specific TDI installer for instructions
on how to use the installer.
Launch the installer directly
You can launch the installer directly using the installation
executable file:
Locate the installation executable file for your platform
in the tdi_installer directory on the
product CD (on i5/OS this directory is called TDI_INST).
Windows Intel
install_tdiv70_win_x86.exe
Windows AMD64/EM64T
install_tdiv70_win_x86_64.exe
AIX
install_tdiv70_aix.bin
Linux
install_tdiv70_linux_x86.bin
Linux AMD 64
install_tdiv70_linux_x86_64.bin
Power PC Linux
install_tdiv70_ppclinux.bin
z/OS Linux
install_tdiv70_zlinux.bin
Solaris Sparc
install_tdiv70_solaris_sparc.bin
Solaris
install_tdiv70_solaris_x86_64.bin
HP-UX PA-RISC
install_tdiv70_hpux_parisc.bin
HP-UX Integrity
install_tdiv70_hpux_ia64.bin
i5/OS
INST_TDI.SH
Double-click the executable file, or type the executable file
name at the command prompt. This launches the installer. See Using the platform-specific TDI installer for information on how to use the installer.
Once you have launched the installer (using the Launchpad or
by starting the platform-dependent installer directly), you
are ready to begin the process of Using the platform-specific TDI installer.
Notes:
By default, the Windows installers will return immediately when
started from a command prompt. This makes it impossible to write a
script that will run the installer on Windows and wait for it to complete.
Additional executables, install_tdiv70_win_x86_console.exe and install_tdiv70_win_x86_64_console.exe are
provided; these do not return until completed, so these executables
should be used if such behavior is desired. There is no other difference
in their behavior.
Non-administrators can install Tivoli Directory Integrator, with the
following caveats: users installing Tivoli Directory Integrator must have write
privileges to the installation location; non-administrators
do not see the "Register AMC as a service" window, and non-administrator
Configuration Editor shortcuts differ from administrator Configuration
Editor shortcuts.
The platform-specific Tivoli Directory Integrator installer
is launched either form the Launchpad or from the command line. The Tivoli Directory Integrator installer can be used to install a new copy of Tivoli Directory Integrator, add a feature to an existing instance of Tivoli Directory Integrator,
or upgrade a previous version of Tivoli Directory Integrator. The default install location on your computer
for Tivoli Directory Integrator varies with the platform.
Before you install
Note:
In addition to being unavailable on the i5/OS operating
system, Tivoli Directory Integrator supports neither the Configuration Editor (CE) nor the
Configuration Editor Update Site on the following operating systems:
Installing IBM Tivoli Directory Integrator on i5/OS
InstallShield Multi Platform (ISMP) 11.5 Tivoli Directory Integrator supports
installation on i5/OS. The i5/OS platform does not support a GUI interface
(Launchpad). i5/OS supports the command line installation -console option.
See Installing using the command line.
The following Tivoli Directory Integrator features are not available on i5/OS,
and are not listed as installable features during -console installation:
Configuration Editor Update Site (Eclipse Update site for CE) -
An Eclipse update site used for CE maintenance and for allowing the
customer to install the CE to an existing Eclipse workbench if they
do not want to use the stand alone Rich Client Platform (RCP) application.
Prior to installing Tivoli Directory Integrator, certain software must already be installed
on the i5/OS operating system running Tivoli Directory Integrator.
Java virtual machine version
Tivoli Directory Integrator requires the IBM J9 32-bit JVM on all versions
of i5/OS. If the J9 32-bit JVM is not found, an error message displays:
The install was unable to detect the IBM J9 VM (32-bit). The IBM J9 VM is required for this product.
Please install this JVM then try again.
If you see this message,
you must cancel the installation, install the IBM J9 VM, and begin
the installation again.
If you choose the embedded Web platform feature, the install will
check to make sure that LWI 7.0.1(v5r4) or 7.1.1(v6r1) is resident
on the target machine.
PTF versions
For i5/OS V5R4 the installer will check that the following items
are installed:
Product 5722JV1 option 8 (J2SE 5.0 32 bit)
PTF group SF99291 level 17 or higher (Java 5.0 SR9)
PTF group SF99114 level 13 or higher (embedded Web platform 7.0.1)
PTF SI34226 for product 5722SS1 (SSL support for embedded Web
platform)
PTF SI34483 for product 5722SS1 (embedded Web platform fixes)
For i5/OS V6R1 the installer will check that the following items
are installed:
Product 5761JV1 option 8 (J2SE 5.0 32 bit)
PTF group SF99562 level 5 or higher (Java 5.0 SR9)
Product 5761DG1, *BASE (IBM HTTP Server for i5/OS - Contains
embedded Web platform 7.1.1)
PTF SI33788 for product 5761SS1 (Administration and Monitoring
Console Roles fix)
PTF SI34021 for product 5761SS1 (SSL fixes)
If these PTFs or products are not found, an error message appears:
The installer was unable to detect the i5/OS product/PTFs required by the embedded Web platform feature.
You may choose to continue the install without the embedded Web platform feature or you may exit now and
refer to the install log for a list of the missing requirements.
Installation
Note:
The installer and uninstaller on i5/OS are called
INST_TDI.SH and uninstaller.sh, respectively.
To begin installing on i5/OS:
Locate the installation executable file for i5/OS in the TDI_INST directory
on the product CD. Launchpad is not available on i5/OS. The default
location to install i5/OS on your computer is: /QIBM/ProdData/TDI/V7.0
On i5/OS, in order to extract the Tivoli Directory Integrator 7.0 installer from a TAR
image, you must set environment variable "QIBM_CCSID" to 819; that
is, run the command
export QIBM_CCSID=819
before un-tarring
the Tivoli Directory Integrator installer TAR image.
Another i5/OS difference is on the Tivoli Directory Integrator Solutions directory
panel. On i5/OS, there is a specific place for user data. As a result,
instead of giving you the option to make the installation directory
the same as the solutions directory, the option reads: Use the
TDI User Product Directory.
Installing a new version of Tivoli Directory Integrator 7.0
Tivoli Directory Integrator is either not present on the target system, or
you chose to install a new version when prompted.
When you run the installer:
A window appears, stating "The InstallShield Wizard is preparing
the installation, please wait."
After the installation program is loaded, the Welcome window appears,
stating "Welcome to the InstallShield Wizard for IBM Tivoli Directory
Integrator v7.0."
Click Next to continue.
A window appears,
stating "Click next to search for previously installed versions
of Tivoli Directory Integrator. This may take a while..."
Click Next to search for previously
installed versions of Tivoli Directory Integrator.
If there is a version of Tivoli Directory Integrator already installed on
your computer, a new window lists several options:
Install Tivoli Directory Integrator version 7.0 to a new location.
Add features to a current version of Tivoli Directory Integrator.
Upgrade one of the following Tivoli Directory Integrator installed versions
to version 7.0.
Select Install TDI 7.0 to a new location.
Click Next.
After reading the software license agreement, select one of the
following options:
I accept both the IBM and the non-IBM
terms.
I do not accept the terms in the license
agreement.
If you do not accept the terms of the software license agreement,
you cannot continue with the installation. Click Next to
continue.
A new window appears, showing the default directory for
the installation of Tivoli Directory Integrator 7.0.
To accept the default directory, click Next. To have InstallShield install Tivoli Directory Integrator to
a different directory, click Browse, navigate
to the directory you want, and click Open in
Windows Explorer. Click Next.
Notes:
Non-ASCII characters and the following list of characters are
not supported in the install path: ";|*?!#&$',=^@%
You cannot choose an installation location of an existing installation
(an "instance") of Tivoli Directory Integrator. If you try to select the directory
of an existing Tivoli Directory Integrator version, an error appears, stating:
The directory you have chosen already contains an installation of IBM Tivoli Directory Integrator.
Choose another directory.
Note:
Select the installation type you prefer:
Select Typical to install the Java
Runtime Environment, the Runtime Server, Configuration Editor, Java
API documentation, Examples, embedded Web platform (includes Integrated
Solutions Console SE), and Administration and Monitoring Console (AMC).
This option does not give you the opportunity to install individual
features.
Select Custom to choose individual
or additional features to install.
Click Next.
If you are performing a custom installation, select the Tivoli Directory Integrator components you want to install. See Components in IBM Tivoli Directory Integrator for
a list and descriptions of components available for installation.
When you have finished making your selections, click Next.
If you are performing a typical installation, or if you selected
to install the Runtime Server, you must select a solution directory.
The solution directory is where the Tivoli Directory Integrator Server and Configuration
Editor locate your solutions, like Config files and properties files.
To set up your solution directory, select one of the following options:
Use a subdirectory named TDI under my
home directory. This creates a subdirectory under your home directory,
for example for Windows: C:\Documents and
Settings\username\My Documents\TDI.
Select a directory to use. Navigate
to or type the name of a directory. Any directory reachable on the
local computer can be established as the default solution directory.
Do not specify. Use the current
working directory at startup time.
Click Next.
Note:
On
i5/OS, the "Use Install Directory" is replaced with "Use
the TDI User Product Directory". The i5/OS platform has a specific
location (/QIBM/UserData) for user data. The installation directory
is not appropriate.
If you selected to deploy Administration and Monitoring Console
(AMC) to ISC, a window appears, providing you with options for deploying
AMC into the Integrated Solutions Console (ISC):
Embedded instance of Integrated Solutions
Console SE.
Existing instance of Integrated Solutions
Console. When selecting this option in Windows, you can use Browse to locate the instance of ISC.
Do not specify. I will manually deploy
AMC at a later time.
Note:
If you did not select the embedded Web platform
component, the option Embedded instance
of Integrated Solutions Console SE is not available.
If you chose to deploy AMC to ISC, enter port-related values to
be used by ISC and AMC for the following fields:
HTTP port. The default HTTP port is 13100.
HTTPS port. The default HTTPS port is 13101.
Action Manager API port. The default Action Manager API port is
13104.
Enter ISC port information and click Next.
If you have selected to deploy AMC to the embedded Web platform, a
window appears giving you the option to register AMC as a system service.
If you want to register AMC as a service for your operating system,
select Register AMC as a system service. The
default is cleared, or do not register AMC as a service with the OS.
The
installer tries to provide a valid default value for Service Name. If the installer is unable
to determine a valid Service Name,
the installer leaves the field blank. You cannot continue with the
installation until you enter a valid service name.
Note:
The
register AMC as a service window appears only if these conditions
are met:
The embedded Web platform and AMC features are selected.
The userid has Administrator privileges.
A window appears, stating "Please
read the summary information below."
Review the installation information you have selected. The summary
shows what is going to be installed. Click Back to
make any changes. When you are ready to begin installation, click Install.
A window showing installation progress
appears. The progress bar applies to all features selected for installation.
Each file or group of files being installed, along with its path,
displays rapidly to let you know what is being installed.
Click Cancel only if you want to
cancel the installation.
A summary information window appears when
the installation process is complete.
If you chose to install the Configuration Editor and if you want
the Configuration Editor to start immediately, select Start
the Configuration Editor. Click Finish to
complete the installation process.
Adding features to an existing (installed) version of Tivoli Directory Integrator
Tivoli Directory Integrator 7.0 is present on the
target system, and some features supported for your platform have
not yet been installed.
Notes:
You cannot choose the Add Features option
if there is not an installed Tivoli Directory Integrator 7.0 instance available.
The Tivoli Directory Integrator 7.0 selections are enabled if the Add Features option is chosen.
You cannot remove features using this procedure. To remove features,
you must use the Tivoli Directory Integrator uninstaller. See Uninstalling.
When you run the installer:
A window appears, stating "The InstallShield Wizard is preparing
the installation, please wait."
After the installation program is loaded, the Welcome window appears,
stating "Welcome to the InstallShield Wizard for IBM Tivoli Directory
Integrator v7.0."
Click Next to continue.
A window appears, stating "Click next to search for previously
installed versions of Tivoli Directory Integrator. This may take a while..."
Click Next to search for previously
installed versions of Tivoli Directory Integrator.
If there is a version of Tivoli Directory Integrator already installed on
your computer, a new window lists several options:
Install Tivoli Directory Integrator version 7.0 to a new location.
Add features to a current version of Tivoli Directory Integrator.
Upgrade one of the following Tivoli Directory Integrator installed versions
to version 7.0.
Select Add features
to a current version of Tivoli Directory Integrator.
Immediately below the Add features option,
click the down arrow and select the version of Tivoli Directory Integrator to
which you want to add features. Click Next.
You
are not prompted for an installation location. The feature selection
window appears. The features that are installed are shown already
selected. You cannot clear these features.
Choose the features you would like to add to the installed version
of TDI that you have selected. Click Next.
If you are adding the Runtime Server, you must select a solutions
directory. The solutions directory is where the Tivoli Directory Integrator server
and Configuration Editor locate your solutions, like Config files
and properties files. To set up your solution directory, select one
of the following options:
Use a subdirectory named TDI under my
home directory. This creates a subdirectory under your home directory,
for example for Windows: C:\Documents and
Settings\username\My Documents\TDI.
Select a directory to use. Navigate
to or type the name of a directory. Any directory reachable on the
local computer can be established as the default solution directory.
Do not specify. Use the current
working directory at startup time.
Click Next.
Note:
On
i5/OS, the "Use Install Directory" is replaced with "Use the TDI User
Product Directory." The i5/OS platform has a specific location (/QIBM/UserData)
for user data. The installation directory is not appropriate.
If you chose to install the Administration and Monitoring Console
(AMC) feature and deploy to ISC, a window appears, providing you with
options for deploying AMC into the Integrated Solutions Console (ISC):
Embedded instance of Integrated Solutions
Console SE.
Existing instance of Integrated Solutions
Console. When selecting this option in Windows, you can use Browse to locate the instance of ISC.
Do not specify. I will manually deploy
AMC at a later time.
Note:
If you did not select the embedded Web platform
component, the option Integrated Solutions
Console SE is not available.
If you chose to deploy AMC to ISC, enter port-related values to
be used by ISC and AMC for the following fields:
HTTP port. The default HTTP port is 13100.
HTTPS port. The default HTTPS port is 13101.
Action Manager API port. The default Action Manager API port is
13104.
Enter ISC port information and click Next.
If you have selected to deploy AMC to the embedded Web platform, a
window appears giving you the option to register AMC as a system service.
On platforms other than i5/OS, if you want to register AMC as
a service for your operating system, select Register
AMC as a system service. The default is cleared, or do not register
AMC as a service with the OS.
The installer tries to provide a valid
default value for Service Name. If
the installer is unable to determine a valid Service
Name, the installer leaves the field blank. You cannot continue
with the installation until you enter a valid service name.
Note:
The register AMC as a service window appears only if these
conditions are met:
The bundled ISC platform and AMC features are selected.
The userid has Administrator privileges.
Review the installation information you have
selected. The summary shows what is going to be installed. Click Back to make any changes. When you are
ready to begin the installation, click Install.
A window showing installation progress appears. The progress bar
applies to all features selected for installation. Each file or group
of files being installed, along with its path, displays rapidly to
let you know what is being installed.
Click Cancel only if you want to
cancel the installation.
A summary information window appears when
the installation process is complete.
If you chose to install the Configuration Editor and if you want
the Configuration Editor to start immediately, select Start the Configuration Editor. Click Finish to complete the installation process.
Upgrading an installed version of Tivoli Directory Integrator
Note:
You cannot select the Upgrade option
if there are no previous versions of Tivoli Directory Integrator available.
Upgrading a version of Tivoli Directory Integrator from Tivoli Directory Integrator 6.0
to Tivoli Directory Integrator 7.0
Notes:
If you have installed IBM Tivoli Directory
Integrator 6.0 as a Windows Service, see section Uninstalling the service first.
Not all files are upgraded when performing the installer upgrade.
See section Migrate files to a newer version for information what
files are automatically upgraded and which need to be updated manually.
After some time, a window appears, stating "The InstallShield
Wizard is preparing the installation, please wait."
After the installation program is loaded, the Welcome window appears,
stating "Welcome to the InstallShield Wizard for IBM Tivoli Directory
Integrator v7.0."
Click Next to continue.
A window appears, stating "Click next to search for
previously installed versions of Tivoli Directory Integrator. This may take a
while..."
Click Next to search for previously
installed versions of Tivoli Directory Integrator.
If there is a version of
TDI already installed on your computer, a new window lists several
options:
Install Tivoli Directory Integrator version 7.0 to a new location.
Add features to a current version of Tivoli Directory Integrator.
Upgrade one of the following Tivoli Directory Integrator installed versions
to version 7.0.
Select Upgrade one of the following Tivoli Directory Integrator installed versions to version 7.0.
Immediately below the Upgrade option,
click the down arrow and select a TDI 6.0 version. Click Next.
Note:
There is no version
detection and automated upgrade for versions prior to Tivoli Directory Integrator 6.0.
Select Typical or Custom and click Next.
If you select custom, the feature selection window appears. The Default
Install Location window is skipped, and the value for the installation
location is taken from the TDI 6.0 installation.
If you are performing a custom installation, select the Tivoli Directory Integrator components you want to install. When you have finished
making your selections, click Next.
If you are upgrading the Runtime Server feature, the Tivoli Directory Integrator Solutions
Directory window is skipped, and the value for the Solutions Directory
location is taken from the TDI 6.0 installation.
If you chose to install the AMC feature and deploy to ISC, the
ISC window appears, providing you with options for deploying AMC into
the Integrated Solutions Console (ISC):
Embedded instance of Integrated Solutions
Console SE.
Existing instance of Integrated Solutions
Console. When selecting this option in Windows, you can use Browse to locate the instance of ISC.
Do not specify. I will manually deploy
AMC at a later time.
Note:
If you did not select the embedded Web platform
component, the option Embedded instance
of Integrated Solutions Console SE is not available.
If you chose to deploy AMC to ISC, enter port-related values to
be used by ISC and AMC for the following fields:
HTTP port. The default HTTP port is 13100.
HTTPS port. The default HTTPS port is 13101.
Action Manager API port. The default Action Manager API port is
13104.
Enter ISC port information and click Next.
If you have selected to deploy AMC to the embedded Web platform, a
window appears giving you the option to register AMC as a system service.
On platforms other than i5/OS, if you want to register AMC as
a service for your operating system, select Register
AMC as a system service. The default is cleared, or do not register
AMC as a service with the OS.
The installer tries to provide a valid
default value for Service Name. If
the installer is unable to determine a valid Service
Name, the installer leaves the field blank. You cannot continue
with the installation until you enter a valid service name.
Note:
The register AMC as a service window appears only if these
conditions are met:
The bundled ISC platform and AMC features are selected.
The userid has Administrator privileges.
A window appears, stating "Please
read the summary information below."
Review the installation information you have selected. The summary
shows what is going to be installed. Click Back to
make any changes. When you are ready to begin installation, click Install.
A window showing installation progress
appears. The progress bar applies to all features selected for installation.
Each file or group of files being installed, along with its path,
displays rapidly to let you know what is being installed.
Click Cancel only if you want to
cancel the installation.
A summary information window appears when
the installation process is complete.
If you chose to install the Configuration Editor and if you want
the Configuration Editor to start immediately, select Start
the Configuration Editor. Click Finish to
complete the installation process.
Updating a version of Tivoli Directory Integrator 6.1 or 6.1.1 to Tivoli Directory Integrator 7.0
A version of Tivoli Directory Integrator 6.1 or 6.1.1 is present on the system,
and the Tivoli Directory Integrator 7.0 installer is invoked to upgrade the existing installation.
Notes:
If you have installed IBM Tivoli Directory
Integrator 6.1 or 6.1.1 as a Windows Service, see section Uninstalling the service first.
Not all files are upgraded when performing the installer upgrade.
See section Migrate files to a newer version for information what
files are automatically upgraded and which need to be updated manually.
After some time, a window appears, stating "The InstallShield Wizard
is preparing the installation, please wait."
After the installation program is loaded, the Welcome window appears,
stating "Welcome to the InstallShield Wizard for IBM Tivoli Directory
Integrator v7.0."
Click Next to continue.
A window appears, stating "Click next to search for
previously installed versions of Tivoli Directory Integrator. This may take a
while..."
Click Next to search for previously
installed versions of Tivoli Directory Integrator.
If there is a version of Tivoli Directory Integrator already installed on your computer, a new window lists
several options:
Install Tivoli Directory Integrator 7.0 to a new location.
Add features to a current version of Tivoli Directory Integrator.
Upgrade one of the following Tivoli Directory Integrator installed versions
to version 7.0.
Select Upgrade one of the following Tivoli Directory Integrator installed versions to version 7.0.
Immediately below the Upgrade option, click the down arrow and
select a Tivoli Directory Integrator 6.1 or 6.1.1 version. Click Next.
You are not prompted for an installation location. The feature
selection window appears. The features already installed are shown
already selected. You cannot clear these features. Choose the features
you would like to add to the installed version of Tivoli Directory Integrator that
you have selected. Click Next.
If you are adding the Runtime Server, you must select a solutions
directory. The solutions directory is where the Tivoli Directory Integrator server
and CE locate your solutions, like Config files and properties files.
To set up your solution directory, select one of the following options:
Use a subdirectory named TDI under my
home directory. This creates a subdirectory under your home directory,
for example for Windows: C:\Documents and
Settings\username\My Documents\TDI.
Use the installation directory. This
is the directory you specified in 6.
Select a directory to use. Navigate
to or type the name of a directory. Any directory reachable on the
local computer can be established as the default solution directory.
Do not specify. Use the current
working directory at startup time.
Click Next.
Note:
On i5/OS, the phrase "Use installation directory"; is replaced
with "Use the TDI User Product Directory."; The i5/OS platform has
a specific location (/QIBM/UserData) for user data. The installation
directory is not appropriate.
If you chose to install the AMC feature and to deploy to ISC,
the ISC window appears, providing you with options for deploying AMC
into the Integrated Solutions Console (ISC):
Embedded instance of Integrated Solutions
Console SE.
Existing instance of Integrated Solutions
Console. When selecting this option in Windows, you can use Browse to locate the instance of ISC.
Do not specify. I will manually deploy
AMC at a later time.
Note:
If you did not select the embedded Web platform
component, the option Embedded instance
of Integrated Solutions Console SE is not available.
If you chose to deploy AMC to ISC, enter port-related values to
be used by ISC and AMC for the following fields:
HTTP port. The default HTTP port is 13100.
HTTPS port. The default HTTPS port is 13101.
Action Manager API port. The default Action Manager API port is
13104.
Enter ISC port information and click Next.
If you have selected to deploy AMC to the embedded Web platform, a
window appears giving you the option to register AMC as a system service.
On platforms other than i5/OS, if you want to register AMC as
a service for your operating system, select Register
AMC as a system service. The default is cleared, or do not register
AMC as a service with the OS.
The installer tries to provide a valid
default value for Service Name. If
the installer is unable to determine a valid Service
Name, the installer leaves the field blank. You cannot continue
with the installation until you enter a valid service name.
Note:
The register AMC as a service window appears only if these
conditions are met:
The bundled ISC platform and AMC features are selected.
The userid has Administrator privileges.
A window appears, stating "Please
read the summary information below."
Review the installation information you have selected. The summary
shows what is going to be installed. Click Back to
make any changes. When you are ready to begin installation, click Install.
A window showing installation progress
appears. The progress bar applies to all features selected for installation.
Each file or group of files being installed, along with its path,
displays rapidly to let you know what is being installed.
Click Cancel only if you want to
cancel the installation.
A summary information window appears when
the installation process is complete.
If you chose to install the Configuration Editor and if you want
the Configuration Editor to start immediately, select Start
the Configuration Editor. Click Finish to
complete the installation process.
The following command line options are supported by the Tivoli Directory Integrator 7.0 installer:
-console
Specifies to use the console interface mode, where messages
during installation are displayed on the Java console and the wizard
is run in console mode.
install_tdiv70_win_x86.exe -console
-options-record
Specifies that the TDI installation Wizard should automatically
generate a response file for the project after the completion of the
installation or uninstallation.
install_tdiv70_win_x86.exe -options-record Response File Name
-options
Specifies that a response file be used to run the installation
or uninstallation of TDI. A response file is usually used when a silent
installation is run (see the next option).
install_tdiv70_win_x86.exe -options Response File Name
Note:
The
directory TDI_install_dir/examples/install contains
a number of example response files for various installation and de-installation
scenarios.
-silent
Specifies to install or uninstall the product in silent mode,
where the installation or uninstallation is performed with no user
interaction. The -options command line
option is used here to specify what response file to use.
install_tdiv70_win_x86.exe -silent -options Response File Name
TDI_install_dir/_uninst/uninstaller.exe -silent -options Uninstall Response File Name
-is:javahome java home directory
Specifies the home directory location of the JVM to
the launcher. The JVM that is specified must be at the 1.4.2 level
or later. Currently, version 1.5 SR9 is included.
This option should only be used if the installer
will not run with the bundled JRE.
-is:log filename
This option is useful for setting up launchers that hide the
Java console because it logs detailed information about the launcher,
including the actual Java commands that were used to start the Java
program, to the specified filename. This
includes all of the "std out" and "std err" messages from the Java
process.
Sets the path to the temporary directory to which the launcher
should write its temporary files. If the specified directory does
not exist or is not a directory, the launcher uses the system temp directory instead, and no error
message is provided.
This parameter should only be passed in on an installation.
This parameter is provided so that installers may avoid creating shortcuts
if they are not needed.
To perform a silent installation you must first generate a response
file. To generate this file, perform a non-silent installation
with the -options-record option specified,
for example:
install_tdiv70_win_x86.exe -options-record Response File Name
The response file is created in the directory that you specify
during installation.
Note:
The directory TDI_install_dir/examples/install contains
a number of example response files for various installation and uninstallation
scenarios.
Once the response file is created, you
can install silently using the following command:
install_tdiv70_win_x86.exe -silent -options Response File Name
Note:
The examples in this document use the Windows
platform installation executable file. See Launching the appropriate installer for
a list of executable file names for each supported platform.
On Windows, a shortcut to the launchAMC.html file
is created in the start menu under Program Files.
By default, the user who installs Tivoli Directory Integrator is the only one with access
to log in to the console.
Customer or deferred deployment
If you chose a custom ISC AE to deploy AMC to, and are now ready
to deploy, see Deploying AMC to a custom ISC SE/AE. When deploying AMC in
ISC AE the installer does not automatically assign the current user
the TDI AMC Admin role. This right needs to be manually authorized
by an administrator of the ISC console. This is typically done using
the Users and Groups -> Administrative User
Roles panel of the ISC AE console. Alternatively this role could
be assigned using the setAMCRoles command.
If
you have done a custom ISC SE/AE deployment then at a minimum you
will need to ensure that AM is started after you start the ISC SE/AE
that AMC was installed into.
Documentation
The documentation system used by Tivoli Directory Integrator is the IBM Eclipse Help System.
After you have done a default installation, this means that IBM Tivoli Directory Integrator 7.0 documentation
is made available to you online, on the Web in the form of an Infocenter
hosted by IBM. You may, however, choose to deploy the documentation
locally. For more information, see Installing local Help files.
If you have used earlier versions of Tivoli Directory Integrator, then chapter 3 of the IBM Tivoli Directory Integrator V7.0 Users Guide will be very beneficial to you in order to understand
he new IDE framework and layout. It will also explain how you can
import and open your existing configurations; and how the Server still
uses the Config model at runtime.
Migration
If you have used an earlier version of Tivoli Directory Integrator, then you will most
likely need to migrate certain aspects of your previous deployment.
More information on what to do in this case can be found under Migrating.
Attention: Support for running the Configuration Editor (the GUI for
developing solutions in IBM Tivoli Directory Integrator 7.0) has changed. The Configuration
Editor (CE) is not supported on the following platforms:
z/OS
Linux 390
Linux PPC
HP PA-RISC
HP-UX Integrity
If you wish to develop solutions for these platforms, you should
use the Remote Configuration Editor functionality, meaning that you
run the CE on a supported platform, while in contact with a Tivoli Directory Integrator Server
on one of the aforementioned platforms. See Using the Remote Configuration Editor for details.
