Manually registering application plugins for BMC Remedy ITSM Suite
Product plug-ins are installed and registered as part of the BMC Remedy IT Service Management (ITSM) Suite installation. If an error occurs during plug-in registration, you must register the plug-ins manually.
If you are upgrading to BMC Remedy ITSM Suite 7.6.03 or later, complete the procedure in this topic to uninstall the C plug-ins that have been replaced by Java plug-ins.
The plug-in installation errors are recorded in the bmcremedyitsmsuite_install_log.txt file, which is found in the following directory:
- (Microsoft Windows) temp
- (UNIX) /tmp
This topic describes the following tasks:
To uninstall the C plug-ins
- Stop the BMC Remedy AR System server.
(Microsoft Windows) Delete the items shown in the following table:
The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.
(UNIX) Delete the items shown in the following table.
- After you uninstall the C plug-ins, you can proceed with registering the new Java plug-ins.
To register the new Java plug-ins
- Add the following Plugin and Plugin-Path entries to the ar.cfg (ar.conf) file.
- Server-Plugin-Alias: REMEDY.ARF.CAI REMEDY.ARF.CAI PluginServerHost:PluginServerPort
- Server-Plugin-Alias: REMEDY.ARDBC.APPQUERYREMEDY.ARDBC.APPQUERY PluginServerHost:PluginServerPort
- Server-Plugin-Alias: REMEDY.ARF.CBDATA REMEDY.ARF.CBDATA PluginServerHost:PluginServerPort
- Server-Plugin-Alias: NextId NextId PluginServerHost:PluginServerPort
- (Windows and UNIX) For each plug-in, add the appropriate text, as shown in the following list, to pluginsvr_config.xml in the pluginsvr directory.
The list shows the code for UNIX. The same code is applicable to Windows with backward slashes (\) instead of forward slashes (/) in the directory names.For the CAI plug-in, add the following text to pluginsvr_config.xml 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/foundation_shared/
ITSMCommonUtils.jar</pathelement><userDefined></userDefined>
</plugin>For the ARDBC plug-in, add the following text to pluginsvr_config.xml 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/foundation_shared/ITSMCommonUtils.jar</pathelement>
<userDefined>
</userDefined>
</plugin>For the chargebacks plug-in, add the following text to pluginsvr_config.xml in the pluginsvr directory:
<plugin>
<name>REMEDY.ARF.CBDATA</name>
<type>FilterAPI</type>
<code>JAVA</code>
<filename>ARSystemInstallDir/pluginsvr/chb/chargebacks.jar</filename>
<classname>com.bmc.itsm.chargeback.filterapi.chargeback.
ChargeBackFilterAPI</classname>
<pathelement type="location">ARSystemInstallDir/pluginsvr/chb/chargebacks.jar
</pathelement>
<pathelement type="location">ARSystemInstallDir/pluginsvr/foundation_shared/
ITSMCommonUtils.jar</pathelement>
</plugin>For the NextId plug-in, add the following text to pluginsvr_config.xml in the pluginsvr directory:
<plugin>
<name>NextId</name>
<type>FilterAPI</type>
<code>JAVA</code>
<filename>ARSystemInstallDir/pluginsvr/nid/nextid.jar</filename>
<classname>com.bmc.itsm.nextid.filterapi.nextid.NextID</classname>
<pathelement type="location">ARSystemInstallDir/pluginsvr/foundation_shared/ITSMCommonUtils.jar</pathelement>
<pathelement type="location">ARSystemInstallDir/pluginsvr/nid/
nextid.jar</pathelement>
</plugin>
(Windows and UNIX) For the plug-ins, add the appropriate text to the log4j_pluginsvr.xml file.
For the CAI plug-in, add the following text to log4j_pluginsvr.xml:
<logger name="com.bmc.itsm.cai.filterapi.cai">
<level value="warn"/>
</logger>For the ARDBC plug-in, add the following text to log4j_pluginsvr.xml:
<logger name="com.bmc.itsm.conquery.ardbc.conquery">
<level value="warn"/>
</logger>For the charge backs plug-in, add the following text to log4j_pluginsvr.xml:
<logger name="com.bmc.itsm.chargeback.filterapi.chargeback">
<level value="warn"/>
</logger>For the NextId plug-in, add the following text to log4j_pluginsvr.xml:
<logger name="com.bmc.itsm.nextid.filterapi.nextid">
<level value="warn"/>
</logger>
- Add the following entry to the ar.cfg(ar.conf) file:
Server-Plugin-Default-Timeout: 300 - Start the BMC Remedy AR System server.