Task 2.1 Install File-AID Services (FAS)

File-AID Services (FAS) can be installed to 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 you did not select a database type during the initial installation but now find the need to configure a database.
• Configure the FAS license.

Task 2.1.1 Install File-AID Services (FAS) on Windows 

1. Select a machine to run FAS, being sure to consider the following:
   • The 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 System and Hardware Requirements 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 Topaz Enterprise Data media or the electronic download of FAS installation files from Compuware Support Center. Run setup.exe from the media. The media browser appears.

   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 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. Do 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 Compuware Support Center, 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 the I accept the terms of the License Agreement button. Click Next.
7. Choose a destination folder to install FAS or accept the default value
   
   C:\Program Files\Compuware\File-AID Services
   Click Next. Installation setup information is displayed.

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

   Check all database types that you might access at your site. For each item 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/or z/OS.

   If you do not choose a database type at install time and later wish to configure a connection to that type of database, you will need to use the Server Configuration utility as described in Control FAS.

9.  If you select Oracle, you will be prompted to accept the Oracle license agreement.
10. Confirm the setup information and click Install.
11. Once installed, click Done to dismiss the InstallAnywhere dialog box. FAS begins running using port 3081 for secure Topaz Workbench client access, port 4180 for Data Privacy execution, and port 5180 for File-AID/Data Solutions interface. If you need to change the default FAS ports for any reason, see Control FAS.
12. 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 with a list of executing bundles.

Task 2.1.2 Install File-AID Services (FAS) on Linux 

Follow these steps to install FAS to a Linux server. It is highly recommended that installation of FAS in Linux be done under the authority of superuser.

1. Copy the Disk1 folder of either the Linux subfolder from the downloaded extracted Linux File-AID Services install files from the Compuware Support Center 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. OpenJDK v11 must be used.
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. Once 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 will stop.)
   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 where the server was installed. The resulting web page should display a list of executing bundles.