Skip to main content
Skip table of contents

Installation

You can install the application either via the setup wizard or silently via a command line with parameters.

Before Installation

Preferences for Server Connection

There are three methods to pass mandatory connection details to MDC. These can be completed before the installation. They define to what server the Desktop Client connects on startup after the installation is completed.

Parameters in the Installer Name

The Server Address, Server Port, and Security Mode can be set by editing the Installer file name.

The installer can be named following the structure:

(MyQ-)DesktopClient-ServerAddress-ServerPort(-Normal|Strict).msi

ServerAddress, ServerPort and Normal|Strict are properties that need to be set; content shown in rounded brackets is optional. If the security mode is omitted, Normal is used as default. Examples:

  • MyQ-DesktopClient-contoso.myq.com-8090.msi

  • DesktopClient-acme.com-443-Strict.msi

    • ServerAddress: http://acme.com

    • ServerPort: 443

    • SecurityMode: Strict

image-20240522-225556.png

Example of the installer file with connection details

Editing the config.ini File

The config.ini should be placed next to the installer .msi file before the installer is run; MyQ Desktop Client will use it to configure itself on the client startup.

The Server Address, Server Port, and Security Mode can be set by editing the config file which is included in the installation package. The available security modes are Strict and Normal.

image-20240502-071052.png

Edited config file

Silent Installation Parameters

Connection details can also be defined when the installer is run. See Silent Installation for a description.

Desktop Client Configuration

Creating and Editing Configuration Profiles

Administrators now have the option to save multiple different configurations for MyQ Desktop Client (MDC) in MyQ, so that they can deploy different configurations based on locations; for example, define different fallback printers in each of their offices or enable client spooling only for selected workstations.

It is possible to configure profiles before deploying MyQ Desktop Client 10.2+. Once MyQ Desktop Client connects to the server, it starts automatically using settings from applicable profiles if this feature is enabled.

On the MyQ Desktop Client Settings tab (MyQ, Settings, MyQ Desktop Client), you can configure the MDC settings and deployment.

You can create multiple configuration profiles, assign them to specific locations, and configure the Desktop Client’s features for that particular location.

Clients that are not matched in any of the profiles will use settings from the Default profile. In case that the client matches multiple profiles, the highest matched profile in this list will be used.

Switch Automatic configuration on and click Save to use the feature.

MyQ Desktop Client settings tab

To create a new configuration profile for MDC:

desktop client configuration general tab

General tab

desktop client configuration printing tab

Printing tab

  1. On the MyQ Desktop Client Settings tab, click Add in the top-right corner.

  2. On the General tab enter a Name for your configuration profile.

  3. In the Clients section specify which clients this configuration profile should apply to, either using an IP range or Hostnames regex. You can also add exclusions.

  4. In the Authentication section select a Client mode. In Private mode, the MDC offers a more lenient authentication and session management approach, acknowledging the trust level of a personal or assigned device. Public mode is designed with communal device security in mind, ensuring that print jobs and user sessions are managed to prevent unauthorized access. Read more about Private and Public mode here.

  5. In the Authentication choose the appropriate Login methods, from Sign in with MyQ, ID Card (requires a card reader on the user's device), and Integrated Windows Authentication (read more about Integrated Windows Authentication here).

  6. On the Printing tab in the Job Processing section select a Processing method from:

    1. Secure print job forwarding: All print jobs received by the Desktop Client are automatically forwarded to the MyQ Print Server over a secure port. Desktop client is only used for authentication and accounting.

    2. Client spooling: The Desktop Client stores the job data on the computer and releases it directly to a printer upon server’s command. This lowers network usage to the server.

  7. Choose if you want to Append domain name to username, if enabled the username will be set as username@domain on the job.

  8. Enable or disable Local Print Monitoring, which allows accounting of jobs released on local printers not managed by MyQ. It is necessary to specify the Monitored ports and Release conditions when using this feature.

Local Print Monitoring and Fallback Printing are not currently supported in MyQ Desktop Client 10.2, but they will be included in a future release.

  1. Click Save, your configuration profile is created and automatically applied to the MDCs of the specified clients.

Installation Process

Manually Running the Setup Wizard

This option allows users to manually install MDC.

To successfully run the installer, one of the methods to define the server to which MDC should connect must be used. See above in Preferences for Server Connection. Potentially, you can perform Silent Installation instead (read below).

  1. Download the latest available version of the installation (.msi) file from the MyQ Community portal.

  2. Double-click on the installation file. The installation wizard opens; click Next.

    installer step 1
  3. The End-User License Agreement window opens.

  4. Select I accept the terms in the License Agreement; click Next.

    installer step 2
  5. The Select Installation Folder dialogue opens, select in installation location and click Next.

    installer step 3
  6. The Ready to Install window opens; click Install.

    installer step 4
  7. The Completing the MyQ Desktop Client Setup Wizard window opens; Click Finish.

Once the installation is finished, MyQ Desktop Client (MDC) starts running in the background. The application can be found in the Windows Apps menu.

desktop client in start menu

The MyQ Desktop Client Windows service also starts running in the background and can be found in Windows Services.

desktop client in windows services

Silent Installation

To silently install the application, download the latest available version of the installation file from the MyQ Community portal, open the Windows command line, and use the following command with Address stating the server address, Port specifying the port, and Normal|Strict specifying the security mode:

msiexec /i "ClientInstaller.msi" /qn SERVERADDRESS=Address SERVERPORT=Port SECURITYMODE=Normal|Strict

Preferences after silent installation can be set using Configuration Profiles, as described above.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.