FileNet P8 Workplace XT, Version 1.1.5              

Running the Workplace XT installation silently

You can use a command-line option with a response file to install Workplace XT silently.

Important: In a high availability environment, you must install Workplace XT on all nodes in the application server configuration. Even in an application server cluster configuration Workplace XT provides components that run outside of the application server such as the Component Manager. These components are only available through a Workplace XT installation.
To install the Workplace XT software silently:
  1. Collect the parameters that are required to complete your installation. For information about parameter values, see documentation about the installation and upgrade worksheet in Plan and Prepare Your Environment for IBM FileNet P8.
    HINT 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 that 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. Edit your Workplace XT response file to reflect the options you collected in the worksheet.
    Note: In high availability environments, specify the location to hold the Workplace XT shared configuration data.
  5. Optional: Install IBM Production Imaging Edition Viewer Pro. 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 silently install the license file:
    1. Access the IBM Production Imaging Edition Viewer Pro package, copy the silent-input template file, and save the copy with a different file name. The silent-input template file is PIEsilent_input.txt on UNIX operating systems and PIEsilent_input_windows.txt on Windows.
    2. Referring to the values from your worksheet, edit the renamed copy of the silent input file to reflect the appropriate responses for your installation.
      Note:

      At a minimum, you must edit the silent input file to accept the license agreement (-V licenseAccepted="true") before you can use the file for a silent installation.

    3. From a command prompt, navigate to and run the IBM Production Imaging Edition Viewer Pro license installation program:
    Option Description
    UNIX "./PIEProLic-1.1.5.0-operating_system.bin -options " path_to_edited_input_file/ input_file.txt " -silent

    where

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

    AIX®, HPUX, HPUXi, Linux, or SOL

    input_file.txt is the silent input file you edited for the installation.

    Windows PIEProLic-1.1.5.0-WIN.exe -options " path_to_edited_input_file \ input_file.txt " -silent

    where input_file.txt is the silent input file you edited for the installation.

    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 the Workplace XTupgrade. Often problems are logged with the term "ERROR" at the beginning of a line.

    Note: For more information about IBM Production Imaging Edition Viewer Pro, see Production Image Edition on the IBM website.
  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 Workplace XT.
    Windows Log in as a member of the local Administrators group or a user with equivalent permissions.
  7. From a command prompt, navigate to and run the Workplace XT installation program.
    Option Description
    UNIX ./WorkplaceXT-1.1.5.0-operating_system.bin -options " path_to_edited_input_file/ input_file.txt " -silent

    where

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

    AIX, HPUX, HPUXi, Linux, SOL

    input_file.txt is the response file you created or the silent input file you edited for the installation.

    Windows WorkplaceXT-1.1.5.0-WIN.exe -options " path_to_edited_input_file \ input_file.txt " -silent

    where input_file.txt is the response file you created or the silent input file you edited for the installation.

  8. 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.

  9. 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
wxtip011.htm

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