Changing RAM

Optimizing vScope’s performance might require updating the RAM allocation settings. The initial RAM setting is configured during installation, and it determines the amount of system RAM vScope is permitted to use. Allocating additional RAM can enhance performance, but ensure you leave sufficient RAM for other system processes. Never allocate all available system RAM to vScope.

Windows installations

These steps apply to the Windows installation, where the heap is set by the installer and stored in the registry. On Linux, Docker, and Kubernetes the maximum heap is set through JAVA_OPTS instead — see Installation.

---

RAM for Optimal Performance

Total Server RAM	vScope Allocation
16 GB	8 GB
24 GB	16 GB
48 GB	31 GB

These match the tiers in System Requirements. Allocations stop at 31 GB on purpose: past about 32 GB, Java switches to a less efficient way of addressing memory, so vScope fits less data in more RAM.

---

Method 1: Updating RAM via Installer

1. Stop the vScope Service
2. Download and run the latest vScope installer.
3. Choose Advanced Installation by unchecking “Express Installation.”
4. Under vScope Core Settings, set the dedicated RAM.
5. Complete the installation and ensure the data directories align with your current installation settings.
6. Restart the vScope Service.

---

Method 2: Adjusting RAM via Windows Registry

1. Stop the vScope Service
2. Open regedit.exe and navigate to: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\vScopeServer\Parameters\Java
3. Right-click the key named Options and select Modify…
4. You’ll see a value containing the maximum heap setting, for example: -Xmx4096m
5. To change the RAM allocation, modify the -Xmx value. For example, to increase from 4 GB to 8 GB, change it to: -Xmx8192m Leave any other options in the key unchanged.
6. Click OK, exit regedit, and restart the vScope service. vScope will now use the updated RAM setting.