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
- MacOS & Linux: Open terminal and go into the folder where the file is downloaded
- Linux: Run command from terminal sudo chmod +x ./fixcertissue_linux_amd64_v0.0.1 && sudo ./fixcertissue_linux_amd64_v0.0.1
- MacOS: Run command from terminal sudo chmod +x ./fixcertissue_darwin_amd64_v0.0.1 && sudo ./fixcertissue_darwin_amd64_v0.0.1
- MacOS & Linux: Open terminal and go into the folder where the file is downloaded
- Start the installer service
- Windows: Restart installer2 service in Windows Services
- Linux: Run command from terminal
cd /usr/lib/Erply/installer2 && sudo ./installer2_linux -service=start
- 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
Log in, from the left blue pane, select Hardware - Installer app - Installation
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
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.