This documentation applies to the 8.1 version of Remedy IT Service Management Suite, 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 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.

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments