Install the Intelligent AI Connector

4 Install the Intelligent AI Connector

If you are using the Intelligent AI Connector (IAC), you must install either the Basic Intelligent Media Connector Domain or the Replicated Intelligent Media Connector Domain.

Download Patchset 39305242

Log into My Oracle Support and select Patches.
Search for patch 39305242.
Download the file p39305242_83000_Linux-x86-64.zip.

Extract the zip file.

$ unzip p39305242_83000_Linux-x86-64.zip 
Archive:  p39305242_83000_Linux-x86-64.zip
inflating: 38769006.zip            
inflating: IMCSampleApp-8.3.0.0.0.zip  
extracting: IntelligentAIConnector-8.3.0.0.0.tar.gz  
inflating: media-flow-engine-8.3.0.0.0.tar.gz  
inflating: README.txt              
inflating: rtp-proxy-8.3.0.0.0.tar.gz

Install Patch 38769006

After extracting the patchset, install patch number 38769006.

Copy 38769006.zip to the OPatch directory.

cp 38769006.zip ~/Oracle/Middleware/Oracle_Home/OPatch/

Navigate to the OPatch directory.

cd ~/Oracle/Middleware/Oracle_Home/OPatch/

Install the patch.
```
./opatch apply 38769006.zip -silent 
```
Verify the patch installed.
```
./opatch lsinventory
```

Update Config XML

Navigate to the $DOMAIN_HOME/config directory.
Backup the existing config.xml file.

Add the following blocks before the <admin-server-name> element.

For the Basic Intelligent Media Connector Domain

  <custom-resource>
    <name>IntelligentAIConnector</name>
    <target>AdminServer</target>
    <descriptor-file-name>custom/aic-connector.xml</descriptor-file-name>
    <resource-class>com.bea.wcp.aic.descriptor.resource.AIConnectorResource</resource-class>
    <descriptor-bean-class>com.bea.wcp.aic.descriptor.beans.AIConnectorBean</descriptor-bean-class>
  </custom-resource>
  <custom-resource>
    <name>AICHealthMonitor</name>
    <target>AdminServer</target>
    <descriptor-file-name>custom/aic-connector.xml</descriptor-file-name>
    <resource-class>com.oracle.occas.ags.aihm.descriptor.resource.AICHealthMonitorResource</resource-class>
    <descriptor-bean-class>com.bea.wcp.aic.descriptor.beans.AIConnectorBean</descriptor-bean-class>
  </custom-resource>

For the Replicated Intelligent Media Connector Domain

  <custom-resource>
    <name>IntelligentAIConnector</name>
    <target>BEA_ENGINE_TIER_CLUST</target>
    <descriptor-file-name>custom/aic-connector.xml</descriptor-file-name>
    <resource-class>com.bea.wcp.aic.descriptor.resource.AIConnectorResource</resource-class>
    <descriptor-bean-class>com.bea.wcp.aic.descriptor.beans.AIConnectorBean</descriptor-bean-class>
  </custom-resource>
  <custom-resource>
    <name>IntelligentAIConnectorStorage</name>
    <target>BEA_ENGINE_TIER_CLUST</target>
    <descriptor-file-name>custom/coherence.xml</descriptor-file-name>
    <resource-class>com.oracle.occas.ags.storage.descriptor.resource.AIGatewayStorageResource</resource-class>
    <descriptor-bean-class>com.bea.wcp.sip.management.descriptor.beans.CoherenceStorageBean</descriptor-bean-class>
  </custom-resource>
  <custom-resource>
    <name>AICHealthMonitor</name>
    <target>BEA_ENGINE_TIER_CLUST</target>
    <descriptor-file-name>custom/aic-connector.xml</descriptor-file-name>
    <resource-class>com.oracle.occas.ags.aihm.descriptor.resource.AICHealthMonitorResource</resource-class>
    <descriptor-bean-class>com.bea.wcp.aic.descriptor.beans.AIConnectorBean</descriptor-bean-class>
  </custom-resource>

Add the aic-connector.xml

Navigate to $ORACLE_HOME/OPatch.
Extract the patch.
```
unzip 38769006.zip
```

Copy the file.

cp 38769006/custom/aic_config/aic-connector.xml $DOMAIN_HOME/config/custom/

Modify startWebLogic.sh

If JWT authentication is enabled:

Copy the private_aic.pem from the build package into the Oracle home directory

Add the following JVM parameters to the SAVE_JAVA_OPTIONS variable:

-Dmfe.config.file=${ORACLE_HOME}/mfe-app.properties
  -Doracle.sdp.mgs.jwt.pem.path=${ORACLE_HOME}/private.pem
  -Doracle.occas.ags.jwt.pem.path=${ORACLE_HOME}/private_aic.pem
  -Daic.transcription.save=true
  -Daic.transcription.dir=${ORACLE_HOME}/Transcriptions

Open the <DOMAIN_HOME>/bin/setDomainEnv.sh file.

Replace the POST_CLASSPATH if-else block with the following:

if [ "${POST_CLASSPATH}" != "" ] ; then
  POST_CLASSPATH="${ORCL_HOME}/occas/server/lib/platform/oracle.sdp.occas.depended.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/wlss-runtime-rest-proxy.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/weblogic_sip.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/media-gateway-storage.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/health-monitor.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/mediagateway-api.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/mgs-impl.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/media-control-api-impl.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/aic-health-monitor.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/ai-gateway-storage.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/ags-api.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/ags-impl.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/ai-service-api-impl.jar${CLASSPATHSEP}${POST_CLASSPATH}"
  export POST_CLASSPATH
else
  POST_CLASSPATH="${ORCL_HOME}/occas/server/lib/platform/oracle.sdp.occas.depended.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/wlss-runtime-rest-proxy.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/weblogic_sip.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/media-gateway-storage.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/health-monitor.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/mediagateway-api.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/mgs-impl.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/media-control-api-impl.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/aic-health-monitor.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/ai-gateway-storage.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/ags-api.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/ags-impl.jar${CLASSPATHSEP}${ORCL_HOME}/wlserver/sip/server/lib/ai-service-api-impl.jar"
  export POST_CLASSPATH
fi

Restart the Admin and all Managed Servers.

Download and Configure AIC

Download and extract the AIC package from the Oracle Software Delivery Cloud.
```
tar -xzvf IntelligentAIConnector-8.3.0.0.0.tar.gz
```

Navigate to the config directory.

cd IntelligentAIConnector-8.3.0.0.0-AIC/AIC_HOME/config/

Open the application.yaml file.
1. Set the providers.oci.compartmentId to your OCI compartment ID
2. Set the providers.oci.region to your OCI region.
3. Set application.ip-address to the management IP used by the REST/HTTP worker.
  This interface must have public network access, as IAC connects to OCI STT through this IP.
4. Set application.udp.bind-address to the private IP used for UDP media ingress.
  This address must be in the same subnet (L2 adjacency) as the RTPProxy and MFE to ensure proper audio packet delivery.
Modify the rest of the file as needed for your environment.

Start the AIC.

cd IntelligentAIConnector-8.3.0.0.0-AIC/AIC_HOME/bin 
./startAIC.sh