Load Parameter Options for the iPrint Gateway

  • 3604883
  • 02-Jan-2008
  • 12-Oct-2016

Environment

Novell iPrint for NetWare Novell NetWare 6.5
Novell iPrint for Open Enterprise Server

Situation

This TID documents the command line switches available for the NDPS/iPrint Gateway on NetWare. To modify a Printer's Gateway Load command:

i. Go to Novell Remote Manager (https://[IPorDNSofPrintServer]:8009)
       - For Linux, go to https://[IPorDNSofPrintServer]/psmstatus) and skip step ii.
ii. Go to NDPS Manager Health (link on left frame)
iii. Click the link for a Printer Agent in the list
iv. Click the Configuration Options link
v. Modify the Gateway Autoload Command
vi. Click Apply
vii. Shutdown the Printer Agent
viii. Startup the Printer Agent

Resolution

STRICTLPR

Linux Example:
iprintgw PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH STRICTLPR

NetWare Example:
NDPSGW PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH STRICTLPR

Explanation: This feature is available with NDPSGW.NLM dated 13FEB2007 and later. A few printers require LPR connections to be made on a port that falls within a defined range (721-731). For those printers, use the STRICTLPR feature.

WaitOnPrinter=minutes_wait_on_printer_before_aborting_job
iPrint Example:
iprintgw PORT=LPR HOSTADDRESS=x.x.x.x PRINTERNAME=PASSTHROUGH waitonprinter=20

NetWare Example:
NDPSGW PORT=LPR HOSTADDRESS=x.x.x.x PRINTERNAME=PASSTHROUGH waitonprinter=20

Explanation: This feature is known to resolve the LPR Communication Failed issue when the Printer Agent is able to send print jobs to a printer, but fails on large jobs (either large in disk size or large number of pages). The usual pattern observed is; the job is sent, the job aborts, the job starts printing from the beginning again. This pattern is usually looped. This feature will cause the Gateway to wait up to X (the example of above shows 20) minutes before aborting and restarting the print job. This feature is helpful when sending large print jobs to slow or low memory printers.  This switch is not valid with RAW connections.

Throttle=seconds_pause_between_jobs
Linux Example:
iprintgw PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH THROTTLE=2

NetWare Example:
NDPSGW PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH THROTTLE=2

Explanation:
NDPSGW.NLM that ships with SP7 introduces a new feature that causes the Gateway to pause between print jobs. This feature has proven helpful when connecting LPR to a Windows LDP Service.

The steps to implement are similar to the steps above for the WaitOnPrinter. You can specify the number of seconds to pause between jobs. The above example creates a 2 second pause.  This switch is not valid with RAW connections.

USERNAME_CN
Linux Example:
iprintgw PORT=LPR HOSTADDRESS=x.x.x.x PRINTERNAME=PASSTHROUGH USERNAME_CN

Explanation:
This parameter is needed when you want the user name submitted to the printer in CN format.  For example, when the Novell Client is installed with the iPrint Client, the user name is submitted with the print job in this format:
joeuser.accounting.chicago.ozcorp
This is the full eDirectory name with the context in dot notation.
When the iPrint client is installed without the Novell client, the user name is submitted with the print job in this format:
joeuser@00:0a:95:9d:68:16
This is the Windows user with the Mac address.

When implementing the USERNAME_CN option, the workstation still submits the user name in the above two formats to the iPrint server, but then the iPrint server removes the .accounting.chicago.ozcorp context or @00:0a:95:9d:68:16 Mac address when submitting the print job data to the network printer.  The user will look like:
joeuser
This option is important when the network printer or print server receiving the print job requires the user name to be only the CN.

USERNAME_TRUNCATED

Linux Example:
iprintgw PORT=LPR HOSTADDRESS=x.x.x.x PRINTERNAME=PASSTHROUGH USERNAME_TRUNCATED
   Note: Feature available in SEPT2012 novell-iprint-server RPM and later.

NetWare Example:
Not available on NetWare.

Explanation: The iPrint Gateway sends the user name with the print job to the physical printer when using the LPR port configuration. The default behavior is to send the entire user name to the physical printer.  The user name can be long because the eDir context is part of the user name. Some printers have the ability to authenticate user names at the physical printer. However, some printers won't allow the user name to exceed 31 characters. If the user name must be truncated to 31 characters, use this USERNAME_TRUNCATED feature.

PORT=port_value port_specific_parameters
Linux Example:
iprintgw PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH
or 
iprintgw PORT=RAW HOSTADDRESS=[x.x.x.x]

NetWare Example:
NDPSGW PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH
or
NDPSGW PORT=RAW HOSTADDRESS=[x.x.x.x]

Explanation: The type of port to be used. Supported values are LPR, RAW and NULL. Most printers use LPR. Some printers use RAW, which defaults to PORT 9100. Other ports can be used by appending :port_number to the HOSTNAME or HOSTADDRESS. For example, 129.63.47.78:9101.

The PORT options apply to both NetWare and Linux.  With Linux, replace NDPSGW with IPRINTGW.

PRINTERNAME=
Linux Example: iprintgw PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH

NetWare Example: NDPSGW PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH

Explanation: When printing to the LPR port, the PRINTERNAME must be defined. Passthrough is used for most printers. For printers that need a specific LPR queue name, see KB 10080373.  This switch is not valid with RAW connections. 

The PRINTERNAME option applies to both NetWare and Linux. 

GETCOMMUNITYSTRING=

Specifies the community string to be used for SNMP Get and GetNext requests.  This option applies to both NetWare and Linux.

SETCOMMUNITYSTRING=

The community string to be used for SNMP Get and GetNext requests.  This option applies to both NetWare and Linux.

NOSNMP
Linux Example: iprintgw PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH NOSNMP
NetWare Example: NDPSGW PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH NOSNMP

Explanation: No SNMP traffic is generated by the gateway and printer status information, such as the information displayed on the printer, is not gathered. This switch is helpful when getting SNMP errors that affect the ability to print from specific printer types.

This option applies to both NetWare and Linux.

SPOLL=
Linux Example: iprintgw PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH SPOLL=60

NetWare Example: NDPSGW PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH SPOLL=60

Explanation: The base SNMP polling interval (in seconds). Only certain SNMP information, such as the printer's alert table and display console, is gathered at this polling interval.  When the SPOLL option is not set, the SNMP polling interval is 60 seconds.

This option applies to both NetWare and Linux.

JPOLL =
Linux Example: iprintgw PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH JPOLL=2

NetWare Example: NDPSGW PORT=LPR HOSTADDRESS=[x.x.x.x] PRINTERNAME=PASSTHROUGH JPOLL=2

Sets the job polling interval (in seconds).  When the JPOLL option is not set, the job polling interval is 2 seconds.

This option applies to both NetWare and Linux.