Creating Performance Sessions Using a Script

The Legacy orchestrator command line interface is called Appliance Monitor. From the Appliance Monitor command line, you can access another set of commands (called mgr-commands) that are used primarily to set up performance sessions.

To create performance sessions in bulk using a script, you prepare the script consisting of mgr-commands that create sender endpoints, reflector endpoints, and sessions. Then you execute the script in mgr-commands mode.

This article provides a procedure for loading and executing a script on the command line. It also provides an example script for creating performance sessions.

For detailed information about the Appliance Monitor and mgr-commands, see the Appliance Monitor Command Reference (part of the document set for Legacy orchestrator).

Procedure Requirements

1. Part of this procedure is performed in the Legacy orchestrator console (Appliance Monitor CLI). To access the console, you need to know the credentials of the visionems user.
2. Part of this procedure is performed in mgr-commands mode. To enter this mode, you must know the credentials for a valid Legacy orchestrator user account (an account for the Legacy orchestrator web interface).

You must prepare a script that includes all the commands needed to set up the session. For an example that you can use as a starting point, see Example Script for Creating Performance Sessions.

Procedure Steps

During this procedure you will do the following tasks:

• Upload the script to the Legacy orchestrator appliance.
• Execute the script.

To upload the script to the Legacy orchestrator appliance

Use an SCP client (such as WinSCP) and the visionems account to transfer your script to the following directory on the appliance:
/home/visionems

To execute the script

1. Access the Legacy orchestrator console by opening an SSH session to the appliance IP address, port 2200.

2. Log in as the visionems user.

3. At the prompt, enter this command to go into mgr-commands mode:
   mgr-commands

4. At the mgr/mgr# prompt, enter this command to execute the script:
   execute /home/visionems/yourScript
   The commands in the script are displayed as they are executed.

5. When the script has run to completion, enter this command to confirm that any new reflectors and supervision endpoints were created:
   show endpoint all
   Confirm that new endpoints appear in the list.

6. Enter this command to check that new sessions were created:
   show session
   Confirm that new sessions appear in the list.

7. Exit mgr-commands mode by entering:
   quit

Example Script for Creating Performance Sessions

This example script creates and configures four reflectors and sets up a TWAMP session.

The script consists of mgr-commands. For detailed descriptions of mgr-commands, see the Appliance Monitor Command Reference.