TFTP configuration file entries (IPv4)

TFTP configuration file entries (IPv4)


To provide additional configuration parameters for your HP Jetdirect print server, such as SNMP or non-default settings, you can download a configuration file using TFTP. This TFTP configuration file’s relative path name is specified in the BOOTP reply using the /etc/bootptab file’s T144 vendor-specific tag, or the ef standard BOOTP tag entry. The following is an example of a TFTP configuration file. (The # symbol signifies a remark and is not included in the file.)

Example HP Jetdirect TFTP configuration file

HP Jetdirect Print Servers tftp cfg TFTP configuration file entries (IPv4)

Set allow to enable subnet 192.168.10.0 with access to the printer. This specifies a host or network of hosts that can connect to the print server. Add up to 10 entries using TFTP, Telnet, or the embedded Web server. You can also specify single IP addresses for specific systems. The following list describes the example TFTP configuration file settings:
telnet-config Set to zero (0). Cannot use Telnet.
ews-config Set to one (1). Use the embedded Web server.
auth-trap Set to on. Send SNMP authentication traps.
trap-dest IP address of the system to send SNMP traps to.
set-cmnt-name Community name required in SNMP Set commands.

This table describes the TFTP command parameters supported by HP Jetdirect print servers. (Optional commands for the same function are shown in parentheses.)

TFTP configuration file parameters
General
passwd:     (or passwd-admin:)

Administrator’s password to control access to HP Jetdirect print server configuration parameters using Telnet, HP Web Jetadmin, or the embedded Web server. Enter up to 16 alphanumeric characters. Clear the password with a cold reset.
sys-location:      (or host-location:, location:)

Physical location of the printer (SNMP sysLocation object). Enter up to 64 alphanumeric characters. The default location is undefined.
sys-contact:     (or host-contact:, contact:)

Name of the network or device administrator (SNMP sysContact object) who administers or services the printer. Enter up to 64 alphanumeric characters. The default contact is undefined.
ssl-state:      (or ssl-redirect-config)

Print server’s security level for Web communication, using the following values:

1: Forced redirection to the HTTPS port. Use only HTTPS (secure HTTP) communication.

2: Disable redirection to HTTPS. Use both HTTP and HTTPS communication.

security-reset:

Reset security settings on the print server to factory default values. 0 (default): Do not reset. 1: Reset.
TCP/IP Main
llmnr:

Link local multicast name resolution (LLMNR). 0 (default): Disable. 1: Enable.
host-name:      (or sys-name:, name:)

Node name that appears on the HP Jetdirect configuration page. Default is NPIxxxxxx, where xxxxxx represents the last six digits of the LAN hardware address.
parm-file:

Path and file name whose contents are printed each time the print server is turned on. Enter up to 64 alphanumeric characters.
domain-name:

Domain name of the device, for example support.hp.com. Does not include the host name and is not the FQDN, such as printer1.support.hp.com.
pri-dns-svr:      (or dns-srv:)

IP address of the DNS server.
sec-dns-svr:

IP address of a secondary DNS server to use if the primary DNS server is unavailable.
pri-wins-svr:      (or pri-wins-srv:)

IP address of the primary Windows Internet naming service (WINS) server.
sec-wins-svr:      (or sec-wins-srv:)

IP address of the secondary WINS) server.
TCP/IP Print Options
9100-printing:      (or 9100-config:)

Print to TCP port 9100 on the print server. 0: Disable. 1 (default): Enable.
ftp-printing:      (or ftp-config:, ftp:)

Print through FTP. 0: Disable. 1 (default): Enable.
ipp-printing:      (or ipp-config:, ipp:)

Print through IPP. 0: Disable. 1 (default): Enable.
lpd-printing:      (or lpd-config:, lpd:)

Print using the line printer daemon (LPD) on the HP Jetdirect print server. 0: Disable. 1 (default): Enable.
banner:

Print a port-specific LPD banner page. 0: Disable. 1 (default): Enable.
interlock:      (or interlock-mode:)

Require an acknowledgement (ACK) on all TCP packets before allowing the printer to close a port 9100 print connection. Specify a port number and the parameter value. For current HP Jetdirect print servers, the port number is 1. For example, interlock 1 1 specifies port 1 and enable interlock. 0 (default): Disable. 1: Enable.
buffer-packing:      (or packing:)

Pack the TCP/IP data buffer.

0 (default): Pack the data buffer before sending to the printer.

1: Disable buffer packing. Data is sent to the printer as it is received.

write-mode:

Set the TCP PSH flag for device-to-client data transfers.

0 (default): Disable.

1: Enable the all-push option in all data packets.

mult-tcp-conn:

Allow multiple TCP connections.

0 (default): Enable multiple connections.

1: Disable multiple connections.

TCP/IP Raw Print Ports
raw-port:      (or addrawport:)

Additional ports for printing to TCP port 9100. Valid ports are 3000 to 9000, which are application-dependent.
TCP/IP Access Control
allow: netnum [mask]

Add entries to the host access list stored on the HP Jetdirect print server. Each entry specifies a host or network of hosts allowed to connect to the printer. The netnum parameter sets the network number or host IP address, and mask sets an address mask of bits applied to the network number and host address to verify access. Add up to 10 access list entries. If there are no entries, all hosts are permitted access. For example:

allow: 192.0.0.0 255.0.0.0 Allow hosts on network 192.

allow: 192.168.1.2 Allow a single host. The default mask 255.255.255.255 is assumed and is not required.

allow: 0 Clear the host access list.

For additional information, see Security features (V.38.xx).

TCP/IP Other Settings
syslog-config:

Allow syslog server operation on the print server: 0: Disable. 1 (default): Enable.
syslog-svr:      (or syslog-srv:)

IP address of the server that the HP Jetdirect print server sends syslog messages to.
syslog-max:

Maximum number of syslog messages sent by the HP Jetdirect print server on a per-minute basis. Allows administrators to control the log file size. 0: No restriction on the number of messages. 10 (default): Send a maximum of 10 messages per minute.
syslog-priority:

Filter messages sent to the syslog server. The filter range is 0 to 7, with 0 being the most specific, and 7 the most general. Only messages that are lower than the specified filter level (or higher in priority) are reported. 7 (default): Messages of all priorities are sent. 8: Disable. No syslog messages are sent.
syslog-facility:

Identify the source facility of a message. Typically used to identify the source of selected messages during troubleshooting. By default, the HP Jetdirect print server uses LPR as the source facility code. Use values of local0 through local7 to isolate individual or groups of print servers.
slp-config:

Use the service location protocol (SLP) operation on the print server. 0: Disable. 1 (default): Enable.
slp-keep-alive:

Number of minutes the print server waits between sending multicast packets on the network to prevent deletion from network device tables. The range is 1 to 1440 minutes. Some infrastructure devices, such as switches, delete active devices from their device tables because of network inactivity. 0: Disable.
ttl-slp:

IP multicast time to live (TTL) setting for SLP packets. The range is 1 to 15 hops. (A hop is the number of routers from the local network.). -1: Disable. 4 (default): Enable.
bonjour-config:

Use Bonjour. (Previously listed as multicast domain name system [mDNS services.) Bonjour is typically used for IP address and name resolution (through UDP port 5353) where a conventional DNS server is neither used or available. 0: Disable. 1 (default): Enable.
bonjour-service-name:

Bonjour service name. This name is persistent and is used to resolve a particular device or service if socket information (such as the IP address) changes from session to session. Apple Bonjour displays this service. The default service name is the printer model and the LAN hardware (MAC) address. Enter up to 64 alphanumeric characters.
bonjour-pri-svc:

Highest priority Bonjour service to use for printing. Set this using the following values:

1: Port 9100 printing

2: IPP port printing

3: Default LPD raw queue

4: Default LPD text queue

5: Default LPD auto queue

6: Default LPD binps (binary PostScript) queue

7 through 12: If user-specified LPD queues are defined, corresponds to user-specified LPD queues 5 through 10.

The default selection depends on the printer, typically port 9100 printing or LPD binps.

ipv4-multicast:

Receive and transmit IP version 4 multicast packets. 0: Disable. 1 (default): Enable.
HP Jetdirect Print Servers note TFTP configuration file entries (IPv4) NOTE:

If disabled, other protocols that use multicast protocols, such as Bonjour and SLP, might also be disabled without notification.

idle-timeout:

Seconds that an idle print data connection is allowed to remain open. The range is 1 to 3600 seconds. Since the card supports only a single TCP connection, the idle timeout balances the opportunity of a host to recover or complete a print job against the ability of other hosts to access the printer. 0: Disable. 270 (default): Enable.
user-timeout:      (or telnet-timeout:)

Seconds that a Telnet or FTP session is idle before it is automatically disconnected. The range is 1 to 300 seconds. 0: Disable. 900 (default): Enable.
HP Jetdirect Print Servers caution TFTP configuration file entries (IPv4) CAUTION:

Small values, such as 1 to 5, can disable the use of Telnet. A Telnet session can terminate before any changes are made.

ews-config:      (or web:)

Allow use of the print server’s embedded Web server. 0: Disable. 1 (default): Enable.
tcp-mss:      (or subnets-local:)

Maximum segment size (MSS) that the HP Jetdirect print server advertises for use when communicating with local subnets (Ethernet MSS=1460 bytes or more) or remote subnets (MSS=536 bytes). Use the following values:

0 (default): All networks are assumed to be local (Ethernet MSS=1460 bytes or more).

1: Use MSS=1460 bytes (or more) for subnets, and MSS=536 bytes for remote networks.

2: All networks are assumed to be remote (MSS=536 bytes), except the local subnet.

MSS affects performance by preventing IP fragmentation that can result in data retransmission.

tcp-msl:

Maximum segment life (MSL) in seconds. The range is 5 to 120 seconds. 0: Disable. 15 (default): Enable.
telnet-config:      (or telnet:)

Print server allows incoming Telnet connections. If disabled, you can regain access by changing the setting in the TFTP file and turning the print server on and then off, or resetting the print server to factory default values (cold reset). 0: Disable. 1: Enable. Allow incoming Telnet connections.
default-ip:

IP address to use when the print server is unable to obtain an IP address from the network during a forced TCP/IP re-configuration. For example, when turned off and then on or when manually configured to use BOOTP/DHCP.

DEFAULT_IP: Set the legacy default IP address 192.0.0.192.

AUTO_IP: Set a link-local IP address 169.254.x.x.

The initial setting is determined by the IP address obtained when first turned on.

default-ip-dhcp:

Periodically transmit DHCP requests when a legacy default IP address 192.0.0.192 or link-local IP address 169.254.x.x is automatically assigned.

0: Disable.

1 (default): Enable DHCP requests.

dhcp-arbitration:

Seconds that the print server waits for DHCP configuration offers. The range is between 1 and 10 seconds. 0: Disable. 5 (default): Enable.
web-refresh:

Time interval (1–99999 seconds) for embedded Web server diagnostic page updates. The range is between 1 and 99999 seconds. 0: Disable.
SNMP
snmp-config:

SNMP operation on the print server. 0: Disable. 1 (default): Enable SNMP operation.
HP Jetdirect Print Servers caution TFTP configuration file entries (IPv4) CAUTION:

Disabling SNMP disables all SNMP agents (SNMP v1, v2, v3), communication with HP Web Jetadmin, and firmware upgrades using HP downloading utilities.

get-cmnty-name:     (or get-community-name:)

Optional. Password to determine which SNMP GetRequests the HP Jetdirect print server responds to. If a Get community name is set, the print server responds to either a user-specified community name or the factory-default. Enter up to 255 alphanumeric characters.
set-cmnty-name:      (or set-community-name:)

Password to determine which SNMP SetRequests (control functions) the HP Jetdirect print server responds to. The community name of an incoming SNMP SetRequest must match the print server’s Set community name for the print server to respond. (For additional security, you can limit configuration access through the print server’s host access list.) Enter up to 255 alphanumeric characters.
auth-trap:     (or authentication-trap:)

Send SNMP authentication traps. Authentication traps indicate that an SNMP request was received, but the community name check failed. 0: Disable. 1 (default): Enable.
trap-dest:      (or trap-destination:)

Add a host’s IP address to the HP Jetdirect print server’s SNMP trap destination list. The list can contain up to six entries. To receive SNMP traps, the systems listed on the SNMP trap destination list must have a trap daemon that listens for the traps. The following is the parameter format:

trap-dest: <ip-address> [community name] [port number]

The default community name is public. The default SNMP port number is 162. (You must enter a community name to specify a port number.)

If a trap-dest follows a trap-community-name, the trap community name is assigned to those entries unless a different community name is specified in each trap-dest command.

To delete the table list, set trap destination to zero (trap-dest: 0).

By default the SNMP trap destination list is empty and does not send SNMP traps.

IPX/SPX
ipx-config:      (or ipx/spx:)

IPX/SPX protocol operation on the print server. 0: Disable. 1 (default): Enable.
HP Jetdirect Print Servers note TFTP configuration file entries (IPv4) NOTE:

On HP Jetdirect 635n print servers, by default all network protocols except TCP/IP are disabled.

ipx-unit-name:

Name assigned to the print server. By default, the name is NPIxxxxxx, where xxxxxx are the last six digits of the LAN hardware address. Enter up to 31 alphanumeric characters.
ipx-frametype:

IPX frame type setting available for your print server model. Set to AUTO (default), EN_SNAP, EN_8022, EN_8023, EN_II.
ipx-sapinterval:

Time in seconds that the HP Jetdirect print server waits between service advertising protocol (SAP) broadcasts on the network. The range is 1 to 3600 seconds. 0: Disable. 60 (default): Enable SAP broadcasts.
ipx-nds-tree:

Name of the Novell directory services (NDS) tree for this printer.
ipx-nds-context:

NDS context for the HP Jetdirect print server. Enter up to 256 alphanumeric characters.
ipx-job-poll:

Time in seconds that the HP Jetdirect print server waits to check for print jobs in a print queue. The range is 1 to 255 seconds. 0: Disable. 2 (default): Enable.
pjl-banner:      (or ipx-banner:)

Print an IPX banner using the printer job language (PJL). 0: Disable. 1 (default): Enable banner pages.
pjl-eoj:     (or ipx-eoj:)

IPX end-of-job notification. 0: Disable. 1 (default): Enable.
 pjl-toner-low:      (or ipx-toner-low🙂

IPX toner-low notification. 0: Disable. 1 (default): Enable.
AppleTalk
appletalk:      (or at-config:, ethertalk:)

Use AppleTalk (EtherTalk) protocol operation on the print server. 0: Disable. 1 (default): Enable.
HP Jetdirect Print Servers note TFTP configuration file entries (IPv4) NOTE:

On HP Jetdirect 635n print servers, all network protocols except TCP/IP are disabled by factory default.

DLC/LLC
dlc/llc-config:      (or dlc/llc:)

Use DLC/LLC protocol operation on the print server. 0: Disable. 1 (default): Enable.
HP Jetdirect Print Servers note TFTP configuration file entries (IPv4) NOTE:

On HP Jetdirect 635n print servers, all network protocols except TCP/IP are disabled by factory default.

Other Settings
link-type:

(For wired 10/100/1000T Ethernet.) Set the print server’s link speed (10, 100, 1000 Mbps) and communication mode (Full- or Half-Duplex). The available link-speed depends on the print server model. The communication modes are: AUTO, 1000FULL, 100AUTO, 100FULL, 100HALF, 10FULL, 10HALF.

For AUTO (default), the print server uses auto-negotiation to configure the highest link speed and communication mode allowed. If auto-negotiation fails, either 100TX HALF or 10TX HALF is set, depending on the detected link speed of the hub/switch port. (A 1000T half-duplex selection is not supported.)

upgrade:

Set the name and location of a firmware upgrade file for the HP Jetdirect print servers.
HP Jetdirect Print Servers caution TFTP configuration file entries (IPv4) CAUTION:

Ensure that command parameters are properly entered. Verify that the upgrade file is a higher version than the currently installed version. The print server attempts to upgrade when the upgrade file contains a higher version than the installed version.

The following is the command format:

upgrade: <TFTP server IP> <Version> <Product Number> <Filename>

The following defines the parameters:

<TFTP Server IP> IP address of the TFTP server.

<Version> Firmware version of the upgrade file.

<Product Number> Print server product number.

<Filename> Path and filename of the firmware upgrade file.

usb-mode:

USB port communication mode on the HP Jetdirect print server.

Auto (default): Automatically negotiate and set the highest communication mode possible for the attached printer or device.

MLC: HP proprietary communication mode (multiple logical channels) that allows multiple channels of simultaneous print, scan, and status communications.

BIDIR: Standard connection that supports bi-directional communication between the printer and print server. The print server sends print data and receives status from the printer.

UNIDIR: Standard connection in which data is transferred in one direction only (to the printer).
status-page-lang:

Page description language (PDL) that the print server uses to send the HP Jetdirect configuration/status page to the printer.

Auto (default): Auto-detected when the print server is turned on or after a cold-reset.

PCL: Hewlett-Packard Printer Control Language.

ASCII: Standard ascii characters.

HPGL2: Hewlett-Packard Graphics Language (v2).

PS: PostScript language.
network-select:

(For HP Jetdirect products with a dual wired/wireless port.) Specifies the active behavior of the print server.

Auto (default): Automatically determines the active port. If a network cable is attached, then only the IEEE 802.3 wired port is active. If a network cable is not attached, only the IEEE 802.11g wireless port is active.

Wired: Only the 802.3 wired port is active.

Wireless: Only the 802.11g wireless port is active.
HP Jetdirect Print Servers caution TFTP configuration file entries (IPv4) CAUTION:

If you plug in a network cable on an active wireless network, wireless use of the device is terminated.

Support
support-name:      (or support-contact:)

Identify the name of a person to contact for support of this device.
support-number:

Phone number or extension to call for support of this device.
support-url:

Web URL for product information on this device over the Internet or an intranet.
tech-support-url:

Web URL for technical support over the Internet or an intranet.
HP Jetdirect Print Servers TFTP configuration file entries (IPv4)