Open navigation

AutoConnect: Printer mapping without print servers

AutoConnect features

Basic constellation

Templates and ports

Template permissions

Port pooling

AutoConnect configuration

Configuration

General tab

Printer Creation tab

Default Printer tab

Printers tab

High Availability tab

Dynamic Printer Matrix

Configuration

Input modes for search

Assigning templates

More table func­tions

Functional principle

IP range

Client type

User / Group

Variables

Map Additional Printers

Input modes for search

Sending and importing the configuration

Send configuration

Saving und import­ing the AutoCon­nect database

Script control

Using logon/logoff script

Storage destination for AutoConnect settings

Session-in-Session

Installation, licensing and configuration

Citrix ICA Client later installed


With AutoConnect it's possible to create printer objects automatically using tem­plates on a remote desktop (terminal server or virtual desktop). It is installed as a Windows service. AutoConnect is supplied with the ThinPrint Engine.

Note! The AutoConnect configuration using group policies is described in ThinPrint group policies.


AutoConnect features

  • Dynamic creation of printer objects in a remote desktop session, based on various cri­teria, e. g.:
  • Active Directory user or group name
    • Printer name or printer group name
    • Client (or host) name
    • Client IP address, IP range or IP group
  • Two methods for AutoConnect configuration:
    • Using an MMC snap-in (recommended for single terminal servers or virtual desktops)
    • Using a Group Policy Object (recommended for large environments)
  • Support of Output Gateway
  • Support of Connection Service


Basic constellation

  • ThinPrint Engine on a remote desktop as well as AutoConnect and Output Gate­way
  • ThinPrint Clients on workstations and/or local print servers and/or gateway appliances (e. g. ThinPrint Hub)

ThinPrint AutoConnect scenario with remote desktops

Templates and ports

Printers generated with templates by AutoConnect on the server are always installed on the same ThinPrint Port as the template. If printers are to print over several Ports, multiple templates for the same driver can be set up on various Ports.


Template permissions

So that each user only sees his/her printers – and not all printers installed on the server –, templates must be assigned the following permissions:

AdministratorsPrint, Manage documents, Manage this printer
SystemPrint, Manage documents, Manage this printer
if applicable: All Application PackagesPrint, Manage documents
  • Delete all permissions of other accounts.

Note! Templates must not be shared.


Port pooling

Port pooling on ThinPrint Ports can also be used with AutoConnect.


AutoConnect configuration

You can configure AutoConnect locally as well as remotely; for remote configuration AutoConnect must be installed on both machines.

  • Open the ThinPrint configuration. Select on the left AutoConnect.

Open AutoConnect configuration


Configuration

  • Click on Edit will open the AutoConnect configuration.

AutoConnect configuration: General tab


General tab

In the General tab the default value for the connection protocol between AutoConnect and ThinPrint Clients can be selected. If you select TCP/IP or Virtual Channel (ICA or RDP), you restrict the communication to a protocol family. The Auto setting allows both protocol families and is therefore recommended for ICA / RDP / PCoIP as well as TCP/IP ThinPrint Ports. In Dynamic Printer Matrix (see below) you can limit this setting per rule; here, the columns T, R, I and P correspond to the protocols TCP/IP, ICA, RDP and PCoIP. 

Furthermore, you can decide here which AutoConnect events are to be logged and displayed in the AutoConnect Diagnostics table.

For Configuration databases see Storage destination for AutoConnect settings (see below).


Printer Creation tab

In the Printer Creation tab you can determine

  • whether the users may manage their session printers themselves.
  • when the printers are to be created or mapped:
    • Either at each session logoff / logon
    • Or when disconnecting and reconnecting a session.
  • Restart the TP AutoConnect Service afterwards.

Note! From the time when the option ThinPrint Self Service is enabled, the printers of users who log on to a session for the first time aren’t created or mapped automatically anymore. The tables Map Additional Printers and Dynamic Printer Matrix then provide the input for printers to be selected.

In case you use only the Map Additional Printers table for connecting printer shares you can speed up AutoConnect using the option Disable Dynamic Printer Matrix.

AutoConnect configuration: Printer Creation tab


Default Printer tab

Using the settings in the Default Printer tab you can set whether the session’s default printer should be changed by AutoConnect and – if yes – which information is to be used to change it:

  • either the last choice by the users in the session or in ThinPrint Self Service (Apply default printer from user settings)
  • or the current printer of the relevant ThinPrint Client in case of using Dynamic Printer Matrix (Default printer set by administrator for ThinPrint Client has priority)
  • or the Default column of the Map Additional Printers table (Default printer set by administrator in Map Additional Printers has priority)

AutoConnect configuration: Default Printer tab


Printers tab

In Printers tab you can control the naming convention of the printers to be created. With Session ID you determine that the session number is shown at the end of the printer name. In this case, the real address information for sending print data will be stored in the Windows Registry. The alternative option with the address information in the printer name is described in the Naming convention section.

Furthermore you can set the user rights for the printers to be created: Print, Man­age Documents (default) or Print, Manage Printers and Documents. The permis­sion Manage Documents allows, among other things, “hanging” print jobs to be deleted. Manage printers allows, among other things, printers to be deleted.

Under Printer name contains the preference, specify whether the printer names to be created should include the Client name (= computer name) or the Client IP address. If the client name cannot be detected, the client IP address is automatically entered (TCP/IP only).

Furthermore you can decide which properties of a local installed printer or driver are to be transferred to the session printer’s properties:

  • The Comments and Location columns of the local printers folder
  • The native printer driver’s properties Paper size, Color, Paper source, Print on both sides, Print quality and Finishing options.
  • Click Apply or OK to confirm your settings.

AutoConnect configuration: Printers tab (part 1)


Other settings in the Printers tab relate to all printers, including those that are mapped from ThinPrint Servers.

If users carry out changes to printers themselves, then these will be stored in the configuration database for User-specific printer preferences (see the General tab), if the Automatically save changes to printer properties option is enabled here.

If these stored settings are to be applied to newly created printer objects, or those yet to be connected, then the Create printers with user-defined properties option must also be enabled.

AutoConnect configuration: Printers tab (part 2)

Note! For transfer of printer properties from ThinPrint Clients to Output Gate­way objects on print servers or Management Services can be used alternatively.


High Availability tab

See High availability and load balancing.


Dynamic Printer Matrix

With Dynamic Printer Matrix, you can specify which templates should be used for creating a session printer.

  • Select the Dynamic Printer Matrix in the console tree.

Selecting Dynamic Printer Matrix


Configuration

  • Double-clicking in the table or selecting Edit in the context menu will open the configuration console of Dynamic Printer Matrix. Use the Buttons (upper arrow) to edit the table.

See Syntax: Dynamic Printer Matrix when you want to use filter rules like IP ranges or AD groups.

Editing Dynamic Printer Matrix


Legend:

Table elementMeaning
inserting a row above the current one
inserting a row below the current one
removing selected rows
moving a row up
moving a row down
• rule 1: locally on a client machine created printers won’t be included
• rule 2: shared printers connected to a client machine won’t be included; their names contain a backslash (\) at the first position (see Printer Name column)
• import from a CSV file (this can be created using the Management Services)
Caution: Existing rows will be overwritten – without warning!
IP Range/GroupIP address, IP range or IP group in which the client is located
Client Nameclient’s hostname; multiple clients are separated by the pipe character (example: client12|client13|workstation27)
Driver Nameprinter driver name
Printer Nameprinter name; with local connected printer shares a backslash (\) is on the first position
Class Namename of (any) printer class
User/Groupuser or group from the Active Directory
WWindows clients allowed
AApple Macintosh clients allowed
LLinux/Unix clients allowed
JJava clients allowed
TThin clients allowed
xother client types allowed
Tprotocol: ThinPrint TCP/IP
Rprotocol: RDP
Iprotocol: ICA
Pprotocol: PCoIP
Target Printer
template printer name without _#
• optionally in the Target Printer column: finding shared printers in the network
• Here, simply the print server name must be given, then a list of all printers of this server will be shown.
• see also Input modes for search (below)
Commentany comment

Note! In ThinPrint versions before 11.0, AutoConnect has treated a single hidden protocol column as not matching. If, for example, an ICA type of Thin­Print Client was detected by AutoConnect and the ICA column was hidden then no rule (row) of Dynamic Printer Matrix was matching. With version 11, the new functionality of a hidden column is that this column is ignored within each rule (row). This means that it would not matter whether the respective protocol or client type is true or not.


The search box can be used in two ways:

  • Direct search:
    • Even when entering just one character, all matches are listed immediately. With every additional character, the number of matches decreases accordingly.
  • Debug search:
    • By using keywords, an AutoConnect query can be simulated. Here, the entries are not only compared to the entries in the table (as opposed to Direct Search), but the entries are evaluated.
    • So, you can easily see the relevant rows for a specified client or user. This can be helpful for support purposes.
    • When entering more than one key, use commas to separate.
    • Keys: IP, Client, Driver, Printer, Class, User
    • If you enter a user name, also user groups in which the user is a member will be found.
    • With IP addresses also IP ranges will be found in which the entered IP address is enclosed.
    • If you enter words, items with wildcards will be found if the entered string and an item match.
    • Checkbox search in columns <key>:true
    • Keys:
    • Win, Mac, Linux, Java, Thin (for thin clients), CE (for Windows CE), TCPIP, RDP, ICA

Example for debug search:

User5 from the domain ourdomain.local establishes a session from Client7 with the IP address 192.168.14.10. To figure out the very rows used by Auto­Connect, you could enter:

IP:192.168.14.10, Client:Client7, User:ourdomain\user5


Assigning templates

Dynamic Printer Matrix assigns any printer to a specific template. For example, the
_#ICA_32
template is assigned to the HP DeskJet printer and for a cer­tain IP range is given the
_#ThinPrint Output Gateway template.

All printer and class names listed in the ThinPrint Client can be translated, includ­ing printers which are connected to a shared printer (on a local print server); e. g., the printer Alps MD-1000.


Dynamic Printer Matrix entries


With editing the Target Printer column you can simply select a template from the table shown below.

Template printers are shown at the bottom as necessary


When you've done all changes then you need to acknowledge them. 

Publish or discard changes

  • By clicking Publish you acknowledge your changes and they will be saved in the given AutoConnect database (see  Storage destination for AutoConnect settings, below) or by clicking Discard All no changes will be saved.


More table func­tions

You have the option of hiding unneeded columns. In all cases, hidden columns (and their rules) are deactivated.

Dynamic Printer Matrix: hiding columns


Functional principle

When you start a remote desktop session or reconnect to an existing session, AutoConnect is activated automatically. Then it processes the table from top to bottom, for each printer activated in ThinPrint Client. If all criteria (columns) in one line are met for the first printer AutoConnect searches for the template specified in the col­umn Target Printer (without _#) and creates the session printer using the applica­ble template properties. AutoConnect now stops the search for this printer in the table and, if applicable, continues the same procedure for the next activated printer in ThinPrint Client etc. etc. You can change AutoConnect’s processing sequence by switching the line order using the arrow keys ( ). You can also add or delete lines.

In the table, * and ? can be used as wild cards. The Target Printer column rep­resents the template name (without _#).

These features are explained in the scenarios below; the scenarios can also be combined with each other.


Scenario: Remote offices and home users with various connections

connections with different bandwidths require different bandwidth limits

Each type of connection uses a different IP address range. Different bandwidths, print protocols, and parameters can be assigned to each of them.


IP range

The IP Range column in the Dynamic Printer Matrix could contain, for example, the following entries:

192.168.1.136

192.168.1.1–192.168.1.150

192.168.1.0 / 24

192.168.128.0 /22

192.0.0.0 / 8

A separate template is given as each target; printers with different properties will thus be mapped in the respective remote desktop session.

The default entry in IP Range is: 0.0.0.0–255.255.255.255

The 24 represents the following subnet mask: 255.255.255.0; i. e., 3 x 8 = 24 set bits (22 is equivalent to 255.255.252.0; 16 is equivalent to 255.255.0.0; and 8 is equivalent to 255.0.0.0).


Scenario: Native Printing or Driver Free Printing

Windows clients can use Driver Free Printing, all other print with a native driver

All Windows clients are to use Driver Free Printing; i. e., to print with the ThinPrint Output Gateway virtual printer driver. The client type W is therefore selected for them. All other clients are to use one or more native printer driver.


Client type

On the one hand you can select between the client platforms Windows (W), Mac OS X (A), Unix or Linux (L), Java (J), thin client (T) and other (x), and on the other hand between the connection protocols TCP/IP (T), RDP (R), ICA (I) and PCoIP (P). By default, all client types are selected. If specific translation rules are only to apply to selected client types, then, they are easily selected by simply adding or removing a checkmark. In the fol­lowing table, as an example, the _#ThinPrint Output Gateway template is assigned to all Windows clients . All other client types use the _#HPLaser template, which uses a native printer driver.

WALJTxTRIPTarget Printer
-----ThinPrint Output Gateway
-HPLaser


User/Group

The User/Group column in the Dynamic Printer Matrix could contain names of local or domain users or groups.


Variables

Variables can also be used in the column Target Printer, however, they are restricted to connections to printer shares. Refer to ThinPrint Engine on print servers.


Map Additional PrintersSelecting Map Additional Printers


In contrast to the Dynamic Printer Matrix, with Map Additional Printers you can map any network printer (share on a print server) – regardless of that ThinPrint Cli­ents or a print server with a ThinPrint Engine installed on are available.

See Syntax: Map Additional Printers when you want to use filter rules like IP ranges or AD groups.

Editing Map Additional Printers

Legend:

Table elementMeaning
inserting a row above the current one
inserting a row below the current one
removing selected rows
moving a row up
moving a row down
• import from a CSV file (this can be created using the Management Services)
Caution: Existing rows will be overwritten – without warning!
Default
• set as user’s default printer in the session
• see also Default printer (see above) and Printer groups
User/Groupuser or group from the Active Directory
IP Range/GroupIP address, IP range or IP group in which the client is located
Client Nameclient’s hostname
Target Printer/Group• shared printer in the network
syntax: \\print-server\share-name or
\\HA-group\share-name
printer group
• in the Target Printer/Group column: finding shared printers in the network
• Here, simply the print server name must be given, then a list of all printers of this server will be shown.
• see also Input modes for search (below).
Commentany comment

When you've done all changes then you need to acknowledge them.

Publish or discard changes

By clicking Publish you acknowledge your changes and they will be saved in the given AutoConnect database (see Storage destination for AutoConnect settings, below) or by clicking Discard All no changes will be saved.


Input modes for search

The search box can be used in two ways:

  • Direct search:
    • Even when entering just one character, all matches are listed immediately. With every additional character, the number of matches decreases accordingly.
  • Debug search:
    • By using keywords, an AutoConnect query can be simulated. Here, the entries are not only compared to the entries in the table (as opposed to Direct Search), but the entries are evaluated.
    • So, you can easily see the relevant rows for a specified client or user. This can be helpful for support purposes.
    • When entering more than one key, use commas to separate.
    • Keys: User, IP, Client
    • If you enter a user name, also user groups in which the user is a member will be found.
    • With IP addresses also IP ranges will be found in which the entered IP address is enclosed.
    • If you enter words, items with wildcards will be found if the entered string and an item match.
    • Checkbox search in columns <key>:true

Example for debug search:

User5 from the domain ourdomain.local establishes a session from Client7 with the IP address 192.168.14.10. To figure out the very rows used by Auto­Connect, you could enter:

IP:192.168.14.10, Client:Client7, User:ourdomain\user5


Sending and importing the configuration

Similar to the port configuration, AutoConnect also has additional options of Send Configuration and Import from Management Services.

When sending, the AutoConnect configuration is sent to other computers with the exception of Dynamic Printer Matrix or Map Additional Printers tables – these are included in AutoConnect’s configuration database and can be assigned by setting the storage destination (see Storage destination for AutoConnect settings, below) or by copying the database file.

Using the import function, CSV files which come from Management Services can be read in (see above import from a CSV file).

Caution! With Send and Import, an existing AutoConnect configuration will be overwritten – with Import without warning!


Send configuration

The Action→ Send Configuration function lets data from the AutoConnect config­uration be sent to groups of servers; see also Procedure when sending.

Once you are finished configuring AutoConnect, click Apply or OK.


Saving und import­ing the AutoCon­nect database

Saving the AutoConnect database can be done in two different ways. First of all you could save the database after changing something via Save Table As.

It can be done as an alternative via rightclicking the snap-in AutoConnect and choose Save Table As.

Saving the AutoConnect database

As well via rightclick on the snap-in AutoConnect you can choose Open Tables from and import a saved AutoConnect database. You can import the database on the same server you saved it or on a other server with a ThinPrint Engine installed. 


Script control

If you want to run AutoConnect from the Command Prompt or using a script, amongst other the following parameters can be used:

ParameterFunction
-v(Verbose) Display messages; give detailed information at startup
-dDelete the printer(s) for a specific session
-dlDelete only local printers (on remote desktops)
-dnDelete only connections to printer shares
-d session-IDDelete all printer(s) of a specific session (admins only). The session ID can be found in the printers folder under Location
-d allDelete all printers created with templates (admins only)
-r(Repair) Compares saved session information at actually existing printer objects (admins only)
-F xKeep AutoConnect running and restart every x seconds
-p port(Port) TCP/IP port number (if other than port 4000)
Note: The TCP port numbers in ThinPrint Port, AutoConnect, and ThinPrint Client must match.
-i protocol(Interconnection) Select protocol for connection to the ThinPrint Clients; overwrites AutoConnect dialog settings (acceptable values: TCPIP, VC, AUTO)
-a addressSpecification of IP address or client name of the computer on which a ThinPrint Cli­ent is running – i. e., of local print servers or external print servers of network printers (e. g., ThinPrint Hub or a device from SEH).
-LDisplay ThinPrint Client’s printer list
-I printer IDSpecification of selected printer IDs from ThinPrint Client – comma separated
-I dMap only ThinPrint Client’s Current printer
-? oder -h(Help) Will open parameter help panel

Script control also works for network printer objects which are created with the Dynamic Printer Matrix.


Using logon/logoff script

Running AutoConnect script-controlled or from the Command Prompt (in script mode):

  • Enter the AutoConnect cue in a remote desktop logon script.

Example for mapping of printers from a local print server or gateway appliance (192.168.10.20, ThinPrint Client installed) in C:\Program Files\Common Files\ThinPrint\:

tpautoconnect –d
tpautoconnect -a 192.168.10.20


Storage destination for AutoConnect settings

Since version 11.0, AutoConnect stores it’s settings in an SQLite database. If you use multiple terminal servers or a VDI and want to avoid duplication of the configuration tasks, you should therefore first move the location for this database from a local to a network drive:

  • To do so, open the AutoConnect settings.Since version 11.0, AutoConnect stores it’s settings in an SQLite database. If you use multiple terminal servers or a VDI and want to avoid duplication of the configuration tasks, you should therefore first move the location for this database from a local to a network drive.

In the General tab, you will find the storage location of the configuration database for the AutoConnect settings (Mapping) as well as the settings users have selected for preferences such as default printer or default paper tray (User-specific printer pref­erences).

  • To relocate the mapping database onto a network drive, firstly move the data­base from:

%ALLUSERSPROFILE%\ThinPrint\TPAutoConnect\TPACGlobal.db

into a shared folder on the network, to which the domain computer (the TP AutoConnect Service) has read permission and the administrators have write permission.

Note! You have to set up the access settings of the directory in the share per­missions as well as in the NTFS permissions.

  • Then, under Mapping, enter the UNC path to the new storage location. Confirm with OK or Apply.

Note! Under Mapping, specify the UNC path only when you have already moved the AutoConnect database there. Otherwise AutoConnect would try to remotely create a database that would then not work because the tables Dynamic Printer Matrix and Map Additional Printers missing. It’s also possible to move the local database later on and thus overwrite the incomplete remote one.

  • Restart the TP AutoConnect Service.

Note! You can use the AutoConnect group policy Specify mapping configura­tion file path (Mapping database) alternatively.

Changing the storage location for AutoConnect settings

Storage location for AutoConnect settings relocated onto a network drive

  • To relocate the databases with user settings onto a network drive, under User-specific printer preferences, you can enter the UNC path to the new storage location. On this, specify the database name with the user variable, e. g. %username%.db, since a separate database is required for each user. Confirm with OK or Apply and restart the TP AutoConnect Service.

Note! You can use the AutoConnect group policy Specify mapping configura­tion file path (Mapping database)  alternatively – especially when using the Desktop Engine installer role.

Storage location for user settings on a network drive


Session-in-Session

This feature makes it possible for client or network printers to be still available in a session, even when a further session is opened from within an existing one, or if you – from this (first) session – access a server or a virtual desktop that is already running a Published Application. Thereby, printers are mapped into the second session and print jobs are “passed on” from the second to the first server or desktop.

  • Open a further session from within an existing session:

Session-in-Session: Open a further session from within an existing session


Installation, licensing and configuration

You need a ThinPrint Engine on the machine on which the (second) session is running (right computer in Illus.) – that means a ThinPrint Engine on a remote desktops. A ThinPrint Client is installed on the client machine (in this example: a laptop), and an ICA or RDP client must be running.

The Session-in-Session component is installed on the “middle” computer. On remote desktops, this can be selected during the installation procedure via Custom Setup. Select Session in Session. This feature functions without any further configuration. An ICA or RDP connection is a prerequisite.

custom ThinPrint installation: Select Session in Session

If you also want to print from the “middle” computer, then you need two ThinPrint Engines.


Citrix ICA Client later installed

If you’ve installed a Citrix ICA Client after Session-in-Session, uninstall the Ses­sion-in-Session component via custom setup and afterwards rein­stall it.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.