Installing, Activating, and Removing the Operavix Application on Windows

Installing the Distribution Package

The distribution package of the Operavix application is an executable .exe file. To begin the installation, run the provided file on the required server with local administrator rights. The application installer window will open.

Click Install. During the installation process, you may be prompted to create an allowing rule for Windows Firewall. Allow its creation, and after the installation process is complete, click Done.

The application will start automatically after installation and each time the PC is started. You can Stop/Restart the application by disabling the service. The name of the service is "Operavix". You can also disable the automatic startup of the application through the "Services" snap-in.

Fill in the following fields:

• First name
• Last name
• Username
• Email
• Password
• System language

Click Apply and log in. This information will be used for the initial administrator login to the system's web interface.

Configuring the Application Web Server to Use the Secure HTTPS Protocol

After installing the application, the system's web interface and data transmission from monitoring agents use the HTTP protocol. To configure data transmission using the secure HTTPS protocol:

1. Prepare an SSL certificate and private key for the server on which the application is installed in the form of a PFX file. It is acceptable for the PFX file to also include certification authority certificates. It is important that this server certificate is trusted on the computers where the monitoring agents will be installed and where the web interface will be accessed. To get the certificate, we recommend contacting the Public Key Infrastructure (PKI) administrators in your company.
2. On the server, stop the "Operavix" service (Win+R > services.msc > right-click on "Operavix" > Stop).
3. Open a text editor, such as "Notepad", with administrator privileges and edit the application web server configuration file C:\ProgramData\Operavix\config\com.operavix.subsystem.frontend.json. We recommend making a backup copy of the file before editing. Make the following changes to the file:
   • "protocol":"https" – use of the HTTPS
   • "port":443 – specify the port for the web server
   • "ssl_cert_store_password":"password" – password for the PFX file. If the password is empty, specify ""
   • "ssl_cert_store":"C:\ProgramData\Operavix\certs\file.pfx" – the path to the PFX file. Backslashes must be escaped with another backslash
   • "url" – this parameter is not used in current versions and can be left unchanged
   Save the file.
4. Start the "Operavix" service. Check the availability of the web server using the HTTPS protocol on the specified port. If there are issues after starting, refer to the log at C:\ProgramData\Operavix\logs\main.log.

To change the application web server address in an already installed monitoring agent, you can:

• Use the utility C:\Program Files\OperavixAgent\agent_configurator.exe included in the agent installation
• Edit the agent configuration file C:\ProgramData\OperavixAgent\settings.cfg and restart the computer or the application service

Specifying the Available Memory for the Operavix Application

The maximum amount of server RAM that Operavix application can use is strictly defined in the service startup parameters.

To change the allocated amount of RAM for the Operavix service:

1. Stop the Operavix service.
2. Open the Registry editor with administrator rights.
3. In the Registry editor, navigate to Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Operavix.
4. Double-click on "ImagePath".
5. In the "Value Data" field, change -Xmx2G to the desired value in gigabytes (for example, -Xmx8G).
6. Save the changes and restart the Operavix service using the Services snap-in or Task Manager.

Removing the Operavix Application

To remove the Operavix application:

1. Run the uninstall.exe file on the server where it is installed. By default, the file is located at C:\Program Files\Operavix\uninstall.exe.
2. A window will open with a prompt to uninstall the program.
3. Click Remove.

System and Installer Logs

• The default location for the Operavix service log is C:\ProgramData\Operavix\logs\main.log;
• The installation process log is saved in the %TMP% directory of the user session in which the installation/update process was initiated. By default, it is stored in C:\Users%USERNAME%\AppData\Local\Temp\operavix_stdout.log.