Before uploading MyQ DDI on the domain server it is necessary to configure it correctly and run it manually on a selected test computer. The following components are necessary to correctly run MyQ DDI:
MyQ DDI main script for installation
MyQ DDI configuration file
Printer driver files
Necessary files for the printer driver installation
Printer driver settings files
Optional file for setting up the printer driver (*.dat file)
The MyQDDI.ps1 file is located in your MyQ folder, in C:\Program Files\MyQ\Server, but the other files have to be manually created.
All the parameters necessary to be configured in MyQ DDI are placed in the MyQDDI.ini file. Within this file you can set up printer ports and printer drivers, as well as load a file with default settings of a particular driver.
The MyQDDI.ini structure
MyQDDI.ini is a simple script adding information about print ports and print drivers to the system registry and thereby creating new printer ports and printer drivers. It consists of several sections.
The first section serves for setting up the DDI ID. It is important when detecting whether this script is new or was already applied.
The second section serves for printer ports installation and configuration. More printer ports can be installed within a single script.
The third section serves for printer driver installation and configuration. More printer drivers can be installed within a single script.
The fourth section is not mandatory and can be useful for automatic deletion of old unused drivers. More printer ports can be uninstalled within a single script.
The MyQDDI.ini file must always be located in the same folder as MyQDDI.ps1.
DDI ID parameter
After running MyQDDI.ps1 for the first time, the new record "DDIID" is stored into the system registry. With every next run of the MyQDDI.ps1 script, the ID from the script is compared with the ID which is stored in the registry and the script is executed only if this ID is not equal. That means if you run the same script repeatedly, no changes are made in the system and the procedures of installing printer ports and drivers are not executed.
It is recommended using the date of modification as the referent DDIID number. If the value skip is used, then the ID check is skipped.
Port section parameters
The following section will install and configure the standard TCP/IP port to Windows OS.
This section contains the parameters:
PortName – Name of the port, text
QueueName – Name of the queue, text without spaces
Protocol – Which protocol is used, "LPR" or "RAW", default is LPR
Address – Address, can be hostname or IP address or if you use a CSV file, then you can use the %primary% or %% parameters
PortNumber – The number of the port you want to use, LPR default is "515"
SNMPEnabled – If you want to use SNMP, set it to "1", default is "0"
SNMPCommunityName – Name for using SNMP, text
SNMPDeviceIndex – SNMP index of device, numbers
LPRByteCount – LPR byte counting, use numbers, default is "1" – turn on
Printer section parameters
The following section will install and configure the printer and printer driver to Windows OS by adding all the necessary information to the system, using the driver INF file and the optional configuration *.dat file. To install the driver properly, all the driver files must be available and a correct path to these files must be set within the script parameters.
This section contains the parameters:
PrinterName - Name of the printer
PrinterPort - Name of the printer port that will be used
DriverModelName - Correct name of the printer model in the driver
DriverFile - Full path to the printer driver file; you can use %DDI% to specify a variable path like: %DDI%\driver\x64\install.conf
DriverSettings - Path to the *.dat file if you want to set printer settings; you can use %DDI% to specify a variable path like: %DDI%\color.dat
DisableBIDI - Option to turn off "Bidirectional Support", default is "Yes"
SetAsDefault - Option to set this printer as default
RemovePrinter - Option to remove an old printer if necessary
This configuration file is very helpful if you want to change the default settings of the print driver and use your own settings. For example, if you want the driver to be in monochrome mode and set the duplex print as default.
To generate the dat file, you need to install the driver on any PC first and configure the settings to the status you want. The driver must be the same as the one you will install with MyQ DDI!
After you set up the driver, run the following script from the command line:
rundll32 printui.dll PrintUIEntry /Ss /n "MyQ mono" /a "C:\DATA\monochrome.dat" g u d r
Just use the correct driver name (parameter /n) and specify the path (parameter /a) to where you want to store the .dat file.
MyQDDI.csv file and structure
Using MyQDDI.csv file, you can setup variable IP addresses of the printer port. The reason is to automatically reconfigure the printer port if the user changes the location with their laptop and connects to a different network. After the user switches on the computer or logs in to the system (it depends on the GPO setting), MyQDDI detects the IP range and on this basis, it changes the IP address in the printer port so that the jobs are sent to a correct MyQ server. If the Primary IP address is not active, then the Secondary IP is used. The MyQDDI.csv file must always be located in the same folder as MyQDDI.ps1.
RangeFrom - The IP address that starts the range
RangeTo - The IP address that ends the range
Primary - The IP address of MyQ server; for the .ini file, use the %primary% parameter
Secondary - IP that is used if primary IP is not active; for the .ini file, use the %secondary% parameter
Comments - Comments can be added here by the customer