Creating the Drivers, PrinterY, and FaxY sections

The Drivers section lets you specify print and fax drivers installations. It contains a single entry for each installation, which references the PrinterY or FaxY sections, or both. Each key in the Drivers section results in the installation of a driver and creation of a printer object when the necessary information is provided.

Key

Description

CfgEntry

This is the name of the configuration. By default, this is the driver model name.

Note: To use this key, make sure to include the Configurations key in the Install section.

CfgFile

This is the fully qualified path to the driver configuration (ldc) file that contains the configuration that you want to apply.

Note: To use this key, make sure to include the Configurations key in the Install section.

CfgType

This is the type of configuration that you want to apply to the printer object.

When setting the CfgType key, choose from the following parameters:

  • RunOnce—The configuration applies to a single printer object.

  • Persistent—The configuration applies to all subsequent printer object that do not have their own configurations.

Note: To use this key, make sure to include the Configurations key in the Install section.

Comment

This lets you enter messages in the Comment field of the Printer Properties.

Note: This value is optional.

Default

This lets you select the printer object as the default printer on the target computer.

Note: This value is optional and has no impact on local installations.

Location

This lets you enter messages or addresses on the Location field of the Printer Properties.

Note: This value is optional.

Model

This is the model name of the driver.

Note: This value is required.

Name

This is the name of the printer object. The name can be any value that is supported by the operating system of the target computer.

Note: This value is required.

Port

This specifies which port to use when creating the printer object.

Notes:

  • This value is required for network installations. If you need to create a new port during installation, then the value must reference a key in the Ports section.
  • The value may be omitted for local installations.
  • To use the Travel Print port for a printer object, make sure the TravelPrint key is installed in the Install section, and then set to Travel Print Port.
  • You can exclude a corresponding entry in the Ports section when the port that you want to use already exists in the target computer. Make sure to specify the port name as the value of the key. For example: Port=File: or Port=LPT1:
RealName

This is the driver name of the printer model that will be used.

Notes:

  • This value is required.
  • This is typically the model name with the Stream value appended at the end.
Share

This lets you specify whether or not to share the printer.

Notes:

  • This value is optional.
  • Before installing the printer, make sure to configure the operating system to allow file and print sharing.
ShareName

This is the name that other users see when pointing to the shared printer.

Note: If you want to share the printer, then this value is required.

Stream

This is the data stream of the driver.

Notes:

  • This value is required.
  • You can use the following values: PS (for PostScript), PCL (for PCL 5), PCLXL (for PCL 6), and HBPGDI (for host-based drivers).

Notes:

Sample Drivers section

[Drivers]
Printer1=1
Fax1=1

Sample PrinterY section

[Printer1]
Model=Universal v2
Name=Universal v2 XL
RealName=Universal v2 XL
Stream=PCLXL
ShareName=Universal v2 XL
Port=StandardIPExample
Share=0
Comment=0
Location=0
Default=1
CfgFile=C:\Configuration\A4.ldc
CfgEntry=A4
CfgType=RunOnce

Sample FaxY section

[Fax1]
Model=Universal Fax
Name=Universal Fax
RealName=Universal Fax
Stream=PS
ShareName=Universal Fax
Port=StandardIPExample
Share=0
Comment=0
Location=0
Default=0
CfgFile=C:\Configuration\A4.ldc
CfgEntry=A4
CfgType=RunOnce