The application is installed by running the Install.sh script in the macOS Terminal. The application settings are defined via parameters during the installation.

Before starting the installation, create a queue on the MyQ web administrator interface with the User Detection Method set to MyQ Desktop Client.

  1. Download the latest MyQ MDC for macOS installation .zip from the MyQ Community portal and extract the files.

  2. In the Mac workstation, open Terminal.

  3. Navigate to the folder where the file was extracted and run the Install.sh file setting the installation parameters. You are asked to type the administrator's account password.

  4. Type the password, and then click Enter. The MyQ MDC application is installed to the computer.

Installation

Installation Parameters

  • -i: MyQ Server's IP address or hostname

  • -p: MyQ Server's port. Since MyQ Server 8.0, it is 8090 by default and the connection is secure (SSL). (For a MyQ Server version lower than 8.0, the default port is 8080 and the connection unsecure).

  • -a: Select one of the following authentication methods:

    • -a 0: With this option selected, the job sending user has to select one of the MyQ user accounts from a list of all MyQ users. The job sender is then identified as the selected MyQ user.

    • -a 1: With this option selected, the job sending user has to log in under their MyQ credentials. The job sender is then identified as the logged in MyQ user.

    • -a 2: With this option selected, the job sender is identified as the OS user account where the job is sent from.

  • LOGINTYPE: A 1-3 letter code with combination of these three letters: "p" for PIN, "u" for Username and password and "c" for ID Card. See the examples below.

    • -l p: Enables only PIN

    • -l u: Enables only Username and password

    • -l c: Enables only Card

    • -l cp: Enables Card or PIN login

    • -l puc: Enables all three login types

  • -r: If you set this parameter to 0, it will hide the Remember me option from the user login screen. If you set it to 1, the Remember me option will be visible (the default value is 0).

  • -v: If you set this parameter to 1, MyQ MDC can use alternative servers of an IP subnet to automatically connect to. The servers need to be specified in a CSV file (the default value is 0).

  • -c: This parameter is used when the -v parameter is set to 1. It is the full path to the CSV file containing the alternative servers configuration.

Below you can see an example of the installation command:
sh Install.sh -i 10.14.5.99 -p 8090 -a 1 -l p -r 1 -v 1 -c
Users/myqtestlab/Desktop/SJM.csv

IP subnet CSV file information

To automatically switch between multiple servers on an IP subnet, the uploaded CSV file should contain the information about the subnets. The file's headers should be subnet, host, and port, as seen on the image below.

CSV file headers

In case the configuration for the current subnet does not match or something is incorrect on the file or it can't be opened, MDC will use the configuration for the connection from the registry, set during the installation.

  • If this feature is enabled, the logic is triggered every time the PC starts or there is an event in the network settings.

  • This feature doesn't restart the Service, it just updates the settings in the memory.

  • If a user is connected on 2 (Wi-Fi, cable) networks and one of them is known, MDC uses the settings for the known network.