Install FileMasker Software
Installing the FileMasker data masking software is very simple and the steps are outlined below.
Note: You can install a later version of the FileMasker software side-by-side with an earlier version; however, only one instance of the GUI can be running at any given time because the GUI software shall attempt to use the same work area cache. Multiple command-line executions can be run concurrently because these do not rely on the same GUI work area. Please do not run more concurrent copies than specified in your license. Please see the Licensing section for details.
FileMasker requires that Java 8 or later JDK is installed.
Note: Java JRE is not adequate, you must install the JDK.
Step 1: Unzip the downloaded FileMasker software ZIP file
The FileMasker software is delivered in a ZIP file that has the version number appended to it. E.g. "filemasker_1_0_0.zip" is the software for FileMasker version 1.0.0.
You can use an 'Unzip Here' type command to unzip because the contents of the zip are all in a parent folder called "filemasker".
Therefore, after unzipping you should see something like:
Note: Avoid unzipping to any Windows system folders, such as Program Files, because you may get security errors while running the software such as when FileMasker attempts to create reports or log files in its default location (installed folder).
The contents of the "filemasker" folder are:
Step 2: Set permissions (Linux / Unix)
On Linux / Unix systems you shall also need to grant 'execute' permissions to some files as shown below:
chmod +x bin/filemasker
chmod +x demo/cmd_nix
Step 3: Create a shortcut to the GUI executable (optional)
On Windows platforms, the executable file to start the GUI in 64 bit Java environments is bin/filemasker64.exe. For 32 bit Java environment it is bin/filemasker.exe.
On Linux/Unix platforms, the executable script is bin/filemasker.
Therefore, it may be convenient to create a shortcut to the relevant executable.
If you later upgrade the software (i.e. just download an unzip to a new folder) then please remember to update the shortcut to refer to the executable in the new folder.
This concludes the installation of FileMasker.
To run FileMasker from the GUI, command-line or as an AWS Lambda please refer to the Executing Projects section.
Moving the Installed Directory
If you later decide to move the directory where you installed (unzipped) the software and from where you have been running FileMasker then you should also delete Filemasker's user directory. This is where FileMasker stores runtime settings and its GUI cache.
If you don't delete this folder after moving the installed directory then the GUI shall likely continue to work normally but you may get an exception message saying that some files could not be found.
Therefore, if you do move the installed directory then it is recommended to delete the FileMasker User directory. The location is shown in the Help->About dialog. It is safe to delete this directory. Whenever FileMasker starts, if the directory is not found then a new one shall automatically be created and initialized.