Microservice and Installer app issue resolution - 18th Feb 23

If your Point Of Sale is currently operating as expected please ignore this article.

If you need further assistance, you can contact us to schedule a remote session with a support technician. Due to high call volume, a rep may not be able to answer the call live. You can provide your account code, company name, your name and phone number by emailing support@erply.com or using the chat bot at erply.com, and you will be called back as soon as possible.

This article is for POS registers that have not updated their Installer app and Microservices to latest versions.

To check the status go to the Erply Wizard environment https://posow-sb.erply.com/. Login with Erply credentials (Erply ID, username, password).

Go to Hardware>Installer App> Installation> Check if you are running the latest version v2.2.0

If you are already running the latest version: go to Task Manager> Services > Installer2

Restart the installer:

After restarting the installer restart you POS by Pressing CTRL + Shift + R and try to run a test sale to check if it’s working if not follow this.

Updating to new version by executable file

Install the executable file
Windows 64bit
Windows 32bit
Linux
MacOS
Run the file with administrator rights
1. MacOS & Linux: Open terminal and go into the folder where the file is downloaded
  1. Linux: Run command from terminal sudo chmod +x ./fixcertissue_linux_amd64_v0.0.1 && sudo ./fixcertissue_linux_amd64_v0.0.1
  2. MacOS: Run command from terminal sudo chmod +x ./fixcertissue_darwin_amd64_v0.0.1 && sudo ./fixcertissue_darwin_amd64_v0.0.1
Start the installer service
1. Windows: Restart installer2 service in Windows Services
2. Linux: Run command from terminal cd /usr/lib/Erply/installer2 && sudo ./installer2_linux -service=start
3. MacOS: Run command from terminal sudo launchctl load /Library/LaunchDaemons/com.Erply.installer2.plist
Restart the computer

Updating to new version by uninstalling & installing from scratch

1.In order to fix the issue we ask you to uninstall the current version of the Installer App.

On Windows:

Open the Windows Services Manager and stop the micro-service.

After that, please open the Control Panel -> Program and Feature and uninstall the app called Installer.

Please do not remove the folder under the Program Files -> Erply since it might cause some troubles with reinstallation.

On MacOS:

Open a terminal window and paste the following command line:

cd /Library/Erply/installer2 && sudo ./installer2_darwin -service=uninstall

Press enter. You will be required to enter the computer password.

Once the uninstallation complete, you will need to restart your computer before installing a new installer version.

More information here: https://wiki.erply.com/en/article/1032-installer-app-installation#frequently-asked-questions-0

2.Once the Installer App is uninstalled, you need to download and install a new version of the Installer App by following this guide: https://wiki.erply.com/article/1032-installer-app-installation

If you are running Windows 32bit, please use the following link to download the latest Installer app: https://downloads.erply.com/production/installer2_windows_386.msi

If you are running Windows 64bit, please use the following link to download the latest Installer app: https://downloads.erply.com/production/installer2_windows_amd64.msi

After installing the new Installer App we also ask you to connect all your external devices by following this guide: https://wiki.erply.com/article/1197-printing-and-payment-terminal-microservice-setup

Installer update on SSL error

1. Switch SSL off for Installer

Find config.json file for Erply Installer, default location C:\Program Files\Erply\Installer2

Open notepad and run it as Administrator, go to File> Open > C:\Program Files\Erply\Installer2

Go to Config folder

find row "SSLEnable":true, change it to "SSLEnable":false, save file and close it

2. Restart Installer in Service

Go to Task Manager> Services > Installer2

After restarting the installer restart you POS a

3. Update the Installer

open browser, paste to adress bar:

http://localhost:7777/api/v1/update

and press enter.

Wait for the update to complete, confirmation message should appear:

{"httpCode":200,"dateTime":"20220213215216","status":"OK","message":"installer was updated successfully"}

4. Switch SSL back on for the Installer

Open notepad and run it as Administrator, go to File> Open > C:\Program Files\Erply\Installer2

Go to Config folder

Change row "SSLEnable":false back to "SSLEnable":true, save file and close it

5. Restart Installer service again from Windows Services app. Now register and wizard should be able to connect to Installer service again.

6. Test the connection in wizard

open browser, navigate to

Posow-sb.erply.com

Click on Test connection, yellow message box with message Installer not connected should turn to green and show Installer is running - v2.1.0 or higher

7. Update services

Select Micro-service manager from the left pane

open UPDATE EXISTING MICRO-SERVICE dropdown menu and select service from that list

click Continue

Press Update to latest button and wait for the service to update. Do this for all services