Sign in

Introducing

Ideagen Community

Introducing

Ideagen Community

Articles in this section

See more
  1. Q-Pulse
  2. Q-Pulse Windows
  3. IT Guide
  4. Installation

Moving Q-Pulse to a New Application Server

Michael McAleer
  • Updated
Follow

Moving your Q-Pulse Application and Database to a new Server can be completed in 4 stages:

  1. Backing up your current environment
  2. Installing Q-Pulse on your new server
  3. Restoring your Database(s)
  4. Updating the Client Applications

Backing up your current environment

  1. Backup your Q-Pulse Database & Audit Log (if applicable)
  2. Browse to your Q-Pulse 5 Server Installation Directory. By default, this is:
    • 32bit Windows: C:\Program Files\Gael Ltd\Q-Pulse Server
    • 64bit Windows: C:\Program Files (x86)\Gael Ltd\Q-Pulse Server
Important Note: If you have upgraded your Q-Pulse system from an older version your Server directory may be listed as Q-Pulse 5 Server.
  1. Take a backup of the QPulse.lic

Installing Q-Pulse on your new Server

  1. Please consult the Installation Guide located in the installation media, or contact our Support Team for a copy of your Q-Pulse version
  • Note: You can install the latest version of Q-Pulse at this point if you wish to upgrade.
  • This can be requested at www.q-pulse.com/upgrade
  1. Browse to the Server directory of the Installation Pack
  2. Run the setup.exe 'as admin', then:
  • Check the 'Install the Q-Pulse 5 Server Application Server' box
  • Check the 'Install the Q-Pulse 5 Server Database' box 
  • Enter your Q-Pulse SQL Instance Credentials
  • Enter a new password for Application User (this must match your SQL complexity requirements)
  • Finish the wizard
  1. Ensure the Q-Pulse Data Portal is active using the following guide:
  1. If you have purchased the Audit Log feature:
  • Browse to the Audit Log directory of the Installation Pack
  • Run the setup.exe 'as admin'
  • Enter your Q-Pulse SQL Instance Credentials
  • Enter a new password for AuditLog User (this must match your SQL complexity requirements)
  • Finish
  1. Activate the Server Application
  • Browse to the Q-Pulse 5 Server Installation Directory
  • Run the ServerConfigUtil.exe 'as admin'
  • Import the Q-Pulse Licence
  • Import the DBConnections.xml
  • Start the 'Q-Pulse-5 Server' Service
  1. Test your installation:
  • Browse to the Client directory of the Installation Directory
  • Run the setup.exe 'as admin' 
  • Enter the loopback address for the Application Server, i.e. 127.0.0.1 / localhost
  • Complete the wizard
  • Log into the Client using admin / ABC@123
  1. Install additional features, Q-Pulse Web, DRS, Web Services API, etc

Restoring your Database

  1. For steps on restoring your Q-Pulse database click here
  2. If you have purchased Audit Log:
  • Restore the Audit Log Database
  • Execute the following query:
exec sp_change_users_login 'auto_fix','qpulseauditloguser'
  1. If you upgraded the application you must run the corresponding Database Update utilities 'as admin':
  • Upgrading from Q-Pulse V5.1 or v5.11
    • ..\Support\DBUpdate 5.100 and 5.110 to 5.200\QPulseDatabaseUpdater.exe 
    • ..\Support\DBUpdate 5.200 5.500 5.510 and 5.600 to 5.610\SQL2005\QPulseDatabaseUpdater.exe
    •  ..\DBUpdate\GaelDatabaseMigrator.exe
  • Upgrading from Q-Pulse V5.2, V5.5, V5.51 or V5.60
  • ..\Support\DBUpdate 5.200 5.500 5.510 and 5.600 to 5.610\SQL2005\QPulseDatabaseUpdater.exe
  • ..\DBUpdate\GaelDatabaseMigrator.exe
  • Upgrading from Q-Pulse V5.61
  • ..\DBUpdate\GaelDatabaseMigrator.exe
  1. Restart the Q-Pulse 5 Server Service
  2. Confirm you can view your restored Databases in Q-Pulse at this point before continuing

 
Updating the Client Applications

If you have installed the client directly on the PC:

  1. Browse to the installation directory on the Client machine. By default, this is:
    • 32bit Windows: C:\Program Files\Gael Ltd\Q-Pulse
    • 64bit Windows: C:\Program Files (x86)\Gael Ltd\Q-Pulse
Important Note: If you have upgraded your Q-Pulse system from an older version your Client directory may be listed as Q-Pulse 5.
  1. Open the Q-Pulse.exe.Config file (with notepad)
  2. We now need to edit a number of keys within this file to reflect the server name change.  To do this, we will perform a 'search and replace'.
  • If you do not know the old server name, then select [Find] from the [Edit] menu and search for "ghttp://" (without inverted commas).  The old server name will be the name directly after the ghttp:// but before the next forward slash (/).
For example, in the screenshot below, the old server name would be localhost
 
qpu1.png
  • We will now replace these entries with the new server name.  To do this select [Replace] from the [Edit] menu.  In the "Find what:" text box enters the old server name identified above, and enter the new server domain name in the "Replace with:" text box.
qpu2.png
 
Be careful to ensure that you have not entered any extra spaces before or after the text in either box and then press the [Replace All] button.
  • Close the 'Replace' window
  1. Save the Q-Pulse.exe.Config file.
  2. Launch the client


If you have deployed the client using Click Once:

Please refer to the Deploying a Configuration Change Using Click Once article for steps on how to deploy the client with the updated server location.

Article Comments

2 comments

Date Votes