This article will cover the AppInstaller for Syrinx 365 which is a single executable that can be used to download and install the server and client components for a Syrinx 365 installation. This applies to Syrinx 365 5.0.8 or later. Previous versions of Syrinx 365 must be completely uninstalled and then reinstalled using the latest version of the Syrinx 365 AppInstaller program.
Topics included in this article
- Download the AppInstaller Executable
- Applications and Modules Available to Install
- Installing Applications
- Updating Applications
- Uninstalling Applications
- Troubleshooting
Download the AppInstaller Executable
The AppInstaller executable can be downloaded from the Syrinx download site by clicking on the below link and entering the below credentials:
https://www.syrinxusers.co.uk/Syrinx%20365/AppInstaller.exe
Username: download
Password: c0nc3pt
No further downloads will be required to perform a Syrinx 365 installation as the AppInstaller will download the required application installers and any required prerequisites.
For Syrinx 365 system requirements please consult the Syrinx 365 Minimum Hardware Requirements guide.
Applications and Modules Available to Install
Once downloaded, the AppInstaller simply needs to be run in order to begin the installation or upgrade process for any of the Syrinx applications or add-on modules.
Once opened the AppInstaller will display the list of applications that are available to install. These applications can be filtered as per the required installation type (e.g. “client” or “server”):
The following table details the applications that are available to install as well as the type of installation where they would normally be used (e.g. “client” or “server”). Clicking the “More…” option against each installation option can also provide further details on that specific module:
|
Application |
Type |
Description |
|
Client |
The Syrinx 365 Desktop application will be installed on all Syrinx client PCs. If an appropriate version of Access 365 or 2016 is not installed on the PC, the installer will install the 64 bit Microsoft 365 Access Runtime as a pre-requisite. | |
|
Server |
All Syrinx 365 Desktop clients will connect to the Syrinx 365 API in order to establish a bridge between the client and the Syrinx database. This is a website hosted in IIS on the server PC. If IIS or its required features are not installed on the server, they will be installed during the 365 API installation. One instance of the Syrinx 365 API will be installed in a Syrinx 365 system. | |
|
Syrinx Accounts Transfer |
Client |
Middleware application used to establish a link between the Syrinx system and a customer’s accounts system package. Running the installation will provide a list of supported accounting system integrations and allow the user to select which one is appropriate for their environment. |
|
Syrinx DB Admin Tool |
Server |
Installs the Syrinx Database Administration program and can also create the default Syrinx folder structure on the server. This option can also copy the latest upgrade scripts on to the server for use when upgrading a Syrinx database. |
|
Syrinx Invoice Import |
Client |
Syrinx Invoice Import can be used to simplify or automate the entry of supplier purchase invoices into the Syrinx system where a supplier has supplied xml files containing the purchase invoice data. |
|
Syrinx Mobile Web Service |
Server |
Creates a link between the Driver, Workshop and Operator mobile apps and the Syrinx database. |
|
Syrinx Outlook Addin |
Client |
Allows for the automation of saving Outlook sent and received emails against customer and supplier records in the Syrinx system. |
|
SQL Server Express |
Server |
Installs 64 bit SQL Server 2019 Express for hosting the Syrinx database. If there is already an instance of SQL server on the server PC, this installation may not be required and the Syrinx database can be restored to the existing instance as long as it is SQL 2015 or later and is enabled for “Mixed Mode” authentication. |
|
Syrinx Task Scheduler |
Client |
The task scheduler is a client and server module where it can be installed on a client PC to allow a user to set the frequency, email notifications and logging for each of the scheduler’s tasks such as but not limited to emailing scheduled reports and mobile POD notifications, AEMP updates, etc. It can also be installed on the server so that its “service” component can take advantage of the additional resources on the server PC when performing these scheduled tasks. |
|
Syrinx V4 API |
Server |
Allows 3rd parties to query, update or insert data into the Syrinx database. |
|
Syrinx WS |
Server |
A series of websites hosted in IIS that can provide for a customer portal, an online ordering solution as well as an administration site to configure and control access to the solution. |
|
Syrinx Sales App |
Server |
A website hosted in IIS that provides external sales users access to customer information and allows them to generate sales and hire quotations for customers. |
Note: Some modules require valid license details in the Syrinx database before they can be used with the Syrinx system.
Installing Applications
The installer should be “Run as Administrator” due to the nature of some of the system changes that the installer will potentially have to make during installation of the available Syrinx 365 components. If the installer is not run as an Administrator, the user will receive the following prompt when opening the program:
If the AppInsaller is not opened as an Administrator, the user will not be able to select the install option against any of the available applications and the “Install” button will be greyed out.
To install a Syrinx application using the AppInstaller, simply select the desired applications from the list of “Available” components and then press the “Install” button:
The applications can be installed individually or all in one go. Any pre-requisites required for an installation will also be downloaded and installed during the installation process.
Once an application has been successfully installed, it will be removed from the “Available” tab and displayed on the “Installed” tab of the AppInstaller:
Updating Applications
After the AppInstaller has been installed on a PC it can then be used to check for available updates for the installed Syrinx components. This can be accomplished by either running the AppInstaller executable again or by selecting the “Syrinx App Installer” option from windows “Programs and Features” and pressing the “Change” button:
The AppInstaller will check for any updates available for the installed Syrinx components and can issue the below prompt to the user if any are available:
It is also possible to manually check for updates by pressing the “Check for Updates” button when viewing the installed components. If any updates are available, “Update available…” text will be displayed against the component detailing the available update version. The user can select an individual entry to update a specific component or they can press the “Upgrade All” button to update all of the components that have available updates:
The Syrinx AppInstaller is not a version dependent component of the Syrinx 365 system and can be used to install/upgrade multiple versions of Syrinx 365 and its components but there may be occasional functionality or performance updates to this application in future. If a later version of the Syrinx 365 AppInstaller executable is run a PC with an existing AppInstaller installation, the user will be issued with the below prompt and saying “OK” will update the installed AppInstaller to the latest version:
Uninstalling Applications
Like any other application installed on a PC, the individual Syrinx components can be uninstalled by selecting the specific entries from the list of installed applications in windows “Programs and Features” and then selecting the “Uninstall” option:
All Syrinx components can also be uninstalled from a PC in bulk by selecting the “Syrinx App Installer” application from the list of installed programs and then selectin the “Uninstall” option. The user will then be advised that all of the installed Syrinx components will also be uninstalled:
Troubleshooting
As mentioned previously the Syrinx AppInstaller application must be “Run as Administrator”. If this is not done, the user will not be able to select a component for installation and the “Install” button will be greyed out.
The PC will require full access to the internet as the appinstaller will download the necessary Syrinx applications and pre-requisites during the installation process. Restrictions to a PC’s access to the internet or specific domains may prevent the installer from completing the installation process.
The AppInstaller will log its activity in the user’s home directory, C:\Users\username\AppData\Local\Temp, and will be prefixed with “Syrinx_APP_Installer” and suffixes with the time and date. These logs can be checked for issues if an error occurs during the installation process and a component fails to install: