Submit a ticketCall us

Systems Monitoring for Dummies
Our new eBook will teach you the fundamentals and help you create monitors and alerts that are effective, meaningful, and actionable. Monitoring is more than a checkbox on your to-do list. This free eBook will give you practical advice to help you succeed in all aspects of monitoring – discovery, alerting, remediation, and troubleshooting. Don’t miss out on this indispensable resource for newbies, experienced IT pros, and everyone in between. Register Now.

Home > Success Center > Web Help Desk (WHD) > Migrate Web Help Desk to another server

Migrate Web Help Desk to another server

Overview

This article describes how to move Web Help Desk to another server running an identical or disparate operating system. This article addresses the following configurations:

  • Original and target server are running identical operating systems

  • Original server is running Windows Server and the target server is UNIX-based (Linux or macOS)

  • Original server is UNIX based (Linux or macOS) and the target server is running Windows Server

This article uses standard installation directories for a reference. If you installed WHD to a non-standard directory, replace c:\progra~1\WebHelpDesk (Windows), /Library/WebHelpDesk (macOS), /usr/local/webhelpdesk (Linux or Virtual Appliance) with the correct locations in all commands.

Environment

All WHD versions

Steps

Original and target server are running identical operating systems

Ensure that both servers are running identical 32-bit or 64-bit operating systems. 

  1. Stop WHD on the original server.
  2. Navigate to the <WebHelpDesk> directory. 
    macOS:  /Library/WebHelpDesk    
    Microsoft® Windows Server®:  \Program Files\WebHelpDesk    
    Linux: /user/local/webhelpdesk
  3. Back up the <WebHelpDesk>/conf directory to a safe location. 
  4. If the original server is running Windows Server, copy the \bin\wrapper\conf directory to a safe location.
  5. Install the same WHD version on the target server. 
  6. On the target server, initialize Web Help Desk using the Getting Started Wizard. When prompted, select Embedded database (the default is PostgreSQL).
  7. Stop WHD and the PostgreSQL service on the target server.
    1. On the target WHD sever, rename the \Program Files\WebHelpDesk\PGSQL9 directory to OLD_PGSQL9.
      You can also move the directory to a different location.
    2. Copy the program files in the \WebHelpDesk\PGSQL9 directory from the old WHD installation to \Program Files\WebHelpDesk\ on the target server.
  8. Navigate to the conf directory on the target server.
    Windows Server: <WebHelpDesk>\bin\wrapper\conf
    Linux or macOS: <WebHelpDesk/conf
  9. Copy the conf directory files from the original server to the same location on the target server.
    • Windows Server:
      • keystore.jks
      • whd.conf
      • labels\CustomLabels*.properties
      • bin\wrapper\conf\wrapper_template.conf
    • Linux or macOS:
      • keystore.jks
      • whd.conf
      • labels/CustomLabels*.properties
  10. Start WHD on the target server.
  11. If the target server domain host name is identical to the original server domain host name, you are finished.
    If the target server domain host name is different from the original server domain host name, perform the following steps:

    1. Log in to Web Help Desk as an administrator.

    2. Click Setup > General > Options.

    3. In the Server DNS Name field, enter the new server DNS name.

    4. Click Save. 

Original server is running Windows Server and the target server is UNIX-based (Linux or macOS)

Ensure that both servers are running identical 32-bit or 64-bit operating systems. 

  1. Stop WHD on the original server.
  2. Back up the /conf directory and the whd\bin\wrapper\conf directories to a safe location.
  3. Install an identical WHD version on the target server. 
  4. Initialize WHD using the Getting Started Wizard. When prompted, select the default PostgreSQL embedded database.
  5. Log in to WHD using admin/admin credentials.
  6. Click Setup > General > Database and point WHD to your original database. If the original server connected to an embedded PostgreSQL database, use port 20293.
  7. Stop WHD on the target server.
  8. Navigate to the conf directory on the target server.
    Windows Server: <WebHelpDesk>\bin\wrapper\conf
    Linux or macOS: <WebHelpDesk/conf
  9. Copy the following files from the original server to the same location on the target server: 
    • keystore.jks
    • whd.conf
    • labels/CustomLabels*.properties
  10. If you use custom VM arguments in the \bin\wrapper\conf\wrapper_template.conf file, add them to the JAVA_OPTS parameter in the /conf/whd.conf file.
    For e
    xample: JAVA_OPTS="-Darg1=true -Darg2=true"
  11. Start WHD on the target server.
  12. If the target server domain host name is identical to the original server domain host name, you are finished.
    If the target server domain host name is different from the original server domain host name, perform the following steps:

    1. Log in to Web Help Desk as an administrator.

    2. Click Setup > General > Options.

    3. In the Server DNS Name field, enter the new server DNS name.

    4. Click Save,

Original server is UNIX based (Linux or macOS) and target server is running Windows Server

  1. Stop WHD on the original server.
  2. Navigate to the <WebHelpDesk> directory. 
    macOS:  /Library/WebHelpDesk    
    Windows Server:  \Program Files\WebHelpDesk    
    Linux: /user/local/webhelpdesk
  3. Back up the <WebHelpDesk>/conf directory to a safe location.
  4. Install an identical WHD version on the target server.
  5. Initialize WHD using the Getting Started Wizard. When prompted, select the default PostgreSQL embedded database.
  6. Log in to WHD using admin/admin credentials.
  7. Click Setup > General > Database and point WHD to your original database. If the original server used embedded PostgreSQL, use port 20293.
  8. Stop WHD on the target server.
  9. Navigate to the conf directory on the target server.
    Windows Server: <WebHelpDesk>\bin\wrapper\conf
    Linux or macOS: <WebHelpDesk/conf
  10. Copy the following files from the original server to the same location on the target server:
    • keystone.jks
    • whd.conf
    • labels/CustomLabels*.properties
  11. If you used custom VM arguments in the JAVA_OPTS parameter in the /conf/whd.conf file, add them to the \bin\wrapper\conf\wrapper_template.conf file.
    For e
    xample: wrapper.java.additional.16=-DWHDconfig=...Helpdesk.woa.properties
  12. Start WHD on the target server.
  13. If the target server domain host name is identical to the original server domain host name, you are finished.
    If the target server domain host name is different from the original server domain host name, perform the following steps:

    1. Log in to Web Help Desk as an administrator.

    2. Click Setup > General > Options.

    3. In the Server DNS Name field, enter the new server DNS name.

    4. Click Save.

Access a command line

Most of the commands in this article must be executed in a command line. The following table describes how to open a command line in your operating system. 

Operating System Steps
Windows Server
  1. Open a Run dialog box.
  2. Enter cmd to open a command line with administrator privileges.
macOS
  1. Click Applications >Utilities.
  2. Double-click Open in Terminal. 
    This option may vary with your distribution.
Linux (RPM installation)
  1. Open the graphical user interface.
  2. Click Applications > System.
  3. Right click Desktop and click Open in Terminal (
Virtual Appliance
  1. Connect to the server using SSH. 
  2. Execute:
    ssh username@server_ip_or_hostname

 

 

Last modified

Tags

Classifications

Public