Skip to main content

VMware Windows Network Loss

VMware Windows Network Loss simulates a network loss scenario on Windows OS based VMware VM.

  • It checks the performance of the application running on the VMware Windows VMs under network loss conditions.

VMware Windows Network Loss

Use cases

  • VMware Windows Network Loss determines the resilience of an application when a network loss scenario is simulated on a VMware Windows virtual machine.
  • VMware Windows Network Loss simulates the situation of network loss for processes running on the application, which degrades their performance.
  • It also helps verify the application's ability to handle network failures and its failover mechanisms.

Prerequisites

  • Kubernetes > 1.16 is required to execute this fault.

  • Execution plane should be connected to vCenter and host vCenter on port 443.

  • VMware tool should be installed on the target VM with remote execution enabled.

  • Adequate vCenter permissions should be provided to access the hosts and the VMs.

  • The VM should be in a healthy state before and after injecting chaos.

  • Kubernetes secret has to be created that has the Vcenter credentials in the CHAOS_NAMESPACE.

  • Verify clumsy is installed on the VM, as it's essential for this experiment.

  • Run the fault with a user possessing admin rights, preferably the built-in Administrator, to guarantee permissions for memory stress testing. See how to enable the built-in Administrator in Windows.

  • VM credentials can be passed as secrets or as a chaos enginer environment variable.

apiVersion: v1
kind: Secret
metadata:
name: vcenter-secret
namespace: litmus
type: Opaque
stringData:
VCENTERSERVER: XXXXXXXXXXX
VCENTERUSER: XXXXXXXXXXXXX
VCENTERPASS: XXXXXXXXXXXXX

Mandatory tunables

Tunable Description Notes
VM_NAME Name of the target VM. For example, win-vm-1
VM_USER_NAME Username of the target VM. For example, vm-user.
VM_PASSWORD User password for the target VM. For example, 1234. Note: You can take the password from secret as well.

Optional tunables

Tunable Description Notes
DESTINATION_HOSTS Comma-separated list of destination hosts to induce loss. For example, github.com,harness.io. For more information, go to destination hosts.
DESTINATION_IPS Comma-separated list of destination IPs to induce loss. For example, 10.0.0.1,10.0.0.2. For more information, go to destination IPs.
NETWORK_PACKET_LOSS_PERCENTAGE Percentage of network packets to lose. Default: 100. For more information, go to network packet loss percentage.
PATH_OF_CLUMSY Path of the Clumsy tool in the VM. For example, C:\Program Files\Clumsy\. For more information, go to path of Clumsy.
TOTAL_CHAOS_DURATION Duration that you specify, through which chaos is injected into the target resource (in seconds). Default: 60 s. For more information, go to duration of the chaos.
RAMP_TIME Period to wait before and after injecting chaos (in seconds). Default: 0 s. For more information, go to ramp time.
SEQUENCE Sequence of chaos execution for multiple instances. Default: parallel. Supports serial and parallel sequence. For more information, go to sequence of chaos execution.
DEFAULT_HEALTH_CHECKDetermines if you wish to run the default health check which is present inside the fault. Default: 'true'. For more information, go to default health check.

Destination hosts

The DESTINATION_HOSTS environment variable specifies the destination hosts to induce loss on the target Windows VM.

Use the following example to specify destination hosts:

apiVersion: litmuschaos.io/v1alpha1
kind: ChaosEngine
metadata:
name: engine-nginx
spec:
engineState: "active"
chaosServiceAccount: litmus-admin
experiments:
- name: vmware-windows-network-loss
spec:
components:
env:
# Name of the VM
- name: VM_NAME
value: 'test-vm-01'
# Destination hosts to induce loss
- name: DESTINATION_HOSTS
value: 'github.com'

Destination IPs

The DESTINATION_IPS environment variable specifies the destination IPs to induce loss on the target Windows VM.

Use the following example to specify destination IPs:

apiVersion: litmuschaos.io/v1alpha1
kind: ChaosEngine
metadata:
name: engine-nginx
spec:
engineState: "active"
chaosServiceAccount: litmus-admin
experiments:
- name: vmware-windows-network-loss
spec:
components:
env:
# Name of the VM
- name: VM_NAME
value: 'test-vm-01'
# Destination IPs to induce loss
- name: DESTINATION_IPS
value: '10.0.0.1,10.0.0.2'

Network packet loss percentage

The NETWORK_PACKET_LOSS_PERCENTAGE environment variable specifies the percentage of network packets to lose.

Use the following example to specify network packet loss percentage:

apiVersion: litmuschaos.io/v1alpha1
kind: ChaosEngine
metadata:
name: engine-nginx
spec:
engineState: "active"
chaosServiceAccount: litmus-admin
experiments:
- name: vmware-windows-network-loss
spec:
components:
env:
# Name of the VM
- name: VM_NAME
value: 'test-vm-01'
# Percentage of network packets to lose
- name: NETWORK_PACKET_LOSS_PERCENTAGE
value: '100'

Path of Clumsy

The PATH_OF_CLUMSY environment variable specifies the path of the Clumsy tool in the VM.

Use the following example to specify the path of Clumsy:

apiVersion: litmuschaos.io/v1alpha1
kind: ChaosEngine
metadata:
name: engine-nginx
spec:
engineState: "active"
chaosServiceAccount: litmus-admin
experiments:
- name: vmware-windows-network-loss
spec:
components:
env:
# Name of the VM
- name: VM_NAME
value: 'test-vm-01'
# Path of the Clumsy tool in the VM
- name: PATH_OF_CLUMSY
value: 'C:\\Program Files\\Clumsy\\'