FileCatalyst Request Strings and Licensing the Applications
Posted by Jeyram Sachchithananthan, Last modified by Jeyram Sachchithananthan on 10 August 2021 04:12 PM

Overview
The FileCatalyst request string is generated during the installation of the FileCatalyst applications. The FileCatalyst request string is unique to individual hardware, and any alteration to the string nor moving the license to another system will invalidate your license. Once you successfully generated and collect the request string, please get in touch with your FileCatalyst Sales Executive or our Customer Operations team, and provide the request string to get a valid license key for the application.


Environment

FileCatalyst Server v3.7.3 Build 18 and Higher
FileCatalyst Central v3.7.3 Build 18 and Higher

FileCatalyst Reverse Proxy v3.7.3 Build 18 and Higher

Resolution

FileCatalyst Server 
After a successful installation of the FileCatalyst Server, please follow the steps listed below to extract your request string:

Windows:

  1. Launch the FileCatalyst Server in standalone mode by running the FCServer.exe executable from the installation folder.
  2. When the activation pop-up is displayed, copy the request string to your clipboard by selecting the copy button.

Linux:

  1. Connect to the FileCatalyst Server using PuTTY or a Terminal program as root or a user with root privileges
  2. Change your working directory to the FileCatalyst Server installation folder.
    Example: cd /opt/utechsoft/server 
  3. Execute the following script to retrieve the request string as well as start the FileCatalyst Server as a standalone instance
    ./fc_server_console.sh
  4. During the above script execution, the request string will be displayed:


  5. Shutdown the application (./fc_server_shutdown.sh),
    Edit fcconf.conf to enter the provided license key to activate your FileCatalyst Server.

FileCatalyst Central
After a successful installation of the FileCatalyst Central, please follow the steps listed below to extract your request string:

  1. Start the FileCatalyst Central service if it is not already started.
  2. Using a web browser to access the FileCatalyst Central web portal by navigating to the  Local IP using port 8080 (http://127.0.0.1:8080)
  3. The First time wizard would prompt to apply a License to activate Central, and the request string will also be displayed:

  4. Enter and apply the provided license key to activate your FileCatalyst Central.

FileCatalyst Reverse Proxy
After a successful installation of the FileCatalyst Reverse Proxy, please follow the steps listed below to extract your request string:

Windows:

  1. Open an Administrator Command Prompt window and navigate to the install directory.
  2. Run the following command to generate the request string for the machine.
    "jre\bin\java" -jar FileCatalystProxy.jar -requestString
  3. Once your license key has been acquired, run the following command:
    "jre\bin\java" -jar FileCatalystProxy.jar -setLicense ${license.key}
    Note: ${license.key} represents the license key that was supplied.
    Example: "jre\bin\java" -jar FileCatalystProxy.jar -setLicense EXAMPLE1DD712KW453DE2MNC18A000000000000AC9934084C25EF9F


Linux: 

  1.  In a terminal window, navigate to the Install directory and enter the following command to get the request string
    ./fc_proxy_console.sh -requestString
  2. Once your license key has been acquired, enter the following command to register your license key
    ./fc_proxy_console.sh -setLicense {your.license.key}
    Example: ./fc_proxy_console.sh -setLicense EXAMPLEE99712KY03A5459CE2IQ00000000000047F441D1D4C27C77


FileCatalyst HotFolder
FileCatalyst HotFolder does not require a license key to run, but certain advanced features require a license key.

Allowed clients/features via license are :

- HF Alarms
- HF Remote Admin 
- HF Session Reports
- Connect to 3PP Server

 Please follow the steps listed below to License your FileCatalyst HotFolder applications:

  1. Launch the FileCatalyst HotFolder as standalone or Service ( Procedure is same for all the Operating Systems )
  2. Select the left menu Settings -> Select the License tab from the right panel 
  3. Enter and apply the provided license key to activate your FileCatalyst HotFolder advanced features.



Comments (0)