FileNet P8

Version 5.2.1

Plan and Prepare Your Environment for

FileNet P8
for upgrade on AIX with Oracle, IBM
WebSphere Application Server, and
Windows Active Directory

IBM

GC19-3929-04
FileNet P8
Version 5.2.1

Plan and Prepare Your Environment for

FileNet P8
for upgrade on AIX with Oracle, IBM
WebSphere Application Server, and
Windows Active Directory

IBM

GC19-3929-04
 Note
Before using this information and the product it supports, read the information in “Notices” on page 49.

This edition applies to version 5.2.1 of IBM FileNet Content Manager (product number 5724-R81), version 5.2.1 of
IBM Case Foundation (product number 5724-R76), and to all subsequent releases and modifications until otherwise
indicated in new editions.
© Copyright IBM Corporation 2001, 2016.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
ibm.com and related resources. . . . . v Using IBM Support data collection tools . . . 20
Contacting IBM . . . . . . . . . . . . . v Security administrator upgrade tasks . . . . . 21
Security upgrade planning considerations . . 22
Planning and preparing for FileNet P8 Creating Content Platform Engine directory
server accounts for upgrades . . . . . . 22
upgrade . . . . . . . . . . . . . . . 1 Creating the application server
Planning the upgrade . . . . . . . . . . . 1 administrative console user (WebSphere
Upgrade scenarios . . . . . . . . . . . 1 Application Server) . . . . . . . . . 22
Upgrade on an existing server instance . . . 3 Database administrator upgrade tasks . . . . 23
Upgrade with migration to a new server Database administrator planning . . . . . 23
instance . . . . . . . . . . . . . . 4 Planning for Oracle database upgrades . . 25
Migration upgrade overview and roadmap 4 Planning the IBM Content Search Services
Upgrade planning considerations . . . . . . 6 upgrade . . . . . . . . . . . . . 25
Upgrade system requirements for FileNet P8 . 7 Application Server administrator upgrade tasks 26
Upgrade system requirements for FileNet P8 Creating the application server administrator 26
expansion products . . . . . . . . . . 7 Starting or stopping an application server
FileNet P8 eForms . . . . . . . . . 7 instance . . . . . . . . . . . . . 27
Content Federation Services . . . . . . 7 Configuring the application server for Content
IBM Enterprise Records. . . . . . . . 7 Platform Engine . . . . . . . . . . . 28
Upgrading or migrating the underlying vendor FileNet P8 administrator upgrade tasks . . . . 29
software supported by Content Platform Enabling the Asynchronous Processing
Engine . . . . . . . . . . . . . . 8 dispatcher . . . . . . . . . . . . . 29
Planning Process Engine upgrades (versions Preparing Process Engine for upgrade
4.5.1, 5.0.0, 5.1.0) . . . . . . . . . . . 8 (upgrades from versions 4.5.1, 5.0.0, 5.1.0) . . 30
Definition of upgrade roles . . . . . . . . 9 Collecting settings for peupgrade wizard
Using the installation and upgrade worksheet . . 10 (upgrades from versions 4.5.1, 5.0.0, 5.1.0) . . 30
Running the Customize Worksheet macro . . 11 Collecting configuration information for
Autofiltering and sorting the Worksheet . . . 12 Process Engine DbExecute connections
Performing the required upgrade preparation tasks 12 (upgrades from 4.5.1) . . . . . . . . . 30
IT administrator upgrade tasks . . . . . . . 13 | Saving Component Manager custom settings
Creating operating system accounts for | for CE_Operations (upgrades from V5.1 or
upgrades . . . . . . . . . . . . . 13 | earlier) . . . . . . . . . . . . . . 31
Creating the Content Platform Engine
installer account . . . . . . . . . . 14
Creating the Process Engine upgrade
Appendix A. Preparing non-English
account (upgrades from versions 4.5.1, environments for installing FileNet P8 . 33
5.0.0, 5.1.0). . . . . . . . . . . . 15 IT administrator . . . . . . . . . . . . . 33
Creating Configuration Manager user . . 15 Operating system considerations . . . . . . 34
Creating the Content Platform Engine Configuring locale and support for other
application server installation account . . 16 languages in an AIX, HPUX, HPUXi, Linux,
Creating the Content Platform Engine Linux on System z, or Solaris system . . . . . 34
application server installation group . . . 17 Security administrator . . . . . . . . . . . 35
Configuring AIX, HPUX, HPUXi, Linux, Linux Extended characters and user names . . . . . 35
on System z, and Solaris . . . . . . . . 17 Database administrator . . . . . . . . . . 35
Configuring AIX, HPUX, HPUXi, Linux, Installing Oracle server . . . . . . . . . 35
Linux on System z, and Solaris FileNet P8 Application Server administrator . . . . . . . 35
servers (all components) . . . . . . . 18 | Configuring character encoding on WebSphere
Configuring Content Platform Engine | Application Server . . . . . . . . . . . 36
servers (AIX, HPUX, HPUXi, Linux, Linux FileNet P8 administrator . . . . . . . . . . 36
on System z, and Solaris) . . . . . . . 18 Configuring Process Task Manager for
Assigning directory permissions to a new Application Engine and Workplace XT . . . . 36
installer account on AIX, HPUX, HPUXi, Limitations on installing in a non-English
Linux, Linux on System z, or Solaris . . . 19 environment . . . . . . . . . . . . . . 37
Configuring operating system elements . . . 20
Configuring network communications . . 20 Appendix B. FileNet P8 ports . . . . . 39
Synchronizing machine clocks . . . . . 20 Content Platform Engine ports . . . . . . . . 40

© Copyright IBM Corp. 2001, 2016 iii

Application Engine and Workplace XT ports . . . 43 Notices . . . . . . . . . . . . . . 49
Process Simulator ports . . . . . . . . . . 43 Trademarks . . . . . . . . . . . . . . 51
Content Search Services ports . . . . . . . . 44 Privacy policy considerations . . . . . . . . 52
Database ports . . . . . . . . . . . . . 45
IBM System Dashboard for Enterprise Content Index . . . . . . . . . . . . . . . 55
Management ports . . . . . . . . . . . . 46
Content Services for FileNet Image Services ports . 47

iv Planning for FileNet P8

ibm.com and related resources
Product support and documentation are available from ibm.com®.

Support and assistance

From ibm.com, click Support & downloads and select the type of support that you
need. From the Support Portal, you can search for product information, download
fixes, open service requests, and access other tools and resources.

IBM® Knowledge Center

You can view the product documentation online in IBM Knowledge Center or in
an Eclipse-based information center that you can install when you install the
product. By default, the information center runs in a web server mode that other
web browsers can access. You can also run it locally on your workstation.

Use the following links to view the IBM Knowledge Center online product
documentation that is appropriate for your configuration. For IBM FileNet® P8
documentation, see http://www.ibm.com/support/knowledgecenter/
SSNW2F_5.2.1/. For IBM Content Foundation, see http://www.ibm.com/support/
knowledgecenter/SSGLW6_5.2.1/.

PDF publications

See the PDF publications that are available for your product at the following links:

Product Website
IBM FileNet P8 Platform http://www.ibm.com/support/
publication library docview.wss?uid=swg27042122
IBM Content Foundation http://www.ibm.com/support/
publication library docview.wss?uid=swg27042128

“Contacting IBM”
For general inquiries, call 800-IBM-4YOU (800-426-4968). To contact IBM
customer service in the United States or Canada, call 1-800-IBM-SERV
(1-800-426-7378).

Contacting IBM
For general inquiries, call 800-IBM-4YOU (800-426-4968). To contact IBM customer
service in the United States or Canada, call 1-800-IBM-SERV (1-800-426-7378).

For more information about how to contact IBM, including TTY service, see the
Contact IBM website at http://www.ibm.com/contact/us/.

© Copyright IBM Corp. 2001, 2016 v

vi Planning for FileNet P8
Planning and preparing for FileNet P8 upgrade
To prepare to upgrade your FileNet P8 installation, you must review the upgrade
planning information to determine what kind of upgrade you will carry out. You
must also complete the prerequisite tasks assigned to the various Roles.
“Planning the upgrade”
Carefully review the information provided to plan your FileNet P8 system
upgrade.
“Performing the required upgrade preparation tasks” on page 12
To efficiently carry out the required upgrade preparation tasks, assign a
member of your staff to carry out the tasks assigned to each role.

Planning the upgrade

Carefully review the information provided to plan your FileNet P8 system
upgrade.

In version 5.2, the Content Engine, Process Engine, and Case Analyzer were
combined and now run as a single deployed application. This is the Content
Platform Engine. This content and workflow management software runs on every
application server instance where it is deployed. It is recommended that you
contact your IBM representative to review capacity planning and load balancing
before you upgrade.

All data in the existing global configuration database, object stores, and workflow
system are automatically upgraded when you deploy the upgraded Content
Platform Engine EAR file.
“Upgrade scenarios”
Upgrade planning depends on the details of your existing installation. The
starting version and platform choices all influence the upgrade path of your
existing components.
“Upgrade planning considerations” on page 6
Review all upgrade planning information related to requirements for upgrading
an FileNet P8 system and expansion products, as well as other vendor products
associated with the FileNet P8.
“Definition of upgrade roles” on page 9
Your organization may have different roles, and some of the responsibilities of
listed roles will vary from those assigned by default.
“Using the installation and upgrade worksheet” on page 10
The Installation and Upgrade Worksheet is a Microsoft Excel spreadsheet
(p8_worksheet.xls). The worksheet describes the properties and parameters
required to complete FileNet P8 installation, upgrade, and configuration
programs, and provides a way to record the values you assign to these
properties and parameters.

Upgrade scenarios
Upgrade planning depends on the details of your existing installation. The starting
version and platform choices all influence the upgrade path of your existing
components.

© Copyright IBM Corp. 2001, 2016 1

 Starting with version 5.2, Content Engine, Process Engine, and Case Analyzer are
combined into the Content Platform Engine. The Content Platform Engine server is
installed from a single installation program, and configured and deployed as a
single application server instance.
Table 1. Versions of components that can be upgraded.

Versions of components that can be

Component upgraded to FileNet P8 5.2.1
Content Platform Engine 5.2.0
Content Engine 4.5.1, 5.0.0, or 5.1.0
Process Engine 4.5.1, 5.0.0, or 5.1.0
Application Engine Application Engine software is not being
updated in the 5.2.1 FileNet P8 software
release.

(For upgrades from 5.2.0): The only

requirement is to update Content Platform
Engine client files on all Application Engine
servers.

(For upgrades from 4.5.1, 5.0.0, 5.1.0) Follow

the appropriate version of the Application
Engine upgrade instructions.
Workplace XT Workplace XT software is not being updated
in the 5.2.1 FileNet P8 software release.

(For upgrades from 5.2.0): The only

requirement is to update Content Platform
Engine client files on all Workplace XT
servers.

(For upgrades from 4.5.1, 5.0.0, 5.1.0) Follow

Workplace XT upgrade instructions. See
Installing the latest Content Engine Client
files on Workplace XT servers.
IBM Content Navigator IBM Content Navigator software is not being
updated in the 5.2.1 FileNet P8 software
release.

The only requirement is to update Content

Platform Engine client files on all IBM
Content Navigator servers.
IBM Content Search Services 5.0, 5.1, or 5.2
IBM Legacy Content Search Engine If you are running IBM Legacy Content
Search Engine and you want your system to
retain the ability to do content-based searches
after the upgrade of the system is complete,
you cannot upgrade directly from version
4.5.1 to version 5.2.1 software. You must first
upgrade FileNet P8 to version 5.1 and
complete the migration from IBM Legacy
Content Search Engine to IBM Content
Search Services. You can then upgrade from
version 5.1 to 5.2.1.

2 Planning for FileNet P8

Important: If the system you are upgrading is running WebSphere® Application
Server version 6.1, you must do an upgrade with a migration. The new application
server instance must be deployed on at least version 7 of WebSphere Application
Server.

(For upgrades from versions 4.5.1, 5.0.0 and 5.1.0) Content Engine, Process Engine,
and the following associated components must be upgraded together:
v Application Engine and depending on which version of Application Engine you
are upgrading from, the upgrade could be only the installation of a fix pack.
v IBM FileNet Workplace XT
v IBM Content Search Services
v Rendition Engine
v IBM FileNet Content Federation Services
v Case Analyzer and IBM FileNet Process Simulator can be upgraded at the same
time if you need full access to all case and simulation data after the upgrade.
However, you could upgrade these components later, such as the following
weekend. All backlogged data will be processed after those upgrades are
complete. See the Case Analyzer and IBM FileNet Process Simulator
documentation for information on upgrading those components.

(For upgrades from versions 5.2.0) Content Platform Engine and the following
associated components must be upgraded together:
v Application Engine client files
v IBM FileNet Workplace XT client files
v IBM Content Navigator client files
v IBM Content Search Services
v Rendition Engine
v IBM FileNet Content Federation Services
v Case Analyzer and IBM FileNet Process Simulator can be upgraded at the same
time if you need full access to all case and simulation data after the upgrade.
However, you could upgrade these components later, such as the following
weekend. All backlogged data will be processed after those upgrades are
complete. See the Case Analyzer and IBM FileNet Process Simulator
documentation for information on upgrading those components.

See the FileNet P8 Fix Pack Compatibility Matrices for a list of product-component
versions from which you can start an upgrade. .
“Upgrade on an existing server instance”
You can complete an upgrade on an existing server instance.
“Upgrade with migration to a new server instance” on page 4
An upgrade can be accomplished while also migrating from one server instance
to another. The new server instance could be on new hardware, or could be on
existing hardware. Making such a change is often part of the motivation for
doing the upgrade and it is important to have a well-understood process.

Upgrade on an existing server instance

You can complete an upgrade on an existing server instance.

(For upgrades from 5.2.0) This upgrade scenario assumes you are upgrading
Content Platform Engine on the application server where it is currently deployed
and making configuration changes to that deployment.

Planning and preparing for FileNet P8 upgrade 3

 (For upgrades from 4.5.1, 5.0.0, or 5.1.0) This upgrade scenario assumes you are
upgrading Content Engine on the application server where it is currently deployed
and making configuration changes to that deployment to include Process Engine
information.

| A server that was formerly a Process Engine server could also be used to install
| Content Platform Engine and Case Analyzer. This requires an installation of the
| same application server software that is installed on the other Content Platform
| Engine servers. Handle the configuration of this server like an upgrade with
| migration to a new server instance. Then add the new server as another node in
| the Content Platform Engine application server cluster.

Upgrade with migration to a new server instance

An upgrade can be accomplished while also migrating from one server instance to
another. The new server instance could be on new hardware, or could be on
existing hardware. Making such a change is often part of the motivation for doing
the upgrade and it is important to have a well-understood process.
“Migration upgrade overview and roadmap”
The goal of an upgrade that involves a migration to a new server instance is to
minimize the unavailability of the production system.

Migration upgrade overview and roadmap:

The goal of an upgrade that involves a migration to a new server instance is to

minimize the unavailability of the production system.

Upgrading large FileNet P8 systems involves significant work. The upgrade can be
particularly challenging if you are changing the underlying platform of major
system components, such as Content Platform Engine. Using this approach, you
might install and configure a new server instance, such as for the application
server or database server. The initial installation and configuration work can be
done without impacting the production system.

At a high level, complete the upgrade migration procedures by using the following
steps. Some steps are repeated for each major FileNet P8 component:
v Determine a time when you can run the upgrade, which must be done when
nobody is altering the production system data. The copy of the production data
(replica) must reflect the production system. Otherwise the upgrade is not on
current data.
| v Set up a second system that contains a copy of production data. With this
| approach, you can revert to the original system if you encounter problems
| during the upgrade. You can also do some of the initial installation and
| configuration without impact to the production system. This second system lets
| you move to different server instances, replacing or updating hardware for
| application servers or database servers. Try to reuse as many of the
| configuration settings as possible from the original system on the second system
| to reduce any configuration issues that might arise in the upgrade.
v On the second system, run all upgrade tasks that might alter data in a
production system.
v Typically, the file stores are also relocated to the new platform. If you do not
relocate your file stores, you must take extra steps to ensure that the file stores
can be accessed from the new system.
v Conduct various validation tests that use the production applications on the
upgraded replica system.

4 Planning for FileNet P8

 Migration roadmap
The migration roadmap lists the major steps that are required to upgrade
FileNet P8 onto a different set of servers. Use this roadmap as a template
for your own plan.
Table 2. Steps required to complete a migration upgrade.
Migration task. Where to go for instructions.
h Learn about upgrading FileNet P8. “Upgrade planning considerations” on page 6
h Create a replica of your FileNet P8 environment. This v Version 4.5.1: http://www.ibm.com/support/
scenario involves installing a new environment with the knowledgecenter/SSNW2F_4.5.1/welcome.html
same servers and same version of FileNet P8 as your
v Version 5.0.0: http://www.ibm.com/support/
production system.
knowledgecenter/SSNW2F_5.0.0/
v The GCD, object store, and Process Engine databases in com.ibm.p8toc.doc/ic-homepage.html
the replica must be backups of the databases that are
v Version 5.1.0: http://www.ibm.com/support/
used on the production system. If the database accounts
knowledgecenter/SSNW2F_5.1.0/
required by FileNet P8 are not included in the backup,
com.ibm.p8toc.doc/ic-homepage.html
create new instances of the accounts and use the same ID
and password as on your production system. v Version 5.2.0: http://www.ibm.com/support/
knowledgecenter/SSNW2F_5.2.0/
v The replica must use the same LDAP provider, LDAP
com.ibm.p8toc.doc/
configuration settings, and LDAP-based security accounts
filenetcontentmanager_5.2.0.htm
as the production system.
v The replica application server can start with a new
Configuration Manager profile or a copy of the
production Configuration Manager profile. The
installation instructions have sections for both these
possibilities.
v On the new Content Platform Engine computer, complete
the installation preparation tasks for the Application
Server administrator except for the tasks that are related
to Application Engine or Workplace XT, as these
components are not being upgraded now.
v As part of an upgrade or if you are moving Workplace
XT from 1.1.4 to 1.1.5, you might apply fix packs to
Application Engine or Workplace XT because the older
version is supported by older FileNet P8 releases.
v If you still have a copy of the installation and upgrade
worksheet for your production system, use it to help you
install the replica system. Do not use this older version of
the worksheet for upgrades.
h Download the 5.2.1 installation and upgrade worksheet. “Using the installation and upgrade worksheet” on
Run the customization macro and select Upgrade for the page 10
Procedure Type option. Use the customized worksheet to
enter values that are required for an upgrade.
h Prepare the replica for upgrade. Follow the steps in the “Performing the required upgrade preparation
upgrade preparation instructions. tasks” on page 12

Depending on your replica system, not all upgrade

preparation instructions apply to migration upgrades.
h Upgrade the replica. Follow the steps in the 5.2.1 upgrade
instructions. Upgrade instructions have separate sections for
whether you are working with a new configuration profile
in the replica or copied your former configuration profile
into the replica.
h When the replica system is tested and is ready for
production, disconnect the former system and make the
replica your new production system.

Planning and preparing for FileNet P8 upgrade 5

 Tip: Because large-system upgrades involve interacting with many system
components, a common approach is to go through a test upgrade run first. In this
scenario, you complete the upgrade on a test system, and then discard the test
system after you verify the integrity of the upgrade. You preserve the original
production system in case the upgrade fails and to minimize outages to the
production system. Running a test upgrade first takes more time than doing the
upgrade immediately, but it can minimize risk. The test upgrade approach involves
extra steps to completely replicate the production data. Replication is needed to
simulate production activities by using a duplicated system.

You can practice the upgrade of your production environment by using either of
these two methods:
v Upgrade the lower environments first by running practice upgrades in the
following order:
– Upgrade the development environment
– Upgrade the various test environments
– Upgrade the production environment
This method tests the process and validate that your applications are functioning
correctly at each environment level before you move production to the next
level.
v Practice the upgrade of the production environment by using the new
production environment.
– Early in the project cycle, copy the existing production databases and file
storage areas into the new environment
– Each time that you practice the upgrade, you apply only the updates that
were made to the data since the last practice run.
This method reduces the time that is needed to complete the final upgrade in
the required maintenance window. All of the required FileNet P8 and custom
application software is already installed in the new environment. You run only
incremental changes to the replicas of databases and file storage areas.

Upgrade planning considerations

Review all upgrade planning information related to requirements for upgrading an
FileNet P8 system and expansion products, as well as other vendor products
associated with the FileNet P8.
“Upgrade system requirements for FileNet P8” on page 7
Before you upgrade FileNet P8, verify that all components are at the minimum
supported versions, including fix pack levels.
“Upgrade system requirements for FileNet P8 expansion products” on page 7
To upgrade the FileNet P8 Platform expansion products, in addition to the tasks
described in those products' own Installation and Upgrade Guides, you must
carry out certain tasks regarding Content Platform Engine.
“Upgrading or migrating the underlying vendor software supported by Content
Platform Engine” on page 8
To remain in a supported configuration, some upgrade scenarios might require
that you also upgrade or migrate the underlying vendor software, such as the
application server or database server software.
“Planning Process Engine upgrades (versions 4.5.1, 5.0.0, 5.1.0)” on page 8
Upgrades of versions 4.5.1, 5.0.0, and 5.1.0 require the use of a Process Engine
upgrade wizard.

6 Planning for FileNet P8

Upgrade system requirements for FileNet P8
Before you upgrade FileNet P8, verify that all components are at the minimum
supported versions, including fix pack levels.

Apply the required minimum level FileNet P8 software updates for the release you
are currently running before you upgrade.

Applying a fix pack for one component might require fix packs for other
components. Prior to applying any fix pack, review the FileNet P8 Fix Pack
Compatibility Matrices to ensure compatibility between all installed components.

Upgrade system requirements for FileNet P8 expansion products

To upgrade the FileNet P8 Platform expansion products, in addition to the tasks
described in those products' own Installation and Upgrade Guides, you must carry
out certain tasks regarding Content Platform Engine.
“FileNet P8 eForms”
If FileNet P8 eForms is installed, undeploy it before upgrading Application
Engine. You can redeploy after the Application Engine upgrade is completed.
“Content Federation Services”
IBM FileNet Content Federation Services must be at the same version level as
Content Platform Engine.
“IBM Enterprise Records”
Depending upon which version of the records management product you are
using, there are tasks you must perform before you upgrade your Content
Platform Engine software. You must use different upgrade tools depending on
the version of records management software you are running.

FileNet P8 eForms:

If FileNet P8 eForms is installed, undeploy it before upgrading Application Engine.

You can redeploy after the Application Engine upgrade is completed.

For more information, see the appropriate topics for upgrading in the IBM FileNet
P8 eForms Installation and Upgrade Guide.

Content Federation Services:

IBM FileNet Content Federation Services must be at the same version level as
Content Platform Engine.

If IBM FileNet Content Federation Services is not at the same version level as
Content Platform Engine, shut it down and upgrade it to the same version level
after Content Engine has been upgraded.

For more information, see readme file that accompanied the latest IBM FileNet
Content Federation Services fix pack.

IBM Enterprise Records:

Depending upon which version of the records management product you are using,
there are tasks you must perform before you upgrade your Content Platform
Engine software. You must use different upgrade tools depending on the version of
records management software you are running.

Planning and preparing for FileNet P8 upgrade 7

 For more information, see the appropriate topic for upgrading your object stores in
the IBM Enterprise Records Installation and Upgrade Guide.

Upgrading or migrating the underlying vendor software

supported by Content Platform Engine
To remain in a supported configuration, some upgrade scenarios might require that
you also upgrade or migrate the underlying vendor software, such as the
application server or database server software.

Upgrading the underlying vendor software

For specifics on how to upgrade the underlying vendor software, see the
appropriate vendor documentation. Complete these vendor software upgrades
before you begin the upgrade but as part of the entire upgrade process.

Migrating the underlying vendor software

As an alternative to upgrading the existing instances of the underlying software,

you can choose to use a migration process. Migration involves creating a new
instance of the underlying software and then moving data and configuration
settings. Some steps in the upgrade procedures show where you must complete
different actions when you use a new application server or database server
instance.

| Important: If the system you are upgrading is running WebSphere Application

| Server, you must upgrade WebSphere Application Server with a migration. The
| new application server instance must be deployed on a later version of WebSphere
| Application Server. For more information, see IBM FileNet P8 system requirements.

Any new databases into which you migrate data must be populated by using the
database vendor’s appropriate database tools, such as backup and restore tools or
export and import tools. Perform database migration tasks only after you shut
down existing Content Platform Engine software and back up the databases. These
shutdown and backup actions help to ensure that all data that was in production is
moved to the new upgraded system.

Planning Process Engine upgrades (versions 4.5.1, 5.0.0, 5.1.0)

Upgrades of versions 4.5.1, 5.0.0, and 5.1.0 require the use of a Process Engine
upgrade wizard.

Upgrading Process Engine 4.5.1, 5.0.0, or 5.1.0 requires the following steps, which
are explained in the upgrade instructions:
v Install the Content Platform Engine and IBM Case Foundation 5.2.1 software on
an existing Content Engine application server or on a new application server.
v Define data sources for any Process Engine database that is not already shared
with an object store.
v Deploy the combined Content Platform Engine on the application server.
v Run the pre-upgrade wizard to gather configuration information for Process
Engine. Upon completion of the wizard, the upgrade of the Process Engine
database and isolated regions starts.

After the upgrade, the Process Engine is no longer a separate component. There is
a single deployment of both the Process Engine and Content Engine components in
the new Content Platform Engine. Each existing Process Engine database becomes

8 Planning for FileNet P8

 a legacy workflow system in the Content Platform Engine. You administer legacy
workflow systems, as well as new workflow systems, with the Administration
Console for Content Platform Engine.

| To move a legacy workflow system to the 5.2 style collocation model, you use the
| Region Move tool that is provided under Tools in the installation package. For
| detailed information on how to run the Region Move tool, see
| http://www-01.ibm.com/support/docview.wss?uid=swg27036552.

There are no longer any dependencies on the IBM FileNet Image Services software
and no IBM FileNet Image Services software is installed. You can remove the older
versions of Process Engine and IBM FileNet Image Services after successfully
installing the Content Platform Engine software and upgrading the database.

The Database administrator and FileNet P8 administrator upgrade tasks provide

more details.

Definition of upgrade roles

Your organization may have different roles, and some of the responsibilities of
listed roles will vary from those assigned by default.

The tasks in this guide as well as the rows in the Installation and Upgrade
Worksheet are organized by administrative roles, listed below.

| Installation administrator
| v Runs the FileNet P8 component installers and upgrade programs.
| v Runs the FileNet Configuration Manager tool, followed by launching IBM
| Administration Console for Content Platform Engine.
| v Abbreviated as IA®. Responsible for coordinating the information described in
| this worksheet. The information itself will require the input from the other roles.

| The role of IA is usually filled by a FileNet P8 Certified Professional (FCP).

Information technology administrator

v Responsible for the networking and operating systems settings required by the
FileNet P8 components.
v Responsible for performing certain security configurations.
v Abbreviated as ITA. Responsible for providing the information in the rows in
the Installation and Upgrade Worksheet with a value of ITA in the Role column.

For tasks assigned to the ITA, see “IT administrator upgrade tasks” on page 13.

Security administrator
v Responsible for configuring the directory servers required by FileNet P8
components.
v Creates and maintains directory server user and group accounts.
v Abbreviated as SA. Responsible for providing the information in the rows in the
Installation and Upgrade Worksheet with a value of SA in the Role column.

For tasks assigned to the SA, see “Security administrator upgrade tasks” on page
21.

Planning and preparing for FileNet P8 upgrade 9

 Database administrator
v Creates, configures, maintains database installations and databases or table
spaces.
v Responsible for creating database accounts needed by FileNet P8 Platform
components.
v Performs database backups.
v For purposes of this documentation, the database administrator is expected to
have responsibilities regarding the Java™ Database Connectivity (JDBC) data
sources.
v Abbreviated as DBA. Responsible for providing the information in the rows in
the Installation and Upgrade Worksheet with a value of DBA in the Role column.

For tasks assigned to the DBA, see “Database administrator upgrade tasks” on
page 23.

Application server administrator

v Responsible for providing the application servers required by FileNet P8
Platform components.
v Responsible for application server administrative accounts.
v Abbreviated as ASA. Responsible for providing the information in the rows in
the Installation and Upgrade Worksheet with a value of ASA in the Role column.

For tasks assigned to the ASA, see “Application Server administrator upgrade
tasks” on page 26.

FileNet P8 administrator
v This role designation actually refers to the administrator or administrators who
perform regular maintenance of Content Platform Engine and any client
applications.
v The administrator who logs on to IBM Administration Console for Content
Platform Engine using the gcd_admin account or an object_store_admin account is
considered an FileNet P8 administrator.
v Abbreviated as P8A. Responsible for providing the information in the rows of
the Installation and Upgrade Worksheet with a value of P8A in the Role column.

For tasks assigned to the P8A, see “FileNet P8 administrator upgrade tasks” on
page 29.

Using the installation and upgrade worksheet

The Installation and Upgrade Worksheet is a Microsoft Excel spreadsheet
(p8_worksheet.xls). The worksheet describes the properties and parameters
required to complete FileNet P8 installation, upgrade, and configuration programs,
and provides a way to record the values you assign to these properties and
parameters.

Administrators who are preparing the environment for installation or upgrade of

FileNet P8 components must use the worksheet during their preparation tasks to
record the appropriate values and provide them to the Installation Administrator
who runs the installation or upgrade programs.

Some of the features of the Installation and Upgrade Worksheet are:

10 Planning for FileNet P8

v Instructions: describes the worksheet and includes a button that runs the
Customize Worksheet macro.
v The two highlighted columns, Property or Parameter and ENTER YOUR
VALUE HERE, provide the simplest view of the requirement. The others add
identifying information and help you sort and filter the rows usefully.
v The Role column assigns each row to an administrator and uses the following
acronyms:
– IA: Installation Administrator
– ITA: Information Technology Administrator
– ASA: Application Server Administrator
– DBA: Database Administrator
– SA: Security Administrator
– P8A: FileNet P8 Administrator
v Property definitions are contained in the column titled Description.
v Some rows, though not all, contain a hyperlink in the IC help link column.
Click this hyperlink to run a query against the online documentation, which
opens with the Search Results pane showing the topics that contain the words in
the query phrase. Browse the search results until you have enough information
to be able to enter a value in the Worksheet row.
“Running the Customize Worksheet macro”
The Customize Worksheet macro lets you extract only those rows that describe
your environment.
“Autofiltering and sorting the Worksheet” on page 12
There are several ways to organize the Worksheet to make finding properties
and entering values easier.

Running the Customize Worksheet macro

The Customize Worksheet macro lets you extract only those rows that describe
your environment.

Important: For support of the full range of built-in filter and macro features, use
Microsoft Excel to view the Installation and Upgrade Worksheet file. You can use
other spreadsheet programs to view the file; however, filter and macro support can
vary. For example, in Calc from OpenOffice.Org, the column filters work as
expected, but the Customize Worksheet button does not.

To run the Customize Worksheet macro:

1. Open the Installation and Upgrade Worksheet (p8_worksheet.xls) and click the
Instructions worksheet (also called a tab).
2. Scroll down until you see the button representing the Customize Worksheet
macro. Click the button.
3. Select the components and options that describe the environment you are
preparing for FileNet P8.
v Installation or Upgrade
v FileNet P8 Components
v Application Server type
v Operating system
v Database type
v Directory Server type
v Number of object stores (adds new sets of rows for creating additional data
sources)
Planning and preparing for FileNet P8 upgrade 11
 v Name of customized sheet
4. Click OK. The macro copies the rows that fulfill your selection criteria into a
new worksheet with the name you entered. Enter the values for your
environment into this new worksheet.
5. Click the name of the new worksheet at the bottom of the Excel window. Add
your preparation values into this new worksheet.
6. Notice that the new worksheet has buttons at the top titled Show Installer
View and Show Full View, depending on its state. The Show Installer View
displays only those columns that you need while running installation or
configuration programs.

Autofiltering and sorting the Worksheet

There are several ways to organize the Worksheet to make finding properties and
entering values easier.

AutoFiltering is a quick way to display only those rows that meet a certain
criterion.

To use AutoFilter:
1. Make sure AutoFiltering is enabled. (Select the entire row with the column
headers, then click Data > Filter > Autofilter.) AutoFilter arrows will appear to
the right of the column labels.
2. Click the AutoFilter arrow in the Installation or Configuration Program
column header and select the program you are interested in (for example, CPE
installer).
3. For a custom AutoFilter, click the AutoFilter arrow in any column header,
select Custom, and use the dialog box to define a filter that will show rows
that meet your criteria.
4. To turn off AutoFiltering in a column, click the column AutoFilter arrow and
select (All).
5. To reorder rows alphabetically, do a Sort:
a. Click anywhere in a column, for example, Column A Role.
The only possible values in the Role column are ASA, SA, DBA, ITA, and
P8A. Sorting on Role therefore groups the rows by this attribute, in
alphabetic order. Several other columns also have a limited number of
possible values which means they can be usefully sorted.
b. Click the Sort Ascending icon in the Excel toolbar, or use the Data > Sort
menu command. The rows sort on Role.
Sorting the Worksheet reassigns row numbers. If you refer to rows by
number, be aware that row numbers change if you change the sort order.

Performing the required upgrade preparation tasks

To efficiently carry out the required upgrade preparation tasks, assign a member of
your staff to carry out the tasks assigned to each role.

To prepare the FileNet P8 environment, complete the tasks assigned to each role.
Some tasks require input that results from other preparation tasks performed by
other administrator roles. For information about assigning and defining these roles,
see “Definition of upgrade roles” on page 9.

While performing the tasks, record the results in the Installation and Upgrade
Worksheet where indicated.

12 Planning for FileNet P8

 “IT administrator upgrade tasks”
The Information Technology administrator must prepare the network and
operating systems, and carry out certain security configurations to prepare your
environment for FileNet P8 upgrade.
“Security administrator upgrade tasks” on page 21
The Security administrator must prepare the security environment for FileNet
P8 upgrade, including planning the security environment, and creating
accounts.
“Database administrator upgrade tasks” on page 23
The Database administrator prepares the databases required for FileNet P8
upgrade.
“Application Server administrator upgrade tasks” on page 26
The Application Server Administrator must prepare the application servers for
FileNet P8 upgrade.
“FileNet P8 administrator upgrade tasks” on page 29
The FileNet P8 administrator must carry out several tasks to prepare your
environment for your FileNet P8 upgrade.

IT administrator upgrade tasks

The Information Technology administrator must prepare the network and
operating systems, and carry out certain security configurations to prepare your
environment for FileNet P8 upgrade.
v Review all rows assigned to the IT Administrator for Upgrade in the
Installation and Upgrade Worksheet. Provide values for any rows appropriate to
your installation that you have not yet completed.

Tip: With the Data > Filter > AutoFilter command enabled, as it is by default in
the shipping worksheet file (p8_worksheet.xls), perform the following actions to
quickly see only the properties assigned to a particular role:
–Click the AutoFilter drop-down arrow in the Role column header and select
ITA.
– Further filter the result set by clicking the AutoFilter drop-down arrow in
any of the other columns and selecting a value or clear a filter by selecting
All.
v Configure the operating systems to prepare for component upgrade.
“Creating operating system accounts for upgrades”
Operating system accounts are required during the upgrade process.
“Configuring AIX, HPUX, HPUXi, Linux, Linux on System z, and Solaris” on
page 17
Prepare your AIX®, HPUX, HPUXi, Linux, Linux on System z®, or Solaris-based
server for FileNet P8.
“Configuring operating system elements” on page 20
Configure the network to prepare for your FileNet P8 upgrade. You must
ensure proper network communications and access rights.
“Using IBM Support data collection tools” on page 20
The IBM Support data collection tools can help you troubleshoot problems with
your installed IBM FileNet P8 products by collecting and analyzing
problem-related diagnostic data.

Creating operating system accounts for upgrades

Operating system accounts are required during the upgrade process.

Accounts are referred to in documentation in the following ways:

Planning and preparing for FileNet P8 upgrade 13
 v By a display name; for example, Database User Name. An account's display
name is how the FileNet P8 user interface, such as a setup program or dialog
box, refers to the account. Many accounts have both a display name and a
variable.
v By a variable designator; for example cpe_db_user, using lower-cased italics and
underscores. The variable is intended to show that you must designate your
own account to act in the role described by the variable. The variable is the
unique identifier for a particular account.

If you see a reference to an account that you do not understand, search the
documentation for that reference.
“Creating the Content Platform Engine installer account”
An operating system account you use to install Content Platform Engine.
“Creating the Process Engine upgrade account (upgrades from versions 4.5.1,
5.0.0, 5.1.0)” on page 15
An operating system account you use to run the Process Engine upgrade
wizard.
“Creating Configuration Manager user” on page 15
An operating system account you use to run Configuration Manager.
“Creating the Content Platform Engine application server installation account”
on page 16
Create a new or designate an existing application server account to be used
while upgrading Content Platform Engine.
“Creating the Content Platform Engine application server installation group” on
page 17
An operating system group account to which several Content Platform Engine
accounts must belong.

Creating the Content Platform Engine installer account:

An operating system account you use to install Content Platform Engine.

If you are upgrading on the same machine where Content Platform Engine (or
Content Engine) was previously installed, use the same installer account that you
originally used to install that software. The installation program requires this to
detect that it is an upgrade and to use the same installation path.

If you are upgrading on a new machine, where Content Platform Engine has never
been installed, create the cpe_install_user as explained here.

If your operating system is AIX, HPUX, HPUXi, Linux, Linux on System z, or

Solaris and you do not know the account that was used to install Content Platform
Engine (or Content Engine), skip this procedure and see the procedure Assigning
directory permissions to a new installer account on AIX, HPUX, HPUXi, Linux,
Linux on System z, or Solaris.
1. If installing Content Platform Engine on AIX, HPUX, Linux, Solaris, create the
following operating system account:
Content Platform Engine installer account (AIX, HPUX, HPUXi, Linux, Linux
on System z, or Solaris)
Unique identifier
cpe_install_user

14 Planning for FileNet P8

 Description
An operating system account used to run the Content Platform
Engine installation program.
Minimum required permissions
Use your administrative tools to grant cpe_install_user at least
the following permissions:
v Read, write, and execute permissions to the device or
location where:
– Content Platform Engine is to be installed.
– The application server instance/domain/profile has been
installed.
v Write permission to the directories where you create file
storage areas, index areas, and content caches.
v Write permission on the /tmp directory.
v Membership in the cpe_appserver_install_group.

2. Record this value in your customized Installation and Upgrade Worksheet.

To find this property, search the worksheet for instances of cpe_install_user.

Creating the Process Engine upgrade account (upgrades from versions 4.5.1, 5.0.0,
5.1.0):

An operating system account you use to run the Process Engine upgrade wizard.
1. Create the following operating system account:
Process Engine upgrade user account
Unique identifier
pe_upgrade_user
Description
v A directory server user account that has Full Control access
rights to the FileNet P8 domain, and has also been granted
rights through its membership in the
workflow_system_admin_group.
v Content Platform Engine permissions can be granted by a
gcd_admin who uses IBM Administration Console for Content
Platform Engine to add the pe_upgrade_user to the ACL of the
FileNet P8 domain and grant it Full Control.
v Use your directory server tools to add the pe_upgrade_user to
the workflow_system_admin_group. The
workflow_system_admin_group in the current release is the
same as the pe_admin_group that you created in the previous
release.
Minimum required permissions
v Full Control access rights on the FileNet P8 domain.
v Membership in the workflow_system_admin_group.

2. Record this value in your customized Installation and Upgrade Worksheet.

To find this property, search the worksheet for instances of pe_upgrade_user.

Creating Configuration Manager user:

An operating system account you use to run Configuration Manager.

Planning and preparing for FileNet P8 upgrade 15

 If you are upgrading on the same machine where Content Platform Engine (or
Content Engine) was previously installed, use the same Configuration Manager
user account that you originally used during installation. The program requires
this to detect that it is an upgrade and to use the same installation values.

If you are upgrading on a new machine, where Content Platform Engine (or
Content Engine) has never been installed, create config_mgr_user, as explained here.
1. Create the following operating system account:
Configuration Manager user
Unique identifier
config_mgr_user
Description
An operating system account you will use to run Configuration
Manager.
Minimum required permissions
config_mgr_user must belong to the cpe_appserver_install_group.

2. Record this value in your customized Installation and Upgrade Worksheet.

To find this property, search the worksheet for instances of config_mgr_user.

Creating the Content Platform Engine application server installation account:

Create a new or designate an existing application server account to be used while

upgrading Content Platform Engine.

Create this account if it does not already exist. The upgrade instructions tell you
when to use it. In earlier releases, this account was identified as
ce_appserver_install_user.
1. Create the following operating system account:
Content Platform Engine application server installation administrator
Unique identifier
cpe_appserver_install_user
Description
The cpe_appserver_install_user account is needed during the
installation process to perform the following tasks:
v Create and configure the application server for Content
Platform Engine.
v Start or stop the application server when needed.
v Modify the application server files or directories as needed
for deploying Content Platform Engine using the
Configuration Manager tool.
v Provide create, read and write permissions for directories on
devices or drives that are used for external Content Platform
Engine file storage.
cpe_appserver_install_user must belong to the
cpe_appserver_install_group.
Minimum required permissions
Use your local machine's administrative tools to grant
cpe_appserver_install_user at least the following permissions:

16 Planning for FileNet P8

 v For UNIX, cpe_appserver_install_user must have read, write,
and execute permissions to the Content Platform Engine
installation directory.

2. Record this value in your customized Installation and Upgrade Worksheet.

To find this property, search the worksheet for instances of
cpe_appserver_install_user.

Creating the Content Platform Engine application server installation group:

An operating system group account to which several Content Platform Engine

accounts must belong.

Create this account if it does not already exist. The upgrade instructions tell you
when to use it. In earlier releases, this account was identified as
ce_appserver_install_group.
1. Create the following operating system account:
Content Platform Engine application server installation group
Unique identifier
cpe_appserver_install_group
Description
An operating system group account. You will be instructed to
grant certain permissions to this group during Content Platform
Engine installation and configuration.
The user accounts in cpe_appserver_install_group will perform the
following tasks:
v Give operating system privileges to the directories used for
Content Platform Engine installation and for the application
server's instance/domain/profile.
v Configure and deploy the Content Platform Engine EAR files
which require access to the application server's
instance/domain/profile directories.
v Have permissions on devices/drives to read and write that
are designated for external Content Platform Engine file
storage.
Minimum required permissions
Use your local machine's administrative tools to add the
following accounts to this group:
v cpe_appserver_install_user
v cpe_install_user
v config_mgr_user

2. Record this value in your customized Installation and Upgrade Worksheet.

To find this property, search the worksheet for instances of
cpe_appserver_install_group.

Configuring AIX, HPUX, HPUXi, Linux, Linux on System z, and

Solaris
Prepare your AIX, HPUX, HPUXi, Linux, Linux on System z, or Solaris-based
server for FileNet P8.
“Configuring AIX, HPUX, HPUXi, Linux, Linux on System z, and Solaris
FileNet P8 servers (all components)” on page 18

Planning and preparing for FileNet P8 upgrade 17

 To ensure hosts file contents, the /etc/hosts file must have the Internet
Protocol (IP) address of the servers to be used.
“Configuring Content Platform Engine servers (AIX, HPUX, HPUXi, Linux,
Linux on System z, and Solaris)”
The system checks for the default file-creation permissions for the user who
will upgrade Content Platform Engine.
“Assigning directory permissions to a new installer account on AIX, HPUX,
HPUXi, Linux, Linux on System z, or Solaris” on page 19
Upgrades of the Content Platform Engine (or Content Engine) software are
normally done by the same user who originally installed the software. If this is
account cannot be used for some reason, designate a new account and assign
certain directory permissions to it.

Configuring AIX, HPUX, HPUXi, Linux, Linux on System z, and Solaris FileNet
P8 servers (all components):

To ensure hosts file contents, the /etc/hosts file must have the Internet Protocol
(IP) address of the servers to be used.
1. Ensure hosts file contents. On each AIX, HPUX, HPUXi, Linux, Linux on
System z, or Solaris-based FileNet P8 server that does not use DNS (Domain
Name Service) or NIS (Network Information Service), the /etc/hosts file must
contain the name and IP address of all servers it will communicate with,
including the remote database server, if applicable.
2. Consult with the application server, database, and FileNet P8 administrators to
determine port requirements for all the servers in your environment. For
details, see Appendix B, “FileNet P8 ports,” on page 39.

Configuring Content Platform Engine servers (AIX, HPUX, HPUXi, Linux, Linux
on System z, and Solaris):

| The system checks for the default file-creation permissions for the user who will
| upgrade Content Platform Engine.
Content Platform Engine running on an AIX, HPUX, HPUXi, Linux, Linux on
System z, or Solaris-based application server
Use the umask utility program to set the default file-creation permissions
mask for the Java Virtual Machine (JVM) instance that hosts Content
Platform Engine so that the owner (the user running JVM) and the
members of the owners group have read/write/execute access
permissions, and all others have no access:
umask u=rwx,g=rwx,o=

This mask setting ensures that the access permissions on files and
directories created by Content Platform Engine are identical to those you
must specify when creating file storage areas on AIX, HPUX, HPUXi,
Linux, Linux on System z, or Solaris file servers.

Tip: This umask setting is required for the user (cpe_install_user) who runs
the Content Platform Engine installer program, but does not need to be in
the .profile file of the user.

18 Planning for FileNet P8

Assigning directory permissions to a new installer account on AIX, HPUX,
HPUXi, Linux, Linux on System z, or Solaris:

Upgrades of the Content Platform Engine (or Content Engine) software are
normally done by the same user who originally installed the software. If this is
account cannot be used for some reason, designate a new account and assign
certain directory permissions to it.

If the old cpe_install_user account, the one you used to install Content Platform
Engine (or Content Engine) is not available, use the following procedure to assign
the necessary directory permissions to a new and different cpe_install_user user
account which you will use to upgrade Content Platform Engine:
1. Make sure you know the old cpe_install_user account. If you do not know, log
on to the application server as any user and run the ls -l command from a
shell prompt to determine the ownership of the Content Platform Engine (or
Content Engine) installation directory and the files it contains. The default
installation directory is one of the following locations:
v Default path on version 4.5: /opt/FileNet/ContentEngine
v Default path on version 5: /opt/IBM/FileNet/ContentEngine

Important: If the old cpe_install_user no longer exists, contact IBM Software

Support for assistance.
2. Designate an operating system account that will become the new
cpe_install_user.
3. Log on to the application server as the old cpe_install_user, navigate to the
ContentEngine directory, and recursively give ownership of this directory and
all its files and subdirectories to the new cpe_install_user account. For example,
if Content Platform Engine (or Content Engine) is installed at
/opt/FileNet/ContentEngine, run the following command to give ownership
to the new cpe_install_user:
chown -R cpe_install_user /opt/FileNet/ContentEngine
4. Log on to the application server as the appserver_admin user who initially
installed the application server and created the application server instance.
5. Navigate to the application server instance directory and give group rights to
the cpe_appserver_install_group (whose members are the cpe_install_user and
cpe_appserver_install_user). For example:
chgrp -R cpe_appserver_install_group /opt/IBM/Websphere/Appserver
/profiles/Appsvr01
6. Give cpe_appserver_install_group read/write permissions. For example:
chmod -R 775 /opt/IBM/Websphere/Appserver/profiles/Appsvr01
7. Log off the application server and log back on as the new cpe_install_user.
8. Grant read, write, and execute permissions on the Content Platform Engine
directories to the new cpe_install_user, as follows:
chmod -R +rwx /opt/FileNet/ContentEngine
9. Copy the Install Shield directory from the $HOME directory of the old
cpe_install_user to the $HOME of the new cpe_install_user, and grant read, write,
and execute permissions to the new cpe_install_user.

10. Record the value of the new cpe_install_user in your customized

Installation and Upgrade Worksheet. To find this property, search the
worksheet for instances of cpe_install_user.

Planning and preparing for FileNet P8 upgrade 19

 Configuring operating system elements
Configure the network to prepare for your FileNet P8 upgrade. You must ensure
proper network communications and access rights.
“Configuring network communications”
Ensure that your TCP/IP settings are configured so that your servers and
clients can communicate with one another.
“Synchronizing machine clocks”
FileNet P8 processes require that you synchronize the clocks on all of the
machines that are running FileNet P8 servers and FileNet P8 clients.

Configuring network communications:

Ensure that your TCP/IP settings are configured so that your servers and clients
can communicate with one another.

Complete the following prerequisite tasks in any order:

v Ensure TCP/IP settings. Verify the TCP/IP settings on the UNIX and Windows
servers and IBM Administration Console for Content Platform Engine clients
that are configured for FileNet P8 enable the servers and clients to communicate
with one another.
v Ensure NetBIOS over TCP/IP is enabled on Windows.
v Ensure availability of required port numbers. Several port numbers are required
by the various FileNet P8 components. Appendix B, “FileNet P8 ports,” on page
39

Synchronizing machine clocks:

FileNet P8 processes require that you synchronize the clocks on all of the machines
that are running FileNet P8 servers and FileNet P8 clients.
1. Make sure that the machine clocks on all FileNet P8 servers, including Content
Platform Engine, Application Engine, as well as all database servers and those
of FileNet P8 client applications including Workplace XT, Rendition Engine,
IBM Case Manager, and so on, are synchronized. Errors that might arise if they
are not synchronized include those of authentication, cooperative locking,
communication between servers, and others.
| 2. You can run a clock synchronization utility to synchronize all of the clocks on
| your Java virtual machines with a reliable time source. If the clocks get out of
| sync by 60 seconds or more, you can configure a scheduler in the clock
| synchronization utility to periodically synchronize the time of the clocks.

Using IBM Support data collection tools

The IBM Support data collection tools can help you troubleshoot problems with
your installed IBM FileNet P8 products by collecting and analyzing
problem-related diagnostic data.

IBM Support data collection tools automate the gathering and sending of
appropriate diagnostic data to IBM Support for investigation and resolution of
installation, upgrade, or runtime problems in IBM FileNet P8 products. Typically
you would run an IBM Support data collection tool after installing or upgrading
the product, or when the IBM FileNet P8 system is in production.

To use an IBM Support data collection tool, your IBM FileNet P8 product must be
supported by the tool and must have Internet access to the IBM Support back-end
servers where the collected data is analyzed. If your product does not meet these

20 Planning for FileNet P8

 requirements, IBM Support can assist you in determining the most effective
manual method to collect and deliver the diagnostic data for analysis.

Two IBM Support Assistant data collection tools are available, at the IBM Support
Assistant Data Collectors website:
v IBM Support Assistant Data Collector is a web-based tool that can be used at
any time; there is nothing to install.
v IBM Support Assistant Lite Data Collector must be installed on the servers
where you installed or upgraded your IBM FileNet P8 products before it can be
used. By installing the tool before your IBM FileNet P8 system goes into
production, you avoid the possibility of not being able to install it after a
runtime problem occurs.

To determine which IBM Support data collection tool supports your IBM FileNet
P8 product:
1. Browse to the IBM Support Assistant Data Collectors website.
2. Find an IBM Support data collection tool that supports your product:
v To determine whether IBM Support Assistant Data Collector supports your
product, complete the following substeps:
a. Click the Data Collectors tab on the IBM Support Assistant Data
Collectors home page, and then click Launch.
b. Expand the I need to collect data for drop-down list. If your product is
listed, then you can use IBM Support Assistant Data Collector.
v To determine whether IBM Support Assistant Lite Data Collector supports
your product, complete the following substeps:
a. Click the Data Collectors tab on the IBM Support Assistant Data
Collectors home page.
b. Choose Enterprise Content Management in the Select a brand to begin
the download process drop-down list.
c. Expand the Select a product to access the download page drop-down
list. If your product is listed, then you can use IBM Support Assistant Lite
Data Collector.
3. Follow the instructions on the web page for the tool that supports your product
to use the tool directly or to install it, as needed.

Security administrator upgrade tasks

The Security administrator must prepare the security environment for FileNet P8
upgrade, including planning the security environment, and creating accounts.
v Review all rows assigned to the Security Administrator (SA) for upgrades in the
Installation and Upgrade Worksheet. Provide values for any rows appropriate to
your installation that you have not yet completed.

Tip: With the Data > Filter > AutoFilter command enabled, as it is by default in
the worksheet file (p8_worksheet.xls), perform the following actions to quickly
see only the properties assigned to a particular role:
– Click the AutoFilter drop-down arrow in the Role column header and select
SA.
– Further filter the result set by clicking the AutoFilter drop-down arrow in
any of the other columns and selecting a value or clear a filter by selecting
All.

Planning and preparing for FileNet P8 upgrade 21

 “Security upgrade planning considerations”
Review the security requirements for systems being upgraded.
“Creating Content Platform Engine directory server accounts for upgrades”
Create new or designate existing directory server installation accounts for
Content Platform Engine.

Security upgrade planning considerations

Review the security requirements for systems being upgraded.
v It is a best practice not to change realms (your authenticated users and groups),
during an upgrade.
v If the new Content Platform Engine version does not support the directory
server (LDAP) version you are already using, migrate the LDAP directory before
upgrading.
v Contact your IBM FileNet representative if you intend to change directory
servers.

Creating Content Platform Engine directory server accounts for

upgrades
Create new or designate existing directory server installation accounts for Content
Platform Engine.

Accounts are referred to in documentation in the following ways:

v By a display name; for example, Database User Name. An account's display
name is how the FileNet P8 user interface, such as a setup program or dialog
box, refers to the account. Many accounts have both a display name and a
variable.
v By a variable designator; for example cpe_db_user, using lower-cased italics and
underscores. The variable is intended to show that you must designate your
own account to act in the role described by the variable. The variable is the
unique identifier for a particular account.

If you see a reference to an account that you do not understand, search the
documentation for that reference.
“Creating the application server administrative console user (WebSphere
Application Server)”
An LDAP account to which you have granted the WebSphere Application
Server administrative role.

Creating the application server administrative console user (WebSphere

Application Server):

An LDAP account to which you have granted the WebSphere Application Server
administrative role.

Create this account if it does not already exist. The upgrade instructions tell you
when to use it.
1. Create the following directory service account:
WebSphere administrative console user
Unique identifier
appserver_console_user
Description
The appserver_console_user account is an LDAP account to which

22 Planning for FileNet P8

 you have granted the WebSphere Application Server
administrative role so that it can log in to the WebSphere
administrative console.
v If your WebSphere repository type is Stand-alone LDAP
registry, when you run the Configuration Manager Configure
LDAP task, enter the credentials of a valid LDAP user
account to be the appserver_console_user for the entry labeled
Administrative console user name. Configuration Manager
grants this account WebSphere administrative console
administrative rights. Alternatively, you can enter an LDAP
account that you have already configured as a console
administrator.
v If your WebSphere Application Server LDAP repository type
is Federated repositories, you can use the same user account
defined as your appserver_admin. However, if you specify a
user for the Administrative console user name that is
different from appserver_admin, it must be unique across all
federated realms including the WebSphere Application Server
local file-based repository.

2. Record this value in your customized Installation and Upgrade Worksheet.

To find this property, search the worksheet for instances of
appserver_console_user.

Database administrator upgrade tasks

The Database administrator prepares the databases required for FileNet P8
upgrade.
v Review all rows assigned to the Database Server Administrator in the
Installation and Upgrade Worksheet. While you complete the following
preparation tasks, provide values for the rows that are appropriate to your
installation.

Tip: With the Data > Filter > AutoFilter command enabled, as it is by default in
the worksheet file (p8_worksheet.xls), perform the following actions to quickly
see only the properties assigned to a particular role:
– Click the AutoFilter drop-down arrow in the Role column header and select
DBA.
– Further filter the result set by clicking the AutoFilter drop-down arrow in
any of the other columns and selecting a value or clear a filter by selecting
All.
v Upgrade your database to a version that is supported by FileNet P8 prior to
upgrading the FileNet P8 software. See FileNet P8 Hardware and Software
Requirements for version information.
“Database administrator planning”
To prepare for an upgrade, review database requirements and complete other
planning tasks.
“Planning the IBM Content Search Services upgrade” on page 25
Empty the IBM Content Search Services index request table before you upgrade
Content Platform Engine.

Database administrator planning

To prepare for an upgrade, review database requirements and complete other
planning tasks.

Planning and preparing for FileNet P8 upgrade 23

 You must upgrade to the appropriate database versions and patches before you
upgrade FileNet P8 components. For minimum database software version and fix
pack requirements, see IBM FileNet P8 system requirements.

Rather than upgrading your existing database, it is a best practice to create a new
database instance on a version of the database that is supported by the new
FileNet P8 components. Import data for, or restore backups of, your existing
Content Platform Engine (or your Content Engine and Process Engine) data into
the new database. Then retarget your JDBC Content Engine data sources to the
new database. This approach allows you to leave the existing production system in
place while you do the prerequisite steps for the new database.

FileNet P8 systems with IBM Case Manager (for upgrades from

versions 5.0.0, or 5.1.0)

Before upgrading FileNet P8 to version 5.2.1, Process Engine isolated regions that
are used in an IBM Case Manager configuration must be located in the
corresponding Content Engine object store database or table space.

For version 5.0 and 5.1 FileNet P8 systems, new installations configured with IBM
Case Manager were required to have common Oracle or DB2® for Linux, UNIX
and Windows table spaces for the Process Engine isolated region and Content
Engine object store. For Microsoft SQL Server, new installations configured with
IBM Case Manager were required to have a common database for the Content
Engine object store and the Process Engine isolated region. For systems that were
upgraded to version 5.0 or 5.1, where IBM Case Manager was then added, there
was no requirement for Process Engine and Content Engine databases to be
common.

Important: For version 5.0 or 5.1 systems not in compliance with the common
database or table space requirement, you must move any Process Engine isolated
regions into the appropriate Content Engine object stores before you upgrade. A
tool has been provided on the Content Platform Engine installation media for that
purpose. See the techdoc documenting the tool for moving isolated regions.

Process Engine (for upgrades from versions 5.0.0, or 5.1.0)

Starting with the 5.2 version of FileNet P8, the Content Engine and Process Engine
are deployed together as a single application server instance. In addition, the
database is handled as a single entity. New workflow systems and isolated regions
are created in object stores, and all database connections require data sources.
Existing Process Engine systems become legacy workflow systems and the
databases are separate from any new workflow systems.

As a part of the upgrade you will create data sources for any existing Process
Engine databases. If you are upgrading from version 5.0 of Process Engine and had
multiple virtual servers, each virtual server had a unique database and each of
those databases will require a data source and those data sources will also be
targeted to the new database. Upgrade the Content Engine, Process Engine, and
Case Analyzer software and complete all upgrade procedures before you allow
users to access information in the new database.

To upgrade the Process Engine database, identify the existing database user name
and password. In versions of Process Engine older than 5.0, the default was the
f_sw user. Record this database user name and password in the Installation and
Upgrade Worksheet as the pe_db_user and password.

24 Planning for FileNet P8

 “Planning for Oracle database upgrades”
Review upgrade requirements for Oracle databases.

Planning for Oracle database upgrades:

Review upgrade requirements for Oracle databases.

Update to the appropriate database versions and patches before you upgrade
FileNet P8 components. For minimum patch requirements, see IBM FileNet P8
system requirements.

Content Platform Engine databases must be configured with AL32UTF8 character

sets. It is not required to set the national character set
(NLS_NCHAR_CHARACTERSET) to a specific value; you can take the default. If
you change the character set for an existing database, the workflow system or
legacy workflow system locale must not change when the database character set is
converted to AL32UTF8.

Any Oracle database users must have the following permission for the upgrade:
SELECT on USER_INDEXES

Planning for Content Platform Engine (or Content Engine) Oracle database
upgrades

If you have set the oracle.jdbc.V8Compatible flag to true for your Content
Platform Engine (or Content Engine) database, as documented in the Enabling
Oracle Data Index Use in the FileNet Content Engine technical notice (see
http://www.ibm.com/support/docview.wss?uid=swg21397282), you need to set
the flag to false. The flag is not supported in Oracle 11g and is not needed in
version 5.2.1 Content Platform Engine databases.

For object stores upgraded from version 4.5.1, as part of the auto-upgrade of
Oracle-based Content Engine data, table columns defined by the DATE property
are automatically converted to the TIMESTAMP property, even if there is an index
on the DATE property. However, auto-upgrade will not be able to perform this
conversion on function-based indexes, such as the descending (DESC) keyword,
that involve the DATE property. Because it is not feasible to resolve this conversion
failure within the auto-upgrade framework, plan to manually convert DATE
columns with function-based indexes to TIMESTAMP columns by dropping these
indexes, altering the property and recreating the index. Upgrade procedures direct
you to complete this procedure after the auto-upgrade finishes.

Planning for Process Engine Oracle database upgrades

The following database changes are automatically made for system and user data
during the database upgrade:
v Process Engine date and time fields are changed from 32-bit to 64-bit to enable
date fields exceeding the 2038 date.
v Process Engine string fields are converted from byte-based to character-based
strings.

Planning the IBM Content Search Services upgrade

Empty the IBM Content Search Services index request table before you upgrade
Content Platform Engine.

Planning and preparing for FileNet P8 upgrade 25

 For systems configured with IBM Content Search Services, plan to flush as many
index requests as possible before starting the upgrade. Part of the automatic
upgrade of the Content Platform Engine (or Content Engine) database includes a
change to the index request table. If there are more than 500,000 records in that
table when the automatic upgrade runs, a new required index will not be created.
A message will be logged and the database administrator must manually build the
new index before upgrading the IBM Content Search Services software. This index
must exist before the Content Platform Engine and IBM Content Search Services
software is used for production.

To determine the size of the index request table:

1. Run the following SQL query on the database table associated with the index
requests using your native database tools:
SELECT COUNT (*) FROM IndexRequests
2. If the SQL query result shows one or more entries, let IBM Content Search
Services process the entries before you initiate the upgrade.

Application Server administrator upgrade tasks

The Application Server Administrator must prepare the application servers for
FileNet P8 upgrade.
v Review all rows assigned to the Application Server Administrator (ASA) in the
Installation and Upgrade Worksheet. While you complete the preparation tasks,
provide values for the rows that are appropriate to your installation.

Tip: With the Data > Filter > AutoFilter command enabled, as it is by default in
the worksheet file (p8_worksheet.xls), perform the following actions to quickly
see only the properties assigned to a particular role:
– Click the AutoFilter drop-down arrow in the Role column header and select
ASA.
– Further filter the result set by clicking the AutoFilter drop-down arrow in
any of the other columns and selecting a value or clear a filter by selecting
All.
“Creating the application server administrator”
An application server administrator used while configuring Content Platform
Engine.
“Starting or stopping an application server instance” on page 27
You need to be able to start or stop an application server instance when
working with Content Platform Engine.
“Configuring the application server for Content Platform Engine” on page 28
You can deploy Content Platform Engine only on certain versions of application
servers. Therefore, you must determine if and when to upgrade the application
server where the current version of Content Platform Engine (or Content
Engine) is deployed before upgrading to a new version.

Creating the application server administrator

An application server administrator used while configuring Content Platform
Engine.

Create this account if it does not already exist. The upgrade instructions tell you
when to use it.
1. Create the following application server account:
Application server administrator

26 Planning for FileNet P8

 Unique identifier
appserver_admin
Description
WebSphere Application Server
In Configuration Manager, when you run the Set
Properties for WebSphere Application Server task, enter
the credentials of the appserver_admin account in the
field labeled Application server administrator user
name. Configuration Manager uses the appserver_admin
account to run configuration tasks.
WebSphere administrative security is enabled
You have two options for creating the
appserver_admin user account. You can use the
local file-based account usually defined while
creating the WebSphere profile. Or, you can use
WebSphere tools to grant administrative rights
to an LDAP account and optionally remove the
file-based account created earlier.
The appserver_admin user account must have
WebSphere administrator permissions
throughout the Content Platform Engine
installation process. Afterwards, you can reduce
the account to a lesser role, such as
Configurator.
WebSphere administrative security is not enabled
If you decide not to enable WebSphere
administrative security during profile creation,
then no special credentials are required to log
in to the WebSphere administrative console.
You can enter any string into the Configuration
Manager field labeled Application server
administrator user name. However, remember
that to run Content Platform Engine,
WebSphere administrative security must be
enabled. When you do enable it and the
WebSphere administrative console requests an
account to use as the administrative user, enter
the appserver_admin.

2. Record this value in your customized Installation and Upgrade Worksheet.

To find this property, search the worksheet for instances of appserver_admin.

Starting or stopping an application server instance

You need to be able to start or stop an application server instance when working
with Content Platform Engine.

To start or stop an application server instance:

Depending on your application server type, run one of the following commands to
start or stop an application server instance:

Planning and preparing for FileNet P8 upgrade 27

 Table 3. How to start or stop an application server instance
Command to start an Command to stop an
Application server type application server instance application server instance
WebSphere Application startServer stopServer
Server

In a high availability environment, when instructed to start or stop an application

server instance, start or stop the nodes unless otherwise specified.

Configuring the application server for Content Platform Engine

You can deploy Content Platform Engine only on certain versions of application
servers. Therefore, you must determine if and when to upgrade the application
server where the current version of Content Platform Engine (or Content Engine) is
deployed before upgrading to a new version.

To determine the order of upgrading Content Platform Engine and the application
server on which it is deployed:
1. Consult the IBM FileNet P8 system requirements documentation for both the
existing version of software and the new version. Determine if a version of
your application server is supported by both your existing version of Content
Platform Engine (or Content Engine) and the new version of Content Platform
Engine.
2. Upgrade your application server and Content Platform Engine (or Content
Engine) according to the criteria in the following table:

Option Description
If you deployed your current version of 1. Upgrade the Content Platform Engine
Content Platform Engine (or Content software. It is not necessary to upgrade
Engine) on an application server version your application server.
that is supported by the new version of
2. (optional) Upgrade the application server
Content Platform Engine
to a newer version that is supported by
the new version of Content Platform
Engine
If you deployed your current version of 1. Upgrade to an application server version
Content Platform Engine (or Content that both the current version of Content
Engine) on an application server version Platform Engine (or Content Engine) and
that is not supported by the new version of the new version of Content Platform
Content Platform Engine Engine support.
2. Upgrade Content Platform Engine to the
new version.
If you deployed your current version of 1. Perform a migration upgrade by creating
Content Platform Engine (or Content a new instance of the application server
Engine) on an application server version using a version that is supported by the
that is not supported by the new Content new Content Platform Engine.
Platform Engine and an application server
2. Upgrade Content Platform Engine
version that is supported by both your
working through the topics on
existing Content Platform Engine (or
configuring Content Platform Engine into
Content Engine) and the new Content
a new application server instance using
Platform Engine version does not exist
an existing Configuration Manager
profile.

28 Planning for FileNet P8

FileNet P8 administrator upgrade tasks
The FileNet P8 administrator must carry out several tasks to prepare your
environment for your FileNet P8 upgrade.

Review all rows assigned to the FileNet P8 Administrator (P8A) in the Installation
and Upgrade Worksheet. While you complete the following preparation tasks,
provide values for the rows that are appropriate to your installation.

Tip: With the Data > Filter > AutoFilter command enabled, as it is by default in
the worksheet file (p8_worksheet.xls), perform the following actions to quickly see
only the properties assigned to a particular role:
v Click the AutoFilter drop-down arrow in the Role column header and select
P8A.
v Further filter the result set by clicking the AutoFilter drop-down arrow in any
of the other columns and selecting a value or clear a filter by selecting All.
“Enabling the Asynchronous Processing dispatcher”
You must enable the Asynchronous Processing dispatcher to ensure that the
object stores progress to a completed or ready state as part of an upgrade.
“Preparing Process Engine for upgrade (upgrades from versions 4.5.1, 5.0.0,
5.1.0)” on page 30
Repair any inconsistencies between Process Engine queues and rosters in the
Process Engine database, reconcile user security information and prepare Case
Analyzer data for upgrade.
“Collecting settings for peupgrade wizard (upgrades from versions 4.5.1, 5.0.0,
5.1.0)” on page 30
Collect the values for all settings in the peupgrade wizard. The values are
needed for Process Engine upgrades from versions 4.5.1, 5.0.0, and 5.1.0.
“Collecting configuration information for Process Engine DbExecute
connections (upgrades from 4.5.1)” on page 30
DbExecute connection information must be provided to the peupgrade tool for
Process Engine upgrades from Version 4.5.1. Collect the current configuration
information for all of your existing DbExecute aliases before you upgrade.
“Saving Component Manager custom settings for CE_Operations (upgrades
from V5.1 or earlier)” on page 31
Save Component Manager custom settings for CE_Operations in each isolated
region before you upgrade. You need to restore the settings after the upgrade is
complete.

Enabling the Asynchronous Processing dispatcher

You must enable the Asynchronous Processing dispatcher to ensure that the object
stores progress to a completed or ready state as part of an upgrade.

For each object store to be upgraded, you must enable the Asynchronous
Processing dispatcher on at least one Content Platform Engine (or Content Engine)
server in the site where the object store is located.

(For upgrades from 5.2.0 to 5.2.1) To enable the Asynchronous Processing

dispatcher for one Content Platform Engine server:
1. Start the FileNet P8 administration tool.
a. (For upgrades from 5.2.0 to 5.2.1) Start Administration Console for Content
Platform Engine.
b. (For upgrades from 4.5.1, 5.0.0 or 5.1.0) Start Enterprise Manager.

Planning and preparing for FileNet P8 upgrade 29

 2. (For upgrades from 5.2.0 to 5.2.1) Click the domain root node and then click the
Asynchronous Processing Subsystem tab. Select Enable Dispatcher.
3. (For upgrades from 4.5.1, 5.0.0 or 5.1.0) Right-click the domain root node or the
node of the object store to be upgraded and click Properties. Click the
Asynchronous Processing tab and select Enable Dispatcher.

Preparing Process Engine for upgrade (upgrades from versions

4.5.1, 5.0.0, 5.1.0)
Repair any inconsistencies between Process Engine queues and rosters in the
Process Engine database, reconcile user security information and prepare Case
Analyzer data for upgrade.
v (upgrades from 4.5.1) Use the vwverify program to repair any inconsistencies
between Process Engine queues and rosters in the Process Engine database.
v (upgrades from 5.0 or later) Use the PEVerify program to repair any
inconsistencies between Process Engine queues and rosters in the Process Engine
database. See Techdoc 7022275 for information.
v If there are unused isolated regions with no connection point, remove those
regions before the upgrade.

Collecting settings for peupgrade wizard (upgrades from

versions 4.5.1, 5.0.0, 5.1.0)
Collect the values for all settings in the peupgrade wizard. The values are needed
for Process Engine upgrades from versions 4.5.1, 5.0.0, and 5.1.0.

During the upgrade of Process Engine, you run peupgrade. After you provide
information to the program, you run it to upgrade the Process Engine database.
The values can be provided to peupgrade in a wizard or in a property file that is
an input file to the program. The information that you must gather varies
depending on whether you are upgrading from Version 5.0 or 5.1, or from Version

4.5.1. Record these values in your customized Installation and Upgrade

Worksheet. To find these properties, search the worksheet for instances of
peupgrade.

The following table shows the information that is required and where to collect it
on the source Process Engine system. Several values are not on the source system
but are needed for the upgrade. For each property name, record the value in your
Installation and Upgrade worksheet. Property names in this table reflect the name
in the peupgrade wizard user interface.
Table 4. peupgrade upgrade values
4.5.1 property name and 5.0 or 5.1 property name
Property name location and location Comments
Server DNS name Server or load balancer Server or load balancer
name in FileNet Enterprise name in FileNet Enterprise
Manager, Isolated Region Manager, Isolated Region
properties. properties.

Collecting configuration information for Process Engine

DbExecute connections (upgrades from 4.5.1)
DbExecute connection information must be provided to the peupgrade tool for
Process Engine upgrades from Version 4.5.1. Collect the current configuration
information for all of your existing DbExecute aliases before you upgrade.

30 Planning for FileNet P8

 Collect DbExecute connection information and record it in your Installation and
Upgrade worksheet. The DbExecute connection information must be provided to
the peupgrade tool. You run the peupgrade tool during the upgrade of Process
Engine to Content Platform Engine Version 5.2.1.

To collect DbExecute alias configuration information for Process Engine, log on to

the Process Engine v4.5.1 server and locate existing information.
1. Change your working directory to the following:

Option Description
AIX, HPUX, HPUXi, Solaris /fnsw/local/sd

2. Each connection has a file associated with the following naming scheme
.alias.bin

Note the names for all aliases.

3. Collect the connection information for each alias by running vwtool with the
listdbconfig option as follow:
a. Start vwtool at a command prompt as follows:
vwtool -Y pe_service_username+pe_service_username_password
b. Enter the following command at the prompt:
listdbconfig alias
c. For each database type, the information returned is as follows:
Oracle global database name
SQL Server
SQL Server name
database name
DB2 database alias
4. Using the information for every existing connection, collect the following
information. Record the values in your Installation and Upgrade worksheet.
v Database type
v Database name
v Database host name
v Database port
v Database user name
v Database password
As an alternative to the database host name and port, use a connection URL
string. Your URL can vary, depending on your configuration, but default URLs
that can be configured are as follows:
v jdbc:sqlserver://DBhost:DBport;DatabaseName=DBName
v jdbc:db2://DBhost:DBport/DBName
v jdbc:oracle:thin:@DBhost:DBport:DBName

| Saving Component Manager custom settings for CE_Operations

| (upgrades from V5.1 or earlier)
| Save Component Manager custom settings for CE_Operations in each isolated
| region before you upgrade. You need to restore the settings after the upgrade is
| complete.

Planning and preparing for FileNet P8 upgrade 31

| Before you upgrade FileNet P8 from version 5.1 or earlier, you must make note of
| the logon and password for the adapter. If you extended the CE_Operations queue
| with exposed fields or database indexes, you must also save these custom settings
| before you upgrade. You must manually restore these settings and values after the
| upgrades of the Content Platform Engine software and the Process Engine
| database are complete.

| Important: Other customizations or extensions to the CE_Operations component

| queue are not supported. These customizations might cause the Process Engine
| database upgrade to fail. Contact IBM Support for assistance before you proceed
| with the upgrade if the CE_Operations queue has customizations other than
| exposed fields or database indexes.

| You can use Administration Console for Content Platform Engine if it is available
| or the Process Configuration Console in Workplace or Workplace XT to save the
| CE_Operations settings. The console that you select is used to configure the queue,
| but that does not imply that the component queue runs in Content Platform
| Engine or Workplace.

| To save the Component Manager custom settings for CE_Operations:

| 1. Start Process Configuration Console by using Workplace or Workplace XT:
| Table 5. Starting Process Configuration Console
| Option Select
| Workplace Select Admin > Process Configuration
| Console.
| Workplace XT Select Tools > Administration > Process
| Configuration Console
|
| 2. Save the custom settings for the CE_Operations queue in each isolated region:
| a. Go to an isolated region node and choose Export to XML from the Action
| menu.
| b. In the Export window, click Browse and specify a file name and location on
| your local drive or network for the exported data.

| Tip: Use the XML file extension for the file name.
| c. Choose the export type Export selected components and select the
| CE_Operations queue from the Component Queues. Then click Next.
| d. On the Summary page, confirm that the export contains only the
| CE_Operations queue, and then click Finish to complete the export.
| e. Repeat the preceding substeps for the other isolated regions.
| 3. Save the adapter settings for the CE_Operations queue in each isolated region:
| a. Go in Process Configuration Console for an isolated region to the isolated
| region node > Component Queues > CE_Operations.
| b. Right-click the CE_Operations node and choose Properties to view its
| properties.
| c. Open the Adapter tab and make note of the JAAS Credentials settings; you
| need it later in the upgrade process.
| d. Repeat the preceding substeps for the other isolated regions.

32 Planning for FileNet P8

Appendix A. Preparing non-English environments for
installing FileNet P8
To run FileNet P8 components in a non-English environment, certain conditions
must be met. Review the following considerations and tasks, organized by
administrator role, if you plan to run FileNet P8 in a non-English environment.

By default, Content Platform Engine uses Oracle Outside In Search Export for text
extraction on PDF documents. For right-to-left language PDF documents, you can
optionally use Apache PDFBox technology for text extraction. To use PDFBox, you
set a JVM property on Content Platform Engine. For more information, see the
topics in Administering FileNet P8 > Administering Content Platform Engine.

For information on how IBM Content Search Services extracts text from documents
that are sent to it by IBM Content Collector, see Administering FileNet P8 >
Administering Content Platform Engine > Retrieving documents > Finding
objects with content-based retrieval > Making object text searchable > Indexable
document types and text extraction.
“IT administrator”
Depending on the operating system, the IT administrator installs either a
localized version of the operating system, or the operating system language
pack.
“Security administrator” on page 35
The FileNet P8 security administrator installation role includes configuring and
maintaining directory servers.
“Database administrator” on page 35
The FileNet P8 database administrator installation role includes configuring
database installations and table spaces, and creating database accounts.
“Application Server administrator” on page 35
To support Unicode UTF-8 characters, all FileNet P8 domain application servers
must be properly configured and must have all fix packs installed.
“FileNet P8 administrator” on page 36
The FileNet P8 administrator configures Process Task Manager for Application
Engine and Workplace XT.
“Limitations on installing in a non-English environment” on page 37
There are certain limitations on installing FileNet P8 in non-English
environments.

IT administrator
Depending on the operating system, the IT administrator installs either a localized
version of the operating system, or the operating system language pack.
“Operating system considerations” on page 34
In addition to any operating system platforms, the IT administrator must
consider the FileNet P8 components that will be installed in a non-English
environment.
“Configuring locale and support for other languages in an AIX, HPUX, HPUXi,
Linux, Linux on System z, or Solaris system” on page 34
Add language fonts for your AIX, HPUX, HPUXi, Linux, Linux on System z, or

© Copyright IBM Corp. 2001, 2016 33

 Solaris operating system if you need to display an X Window desktop in a
specific-language user interface. Follow your operating system administration
guide to install other language fonts.

Operating system considerations

In addition to any operating system platforms, the IT administrator must consider
the FileNet P8 components that will be installed in a non-English environment.

Application Engine or Workplace XT

Application Engine and Workplace XT can be installed:

v In any locale on any of the supported AIX, HPUX, HPUXi, Linux, Linux on
System z, and Solaris platforms

Remember: The Application Engine and Workplace XT setting must match the
Content Platform Engine setting. Otherwise, workflows can experience unexpected
problems such as errors related to the way characters display.

Content Platform Engine

Content Platform Engine can be installed:

v In any locale on any of the supported AIX, HPUX, HPUXi, Linux, Linux on
System z, and Solaris platforms

If you intend to install Content Platform Engine in a path that contains

non-English characters, you must specify each such character in the path by its
escaped Unicode representation (for example, \u4EF6).

IBM Content Search Services

IBM Content Search Services can be installed:

v In any locale on any of the supported AIX, Linux, Linux on System z, and
Solaris platforms

When you run the installation program for IBM Content Search Services, you
specify a configuration data directory and an installation directory. If any
component of either of these directory names contains non-English characters, the
installation program appears to complete normally; but the program creates an
installation directory whose name contains random characters instead of the name
that you specified.

This installation failure occurs whether you install the first instance or an
additional instance of IBM Content Search Services. To prevent the failure, use only
English characters in the name of each component of the configuration data
directory and the installation directory.

Configuring locale and support for other languages in an AIX,

HPUX, HPUXi, Linux, Linux on System z, or Solaris system
Add language fonts for your AIX, HPUX, HPUXi, Linux, Linux on System z, or
Solaris operating system if you need to display an X Window desktop in a
specific-language user interface. Follow your operating system administration
guide to install other language fonts.

34 Planning for FileNet P8

 Configure your X-session manager application to use the fonts for your operating
system. See your X-session manager application administration guide for details
about adding fonts or accessing them on the server. Make sure to add a locale for
the language that is used and also to add the UTF-8 locale. Set the server locale to
the UTF-8 locale.

For information about right-to-left languages, see the Oracle support document
Enabling Outside In Technology for Bidirectional Arabic and Hebrew Text.

Security administrator
The FileNet P8 security administrator installation role includes configuring and
maintaining directory servers.
“Extended characters and user names”
Note the following considerations for localized FileNet P8 accounts.

Extended characters and user names

Note the following considerations for localized FileNet P8 accounts.
v With Microsoft Active Directory, Content Platform Engine supports extended
characters in user names and passwords for all Latin1, Latin2, Arabic, and
double-byte languages
v Content Platform Engine does not support extended (double-byte) characters in
LDAP attributes for authentication purposes. These attributes include, but are
not limited to, such items as cn (common name), ou (organizational unit), or dc
(domain component). ASCII characters are required for these attributes.
v The Content Platform Engine locale must match directory server locale to
manage non-ASCII user names correctly.
v AIX, HPUX, HPUXi, Linux, Linux on System z, and Solaris systems can support
Latin1, Latin2, Arabic, and double-byte user names simultaneously.

Database administrator
The FileNet P8 database administrator installation role includes configuring
database installations and table spaces, and creating database accounts.
“Installing Oracle server”
Create the database using the AL32UTF8 database character set.

Installing Oracle server

Create the database using the AL32UTF8 database character set.

The collation settings must match the language settings on the system. Searching
for other languages that do not match the database collation setting will result in
invalid search and sort results.

Set the regular character set to AL32UTF8. It is not required to set the national
character set (NLS_NCHAR_CHARACTERSET) to a specific value. You can take
the default. The national character set applies to the data types NCHAR /
NVARCHAR2 / NCLOB which the Content Platform Engine does not use.

Application Server administrator

To support Unicode UTF-8 characters, all FileNet P8 domain application servers
must be properly configured and must have all fix packs installed.

Appendix A. Preparing non-English environments for installing FileNet P8 35

| “Configuring character encoding on WebSphere Application Server”
FileNet P8 requires two WebSphere settings: com.ibm.CORBA.ORBCharEncoding, to
specify the native encoding set of character data that Object Request Broker
uses, and com.ibm.websphere.security.BasicAuthEncoding, to match the
encoding used by Basic Authentication for Web Services so that client
applications can access web services.

| Configuring character encoding on WebSphere Application

| Server
| FileNet P8 requires two WebSphere settings: com.ibm.CORBA.ORBCharEncoding, to
| specify the native encoding set of character data that Object Request Broker uses,
| and com.ibm.websphere.security.BasicAuthEncoding, to match the encoding used
| by Basic Authentication for Web Services so that client applications can access web
| services.

| To set character encoding parameters on WebSphere Application Server:

| 1. Log on to the WebSphere administrative console.
| 2. In the navigation pane, click Servers > Server Types > WebSphere application
| servers > server_name, where server_name is the name of one of your
| application servers.
| 3. In the Container services section, click ORB service > Custom properties >
| New.
| 4. In the Name field, enter com.ibm.CORBA.ORBCharEncoding, set the value to UTF8,
| and save your changes.
| 5. In the Server Infrastructure section, click Java and process management >
| Process definition > Java virtual machine > Custom properties > New.
| 6. In the Name field, enter com.ibm.websphere.security.BasicAuthEncoding, set
| the value to UTF8, and save your changes.
| 7. Restart the application server.
| 8. Repeat steps 2 through 7 for your other application servers.

FileNet P8 administrator
The FileNet P8 administrator configures Process Task Manager for Application
Engine and Workplace XT.
“Configuring Process Task Manager for Application Engine and Workplace XT”
In AIX, HPUX, HPUXi, Linux, Linux on System z, or Solaris environments,
verify that the LC_TIME and LC_MESSAGES environment variables are set to
“C” before you run Process Task Manager in Application Engine or Workplace
XT. Failure to set these variables can result in an error in a non-English locale.

Configuring Process Task Manager for Application Engine and

Workplace XT
In AIX, HPUX, HPUXi, Linux, Linux on System z, or Solaris environments, verify
that the LC_TIME and LC_MESSAGES environment variables are set to “C” before
you run Process Task Manager in Application Engine or Workplace XT. Failure to
set these variables can result in an error in a non-English locale.

36 Planning for FileNet P8

Limitations on installing in a non-English environment
There are certain limitations on installing FileNet P8 in non-English environments.

Important: For additional limitations, see the release notes.

Process Task Manager

If Application Engine, Workplace XT, or Content Platform Engine is installed on
any operating system other than Windows, Process Task Manager (vwtaskman)
takes too long to launch when it is run under a UTF-8 locale using remote CDE
shells such as X Window, Exceed, Xmanager, etc). Verify that the X Window
application can handle Unicode fonts to fix this problem. Also, verify that any
independent software vendor applications are configured correctly. The
command-line interface functionality is not affected.

Process Designer

To import a user-defined XSD file that contains non-English characters in Process

Designer, run the following command to convert characters to the Unicode
encoding format to match an operating system other than Windows Content
Platform Engine in a UTF-8 locale, and then import the XSD file into Process
Designer.
Java -cp pe.jar filenet.vw.toolkit.utils.FileConverter /in filename
/out outfilename

Composite Platform Installation Tool

The Composite Platform Installation Tool, which installs a single-server FileNet P8
environment, is not supported on Simplified Chinese Microsoft Windows 2008 R2.

IBM Case Manager

IBM Case Manager requires language support on the Content Platform Engine
server to support authored language solution templates.

Important: Case Manager Builder displays unreadable characters in Step Editor for
double-byte (east Asian) characters. To resolve the problem, install the correct
language pack on the Case Manager Builder Server.

IBM FileNet Image Services

In IBM FileNet Image Services, navigate to fn_edit > System Attributes > Client
Character Set, enter MS932, and restart the IBM FileNet Image Services service. This
configuration setting ensures that Japanese characters in property values are
synchronized in both directions between IBM FileNet Image Services and Content
Platform Engine.

Rendition Engine

Rendition Engine supports only English and Japanese operating system languages.
You can install and run Rendition Engine on any language version of Windows,
provided that you set the Windows Region/Language configuration to either
English or Japanese.

Appendix A. Preparing non-English environments for installing FileNet P8 37

 With one exception, IBM FileNet Rendition Engine supports only the English
versions of authoring applications. The exception is that Rendition Engine supports
the Japanese versions of Microsoft Office, Microsoft Project, and Microsoft Visio.

For more information, see Microsoft Windows operating system help for further
information about adding additional language support.

38 Planning for FileNet P8

Appendix B. FileNet P8 ports
Port numbers that are used by FileNet P8 components are listed along with
information such as communication protocols, the source and target components,
whether load balancers are supported, and other information specific to the
component ports.

The following conditions apply to the ports that are used by the FileNet P8
components:
v The port numbers are default values, but can be changed to other unique port
numbers.
v The default port number and communication protocol must be open on the
target server.
v Replies and responses to the requestor are made unless specified otherwise.
v No long-lived connections are established between FileNet P8 components
unless specified for the port. The connection is closed after the initiator opens a
connection with the recipient and the recipient responds.
“Content Platform Engine ports” on page 40
The Content Platform Engine ports information is presented in multiple tables
that list the port names, port numbers, communication protocols, and
descriptions.
“Application Engine and Workplace XT ports” on page 43
The Application Engine and Workplace XT servers ports table lists the port
names, port numbers, communication protocols, and description for its use.
“Process Simulator ports” on page 43
The Process Simulator ports information, which is segmented into multiple
tables, lists the port names, port numbers, communication protocols, and
description for its use.
“Content Search Services ports” on page 44
The Content Search Services ports information, which is segmented into
multiple tables, lists the port names, port numbers, communication protocols,
and description for its use.
“Database ports” on page 45
The database ports information, which is segmented into multiple tables, lists
the port names, port numbers, communication protocols, and description for its
use.
“IBM System Dashboard for Enterprise Content Management ports” on page 46
The IBM System Dashboard for Enterprise Content Management ports
information, which is segmented into multiple tables, lists the port names, port
numbers , communication protocols, and description for it use.
“Content Services for FileNet Image Services ports” on page 47
The following tables list the port numbers used by IBM FileNet Content
Services for FileNet Image Services.

© Copyright IBM Corp. 2001, 2016 39

Content Platform Engine ports
The Content Platform Engine ports information is presented in multiple tables that
list the port names, port numbers, communication protocols, and descriptions.
Table 6. Content Platform Engine ports
Application Transport level Default port
Port name level protocol protocol number From To
LDAP LDAP TCP 389 Content Directory server
Platform
Engine server
LDAP (SSL ) LDAP TCP 636 Content Directory server
Platform
Engine server
LDAP Global Catalog LDAP TCP 3268 Content Global Catalog
Platform server
Engine server
LDAP Global Catalog (SSL) LDAP TCP 3269 Content Active Directory
Platform Global Catalog
Engine server server
WebSphere WSI HTTP TCP 9080 Content Content Platform
Platform Engine server
Engine client
WebSphere WSI (SSL) HTTPS TCP 9443 Content Content Platform
Platform Engine server
Engine,
Administration
Console for
Content
Platform
Engine,
Component
Manager
(Workplace
XT), or a
custom
application
WebSphere EJB IIOP TCP 2809 Content Content Platform
Platform Engine server
Engine client

Table 7. Content Platform Engine ports - continued

Port name Supports SSL?
LDAP No
LDAP (SSL ) Yes
LDAP Global Catalog No
LDAP Global Catalog (SSL) Yes
WebSphere WSI No
WebSphere WSI (SSL) Yes
WebSphere EJB Yes

40 Planning for FileNet P8

Table 8. Content Platform Engine ports - continued
Port name Notes
LDAP The port is on the directory server and specified on the Content Platform Engine
server for authentication.
LDAP (SSL ) The port is on the directory server and specified on the Content Platform Engine
for authentication through SSL.
LDAP Global Catalog The port is used for the Active Directory only.
LDAP Global Catalog (SSL) The port is used for the Active Directory only.
WebSphere WSI The port is on the WebSphere Application Server for Content Platform Engine. The
port is used for communication with Content Platform Engine by clients through
WSI.
WebSphere WSI (SSL) HTTPS over SSL or TLS. (Port 9080 is the non-SSL HTTP port.) Content Platform
Engine and custom applications use WSI. Port 9443 is on the WebSphere
Application Server for Content Platform Engine. The port is used for
communication with Content Platform Engine by clients through WSI.
WebSphere EJB The port is on the WebSphere Application Server for Content Platform Engine. The
port is used for communication with Content Platform Engine by clients through
EJB and for request forwarding between Content Platform Engine servers.

Table 9. Content Platform Engine ports

Application Transport level Default port
Port name level protocol protocol number From To
SMTP (Email Notification) SMTP TCP 25 Content Email server
Platform
Engine server
Process Task Manager / RMI TCP 32771 (for Process Task Component
Component Manager version 1 of Manager on the Manager /
version 1 communications Component Application Process Task
port Manager) Engine server Manager
communication
Component Manager Event RMI TCP 32773 (for Content Component
Port backward Platform Manager version
compatibility Engine server 1 on the
with version 1 Application
of Component Engine server
Manager)
Rules Listener RMI TCP 32774 (for Content Rules Listener
Rules Engine Platform
using Rules Engine server
Connectivity
Framework)
Content Platform Engine HTTP (only for TCP 0 (randomly Content Content Platform
server to server clusters) assigned port Platform Engine server
communication port number) Engine server

Table 10. Content Platform Engine ports–continued

Reply or
Response to Long lived Supports SSL
Port name requestor? sessions? Load Balancer? and TLS?
SMTP (Email Notification) No No No Yes

Appendix B. FileNet P8 ports 41

Table 10. Content Platform Engine ports–continued (continued)
Reply or
Response to Long lived Supports SSL
Port name requestor? sessions? Load Balancer? and TLS?
Process Task Manager / Component Yes Yes No No
Manager version 1 communications port
Component Manager Event Port Yes Yes No No
Rules Listener Yes Yes No No
Content Platform Engine server to server Yes Yes No No
communication port

Table 11. Content Platform Engine ports - continued

Port name Notes
SMTP (Email Notification) The port is on the SMTP server and is configured for Content Platform Engine
email notification in Administration Console for Content Platform Engine.

Communication on this port is one-way, from the Content Platform Engine server
to the email server.
Process Task Manager / This port is on the Application Engine server for Process Task Manager to
Component Manager version 1 communicate with the Component Managers.
communications port
Component Manager Event Port The port is on the Application Engine server, configured through the Process Task
Manager. This port number must match the port used for the Component Manager
Event Port on the Application Engine.

Communication on this port is one-way from the Content Platform Engine server
to the Component Manager.
Rules Listener The port is on the Content Platform Engine server.

Communication on this port is bidirectional from the Content Platform Engine

server to the Rules Listener
Content Platform Engine server For a cluster configuration only. If there is a firewall between the Content Platform
to server communication port Engine server instances of a cluster, this value should be set to a specific assigned
port number and that port value should be allowed in the firewall configuration.

The port is set for the workflow system. The port number is the internal port
number, which is the field name for this in the Administration Console for Content
Platform Engine. In a cluster configuration, this port needs to be set in
Administration Console for Content Platform Engine and it needs to be opened in
the firewall.

Communication on this port is bidirectional between Content Platform Engine

servers in a cluster.

42 Planning for FileNet P8

Application Engine and Workplace XT ports
The Application Engine and Workplace XT servers ports table lists the port names,
port numbers, communication protocols, and description for its use.
Table 12. Application Engine and Workplace XT server ports
Default port
Port name number Notes®
WebSphere 9080 The port is on the WebSphere Application Server for clients to
connect to Workplace and Workplace XT.
WebSphere SSL 9443 The port is on the WebSphere Application Server for clients to
connect to Workplace and Workplace XT through SSL.
WebLogic 7001 The port is on the WebLogic Server for clients to connect to
Workplace and Workplace XT.
WebLogic SSL 7002 The port is on the WebLogic Server for clients to connect to
Workplace and Workplace XT through SSL.
JBoss 8080 The port is on the JBoss Application Server for clients to connect to
Workplace and Workplace XT.
JBoss SSL 8443 The port is on the JBoss Application Server for clients to connect to
Workplace and Workplace XT through SSL.
BPM Web Services Reliable 32767 The port is configured and used on the Application Engine server,
messaging client port for a Component Manager instance.
Content Platform Engine 32771 The port is on the Windows Content Platform Engine server for
(RMI) Process Task Manager to communicate with the Windows Content
Platform Engine Services Manager. Specify this port number in the
jpemgr.properties file, in the jpemgr.port parameter on the Content
Platform Engine.

This port is on the Application Engine server for Process Task

Manager to communicate with the Component Managers and the
Windows Process Workplace (or Workplace XT) Services Manager.
Set the port in Process Task Manager on the Application Engine as
the Registry Port.
Component Manager (Event 32773 The port is on the Application Engine server, and is used when the
Port) Component Manager (running on the Application Engine Server) is
configured to be triggered by events, instead of polling. This port
number must match the port used for the Component Manager
Event Port on the Content Platform Engine.

Process Simulator ports

The Process Simulator ports information, which is segmented into multiple tables,
lists the port names, port numbers, communication protocols, and description for
its use.
Table 13. Process Simulator ports
Application Transport level Default port
Port name level protocol protocol number From To
Registry port RMI TCP 32771 Process Task Process
Manager Simulator
Return RMI TCP 0 Application Process
Engine Simulator

Appendix B. FileNet P8 ports 43

Table 14. Process Simulator ports–continued
Reply or
Response to Long lived
Port name requestor? sessions? Load Balancer? Supports SSL?
Registry port Yes No No No
Return Yes No No No

Table 15. Process Simulator ports–continued

Port name Notes
Registry port The port is on the Process Simulator server. The Process Task Manager application
on the Process Simulator server communicates with the Process Simulator server
process on this port. The Application Engine also communicates with the Process
Simulator server process on this port.
Return The port is on the Process Simulator server and is used to communicate with the
Application Engine server.

By default an anonymous port number is used. However, if the Process Simulator

server resides behind a firewall it will be necessary to specify an explicit port by
entering a value other than 0.

Content Search Services ports

The Content Search Services ports information, which is segmented into multiple
tables, lists the port names, port numbers, communication protocols, and
description for its use.
Table 16. Content Search Services ports
Application Transport level Default port
Port name level protocol protocol number From To
Content Search Services proprietary TCP 8191 Content Engine Content Search
server Services

Table 17. Content Search Services ports–continued

Reply or
Response to Long lived
Port name requestor? sessions? Load Balancer? Supports SSL?
Content Search Services server Yes No No Yes (for P8
version 5.1)

Table 18. Content Search Services ports–continued

Port name Notes
Content Search Services server The port is located on the Content Search Services server and is used for
communication between the Content Search Services server and the Content
Engine.

44 Planning for FileNet P8

Database ports
The database ports information, which is segmented into multiple tables, lists the
port names, port numbers, communication protocols, and description for its use.
Table 19. Database ports
Application Transport level Default port
Port name level protocol protocol number From To
DB2 for Linux, UNIX, and JDBC or CLI TCP 50000 Content DB2
Windows Platform
Engine, Case
Analyzer and
IBM Content
Navigator
DB2 for z/OS® JDBC or CLI TCP 446 Content DB2
Platform
Engine, Case
Analyzer and
IBM Content
Navigator
Oracle JDBC or OCI TCP 1521 Content Oracle
Platform
Engine, IBM
Content
Navigator, Case
Analyzer, and
Rendition
Engine
Microsoft SQL Server JDBC or TDS TCP 1433 Content Microsoft SQL
Platform Server
Engine, IBM
Content
Navigator, Case
Analyzer, and
Rendition
Engine

Table 20. Database ports - continued

Reply or Response
Port name to requestor? Long lived sessions? Load Balancer?
DB2 for Linux, UNIX, and Windows Yes No Yes
DB2 for z/OS Yes No Yes
Oracle Yes No Yes
Microsoft SQL Server Yes No Yes

Table 21. Database ports - continued

Port name Notes
DB2 for Linux, UNIX, DB2 for Linux, UNIX, and Windows default port. Port 50000 or
and Windows higher can be used.
DB2 for z/OS The default port for DB2 for z/OS is typically changed. Refer to
your database administrator for the port numbers in use.
Oracle Oracle DB default listener. Alternative port is 2483 (TTC) or 2484
(TTC SSL).

Appendix B. FileNet P8 ports 45

 Table 21. Database ports - continued (continued)
Port name Notes
Microsoft SQL Server The port is the default port for SQL Server.

IBM System Dashboard for Enterprise Content Management ports

The IBM System Dashboard for Enterprise Content Management ports information,
which is segmented into multiple tables, lists the port names, port numbers ,
communication protocols, and description for it use.
Table 22. IBM System Dashboard for Enterprise Content Management ports
Application Transport level Default port
Port name level protocol protocol number From To
Listener (first) TCP/IP TCP 32775 IBM System IBM System
Dashboard for Dashboard for
Enterprise Enterprise
Content Content
Management Management
client (such as, Listener
System (running on
Dashboard / Content Platform
FSM) Engine,
Application
Engine, FileNet
Image Services,
and other
servers)
Listener (subsequent) TCP/IP TCP OS defined IBM System IBM System
Dashboard for Dashboard for
Enterprise Enterprise
Content Content
Management Management
client (such as, Listener
IBM System (running on
Dashboard for Content Platform
Enterprise Engine,
Content Application
Management / Engine, FileNet
FSM) Image Services,
and other
servers)

Table 23. IBM System Dashboard for Enterprise Content Management ports–continued
Reply or
Response to Long lived
Port name requestor? sessions? Load Balancer? Supports SSL?
Listener (first) Yes Yes No No
Listener (subsequent) Yes Yes No No

46 Planning for FileNet P8

Table 24. IBM System Dashboard for Enterprise Content Management ports–continued
Port name Notes
Listener (first) This is the primary "pilot port" for connection to the IBM System Dashboard for
Enterprise Content Management server. This port also registers the secondary
allocated ports and communicates those numbers to the Dashboard. If needed, an
administrator can use the PchConfig.properties file to override the OS-defined
property and define a specific range of ports to use.
Listener (subsequent) If the first listener port is allocated, the OS will allocate additional ports for
managers to connect to listeners on the IBM System Dashboard for Enterprise
Content Management server. If needed, an administrator can use the
PchConfig.properties file to override the OS-defined property and define a
specific range of ports to use.

Content Services for FileNet Image Services ports

The following tables list the port numbers used by IBM FileNet Content Services
for FileNet Image Services.
Table 25. Content Services for FileNet Image Services ports
Application level Transport level Default port
Port name protocol protocol number From To
tms Custom TCP 32768 administrator FileNet Image
Services server
cor Custom TCP 32769 FileNet Image FileNet Image
Services, FileNet Services server
Image Services
Toolkit, or
Content Engine
server
nch Custom UDP 32770 Content Engine FileNet Image
server Services server
fn_snmpd SNMP UDP 161 SNMP Mgmt FileNet Image
Services
snmp trap SNMP UDP 162 SNMP Mgmt SNMP Mgmt
fn_trapd SNMP UDP 35225 FileNet Image SNMP Mgmt
Services
Native default SNMP UDP 8000 SNMP Mgmt HP-UX OS
SNMP port (HP
only)
IBM FileNet P8 SNMP UDP 8001 SNMP Mgmt fn_snmp (HP and
specific SNMP port Sun)
(HP and Solaris
only)
tpi Custom UDP anonymous FileNet Image FileNet Image
Services Toolkit Services
or FileNet Image
Services

Appendix B. FileNet P8 ports 47

Table 26. Content Services for FileNet Image Services ports–continued
Reply or
Response to Long lived
Port name requestor? sessions? Load Balancer? Supports SSL?
tms Yes No No No
cor Yes Caller is No No
responsible for
closing the
connection
nch Yes No No No
fn_snmpd Yes No No No
snmp trap No No No No
fn_trapd No No No No
Native default SNMP port (HP only) Yes No No No
FileNet P8 specific SNMP port (HP and Yes No No No
Solaris only)
tpi Yes No No No

Table 27. Content Services for FileNet Image Services ports–continued

Port name Notes
tms tms is the Task Manager service. TM_daemon listens for requests from initfnsw
running on the same or a different system analogous to COR_Listen listening for
RPCs.
cor cor is the Courier service. COR_Listen listens on this port for incoming RPC
requests.
nch nch is the NCH daemon. NCH_daemon listens on this port. Pre-4.1.2 listened for
broadcasts, and so on, Post 4.1.2, listens only for old print servers to verify that
NCH is up.
fn_snmpd fn_snmpd is the FileNet Image Services Simple Network Management Protocol
daemon. It listens for SNMP requests from the native OS SNMP daemon. The
native SNMP daemon listens on this port and communicates with fn_snmpd
through other local port. fn_snmpd does not listen on this port.
snmp trap This port is a well-known OS trap daemon port for listening to trap messages. All
FileNet Image Services trap messages received by fn_trapd daemon are eventually
routed to this port.
fn_trapd fn_trapd is the FileNet Image Services trap daemon, which listens for notifications
of the end of FileNet Image Services background processes running on the server
and sys logs information.
Native default SNMP port (HP All non-FileNet Image Services based SNMP requests are routed to this port for
only) native SNMP processing.
FileNet P8 specific SNMP port All FileNet Image Services based SNMP requests are routed to this port for
(HP and Solaris only) fn_snmpd daemon processing.
tpi Used for migration notification. The requester gets the anonymous UDP socket and
waits on completion. When the migration is complete, the ds_notify and pri_notify
processes send TPI notifications to signal completion of a task.

Important: On AIX, HPUX, HUPUXi, Linux, Linux on System z, and Solaris

platforms, FileNet Image Services port assignments are made in the /etc/services
file.

48 Planning for FileNet P8

Notices
This information was developed for products and services offered in the US. This
material may be available from IBM in other languages. However, you may be
required to own a copy of the product or product version in that language in order
to access it.

IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant you
any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing

IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US

For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing

Legal and Intellectual Property Law
IBM Japan Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS

PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of
express or implied warranties in certain transactions, therefore, this statement may
not apply to you.

This information could include technical inaccuracies or typographical errors.

Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.

© Copyright IBM Corp. 2001, 2016 49

 IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:

IBM Director of Licensing

IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US

Such information may be available, subject to appropriate terms and conditions,

including in some cases, payment of a fee.

The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement or any equivalent agreement
between us.

The performance data discussed herein is presented as derived under specific

operating conditions. Actual results may vary.

The client examples cited are presented for illustrative purposes only. Actual
performance results may vary depending on specific configurations and operating
conditions.

The performance data and client examples cited are presented for illustrative
purposes only. Actual performance results may vary depending on specific
configurations and operating conditions.

Information concerning non-IBM products was obtained from the suppliers of

those products, their published announcements or other publicly available sources.
IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.

Statements regarding IBM's future direction or intent are subject to change or

withdrawal without notice, and represent goals and objectives only.

This information is for planning purposes only. The information herein is subject to
change before the products described become available.

This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which

illustrate programming techniques on various operating platforms. You may copy,

50 Planning for FileNet P8

 modify, and distribute these sample programs in any form without payment to
IBM, for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the operating
platform for which the sample programs are written. These examples have not
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or
imply reliability, serviceability, or function of these programs. The sample
programs are provided "AS IS", without warranty of any kind. IBM shall not be
liable for any damages arising out of your use of the sample programs.

Each copy or any portion of these sample programs or any derivative work, must
include a copyright notice as follows:

© Copyright IBM Corp. 2016

Portions of this code are derived from IBM Corp. Sample Programs.
“Privacy policy considerations” on page 52

Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies.
A current list of IBM trademarks is available on the Web at "Copyright and
trademark information" at http://www.ibm.com/legal/copytrade.shtml

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered
trademarks or trademarks of Adobe Systems Incorporated in the United States,
and/or other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other

countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
Microsoft Corporation in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or registered
trademarks of Oracle and/or its affiliates.

UNIX is a registered trademark of The Open Group in the United States and other
countries.

Other company, product, and service names may be trademarks or service marks
of others.

Terms and conditions for product documentation

Permissions for the use of these publications are granted subject to the following
terms and conditions.

Applicability

http://www.ibm.com/legal/us/en/copytrade.shtml

Personal use

Notices 51
 You may reproduce these publications for your personal, noncommercial use
provided that all proprietary notices are preserved. You may not distribute, display
or make derivative work of these publications, or any portion thereof, without the
express consent of IBM.

Commercial use

You may reproduce, distribute and display these publications solely within your
enterprise provided that all proprietary notices are preserved. You may not make
derivative works of these publications, or reproduce, distribute or display these
publications or any portion thereof outside your enterprise, without the express
consent of IBM.

Rights

Except as expressly granted in this permission, no other permissions, licenses or

rights are granted, either express or implied, to the publications or any
information, data, software or other intellectual property contained therein.

IBM reserves the right to withdraw the permissions granted herein whenever, in its
discretion, the use of the publications is detrimental to its interest or, as
determined by IBM, the above instructions are not being properly followed.

You may not download, export or re-export this information except in full
compliance with all applicable laws and regulations, including all United States
export laws and regulations.

IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE

PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING
BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY,
NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

Privacy policy considerations

IBM Software products, including software as a service solutions, (“Software
Offerings”) may use cookies or other technologies to collect product usage
information, to help improve the end user experience, to tailor interactions with
the end user or for other purposes. In many cases no personally identifiable
information is collected by the Software Offerings. Some of our Software Offerings
can help enable you to collect personally identifiable information. If this Software
Offering uses cookies to collect personally identifiable information, specific
information about this offering’s use of cookies is set forth below.

This Software Offering does not use cookies or other technologies to collect
personally identifiable information.

If the configurations deployed for this Software Offering provide you as customer
the ability to collect personally identifiable information from end users via cookies
and other technologies, you should seek your own legal advice about any laws
applicable to such data collection, including any requirements for notice and
consent.

For more information about the use of various technologies, including cookies, for
these purposes, See IBM’s Privacy Policy at http://www.ibm.com/privacy and
IBM’s Online Privacy Statement at http://www.ibm.com/privacy/details the

52 Planning for FileNet P8

section entitled “Cookies, Web Beacons and Other Technologies” and the “IBM
Software Products and Software-as-a-Service Privacy Statement” at
http://www.ibm.com/software/info/product-privacy.

Notices 53
54 Planning for FileNet P8
Index
A Fix Packs and Test Fixes
minimum level required 7
R
accounts roles
Content Platform Engine definition of upgrade 9
upgrade 13, 22
AIX, HPUX, HPUXi, Linux, Linux on I
System z, and Solaris 18
Application Engine and Workplace XT
IBM Support
data collection tools 20
S
IBM Support Assistant Data SA
ports 43
Collector 20 upgrade tasks 21
Application Engine operating system
IBM Support Assistant Lite Data security
database user account 26
Collector 20 upgrade considerations 22
application server
LDAP user account 22 IBM System Dashboard for Enterprise
application server installation group 17 Content Management ports 46
application server instance installation and upgrade worksheet 10 U
starting or stopping 27 installing localized version of operating upgrade 4
ASA system 33 ASA tasks 26
upgrade tasks 26 installing operating system language DBA tasks 23
asynchronous processing dispatcher pack 33 ITA tasks 13
enabling before upgrade 29 ITA on existing server instance 3
upgrade tasks 13 planning 1
planning and preparing 1
C planning considerations 6
CE_Operations custom settings 32 L SA tasks 21
locale and support for other upgrade expansion products 7
CFS database user 23
languages 35 Content Federation Services 7
configuring FileNet P8 components 18
FileNet P8 eForms 7
configuring the application server
Records Manager 8
forContent Platform Engine 28
upgrade tasks
Content Federation Services 7 M P8A 29
Content Platform Engine migration upgrade upgrading Content Engine
configuring AIX, HPUX, HPUXi, migrating the Windows platform to upgrading the underlying vendor
Linux, Linux on System z, and UNIX software 8
Solaris 18 goal overview 4 upgrading FileNet P8
configuring the application server 28
configuring AIX, HPUX, HPUXi,
Content Platform Engine application
Linux, Linux on System z, and
server installation account 16
Content Platform Engine application N Solaris 17
network Upgrading Process Engine
server installation group 17
configuring for FileNet P8 background information 8
Content Platform Engine operating
system user account 16 components 20
Content Platform Engine ports 40 new server instance
Content Search Services ports 44 changing application server W
hardware 4 worksheet
changing database server hardware 4 autofiltering and sorting 12
D running the customize macro 11
using the installation and upgrade
data collection tools
IBM Support Assistant Data O worksheet 10
Collector 20 operating system considerations 34
IBM Support Assistant Lite Data Oracle
Collector 20 planning for upgrades 25
database ports 45
DBA
upgrade tasks 23 P
DBexecute alias 31 P8A
upgrade tasks 29
ports 39, 40, 43, 44, 45, 46, 47
F Process Engine
FileNet Image Services ports 47 preparing for upgrades 30
FileNet P8 eForms 7 Process Simulator ports 43
Filenet P8 ports 39

© Copyright IBM Corp. 2001, 2016 55

56 Planning for FileNet P8
IBM®

Product Number: 5724-R76

5724-R81

GC19-3929-04