6.1

track Method
You use the track method to track log or configuration events.
Syntax
The syntax for the track method is as follows.
ava -jar /bundles/agent-VERSION/pdk/lib/dcs-tools-pdk-VERSION.jar -p PluginName -t
"ResourceType" -m track -a TrackAction -Dserver.config_track.files=TrackFiles
Argument Description
PluginName Identifies the plug-in to run.
ResourceType
Specifies a resource type managed by the plug-in.
TrackAction
Specifies whether to track log events or configuration events.
Use with the log or track options.
NOTE You can use a properties file instead of specifying
-pPluginName
-t ResourceType
-Dserver.config_track.files=TrackFiles
Example: Various Usage Options
In the following examples, only the method invocation and command options are shown. The java -jar
AgentHome/bundles/AgentBundle/pdk/lib/dcs-tools-pdk-VERSION.jar portion of the command is not
shown.
Command Purpose
-p apache -t "Apache 2.0" -m track -a config -
Dserver.config_track.files=/etc/httpd/httpd.conf
To track changes made to
the /etc/httpd/httpd.conf file for an
"Apache 2.0" server.
-p apache -t "Apache 2.0" -m track -a log -
Dserver.log_track.files=/var/log/httpd/error_log
To track log entries
to /var/log/httpd/error_log for an
"Apache 2.0" server .
Add the required property definition to the command line, for
example, -Dserver.log_track.exclude=String
To implement other configurable tracking
behaviors. For example, to check the results of
tracking log messages that do or do not contain
a particular string, you must set the value of
server.log_track.exclude or
server.log_track.include on the command
line.
generate Method
You use the generate method to generate documentation from the plug-in descriptor.
Syntax
The syntax for the generate method is as follows.
java -jar bundles/agent-VERSION/pdk/lib/dcs-tools-pdk-VERSION.jar -p PluginName -m generate -a
GenerateAction
Chapter 1 Introduction to Plug-in Development
VMware, Inc. 35