Wiki

    Contact support:

    Email: support@erply.com

    1 Mar, 2023
    Permalink:
    Also available in:EstonianFinnish

    Microservice and Installer app issue resolution - 18th Feb 23

    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

    1. Install the executable file
      Windows 64bit
      Windows 32bit
      Linux
      MacOS
    2. 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
    3. 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
    4. 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.