This task describes the File-AID/EX installation setup types and provides installation procedures for File-AID/EX on Linux.

Task 2.1 Install File-AID/EX components

This subtask describes the steps required to install the File-AID/EX components on Linux, including the execution server and the File-AID Rules Engine (FARE).

To install File-AID/EX (including the execution server and Rules Engine)

1. Log on to the UNIX or Linux workstation as a user ID that has the authority to read from the device where the File-AID/EX installation image is mounted and that has the authority to create the directory where File-AID/EX is to be installed.
2. Create an installation media mount point directory, if one does not already exist.

3. Insert the installation media containing the File-AID/EX software in the appropriate drive and mount the media device.Refer to the following example, where <media_dev_name> is the device name and <media_mount_point> is the mount point of the device:

   – Red Hat Linux

   Informationmount <media_dev_name>where <media_dev_name> matches the device or mount point of the device in the /etc/fstab file. Typically, the <media_dev_name> is /dev/cdrom

4. Navigate to the installation directory.

   Information<mount_point>/FileAID_EX_Installer/FG/cpwr/FAEX_Unix/platform/install/– For Red Hat Linux: Install from FAEX_Linux directory

5. Make sure the copied files are executable by issuing the command (where <directory> is the directory in the step 4:
   chmod -R 777 <directory>.
6. Execute ./faexinst.ins. The Welcome to the Installation for File-AID/EX Server dialog box appears.
7. Press Enter. The default pathname message appears.
8. Type y to accept the default or type n to specify a different path. Press Enter. The copyright message appears, and a prompt to accept the terms appears.
9. Type y and press Enter. The Java command prompt appears.
10. Do one of the following:
    • Press Enter to accept the default Java location.
    • Type the fully qualified path of the Java command and press Enter.
11. Type y to install the selected components in the default directory, and press Enter. The default installation directory path appears.
12. Do one of the following:
    
    • Type y and press Enter to accept the default path.

    • Type the full installation path and directory and press Enter.

      Space is validated and then the current settings message appears.

13. Type y to continue with the installation and press Enter.
14. When the installation completes, a prompt appears asking to view the readme file. Type y or n and press Enter.

The File-AID/EX UNIX components are now installed.

Task 2.2 Install File-AID Rules Engine (FARE) for File-AID Execution Server on Linux

1. Run setup.exe on File-AID Services media image downloaded from an electronic distribution order. 

   Success

   Tip

   The current version of the specific Unix FAREs is also available as a download from the Fixes and Downloads section of the Workbench for Eclipseproduct page on the BMC Support. You must synchronize the version of the FARE with the version of the Workbench for Eclipse client, Data Studio’s Data Privacy plug-in, and File-AID Services (FAS).

2. Select the File-AID Rules Engine tab in the media browser and click the link corresponding to your UNIX platform, which opens the folder containing the installation files.
3. Use an FTP tool (for example, WinSCP or PuTTY) to transfer the FARE installer files to the directory of your choice on the UNIX machine.
4. In the UNIX machine, locate the directory path to a current Java Virtual Machine (JVM). The File-AID Rules Engine requires a minimum of Java version 11 or later (For example, ~/usr/compilers/java/java11). For validation purposes, execute the shell command: [JVM Install directory]/bin/java -version. For example: /usr/lpp/java/java11/bin/java -version).
5. Execute the installer by issuing the shell command: sh installfare.bin
6. When prompted, provide the directory path to the current Java Virtual Machine (JVM) you located as part of Step 4.

7. Choose FAEX and provide the path to an existing location of File-AID/EX Execution Server (FAEX install folder that contains the dme folder), or choose a separate folder to install the FARE into a user-chosen folder to be used with Data Privacy APIs. This folder should have at least 150MB of free space. 

   Success

   Tip

   The target directory must not be the same directory where you uploaded installfare.bin.

8. If a notification appears indicating that JAR files have been found, enter 1 for OK and press Enter to continue the install.
9. Press Enter again to exit the installer.