Install and Upgrade the EMS Kiosk

1. Verify that the System Requirements and Prerequisites for EMS Kiosk App are fulfilled:

   1. Patches

   2. API

   3. .NET Core Windows Server Hosting Bundle:

      1. Run the installer.

      2. When complete, open a CMD prompt as an Admin.

      3. Right-click the Start button and select Command Prompt (admin).

      4. Type net stop was /y <enter>.

      5. Type net start w3svc <enter>.

   4. EMS Platform Services

      1. We recommend that you test that Platform Services is properly installed by navigating to the URL it created on install (http://localhost/EmsPlatform).

      2. To ensure Platform Services is working correctly, connect to http://localhost/EmsPlatform/admin and use an Admin Everyday User to verify you can log in. If you see license information, everything is working properly.

2. Uninstall old versions of EMS Kiosk App. 

   We recommend that you record the IIS server, the SQL server name, the EMS DB name, etc. We also recommend creating a notepad file for the URLs that are generated for later reference.

3. Get the latest version of the installation files from the Downloads area in Accruent Access.

   To view the Downloads area, My Products > EMS Downloads (opens a new tab) > (Release) Releases & Patches.

4. Load the EMS.Kiosk.App.msi file onto the web server that will be running the EMS Kiosk App.

5. Run EMS.Kiosk.App.msi.

6. The first screen welcomes you to the EMS Kiosk Setup Wizard. Click Next to begin the installation process.

7. The Destination Folder screen appears. 

   The default install folder for the EMS Kiosk App is in C:\Program Files. You can change the location of the default installation folder.

   EMS Kiosk App should not be installed in the same physical directory as other EMS web-based products OR under a site running another version of the EMS Kiosk App.

8. On the EMS Application Settings page, enter the Platform API URL and the Virtual Directory Name.

9. Enter your EMS Kiosk App path and click Next. The Virtual Directory screen appears.

10. Enter the virtual directory name. Click Next. The Ready to Install screen appears.

11. To install EMS Kiosk App, on the EMS Kiosk Setup window, click Install.

12. Navigate to C:\Program Files\EMS Software\EMSKiosk.

13. Open the appsettings.json file in Notepad.

14. Search for the section, "Platform Options." DO NOT EDIT ANYTHING except the next steps. If there are multiple (load balanced) nodes, you need to apply the Client Secret to all of them.

15. Add a new line below the first { and then type:
    "SecureCookies": false,

    

16. Navigate to your Platform Services URL and log-in.

17. Click Integrations.

18. Select the EMS Kiosk service.

    1. Copy the Client ID.

    2. In your notepad file, replace the Client ID area between the quotation marks. Do not delete the commas.

       

19. Reset the client secret in the EMS Platform Admin UI:

    1. Visit the Admin UI for you EMS Platform Services install (e.g., https://my-company.com/EmsPlatform/admin). You will need a Web User login with Administrative permissions to perform this step. 

    2. Click the Reset Secret button.

    3. A new Client Secret is generated following the reset.

    4. Copy the generated Client Secret after successful reset. You won't be able to retrieve this secret later. Instead, reset the secret again to generate a new secret.

    5. In your notepad file, replace the blank area between the QUOTES “” of ClientSecret with this code. Ensure that the quotations remain before and after the ClientSecret and that there are no spaces. 

       

       Sample ClientSecret Value

20. Save and close the file. Overwrite the existing appsettings.json file. Ensure your overwrite worked by checking the date (your file should reflect the current date and time.)

21. Reboot your server. Conversely, you could:

    1. Open a CMD prompt as admin.

    2. Type: net stop was /y <enter>

    3. Type: net start w3svc <enter>

22. Clear the temp cache by closing your EMS Kiosk App browser window.

23. Return to the EMS Platform Admin and set the Active, Enable Logging, and User Auth to CHECKED.

24. Click Save.

In appsettings.json, set either SameSite=Lax, SameSite=Strict, or SameSite=None. SameSite=Lax is the default setting.

If you set SameSite=None, to set the Secure attribute to "True".