Installing the Content Engine and IBM Content Engine Client fix pack or iFix manually for CR1

The CR1 instructions for updating FileNet® are provided in this section as a convenience if you are still in the process of applying CR1 and are not planning to apply CR2 right away. Skip these procedures if you have already applied CR2 or have an existing FileNet deployment that was installed independently of IBM Connections.

Before you begin

Make sure the Connections 5.0 CR1 update is installed before attempting to upgrade the CE server, CE client, and FNCS.

Procedure

  1. Make sure Connections is running before running these upgrade scripts.
  2. Navigate to the folder where IBM® Content Engine and IBM Content Engine Client have been downloaded. For example, for CE IF003, the folder should contain the following items:
    • Windows: 5.2.0.3-P8CPE-WIN-IF003.EXE and 5.2.0.3-P8CPE-CLIENT-WIN-IF003.EXE
    • AIX®: 5.2.0.3-P8CPE-AIX-IF003.BIN and 5.2.0.3-P8CPE-CLIENT-AIX-IF003.BIN
    • Linux: 5.2.0.3-P8CPE-LINUX-IF003.BIN and 5.2.0.3-P8CPE-CLIENT-LINUX-IF003.BIN
    • zLinux: 5.2.0.3-P8CPE-zLINUX-IF003.BIN and 5.2.0.3-P8CPE-CLIENT-zLINUX-IF003.BIN
  3. For Linux and AIX only, assign permission to /opt/IBM/Connections/ccm/ccm/ccm as follows:
    run chmod -R 777 * under the folder  /opt/IBM/Connections/ccm/ccm/ccm
  4. Back up your current Connections Content Manager deployment as follows (if you haven't run the backup already):
    1. Make sure that the Deployment Manager is running.
    2. Navigate to the connections_root/opt/IBM/Connections/ccm/ccm/ccm/scripts folder to run the backup script appropriate to your operating system:
      • For Windows use the backup.bat [-param value] ... [-paramN valueN] script with the following parameters:
        • was.dm.path is the path of WebSphere® Application Server Deployment Manager.
        • was.admin.user is the username of WebSphere Application Server administrator.
        • was.admin.password is the WebSphere Application Server administrator password.
        For example:
        backup.bat -was.dm.path "C:\Program Files\IBM\WebSphere\AppServer\profiles\Dmgr01" -was.admin.user wasadmin -was.admin.password passw0rd
      • For AIX or Linux use the ./backup.sh [-param=value] ... [-paramN=valueN] script with the following parameters:
        • was.dm.path is the path of WebSphere Application Server Deployment Manager.
        • was.admin.user is the username of WebSphere Application Server administrator.
        • was.admin.password is the WebSphere Application Server administrator password.
        For example:
        ./backup.sh -was.dm.path=/opt/IBM/WebSphere/AppServer/profiles/Dmgr01 -was.admin.user=wasadmin -was.admin.password=passw0rd
  5. Run the upgrade CE script as follows:
    1. Make sure you have at least 6 GB in %TEMP% (Windows) or /tmp (Linux) disk.
    2. Navigate to the connections_root/opt/IBM/Connections/ccm/ccm/ccm/scripts folder to run the update scripts for CE FP/IF:
      • For Windows, use the update-ce.bat script with the following parameters:
        • was.dm.path is the path of WebSphere Application Server Deployment Manager.
        • was.admin.user is the username of WebSphere Application Server administrator.
        • was.admin.password is the WebSphere Application Server administrator password.
        • ce.fp.installer.location is the location of CE Fix pack installer.
        For example:
        update-ce.bat -was.dm.path "C:\Program Files\IBM\WebSphere\AppServer\profiles\Dmgr01" -was.admin.user wasadmin -was.admin.password passw0rd -ce.fp.installer.location C:\ce-fp\installer\5.2.0.3-P8CPE-WIN-IF003.EXE
        Note: If your DM path contains spaces, add quotation marks to the path.
      • For AIX or Linux, use the ./update-ce.sh script with the following parameters:
        • was.dm.path is the path of WebSphere Application Server Deployment Manager.
        • was.admin.user is the username of WebSphere Application Server administrator.
        • was.admin.password is the WebSphere Application Server administrator password.
        • ce.fp.installer.location is the location of CE Fix pack installer.
        For example:
        ./update-ce.sh -was.dm.path=/opt/IBM/WebSphere/AppServer/profiles/Dmgr01 -was.admin.user=wasadmin -was.admin.password=passw0rd -ce.fp.installer.location=/opt/build/5.2.0.3-P8CPE-LINUX-IF003.BIN
        Note: If you don't append these parameters, you will be prompted for them while the update script runs.
      Note: After using update-ce.bat or ./update-ce.sh to update to CE IF003, you also need to update the waltz.jar and sonata.jar files as described in this tech note.
    After you run the first update, the filenetengine application is redeployed. Remap the application to your web server as described in Mapping applications to IBM HTTP Server.
  6. Make sure Connections is running (it will be marked as stopped after the update) and the filenetengine application is started before running the next upgrade command.
  7. Run the upgrade script as follows:
    1. Make sure that the FileNetEngine server's status is enabled (Status shows green checkmark) via the WebSphere Application Server administrative console: Servers > Server Types > WebSphere application servers.
    2. Navigate to the connections_root/opt/IBM/Connections/ccm/ccm/ccm/scripts folder to run the update scripts for CE Client Fix pack:
      • For Windows, use the update-fncs-ceclient.bat script with the following parameters:
        • was.dm.path is the path of WebSphere Application Server Deployment Manager.
        • was.admin.user is the username of WebSphere Application Server administrator.
        • was.admin.password is the WebSphere Application Server administrator password.
        • ceclient.fp.installer.location is the location of CE Client Fix pack installer.
        • doInstallFNCS Set to y if installing FNCS or n if not installing FNCS.
        • doInstallCEClient Set to y if installing CE Client or n if not installing the CE Client.
        For example:
        update-fncs-ceclient.bat -was.dm.path "C:\Program Files\IBM\WebSphere\AppServer\profiles\Dmgr01" -was.admin.user wasadmin -was.admin.password passw0rd -doInstallFNCS n -ceclient.fp.installer.location C:\fncs-fp\installer\ 5.2.0.3-P8CPE-CLIENT-WIN-IF003.EXE -doInstallCEClient y
        Note: If you don't append these parameters, you will be prompted for them while the update script runs.
    3. For AIX or Linux, use the ./update-fncs-ceclient.sh script with the following parameters:
      • was.dm.path is the path of WebSphere Application Server Deployment Manager.
      • was.admin.user is the username of WebSphere Application Server administrator.
      • was.admin.password is the WebSphere Application Server administrator password.
      • ceclient.fp.installer.location is the location of CE Client Fix pack installer.
      • doInstallFNCS Set to y if installing FNCS or n if not installing FNCS.
      • doInstallCEClient Set to y if installing CE Client or n if not installing the CE Client.
      For example:
      ./update-fncs-ceclient.sh -was.dm.path=/opt/IBM/WebSphere/AppServer/profiles/Dmgr01 -was.admin.user=wasadmin -was.admin.password=passw0rd -doInstallFNCS=n -ceclient.fp.installer.location=/opt/build/ 5.2.0.3-P8CPE-CLIENT-LINUX-IF003.BIN -doInstallCEClient=y
      Note: If you don't append these parameters, you will be prompted for them while the update script runs.
  8. After the update process completes successfully, restart the cluster that the FileNet application, FileNetEngine, is hosted on in order to use it.

Results

When updating an already installed Connections Content Manager, run the ccmUpdate.bat|sh command in the ccmDomainTool package to update the User Token Cache and Subject Cache values to 3600 as follows:
  1. Make sure the cluster and Connections Content Manager are running before running the ccmUpdate task.
  2. Run the command as follows:
    • For AIX/Linux:
      cd /opt/IBM/Connections/addons/ccm/ccmDomainTool/
       chmod +x ccmUpdate.sh
       ./ccmUpdate.sh
    • For Windows:
      cd C:\Program Files\IBM\Connections\addons\ccm\ccmDomainTool/
       ccmUpdate.bat