Troubleshooting the installation, migration, or upgrade
Resolving errors with default currency settings
Manually registering application plug-ins
Application plug-ins are installed and registered as part of the installation. If there is an error during plug-in registration, you must register the plug-ins manually.
To register the application plug-ins
- Stop the BMC Remedy AR System server.
- (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: "C:\Program Files\BMC Software\BMCServiceRequestManagement\Shared_Components\bin\arfcbdata.dll"
- Plugin: "C:\Program Files\BMC Software\BMCServiceRequestManagement\Shared_Components\bin\NextId.dll"
Plugin-Path: Plugin: C:\Program Files\BMC Software\ BMCServiceRequestManagement\Shared_Components\bin
- (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: /fullPathToPlug-in/libcaieventcmd.OS
- Plugin: /fullPathToPlug-in/libardbcquery.OS
- Plugin: /fullPathToPlug-in/libarfcbdata.OS
- Plugin: /fullPathToPlug-in/libNextId.OS
- Plugin-Path: /fullPathToPlug-in/Shared_Components/bin
In the syntax, OS is a mnemonic of the UNIX server type (a for AIX, sl for HP-AIX, or so for Solaris or Linux).
For CAI, add the following lines to the pluginsvr_config.xml file in the pluginsvr folder:
<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/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 folder:
<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/qry/ITSMCommonUtils.jar </pathelement>
<userDefined>
<server_name>ar server hostname</server_name>
<server_port> ar server port number</server_port>
</userDefined>
</plugin>For CAI, add the following lines to the log4j_pluginsvr.xml file:
<logger name="com.bmc.itsm.cai.filterapi.cai">
<level value="warn"/>
</logger>For ARDBC, add the following lines to the log4j_pluginsvr.xml file:
<logger name="com.bmc.itsm.conquery.ardbc.conquery">
<level value="warn"/>
</logger>- 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 temp folder (Windows) or the /tmp folder (UNIX).
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*