Manually registering application plug-ins for BMC Service Request Management

Application plug-ins are installed and registered as part of the BMC Service Request Management installation. If an error occurs during plug-in registration, you must register the plug-ins manually.

To register the application plug-ins

1. Stop the BMC Remedy AR System server.

2. (Microsoft Windows) Add the Plugin and Plugin-Path entries to the ar.cfg file.
   For example, on a Windows server, add the following entries to the ar.cfg file:

   • Server-Plugin-Alias: REMEDY.ARF.CAI REMEDY.ARF.CAI pluginServerHost:plugin server port
   • Server-Plugin-Alias: REMEDY.ARDBC.APPQUERY REMEDY.ARDBC.APPQUERY pluginServerHost:plugin server port
   • Plugin: "SRMInstallDir\Shared_Components\bin\arfcbdata.dll"
   • Plugin: "SRMInstallDir\Shared_Components\bin\NextId.dll"
     
     

   Note

   Plug-in entries in the ar.cfg file must be enclosed in double quotes.

3. (UNIX) Add the Plugin and Plugin-Path entries to the ar.conf file.
    For example, on a UNIX server, add the following entries to the ar.conf file:

   • Server-Plugin-Alias: REMEDY.ARF.CAI REMEDY.ARF.CAI pluginServerHost:plugin server port
   • Server-Plugin-Alias: REMEDY.ARDBC.APPQUERY REMEDY.ARDBC.APPQUERY pluginServerHost:plugin server port
   • Plugin: SRMInstallDir/Shared_Components/bin/libcaieventcmd.x
   • Plugin: SRMInstallDir/servername/Shared_Components/bin/libardbcquery.x
   • Plugin: SRMInstallDir/servername/Shared_Components/bin/libarfcbdata.x
   • Plugin: SRMInstallDir/servername/Shared_Components/bin/libNextId.x
     
     

   Note

   The UNIX file name extension .x will be replaced by .so for Linux.

4. For CAI, add the following lines to the pluginsvr_config.xml file in the pluginsvr directory:

   <plugin>
   <name>REMEDY.ARF.CAI</name>
   <type>FilterAPI</type>
   <classname>com.bmc.itsm.cai.filterapi.cai.CAIFilterPlugin</classname>
   <pathelement type="path">ARSystemInstallDir/pluginsvr/cai</pathelement>
   <pathelement type="location">ARSystemInstallDir/pluginsvr/cai/CAIPlugin.jar</pathelement>
   <pathelement type="location">ARSystemInstallDir/pluginsvr/cai/ITSMCommonUtils.jar</pathelement>
   <userDefined>
   <server_name>ar server hostname</server_name>
   <server_port> ar server port number</server_port>
   </userDefined>
   </plugin>
   

   For ARDBC, add the following lines to the pluginsvr_config.xml file in the pluginsvr directory:

   <plugin>
   <name>REMEDY.ARDBC.APPQUERY</name>
   <type>ARDBC</type>
   <code>JAVA</code>
   <filename>ARSystemInstallDir/pluginsvr/qry/conquery.jar</filename>
   <classname>com.bmc.itsm.conquery.ardbc.conquery.Query</classname>
   <pathelement type="path">ARSystemInstallDir/pluginsvr/qry</pathelement>
   <pathelement type="location">ARSystemInstallDir/pluginsvr/qry/conquery.jar </pathelement>
   <pathelement type="location">ARSystemInstallDir/pluginsvr/qry/ITSMCommonUtils.jar </pathelement>
   <userDefined>
   <server_name>ar server hostname</server_name>
   <server_port> ar server port number</server_port>
   </userDefined>
   </plugin>
   

5. For CAI, add the following lines to the log4j_pluginsvr.xml file:

   <logger name="com.bmc.itsm.cai.filterapi.cai">
   <level value="warn"/>
   </logger>
   

6. For ARDBC, add the following lines to the log4j_pluginsvr.xml file:

   <logger name="com.bmc.itsm.conquery.ardbc.conquery">
   <level value="warn"/>
   </logger>
   
7. Start the BMC Remedy AR System server.
   The plug-in installation errors are recorded in the bmcremedyitsmsuite_install_log.txt file, which is found in the following directory:
   • (Windows) temp
   • (UNIX) /tmp