The installation program creates the IBM® FileNet® Workplace XT folder structure and files
needed for Workplace XT. After
installing the files, and any necessary updates, you must also configure
and deploy the Workplace XT application.
Before you install
IBM FileNet Workplace XT:
- Make sure that your installation location meets the requirements
specific to IBM FileNet Workplace XT outlined
in the IBM FileNet P8 Hardware and Software
Requirements.
- You must have installed and configured a supported Web application
server for IBM FileNet Workplace XT.
- To ensure proper functionality, performance, and ongoing maintenance, IBM FileNet Workplace XT should only be installed
once per application server (or virtual machine or AIX® LPAR). You can, however, deploy multiple
instances of a single IBM FileNet Workplace XT version per application server.
- If you plan to run the interactive installer as a basis for silent
installation, start the installer as documented in Creating a response file by recording an installation to create the response file.
- For an accessible install process of Workplace XT, follow the procedures
provided for the silent install method, Running the Workplace XT installation silently.
- If you plan to use JAWS screen reader for the setup program,
you must perform the following tasks before you begin the Workplace XT install:
- Ensure that a JAWS-supported version of Oracle JRE is installed
on the system where you will be performing the installation.
- Install the Java™ Access
Bridge (available at http://www.oracle.com/index.html).
- Start the JAWS screen reader.
- Before logging in to Workplace XT for the first time, make sure that at least one object
store has been created on the Content Engine.
- In a high availability environment, you must
install Workplace XT on all
nodes in the application server configuration. Even in an application
server cluster configuration Workplace XT provides components that run outside of the application
server such as the Component Manager. These components are only available
through a Workplace XT installation.
- In the installation program, the version list for application
servers includes versions that might no longer be supported. To confirm
supported versions, check the IBM FileNet P8 Hardware and Software
Requirements.
To install IBM FileNet Workplace XT software:
- Collect the parameters that are required to complete your
installation. For information on parameter values, see documentation
about the installation and upgrade worksheet in Plan and Prepare Your Environment for IBM FileNet P8.
Note: With the command enabled, as it is by
default in the shipping worksheet file (
p8_worksheet.xls),
perform the following actions to quickly see only the installation
properties you must specify for the Workplace XT installation program:
- Click the AutoFilter drop-down arrow in the Installation
or Configuration Program column header and select WPXT installer.
- Click the AutoFilter drop-down arrow in the Setup
Type column header, select Custom, and specify Setup Type contains Installation.
- Click the AutoFilter drop-down arrow in all other column headers
and select (All).
- In highly available environments, mount
the shared configuration directory from all nodes in the application
server configuration.
When the location of the shared
configuration directory is decided, that directory must be mounted
and accessible from all servers in the application server configuration.
Also, ensure that the same directory path is used on all systems.
If the path on the first system is:
make sure this same path is available on all other systems.
- (IBM WebSphere® Application Server in a highly available environment)
Configure the node agent service to start as a user with access to
the shared configuration directory. If IBM WebSphere Application Server is configured to start
as a Windows Service, you
must configure the node agent service with a user that has access
to the shared configuration directory. The default startup user for
the service is Local System, which cannot be given access to the shared
directory.
- (IBM WebSphere Application Server or Oracle WebLogic Server in a highly available environment) Verify that your application
farm or cluster configuration is running.
Note: JBoss Application Server deploys applications on startup. There is no need to start the application
server until you have installed the application.
- Optional: Install the IBM Production Imaging Edition Viewer Pro license
file. If you have purchased IBM Production Imaging Edition, the Viewer Pro software can be installed
when you run the Workplace XT installation. To activate the Viewer Pro installation, you must
run the license installer before you install Workplace XT. To install the license
file:
- Locate the IBM Production Imaging Edition Viewer Pro license installer package
and run the appropriate installation program for your operating system.
Platform |
Command |
AIX |
PIEProLic-1.1.5.0-AIX.bin |
HPUX |
PIEProLic-1.1.5.0-HPUX.bin |
HPUXi |
PIEProLic-1.1.5.0-HPUXi.bin |
Linux |
PIEProLic-1.1.5.0-LINUX.bin |
Solaris |
PIEProLic-1.1.5.0-SOL.bin |
Windows |
PIEProLic-1.1.5.0-WIN.exe |
- Complete the IBM Production Imaging Edition Viewer Pro license installation program
screens.
- View the PIEPro_install_log.txt file located in install_path/IBM/FileNet/PIEProLicense. Correct errors or failures noted in the log file before proceeding
with Workplace XT installation.
Often problems are logged with the term "ERROR" at the beginning of
a line.
- Log in to the server where you want to install Workplace XT:
Option |
Description |
UNIX |
Log in as a user with read, write, and execute access to the
directory where you plan to install IBM FileNet Workplace XT. |
Windows |
Log in as a member of the local Administrators group or a
user with equivalent permissions. |
- Locate the IBM FileNet Workplace XT 1.1.5.0 installation software package.
- Start the installation program in one of the following
ways:
- Run the appropriate installation program for your operating
system.
Platform |
Command |
AIX |
WorkplaceXT-1.1.5.0-AIX.bin |
HPUX |
WorkplaceXT-1.1.5.0-HPUX.bin |
HPUXi |
WorkplaceXT-1.1.5.0-HPUXi.bin |
Linux |
WorkplaceXT-1.1.5.0-LINUX.bin |
Solaris |
WorkplaceXT-1.1.5.0-SOL.bin |
Windows |
WorkplaceXT-1.1.5.0-WIN.exe |
Linux for System z® |
WorkplaceXT-1.1.5.0-ZLINUX.bin |
- Optional: Run the installation program for
your operating system, and have the program record your installation
choices in a response file.
Enter the following command:
WorkplaceXT-1.1.5.0-operating_system.bin -options-record record_file_name
(with no space between -options-record)
where
operating_system is the platform
where you are installing Workplace XT, for example:
AIX, HPUX, HPUXi, LINUX, SOL, WIN, or LINUX ON SYSTEM Z
(For Windows, the file extension is .exe.)
record_file_name is the
name of the response file to be generated, for example, xt_record.txt.
For more information
about response files, see Generating the silent installation response files.
- Complete the Workplace XT installation program screens.
Note: In high availability environments, specify the
location to hold the Workplace XT shared configuration data on the Specify Configuration Directory
screen.
- View the web_client_install_log_1.1.5.0.txt file located in install_path/IBM/FileNet/WebClient.
Verify that no errors or failures were logged. Look
for the ERROR designation at the start of a line. Correct any errors
before you proceed.
- In highly available environments, you
must synchronize the UTCryptoKeyFile.properties file across your Workplace XT nodes.
Each participating Workplace XT server must use the same
encryption key file. Copy the UTCryptoKeyFile.properties file installed on the first Workplace XT server in your farm to all the other servers in your farm.
For more information about setting UTCryptoKeyFile.properties file, see FileNet documentation
about user tokens.