Documentation

The complete knowledge base about ARender - How to install it and how to configure it as needed

Configuration

Configuration files of ARender HMI

ARender configuration files are located in the folder WEB-INF/classes of ARender webapp

File name Editable Role and content
arender-server-default.properties No Default properties configuration of ARender HMI including rendition server access and connector.
arender-server.properties No Default custom properties needed for our connectors. You can find ECM properties in there.
arender-server-custom-<…>.properties Yes Custom properties file of ARender HMI. To modify it copy the needed properties from arender-server-(default).properties.
arender-custom-server-integration.xml Yes Allows to insert custom Spring Bean, without overloading default ARender configuration.
arender.xml No Main configuration of ARender HMI.
ehcache.xml Yes Cache configuration of documents opened via the graphical interface.
log4j.properties Yes Application logs configuration.
arender-default.properties No Default interface configuration.
arender.properties Yes Custom configuration of ARender HMI (Cf. Profile)

Rendition server definition

In order to define one or several rendition servers, edit the arender-server-custom-<…>.properties configuration file as follow:

arender-server-custom-<...\>.properties
arender.server.rendition.hosts={rendition_server_1},{rendition_server_2},{rendition_server_n}
Note

The value of "{rendition_server_x}" here has to be changed by the right rendition server address

(Don’t forget to reboot your HMI)

XFDF annotation folder configuration

A default folder is configured in ARender to saved annotations as XML files. The user that launch the application server has to have read and write rights on this folder.

By default, XFDF annotations are saved in a folder named ARenderAnnotations/ created in the home folder of the user that launch the application server.

Warning
On Windows, if the application server is launched as a service (without any user configured), the folder will be created in C:\Windows\System32\config\systemprofile.

To configure a specific folder,

  • Either modify server properties in arender-server-custom-<…>.properties and add the property arender.server.annotations.xfdf.localstorage.default.path with the wanted value.
  • Either create a system property named arender.annotation.xfdf.localstorage.default.path and set its value with the needed folder path.

Style sheet: ARender-mat.css

Most of the ARender graphical components can be configured in the style sheet. Consult the file for more details.

Note
This stylesheet is related to default user profile. See the Configuration guide for more information.