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

1. Stop the BMC Remedy AR System server.

2. (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

3. (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

4. After you uninstall the C plug-ins, you can proceed with registering the new Java plug-ins.

To register the new Java plug-ins

1. 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
2. (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>
     

3. (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>
     

4. Add the following entry to the ar.cfg(ar.conf) file: 
   Server-Plugin-Default-Timeout: 300
5. Start the BMC Remedy AR System server.