Installing Oracle OutsideIn Technology fix on DOORS Next

Refer to the following instructions for applying Oracle OutsideIn fixes on DOORS Next.

About this task

Use the following table to determine which patch folder to use for your particular installation. If your platform is not similar to one of those listed, these instructions may not be applicable. However, if the EXPORTER_DIR exists and the uploaded file previews work on your server, then these steps should be applied to get the benefits of the security patch.

Folder name Supported platform
aix-ppc-64 AIX® 7.1 POWER® System - Big Endian - 64 bit and future OS fix packs
aix-ppc-64 AIX 7.2 POWER System - Big Endian - 64 bit and future OS fix packs
linux-x86-64 Red Hat® Enterprise Linux® (RHEL) Server 7 x86-64 and future OS fix packs
linux-x86-64 Red Hat Enterprise Linux (RHEL) 8 x86-64 and future OS fix packs
linux-x86-64 SUSE Linux Enterprise Server (SLES) 12 x86-64 and future OS fix packs
win-x86-64 Windows Server 2012 R2 Datacenter and Standard Editions and future OS fix packs
win-x86-64 Windows Server 2016 Datacenter and Standard Editions and future OS fix packs
win-x86-64 Windows Server 2019 Datacenter and Standard Editions and future OS fix packs
  • INSTALL_DIR: Absolute location where DOORS Next is located.
  • EXPORTER_DIR (Located in INSTALL_DIR/server/conf/rm/exporter directory): This directory is the absolute location of the OutsideIn shared libraries that DOORS Next uses for image generation. You might have replaced some of these libraries with the updated versions contained in this patch.
  • PATCH_ZIP_FOLDER: This folder should contain the file README.txt and the following three folders: aix-ppc-64, linux-x86-64, and win-x86-64.

Procedure

  1. Optional: Backup your EXPORTER_DIR in another location in case something goes wrong in the process.
    Additionally, you can confirm that image generation works before applying this patch by uploading a new file (do not use one already on the server) that supports image generation and confirming that images are generated for it.
  2. Refer to the table to determine your supported platform and the folder name that contains the new library for replacing in your DOORS Next server's OutsideIn directory.
  3. Extract the contents of the .zip file to a temporary location.
  4. Copy the contents of the folder that is appropriate for your platform (determined in step 2) to the EXPORTER_DIR.
    When completed, there should be several libraries overwritten in your EXPORTER_DIR. Some of the files may not have changed, but are included because the patch is cumulative. Here are commands that you should be able to adjust for your system:

    Windows:

    1. Navigate to the PATCH_ZIP_FOLDER.
    2. Copy the contents of the win-x86-64 directory to the EXPORTER_DIR.

    Unix

    1. Navigate to the PATCH_ZIP_FOLDER by using cd command.
    2. Copy the patch contents to EXPORTER_DIR:

      For Linux, run \cp -f -R linux-x86-64/* EXPORTER_DIR.
      For AIX, run \cp -f -R aix-ppc-64/* EXPORTER_DIR.

    AIX

    1. If switching from AIX 32-bit to 64-bit, ensure that you copy contents of EXPORTER_DIR to a safe location to preserve ix.properties file.
    2. Remove the contents of EXPORTER_DIR.
    3. Run \cp -f -R aix-ppc-64/* EXPORTER_DIR.
    4. Copy ix.properties from the saved copy of EXPORTER_DIR back to EXPORTER_DIR.
    5. If necessary, use chmod to give permissions to the exporter file to the account running the server.
    These changes take effect immediately. No server restart is required.
  5. Optional: Upload a file to the server that supports image generation to verify that the image generation facility functions appropriately. If there is an issue, you can restore your backup of EXPORTER_DIR.