Network virtualization start command

Starts network virtualization for the device with the specified conditions. Network virtualization will be stopped when the script ends.

For network condition testing, the device used is connected to the Web via Perfecto WiFi. Setup is completed by Perfecto.

Use the Network virtualization start and update commands to activate and update the network conditions. Without this activation, there is no effect on the device communication to the web.

Selecting latency effects both in and out traffic. For example, selecting latency of 100 results in the actual latency being 200 (100 each way).

For typical network emulation values, see Network conditions for network virtualization.

The following table lists emulation values of problematic networks.

Problematic Level Packet loss (%) Corruption (%) Duplication(%) Reorder

Steady Network

1

0

0

2

Noisy Network

2

2

0

5

Unstable Network

3

3

2

10

Very Unstable Network

5

5

5

20

Parameters

Name Type Possible values Description

Device ID*

Device

 

The device for this command. By default, this is the device under test (DUT).

Latency

Number

 0-8000ms

Latency applied on packets in the network.

Packet loss

Number

0-100%

Network packet loss.

A reasonable packet loss value should not exceed 5%.

Bandwidth in

Number

Limitation on the allowed download network bandwidth into the device. Effective values are in the range of 3-100,000 Kbps, or unlimited.

Bandwidth out

Number

Limitation on the allowed upload network bandwidth from the device.
Effective values are in the range of 3-100,000 Kbps, or unlimited.

Packet corruption

Number

0-100%

Network packet corruption. A reasonable packet corruption value should not exceed 5%.

Packet reordering

Number

0-100%

The percentage of network packets sent immediately without any delay. Used alongside the Latency parameter. Moreover, the packets that are sent immediately will arrive earlier than the packets that were delayed by the defined latency value, essentially creating a packet reordering.

A reasonable packet reordering value should not exceed 10%.

Packet duplication

Number

 0-100%

Network packets duplicated. A reasonable packet duplication value should not exceed 3%.

Delay Jitter

Number

 0-8000ms 

Random latency variation; the actual latency between latency +- jitter. Used alongside the Latency parameter. For example, if the latency is defined to be 100 ms and the jitter is 10 ms, this causes the added delay to be 100ms - 10ms.

Correlation

Number

 0-100% 

Network packet value correlation, affecting the Latency, Corruption, Reordering and Duplication.
For Latency, Corruption, Reordering and Duplication, the current packet n value will be correlated by this % to previous packet n-1 value. In other words, the current packet value is correlated to the previous packet value.

For example, if the correlation is defined to be 25%, the packet loss is 5%, and the previous packet was lost, then the updated packet loss value (for the current packet) would be 75% * 5% + 25%, which equals 28.75%. However, if the previous packet was not lost, then the packet loss value would be 75% * 5%, which equals 3.75%.

Blocked destinations

String

Network packet block, to specific destinations, defined by domain name, IP address, and IP range destinations in IP Prefix (Slash) notation.

Examples:

  • Domain name: www.google.com

  • IP address: 192.168.2.0

  • IP range destination: 192.168.2.0/24

To remove a network packet block, prefix the value with a '-'. For example: -www.google.com

Blocked ports

String

Network packet block, to specific ports. For example, to block http, define port number 80.

To remove a network packet block, prefix the value with a '-'. For example: -80

Generate HAR file

String

True | False

Indicates if a HTTP Archive (HAR) file should be generated to analyze the traffic of the virtual network.

Profile

String

2G GPRS Good | 2G GPRS Average | 2G GPRS Poor | 2G Edge Good | 2G Edge Average | 2G Edge Poor | 3G UMTS Good | 3G UMTS Poor | 3.5G HSPA Good | 3.5G HSPA Average | 3.5G HSPA Poor | 3.5G HSPA PLUS Good | 3.5G HSPA PLUS Average | 3.5G HSPA PLUS Poor | 4G LTE Good | 4G LTE Average | 4G LTE Poor | 4G LTE Advanced Good | 4G LTE Advanced Average | 4G LTE Advanced Poor | Bandwidth Good

Suggested network virtualization profiles. For the defined emulation values, see Network conditions for network virtualization.

Important: Specifying additional network virtualization parameters will override their values in the suggested profile.

Comment

String

  

Adds a comment to the script.

On-fail Result*

Condition

Ignore | Break | Continue | Abort | Catch

The behavior when the command fails.

* Mandatory parameter