FireDaemon Fusion 7 OEM Installation and Configuration

FireDaemon Fusion OEM (FFO) is a variant of FireDaemon Fusion specifically designed for use by systems integrators or value-added resellers who wish to bundle FireDaemon Fusion with their product or platform.  FFO is designed to be included in third-party installers or used in conjunction with scripts. FFO is a super-set of FireDaemon Fusion. The key difference is that no Serial Number Name or Serial Number is required for installation


FireDaemon Fusion OEM (FDO) is a variant of FireDaemon Fusion specifically designed for use by systems integrators or value-added resellers who wish to bundle FireDaemon Fusion with their product or platform. FFO is designed to be included in third-party installers or used in conjunction with scripts. FFO is a super-set of FireDaemon Fusion. The fundamental difference is that no Serial Number Name or Serial Number is required to activate the software production.


TABLE OF CONTENTS

Distribution ZIP File

FFO is distributed as a ZIP file only. It does not include an installer. The ZIP file contains 64-bit EXEs and DLLs, configuration files and web page content (HTML, images, Javascript files etc.). The top-level contents of the ZIP file are below.


FireDaemon Fusion OEM ZIP file contents


Installation Fast Track

You would typically automate this process.


Step 1: Patch Windows

Ensure that Microsoft Windows is fully patched. All Windows updates should be applied including root certificates. 

Step 2: Deploy Binaries

  • Log in to the computer as a local or domain administrator
  • Unpack the FireDaemon Fusion OEM ZIP file to a temporary folder
  • Create a target installation folder (e.g. C:\Program Files\FireDaemon Fusion OEM)
  • Copy the binaries contained within the x64 folder to the installation folder
  • Copy the folders contained within the common to the installation folder


The target installation folder (C:\Program Files\FireDaemon Fusion OEM) should now be as follows:


FireDaemon Fusion OEM target installation folder contents


Step 3: Configure and run FFO

Open an elevated command prompt and type the following.

:: Change directory to the installation folder
cd /d "C:\Program Files\FireDaemon Fusion OEM"
:: Complete the initial product configuration
fusioncli configure
:: Replace <password> below with a strong password for the user: admin
fusioncli password admin <password>
:: Create and start the FireDaemon Fusion OEM service
fusioncli service create_start

FFO should now be able to point your browser at https://localhost:20604 running and ready for login.

Note: If FFO is installed on a system that has both FireDaemon Pro and FireDaemon Pro OEM services  installed, then FFO will only enumerate and display the FireDaemon Pro OEM services. 

Installing FFO Alongside Other Versions of FireDaemon Fusion

To avoid conflicts with current or future FireDaemon Fusion installations, FFO should never be installed on the same system as the retail version of FireDaemon Fusion.


FFO Command-Line Options

The FFO command-line installation options can be used to customise your FFO installation. Here is an example:

"C:\Program Files\FireDaemon Fusion OEM\fusioncli.exe" configure --product-name "FireDaemon Fusion OEM" --product-short-name "Fusion"

The fusioncli.exe command-line options are case-sensitive and are described below:


OptionDescription
configure [--product-name "name"] [--product-short-name "short"]Instructs FFO to set up the product registry keys.

The following optional parameters are available:
  • --product-name  This is the full name of the product. If not set, it will default to "FireDaemon Fusion OEM". This string is displayed in the title bar of the main GUI window and various other places, including the command line and logs.
  • --product-short-name  This is an abbreviated name of the product. If not set, it will default to "Fusion". This string is displayed in various messages and dialog boxes.
control <start|stop|restart>Performs a control action on the FFO service.

The following control actions are available:
  • start Starts the FireDaemon Fusion OEM service.
  • stop Stops the FireDaemon Fusion OEM service.
  • restart Stops and then start the FireDaemon Fusion OEM service.
deconfigureRemoves all FFO product registry entries.

Note: Before using this option, the FireDaemon Fusion OEM service must be stopped and uninstalled.
-?
-h
--help
Displays the command-line help options.
help [subcommand ...]Displays the help message for one or more subcommands.
license [print]Displays the registered licensee details.
service <create|delete|create_start|stop_delete>Performs an action on the FFO service.

The following actions are available:
  • create Creates the FFO service on the system.
  • delete Removes the FFO service from the system.
  • create_start Creates and immediately starts the FFO service
  • stop_delete Stops and then removes the FFO service from the system.
-v
--version
Displays the version details of the FireDaemon Fusion program.
password <user> <password>Creates or resets the password for a specific FFO user.


FFO Registry Keys

When deploying FFO, the following registry keys will be created. These registry keys are created automatically by FFO and should not be created manually.


Product Registry Keys

HKLM\SOFTWARE\FireDaemon Technologies\FireDaemon Fusion OEM
Key Name
Type
Value
InitiallyConfiguredREG_SZTimestamp when the product was initially configured
InstallationDirREG_SZC:\Program Files\FireDaemon Fusion OEM
LastConfiguredREG_SZTimestamp when the product was last configured or reconfigured
ProductNameREG_SZFireDaemon Fusion OEM
ProductShortNameREG_SZFusion


Service Registry Keys

HKLM\SYSTEM\CurrentControlSet\Services\FireDaemon Fusion OEM
Key Name
Type
Value
DelayedAutoStartREG_DWORD0
DescriptionREG_SZAllows managing FireDaemon Pro and Windows Services from your browser.
DisplayNameREG_SZFireDaemon Fusion OEM
ErrorControlREG_DWORD1
ImagePathREG_EXPAND_SZ"C:\Program Files\FireDaemon Fusion OEM\FireDaemonFusion.exe"
ObjectNameREG_SZLocalSystem
ServiceSidTypeREG_DWORD1
StartREG_DWORD2 (Automatic)
TypeREG_DWORD16 (0x10)


Uninstalling FFO

To fully uninstall FFO, open an elevated command prompt and run the following commands:

cd /d "C:\Program Files\FireDaemon Fusion OEM"
fusioncli service stop_delete
fusioncli deconfigure
cd ..
rmdir /s /q "FireDaemon Fusion OEM"

Theming and Branding FFO

Simple FFO theme and brand changes can, to a limited extent, be achieved through careful modification of the fusion-oem-ui.css file that is stored in the \webapp\sstatic\css\ folder. Settings in this file will override the standard FireDaemon theme and brand settings upon start-up.

Note:  Copyright notices and version numbers cannot be modified or removed, nor can the registry keys or digital signatures of the executables be modified.

What to Redistribute?

The following files should be included in your installer or deployed on your platform. They must all reside in the same folder:


File
Description
FireDaemonFusion.exe
FusionCLI.exe
FusionCLINonAdmin.exe
FFO service and control programs
AdminService.dll
BackendServices.dll
Core.dll
fd-net.dll
FDFusionLicensing.dll
FDService.dll
FileService.dll
InbuiltService.dll
RssService.dll
StatsService.dll
FFO core shared libraries
boost_chrono-vc143-mt-s-x64-1_82.dll
boost_date_time-vc143-mt-s-x64-1_82.dll
boost_filesystem-vc143-mt-s-x64-1_82.dll
boost_iostreams-vc143-mt-s-x64-1_82.dll
boost_locale-vc143-mt-s-x64-1_82.dll
boost_regex-vc143-mt-s-x64-1_82.dll
boost_system-vc143-mt-s-x64-1_82.dll
boost_thread-vc143-mt-s-x64-1_82.dll
libapr-1.dll
libaprutil-1.dll
libcrypto-3-x64.dll
libexpat.dll
libssl-3-x64.dll
libxml2.dll
log4cxx.dll
pion.dll
FFO 64-bit third-party shared libraries
configuration (Folder)FFO configuration files
hard-wired configuration (Folder)FFO configuration files
webapp (Folder)FFO web page content 

License Restrictions

The FireDaemon End User License Agreement allows the licensee to redistribute FFO royalty-free as part of a product or platform. It is prohibited for FFO to be redistributed or sold as a standalone product or to be made available for public download.