Datasert - Setup - Realfire Help

In this page we will go through how to download and install Realfire app.

Realfire is a Java based desktop application which, requires Jdk (Java Development Kit) v11.

We recommend Amazon Corretto Jdk because of the following reasons.

It is a well supported JDK distribution
It is completely FREE without any licensing cost
Our team uses that JDK to develop and test Realfire

We are here to help

We understand that setup process can be daunting, especially if you are not familiar similar process in other applications.

We are here to help. If you are running into issues or just need help in setting up the application, please get in touch with us at support@datasert.com. We will do our best to get you through to using the app.

Installation (Mac)

Install JDK

Download the JDK v11 for Mac and save it to Downloads folder.
Goto Downloads folder and click on the amazon-corretto-11-x64-macos-jdk.pkg file and follow the prompts.

After successful installation, you should be able to execute the following command in Terminal and see that it prints Java version.

$ java -version
openjdk version "11.0.5" 2019-10-15 LTS
OpenJDK Runtime Environment Corretto-11.0.5.10.2 (build 11.0.5+10-LTS)
OpenJDK 64-Bit Server VM Corretto-11.0.5.10.2 (build 11.0.5+10-LTS, mixed mode)

Install Realfire

Goto Realfire Website, click on the Mac 64 bit link and save the file to Downloads folder.
Click on the realfire-{version}.dmg file
It should prompt with following screen
Drag the Realfire.app from left side to Applications folder.

If it prompts you to overwrite an existing copy of application, choose Replace.
Goto Applications folder (you can double-click on the folder in above dialog), select Realfire.app, right-click and select Open
If Mac prompts with the following dialog, click Open
If all goes well, Realfire application should be starting now.
Delete the downloaded Realfire installation file from Downloads folder to clean up some space

Installation (Windows)

Install JDK

Download the JDK v11 for Windows and save it to Downloads folder.
Goto Downloads folder and click on the amazon-corretto-11-x64-windows-jdk.msi file and follow the prompts.

After successful installation, you should be able to execute the following command in Cmd prompt and see that it prints correct Java version.

C:\ java -version
openjdk version "11.0.5" 2019-10-15 LTS
OpenJDK Runtime Environment Corretto-11.0.5.10.2 (build 11.0.5+10-LTS)
OpenJDK 64-Bit Server VM Corretto-11.0.5.10.2 (build 11.0.5+10-LTS, mixed mode)

Install Realfire

Goto Realfire Website, click on the Windows 64 bit link and save the file to Downloads folder.
Unzip the file realfire-{version}-windows.x86_64.zip which should create a folder named Realfire
Move Realfire folder to C:\Users\{yourusername}\Applications (if Applications folder doesn’t exist, create it)
Execute C:\Users\{yourusername}\Applications\Realfire\realfire.exe
When you run the application for first time, Windows might show a warning message. If so, click on Run Anyway button
If all goes well, Realfire application should be starting now.
Delete the downloaded Realfire installation file from Downloads folder to clean up some space

Installation (Linux)

Install JDK

Download the JDK v11 for Linux and save it to Downloads folder.
Goto Downloads folder and unzip amazon-corretto-11-x64-linux-jdk.tar.gz file, execute the executable and follow the prompts.

After successful installation, you should be able to execute the following command in Terminal prompt and see that it prints the correct Java version.

C:\ java -version
openjdk version "11.0.5" 2019-10-15 LTS
OpenJDK Runtime Environment Corretto-11.0.5.10.2 (build 11.0.5+10-LTS)
OpenJDK 64-Bit Server VM Corretto-11.0.5.10.2 (build 11.0.5+10-LTS, mixed mode)

Install Realfire

Goto Realfire Website, click on the Linux 64 bit link and save the file to Downloads folder.
Unzip the file realforce-{version}-linux.x86_64.tar.gz which should create a folder named Realfire
Move Realfire folder to {user home}/Applications (if Applications folder doesn’t exist, create it)
Run the realfire from witin the Realfire folder
If all goes well, Realfire application should be starting now.
Delete the downloaded Realfire installation file from Downloads folder to clean up some space

Manually Set Max Memory

Many times Realfire deals with huge files (either to read, analyze export) which demands lots of memory size. While most of the times, you don’t need to manually set memory but sometimes you need to based on the tasks at hand. This section walks through how to set the memory manually.

By default, Realfire allocates itself the good amount of memory depending on the physical memory available in the machine. For ex., one of our test machine has 16gb memory and in that, Realfire allocated itself about 4gb.

You can check the maximum memory configuration used by Realfire using the Memory Meter. This is a widget that is shown at the bottom of the application window. If you hover your mouse and hold above the area for a couple of seconds, the tooltip popsup and shows the details.

For ex., in the screenshot below, the maximum memory assigned to Realfire is 4096M, which is about 4GB.

heap meter

To Manually set the memory, follow the below steps.

Quit Realfire Application
Open the realfire.ini file in a text editor. This file is located in the application installation folder as below.
- Mac: {InstallationFolder}/Realfire.app/Contents/Eclipse/realfire.ini
- Widnows: {InstallationFolder}/Realfire/realfire.ini
- Linux: {InstallationFolder}/Realfire/realfire.ini
InstallationFolder varies from system to system depending on where the application was installed.
Add the line -Xmx1024m to below the line -vmargs. Change the value 1024 to a number indicating the number of MBs of memory to assign. For ex., if you want to assign 8GB change that to 8192.

After changing the file should look like below.
Restart the app and check the Memory Meter. It should show the new max memory.