Starting from version 1.9.8.2.10, DMS utilizes an external worker container to generate previews and parse emails.

This container requires a minimum of 4GB of free RAM in addition to the necessary overhead for Docker and other applications. Please ensure that your system meets these requirements.

The procedure:

• Pull latest version of config repository
• Pull latest version of deploy_script repository

• Update the commands.conf file by adding the following code block after the add_variable "ES_JAVA_OPTS" "-Xms${ES_XMS} -Xmx${ES_XMX}" line, if it does not already exist:

  elif [ ${1} = "WORKER" ] then add_volume ${NUXEO_TEMPDIR} "/tmp" add_volume ${NUXEO_WINFONTDIR} "/usr/share/fonts/custom-fonts" add_volume ${NUXEO_WINFONTDIR} "/root/.windows_fonts" add_volume ${NUXEO_LOGDIR} "/var/log/worker"

• Configure the nuxeo and cb images to use version 1.9.8.2.10.
• Perform a proper system redeployment.

Troubleshooting:

If the worker container constantly restarts, it may be due to an outdated Docker version.

To resolve this issue, execute a yum update. If the Docker service does not start, you may need to create or update the /etc/docker/daemon.json file with the following content:

{
"storage-driver": "devicemapper"
}

Changelog for administrators

• Nuxeo Default Fulltext Functionality Disabled: The default fulltext functionality in Nuxeo has been disabled due to excessive CPU and IO load and an increase in Nuxeo database entries. This change also disables the 'Filter' feature in the folder view of the Nuxeo Console, which was occasionally used by administrators. Instead, please use the Nuxeo Search page or provide the direct path in the URL.

• Option to Disable Default Nuxeo Audit Log: The default Nuxeo audit log, which can produce excessive entries in the Nuxeo database's nxp_logs table, can now be disabled. This change disables the document history in the Nuxeo Console. To disable the audit log, add the following line to dms.conf:

  DISABLE_NXP_LOGS=true

  It is highly recommended to disable the audit log when updating to this and future versions, as it consumes significant disk space and generates excessive IO and CPU load.
  Only keep the audit log enabled if the client utilizes Nuxeo document history.
  Audit logs are disabled by default for all new repositories.
  To free up space used by audit logs, execute the following command:

  docker exec postgres psql -d nuxeo -U postgres -c "TRUNCATE nxp_logs CASCADE;"

• User Access Logging Enabled by Default: The enable.user.access.logging entry in PAT_DMS_SETTINGS is now set to true by default, providing a replacement for the audit log.
• Parallel Execution of Sweepers: Sweepers can now be run in parallel. In previous versions up to 1.9.8.2.9, sweepers were executed sequentially.

Deploy script changelog

• New DMS_IMAGE_VERSION Variable: A new DMS_IMAGE_VERSION variable is available for dms.conf. If provided, this version will be used for Nuxeo, CaseBrowser, and worker containers. When deploying a Nuxeo or CaseBrowser container, a new worker container will be deployed with the same version as the Nuxeo container. Old image versions variables are still supported.
• Worker container: On deployment of nuxeo or casebrowser container, new worker container will be deployed with version equal to the nuxeo container version.
• Deprecated CLI Options:
  • The -rmc option is deprecated. The deploy script now always deletes unused containers.
  • The -rmi option is deprecated. The deploy script now always deletes unused images.
  • The -v, -vv, and -vvvv options are deprecated. Only the -vvv option is available for deployment in DEBUG log mode.
• Debug Mode Limitations: The production environment should be run without the -vvv option, as the DEBUG level of logs generates excessive load on the filesystem and CPU. The -vvv option should only be used upon request from the PaceIP support team.
• NX_XMS and CB_XMS variables are deprecated: NX_XMX and CB_XMX will be used instead to define minimal heap size of java processes.