Task 1: To install File-AID Services (FAS)

File-AID Services (FAS) can be installed in either Windows or Linux.

The File-AID Services Configuration Utility, provided with FAS, allows you to do the following:

• Override the default port assignments.
• Install additional database drivers in the event that you did not select a database type during the initial installation but now find the need to configure a database.
• Configure the FAS license.

1.1 Installing FAS on Windows 

1. Select a machine to run FAS, and ensure the following considerations::
   • Number of Data Privacy users
   • Whether the machine has sufficient capacity in terms of CPU cycles, processor speed, and disk space. In general, Data Privacy has minimal CPU requirements, but it does require about 1 GB of disk space to contain FAS software and the default Derby databases. See Verifying prerequisites for more information.
   • Whether there are conflicts with the ports on the selected machine. FAS communicates over the network using the default open TCP ports 3081, 4082, 4180, and 5180. If needed, you can override the default ports after installation.
2.  Log in as the administrator to the selected server.

3. Insert or locate the Data Studio media or the electronic download of FAS installation files from BMC Support. Run setup.exe from the media. The media browser appears.

   Tip

   FAS communicates over the network using the following default open TCP ports: 3081, 4082, 4180, and 5810.

   File-AID/EX communication manager communicates over the network using the default open TCP port: 4901.
   

   Make sure that there are no conflicts with these port on the selected machine. If needed you can override the default ports after installation. In addition, when installing FAS, you should be logged in as the administrator for the selected servers.
   

4. Perform one of the following:
   • When installing from the distribution media, select Install File-AID Services for Windows. The InstallAnywhere dialog box appears.

   • If installing FAS using the install files downloaded from BMC Support, unzip the self-extracting ZIP file to a directory of your choice. Open the extracted Windows subfolder and run update.bat. The InstallAnywhere dialog box appears.

5. Read the introductory text and click Next.
6. Read the license agreement and select I accept the terms of the License Agreement. Click Next.
7. Choose a destination folder to install FAS or accept the default value
   
   C:\Program Files\BMC\File-AID Services
   
   Click Next. Installation setup information appears.

8. Select the databases with which you intend to work.

   Warning

   Check all database types that you might access at your site. For each item that you select, the installation process automatically installs the appropriate JDBC driver. However, for DB2, you are responsible for providing the location of the folder containing the driver (db2jcc4.jar) and the corresponding appropriate licenses for accessing DB2 for LUW and z/OS.

   Tip

   If you do not choose a database type at installation and later wish to configure a connection to that type of database, use the Server Configuration utility as described in Task 5: To control FAS.

9. If you select Oracle, you will be prompted to accept the Oracle license agreement. Confirm the setup information and click Install.
10. After the installation, click Done to dismiss the InstallAnywhere dialog box. FAS begins running using port 3081 for secured access, port 4180 for standard http access, and port 5180 for File-AID/Data Solutions interface. If you need to change the default FAS ports for any reason, see Task 5: To control FAS.
11. Validate that the services are running by using a web browser to view the URL: http://hostname:4180/versions where hostname is either localhost or the machine name; or the IP address where the services are installed. The resulting web page should display a list of executing bundles.

1.2 Installing FAS on Linux 

Follow these steps to install FAS to a Linux server. We recommend that you install FAS in linux under the authority of superuser.

1. Download and extract the Linux File-AID Services install files from BMC Support. Copy the Disk1 folder in the Linux subfolder or the File-AID media directory cpwr\FAS\Linux to the Linux server or a directory that is mounted on the Linux server.

2. At the command prompt type which java to get the location of Java on the Linux server. Use OpenJDK v11.
3. Set the JAVA_HOME environment variable (export JAVA_HOME=<location of Java>).
4. Add the JAVA_HOME/bin directory to the PATH environment variable (export PATH=$JAVA_HOME/bin:$PATH).
5. Navigate to the directory Disk1/InstData/NoVM under the directory where the contents were copied to in step 1.
6. Change the file install.bin to be executable (chmod 777 install.bin).
7. Before starting the installation, if you intend to do data privacy on IBM DB2, locate the path for the file db2jcc4.jar.
8. Run the installation (./install.bin).
9. After the install starts follow the prompts:
   1. Read the License Agreement and respond. Accept the agreement to continue with the installation. (If you do not accept the license the install stops.)
   2. Enter a path in which to install or press Enter to accept the default directory as shown (in either case, you must have write access to the chosen path).
   3. Confirm that the path entered is correct.
   4. Select the databases that you intend to disguise using data privacy. (Use the numbers to the left of the database. Multiple databases can be selected by separating them with commas.)
   5. If IBM Db2 was selected, enter the path to the folder containing the db2jcc4.jar DB2 driver and the appropriate corresponding license files for DB2 UDB on LUW and/or z/OS.
   6. If Oracle was selected, read and accept the license.
   7. Review the install directory and press Enter to start the actual installation of the product.

10. When done, validate that the service is running by using a web browser and going to this URL: http://[hostname]:4180/versions where hostname is the IP address or DNS name of the Linux machine on which the server was installed. The resulting web page should display a list of executing bundles.

    Tip

    An alternate way to validate whether the service is running is to launch C:\Users\USERID\BMC\Workbench and click Test Connection in the Server Preference dialog box.