Error: Invalid spaceKey on retrieving a related space config.

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:
      • (Linux) .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