Installing a single-server IBM FileNet P8 Platform system with IBM Content Navigator

Product documentation

Abstract

You can install all of the IBM FileNet P8 Platform components on a single server, including the middleware applications such as the database and web application server software. When you provide all the installation software for the components and run the installation program, the IBM FileNet Composite Platform Installation Tool installs and configures the entire IBM FileNet P8 Platform environment automatically.

Content

This document contains the following sections: 

Preparing for the installation
To prepare for the single-server installation, you must create a download directory with all the software packages that are required for a full FileNet P8 Platform installation. You can download the installation packages from the IBM Passport Advantage website. Additionally, for each operating system certain prerequisites must be met.

Configuring local users and groups
The Composite Platform Installation Tool installation creates local users and groups for your FileNet P8 Platform environment. 

Running the Composite Platform Installation Tool
The Composite Platform Installation Tool uses the software images that you downloaded to install and configure the IBM FileNet P8 Platform environment on your server. You can choose to run the installation tool interactively by using a wizard or silently by specifying installation values in a silent input file.

Verifying a successful installation
After you install and configure your single-server IBM FileNet P8 Platform environment, you can use the Content Engine Health Page and the IBM Content Navigator to verify the success of your installation.

Changing the default passwords
When you run the installation tool to configure your single-server IBM FileNet P8 Platform environment, the installation tool creates default credentials for the system. After you install and verify your environment, you must change the default passwords on the user accounts to more secure values, and you must remove the password from the scripts that are used during the installation.

Cleaning up the system

If you want to rerun the Composite Platform Installation Tool installation on the same physical server as a previous installation, you can follow these instructions to ensure that you removed all IBM FileNet P8 Platform components and middle-ware software installations.
_______________________________________________________________________________
Preparing for the installation

The Composite Platform Installation Tool requires a server with no existing IBM FileNet P8 Platform components or middle-ware software installations.

The Composite Platform Installation Tool supports only 64-bit versions of the following operating systems:

• AIX versions 6.1, 7.1
• Red Hat Enterprise Linux versions 5.x (5.5 minimum), 6.x
• Microsoft Windows Server 2008 R2

To prepare for the single-server installation, you must create a download directory with all the software packages that are required for a full FileNet P8 Platform installation. You can download the installation packages from the IBM Passport Advantage website. 

The Composite Platform Installation Tool uses a set of predetermined software installation packages. See Downloading software packages for a single-server installation of IBM FileNet P8(http://www.ibm.com/support/docview.wss?uid=swg24030145) for the list of part numbers that identify the packages that you need to create the download directory.

To prepare for the installation:

1. Log on as an administrator to the server where you plan to run the Composite Platform Installation Tool.
2. Create a directory for the installation packages, for example, Platform_Downloads. You must have at least 30 GB of space available.
3. Download all of the following installation packages to the download directory that you created. Download the installation packages as compressed files, but do not extract the installation packages in the download directory.

IMPORTANT

: Make a note of each file name and component as you download or copy the file into the download directory. Files that are named as part numbers might be difficult to identify later when you must rename the files to the names that are used by the installation tool. 

Required packages:

• Content Engine 5.1.0
• Content Engine Client 5.1.0
• Process Engine 5.0.0
• Process Engine 5.0.0 FP 03
• Process Engine Client 5.0.0 FP3
• Workplace XT 1.1.5
• WebSphere Application Server 7.0
• WebSphere fix pack 21
• Tivoli Directory Server 6.3
• GSKit 8 for TDS 6.3 (This package is needed for RHEL Linux only)
• DB2 for Tivoli Directory Server 9.7 fix pack 5
• IBM Content Navigator 2.0.0

4. Rename the compressed files to the names that are used by the installation tool. The installation tool looks for these new names when it installs and configures the software components. Do not change the file extensions.

   
   IMPORTANT: Do not rename the WebSphere Application Server fix pack.

   Use the following names when you rename your downloaded files: 

   Installation images compressed file name: partnumber.fileextension	Rename to this: newname.fileextension
   Example: C1FZ9ML.tar.gz	Example: was.tar.gz
   Content Engine	ce
   Content Engine Client	cec
   Process Engine	pe
   Process Engine 5.0.0 FP03	pefp
   Process Engine Client 5.0.0. FP03	pec
   Workplace XT	wpxt
   WebSphere Application Server	was
   WebSphere Application Update Installer	wasupdi
   WebSphere fix pack	Do not rename.
   Tivoli Directory Server	tds
   DB2 for Tivoli Directory Server	db2
   DB2 License File	db2lic
   GSKit V8 for TDS 6.3 (Linux only)	tdsgskit
   IBM Content Navigator 2.0.0	nexus

 

5. Create a backup of your server. You can restore this backup in case you need to rerun the Composite Platform Installation Tool.

Operating system prerequisites

Prerequisites: AIX
IMPORTANT: The server must be a clean system (that is, without Tivoli Directory Server, DB2, WebSphere Application Server, or FileNet P8 pre-installed).

• The installation must be performed by the root user (Tivoli Directory Server requirement).
• The /opt device must be mounted and available.
• Space requirements:
  • The /opt directory must have a minimum of 30 GB of free disk space.
  • The /tmp directory must have a minimum of 3 GB of free disk space.
  • The /home directory must have a minimum of 2 GB of free disk space.
• The server must have a minimum of 6 GB of RAM.
• The utility gunzip must be installed and in the server path.
  • On AIX systems, ensure that the gunzip program is available in the /usr/bin directory before you run the installation task.
• The utility unzip must be installed. The unzip package can be downloaded at the following website:
  http://www.ibm.com/systems/power/software/aix/linux/toolbox/ezinstall.html
• The required packages must be staged on the locally mounted file system.
• For AIX servers, you must configure network ports for Process Engine before you run the Composite Platform Installation Tool. See the topic "Modifying /etc/rc.dt for AIX 5.3 and 6.1"http://pic.dhe.ibm.com/infocenter/p8docs/v5r1m0/topic/com.ibm.p8.planprepare.doc/p8ppi046.htm in Planning and Preparing for IBM FileNet P8 for details. 

Prerequisites: Linux 
IMPORTANT: The server must be a clean system (that is, without Tivoli Directory Server, DB2, WebSphere Application Server, or FileNet P8 preinstalled).

• The installation must be performed by the root user (Tivoli Directory Server requirement).
• The /opt device must be mounted and available.
• Space requirements:
  • The /opt directory must have a minimum of 30 GB of free disk space.
  • The /tmp directory must have a minimum of 3 GB of free disk space.
• The server must have a minimum of 6 GB of RAM.
• The following 32 and 64-bit packages must be preinstalled on your Red Hat Enterprise Linux server as noted in the following documents:

  http://pic.dhe.ibm.com/infocenter/wasinfo/v7r0/topic/com.ibm.websphere.installation.nd.doc/info/ae/ae/tins_linuxsetup_rhel5.html or

  http://pic.dhe.ibm.com/infocenter/wasinfo/v7r0/topic/com.ibm.websphere.installation.nd.doc/info/ae/ae/tins_linuxsetup_rhel6.html

  • compat-libstdc++-33-3.2.3-61
  • compat-db-4.2.52-5.1
  • libXp-1.0.0-8
  • libXmu-1.0.2-5
  • libXtst-1.0.1-3.1
  • pam-0.99.6.2-3.26.el5
  • rpm-build-4.4.2-37.architecture.el5 or later
  • elfutils-0.125-3.el5
  • elfutils-libs-0.125-3.el5libXft-2.1.10-1.1
  • RHEL v6 additional requirements
    • ksh-20100621-2
    • gtk2-2.18.9-4
    • gtk2-engines-2.18.4-5
    • libXft-2.1.13-4.1
• The required packages must be staged on the locally mounted file system.
• Both the unzip and gunzip utilities must be installed.
  On Linux systems, ensure that the gunzip utility is available in the /usr/bin directory before you run the installation task.
• If SElinux is set to Enforce, you cannot run the installation program. 
  You can start the installation program only if SElinux is set to Permissive or Disabled. You can temporarily change SElinux to Permissive by running this command: 
  echo 0 >/selinux/enforce

Prerequisites: Windows 
IMPORTANT: The server must be a clean system (that is, without Tivoli Directory Server, DB2, WebSphere Application Server, or FileNet P8 preinstalled).

• You must log on as the local administrator.
• You must disable “User Account Control (UAC)” before running the Composite Platform Installation Tool. After the installation is completed successfully, you can reenable UAC.

  See link at the end of this document for a link to the User Account Control from microsoft.com.

• Space requirements:
  • The C: drive must have a minimum of 30 GB of free disk space.
  • The .. emp directory must have a minimum of 3 GB free disk space.
• The server must have a minimum of 6 GB of RAM.
• Web Services Enhancements 3.0 for Microsoft .NET redistributable runtime must be pre-installed.
  http://www.microsoft.com/downloads/details.aspx?FamilyID=9e59c3fb-e7bc-4d91-908e-411a8d329f3d&displaylang=en
• The required packages must be staged on the local disk.

_______________________________________________________________________________ 
Configuring local users and groups 

The Composite Platform Installation Tool automatically creates local users and groups for your FileNet P8 Platform environment.

______________________________________________________________________________
Running the Composite Platform Installation Tool

The Composite Platform Installation Tool uses the software that you downloaded to install and configure the IBM FileNet P8 Platform environment on your server. You can choose to run the installation tool interactively by using a wizard or silently by specifying installation values in a silent input file.

Running the Composite Platform Installation Tool interactively
After you prepare the download directory, you can run the Composite Platform Installation Tool interactively. When you start the installation program and provide the necessary values, the installation tool runs the installation automatically.

To run the Composite Platform Installation Tool interactively:

1. Log on to the server, as appropriate for your operating system:
   UNIX: Log on as root.
   Windows: Log on as a member of the local Administrators group.
2. Navigate to the directory where you downloaded the Composite Platform Installation Tool.
3. Edit the license agreement values in a text file in the package. This editing step accepts the license agreements for all the software components that are installed by the Composite Platform Installation Tool.
   1. Open the CDroot/cpit.properties file and change the LICENSE_ACCEPTED_# parameter to TRUE for each software component.
   2. Save and close the file.
4. Run the installation tool that is appropriate for your operating system:
   AIX: 5.1.0-CPIT-AIX.BIN
   Linux: 5.1.0-CPIT-LINUX.BIN
   Windows: 5.1.0-CPIT-WIN.EXE
5. Accept the license agreement.
6. On the Specify Download Directory window, click Choose to browse to the directory that
   contains the downloaded software packages.
7. Review the preinstallation summary, and click Install to begin the installation.
   The installation processes can take approximately two to three hours. You can ignore or close any component administrative tools that display during the installation.
8. If the installation does not complete, check the IBMcpitcpit_install_log_5.1.0.txt log file for details.

Running the Composite Platform Installation Tool silently 
If you choose to run the Composite Platform Installation Tool silently, you must specify the appropriate values in the silent input text file. When you run the command and specify the silent input text file, the tool runs the installation and configuration automatically. 

To run the Composite Platform Installation Tool silently:

1. Log on to the server, as appropriate for your operating system:
   UNIX: Log on as root.
   Windows: Log on as a member of the local Administrators group.
2. Navigate to the directory where you downloaded the Composite Platform Installation Tool.
3. Edit the license agreement values in a text file in the package. This editing step accepts the license agreements for all the software components that are installed by the Composite Platform Installation Tool.
   1. Open the CDroot/cpit.properties file, and change the LICENSE_ACCEPTED_# parameter to TRUE for each software component.
   2. Save and close the file.
4. Edit the cpit_silent_install.txt file with the values for your installation.
   1. Open cpit_silent_install.txt for editing.
   2. In the file, set LICENSE_ACCEPTED=TRUE.
   3. Set USER_SELECTED_FOLDER to the full path for the download directory that you created, for example: /download_path/Platform_Downloads.
   4. Save and close the file.
5. Run the installation tool, as appropriate for your operating system:
   AIX: 5.1.0-CPIT-AIX.BIN -i silent -f /path_to_file/cpit_silent_install.txt
   Linux: 5.1.0-CPIT-LINUX.BIN -i silent -f /path_to_file/cpit_silent_install.txt
   Windows: 5.1.0-CPIT-WIN.EXE -i silent -f path_to_filecpit_silent_install.txt
   The installation processes can take approximately two to three hours. You can ignore or close any 
   component administrative tools that display during the installation.

If the installation does not complete, check the cpit_install_stderr.txt log file for details. This file is located in the /tmp directory on UNIX or in the TEMP folder on Windows.

________________________________________________________________________________
Verifying a successful installation

After you install and configure your single-server IBM FileNet P8 Platform environment, you can use the Content Engine Health Page and the IBM Content Navigator application to verify the success of your installation.

To verify the installation:

1. Verify Content Engine by using the ping page and health pages:
   Ping page: http://ce_server:port/FileNet/Engine
   Health page: http://ce_server:port/P8CE/Health
2. Verify IBM Content Navigator: 
   Start the Tivoli Web Admin Tool and verify you can see users/groups/domain objects.
   
   Optional installation checks:
3. Verify the Tivoli Directory Server:
   Use an LDAP browser to verify the Tivoli installation. Check for user cn=P8Admin,o=sample.
4. Verify DB2:
   1. Log in as any database user, for example, su -dsrdbm01.
   2. Test the Content Engine database connection by running the following command: 
      db2 connect to gcd_db user gcddbusr
5. Verify Process Engine by using the ping page: 
   http://pe_server:32776/IOR/ping
6. Verify Tivoli Web Admin Tool:
   Start the Tivoli Web Admin Tool and verify that you can see users/groups/domain objects.
7. Verify the Workplace XT installation:
   1. Access the following URL, replacing cpit_server with the appropriate value:
      http://cpit_server:9080/WorkplaceXT
   2. Log in with the credentials that were provided in install_path/IBM/cpit/readme.txt.
   3. Use Workplace XT to browse, search, add a document, and view the Tasks page.
   4. Open Process Designer.

________________________________________________________________________________ 
Changing the default passwords 
When you run the installation tool to configure your single-server IBM FileNet P8 Platform environment, the installation tool creates default credentials for the system. After you install and verify your environment, you must change the default passwords on the user accounts to more secure values, and you must remove the passwords from the scripts that are used during the installation.

To change the default passwords:

Follow the instructions in the Security documentation to change the default passwords. For details, see the IBM FileNet P8 help topics under Security > IBM FileNet P8 Security > How to....http://pic.dhe.ibm.com/infocenter/p8docs/v5r1m0/topic/com.ibm.p8.security.doc/p8pss000.htm

 

To remove the passwords in the installation scripts

1. Open the install_path/IBM/cpit/readme.txt file.
2. Run the pwdchange script:
   UNIX: ./pwdreset.sh password
   Windows: pwdreset.bat password
3. Verify that pwdchange updates all installation scripts by wiping out the Administrative password from every script.

Review the list of installation scripts that are included in the 

pwd_filelist.txt

 file. Check each of the installation scripts to ensure that the passwords are removed.

_________________________________________________________________________________ 
Cleaning up the system

If a single-server installation must be repeated, the following checks are helpful to prevent any issues.

This example assumes a Linux deployment.

1. Make sure that processes are not running on ports 9080 and 3737 (for example, lsof -wni tcp:3737) for the following software packages:
   • WebSphere
   • Tivoli Directory Server
   • DB2
2. The Tivoli Directory Server installation must be cleaned completely, leaving no residual DB2 instances, users, groups, or any DB2 or Tivoli Directory Server entries in the registry.
3. To ensure that the single-server installation is uninstalled, check for the following users and groups:
   1. Ensure that users that were created by the Composite Platform Installation Tool are removed from the /home directory by using the following command:
      userdel -r username for the following users:
      gcddbusr, nxsdbusr, osdbuser, P8Admin, dsrdbm01, idsldap
   2. Ensure that groups that were created by the Composite Platform Installation Tool are removed by using the following command:
      cmd groupdel groupname 
      for the following groups: fnop , fnusr , idsldap , grrdbm01 , fnadmin
4. Remove any residual directories that might not be removed after uninstalling the respective components:
   1. Remove the DB2 directory if it is present in the /var directory.
   2. Remove the idsldap directory from the /var directory.
   3. In the /usr/local/bin directory, remove the db2ls directory.
   4. Remove the following directories by using the following commands:
      rm -rf /home/dsrdbm01
      rm -rf /opt/IBM/NEXUSDB2
      rm -rf /opt/IBM/CPITDB
      rm -rf /opt/IBM/ltpakeys.txt