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 without changing configuration. Also removes the Set Home Page button. 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.