Command line testing tool

Use the command line tool to execute a workflow. The command line tool provides quick feedback while you develop or troubleshoot the contents of a workflow.

The command line tool does not interact with the live IBM® QRadar® event pipeline. Any events that are retrieved from the Universal Cloud REST API protocol are written to the QRadar Console.

New in V2

To run the tool in V2 or later, type the following command.

/opt/qradar/bin/test-workflow.sh

To run the tool in V1, add one or more commands to the end of the following command line to run the tool. If you don't specify any arguments, the entire usage is written.

java -cp "/opt/ibm/si/services/ecs-ec-ingress/current/bin/*:/opt/ibm/si/services/ecs-ec-ingress/eventgnosis/lib/q1labs/*" com.q1labs.semsources.sources.universalcloudrestapi.UniversalCloudRESTAPITest

The following table shows the commands for the command line testing tool.

Table 1. Command line testing tool usage
Command	Description
`-?,--help`	Displays the usage and exits.
`-p <[user@]server:port>`	Specifies the proxy to use.
`-r <seconds>`	Specifies the poll frequency. In V2 or later, by default the tool runs only once. If you enter a frequency, the tool runs at that interval.
`-s <file>`	Specifies the file for state persistence.
`-v`	Displays more logging.
`-w <file>`	Specifies the workflow to load.
`-wp <file>`	Specifies the workflow parameter values to load. In V2 or later, this parameter is optional.

XML Example

In the following example, the command line is used to specify the workflow and workflow parameter values to load. The -w command is used to specify the myworkflow.XML workflow and the -wp command is used to specify the myworkflow.parameter.values.xml workflow parameter values.

/opt/qradar/bin/test-workflow.sh -w myworkflow.xml -wp myworkflow.parameter.values.xml