Differences

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

--- sa29-00 [2014/02/19 11:27] – Dustin Bird
+++ sa29-00 [2017/12/01 16:35] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-IQXMonitor
+====== How to use the IQX Launcher ======
-==========
-IQXMonitor is an application that runs as a service on a DR (Disaster Recovery) server. The application when installed as a service (set to automatic start-up) will look for a process called DBBackup.exe (This is set-up as part of the IQX DR server configuration). IQXMonitor will check this process is running every 3 seconds if this process is not running then it will attempt to restart this repeatedly.
+The purpose of this application is to allow for easy updating of all the IQX main program files and associated dlls.  By replacing the normal IQX/Pears.exe with the IQX launcher.exe it will allow for clients to be automatically updated and in sync with the correct version.
-Setting up IQXMonitor
+There are 4 files that make up the IQX Launcher application.
-==================
-You will need IQXMonitorS.exe and IQXMonitor.ini. Open a command window (With Administrator privileges) and browse to the directory storing the IQXMonitor files. To create the service enter the following:
-"Sc create IQXMonitor binpath= "xxxxxx\IQXMonitors.exe" displayname= "IQX DB Monitor"" (Where xxxxxx is the full path to the IQXMonitor file.) (Without the first and last quotes)
+  - IQXLauncher.exe
+  - client.xml
+  - server.xml
+  - IQXLauncherUpdater.exe
+**IQXLauncher.exe**
-To delete the service if not needed:
+This is the main exe that will replace the IQX.exe or the pears.exe.  This needs to be in the same folder as the main IQX folder for it to work.  You can rename this exe to whatever you want it to be and this will not affect the workings of the application.
-==============================
-Enter "SC Delete IQXMonitor" in a command prompt (without the quotes)
+**client.xml**
-Stopping DBBackup from accessing a DB.
+This is the client version of launcher configuration file.  This has to be in the main folder along with the IQXLauncher.exe file.  This file has the client information on which files it has to update and the details of which version the client has of each file.  The <exename> tag has to match the name you have called your main IQX/Pears.exe file as this is what executes and starts IQX/Pears once the update is finished.
-====================================
-When you need to update an IQX DB with a later version you will not be able to run the update (!) with active connections to the database. In order to run this you will need to stop DBBackup.exe from running and to do this you will need to first of all stop IQXMonitor. To do this open up Windows services manager and select "IQXMonitor|" from the list. Stop the service. Once stopped you will then be able to stop the DBbackup.exe process (simply stop in Task manager). As IQXMonitor is stopped this application will not restart once stopped (If IQXMonitor is still running then DBBackup.exe will keep restarting). Once the DB service is back up and running on the DB server and IQX connections are allowed again then the DBBackup can be started again. To do this Simply go into services and start the "IQXMonitor" service if this starts without an error DBBackup.exe will start shortly after.
-Troubleshoot errors in IQXMonitor
+Example:
-=============================
-IQXMonitor will not start - Are the program files present in the directory specified in the service set-up? If not then alter the file set-up or re-install the IQXMonitor service.
-DBBackup will not start - Is the IQX DB Service running? Can the DR server see the IQX DB server? If not establish this connection and try again.
+<sxh xml>
+<?xml version="1.0" encoding="utf-8"?>
+<client>
+  <iqx>0</iqx>
+  <exename>iqx.exe</exename>
+  <serverpath>C:\IQX\Program</serverpath>
+  <files>
+    <file name="bankscan.dll" latest="0" />
+    <file name="iqx.exe" latest="0" />
+  </files>
+</client>
+</sxh>
+**server.xml**
+This is the server version of the launcher configuration file.  This has to be in the same location as the files you want each client to update.
+<sxh xml>
+<?xml version="1.0" encoding="UTF-8"?>
+<server>
+	<files>
+		<file name="bankscan.dll" latest="1"/>
+		<file name="iqx.exe" latest="1"/>
+	</files>
+</server>
+</sxh>
+**IQXLauncherUpdater.exe**
+This is an application that can be used to update the server.xml. It has to be in the location where the files to be updated are stored.
+{{ :launcher.jpg?nolink&300 |}}
+**How to setup the IQXlauncher**
+  - Add the client.xml and the IQXLauncher.exe file to your default IQX/Pears install folder.
+  - Open up the client.xml file in an xml editor or notepad and set the <iqx>value to either 0 if your exe is called Pears and 1 if your exe is called IQX.
+  - Set the <serverpath> tag to point to the folder where you want the client to get the latest files.  This can be a local path of a networked shared location.
+  - Save and close the file.
+  - Next add the server.xml file and the IQXLauncherUpdater.exe  to the same folder where your updated files are stored, this must be the same location as you have specified in step 3.
+  - Now open up the  IQXLauncherUpdater.exe and add the required files you wish to be updated by the client.
+  - You can now rename the IQXLauncher.exe to either pears.exe of iqx.exe or to whatever name you currently use for your main exe.