Printer Server Command Reference Guide Revision 5.
Information contained in this document is believed to be accurate and reliable. However, Emulex Corporation assumes no responsibility for its use nor for any infringements of patents or other rights of third parties which may result from its use. Emulex Corporation reserves the right to change product specifications at any time without notice.
Table of Contents CONVENTIONS ..................................................................................................................... 1 FORMATTING.................................................................................................................... 1 WHAT IS A COMMAND? .................................................................................................... 1 COMMAND LINES .................................................................................................
ii Command Reference Guide PASSWORDS .................................................................................................................... 12 PRIVILEGED ACCESS ...................................................................................................... 12 SET PRIVILEGE PASSWORD ............................................................................................. 13 CHANGE LOGIN PASSWORD .....................................................................................
Table of Contents iii PROTOCOLS .................................................................................................................... 26 ENABLE OR DISABLE PROTOCOLS .................................................................................. 26 SHOW NETBIOS CHARACTERISTICS................................................................................ 27 APPLETALK....................................................................................................................
iv Command Reference Guide LOAD/DUMP CONFIGURATION..................................................................................... 40 DEFINE TCP/IP LOAD HOST........................................................................................... 40 DEFINE SERVER LOAD.................................................................................................... 40 DEFINE SOFTWARE FILE NAME ......................................................................................
Command Reference Guide 1 Conventions This guide provides the correct syntax for commands used with Emulex printer servers containing software release 5.0. This section describes both general and command conventions used in this document and in other printer server documentation. NOTE: The user must login to the printer server to perform an Emulex printer server command. Formatting You will notice text boxes labeled NOTE or CAUTION. • Notes provide additional information.
2 Command Reference Guide Command Lines A command line begins with the symbol >, contains the word “Server” and a prompt. Prompts A prompt consists of the word Server followed by one or two greater than symbols (>). One (>) indicates nonprivileged status and two (>>) signify privileged or supervisor status. The two prompts are shown below: Server > (nonprivileged users) Server >> (privileged users) Nonprivledged users have read only privileges.
Command Reference Guide 3 Options Options are used to customize a command. When available, the user should always use options. They are italicized and enclosed in brackets. > Server>> [set |define |change] server dhcp n m [temp] [default] temp default an optional entry an optional entry Quotation Marks When case-sensitive information is required, it must begin and end with quotation marks. Font names are case-sensitive and must appear in quotes within command lines.
4 Command Reference Guide Keyword Functions Keywords either modify data (set, define or change), remove data (clear, purge, or delete), or display requests (show, monitor, or list). Set, Define And Change set define change Modifications are immediate and temporary (stored in volatile memory). Old port values will return when the port is logged out. Old node, server and service values return when the printer server is reinitialized.
Command Reference Guide 5 Show, Monitor And List show monitor list Displays current information stored in volatile memory. Similar to show, except the display is updated every second for privileged users or every 10 seconds for nonprivileged users. Displays information stored in non-volatile memory. Clear, Purge And Delete clear purge delete Data is removed temporarily, but returns at next reinitialization.
6 Command Reference Guide Command Summary In the summary below, all commands are presented alphabetically. If the keywords are either set, define or change, only change is listed. Page numbers are provided as a quick directory to find an explanation of the command.
Command Reference Guide 7 ip_addr] [set] [enabled |disabled] change service “servc_name” [port port_num] [TCPport_num] [password “pass_txt”] [protocol] [enabled |disabled] 44 crash 300 10 define node node_name [nfserver |npserver] 16 define port port_num appletalk backspoof [enabled |disabled] 27 define port port_num appletalk tbcp [enabled |disabled] 27 define server authorize protocol [all |none |specific] [enabled |disabled] 26 define server bootp n m [temp] 38 define server dhcp n m [temp]
8 Command Reference Guide help 10 initialize [server] [delay delay_min] [cancel] [flash] [default] [disabled] 11 logout [port port_num] 12 ping ip_address 12 set server privilege password “pass_txt” 13 set server prompt “prompt_txt” 25 show node node_name [gateway |syslog |nfserver |npserver] 14 show port port_num characteristics 17 show port port_num fonts 28 show port port_num status [netjet |device] 20 show server alarms 21 show server appletalk 27 show server characteristics 2
Command Reference Guide 9 • General Commands • Passwords • Node Commands • Port Commands • Server Configuration • Protocols • Load/Dump Configuration • Service Commands
10 Command Reference Guide General Commands Display Internal ARP Table Display or control the printer server’s internal address resolution protocol (ARP) table. > Server>> arp [-a] [-b] [-d] [-f] [-l] [-s] [-t] -a -b -d -f -l -s -t Displays the ARP table. Caches all ARP entries broadcast on the network. Deletes specified IP address entry. Fixes all entries in the table (turns off timer). Caches only locally addressed mappings. Allows addition of the server IP and MAC addresses. Turns on timer.
Command Reference Guide 11 Initialize Initialize NETQue printer servers and NETJet printer servers installed in Hewlett-Packard printers with MIO version 6.0 or above. > Server>> initialize [server] [delay delay_min] [cancel] [flash] [default] [disabled] server delay delay_min cancel flash default disabled Reinitializes the printer server. Indicates reinitialization will not take place until after a specified period of time. A number specifying the amount of delay in minutes. The default is 1 minute.
12 Command Reference Guide Logout Logout of a printer server port, disconnecting associated local or remote sessions. > Server>> logout [port port_num] port port_num Enter this option along with the port_num to log out of a port other than the one you are currently using. Leaving this option out will logout of your current port. The number of the port to be logged out. Check IP Address - Ping Test whether a local or remote IP address exists and is responding.
Command Reference Guide 13 Set Privilege Password Change the password a user must enter in order to use privileged commands. > Server>> set server privilege password “password” “password” Enter from 1 to 16 characters, enclosed in quotes. Default is System. This produces the same result as using the SU (super user) command. Change Login Password Specify the password users must enter at login to the printer server.
14 Command Reference Guide Node Commands The length of node names is dependent on the protocol. Any alphanumeric character may be used, along with: ‘$’, ‘-’, ‘_’, ‘.’. • NetWare node names can have a maximum of 47 characters • LAT node names can have a maximum of 16 characters • TCP/IP node names can have a maximum of 63 characters TCP/IP node names consist of a 1-16 character local node name and a domain name of 1-47 characters. This TCP/IP full node name always ends with a period (.).
Command Reference Guide 15 > Server>> [set |define |change] node node_name ip ip_address [tcpip] [gateway [default]] [syslog facility] node_name ip_address tcpip gateway default syslog facility Enter either the TCP/IP full node name or the IP address of the node. See naming conventions in beginning of this section. The IP address of the designated node in decimal dot notation. For example, 123.234.345.490 Establishes the node as a TCP/IP node in the server’s internal node table.
16 Command Reference Guide Define NetWare Node Define NetWare nodes as a Remote Printer or Preferred File Server. > Server>> define node node_name [nfserver |npserver] node_name nfserver npserver The name of the node to be affected. Defines the node as the Novell Preferred File Server. Only one nfserver node may be defined. Defines the node to act as a Novell Remote Printer. More than one npserver node may be defined. Delete Node Remove nodes from the printer server’s internal node table.
Command Reference Guide 17 Port Commands Show Port Characteristics Display the characteristics of a specified port. > Server>> [show |list] port port_num ch port_num The printer server port number. This command will display a detailed listing of all port options such as: local group, hardware group, network group, LAT_compatible group, and TCP/IP group. Test Port Verify the operation of a port by sending a test pattern of characters to the port. Terminate the test by pressing any key.
18 Command Reference Guide Change Port Access Specify the type of connections (access) the port can make. > Server>> [set |define |change] port port_num access [dynamic |local |remote |virtual |slprt |none] port_num dynamic local remote virtual slprt none Enter the port number whose access is being modified. Allows the port to originate and accept remotelyoriginated connections. This is a combination of remote and local access.
Command Reference Guide 19 Change Port Type Specify the type of terminal or printer connected to a port. > Server>> [set |define |change] port port_num type [ansi |hardcopy |softcopy] port_num ansi hardcopy softcopy Enter the port number. Specifies an ANSI-compatible terminal. Specifies hardcopy serial terminal like a teleprinter with a keyboard. Specifies a generic video display terminal. Change Line Feed Character Control the line feed character.
20 Command Reference Guide Change Port Speed Set the serial communication speed (baud rate) in bits per second. > Server>> [set |define |change] port port_num [input |output] speed baud_rate port_num input output baud_rate The port affected by speed change. Enter the speed at which data is received. If input speed is not chosen, the command sets the speed in both directions. Enter the speed at which data is transmitted. If output speed is not chosen, the command sets the speed in both directions.
Command Reference Guide 21 Server Commands Define Server Name Define the printer server’s node name. > Server>> define server name prnsvr_nam prnsvr_nam Enter a 1 to 16 character name for the printer server. This must be established with the Define command when any sessions are active. Any alphanumeric character is valid. The printer server’s node name is used in certain commands and by hostinitiated connections.
22 Command Reference Guide Show Server Characteristics Display the characteristics of the printer server. > Server>> [show |list] server characteristics This command will display a detailed listing of all printer server options such as local group, hardware group, network group, LAT_compatible group, TCP/IP group, and port IP address. This information is not continually updated since characteristic information does not change. Show Server Configuration Display port configuration information.
Command Reference Guide 23 Show Server Limits Display the current configurable memory table allocation. > Server>> [show |monitor] server limits Trial values are available for five printer server resources: queue, circuits, sessions, nodes and services. The Show Server Limits command does not alter the limits, but allows the user to experiment with trial values for these resources without changing the actual limits in the printer server. For example: > Server>> show server limit nodes 256.
24 Command Reference Guide Other Options Enable or disable special printer server options. > Server>> [set |define |change] server options option_list [all |enabled |disabled] option_list Enter a list of options from the available options section below. all Enables all options. enabled Adds the specified option to the existing option list. If not specified, the existing list is replaced by the new one. disabled Removes a specified option from the existing option list.
Command Reference Guide 25 Set Prompt Specify the prompt displayed when the printer server is in local mode and awaiting a printer server command. > Server>> set server prompt “prompt” “prompt” Enter 1 to 8 characters, enclosed in quotes. The default is “server”. The printer server always adds the string “>>“ after the prompt in privileged mode or “>“ when not in privileged mode. The RCF port will always display Local>.
26 Command Reference Guide Change Domain Specify the name of the local network’s domain or hierarchy within a network. > Server>> [set |define |change] server domain domain_name domain_name The printer server’s domain name, which can contain up to 48 alphanumeric characters including periods. Protocols Enable or Disable Protocols Enable or disable individual protocols.
Command Reference Guide 27 Show NetBios Characteristics Show NetBios characteristics. > Server>> [show |list] server netbios AppleTalk Show Server AppleTalk Show AppleTalk protocol is recognized by the printer server. > Server>> [show |list] server appletalk AppleTalk Backspoofing Enable or disable AppleTalk backspoofing on a port. > Server>> define port port_num appletalk backspoof [enabled |disabled] port_num enabled disabled Enter the printer server port number. Enables backspoofing on the port.
28 Command Reference Guide Show Fonts Display one or more port’s user-entered font list in Apple environments only. > Server>> [show |list] port port_num fonts port_num The printer server port number to which the inquiry is directed. Add Fonts - Apple Add PostScript font names to one or more ports’ font list in Apple environments on uni-directional ports. The number of font strings which can be stored depends upon available memory.
Command Reference Guide 29 “font_list” A list of PostScript font names set off by blanks and/or tabs and enclosed in double quotes. all Enter this option to remove all font names from the font list. NOTE Font strings are case-sensitive and must be enclosed in quotes. The asterisk character (*) may be used as a wild card in the font name; however, it must be the last character of the font name preceded by at least one alphanumeric character.
30 Command Reference Guide LAT Change Groups Select the LAT-compatible group code(s) for the printer server. These group codes apply only to locally defined LAT-compatible services and ports on the printer server. > Server>> [set |define |change] server groups group_list [enabled |disabled] group_list enabled disabled Enter the list of LAT-compatible group codes to modify (see explanation of group codes below).
Command Reference Guide 31 Change Authorized Groups Specify which group codes (groups of LAT-compatible services) are accessible to a port. The default is no groups authorized for port. > Server>> [set |define |change] port port_num authorized groups group_list [enabled |disabled] port_num group_list enabled disabled Enter number of the port that will be given access to the group. Enter the group or list of groups that will be assigned to the port. Enables specified groups access to a port.
32 Command Reference Guide Choose Frame Type Specify the order in which the printer server will handle NetWare frame types. > Server>> [set |define |change] server netware [default |802.2 |snap |802.3 |ethernet_II ether_type] default 802.2 snap 802.3 ethernet_II ether_type IPX will try 802.2, Ethernet II, 802.3, and 802.2 snap in order. The first one found will be selected. IPX will only look for 802.2 Ethernet frames. IPX will only look for 802.2 snap Ethernet frames. IPX will only look for 802.
Command Reference Guide 33 Define Required Fileserver The user must perform two operations to set up a Novell file server as the required file server for the Emulex printer server. 1) Define whether the printer server will attach to the required file server or preferred file server: > Server>> define server netware required [enabled |disabled] enabled disabled If enabled, the printer server will attach only to the required file server.
34 Command Reference Guide Define as Remote Printer Allow the printer server to emulate a NetWare Remote Printer. > Server>> [set |define |change] server netware rprinter [enabled |disabled] enabled disabled Enables remote printer emulation. Disables the remote printer emulation. Rediscover Interval Set the RPRINTER rediscovery interval, which queries the network for newly configured Novell print servers and starts all remote printers found.
Command Reference Guide 35 Forms Enable or disable the NetWare forms function. > Server>> define server netware forms [enabled |disabled] forms enabled disabled Use this to designate the NetWare form function. With forms enabled, the printer server will pause a print job that requires a different type of paper and wait for paper to be changed on the printer. The default is disabled. Selecting Bindery Emulation or NDS Mode Specify the discovery method used by PSERVER.
36 Command Reference Guide Define NDS Tree Specify the NDS Tree where the PSERVER object exists. > Server>> define server netware nds “tree_name” “tree_name” Enter the NDS tree name where the printer server is located, enclosed in quotes. The default is no NDS tree name. To clear, enter “” in its place. TCP/IP Commands Change TCP/IP Routing Modify a TCP/IP routing entry in the printer server’s internal routing table.
Command Reference Guide 37 Establish or Change TCP/IP Nodes Establish or change a TCP/IP node. > Server>> [set |define |change] node [node_name| ip ip_address] [tcpip |gateway [default] |syslog facility] node_name ip_address tcpip gateway default syslog facility Enter either the TCP/IP full node name or the IP address of the node. See naming conventions in beginning of this section. The IP address of the designated node in decimal dot notation. For example, 123.234.345.
38 Command Reference Guide Show TCP/IP Characteristics Display the printer server’s TCP/IP characteristics. > Server>> [show |list] server tcpip BootP, DHCP and RARP Parameters When the Emulex printer server reboots, the default sequence of IP address acquisition is to attempt BootP first; if BootP fails, attempt DHCP; if DHCP fails, attempt RARP. Use the following three commands will define how many times the printer server will attempt BootP, DHCP and RARP.
Command Reference Guide 39 Define DHCP Parameters Define how many times printer server will attempt DHCP. > Server>>define server dhcp n m [temp] n m temp Enter the number of times (between 0 and 7) to attempt DHCP if the server IP address is unknown. The default is 2. Enter the number of times to attempt DHCP if the server IP address is known. The default is 1. If entered, the acquired IP address is stored in volatile memory. Only “infinite” lease IP addresses are stored in non-volatile memory.
40 Command Reference Guide Load/Dump Configuration Configuring a load host or dump host will allow you to: • Upgrade printer server software. • Define a workstation to receive and record memory image dumps. Define TCP/IP Load Host Specify the TCP/IP host where the printer server’s operational software will load from. > Server>> define server preferred load ip ip_address ip_address Enter the IP address of the node where the operational software is stored in decimal dot notation. For example, 123.234.
Command Reference Guide 41 put decnet Use this keyword when the environment does not support BootP, DHCP, or TFTP server load requests to a printer server. Upon reinitialization, the printer server downloads its operational software from a network load host using standard decnetcompatible load protocol. The default is dec. Power must by cycled after this command is performed.
42 Command Reference Guide ip_address none IP address for both the load and dump functions. Enter the IP address of the gateway node in decimal dot notation. For example, 123.234.345.490. This address must be on the same subnet as the printer server. Enter none to remove an existing IP address. Although no IP address is chosen, the printer server attempts the load or dump operation without using a gateway.
Command Reference Guide 43 The dump will save a copy of the printer server’s memory to the specified workstation. > Server>> define server preferred dump ip ip_address ip_address Enter the IP address of the destination node in decimal dot notation. For example, 123.234.345.490. The default is none.
44 Command Reference Guide Service Commands Change Service Specify the name of the service to be established or modified. > Server>> [set |define |change] service “servc_name” [TCPport_num] [port port_num] [password “pass_txt”] [protocol] [enabled |disabled] “servc_name” Enter the name of the service to be created or modified, enclosed in quotes. The maximum length of service names depend on the protocol: NetWare - 47, LAT - 16, Apple 32.
Command Reference Guide 45 Define Service Establish or modify an AppleTalk service. > Server>> define service “servc_name” appletalk type “prn_type” “servc_name” Enter the name of the service, enclosed in quotations marks. “prn_type” Enter the type of printer. Delete Service Remove a service from the printer server’s service table. > Server>> [clear |purge |delete] service “servc_name” “servc_name” Enter the name of the service to be removed, enclosed in quotation marks (valid for Apple service).
