Differences

This shows you the differences between two versions of the page.

--- public:tutorials:manually_moving_speed-quote_to_another_computer [2016/08/31 13:58] – created dave
+++ public:tutorials:manually_moving_speed-quote_to_another_computer [2025/05/22 21:53] (current) – external edit 127.0.0.1
@@ Line 10: / Line 10: @@
   - enabling and starting the Server Software
   - pointing the client software to the new server
 ==== Disabling & Removing the existing Server Software Windows Service ====
@@ Line 15: / Line 16: @@
 It is important to stop the current Speed-Quote Server software in order to make sure that any data files are unlocked before moving the installation.
-  * Stop the Speed-Quote Server Windows Service in the Windows Administrative Tools -> Services program.
+) Stop the Speed-Quote Server Windows Service in the Windows Administrative Tools -> Services program.
-{{:public:tutorials:stopservice.jpg|}}
+<hidden onHidden="Click here to show me">{{:public:tutorials:stopservice.jpg}}</hidden>\\
+) Set the Start Up type for the service to "Disabled".
-  * Set the Start Up type for the service to "Disabled".
+<hidden onHidden="Click here to show me">{{:public:tutorials:disableservice.jpg}}</hidden>\\
+) If you want to completely remove the windows service:
+  * open a command prompt,
+  * change directories to the <Speed-Quote Root Folder>\Programs\ folder
+  * issue the following command: <code>SQEnterpriseServer.exe -rs /UNINSTALL</code>
+  * a dialog box should appear stating that the service has been uninstalled.
+==== Copying the Root Speed-Quote folder to the New Computer ====
+) Copy the root folder (C:\Program Files (x86)\SQEnterprise\) in the default installation to the new computer.  This folder may be very large.
+) Set the proper permissions for the root folder on the new computer so that the Speed-Quote Server Software can read/write to all sub-folders.
+==== Set up the Windows Registry Keys and confirm that the Server Settings are correct ====
+A single Windows Registry Key/Value must be set to point to the Root Folder and 4 Speed-Quote Settings need to be set correctly.
+) Add the following Windows Registry Key for a 64 bit Windows OS:  <code>HKEY_LOCAL_MACHINE:\SOFTWARE\Wow6432Node\APPtastic\SpeedQuote Enterprise</code>
+b) Add the following Windows Registry Key for a 32 bit Windows OS:  <code>HKEY_LOCAL_MACHINE:\SOFTWARE\APPtastic\SpeedQuote Enterprise</code>
+) Create a String Value in that Registry Key named "RootDir" and set it's value to the full path of the Speed-Quote Root Folder (e.g. "C:\Program Files (x86)\SQEnterprise\" )
+<hidden onHidden="Click here to show me">{{:public:tutorials:rootdirregistryvalue.jpg|}}</hidden>\\
+) Use the **ApptRegEdit.exe** program to confirm/change the directory settings for the Server.  The ApptRegEdit.exe program can be found in the <SpeedQuote Root Folder>\System\bin\ folder.  (If you get an error starting the program, double-check the Windows Registry "RootDir" value).
+The ApptRegEdit program works the same as the Windows Registry Editor (regedit), but only changes the settings files within the Speed-Quote Root Folder.
+  * Open the "Directories" Key in the right hand window and set each of the paths in the left hand window to the correct settings.  If you are moving the Speed-Quote Root Folder to the same path as the current installation no settings need to change.
+<hidden onHidden="Click here to show me">{{:public:tutorials:apptregeditdirectories.jpg|}}</hidden>\\
+==== Enabling and Starting the Server Software ====
+The server software is now installed and can run as a "Windowed" program.  You should run it in this "Windowed" mode the first time in order to test that it is installed correctly and to allow the initial cache time to be created.
+) Run <SpeedQuote Server Root Folder>\System\bin\SQEnterpriseServer.exe.  Once the Server Window appears you can close it to shut down the software.
+) To install the Server Software as a windows service:
+  * open a command prompt in Administrator Mode
+  * change directories to the <Speed-Quote Root Folder>\Program\ folder
+  * issue the following command: <code>SQEnterpriseServer.exe -rs /INSTALL</code>
+  * a dialog box should appear stating that the service has been installed.
+) Start the SpeedQuote Server Windows Service in the Windows Administrative Tools -> Service program.
+==== Point all Speed-Quote Client software to the new server ====
+) Use the ApptRegEdit.exe program on each of the Client computers to change the "ClientPrefs -> HostName" to the correct Computer Name or IPV4 address of the server.  <code>e.g. SQServer2  or  192.168.1.45</code>
+<hidden onHidden="Click here to show me">{{:public:tutorials:clienthostname.jpg|}}</hidden>\\
+Alternatively you can use the information below to write a script to mass update all clients.
+==== Underlying structure of how the client finds the server address ====
+The ApptRegEdit.exe program changes small text files with an .rgf extension to update settings.  The <SQEnterprise Root Folder>/Admin/Settings/ClientPrefs/HostName.rgf file controls where the the client software looks for the server software. The HostName.rgf file contains 3 lines of text:
+  * the constant "String"
+  * the length of line 3
+  * either the Computer Name or IPV4 Address of the server.
+Example:
+<code>String
+.0.3.56</code>
+The <SQEnterprise Root Folder> can be found by looking for the following Registry Key:
+HKEY_LOCAL_MACHINE/Software/Apptastic/SpeedQuote Enterprise/RootDir
+or
+HKEY_LOCAL_MACHINE/Software/Wow6432Node/Apptastic SpeedQuote Enterprise/RootDir