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

Introduction

FusionReactor can be configured to be used in a dynamic (containerized) environment. We provide a series of Java Arguments to automatically configure FusionReactor.

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.

Instance

Property Name

Default Value

Values Accepted

Since

Description

fradminpassword

none - disabledany5.0.0This sets the initial administrator password for FusionReactor on this server (this can be changed in FusionReactor once it is running)

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.

We recommend using "remove" in a very dynamic environment, otherwise the Dashboard would quickly fill up with offline servers.

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.

Enterprise Dashboard Examples with Tomcat

ED_OPTS="$ED_OPTS -Dfrregisterwith=http://username:password@192.168.0.1:8090/fusionreactor/"
ED_OPTS="$ED_OPTS -Dfrshutdownaction=remove"
ED_OPTS="$ED_OPTS -Dfrshutdownaction=stop"
ED_OPTS="$ED_OPTS-Dfrregisterhostname=172.20.0.1:8088"
ED_OPTS="$ED_OPTS -Dfrregistergroup=group1,group2"

Licensing Properties

 Property Name

Default Value

Values Accepted

Description

frlicensenone

string

If present, sets the license key of the instance.


Licensing Properties Examples with Tomcat

LICENSE_OPTS="$LICENSE_OPTS -Dfrlicense=XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"

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.


Cloud Properties Example with Tomcat

CLOUD_OPTS="CLOUD_OPTS -Dfr.cloud.group=group1,group2"


More information about the System Properties can be found in the following link, System Configuration Keys.

  • No labels