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
Note
Ensure that the plug-in .jar files (CAIPlugin.jar, conquery.jar, chargebacks.jar, nextid.jar, and ITSMCommonUtils.jar) are in the directories shown in step 3 in To register the new Java plug-ins.
This topic describes the following tasks:
Note
In this topic, ITSMInstallDir is the default location where BMC Remedy ITSM Suite is installed:
- (Microsoft Windows) C:\Program Files\BMC Software\BMCRemedyITSMSuite
- (UNIX) /opt/bmc/bmcremedyitsmsuite
To uninstall the C plug-ins
- Stop the BMC Remedy AR System server.
(Microsoft Windows) Delete the items shown in the following table:
Plugin Line to be removed from ar.cfg file Windows DLL to be deleted CAI
Plugin: "ITSMInstallDir\Shared_Components\bin\caieventcmd.dll"
ITSMInstallDir\Shared_Components\bin\caieventcmd.dll
ARDBC
Plugin: " ITSMInstallDir\servername\Shared_Components\bin\ardbcQuery.dll"
ITSMInstallDir\servername\Shared_Components\bin\ardbcQuery.dll
chargebacks
Plugin: " ITSMInstallDir\servername\Shared_Components\bin\arfcbdata.dll"
ITSMInstallDir\servername\Shared_Components\bin\arfcbdata.dll
NextId
Plugin: "ITSMInstallDir\servername\Shared_Components\bin\NextId.dll"
ITSMInstallDir\servername\Shared_Components\bin\NextId.dll
(UNIX) Delete the items shown in the following table.
Notes
- For UNIX, the file name extension .xwill be replaced by the following extensions:
- (Linux) .so
- On UNIX OS, you must also delete the /ARSystem/DB/CAIPlugin.txt log file while uninstalling the CAI plug-in.
Plugin Line to be removed from ar.conf file UNIX OS libraries to be deleted CAI
Plugin: "ITSMInstallDir/Shared_Components/bin/libcaieventcmd.x"
ITSMInstallDir/Shared_Components/bin/libcaieventcmd.x
ARDBC
Plugin: "ITSMInstallDir/servername/Shared_Components/bin/libardbcQuery.x"
ITSMInstallDir/servername/Shared_Components/bin/libardbcQuery._x
chargebacks
Plugin: "ITSMInstallDir/servername/Shared_Components/bin/libarfcbdata.x"
ITSMInstallDir/servername/Shared_Components/bin/libarfcbdata.x
NextId
ITSMInstallDir/servername/Shared_Components/bin/libNextId.x"
ITSMInstallDir/servername/Shared_Components/bin/libNextId.x
- For UNIX, the file name extension .xwill be replaced by the following extensions:
- 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.
Comments
Log in or register to comment.