Table of Contents




Overview


Starting with version 8.50, an API browser was introduced to improve the user experience in automation.

The API browser is a view of the configuration shown in a hierarchical tree view.

The API browser is supported for Windows and Linux Gateway server.

The installation formats are OVA or QCOW2.


Requirement


IxLoad minimum version 8.50



Installation


From the Ixia support website

Download the Linux Gateway service with an OVA or QCOW2 image.





How to access the API browser


To access to the API browser on the IxLoad gateway on either Windows or Linux


The API browser will be empty

To view a configuration in the API browser, you use a ReST Client like Postman, VScode ReST Client or a ReST API script to load a saved configuration first.

Then go to the API browser to view the configuration under its session ID.



Expectations


IxLoad configurations in the GUI will not be reflected on the API browser.

The API browser doesn't have the capability to load a saved configuration.



Recommandation



Lets begin by connecting to an API browser of your choice

As shown below, it will be empty since no configuration has been loaded yet.




You need to use a third party ReST client tool to load your configuration

Follow the steps below by entering the ReST API syntaxes

You could use our sample script LoadSavedConfigFile.py also


Load a saved configuration using ReST API


      On a ReST API client tool, enter the following syntaxes:

      Step 1: Create a session. Change the version to your IxLoad version.
      POST: http://<IP address>:8080/api/v0/sessions data={"ixLoadVersion":"8.00.0.140"} application/JSON
      
      # Step 2: Get the session ID and the Object ID
      GET: http://<IP address>:8080/api/v0/sessions
      
      # Step 3: Activate the session
      POST: http://<IP address>:8080/api/v0/sessions/<session Id>/operations/start application/JSON
      
      # Verify that the session ID is activated
      GET: http://<IP address>:8080/api/v0/sessions/<session Id>
      
      # Step 4: Load a saved config file
      POST: http://<IP address>:8080/api/v0/sessions/<session Id>/ixload/test/operations/loadTest/0
      data={"fullPath":"C:\\Results\\tcp_8.0.rxf"} application/JSON
      
      # Step 5: Get the Operations ID number from Step 4 returned *headers*
      
      # Verify the load config POST action
      # status="In Progress|successful", state="executing|finished"
      GET: http://<IP address>:8080/api/v0/sessions/<session Id>/ixload/test/operations/loadTest/<operations Id>

with a configuration loaded, on a web browser, enter: http://<ip address>:8080

Then select your session ID at the top left corner




Now you could browse the API tree for your script development




To get the stat names for your script to poll at run time:







In our IxLoad ReST API sample scripts, insert the stats like this

  statsDict = {
     'HTTPClient': ['TCP Connections Established',
                    'HTTP Simulated Users',
                    'HTTP Concurrent Connections',
                    'HTTP Connections',
                    'HTTP Transactions',
                    'HTTP Connection Attempts'
                ],
     'HTTPServer': ['TCP Connections Established',
                    'TCP Connection Requests Failed'
                ]
  }

Here is a sample script from our Github: LoadConfigFile.py