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.
Notes
- In this topic, SRMInstallDir refers to the default BMC Service Request Management installation directory:
- (Microsoft Windows) C:\Program Files\BMC Software\BMCServiceRequestManagement\
- (UNIX) /opt/bmc/BMCServiceRequestManagement/
- In this topic ARSystemInstallDir refers to the default BMC Remedy AR System installation directory:
- (Microsoft Windows) C:\Program Files\BMC Software\ARSystem
- (UNIX) /opt/bmc/ARSystem
- For CAI, ensure that the CAIPlugin.jar and ITSMCommonUtils.jar files are in the ARSystemInstallDir\pluginsvr\cai directory.
- For ARDBC, ensure that the Query.jar and ITSMCommonUtils.jar files are in the ARSystemInstallDir\pluginsvr\qry directory.
To register the application plug-ins
- Stop the BMC Remedy AR System server.
- (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.
- (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.
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>
For CAI, add the following lines to the log4j_pluginsvr.xml file:
<logger name="com.bmc.itsm.cai.filterapi.cai"> <level value="warn"/> </logger>
For ARDBC, add the following lines to the log4j_pluginsvr.xml file:
<logger name="com.bmc.itsm.conquery.ardbc.conquery"> <level value="warn"/> </logger>
- 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
Comments
Log in or register to comment.