Modify dlcache settings - SmartPlant Markup Plus - Version 2019 SP 1 (10.0.1) - Installation & Upgrade

SmartPlant Markup Plus Installation

Language
English (United States)
Product
SmartPlant Markup Plus
Search by Category
Installation & Upgrade
SmartPlant Foundation / SDx Version
10
SmartPlant Markup Plus Version
10.0 (2019)

These steps are required for configuring SmartPlant Markup Plus Server for SmartPlant Foundation Web Client and HxGN SDx.

The dlcache folder is used to cache non-Hexagon PPM files so that they display faster.

Grant access

Access to the configured local or shared dlcache folder can be limited, but at minimum, you must grant the account running the Brava! Job Processor service Full Control permissions for both Share Permissions and Security. If the Brava! Job Processor is installed on a separate server, the dlcache folder must be located in a shared UNC path. For example, \\server\share.

To enable the Clear Display Cache command (available in Update 14), you must grant the SmartPlant Foundation application pool identity user read and write permissions to the configured local or shared dlcache folder. This is because the application worker process examines the folder and identifies files for removal.

If you are using a version prior to SmartPlant Markup Plus 2019 Service Pack 1, the job processor service is called Blazon Job Processor.

For assistance with limiting access to the dlcache shared folder, please contact customer support.

Change folder location or enable Win32 long paths

Windows limits the maximum length for a path to 260 characters. This is an issue if your non-Hexagon PPM files have very long file names. You must move the dlcache folder to a new location with a shorter path or enable Win32 long paths where SmartPlant Markup Plus Server is installed. For help, see Windows Help.

If you move the dlcache folder to a new location, you must do the following:

  1. Log on to the SmartPlant Markup Plus server as an administrator.

  2. Open the server.properties file delivered to the Brava! Server folder.

  3. Update the local.displaylist.cache.root property to the full path of the dlcache folder.

    If you are using version 2019 Update 14 or later, you must ensure that the BravaCacheLocation setting in SmartPlant Foundation Server Manager is also up-to-date. For more information, see Site Settings node properties.

  4. Save changes to the file.

  5. Share and grant access to the new dlcache folder location.

  6. Remove access to the previous dlcache folder location.

  7. Go to Start > Administrative Tools > Services and restart these services in the following order:

    • Apache Tomcat

    • Brava! Job Processor

      If you are using a version prior to SmartPlant Markup Plus 2019 Service Pack 1, the job processor service is called Blazon Job Processor.

    • Blazon Queue Server

Limit folder size

Folder size might grow, impacting performance. Follow these steps to restrict folder size.

  1. Log on to the SmartPlant Markup Plus server as an administrator.

  2. Open the server.properties file delivered to the Brava! Server folder.

  3. Update the displaylist.cache.maximum.size property.

    The value is the number of bytes that the folder can be truncated to at the completion of every publish request. If the current size exceeds this value, the oldest published file or files will be removed from the folder until the size is less than 90% of this value. The default is 10000 MB.

  4. Save changes to the file.