Configuring more printers per YCPC

The connector is capable of registering more than one printer. Each printer has a printer tag which is a prefix of the configuration parameter and has a friendly name which will be displayed in google. Let's assume that we have 2 printers. One printer will have friendly name TestPrinter01 and the second printer will have friendly name TestPrinter02. The first printer configuration attributes will have a name without any prefix. The second printer will have prefix T2. If a configuration parameter with this tag will not be found, then the default parameter is taken into account for configuration of the second printer.

The configuration file might look like this:

More registered printers

<add key="PrinterName" value="TestPrinter01" />
<add key="T2.PrinterName" value="TestPrinter02" />
<add key="SafeQServer" value="Server1,Server2" />
<add key="PJLLanguage" value="PDF" />
<add key="T2.PJLLanguage" value="PCL" />

The configuration above will say that both printers will send the print job to Dispatcher Paragon server Server1 and in the case when Server1 is not reachable they will send it to Server2. It also says that jobs will be sent to the default (first) printer in PDF format and to the second printer in PCL format

Xerox devices

Xerox devices use XPIF templates. In order to have such option on these devices available XPIF tag must be specified for these devices (<add key="Tags" value="XPIF"/>)

Server fault tolerance

There is an option to configure Dispatcher Paragon server redundancy. If there are more than 1 Dispatcher Paragon server you can enter them into configuration file following way:

<add key="SafeQServer" value="servername1,servername2"/>

When the connector cannot connect to the first server from the list then it will go through the list and will try to connect to a different server.

Connect a second registered printer to different Dispatcher Paragon server

When it is necessary to connect the printer to a different server than the default one following lines might be written into the configuration (let's consider the printer name T2)

<add key="T2.SafeQServer" value="servername1,servername2"/>

Google Cloud Print Connector service

Below are listed keys in the configuration file (YSCloudPrintConnector.exe.config) which are used for print job processing.

Connector parameters

<!-- Address for mail notification -->
<add key="AdministratorMailAddress" value="" />
<!-- Time between to cycles of configuration file check -->
<add key="ConfigFileMonitorInterval" />
<!-- Socket connection accepttimeout–>
<add key="ConnectionTimeout" />
<!-- Levelof logging. Possible values ERROR|WARN|INFO|DEBUG|TRACE|VERBOSE. Defaultvalue is INFO. -->
<add key="LogLevel" value="VERBOSE" />
<!-- Sender of notification message -->
<add key="MailSender" />
<!-- IP address or SMTP relay -->
<add key="MailServer" />
<!-- Port of SMTP communication -->
<add key="MailServerPort" />
<!-- Is the SMTP server SSL -->
<add key="MailServerSSL" />
<!-- Time interval of ping request. -->
<add key="PingPeriod" value="5" />
<!-- IPv4 address of local NIC which will be used for outgoing http webrequest communication–>
<add key ="PreferredIPv4AddressToBind" />
<!-- IPv6 address of local NIC which will be used for outgoing http webrequest communication–>
<add key = "PreferredIPv6AddressToBind"/>
<!-- The user must log in to Google interactively and finish the registration of an anonymously registered printer -->
<add key="RegistrationWithInteractiveLogin" value="false"/>
<!-- Period in seconds which the job is re-sent to printer or SafeQ server when the previous sent was unsuccesful -->
<add key="ResendJobsInterval" value="10" />

<!-- Number of print jobs per day per user. -1 means unlimited-->
<add key="DailyQuota" value="-1" />

<!-- Exponent for RSA encryption -->
<add key="RSAExponent" value="4801039"/>
<!-- Modulus for RSA encryption -->
<add key="RSAModulus" value="500508224108203547434568832423132732786748672487709963870837598441542038970505962222995695772091500078249196262667760786525513352880061779408608234740013"/>
<!-- Idle time between to cycles of watchdog runs (in seconds) -->
<add key="WatchDogIdleTime" value="60" />
<!-- DNS name of Google endpoint server for XMPP communication -->
<add key="XMPPServer" value="talk.google.com" />
<!-- Name of Google endpoint server for XMPP communication -->
<add key="XMPPServerCertificateSubjectName" value="gmail.com" />
<add key="SpoolerPath" value="C:\SafeQ5\GoogleSpooler\"/> - defines local folder where documents will be downloaded to and processed
<add key="ResendJobsInterval" value="60"/> - when the transfer to Dispatcher Paragon server fails than the connector will try to resend the document again each ResendJobsInterval seconds

Properties maintained by the service

Token

<add key="RefreshToken" value="" /> - token which is used for gathering access token
<add key="AccessToken" value="" /> - token for authentication of robot account
<add key="AccessTokenExpiration" value="" /> - time till the access token is valid.<add key="OwnerName" value="" /> - Provided dedicated google account credentials
<add key="OwnerPassword" value="" /> - Provided dedicated google account credentials
<add key="XSRFToken" value="" /> - token gathered during registration of the first printer

Cluster configuration

In order to setup a cluster, make steps as follows (the appropriate license must be imported):

• Configure cluster nodes in the configuration file (see below).

• Install a connector on the first node.

• Make sure that the printer is registered in https://www.google.com/cloudprint#printers.

• Expand details of the registered printer and find the Proxy attribute of the printer.

• The value of the Proxy will be used as MACAddress attribute in the configuration file of the connector's second instance.

• Copy the configuration file of the first instance to the second.

• Remove parameters.

  • AccessToken.

  • AccessTokenExpiration.

• Add parameter MACAddress with the value from Proxy field of the registered printer.

• Install a second instance of the connector.

• Start the service.

Cluster configuration

<!-- Port which the job assignment server listens on -->
<add key="JobAssignmentPort" value="3110" />
<!-- Period of finished job list checking for jobs ready to unregister -->
<add key="JobExpirationCheckInterval" value="10" />
<!-- Retention time of downloaded job's registration -->
<add key="JobRetentionTime" value="60" />
<!-- Comma delimited list of nodes. The format is server1[:port],server2[:port] default port is 3110 -->
<add key="ClusterNodes" />

Print language conversion

The print job downloaded from Google is in PDF format. In order to make Dispatcher Paragon offline accountingpossiblethe format must be changed. The connector uses for conversionghostscripttool. It must be installed on the computer and following configuration parameters manages the conversion. The output devices are dependent on the GhsotScript version. Please make sure that the installed version ofghostscriptsupports configured devices. In the case of user conversion,you can configure the connector to use a user tool to convert the job's printing language as described below.

Print language conversion

<!-- In order to convert documents Ghostscript must be installed. -->
<add key="GhostScriptFullName" value="C:\gs\gs9.16\bin\gswin64c.exe" />
<!-- Parameters of ghost script for conversion to PCL -->
<add key="PCLConversionParameters" value="-dNOPAUSE -dBATCH -sDEVICE=pxlcolor"/>
<!-- Default value: PDF. Possible values for converion: PDF|PCL|POSTSCRIPT. Other emulations are not converted. -->
<add key="PJLLanguage" value="PDF" />
<!-- Parameters of ghost script for conversion to postscript -->
<add key="PSConversionParameters" value="-dNOPAUSE -dBATCH -sDEVICE=ps2write"/>
<!-- User print job conversion command (can be whatever exe/bat/cmd). Calling syntax: UserPDFConversionCommand outputfile inputfile -->
<add key="UserPDFConversionCommand"/>

The complete application settings section in the configuration file

Configuration file

<!-- Number of seconds till access token is refreshed (using refresh token). Default value: 3500. -->
<add key="AccessTokenTimeToLive" value="3500" />
<!-- Should be added a PJL header to the print job -->
<add key="AddPJLHeader" value="true" />
<!-- Address for mail notification -->
<add key="AdministratorMailAddress" value="" />
<!-- Capability device definition file -->
<add key="CddFile" value="YSCloudPrintConnectorCapabilities.cdd" />
<!-- Name of the application -->
<add key="ClientName" value="YSoftSafeQGoogleCloudPrintConnector" />
<!-- Comma delimited list of nodes. The format is server1[:port],server2[:port] default port is 3110 -->
<add key="ClusterNodes" />
<!-- Time between to cycles of configuration file check -->
<add key="ConfigFileMonitorInterval" />
<!-- Socket connection accept timeout -->
<add key="ConnectionTimeout" />
<!-- Is the database user the service account -->
<add key="DBIntegratedSecurity" value ="false"/>
<!-- Name of connector work database -->
<add key="DBName" />
<!-- Database user name (if not the service account is used) -->
<add key="DBUserName" />
<!-- Database user password -->
<add key="DBUserPassword" />
<!-- Name of the database server (it might be in form of servername or servername\dbinstance) -->
<add key="DBServerName"/>
<!-- Google domain which the connector belongs (only information) -->
<add key="Domain" value="" />
<!-- In order to convert documents Ghostscript must be installed. -->
<add key="GhostScriptFullName" value="C:\gs\gs9.16\bin\gswin64c.exe" />
<!-- Port which the job assignment server listens on -->
<add key="JobAssignmentPort" value="3110" />
<!-- Period of finished job list checking for jobs ready to unregister -->
<add key="JobExpirationCheckInterval" value="10" />
<!-- Retention time of downloaded job's registration -->
<add key="JobRetentionTime" value="60" />
<!-- The license is provided by Konica Minolta. In order to get the syntax of the license acquiring process (request, import) please run YSCloudPrintConnector.exe from the command prompt. -->
<add key="License" value="" />
<!-- Name of printer for print job release when SafeQ server is not used -->
<add key="LocalPrinterName" value="" />
<!-- Level of logging. Possible values ERROR|WARN|INFO|DEBUG|TRACE|VERBOSE. Default value is INFO. -->
<add key="LogLevel" value="VERBOSE" />
<!-- The PrintJob operation will be logged to database -->
<add key="LogToDatabase" value="false" />
<!-- Port on which the printer/safeq server listens when LPR protocol is used to transfer print job to SafeQ server -->
<add key="LPRPort" value="515" />
<!-- Proxy of the registered printer on Google -->
<add key="MACAddress" />
<!-- Sender of notification message -->
<add key="MailSender" />
<!-- IP address or SMTP relay -->
<add key="MailServer" />
<!-- Port of SMTP communication -->
<add key="MailServerPort" />
<!-- Is the SMTP server SSL -->
<add key="MailServerSSL" />
<!-- Provider of the connector (only information) -->
<add key="Manufacturer" value="Konica Minolta Corporation" />
<!-- Connector model (only information) -->
<add key="Model" value="YSoft Google Cloud Print Connector" />
<!-- Parameters of ghost script for conversion to PCL -->
<add key="PCLConversionParameters" value="-dNOPAUSE -dBATCH -sDEVICE=cljet5c"/>
<!-- command for user print emulation conversion. Calling syntax: PDFConversionCommand outputfile inputfile -->
<add key="PDFConversionCommand" value="" />
<!-- Time interval of ping request. -->
<add key="PingPeriod" value="5" />
<!-- PJL header template file -->
<add key="PJLHeaderTemplate" value="PJLHeaderTemplate.xml" />
<!-- Default value: PDF. Possible values for converion: PDF|PCL|POSTSCRIPT. Other emulations are not converted. -->
<add key="PJLLanguage" value="PDF" />
<!-- IPv4 address of local NIC which will be used for outgoing http webrequest communication-->
<add key ="PreferredIPv4AddressToBind" />
<!-- IPv6 address of local NIC which will be used for outgoing http webrequest communication-->
<add key = "PreferredIPv6AddressToBind"/> 
<!-- URL of proxy server (http://proxy:port/) -->
<add key="ProxyURL" />
<!-- Login of account to authenticate on proxy -->
<add key="ProxyUserName" />
<!-- Password of account to authenticate on proxy -->
<add key="ProxyUserPassword" />
<!-- Name of the priner which the connector is visible under after the registration -->
<add key="PrinterName" value="GCPConnector" />
<!-- Parameters of ghost script for conversion to postscript -->
<add key="PSConversionParameters" value="-dNOPAUSE -dBATCH -sDEVICE=ps2write"/>
<!-- The user must log in to Google interactively and finish the registration of an anonymously registered printer -->
<add key="RegistrationWithInteractiveLogin" value="false"/>
<!-- Period in seconds which the job is re-sent to printer or SafeQ server when the previous sent was unsuccesful -->
<add key="ResendJobsInterval" value="10" />
<!-- Exponent for RSA encryption -->
<add key="RSAExponent" value="4801039"/>
<!-- Modulus for RSA encryption -->
<add key="RSAModulus" value="500508224108203547434568832423132732786748672487709963870837598441542038970505962222995695772091500078249196262667760786525513352880061779408608234740013"/>
<!-- Coma delimited list of SafeQ server where the print job will be sent to. if the first server is unsuccessful then the next will be tried -->
<add key="SafeQServer" value="SafeQ501" />
<!-- Will be the print job kept on server till a request -->
<add key="SendOnDemand" value="false" />
<!-- URL (only information) -->
<add key="SetupURL" value="http://www.example.com" />
<!-- Folder where downloaded files will be stored before they are sent to SafeQ server or printer -->
<add key="SpoolerPath" value="C:\GoogleSpooler\" />
<!-- URL (only information) -->
<add key="SupportURL" value="http://www.example.com" />
<!-- Device type for job release SafeQ or LocalPrinter -->
<add key="TargetDevice" value="SafeQ" />
<!-- Private key for decoding of test license -->
<add key="TestRSAPrivateKey" value=""/>
<!-- URL (only information) -->
<add key="UpdateURL" value="http://www.example.com" />
<!-- User print job conversion command (can be whatever exe/bat/cmd)-->
<add key="UserPDFConversionCommand"/>
<!-- Idle time between to cycles of watchdog runs (in seconds) -->
<add key="WatchDogIdleTime" value="60" />
<!-- DNS name of Google endpoint server for XMPP communication -->
<add key="XMPPServer" value="talk.google.com" />
<!-- Name of Google endpoint server for XMPP communication -->
<add key="XMPPServerCertificateSubjectName" value="gmail.com" />

Prerequisites

• YSCloudPrintConnector is running.

• Dispatcher Paragon server is running.

• Dispatcher Paragon server is registered as Cloud Print Ready Printer.
  

Test

• Login to google as a user which is able to access the Dispatcher Paragon server as the Cloud ready printer.

• Go to http://Drive.google.com.

• Create a document.

• Print the document to the Cloud Ready Printer.

• Go to the http://www.google.com/cloudprint.

• Select Print Jobs.

• The document will be listed and the status will be Printed (it is sent to Dispatcher Paragon server).

• Login to MFD.

• Release the document.

Print the document when YSCloudPrintConnector is not running

• Login to google as a user which is able to access the Dispatcher Paragon server as the Cloud ready printer.

• Go to http://Drive.google.com.

• Create a document.

• Print the document to the Cloud Ready Printer.

• Go to the http://www.google.com/cloudprint.

• Select Print Jobs.

• The document will be listed and the status will be queued.

• When the YSCloudPrintConnector is running again than the job will be delivered to Dispatcher Paragon server.

Print the document when Dispatcher Paragon Server is not available

• Login to google as a user which is able to access the Dispatcher Paragon server as the Cloud ready printer.

• Go to http://Drive.google.com.

• Create a document.

• Print the document to the Cloud Ready Printer.

• Go to the http://www.google.com/cloudprint.

• Select Print Jobs.

• The document will be listed and the status will be In Progress.

• When Dispatcher Paragon server is available again than the job will be delivered to Dispatcher Paragon Server.