This documentation supports the 9.1 version of Remedy IT Service Management Suite.

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

Manually registering application plug-ins

Product plug-ins are installed and registered as part of the installation. If an error occurs during plug-in registration, you must register the plug-ins manually.

This topic describes the following tasks:

The plug-in installation errors are recorded in the bmcremedyitsmsuite_install_log.txt file, which is found in the temp directory (Windows) or the /tmp directory (UNIX).

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.

Before you begin

If you are upgrading to BMC Remedy ITSM 7.6.03 or later, complete the following procedure to uninstall the C plug-ins that have been replaced by Java plug-ins.

To uninstall the C plug-ins

  1. Stop the BMC Remedy AR System server.
  2. Delete the items shown in the following table to uninstall the various C plugins.

    Note

    In the "On UNIX" table, the file name extension .x will be replaced by .sl for HP-UX and HP IA-64, .a for IBM AIX, and .so for Linux and Oracle Solaris.

    On Microsoft Windows

    Plugin

    Line to be removed from ar.cfg file

    Windows DLL to be deleted

    CAI

    Plugin: "...full path to... \BMCRemedyITSMSuite
    \Shared_Components\bin\caieventcmd.dll"

    ...full path to... \BMCRemedyITSMSuite\Shared_Components
    \bin\caieventcmd.dll

    ARDBC

    Plugin: "...full path to... 
    \BMCRemedyITSMSuite\servername
    \Shared_Components\bin\ardbcQuery.dll"

    ...full path to...\BMCRemedyITSMSuite
    \servername\Shared_Components\bin \ardbcQuery.dll

    chargebacks

    Plugin: "... full path to...
    \BMCRemedyITSMSuite\servername
    \Shared_Components\bin\arfcbdata.dll"

    ... full path to...\BMCRemedyITSMSuite
    \servername\Shared_Components\bin\arfcbdata.dll

    NextId

    Plugin: "...full path to...\BMCRemedyITSMSuite\servername
    \Shared_Components\bin\NextId.dll"

    ...full path to...\BMCRemedyITSMSuite
    \servername\Shared_Components\bin\NextId.dll



    On UNIX

    Plugin

    Line to be removed from ar.conf file (UNIX)

    UNIX OS libraries to be deleted

    CAI

    Plugin: "...full path to...
    /BMCRemedyITSMSuite/Shared_Components/
    bin/libcaieventcmd.x"

    ...full path to...
    /BMCRemedyITSMSuite/Shared_Components/
    bin/libcaieventcmd.x

    ARDBC

    Plugin: "...full path to... 
    /BMCRemedyITSMSuite/servername/
    Shared_Components/bin/libardbcQuery.x"

    ...full path to...
    /BMCRemedyITSMSuite/servername/
    Shared_Components/bin/libardbcQuery._x

    chargebacks

    Plugin: "... full path to...
    /BMCRemedyITSMSuite/servername/
    Shared_Components/bin/libarfcbdata.x"

    ... full path to...
    /BMCRemedyITSMSuite/servername/
    Shared_Components/bin/libarfcbdata.x

    NextId

    Plugin: "...full path to...
    /BMCRemedyITSMSuite/servername/
    Shared_Components/bin/libNextId.x"

    ...full path to...
    /BMCRemedyITSMSuite/servername/
    Shared_Components/bin/libNextId.x

    Note

    On UNIX, you must also delete the /ARSystem/DB/CAIPlugin.txt log file while uninstalling the CAI plug-in.

  3. 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. (Windows servers) Add the following Plugin and Plugin-Path entries to the ar.cfg file and for UNIX servers add them to the 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 the pluginsvr_config.xml in the pluginsvr folder.
    The list shows the code for UNIX. The same code is applicable to Windows with \ instead of / in the directory names.
    • For the CAI plug-in, add the following text to pluginsvr_config.xml in the pluginsvrfolder:

      <plugin>
      <name>REMEDY.ARF.CAI</name>
      <type>FilterAPI</type>
      <classname>com.bmc.itsm.cai.filterapi.cai.CAIFilterPlugin</classname>
      <pathelement type="path">...full path to... /ARSystem/pluginsvr/cai</pathelement>
      <pathelement type="location">...full path to.../ARSystem/pluginsvr/cai/CAIPlugin.jar</pathelement>
      <pathelement type="location">...full path to.../ARSystem/pluginsvr/foundation_shared/
      ITSMCommonUtils.jar</pathelement><userDefined></userDefined>
      </plugin>
      
    • For the ARDBC plug-in, add the following text to pluginsvr_config.xml in the pluginsvrfolder:

      <plugin>
      <name>REMEDY.ARDBC.APPQUERY</name>
      <type>ARDBC</type>
      <code>JAVA</code>
      <filename>...full path to.../ARSystem/pluginsvr/qry/conquery.jar</filename>
      <classname>com.bmc.itsm.conquery.ardbc.conquery.Query</classname>
      <pathelement type="path">...full path to... ARSystem/pluginsvr/qry</pathelement>
      <pathelement type="location">...full path to... ARSystem/pluginsvr/qry/conquery.jar</pathelement>
      <pathelement type="location">...full path to... ARSystem/pluginsvr/foundation_shared/ITSMCommonUtils.jar</pathelement>
      <userDefined>
      </userDefined>
      </plugin>
      
    • For the charge backs plug-in, add the following text to pluginsvr_config.xml in the pluginsvr folder:

      <plugin>
      <name>REMEDY.ARF.CBDATA</name>
      <type>FilterAPI</type>
      <code>JAVA</code>
      <filename>...full path to... ARSystem/pluginsvr/chb/chargebacks.jar</filename>
      <classname>com.bmc.itsm.chargeback.filterapi.chargeback.
      ChargeBackFilterAPI</classname>
      <pathelement type="location">...full path to... ARSystem/pluginsvr/chb/chargebacks.jar
      </pathelement>
      <pathelement type="location">...full path to... ARSystem/pluginsvr/foundation_shared/
      ITSMCommonUtils.jar</pathelement>
      </plugin>
      
    • For the NextId plug-in, add the following text to pluginsvr_config.xml in the pluginsvr folder:

      <plugin>
      <name>NextId</name>
      <type>FilterAPI</type>
      <code>JAVA</code>
      <filename>...full path to... ARSystem/pluginsvr/nid/nextid.jar</filename>
      <classname>com.bmc.itsm.nextid.filterapi.nextid.NextID</classname>
      <pathelement type="location">...full path to... ARSystem/pluginsvr/foundation_shared/ITSMCommonUtils.jar</pathelement>
      <pathelement type="location">...full path to... ARSystem/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 or 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