Simple tutorial on how to install an OctoPerf on premises agent on windows. runtime , on-premise , windows , docker , kitematic , virtual-box , monitoring , agent , mac-os , linux https://octoperf.com/blog/2016/02/25/octoperf-on-premises-windows/ OctoPerf ZI Les Paluds, 276 Avenue du Douard, 13400 Aubagne, France +334 42 84 12 59 contact@octoperf.com Devops 545 2021-01-04

Installing an on premises agent step by step on windows

OctoPerf is JMeter on steroids!
Schedule a Demo

Intro

To allow our users to install a local agent and run tests on their private web applications we decided to rely on docker. While Docker is pretty straightforward to install on linux, using it on windows (or Mac through GUI) might prove a bit more complex. That’s why we created this tutorial, there you will find all the steps to install Kitematic and run an OctoPerf On Premises agent.

Docker toolbox

The very first step is to get the docker toolbox for windows or Mac, you get it from one of the following websites:

Then follow the installation procedure:

Setup
You will probably be asked for several drivers to install, that’s because Kitematic is build on top of VirtualBox. Just allow them all to finish the installation process.

Running Kitematic and VirtualBox for the first time

Now that the installation process is over, just run Kitematic from the shortcut:

Shortcut

You will get to this screen:

StartVM
Note that you might have to activate virtualization (VT-x or AMD-V) in the BIOS of your computer as with any other virtualization software.

Once the VM starts, you will see the login screen:

Login

Create or use your existing account and after login you will get inside kitematic:

Main

Quick word about VirtualBox

Before moving on to the OctoPerf installation, note that if it is not clear at this point, the virtualization is made through VirtualBox. Thus, any operation on the virtual machine must be done in VirtualBox itself.

For instance, by default the VM only uses 2 GB of memory.

To run more virtual users, you might need to increase that. To do so, you must edit the configuration of the VM in VirtualBox.

First, launch the VirtualBox interface. Docker Toolbox should have a placed a shortcut for VirtualBox on your desktop.

Else, you should find it in ‘C:\Program Files\Oracle\VirtualBox\VirtualBox.exe’

Now to edit the memory settings we will have to stop the VM:

StopVM

Then right click and go to settings:

Settings

In the system section, you can edit the amount of memory the VM is allowed to use:

Memory Settings

Congrats, it’s all done, you can quit VirtualBox. Next time you start Kitematic, the virtual machine will be started again with your new settings.

Installing OctoPerf agent

The next steps are already covered by a previous blog post. Also, the video in the next section covers the same procedure than this section, so feel free to go have a look instead.

Once you created your provider in OctoPerf you get a command line that you need to copy paste:

Command Line

To do so, in Kitematic, click the bottom left button ‘DOCKER CLI’:

Docker CLI

This wil open a powershell window in which you can copy paste this command line. Carefull though, you must remove the ‘SUDO’ at the beginning of this command because it was meant for linux:

PowerShell

When you launch it, the first automatic step will be the download of Rancher:

PowerShellRancher

When done, you will automatically see 3 containers in Kitematic, 2 stopped and 1 launched:

Containers

This means that the installation was successful, back in OctoPerf you should see the machine appear when you select the right provider:

Providers

You can now run your tests using this machine!

Userload

Video

In case you feel more comfortable looking at a video tutorial, you can find it here:

On premises
Installing an on premises agent step by step on windows
Tags:
Share:

Be the first to comment

Thank you

Your comment has been submitted and will be published once it has been approved.

OK

OOPS!

Your post has failed. Please return to the page and try again. Thank You!

OK

Want to become a super load tester?
OctoPerf Superman