Installation

The MyQ Roger Client (MRC) application is provided in .pkg format and can be distributed over the network using:

Apple Remote Desktop
Microsoft Intune

Alternatively, the package can be installed during a user session either via the setup wizard or silently via the terminal.

Once the installation is finished, MyQ Roger Client starts running in the background and the MyQ (Q) icon appears in the menu bar on the top-right of your screen. MyQ Roger Client can also be found in Applications.

RogerClient.Service also starts running in the background and can be found in Activity Monitor.

Installation via the Setup Wizard

To install MyQ Roger Client via the setup wizard:

Download the latest available version of the installation file from the MyQ Roger Community Portal. Alternatively, download an installer that is pre-configured for your site from the Roger server. For more information, see Desktop Clients in the MyQ Roger Server Administration guide.
Run the installation file.
(Optional) To customize the installation, use installation parameters in the file name.
The MyQ Roger Client Setup wizard dialog opens.
Click Continue to start the installation.
On the license page, click Continue to accept the terms of the software license agreement.
On the Destination Select page, select the destination where to install MyQ Roger Client. Click Continue.
On the Installation Type page, click Install.
Enter the password of the user and click Install Software.
During the installation, there is a pop-up message saying that “Installer” would like to modify apps on your Mac. Click OK.
Once the installation is complete you are redirected to the summary page, and it should say that your installation was successful. Click Close.

Silent Installation

Users with admin rights can silently install the application. Download the latest available version of the installation file, open the Terminal, and issue the command:

sudo installer -pkg "MyQ Roger Client Mac 2.3(Bundled Drivers)_3_eu_MyQTenant.pkg" -target / -dumplog

Example 1

sudo installer -pkg "MyQ Roger Client Mac 2.3(Bundled Drivers)_1_eu_MyQTenant.pkg" -target / -dumplog

Example 2

MyQ Roger Client 2.3_eu__Kyocera ECOSYS M2030dn.PPD.pkg

Note the double underscore (__) after the region parameter.

Installation Parameters

You can use installation parameters to define a pre-configured installation package in two ways.

Parameters in the Package File Name
Specify installation parameters in the package file name. Use this option for deployment with Intune for macOS, silent installation and installation with the Setup Wizard.
Parameters in the Configuration File
The MyQ Roger Server administrator can specify package installation parameters in a configuration file. This package is then available for download from the server. For more information, see Desktop Clients in the MyQ Roger Server Administration guide.

Parameter	Description	File Name Usage	Configuration File Usage
REGION ID (required)	Defines the server that the client connects to (EU, US).	_eu	`REGIONID=US`
TENANCYNAME	Specifies the tenant name (identifier).	_MyQTenant	`TENANCYNAME=MyQTenant`
PRINTERDRIVER	Specifies a pre-installed driver to be used by the MyQ Roger printer. When set to _DefaultHP or _DefaultRicoh, a custom .ppd postscript driver from macOS is used. If the parameter is not set and bundled driver is included, the Kyocera Universal Printing driver is installed.	_Kyocera ECOSYS M2030dn.PPD	`PRINTERDRIVER=“DefaultHP”`
PRINTERSPOOLER	Specifies the printer spooling method. 1 (Client Spooling only) 2 (Cloud spooling, with Microsoft and Google authentication methods allowed in MRC) 3 (Client and Cloud Spooling)	_1	`PRINTERSPOOLER=3`
FAILOVERENABLED	Enables fallback printing. 1 (Enabled, default) 0 (Disabled) If disabled and the server is not accessible, all jobs are discarded.	N/A	`FAILOVERENABLED=1`
PRINTERNAME	Defines a printer name. The installer creates a printer with the name. The default value is MRC-Printer.	N/A	`PRINTERNAME=“MRC-Printer”`
COLORPRINT	Defines color options. 1-Only Color Printer (default) 2-Only B&W Printer 3-Both Printers	N/A	`COLORPRINT=1`

Configuration Examples

REGIONID=EU,TENANCYNAME=[TENANT-NAME],PRINTERSPOOLER=1,PRINTERDRIVER="Kyocera ECOSYS M2030dn.PPD"
REGIONID=EU,TENANCYNAME=[TENANT-NAME],PRINTERSPOOLER=2,PRINTERDRIVER="DefaultRicoh"
REGIONID=US,TENANCYNAME=[TENANT-NAME],PRINTERSPOOLER=3,PRINTERDRIVER="DefaultHP"

The parameter TENANCYNAME is technically optional, but it is highly recommended.

Printer and Driver

During the installation, a MyQ Roger printer is created and is ready to be used for sending jobs via MRC to MyQ Roger server.

If the installer package is with the bundled drivers and there is no set value to the PRINTERDRIVER parameter, then the Kyocera Universal Printing driver is installed.
If the installer package is without the bundled driver and there is no value set to the PRINTERDRIVER parameter, then a generic default driver from macOS is used, however, this driver only supports black-and-white printing.

How to Find Installed Drivers

Open a terminal.
Run the lpinfo -m command.
This command shows the installed drivers:

The installer only needs the filename including the file extension. For example:
Kyocera ECOSYS M2030dn.PPD
All the drivers will be searched on the location: /Library/Printers/PPDs/Contents/Resources

For example, the installer will then look like this:

MyQ Roger Client 2.3_eu_MyQTenant__Kyocera ECOSYS M2030dn.PPD.pkg