This documentation supports the 9.0 version of BMC Remedy ITSM Deployment.

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

Manually registering application plug-ins for BMC Service Request Management

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

Notes

  • In this topic, SRMInstallDir refers to the default BMC Service Request Management installation directory:
    • (Microsoft Windows) C:\Program Files\BMC Software\BMCServiceRequestManagement\
    • (UNIX) /opt/bmc/BMCServiceRequestManagement/
  • In this topic ARSystemInstallDir  refers to the default BMC Remedy AR System installation directory:
    • (Microsoft Windows) C:\Program Files\BMC Software\ARSystem
    • (UNIX) /opt/bmc/ARSystem
  • For CAI, ensure that the CAIPlugin.jar and ITSMCommonUtils.jar files are in the ARSystemInstallDir\pluginsvr\cai directory.
  • For ARDBC, ensure that the Query.jar and ITSMCommonUtils.jar files are in the ARSystemInstallDir\pluginsvr\qry directory.

To register the application plug-ins

  1. Stop the BMC Remedy AR System server.
  2. (Microsoft Windows) Add the Plugin and Plugin-Path entries to the ar.cfg file.
    For example, on a Windows server, add the following entries to the ar.cfg file:
    • Server-Plugin-Alias: REMEDY.ARF.CAI REMEDY.ARF.CAI pluginServerHost:plugin server port
    • Server-Plugin-Alias: REMEDY.ARDBC.APPQUERY REMEDY.ARDBC.APPQUERY pluginServerHost:plugin server port
    • Plugin: "SRMInstallDir\Shared_Components\bin\arfcbdata.dll"
    • Plugin: "SRMInstallDir\Shared_Components\bin\NextId.dll"

    Note

    Plug-in entries in the ar.cfg file must be enclosed in double quotes.

  3. (UNIX) Add the Plugin and Plugin-Path entries to the ar.conf file.
    For example, on a UNIX server, add the following entries to the ar.conf file:
    • Server-Plugin-Alias: REMEDY.ARF.CAI REMEDY.ARF.CAI pluginServerHost:plugin server port
    • Server-Plugin-Alias: REMEDY.ARDBC.APPQUERY REMEDY.ARDBC.APPQUERY pluginServerHost:plugin server port
    • Plugin: SRMInstallDir/Shared_Components/bin/libcaieventcmd.x
    • Plugin: SRMInstallDir/servername/Shared_Components/bin/libardbcquery.x
    • Plugin: SRMInstallDir/servername/Shared_Components/bin/libarfcbdata.x
    • Plugin: SRMInstallDir/servername/Shared_Components/bin/libNextId.x

    Note

    The UNIX file name extension .x will be replaced by .so for Linux.

  4. For CAI, add the following lines to the pluginsvr_config.xml file 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/cai/ITSMCommonUtils.jar</pathelement>
    <userDefined>
    <server_name>ar server hostname</server_name>
    <server_port> ar server port number</server_port>
    </userDefined>
    </plugin>
    


    For ARDBC, add the following lines to the pluginsvr_config.xml file 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/qry/ITSMCommonUtils.jar </pathelement>
    <userDefined>
    <server_name>ar server hostname</server_name>
    <server_port> ar server port number</server_port>
    </userDefined>
    </plugin>
    
  5. For CAI, add the following lines to the log4j_pluginsvr.xml file:

    <logger name="com.bmc.itsm.cai.filterapi.cai">
    <level value="warn"/>
    </logger>
    
  6. For ARDBC, add the following lines to the log4j_pluginsvr.xml file:

    <logger name="com.bmc.itsm.conquery.ardbc.conquery">
    <level value="warn"/>
    </logger>
    
  7. Start the BMC Remedy AR System server.
    The plug-in installation errors are recorded in the bmcremedyitsmsuite_install_log.txt file, which is found in the following directory:
    • (Windows) temp
    • (UNIX) /tmp



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

Comments