iTrack V2.0.2 Upgrade for On-Prem

This procedure provides instructions on how to upgrade the version of your iTrack Service to allow use of the TLS 1.2 service. Currently the installed version uses TLS 1.1 which has noted security vulnerabilities. 

Before You Begin

WARNING: The original installation files, including the config file, will be deleted as a part of the upgrade. The integration key and drop directory details must be recorded BEFORE running the script. 

Note:

• Clients on LawMaster pre-Portugal version, please ensure that .NET 4.8 is installed on the server for the new service to be compatible. 
• Taking a backup copy of iTrack Service folder before the upgrade is strongly recommended.

Step-by-step guide

1. Log into your DMS server where the iTrack Service is installed and running. Account with permissions to install applications and manage services is required.
   
   Note: ITrack Service must run on the default DMS server, check U_WP parameter to confirm default DMS and DS parameter to get more details on a particular DMS server
   
   
2. Open File Explorer. Navigate to the iTrack Service folder – this is typically named InfoTrack, exact location can be obtained from iTrack Service details (use Services.msc):
   
   
   Make a note of that folder – you will be required later in the procedure.
   
   
3. Go into the iTrack Service subfolder where the iTrack.Client.exe file is located.
4. Open the configuration file iTrack.Client.exe.config using any text editor:
   
   
   
5. Make a note of the existing integration key and drop folder details. These will be used in the new config file post upgrade
   
   
   
6. Download the upgrade package from LawMaster Members Site: https://members.lawmaster.com.au/otherdwn.html. If that link doesn't work, try this direct link:
   1. https://members.lawmaster.com.au/members/other/iTrack%20v2.0.2_repack.zip
7. Download and extract the iTrack V2.0.2 zip file - it contains both the upgrade script & the new release. Make a note of the path archive was extracted to.
8. Change Base address in SPR parameter to api.infotrack.com.au 
   1. Top menu Parameters Set Parameters, enter SPR into Parameter Type and hit Enter 
   2. Double click INFOTRACK from the list of SPR parameters below 
   3. Set Base Address: https://api.infotrack.com.au
   4. Click OK
      
      

Perform the upgrade

1. Navigate to the folder the archive was extracted to and edit Powershell script file "Upgrade iTrack service - PS Script.ps1". 
   1. Set the following Values:
      1. $ServiceName - must match the old InfoTrack service name exactly 
      2. $PathCurrent - path for the service to be upgraded, this is the location of the current executable path you noted in the “before you begin” section 
      3. $PathVersion2 - path to new version, this is the folder where you extracted the archive to in the previous step
         
         (Before executing it, update the following details located at the top of the script)
         
         This script will delete the original service and files, then replace the files and install the new service
         
         
         The other service details such as $DisplayName and $Description in the script contain additional optional information and could be changed at your own preference.
         
         
2. Run the script with elevated privileges (run as admin).
3. Go back to the iTrack.Client.exe.config file and update the IntegrationKey and the DropFolder settings that you recorded earlier. Note: most often admin privileges required to save the file. Either run the text editor as admin or save the config file into another folder and then copy it back to the service folder (you will be asked for elevated permissions in this case).
4. Open Services.msc tool, find the iTrack Service. Double-click it and set "Startup type" to Automatic, click Apply. Click Start button to start the service.
   
   
   
   1. Recommended optional step: set the service to restart automatically in case of a failure. In the same service window go to Recovery tab, set actions for first, second and subsequent service failures to "Restart the Service", then click OK.
      
      
      
5. Next check the iTrack Service Logs located in Logs subfolder in the iTrack Service folder. Confirm that the service is logging information.
   
   

Check ...Debug and ...Info log files for errors:

Troubleshooting

• Incorrect/missing Integration key will result in errors recorded in %DATE% - Error.txt log file. Update Integration Key as per instruction above. If the key is already there - request a new Integration Key from InfoTrack support and then update it in iTrack.Client.exe.config. Restart the service and check logs again. 
• Windows sometimes block files downloaded from the internet. This usually leads to Error 1053: "The service did not repond to the start or control request in a timely fashion. To fix the problem run the following PowerShell cmdlet to unblock all InfoTrack files (run as admin, replace $PathCurrent with path used in the script earlier): Get-ChildItem -Path $PathCurrent -Recurse | Unblock-File