Installing interim fixes

Edit online

Install an interim fix for Publishing Document Builder by creating a new installation to obtain updated application files (rpeng.war and dgaas.war). These files are then applied to the existing Document Builder installation.

Procedure

  1. Stop the WebSphere Application Server Liberty Profile server that has the Publishing Document Builder package. Run the appropriate command based on your operating system:
    • Windows icon: Document_Builder_InstallDir\server\server.shutdown.bat

      For example: C:\Program Files\IBM\DocumentBuilder\server\server.shutdown.bat

    • Linux icon: Document_Builder_InstallDir/server/server.shutdown

      For example: /opt/IBM/DocumentBuilder/server/server.shutdown

  2. Install the interim fix to a new location.
    For example,
    • Windows icon

      C:\Program Files\IBM\Document_Builder_iFix

    • Linux icon

      /opt/IBM/Document_Builder_iFix

  3. Go to the application directory of the current installation.
    • Windows icon

      Document_Builder_InstallDir\server\liberty\servers\clm\apps

    • Linux icon

      Document_Builder_InstallDir/server/liberty/servers/clm/apps

  4. Backup the existing rpeng.war and dgaas.war files in the directory. Then, delete these files from the directory.
  5. To create Liberty Profile in interim fix installation, run the following command from the interim fix installation directory:
    • Windows icon

      Document_Builder_iFix\server\server.startup.bat -create

    • Linux icon

      Document_Builder_iFix/server/server.startup -create

  6. Copy the updated rpeng.war and dgaas.war from interim fix installation directory to the existing installation:
    • Windows icon

      From: Document_Builder_iFix\server\liberty\servers\clm\apps

      To: Document_Builder_InstallDir\server\liberty\servers\clm\apps

    • Linux icon

      From: Document_Builder_iFix/server/liberty/servers/clm/apps

      To: Document_Builder_InstallDir/server/liberty/servers/clm/apps

  7. Restart the WebSphere® Liberty server for the existing Publishing Document Builder installation by running the following command:
    • Windows icon: Document_Builder_InstallDir\server\server.startup.bat

      For example: C:\Program Files\IBM\DocumentBuilder\server\server.startup.bat

    • Linux icon: Document_Builder_InstallDir/server/server.startup

      For example: opt/IBM/DocumentBuilder/server/server.startup

What to do next

Verify that all existing data is retained, and remove the interim fix from the Document_Builder_iFix directory, as it is no longer required.