Page tree
Skip to end of metadata
Go to start of metadata

Introduction

FusionReactor can be added to your Docker image with only a minor change to your Dockerfile. We also provide a series of Java Arguments to automatically configure FusionReactor.

Adding FusionReactor to Docker

Adding FusionReactor to docker is done through your Dockerfile, in our github we have a series of examples for adding FusionReactor to Tomcat, Jetty and Lucee images.

You can find these examples at  FusionReactor Docker Examples . These examples can be downloaded and modified as required.

Configuring FusionReactor

Copying an existing configuration

If you have an existing instance and would like to keep the configuration, you can place a copy of the reactor.conf file from this instance and place it in the conf directory of your new FusionReactor instance.

When moving the reactor.conf file you MUST remove the lines beginning with FRUID and GRUID from the file, as this is a unique identifier for the instance so cannot be cloned.

Java Arguments to configure FusionReactor

You can specify a number of Java arguments to configure your license key, Enterprise Dashboard or Cloud Groups. Here is a full list of available arguments:

Please note that these options should be added in the JVM configuration file of the application server you are using and these should be prefixed with -D e.g -Dfrshutdownaction=stop.

Enterprise Dashboard

 Property Name

Default Value

Values Accepted

Description

 frregisterwithnone - disabledURL to FR instance

If present, FusionReactor will attempt to register with the remote instance. The supplied URL should be in the following format; http://username:password@hostname:port/ and the default URL for FusionReactor is http://restuser@127.0.0.1:8088/fusionreactor.cfm

frshutdownactionnone - disabledremove, stop

If this and the "frregisterwith" property is present, FusionReactor will attempt to un-register itself from the specified target using either the remove or stop command.

  • Remove: will remove the instance from the remote server Enterprise Dashboard.

  • Stop: will toggle the server to not monitored (offline) but will remain in the remote Enterprise Dashboard.
frregisterhostnamenone - retrieved from environment

{AWS}

or

any host name/ip address

or

port number

This System Property is used when registering with remote servers. When using the register with key, the server will be registered using this as the host name on the remote server.
frregistergroupnone - disabledcomma-separated list of Strings

This value is used in conjunction with the previous 3 REST commands. This property will allow you to also specify ED groups for your server on start-up/shutdown.

If frshutdownaction is 'remove', groups will remain present on ED. In order to prevent any existing servers from losing their groups.

fradminpasswordnone - disabledanyThis sets the initial administrator password for the FusionReactor instance on this server.

Licensing Properties

 Property Name

Default Value

Values Accepted

Description

frlicenseservice.deactivateOnShutdownnonetrue, falseIf present and the value is set to true, then the instance will deactivate its license on shutdown.
frlicensenone

string

If present, sets the license key of the instance.
frlicenseservice.leasetime.hintnoneintegerIf present, sets the license lease time to x minutes (10 minutes is the shortest possible value). This means that if after x minutes the license is not renewed the instance will become inactive, freeing up a server seat on your license

Cloud Properties

 Property Name

Default Value

Values Accepted

Description

fr.cloud.group(none)comma separated string (group1,group2...)Sends an array of group names within the connect message. The server will then be automatically added to the defined groups.


More information about the System Properties can be found in the following link, System Configuration Keys and Automatically configuring FusionReactor for use in a dynamic environment

  • No labels