Integrating with IBM Docs

You can configure IBM Verse™ On-Premises to work with IBM Docs™ 2.0 CR2 to get an enhanced preview for file attachments. Integration with IBM Docs enables Verse On-Premises users to preview PDF, Microsoft Office, OpenOffice and other types of file attachments when reading and composing messages, without having to download those attachments first.

Note:
  • SAML authentication and previewing and sharing attachments in encrypted messages are not supported in this release.
  • Do not use the iNotes_WA_Security_NonceCheck=0 notes.ini setting on the server. Doing so will prevent attachment previewing.
  1. Install IBM Docs 2.0 CR2. For information on installing IBM Docs, see Installing and deploying IBM Docs 2.0.
  2. Enable CORS on IBM Docs to allow cross origin requests. Verse On-Premises use IBM Docs JavaScript API to communicate with IBM Docs. To enable CORS access, the Domino server's domain name must be added into the WhiteDomainList of IBM Docs.
    Note: Verse On-Premises communicates with IBM Docs' Viewer component. So in addition to concord-config.json, WhiteDomainList field inside viewer-config.json also needs to be updated.

    Example:

    "WhiteDomainList": ["https://mail.ibm.com"],
      "IHS_fast_download": {
        "cache_root_alias": "/rendition_content",
        "enabled": "false"
    },
    Note: If you are using a proxy server in front of the Domino server, the proxy server's domain name must be added to the WhiteDomainList of IBM Docs.
  3. Enable DAOS on the Domino server to improve preview performance.

    Domino Attachment and Object Service (DAOS) enables an attachment to be identified using a unique key (DAOS key) that's generated based on the attachment data. For more information on DAOS, see Attachment consolidation in the Domino documentation. When previewing an attachment in a DAOS-enabled mail file, Verse On-Premises will use the DAOS key to check if the attachment has already been cached in IBM Docs. This avoids having to transfer the attachment again if it has already been cached.

  4. Add Create_R85_Databases=1 to Domino server's notes.ini and restart Domino.
  5. From the server console, enter: load compact -c to upgrade mail files. This will perform a copy style compact of all databases and upgrade mail files to the current ODS level.
Note: Mail files should not be used during the compact process, otherwise the compact operation may fail to execute.