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 Smart Job Manager.
Download the latest MyQ SJM for macOS installation .zip from the MyQ Community portal and extract the files.
In the Mac workstation, open Terminal.
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.
Type the password, and then click Enter. The MyQ SJM application is installed to the computer.
-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).
-k: The Client ID that is displayed on the MyQ web administrator interface.
-t: The API Secret, displayed on the MyQ web administrator interface, that should be used by MyQ Smart Job Manager for communication with MyQ.
-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 SJM 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 -k 81B9EB4F-2C70-45A8=A779-35DE5EB68AA4 -
t 33c7c8ba37744907480ca426de04effc744faeb2 -a 1 -l p -r 1 -c 1 -v
From MyQ SJM version 8.1, SSL is enabled by default and the -s parameter is no longer used.
Client ID and Secret
To show the Client ID of the application on the MyQ Server, follow the steps below.
On the MyQ web administrator interface, go to MyQ, Settings, External Systems.
Under the REST API applications section, select Smart Job Manager and click Actions, Edit (or right-click and Edit).
The Client ID and Secret are visible in the dialog box.
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, port, clientid, clientsecret, as seen on the image below.
In case the configuration for the current subnet does not match or something is incorrect on the file or it can't be opened, SJM 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, SJM uses the settings for the known network.