Skip to content

VM Scale Booster Prerequisites

To install the Accops VM Scale Booster setup on a Windows desktop system, the following prerequisites must be fulfilled:

Hardware Requirements

Accops VM Scale Booster can be installed on Windows machines (physical or virtual) with the following minimum configuration:

Minimum Server Configurations:

  • Minimum 4 GB RAM

  • 2 vCPUs

  • 10 GB of free space on the installation disk for installation, dependencies, and post-installation management files.

Note

Actual server sizing should be determined by the anticipated user load and user profiles, including application types and browser instances.

Where to install VM Scale Booster

VM Scale Booster is typically deployed to reduce communication overhead with agents on desktop VMs; therefore, placing it on the same server as the Controller defeats its purpose. It is recommended to install it on a separate Windows server from the HyWorks Controller.

However, as needed for deployment, VM Scale Booster can still be deployed on HyWorks Controllers. When configuring VM Scale Booster settings, the load balancer must be placed in front of the message queues, and its address must be configured on the HyWorks Controller.

Supported Operating Systems

Accops VM Scale Booster works fine on all Windows servers that HyWorks Controller also supports.

Important Software Requirements (RabbitMQ)

Accops VM Scale Booster relies on RabbitMQ to support its features, such as desktop agents pushing updates to queues and directly to the HyWorks Controller database. This section will provide detailed information on installing and configuring RabbitMQ and its dependencies.

This section of the document provides the latest version(s) of RabbitMQ and Erlang OTP supported by HyWorks modules that require these components.

Important

RabbitMQ and Erlang/OTP

  • It is highly recommended to maintain the interoperability of RabbitMQ and Erlang/OTP as per recommendations. Refer Erlang Version Requirements | RabbitMQ for details.

  • Not all minor versions are being tested, and thus this is highly recommended to use the mentioned minor versions.

  • Please do check the EOL of RabbitMQ and supported Erlang/OTP versions.

  • Important for ASP.NET Core and Dot Net Desktop Runtime

  • Download and install the major version as recommended only. The highest minor version can be chosen. E.g., if the recommended version is v8.0., then use 8.0.x. Do not use 8.1.x* or greater.

  • The official site suggests installing the desktop runtime by default, which consists of .NET Runtime, and thus explicit installation of .NET Runtime should not be required.

v3.6 Series

Accops Module/ Release/Latest Version Compatible HyWorks Controller Latest Verified RabbitMQ and Erlang/OTP Version
[Recommended]		 ASP Dot Net Core and Dot Net Desktop Run Time Minimum Verified RabbitMQ and Erlang/OTP Version
[Supported but not recommended]
VM Scale Booster
v3.6.0.153
[v3.6-SP2]		 v3.6-SP2 and the latest available hot-fix (if any). RabbitMQ: 4.2.1: Download from here
Erlang/OTP: 27.3.4.6: Download from here		 Not required for VM Scale Booster. RabbitMQ: 3.13.6: Download from here
Erlang/OTP: 26.2.5.16: Download from here
Scheduler
v3.6.0.216
[v3.6-SP2]		 v3.6-SP2 and the latest available hot-fix (if any). RabbitMQ: 4.2.1: Download from here
Erlang/OTP: 27.3.4.6: Download from here		 ASP Dot Net Core 8.0.*
Dot Net Desktop Run Time 8.0.*: Download ASP.Net and .Net Desktop Runtime from here		 RabbitMQ: 3.13.6: Download from here
Erlang/OTP: 26.2.5.16: Download from here
Action Processor
v3.6.0.171
[v3.6-SP2]		 v3.6-SP2 and the latest available hot-fix (if any). RabbitMQ: 4.2.1: Download from here
Erlang/OTP: 27.3.4.6: Download from here		 ASP Dot Net Core 8.0.*
Dot Net Desktop Run Time 8.0.*: Download ASP.Net and .Net Desktop Runtime from here		 RabbitMQ: 3.13.6: Download from here
Erlang/OTP: 26.2.5.16: Download from here
Session Recording Manager Server
v3.6.0.79
[v3.6]		 v3.6-SP2 and the latest available hot-fix (if any). RabbitMQ: 4.2.1: Download from here
Erlang/OTP: 27.3.4.6: Download from here		 ASP Dot Net Core 8.0.*
Dot Net Desktop Run Time 8.0.*: Download ASP.Net and .Net Desktop Runtime from here		 RabbitMQ: 3.13.6: Download from here
Erlang/OTP: 26.2.5.16: Download from here
Policy Engine
v20250819T1700
[v3.6-SP1]		 v3.6-SP2 and the latest available hot-fix (if any). RabbitMQ: 4.2.1: Download from here
Erlang/OTP: 27.3.4.6: Download from here		 Not required for Policy Engine. RabbitMQ: 3.13.6: Download from here
Erlang/OTP: 26.2.5.16: Download from here

References:

  • Erlang/OTP and RabbitMQ Compatibility: https://www.rabbitmq.com/docs/which-erlang

  • Download links for RabbitMQ and Erlang/OTP Versions: See the tables above for official download links.

  • RabbitMQ Configuration Script: Required for configuring RabbitMQ to be used with HyWorks modules.

Erlang OTP Installation

Erlang OTP Installation Steps:

  1. Copy the setup file of the downloaded compatible version of Erlang (OTP).

  2. Log in to the server using user credentials that have local administrator privileges.

  3. Double-click the otp_win64_xx.x.x.exe (where xx.x.x is the version; the .exe name may differ), and install with the default selections.

  4. Select the installation location for ErlangOTP, then click Next.

  5. Click Install to start the installation.

  6. Once the installation is complete, click Finish to close the Erlang installation wizard.

  7. Reboot the system if required to complete the Erlang installation process.

Note

The exact version of Erlang (OTP) is required for the installation.

RabbitMQ Installation

RabbitMQ is used in HyWorks by several modules to send, receive, and manage messages to support multiple features, enabling various features, some of which are outlined below:

  • DVM Push: Desktop agents will push session events and heartbeats while the VM Scale Booster (Consumer service) updates the database, thereby reducing overhead on the HyWorks Controller.

  • HA Notify: The HyWorks Controller sends updates on the current high-availability status, including the active primary server, enabling modules to connect to the appropriate server.

  • Scheduler Action and Notification: The Scheduler and Action Processor components use message queues to perform scheduled actions and then send notifications to agents in sessions.

Note

The exact version of RabbitMQ is required for the installation.

RabbitMQ Installation Steps:

  1. Copy the setup file of the downloaded compatible version of the RabbitMQ server.

  2. Log in to the server using user credentials that have local administrator privileges.

  3. Double-click the rabbitmq-server-x.xx.x.exe (where x.xx.x is the version; the .exe name may differ) and proceed with installation.

  4. Select the install location folder and click Next.

  5. Once the installation is complete, confirm that the RabbitMQ service is installed properly and running.

  6. At this point, RabbitMQ, with its prerequisite Erlang OTP, will be ready.

  7. The next step is to configure the RabbitMQ service to enable it for other Accops modules such as VM Scale Booster, Scheduler, or Action Processor.

    1. Basic Configuration: To configure the basic RabbitMQ server, follow the RabbitMQ Server Configuration steps.

    2. Advanced Configuration: To perform advanced configurations, such as enabling SSL, changing the default port, upgrading, and enabling high availability, refer to the RabbitMQ Advanced Configurations section.

RabbitMQ Configurations

RabbitMQ is used in HyWorks by multiple modules to send, receive, and manage messages to support multiple features, some of which are mentioned below:

  • DVM Push: Desktop agents will push the session events and heartbeat and VM Scale Booster (Consumer service) pushes the updates to the database and thus reducing overhead on the HyWorks Controller.

  • HA Notify: HyWorks Controllers push the updates about current HA status e.g., current primary server and thus modules reading this can connect to correct primary server.

  • Schedule Action and Notification: Scheduler, Action Processor components use message queues for performing scheduled actions and then send notifications to agents in the sessions.

Understanding the importance of RabbitMQ in HyWorks deployments, this section will provide detailed information on RabbitMQ configurations(assuming installation is already completed):

RabbitMQ Server Configuration

RabbitMQ settings require modification after installation. A configuration script is provided and needed to execute the following necessary tasks:

  • Create a user in RabbitMQ: This user account will be configured in RabbitMQ to communicate with RabbitMQ from external hosts. A default user will not be allowed to connect other than localhost.

  • Set the Erlang cookie so that the RabbitMQ command works correctly.

  • Configuring some plugins and timestamp settings.

Steps to run RabbitMQ Configuration Script:

Follow the steps below to configure the RabbitMQ server for use with HyWorks components:

  1. Log in to the server using user credentials that have administrator privileges.

  2. Make sure the exact versions of Erlang OTP (Prerequisite for RabbitMQ) and RabbitMQ are already installed on the server.

  3. Make sure that the RabbitMQ service is running after the installation is complete.

  4. Run the ConfigureRabbitMQ.bat with admin privileges. Refer to this download link of the Configuration Script for RabbitMQ v3.13.

    1. It will ask you to enter the username and password to configure RabbitMQ.

    2. Enter the username and password, and remember these details. This information needs to be configured in the HyWorks components that use RabbitMQ.

  5. RabbitMQ is ready to be configured into the Accops HyWorks Controller and other components.

    1. This is a non-SSL configuration on port 5672.

    2. Refer to the RabbitMQ Advance Configurations section to configure RabbitMQ for SSL communication.

At this point, the server is ready and has the prerequisites to install VM Scale Booster.