How to set 4Matrix up as a shared application

If you want to run 4Matrix from a shared folder, we you will need to use a LauncherSettings.xml file.

You can download a customisable Launcher Settings file from the following link: https://www.4Matrix.com/files/downloads/LauncherSettings.xml

 

Example Setup 1: The Cache Model (Recommended)

  • Install the 4Matrix application to a shared folder on your server e.g. P:\Apps\4Matrix
  • Add the LauncherSettings.xml file to this same folder.
  • Open LauncherSettings.xml with notepad.
  • Set the CopyLocal to <CopyLocal>true</CopyLocal> and CopyLocalPath to a path users have full permission to e.g. <CopyLocalPath>N:\4MatrixCache</CopyLocalPath>
  • Create a shortcut to P:\Apps\4matrix\Launcher.exe and share with staff e.g. place on their desktop.
  • When this shortcut is run, the Launcher will create a cached copy of 4Matrix locally in the path specified. This eliminates issues with performance and files 'being in use' by other users.

NB: With  <DownloadUpdates>true</DownloadUpdates> left as true, the central version will be updated by the first person to launch 4Matrix if an update is pending. The update process will complete, and then the files will be copied/cached to the client. There is a very minor risk that multiple users could launch 4Matrix at the same time, in which case the update will try to apply more than once and the files will become corrupt. If this happens, re-installing the 4Matrix client into the shared location will resolve the issue. 

 

Example Setup 2: The Manual Update Model

  • Install the 4Matrix application to a shared folder on your server e.g. P:\Apps\4Matrix.
  • Add the LauncherSettings.xml file to this same folder.
  • Open LauncherSettings.xml with Notepad.
  • Set CheckForUpdates to true, e.g. <CheckForUpdates>true</CheckForUpdates> 
  • Set DownloadUpdates to false e.g. <DownloadUpdates>false</DownloadUpdates> 
  • Create a shortcut to P:\Apps\4Matrix\Launcher.exe and share with staff e.g. place on their desktop.
  • When this shortcut is run, the software will check for updates but not download them. It will only warn the user that an update is available, and they will see an option to open 4Matrix anyway.

To manually update the software the Network Administrator should:

Ensure that no-one is running 4Matrix from this location (we suggest unsharing the folder temporarily).

  • Set DownloadUpdates to true e.g. <DownloadUpdates>true</DownloadUpdates> 
  • Run Launcher.exe to apply the updates.
  • Set DownloadUpdates back to false e.g.  <DownloadUpdates>false</DownloadUpdates> 
  • re-share the folder (if required).

 

Article Revised: 13/07/2021