CLI cookbook: running the network test via CLI - throughput

Prerequisites

The network performance tool measures network performance between a Delphix Engine and an environment host. You must have added an environment in order to use this tool.

This transmission control protocol (TCP) throughput test uses TCP port 50001 by default. The port can also be configured on a per-test-run basis. For the duration of a given throughput test, a server on the receiver will be listening on this port. For a transmit test, the receiver is the remote host; for a receive test, the receiver is the Delphix Engine.

Procedure

The network throughput test measures sustained throughput using a synthetic workload to or from a remote host. To execute a test:

1. Login as a domain user to the Delphix Engine CLI using ssh.

2. Create a network throughput test.

   CODE

   delphix> network test throughput
   delphix network test throughput> create
   delphix network test throughput create *>

3. You must set remoteHost to the name of an environment host already configured in the Delphix Engine. Use 'get' to see other optional arguments. Modify the test parameters as needed and commit to start the test.

   CODE

   delphix network test throughput create *> set remoteHost=oraclesource 
   delphix network test throughput create *> ls
   Properties
       type: NetworkThroughputTestParameters
       blockSize: 128KB
       direction: TRANSMIT
       duration: 30
       numConnections: 0
       port: 50001
       receiveSocketBuffer: 4MB
       remoteHost: oraclesource
       sendSocketBuffer: 4MB
   delphix network test throughput create *> commit
       Dispatched job JOB-21
       NETWORK_THROUGHPUT_TEST_EXECUTE job started for "oraclesource-2014-06-20T19:30:12.566Z".
       Executing network throughput transmit test.
       Measuring throughput with variable number of connections: 1.
       Measuring throughput with variable number of connections: 2.
       Measuring throughput with variable number of connections: 4.
       Measuring throughput with variable number of connections: 6.
       Measuring throughput with variable number of connections: 8.
       Measuring maximum sustained throughput for 30 seconds with 8 connections.
       NETWORK_THROUGHPUT_TEST_EXECUTE job for "oraclesource-2014-06-20T19:30:12.566Z" completed successfully.

4. The job will be submitted and visible in the Delphix Management application.

   CODE

   delphix network test throughput> list
   NAME                                   DIRECTION    STATE     THROUGHPUT
   oraclesource-2014-06-20T19:30:12.566Z  TRANSMIT     COMPLETED 695.6Mbps
   delphix network test throughput> select oraclesource-2014-06-20T19:30:12.566Z
   delphix network test throughput "oraclesource-2014-06-20T19:30:12.566Z"> get
       type: NetworkThroughputTest
       name: oraclesource-2014-06-20T19:30:12.566Z
       endTime: 2014-06-20T19:31:15.041Z
       numConnections: 8
       parameters:
           type: NetworkThroughputTestParameters
           blockSize: 128KB
           direction: TRANSMIT
           duration: 30
           numConnections: 0
           port: 50001
           receiveSocketBuffer: 4MB
           remoteHost: oraclesource
           sendSocketBuffer: 4MB
       reference: NETWORK_THROUGHPUT_TEST-2
       remoteAddress: 172.16.203.184
       startTime: 2014-06-20T19:30:12.566Z
       state: COMPLETED
       throughput: 695.6Mbps