Manual

 

Manual version 1.4.2

September 2018

Introduction

Short description

Long description

Use cases

Company information

Features

Requirements

VDI Drones has been tested to work with:

Introduction

The Drone itself, creates the load

The Drone Controller, deploys and runs the Drones

Quickstart

Firewall ports

Deployment considerations

Installation

The Controller

1. Welcome

2. Settings

3. Operation

4. Report

5. About

Getting a license

Logging

Troubleshooting / Error messages

Appendix 1

Version history

Version 1.4.2 – 15-9-2018

Version 1.4.1 – 10-8-2018

General Disclaimer and Copyright Notice

Disclaimer

Copyright Notice

Introduction

Short description

-Benchmark software for large computer environments.

-Create CPU, Memory and I/O load on a large number of computers and find out how they perform under load.

-VDI Drones is a synthetic load generator for a large number of computers/servers.

Long description

Do you want to benchmark a large number of computers or server? VDI Drones is a Windows Forms application and lets you specify and start a CPU, Memory and Disk load on multiple machines at once. This is especially suited for benchmarking a large group of virtual machines under a hypervisor in VDI/SBC/DaaS situations. You can specify precisely how heavy the load should be in terms of threads, CPU, memory and disk.

Use cases

  • Verification of new infrastructure.
  • Measure impact of changes.
  • Testing of hotfixes and service packs, like Meltdown and Spectre.
  • Burn-in testing of new hardware.

Company information

VDI drones is een geregistreerd handelsmerk in de Benelux en maakt deel uit van Gourami B.V. en is geregistreerd in de Kamer van Koophandel onder nummer: 62817388

VDI drones is a registered trademark in the Benelux and is part of Gourami B.V. registered at the Dutch Chamber of Commerce under number: 62817388

More information on Gourami B.V. visit: https://www.gourami.eu

Features

  • Enables load generation on a large number of machines.
  • Easy to use GUI, no scripting skills needed.
  • No need to setup hundreds of user accounts.
  • Specify the workload in detail, in terms of threads, CPU, Memory and Disk I/O.
  • Integrates with your Microsoft Active Directory.
  • Works on all major hypervisors: VMware, Hyper-V, XenServer, Nutanix and Microsoft. Azure.
  • Competitively priced licensing model.
  • Available as a portable .exe, installation not required.
  • No client side software installation required.

Requirements

  • .NET Framework 4.0 or newer.
  • Active Directory.
  • 2 GB of RAM.
  • A domain-joined computer to run the Controller.
  • A domain-joined computer to run the Drone.
  • Virtual installation fully supported: Hyper-V, VMWare, AWS, Azure, Nutanix or XenServer.
  • Possibility to access the RPC$ and do WMI queries from the Controller to the Drones (firewall rules and rights).
  • Administrative rights on both the Controller and every Drone.

VDI Drones has been tested to work with:

  • Windows 2008, 2012, 2016, 7 and 10.
  • VMWare.
  • Citrix and XenServer, XenApp and XenDesktop.
  • Hyper-V.
  • Microsoft Active Directory (functional level 2008 and up).

Introduction

VDI Drones consists of two main components:

The Drone itself, creates the load

The Drone Controller, deploys and runs the Drones

Quickstart

The process of creating load on your environment is divided in these steps;

  1. Acquire the software and licenses, and determine one machine to run the controller software on.
  2. Go to the folder where you copied or installed VDI drones. Run the drone.exe software to create a load profile. A standard profile creates a default load on one thread representing one user. These settings are saved in a .cfg file, right next to the .exe files.
  3. Run the controller software while logged in the domain with administrative credentials, and select the machines you want to create a load on from active directory.
  4. If you also want to keep an eye on several key servers in your infrastructure you can add them from active directory as a monitoring machine. For example Citrix provisioning servers, file servers or active directory servers.
  5. Start the load on the selected drones and see how your infrastructure holds.

Firewall ports

From the Controller to any Watchers the following needs to be open for WMI/remote performance counters;

  • ICMP echo/Ping
  • TCP 135
  • TCP 445
  • Dynamic ports from 49152 to 65535 TCP

From the Controller to any drone the following needs to be open for WMI/file copy over RPC;

  • ICMP echo/Ping
  • 135 TCP/UDP
  • 137 TCP
  • 137 UDP
  • 138 UDP
  • 139 TCP
  • 445 TCP
  • Dynamic ports from 49152 to 65535 TCP

From the Controller to any domain controllers;

  • LDAP and kerberos ports

Deployment considerations

  • You could run the drone controller from any machine in your domain, but keep the open firewall ports in mind. Therefor it is advisable to run it from a machine where you can easily reach the Drones you want to put under load. Typically this could be on a management server.
  • Preferably you should not run the Controller on the same hypervisor you want to load test.
  • You are limited to 15 Watchers, so don’t try to ‘watch’ every system you put a load on. Only monitor key servers.

Installation

VDI Drones, the Controller and the Drone itself don’t have to be installed. They are portable, just keep in mind to keep them in one folder at all times. The controller expects the drone executable and the config file to be in the same folder.

The Controller

The Controller has five tabs:

  1. Welcome, shows the disclaimer and copyright information.
  2. Settings, where you can change settings.
  3. Operation, where you can control your drones.
  4. Report, where you can find your performance report.
  5. About / Licensing, where you can add license codes and see versioning information.

1. Welcome

In this tab of the configuration tool you can find a link to the manuals, as well as the General Disclaimer and Copyright notice.

2. Settings

In the settings tab of the Drone Controller you can

  1. add domain computers as a drone,
  2. add domain computers as watcher,
  3. customize the startup command,
  4. customize the destination folder,
  5. have the drone controller write it’s log to a file,
  6. or customize the appearance.

To add domain computer as a Drone, make sure that you are logged on to the domain and enter a computer name prefix in the text box and press the server button.

Check one or more computers from the search result and add them as a Drone or a Watcher;

You can configure up to 15 Watchers. When adding a computer as a Watcher, the Controller tries to reach the machine using a WMI ping, if this fails, you will see a message in the event log;

3. Operation

When you have successfully added a Drone or Watcher to the Controller, you will see them in the Operation tab;

Select one or more Drones, and right-click on them, a context menu appears giving you four options with the Drone;

  1. Install and Run
  2. Stop and Uninstall
  3. Reboot
  4. Shutdown

Install and Run will copy the drone to the selected computers and the selected path, see the settings tab. Once the files are copied, the Drone Controller will attempt to start the Drone.

Stop and uninstall will stop the Drone process on the selected machines and will delete the files if present.

Reboot will reboot the selected computers.

Shutdown will power off the selected computers.

4. Report

This tab will contain the report of the operations. The save button saves the HTML formatted report in the ‘My Documents’ folder.

The report contains an overview of the load profile used and the time graphs;

By default, a snapshot of all systems you monitor is also included every 15 minutes;

The automatic report runs until you stop and uninstall the Drones.

5. About

Here you can find your license information and configuration, as well versioning information about VDI Drones.

Getting a license

First go to https://vdidrones.com/license/ and download the license tool;

Run the license tool while logged on to the Microsoft Active Directory Domain where you want to use VDI drones in the future. Now, run the license tool;

Depending on your environment this can take a few minutes.

Copy and paste the text from the license tool into the website at https://vdidrones.com/license/

You will received a quote based on your domain tier. The received license code will look a lot like this;

/s2JcOmWJaCsnq1Q84z5u8B2Ji2UVMtB7pmrKFA9BcdM2fzpCAV8WY1wEgpkIXl/XRdi4pxRkSJsQQr3HN+chDB6RmDJ+eanrFyFHtz1kCipMvYD39HwGBgbOnRnvx5QLi5IrMk3LwKYJaUS5iyz7r5G88dXBSq2LMREV0ldd7Hew//nv4rgTg+PxUZjEPCTG8Wkb3fp30ldDVClWS8P1jfZ9/DBiSGAbkQKeZa9xLvLKck6aW8ugvVyl6hzt//g9/7RvD9vktEEYIz1FhlxNNVjMhitBLCh8Q6A2jjIup/lzJO4BgR0sSCF7kMJnRmUkW71LkpEswZrDsAzEwvoqf8ELgb77fJLNQYwhhCKQjlmYrOmfkAC6bWcLR6hyZ46bmsEO033EXCHalgyaJMh7JuHgmMztx4wmkSb2JuaOPHNUwCHdBvLTGw4JZzHJZnFDWL/K6zc8ugnZcFN7alUUD4zwk3DtA5MDpDQzBDMHImmrcRLxt9yAYW5V1NnbOWK

Paste this code into the About tab in the Drone Controller and restart the controller software;

 

Logging

VDI Drones has two types of logs;

  1. General log
  2. Drone-specific log

The general log contains information for the Controller in general, while in the specific log only Drone-specific log information is found;

What is logged depends on the ‘verbose logging’ setting in the ‘Settings’ tab;

Troubleshooting / Error messages

Message/symptoms: Cannot connect to a drone with WMI.

Cause: WMI is disabled on destination system

You can check this by issuing the following command in the CLI of windows;

If the shares don’t show as above on the Drone system, something is wrong/disabled.

Solution:

If these shares are not listed, use the net share command to create them. For detailed

help for net share, enter: net share /?. Consult Microsoft documentation for details.

Appendix 1

Version history

Version 1.4.2 – 15-9-2018

Features:

  • Verbose logging
  • Fixed watcher BGW timer to 1 second precise
  • PQL processor queue length is also monitored
  • A full history report is added to the HTML report as a ChartJS

Fixes:

  • Spelling and typos
  • Added limit (15) to amount of Watchers for performance reasons

Version 1.4.1 – 10-8-2018

Features:

  • Initial public release

Fixes:

  • None

General Disclaimer and Copyright Notice

Disclaimer

Whilst every care has been taken by Gourami Software to ensure that the information contained in this document is correct and complete, it is possible that this is not the case. Gourami Software provides the information “as is”, without any warranty for its soundness, suitability for a different purpose or otherwise. To the maximum extent permitted by applicable law, Gourami Software is not liable for any damage which has occurred or may occur as a result of or in any respect related to the use of this information. Gourami Software may change or terminate this document at any time without further notice and shall not be responsible for any consequence(s) arising therefrom. Subject to this disclaimer, Gourami is not responsible for any contributions by third parties to this information.

Copyright Notice

Copyright © on software and all Materials 1998-2018 Gourami Software. Gourami and the VDI Drones Logo are either registered trademarks or service marks of Gourami in Benelux, the United States and other countries. All other product and company names mentioned may be trademarks and/or service marks of their respective owners.

 

 

Downloadable version here