Running a Node from the Command Line

Command Line Interface

Although the product contains a full series of command line tools, it is usually much easier to create and configure your runtime analysis specifications inside the graphical user interface (GUI). The CLI would then be used to simply launch the GUI with a project or project node as a parameter.

By doing this, you combine the ease and simplicity of the GUI with the ability to execute project nodes from a CLI.

Note   This functionality can be used to execute any node in a project, including group nodes, application nodes, test nodes or the entire project.

An HTML output option produces a set of HTML reports in a specified directory. The output is the same as exporting to HTML from the original reports. With this option, it is not necessary to open the GUI to view the reports.

To run a specific node from a command line:

  1. Set up and configure your project in the GUI.

  2. Save your project and close the GUI.

  3. Type the following command:

studio -r <node>.{[.<node>]} <project_file> [-html <directory>]

where:

The <node> hierarchy must be specified from the highest node in the project (excluding the actual project node) to the target node to be executed, with periods ('.') separating each item:

<node>{[.<node>]}

Example

The following command opens the project.rtp project in the GUI, and runs the app2 application node, located in group1 of the sub-project subproject1:

studio -r subproject1.group1.app2 project.rtp -html project/output

Related Topics

Graphical User Interface - studio