IBM Support

Cannot upload documents greater than 2GB using a Business Automation Navigator container in a Cloud Pak for Business Automation deployment

Troubleshooting


Problem

If Navigator is deployed as a container in a Cloud Pak for Business Automation (CP4BA) deployment, an error can occur when uploading files that are larger than 2GB.

The same issue does not occur with

  • A stand-alone Content Navigator container
  • A Content Navigator container in a FileNet Content Manager or IBM Content Foundation deployment.

Cause

In Business Automation Navigator or Content Navigator in a Cloud Pak for Business Automation deployment, when a file is added to a repository, the file is not saved as a temp file on the icn-vw-cachestore persistent volume claim (PVC).  If an attempt is made to upload large files, an out of memory error can occur on the Navigator pod.

Resolving The Problem

To resolve the issue set the following custom JVM parameter, and then restart the Navigator pod:

-Dcom.ibm.ecm.icn.system.action.upload.largeFile.chunked=true

Once the JVM parameter is set, files are broken into chunks and the chunks are saved in a temp file on the icn-vw-cachestore PVC. Then the content is sent to the Content Platform Engine.

To set the new parameter, add the following to the list of Navigator parameters in the custom YAML. The change is picked up by the Content Operator, and the Content Navigator pod is updated automatically with the JVM parameter.

spec:
  navigator_configuration:
    icn_production_setting:
      jvm_customize_options: "-Dcom.ibm.ecm.icn.system.action.upload.largeFile.chunked=true"

For more information on the available Navigator parameters: https://www.ibm.com/docs/en/filenet-p8-platform/5.5.12?topic=operators-content-navigator-parameters

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB18","label":"Miscellaneous LOB"},"Business Unit":{"code":"BU056","label":"Miscellaneous"},"Product":{"code":"SSEUEX","label":"IBM Content Navigator"},"ARM Category":[{"code":"a8m0z0000001gsdAAA","label":"ICN-\u003ECore-\u003EContainer"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.0.15"},{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSBYVB","label":"IBM Cloud Pak for Business Automation"},"ARM Category":[{"code":"a8m0z0000001iTlAAI","label":"Operate-\u003EBAN Install\\Upgrade\\Setup"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"23.0.2"}]

Document Information

Modified date:
15 December 2023

UID

ibm17086135

Page Feedback