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 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 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:
-
Log on to the SmartPlant Markup Plus server as an administrator.
-
Open the server.properties file delivered to the Brava! Server folder.
-
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.
-
Save changes to the file.
-
Share and grant access to the new dlcache folder location.
-
Remove access to the previous dlcache folder location.
-
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.
-
Log on to the SmartPlant Markup Plus server as an administrator.
-
Open the server.properties file delivered to the Brava! Server folder.
-
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.
-
Save changes to the file.