Deploying ISR FACE API

The ISR FACE API is deployed the same way as the other ISR components. The ISR FACE API is commonly deployed on an Oracle Linux 7 VM and has the same prerequisites as the other ISR components, described in "Installation Prerequisites".

Installing ISR FACE API

By default, FACE API is configured to handle HTTP requests over SSL, but you must perform the following steps to complete the initial configuration.

Note:

During the installation process, you will be asked to provide and/or verify the users, passwords, and interfaces you created during the Oracle Linux installation.

To install the ISR FACE API:

1. Log into the Oracle Linux CLI using an SSH client.

   Note:

   The Oracle Linux CLI is case-sensitive.
2. Enter the following command into the CLI:

   sudo yum install isr-Face

   Note:

   Most ISR installation environments do not have access to a repository with the RPM required to install the isr-Face RPM itself. The simplest way to manage this issue is to (secure) copy the following file onto the Index host:

   • isr-Face-<release#>.x86_64.rpm

   Once the file is properly copied, connect to the Index host with an SSH client and in the directory (for example, /tmp) containing the file, execute the following command:

   # sudo yum localinstall /tmp/isr-Face-<release#>.x86_64.rpm

3. Verify the installation when prompted.

   Is this ok [y/d/N]:Y

   Oracle Linux downloads the FACE API installation packages.
4. Enter the following command into the CLI once Oracle Linux indicates the installation packages have finished downloading.

   sudo /opt/isr/configIsr.sh

5. Follow the script's instructions closely.

Configuring FACE API Reduced Security

The ISR's FACE API functionality may be run with reduced security. You can use the configIsr.sh script to loosen security settings on the FACE API host.

1. To disable HTTPS in FACE API, run the configCis.sh script and select HTTP for FACE API.

   [root@face ~]# configIsr.sh
   --------------------------------------------
   Please select from the following menu:
   --------------------------------------------
   
   s) Show the current configuration
   m) Modify the current configuration
   i) Add/modify a second network interface
   f) Set FACE default configuration in DB
   q) Quit
   
   Choice: f
   
   WARNING, this action will reset the FACE to its default configuration.
     ** All customization of FACE configured will be lost.
   
   Continue? (yes|no) [yes] yes
   You have been warned.
   
   Enter Face Host IP: [] 1.2.3.4
   Protocol to use for FACE connections? (http|https) [https] http
   
   FACE connection protocol set to http
   Enter ObserveIT Server IP: [] 2.3.4.5
   Protocol to use for ObserveIT Server connections? (http|https) [https]
   ObserveIT connection protocol set to https
   Attempting to restore backup SQL
   Backing up FACE Config (to /opt/isr/faceSetupTemplate.sql.bak).
   Updating FACE IP in SQL Script.
   Updating FACE HTTP/S in SQL Script.
   Updating ObserveIT IP in SQL Script.