FileNet P8 Workplace XT, Version 1.1.5         

Installing IBM FileNet Workplace XT interactively

The installation program creates the IBM® FileNet® Workplace XT folder structure and files needed for Workplace XT. After installing the files, and any necessary updates, you must also configure and deploy the Workplace XT application.

Before you install IBM FileNet Workplace XT:
To install IBM FileNet Workplace XT software:
  1. Collect the parameters that are required to complete your installation. For information on parameter values, see documentation about the installation and upgrade worksheet in Plan and Prepare Your Environment for IBM FileNet P8.
    Note: With the 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 installation properties you must specify for the Workplace XT installation program:
    • Click the AutoFilter drop-down arrow in the Installation or Configuration Program column header and select WPXT installer.
    • Click the AutoFilter drop-down arrow in the Setup Type column header, select Custom, and specify Setup Type contains Installation.
    • Click the AutoFilter drop-down arrow in all other column headers and select (All).
  2. In highly available environments, mount the shared configuration directory from all nodes in the application server configuration.

    When the location of the shared configuration directory is decided, that directory must be mounted and accessible from all servers in the application server configuration. Also, ensure that the same directory path is used on all systems.

    If the path on the first system is:
    • //home/WebClient/Config
    make sure this same path is available on all other systems.
  3. (IBM WebSphere® Application Server in a highly available environment) Configure the node agent service to start as a user with access to the shared configuration directory. If IBM WebSphere Application Server is configured to start as a Windows Service, you must configure the node agent service with a user that has access to the shared configuration directory. The default startup user for the service is Local System, which cannot be given access to the shared directory.
  4. (IBM WebSphere Application Server or Oracle WebLogic Server in a highly available environment) Verify that your application farm or cluster configuration is running.
    Note: JBoss Application Server deploys applications on startup. There is no need to start the application server until you have installed the application.
  5. Optional: Install the IBM Production Imaging Edition Viewer Pro license file. If you have purchased IBM Production Imaging Edition, the Viewer Pro software can be installed when you run the Workplace XT installation. To activate the Viewer Pro installation, you must run the license installer before you install Workplace XT. To install the license file:
    1. Locate the IBM Production Imaging Edition Viewer Pro license installer package and run the appropriate installation program for your operating system.
      Platform Command
      AIX PIEProLic-1.1.5.0-AIX.bin
      HPUX PIEProLic-1.1.5.0-HPUX.bin
      HPUXi PIEProLic-1.1.5.0-HPUXi.bin
      Linux PIEProLic-1.1.5.0-LINUX.bin
      Solaris PIEProLic-1.1.5.0-SOL.bin
      Windows PIEProLic-1.1.5.0-WIN.exe
      Note: For more information about IBM Production Imaging Edition Viewer Pro, see Production Imaging Edition on the IBM website.
    2. Complete the IBM Production Imaging Edition Viewer Pro license installation program screens.
    3. View the PIEPro_install_log.txt file located in install_path/IBM/FileNet/PIEProLicense. Correct errors or failures noted in the log file before proceeding with Workplace XT installation. Often problems are logged with the term "ERROR" at the beginning of a line.
  6. Log in to the server where you want to install Workplace XT:
    Option Description
    UNIX Log in as a user with read, write, and execute access to the directory where you plan to install IBM FileNet Workplace XT.
    Windows Log in as a member of the local Administrators group or a user with equivalent permissions.
  7. Locate the IBM FileNet Workplace XT 1.1.5.0 installation software package.
  8. Start the installation program in one of the following ways:
    1. Run the appropriate installation program for your operating system.
      Platform Command
      AIX WorkplaceXT-1.1.5.0-AIX.bin
      HPUX WorkplaceXT-1.1.5.0-HPUX.bin
      HPUXi WorkplaceXT-1.1.5.0-HPUXi.bin
      Linux WorkplaceXT-1.1.5.0-LINUX.bin
      Solaris WorkplaceXT-1.1.5.0-SOL.bin
      Windows WorkplaceXT-1.1.5.0-WIN.exe
      Linux for System z® WorkplaceXT-1.1.5.0-ZLINUX.bin
    2. Optional: Run the installation program for your operating system, and have the program record your installation choices in a response file.

      Enter the following command:

      WorkplaceXT-1.1.5.0-operating_system.bin -options-record record_file_name

      (with no space between -options-record)

      where

      operating_system is the platform where you are installing Workplace XT, for example:

      AIX, HPUX, HPUXi, LINUX, SOL, WIN, or LINUX ON SYSTEM Z

      (For Windows, the file extension is .exe.)

      record_file_name is the name of the response file to be generated, for example, xt_record.txt.

      For more information about response files, see Generating the silent installation response files.

  9. Complete the Workplace XT installation program screens.
    Note: In high availability environments, specify the location to hold the Workplace XT shared configuration data on the Specify Configuration Directory screen.
  10. View the web_client_install_log_1.1.5.0.txt file located in install_path/IBM/FileNet/WebClient.

    Verify that no errors or failures were logged. Look for the ERROR designation at the start of a line. Correct any errors before you proceed.

  11. In highly available environments, you must synchronize the UTCryptoKeyFile.properties file across your Workplace XT nodes.

    Each participating Workplace XT server must use the same encryption key file. Copy the UTCryptoKeyFile.properties file installed on the first Workplace XT server in your farm to all the other servers in your farm.

    For more information about setting UTCryptoKeyFile.properties file, see FileNet documentation about user tokens.



Feedback

Last updated: March 2013
wxtip005.htm

© Copyright IBM Corporation 2013.
This information center is powered by Eclipse technology. (http://www.eclipse.org)