How to configure FusionReactor system properties

FusionReactor has a number of system properties that can be set to configure FusionReactor.

These arguments should be added to your JVM configuration.

To see examples of configuring JVM arguments in various application servers see Manual Configuration Examples.

Note

The options below should be prefixed with '-D', for example:

-Dfrlicense=XXXXX-XXXXX-XXXXX-XXXXX-XXXXX.

Instance

Property	Default value	Values accepted	Version added	Description
fradminpassword	none	password value	5.0.0	This value is going to contain the password that is used for the FusionReactor instance that is running.
frmanagerpassword	none	password value	10.0.0	This value is going to contain the password that is used for the manager role. Enables the role.
frobserverpassword	none	password value	10.0.0	This value is going to contain the password that is used for the observer role. Enables the role.
frhomepage	none	page ID	10.0.0	Sets the homepage for all roles. The page ID is the value of the p query parameter e.g. about in http://localhost:8087/fusionreactor/findex.htm?p=about
frlicense	none	license key	5.0.0	If present, this argument allows you to specify your license key. This argument gives you the ability to apply your license key without log in to the instance and enter it.
fr.license.http.fallback	true	true false	8.0.0	If true and HTTPS license activation fails the code will fallback to HTTP. Set to false to prevent this fallback.

Enterprise Dashboard

The following properties should be added to the instance hosting the Enterprise Dashboard

Property	Default Value	Values Accepted	Version Added	Description
fr.ed.ds.enable	false	true/false	8.1.0	This value allows an instance to accept registration of ephemeral instances to the Enterprise Dashboard
fr.ed.ds.listen	0.0.0.0:2106	hostname:port	8.1.0	Specifies the listening IP address and port on the server
fr.ed.ds.polltimeout	1000	Integer (ms)	8.1.0	Specifies the time EDS will wait after attempting to poll data from the client before marking the client as offline
fr.ed.ds.maxdatasize	20	Integer (MB)	8.2.2	The maximum size of a page or other data transfer that will be accepted over the tunnel

The following properties should be added to the instance connecting to the Enterprise Dashboard

Property	Default Value	Values Accepted	Version Added	Description
fr.ed.ds.target	none	hostname:port	8.1.0	If specified, causes the instance to attempt to auto-register with the EDS system at the specified address
fr.ed.ds.groups	none	Comma-separated list	8.1.0	If specified, causes the instance to request to be a member of the listed groups. If not specified, the server will be placed within the Ungrouped Servers

Decompilation

Property	Default value	Values accepted	Version added	Description
fr.decompile.external.enabled	false	true/false	6.0.0	This enables or disables the decompilation when requests come in over the external J2EE connection.
fr.decompile.show.line.numbers	false	true/false	6.0.0	This setting enables the procyon line number as comments inside the decompile output. This is very good to track down line number issues in decompiled code.

FusionReactor logging

Property	Default value	Values accepted	Version added	Description
fr.observability.log.enabled	true	true/false	9.0.0	This setting enables or disables logs shipping.

FusionReactor Cloud

Property	Default value	Values accepted	Version added	Description
fr.cloud.group	none	Comma-separated list	6.1.0	Sends an array of group names within the connect message, the server will then be added to the following groups.

Data obfuscation

Property	Default value	Values accepted	Version added	Description
fr.request.obfuscate.parameters	false	true/false	6.2.6	This setting will enable data obfuscation, which will obfuscate transaction data that is displayed to the screen.

Support chat

Property	Default value	Values accepted	Version added	Description
fr.chat.enabled	true	true/false	8.7.2	This enables/disables the loading of the support chat. Setting this to false stops the loading of the 3rd-party support chat service into FusionReactor.

JMS/MDB tracking

Property	Default value	Values accepted	Version added	Description
fr.pointcut.jms.packages	org/apache/activemq/	comma-separated list of package prefixes with / replacing .	10.0.0	List of package prefixes to enable JMS tracking within those packages. Accepts all to enable tracking within all packages.
fr.observability.trace.jms.jakarta	false	true/false	10.0.0	If true, uses the jakarta.jms libraries. Uses javax.jms otherwise.
fr.observability.trace.jms.extra_attributes.enabled	true	true/false	10.0.0	If enabled, attempts to set the messageId and conversationId.

Plugins

Property	Default value	Values accepted	Version added	Description
fr.plugin.reports.notifications.email.disabled	false	true/false	10.0.0	If true, forces the email notifications to be disabled in the reporting plugin

ColdFusion Metrics

Warning

Enabling these ColdFusion metrics for ColdFusion (2018 and later) may incur performance issues and be unsafe. User issues reported include memory leaks and server slowdown.

💡 Tip: We recommend testing in a staging environment before deploying these changes to production.

Property	Default value	Values accepted	Version added	Description
fr.coldfusion.monitor.request.enabled	false	true/false	9.2.2	Enables monitoring request hitcounts and some request metrics. Disabled if PMT is active. Overrides config value on startup.
fr.coldfusion.monitor.memory.enabled	false	true/false	9.2.2	Enables memory monitoring for scopes size. Overrides config value on startup.
fr.coldfusion.monitor.query.enabled	false	true/false	9.2.2	Enables monitoring cached queries in CF metrics for CF 2021. Overrides config value on startup. May cause error when Redis is used as the cache.
fr.coldfusion.monitor.query.app.enabled	false	true/false	9.2.2	Enables monitoring cached queries per app/server. Requires -Dfr.coldfusion.monitor.query.enabled=true also. Overrides config value on startup.

---

Need more help?

Contact support in the chat bubble and let us know how we can assist.