EV Observe - Synthetic Monitoring Module - Install Load Testing Features

Last modified on 2023/09/28 16:54

   Only the specificities of the load testing features and the differences with the Scripts Manager tool installation will be described.
    Open url.png See the Scripts Manager tool installation

In general, the algorithms used to record and replay scenarios are identical for the Scripts Manager tool and the load testing features, as well as security requirements.

The essential differences are on:

  • The Injector: Windows 2008 R2 with Terminal Services required.
  • The LaunchPad: The utility for lauching multiple RDP sessions.
  • The Viewer: The utility for managing RDP sessions.
  • Real-time graphs: Interfacing with Microsoft Performance Monitor and/or Perlogs, the tool of the Synthetic Monitoring module.

Terminal Server installation

Installing Microsoft Terminal Services (Windows 2008 R2)

The Terminal Services installation allows you to configure the Injectors.

  • Multiple RDP sessions (Remote Desktop Protocol) can be launched on each Injector, simulating a virtual user.
  • The client application is installed on each RDP session. It is handled by the remote client as if the environment was that of a standard user of the machine.
     

1. Go to the control panel of the server.

          Terminal Servers installation.png

2. Click Add roles, then follow the instructions for installation.

  • Select roles you want to install on the server.
  • Specifiy the authentication for the Host service.
  • Specifiy the license mode and select the 120-day temporary license.

3. Click Install.

4. Once the installation is complete, click Close.

The server will reboot.

Installing applications on Terminal Services

1. Open the command prompt, then type the following command.

change user/install

2. Launch the application setup on Terminal Services, then follow the instructions.

3. Once the installation is complete, open the command prompt, then type the following command.

change user

Load testing feature installation

The Injectors

Installing an Injector

1. Open the command prompt, then type the following command.

change user/install

Once the installation is complete, the Machine configuration window will appear.

          Installing injector - Machine configuration.png

2. Configure the Injector.

  • Select the Child machine of... option, then specify the IP address of the Parent machine.
  • Check the AppsLoad and Autologout boxes.
  • Click Validate.

Once the installation is complete, let the Agent finish configuring and adding to the Console.

3. Check that the Injector is successfully added.

  • You will find the icon in the Systray.
             Systray icon bar.png
  • You will find the Injector in the Console.
             Installing injector - Injector in Console.png

Adding users

You must create accounts from AD users or local so that you can open multiple sessions directly on the Injector. Open sessions can all have the same or different credentials.

Best Practice icon.png  Use the same credentials for all sessions opened on the Injector. The session initialization will be simpler and will be made once (initialization of the connection, the browser, etc.).

1. Initialize the RDP sessions on the Injector.

  • Open the Windows Registry Editor, Regedit, then:
    • Search for the HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TerminalServer key.
    • Set the value 1 to the fSingleSessionPerUser entry.
    • Click OK.
  • If you use different credentials for all sessions, you must perform this initialization in each session.
  • If you use the same credentials for all sessions, configure the RDP or RDS by disabling the Restrict users to a single session option.
     

   You may encounter an error of encryptions when you connect to the Citrix server (receiver 4.2 and higher). To correct this problem, add a complementary entry in the Registry editor, as described below.

     Open url.png See the article on Citrix website.

For 32-bit machines

  • Search for the HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client key.
  • Add an VdLoadUnLoadTimeOut entry.
  • Select REG_DWORD type.
  • Enter any value in seconds.

For 64-bit machines

  • Search for the HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432node\Citrix\ICA customer key.
  • Add an VdLoadUnLoadTimeOut entry.
  • Select REG_DWORD type.
  • Enter any value in seconds.

2. Specify the credentials used to open RDP sessions.

  • Launch the Console from the Systray. Open url.png See the procedure.
             Console from Systray.png

Credentials for a single user

  • Click Console - Add user icon.png in the Users Properties section.
  • Specify the domain, name and password for the user in the Windows Sessions section.
  • Click Validate.
     

Credentials for multiple users
         Installing injector - Add multiple users.png

  • Enter root as user name in the Windows Sessions section.
    System-generated users will be created by adding root as an increment: root1, root2, etc.
  • Specify the domain and password for the users to be created.
  • Click Validate.
  • Checked the Create Multiple Users box, then enter the number of users to create.
  • Click OK.
    The number of users will be created. The associated password will be defined.
  • Go to the LaunchPad utility to view generated users.

Configuring RDP sessions in the LaunchPad utility

The LaunchPad utility allows you to open multiple RDP sessions on an Injector, defining the session resolution and username/password for each one.

   You must repeat the procedure below on each Injector.

1. Open the LaunchPad utility from the Start menu > Itexis > Tools_LauncherRDP.

2. Go to the RDP Sessions > Settings menu.

          LaunchPad - RDP Sessions.png

The Configuration window will open.
         LaunchPad - Configuration.png

3. Configure the RDP sessions.

  • Delay (s): Define the period between session openings.
  • Select the session resolution.
  • Select user names authorized to open RDP sessions.

4. Click Save config to file, then specify the file name.

The new session configuration will appear in the menu.

5. From the RDP Sessions menu, you can directly launch the RDP sessions, edit the configuration for any changes or remove the configuration.

          LaunchPad - RDP Sessions menu.png
  

Description of the other menus of the LaunchPad utility

  • Tasks: Allows to create and launch tasks.
  • Search User: Allows to find a specific user's session.
  • Tools: Allows to access the real time graphs.
  • Display Choices: Allows to view the sessions of a particular Injector, if the LaunchPad brings together several Injectors.
  • Organize Windows: Allows to choice on how sessions are displayed on the screen.
             LaunchPad - Organize Windows menu.png

Best Practice icon.png  Use the RDP Smart Size option to set a full-screen viewing format for sessions that adapts automatically.

Configuring RDP sessions recording

1. Right-click on the Systray icon Systray icon - Synthetic Monitoring - xSession on.png.

          Systray icon bar.png

2. Check the Session with Recorder option in the menu if it is not already active, then restart the session via the LaunchPad utility.

          Session with Recorder option in Systray menu.png

   The procedure will modify an entry in the Windows Registry editor (Regedit) for the current user.

Configuring Internet Explorer (IE)

1. Launch the IE setup, then follow the instructions.

2. Once the installation is complete, configure the IE options.

  • Go to the Advanced tab, then:
    • Uncheck the Enable automatic recovery after blocking box.
    • Check the Remove the automatic locking of the RDP sessions box.
  • Click Apply.

The LaunchPad utility

The LaunchPad utility allows you to open multiple RDP sessions on an Injector, defining the session resolution and username/password for each one.

Installing the LaunchPad utility

1. Open the LaunchPad utility from the Start menu > Itexis > LaunchPad.

          LaunchPad.png

2. Click Configuration.

The list of users declared in the Console and the key associated to every user machine will appear.
         LaunchPad - Configuration users.png

3. Create a template to save a configuration for opening RDP sessions. 

example  Save the configuration for 2 sessions open for user1 on M1-2 and M1-5 servers (Injectors) with a resolution 1280 x 1024 32bits.

  • Select the resolution.
  • Select the authorized users you want to add to the template of RDP sessions.
  • Click Save config to file, then specify the file name.

Best Practice icon.png  By default, the configuration file is named using the resolution of RDP sessions.

3. Click Connect.

Adding a local task

Local tasks are tasks for a specific Injector. They are configured from the LaunchPad utility of the Injector.

1. Open the LaunchPad from the Start menu > Itexis > LaunchPad.

2. Go to the Tasks > Add Task menu.

          LaunchPad - Add task.png

  • Enter the name of the task, then click OK.
  • Specify the other parameters of the task.
    • Select the scenario to play by the task in the Execute area.
    • Indicate the number of consecutive iterations.
    • Set the GlobalDataset option to False.

3. Click Validate.

Adding a global task

Global tasks are tasks for all Injectors. They allow to share a set of variables and scenarios with all Injectors. They are configured from the Console on the Master machine.

1. Launch the Console from the Systray on the Master machine. Open url.png See the procedure.

2. Go to the Jobs menu, then to the Tasks tab.

          LaunchPad - Global tasks.png

3. Click Add Task.

          LaunchPad - Add global task.png

  • Enter the name of the task, then click OK.
  • Specify the other parameters of the task.
    • Select the scenario to play by the task in the Execute area.
    • Indicate the number of consecutive iterations.
    • Set the GlobalDataset option to True.

4. Click Validate.

5. Click Send Selected Task(s) for broadcasting the task on all Injectors.

The task will appear on each Injector with the mention SHRD (shared).
         LaunchPad - Global task added.png

   If one of the scenarios to be played is not present on an Injector, an alert will appear on the screen.

          LaunchPad - Global task error.png

The Viewer

The Viewer allows you to have a complete view of all the RDP sessions open on Injectors and control load tests by launching the different scenarios.

     Open url.png See the documentation

Real-time graphs

During load tests, real-time statistical counters can be generated, and can be viewed from:

  • Perlogs, the real-time integrated graph tool of the Synthetic Monitoring module: It allows you to view the load testing counters of the Synthetic Monitoring module.
        Open url.png See the description of the counters
  • Microsoft Performance Monitor: It allows you to view the load testing counters of the Synthetic Monitoring module and other counters that you find interesting to track graphically such as CPU or memory.
     

in both cases, you must first create dedicated counters from the Scripts Manager tool.

Creating the real-time statistical counters

1. Launch the Scripts Manager tool from the Master machine (M1).

2. Go to the Console > AppsLoad menu.

3. Click Create Counters.

Adding the real-time statistical counters in Microsoft Performance Monitor

1. Launch Microsoft Performance Monitor.

2. Go to the Performance > Monitoring Tools > Performance Monitor menu, then click the + icon.

3. Add the counters created from the Scripts Manager tool.

A graph with real-time statistical counters will display.

Best Practice icon.png  You can also add system counters of target servers and correlate the impact of load on application servers in real-time.

4. Create a custom data collector set to capture performance metrics and save them into a CSV file so that you can import them in Excel.

     Open url.png See the Microsoft documentation

  • Go to the Performance > Data Collector Sets > User Defined menu, then select New.
  • Name the new collector, then select the Create manually (Advanced) option.
  • Select the Create Data Logs option, then check the Performance Counter box.
  • Specify the counter interval rate (the number of times the selected data must be captured).
  • Click Add.
    • Select the real-time statistical counters.
    • Select target counters to browse and find the machine.
    • Select other counters such as CPU or memory.
    • Click Add.
  • Specify the name of the CSV file to save the collected data.
  • Select the user who will run the data collector set.
  • Click Finish.
    The new data collector set will appear in the menu. The collector is ready to capture the real-time statistical counters.
  • Complete the configuration of the CSV log file.
    • Right-click to the new collector, then select the Properties option from the menu.
    • Select the With a comma separator option.

5. Start recording logs.

  • Right-click to the new collector, then select the Start option from the menu.
    The CSV file containing information that was collected by the collector will be generated.

6. Import the CSV file in Excel, then build graphs.

Viewing graphs from Perlogs

     Open url.png See the description of the graphs

Tags:
Powered by XWiki © EasyVista 2024