Tools
Increase the Java Virtual Machine (JVM) memory on Web Help Desk
This article describes how to increase the Java Virtual Machine (JVM) Memory allocation for your Web Help Desk deployment.
First published date
Last published date
Overview
You may be able to calculate the amount of memory that can be allocated to the Java Virtual Machine using the the procedure below.
Product section
Resolution
- Calculate the required allocated memory for your deployment.
- Update the whd.conf file in the Web Help Desk directory.
- Restart Web Help Desk.
Calculate the required allocated memory
To configure an appropriate amount of memory for your deployment, use the following formula:
(Average # of Concurrent Techs x 150) + (Average # of Concurrent Users x 25) = MAXIMUM_MEMORY
For example, if you have 10 concurrent techs and 50 concurrent clients, the MAXIMUM_MEMORY setting in the whd.conf file should be:
(10 x 150)1500 + (50 x 25)1250 = 2750 or 2.75GB
MAXIMUM_MEMORY=2750
Update the whd.conf file
Update the whd.conf file with the new memory setting.
Microsoft Windows Server
- Navigate to the Web Help Desk directory located at:
C:\Program Files\WebHelpDesk\ - Open the \conf directory.
- Open the
whd.conffile in a text editor (such as Notepad). - Using the value you calculated in the previous section, change the MAXIMUM_MEMORY parameter to a value that is no greater that the total memory installed on the server. SolarWinds recommends allocating 3GB - 4 GB of memory.
- Save and close the file.
macOS
- Using Finder, navigate to Applications > Utilities > Terminal and open the Terminal application.
- Connect to the Virtual Appliance.Change the directory to the Web Help Desk
confdirectory:REM - Scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. REM - The risk arising out of the use or performance of the scripts and documentation stays with you. REM - In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation. ======================================================================== cd /Library/WebHelpDesk/conf
- Enter the following command to change the maximum JVM to the appropriate value: :%s/MAXIMUM_MEMORY=512/MAXIMUM_MEMORY=[memory in MB]/ :wq
For example, if you would like to use 2750MB, type
:%s/MAXIMUM_MEMORY=512/MAXIMUM_MEMORY=2750/ :wq - Save and close the file.
Linux/SolarWinds WHD VA
- Connect to the Virtual Appliance (VA) using an SSH client.
- Enter the following credentials:
- Username: admin
- Password: admin(default password)- If you changed the default password enter the new password.
- If you do not have an SSH client and are running Windows, download a free SSH client (such as PuTTY), connect with the following credentials, and then click Open:
- Host Name or IP: (IP of your VA)
- Username: admin
- Change the directory to the Web Help Desk /conf directory by typing:
REM - Scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. REM - The risk arising out of the use or performance of the scripts and documentation stays with you. REM - In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation. ======================================================================== cd /usr/local/webhelpdesk/conf
- Type the following command to change the maximum JVM to the appropriate value:
:%s/MAXIMUM_MEMORY=512/MAXIMUM_MEMORY=[memory in MB]/ :wq
For example, if you want to change the value to 2750 MB, type:
:%s/MAXIMUM_MEMORY=512/MAXIMUM_MEMORY=2750/ :wq - Save and close the file.
Restart Web Help Desk
See the appropriate instructions below to restart Web Help Desk.
Microsoft Windows Server
- Navigate to C:\Program Files\WebHelpDesk
- Right-click whd_stop.bat and select Run As Administrator.
- After the Command Prompt window closes, right-click whd_start.bat and select Run As Administrator.
macOS
Open a terminal window and type:
REM - Scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. REM - The risk arising out of the use or performance of the scripts and documentation stays with you. REM - In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation. ======================================================================== sudo /Library/WebHelpDesk/whd stop then: sudo /Library/WebHelpDesk/whd start
Linux
Open a command prompt and type:
REM - Scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. REM - The risk arising out of the use or performance of the scripts and documentation stays with you. REM - In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation. ======================================================================== sudo service webhelpdesk stop then: sudo service webhelpdesk start
Disclaimer:
Scripts are not supported under any SolarWinds support program or service. Scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The risk arising out of the use or performance of the scripts and documentation stays with you. In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation.