Running the plug-in server
The plug-in server is set up in the armonitor configuration to start automatically at system startup. It stops and restarts with the rest of the AR System services controlled by armonitor, the AR System UNIX daemon, or the Windows service.
To start the plug-in server manually, run the pluginsvrstartup command in the pluginsvr directory. This command file (pluginsvrstartup.sh for UNIX or pluginsvrstartup.bat for Windows) is customized for your installation. To change command-line options, see Configuring the Java plug-in server.
In this topic:
Logging plug-in information
Plug-ins can write information to the plug-in server log file. C plug-ins can use the ARPluginSetProperties function to call the plug-in log function:
typedef int (*AR_PLUGIN_LOG_FUNCTION)(
The plug-in type, name, and version.
The log level to which the information applies:
The message that is written to the plug-in server log file.
The C plug-in log function has no return value.
Set the log level for the C-based plug-in server using the Plugin_Log_Level option in the ar.cfg or ar.conf file or on the Log Files tab of the AR System Administration: Server Information form. For more information, see Setting log files options.
Java plug-ins can log messages using the logMessage method of their ARPluginContext object. See the Java plug-in API online documentation located at ARSystemServerInstallDir\ARserver\api\javaplugins\arpluginsdocVerNum.jar for details.
The Java plug-in server uses the log4j utility. Set the log level and other logging configuration in the log4j_pluginsvr.xml file. Comments in the sample file describe the log configuration options.
Logging exceptions for calls to Java plug-ins
When a run-time exception or an ARException class error occurs during a Java plug-in server call to a Java plug-in, the following information is now recorded in the ARServerInstallDir\Arserver\Db\arjavaplugin.log file:
- The name of the plug-in
This name matches the name of the corresponding plug-in library registered in the Java plug-in configuration file, pluginsvr_config.xml. For example, if the library is registered as <name>ARSYS.ARF.WEBSERVICE</name>, the plug-in name in the log file is ARSYS.ARF.WEBSERVICE.
- The method that the server tried to call in the plug-in
- (Runtime exceptions only) The exception stack trace
In addition, when a run-time exception occurs, users receive Error 8753: Error in plugin: pluginName.
When an ARException occurs, users receive the usual message associated with the exception.
When you restart the AR System server, the arjavaplugin.log might log warnings that look similar to this:
com.bmc.arsys.pluginsvr.plugins.ARPluginContext (?:?) -
<ARSYS.ARF.REGISTRY>Null registry location
You can safely ignore these messages. If you want to use the Registry, then enter the Registry location in the AR System Administration Console. For more information, see Registering a web service.
About C plug-in exception handling
Exception handling in the C plug-in server now produces a stack trace. The stack trace includes the names of the operation, vendor, and plug-in library. It is written to the arerror.log file.