Complete the following steps to install Devices Client:

These instructions are for OpenJDK.

1. Ensure Java is installed. Devices Client will not work without Java 8.

2. Download and Unzip Iced Tea (Portable Version).

3. Move the folder to a safe location to be used later. This location will be referenced below with {install_location}.

4. Open a terminal and navigate to "{install_location}/icedtea-web-image/bin" and run the command ./itweb-settings.sh

5. A window will open to configure Iced Tea. Select the menu option on the left labeled "JVM Settings".

6. Click the button labeled "Browse for JVM for IcedTea-Web" and select the location of your Java Installation from step 1.

   • Below you will see Validation results
     NOTE: It is common, and acceptable, for an error to populate that notes the directory does not contain lib/rt.jar

7. Click "Apply" and then Click "Ok". The window will close.

8. Download Devices Client for Mac and save the file to a safe location. Future steps will refer to this locations as {downloaded_location}/client_devices.jnlp

9. If prompted with the message, "This type of file can harm your computer. Do you want to keep .JNLP anyway?" click Keep.

   1. Chrome users may not have the Keep option. If this happens you need to go into your Chrome downloads or just click Show All. Find the .JNLP file download and the Keep option will be available.

10. Try to open the .JNLP file once its finished downloading by double clicking. This will cause a warning "Apple could not verify “client_devices.jnlp” is free of malware that may harm your Mac or compromise your privacy." Click "Done".

    1. Navigate to System Settings.

    2. Click the Security and Privacy option.

    3. Scroll to the Security section and look for a "client_devices.jnlp" was blocked to protect your Mac. Click the Open Anyway button.

    4. A window will open with a warning, "Apple is not able to verify that it is free from malware that could harm your Mac or compromise your privacy. Don’t open this unless you are certain it is from a trustworthy source", click Open Anyway.

    5. A window will prompt that the Mac was unable to locate a Java Runtime that supports javaws. Click OK.

11. Open a terminal and navigate to "{install_location}/icedtea-web-image/bin" and run the command ./javaws.sh {downloaded_location}/client_devices.jnlp -J-Djnlp.application.href=https://dci.egov.com/SwiperApp/client_devices.jnlp

12. An icon is displayed on the menu bar after Devices Client has been installed. Clicking on the Mac Menu Bar Icon displays five options.

    • Click About to view Card Swiper Service versioning information.

    • Click Check for Updates to have Devices Client look for a updated version.

    • Click Remove all custom forms to have Devices Client remove any custom forms.

    • Click Agency to set the device with a custom Agency.

    • Click Exit to close Devices Client.

Create a custom Launcher for Devices Client:

1. Click on the search bar and search for "Automater", and select the Automater.app
2. Click the "New Document" Button.
3. Select "Application".
4. Click "Run Shell Script".
5. Add the run command of "sh {install_location}/icedtea-web-image/bin/javaws.sh {downloaded_location}/client_devices.jnlp -J-Djnlp.application.href=https://dci.egov.com/SwiperApp/client_devices.jnlp", make sure to replace the {install_location} and {downloaded_location} with your values from above.
6. Save the new Application with the name Device Client.

You can now search for Device Client in the search bar to start the application.