This documentation applies to the 8.1 version of Remedy ITSM Deployment, which is in "End of Version Support." You will not be able to leave comments.

To view the latest version, select the version from the Product version menu.

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

  1. Stop the BMC Remedy AR System server.
  2. (Microsoft Windows) Delete the items shown in the following table:

    PluginLine to be removed from ar.cfg fileWindows 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:
      • (HP-UX and HP IA-64) .sl
      • (IBM AIX) .a
      • (Linux and Oracle Solaris) .so
    • On UNIX OS, you must also delete the /ARSystem/DB/CAIPlugin.txt log file while uninstalling the CAI plug-in.
    PluginLine to be removed from ar.conf fileUNIX 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.

Was this page helpful? Yes No Submitting... Thank you

Comments