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)(
ARPluginIdentificationasdfasdfasdfas*id,
intasdfasdfasdfasdfasdfaassdfasdfasdfasdfalogLevel,
charasdfasdfasdfasdfasdfaasdfasdfasdfasdfa*text);
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 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>DSO.FILTERCONFIGURATION</name>, the plug-in name in the log file is DSO.FILTERCONFIGURATION. - 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.
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.