CentreWare has two modes that you may use to set up and configure printers. The primary mode is a graphical user interface (GUI), which allows ease of use, and a more sophisticated menu structure. The other mode is a TTY-based user interface (TTY), which can be used directly from any terminal window.

CentreWare can automatically detect whether your system's X server is capable of running in graphical mode or TTY mode and will start accordingly (using the display environment variable).

Graphical Mode

From a terminal window prompt type xpadmin [RETURN].

TTY Mode

From a terminal window prompt, type xpadmin -tty [RETURN].

Using CentreWare Features

This information provides detailed instructions on CentreWare and will familiarize you with the features and tools available with the CentreWare software.

Note that not all CentreWare features are available in TTY mode.

Requirements

A basic knowledge of the terminology of the printer.
The network interface on your printer connected to an active network with the appropriate cable.
CentreWare must be loaded on a supported workstation and connected to the same active network as the printer.
ROOT or superuser privileges to set up or change the configuration of a printer.

Key Features and Benefits

Feature	Benefit
Instant Status	Select a printer from the Printers List to see current printer status.
Remote Configuration	Configure and monitor tasks from your workstation.
Diagnostics	Troubleshoot from your desk.
Printer Upgrades	If your printer is equipped with Flash ROM, upgrade system or network software.
Link to Internet Services	Many Xerox printers are equipped with embedded http servers. For these printers, CentreWare for UNIX provides links to CentreWare Internet Services. Remote configuration for these printers is accomplished through Internet Services using your browser application.
SNMP	For Xerox legacy printers and non-Xerox printers CentreWare directly supports remote configuration.

Graphical Mode Features

Menu Bar

Located across the top of the screen, these options contain the drop-down menus used in CentreWare.

Tool Bar

Located below the Menu Bar, these buttons enable one-click access to Add Queue (Queue Setup (Add)), Internet Services, SNMP Services, and the online Help.

Printers List

The Printers List displays all printers which are supported by CentreWare. The display can include Hostname or System name, IP address, Hardware address, and printer type. You may customize the display using the Display Settings drop-down menu.

Click on any printer in this list to select it for configuration or monitoring.
Click Refresh to poll the network for supported printers and update the Printer List.

Printer Menu

You must log in with ROOT or superuser privileges to complete these procedures.

Queue Setup (Add)

The Setup Wizard guides you through the installation of a new printer. You can set up your printer for access using the following printing models:

Workstation to Printer - spool print jobs in a queue on your local workstation, which sends them directly to the printer.

Workstation to Print Server - spool print jobs from the local workstation to a queue on a print server, which sends them to the printer.

To print using this model, you must first run the Workstation to Printer installation model at the remote print server and note the queue name and IP address for use at any workstation which will print to this queue.

Print Server Setup - Use the Workstation to Printer installation model at the workstation that will be used as a print server. At each workstation that will print to this print server, run the Workstation to Print Server installation model and supply the TCP/IP address of the print server and queue name. Refer to your operating system documentation for any additional requirements necessary for print server setup.

Workstation to Printer Procedure

Access CentreWare for UNIX (graphical mode) by typing xpadmin.
Click Add Queue.

Select Printer>Queue Setup>Add.

In Queue name, enter the name for your queue.
From Printer Type, choose the printer.
From Printing model, select workstation to printer.
From Printer connection, choose a connection method for your printer.
In Printer host name, enter the host name or TCP/IP address of your printer.
From Default printer, select Yes to make this printer the default printer.

Note that CentreWare will recognize a default printer only if it is set up by CentreWare.

From Features, enable or disable print features when submitting a print job to your printer.
From User interface, enable or disable the graphical mode when submitting a print job to your printer.
From Banner page printing, enable or disable printing of a CentreWare banner page with each print job.
Click Configure Printer Features to change the default print options for your printer.
Click Configure Banner Page to customize the banner page for this queue. Up to three lines can be added to the standard banner page. Use $QUEUE to print queue name and $PRINTER to print Host name or IP Address.
When finished, click Apply.
Click OK to save your settings.
Run a test print from an application or select Tools>Test Print (in graphical mode) to verify printer operation.

The configured printer features (installable options, media type) apply to postscript print jobs only. PCL does not incorporate any configured features.

Workstation to Print Server Procedure

Access CentreWare for UNIX (graphical mode) by typing xpadmin.
Click Add Queue.

Select Printer>Queue Setup>Add.

In Queue name, enter the name for the queue created on the remote print server.
From Printer Type, choose your printer.
From Printing model, select workstation to print server.
From Printer connection, select a connection method for your printer.
In Print host name, enter the host name of the remote workstation to be used as a print server.
In Print server queue name, enter the queue name on the remote workstation used for your printer.
From Default printer, select Yes to make this printer your default printer.
From Features, enable or disable the setting of print features when submitting a print job to your printer.
From User interface, enable or disable the graphical mode when submitting a print job to your printer.
From Banner page printing, enable or disable the printing of a banner page with each print job.
Click Configure Printer Features to change the default print options for your printer.
Click Configure Banner Page to customize the banner page for this queue. Up to three lines can be added to the standard banner page. Up to three lines can be added to the standard banner page. Use $QUEUE to print queue name and $PRINTER to print Host name or IP Address.
When finished, click Apply.
Click OK to save your settings.
Run a test print from an application or select Tools>Test Print (in graphical mode) to verify printer operation.

The configured printer features (installable options, media type) apply to postscript print jobs only. PCL does not incorporate any configured features.

Server-based Printing Setup

Set up a queue on the server using the Workstation to Printer model with User interface (graphical mode) enabled.
On each workstation that will print to the printer, set up a queue to spool the print jobs on the server using your native operating system print administration tools.

NIS Server-based printing Setup

(as provided by your operating system)

Set up a queue on your print server using the Workstation to Printer model.
Define the queue in the NIS server's configuration map.
Execute XHOST +servername to allow ServerName X permissions.

Queue Setup (Copy)

Select Printer>Queue Setup>Copy.
Select a queue to copy from the Print Queue list.
Click Copy.
Make the desired changes to the connectivity options.
Click OK to save your changes.

Queue Setup (Delete)

Select Printer >Queue Setup>Delete.
Select the queue(s) to delete from the Print Queue List.
Click Delete to delete the queue and remain in the Delete Queue window.
Click OK to confirm the delete.

Queue Setup (Modify)

You can not modify the Queue name, Printer Type, Printing Model, or Connection Type.

Select Printer>Queue Setup>Modify.
Select a queue to modify from the Print Queue List.
Click Modify.
Make the desired changes to the queue features.
Click OK to save your changes.

Discovery

This feature enables you to find printers from multiple subnets on your network, and also query specific printers.

You cannot discover printers on the internet.

Subnet Address

Add/Set

Select Printer>Discovery.
Select the Subnet Address tab.
Enter the subnet address and subnet mask:

Subnet Address selects a range of subnets to search. A subnet address may be any valid node address within the subnet, for example 13.252.20.0.

Subnet Mask selects a range of TCP/IP addresses to search. This entry is automatically set to the default mask used by the workstation (255.255.255.0).

Click Add to add the subnet to the list.
When finished, click OK to exit.

Remove

Select the subnet address or mask to be deleted, then click Remove.

Local Network Interface Cards are displayed by default in the list and can only be enabled or disabled; not removed.

Enable/Disable

Select the subnet address or subnet mask, then click Enable/Disable.

Update Local Interfaces

Select to automatically refresh the list of local Network Interface cards.

IP Address

Selects a list of specific TCP/IP addresses to search.

To add an IP address, select the IP Address tab, enter the desired IP address, then click Add.
To remove an IP address, click the IP Address tab, select the IP address to be deleted, then click Remove.

Tools Menu

Test Print

Test Print sends a test file to a printer to verify printer operation.

Select Tools>Test Print, then click Send File to send the file to print.

Send File

Select Send File to locate a file to print on a selected printer.

Select Tools>Send File and locate a file from the displayed directory window, then click OK.
Click Filter to select a directory filter, which limits the file entries.

Upgrading Printers

Many of the printers that CentreWare supports are equipped with Flash ROM on the Main Controller card and/or the network interface. You can update these printers using the Tools menu.

You should consult your printer documentation to determine if your printer is equipped with Flash ROM and on which card it is located. Also, some printer models supported by CentreWare may require you to perform the upgrade while connected to the serial or parallel port of the printer.

You must have a queue configured for any printer that you want to upgrade.

DO NOT issue any CentreWare commands during the upgrade process.

Upgrade Procedure

This procedure requires special upgrade file(s) for each type of printer. The files are available from the Xerox website (www.xerox.com).

Start CentreWare from your workstation.
Select Tools>Upgrade. If the upgrade entry is not available, the selected printer requires a direct connection (serial or parallel port) for upgrading.
Enter the path where the upgrade file is located and click OK.
Select the queue for the printer that you want to upgrade and click Send File.
The file is copied to the printer. Once the upgrade has been completed, the printer resets and prints a confirmation page containing information about the new version of firmware.
Repeat this procedure if you are upgrading both the Main Controller and the network interface firmware.

Preferred Browser

This option enables you to choose the browser application to use for Internet Services. When selected, a dialog appears in which you enter the directory path of the browser.

Reset Printer

Enables you to reset the printer.

SNMP Services

Accesses SNMP Services options. See SNMP Services for more information.

Internet Services

Opens a browser and displays the printer's Internet Services home page (if available). See Internet Services for more information.

Display Settings Menu

This menu selects the information to display in the Printers List, such as host or system name, IP address, hardware address, or the type of printer.

SNMP Services

SNMP Services supports printers that do not contain an embedded http server for Internet Services. The tabs display printer status, configuration, and consumable information.

Note that the information displayed will vary for different printer models.

Status Tab

Select Status to view printer status and configuration information directly from the printer.

Control Panel

This tab shows a printer's control panel. The printer's ready status and control panel messages appear. You can also set the refresh interval, which defines how often to refresh the display with new information.

Input

This tab shows a printer's input tray information. The media type, the media size, the amount of media in each tray, and total tray capacity are displayed.

Consumables

This tab shows a printer's ink levels, marker levels, cartridges, oil, or developer waste information.

Output

This tab shows output destinations, output tray capacity, and total output tray capacity.

General

This tab shows a printer's supported languages, installed memory, and page count information.

Network

This tab shows a printer's network configuration, such as speed, packet, and interface data.

Select Interface to view network interface information.
Select IP to view IP information.
Select UDP to view this information.
Select SNMP Inbound or SNMP Outbound to view this information.

Properties Tab

Contact

This tab is used for viewing and configuring contact information such as system name, location, and person responsible for the printer.

Print Channel

This tab is used for configuring TCP/IP, enabling a printer's embedded http server, network, port, and Appletalk information.

Internet Services

For printers that contain an embedded http server, select a printer and then click Internet Services to invoke a printer's home page. Using CentreWare Internet Services, an administrator can define the printer settings and network connections as well as monitor the printer status.

Internet Services enables remote printer configuration, monitoring, and managing on networks. Status checks on consumables such as toner and paper supply can be done immediately. Hotlinks are also provided to Xerox Support resources.

TTY Mode Features

From a terminal window prompt, type xpadmin -tty and press [RETURN] to access the Printer Administration Tool in TTY mode.

The following menu appears:

Xerox Printer Administration Tool

1) Add a Printer

2) Modify a Queue

3) Copy a Queue

4) Remove an existing printer(s)

e) Exit

Existing printer list:

Enter option or h for help:

To access the different parts of this menu, type the corresponding number or letter to the function you want to perform.
If more options are available, choosing a number and pressing [RETURN] will toggle through these options.

You must log in with ROOT or superuser privileges to complete this procedure.

Add a Printer

This option is also used to modify an existing printer.

The configured printer features (installable options, media type) apply to postscript print jobs only. PCL does not incorporate any configured features.

Before you add a printer, decide which printing model to use. See Printing Models for more information.
Access the Printer Administration Tool and enter 1 [RETURN].
From the Add a Printer menu enter 1 [RETURN] and enter a printer name.
Enter 2 [RETURN] to choose the printer.
Enter s [RETURN] to save.
Enter 3 [RETURN] to toggle through the printing models.

If you choose Workstation to Printer, enter 4 [RETURN] to toggle through printer connection, then enter 6 [RETURN] to enter the printer name.

If you choose Workstation to Print Server, enter 7 [RETURN] to enter a Hostname, then enter 8 [RETURN] to enter a Print Server name.

For options 9 through 14, enter a menu option number to toggle through the available settings. Note that if option 10 is disabled, options 11, 12, and 13 are not available.
When the desired settings for all options are selected, apply the settings to the printer using the a option from the menu.

Server-based Printing Setup

Set up a queue on the server using the Workstation to Printer model with User interface (graphical mode) enabled.
On each workstation that will print to the printer, set up a queue to spool the print jobs on the server using your native operating system print administration tools.

Remove an Existing Printer

Access the Printer Administration Tool and enter 4 [RETURN].
Select the queue you want to delete from the Existing printer list. Enter <queue_name> [RETURN].
At the "Do you want to remove <queue_name>" confirmation prompt Enter y [RETURN]. The main menu appears.
Enter e [RETURN] to exit the Printer Administration Tool.

Copy an Existing Printer

Access the Printer Administration Tool and enter 3 [RETURN].
Select the queue you want to copy from the Existing printer list.
Enter <queue_name> [RETURN].
Enter 1 [RETURN].
Enter a new <queue_name> [RETURN].
Enter 2 [RETURN] to select the printing model.
Enter a menu option number to toggle through the available settings.
When the desired settings for all options are selected, apply the settings to the printer using the a option from the menu. The main menu appears.
Enter e [RETURN] to exit the Printer Administration Tool.

Modify an Existing Printer

Access the Printer Administration Tool and enter 2 [RETURN].
From the Modify a Queue menu enter 1 [RETURN] to toggle to the desired user interface.
Enter a menu option number to toggle through the available settings.
When the desired settings for all options are selected, apply the settings to the printer using the a option from the menu. The main menu appears.
Enter e [RETURN] to exit the Printer Administration Tool.

Printing

In addition to the lp and lpr commands, you can use the Xerox Print Submission Tool, xprint.

Printing options are selected from the GUI or TTY mode, depending on how the queue was created:

If the queue was created with the User Interface enabled, print features can be selected using either the graphical or TTY mode.
If the queue was created with the User Interface disabled, print jobs are printed in silent mode using the default print features.

Xprint Commands

The following formats are supported:

xprint [options] [filename ...]

The following options are supported:

-Pprinter_name = printer queue name

-cnumber = print number copies of filename.

-Fnumber = Use text font size number, number = (4, 5, 6, . . . , 16, 18, 20, . . . , 40)

-FC = Convert non printable character to octal notation

-dprinter_name = printer queue name

-tty = tty interface only

-n or -nomenu = Do not display menu or user interface.

-sProfileName = Load printer profile settings.

-oOptions = Print a list of all options available for a printer.

-oOption_name = Set the option_name printer feature.

For example, to print with predefined settings, enter -sProfileName -n, which loads the profile settings file and print input file names.

For TTY installations, the pop-up text menu that appears when invoking the command xprint queue name is NOT available when invoking the command lp queue name.

Using Command Line Options

You can send command line options to the print driver using either the xprint or lp command. With each call to xprint or lp, use the -o option plus the printer feature that you wish to set.

Features work from the command line only if the required installable option is selected during queue set up and has not been restricted by a selected feature, for example, duplex printing with paper size of envelope selected.

For example, if you want to print on legal paper, enter the -oLegal option on the command line to print on legal paper:

lp -dtest_queue -oLegal paper.ps

You can print a listing of all options available on your printer by entering:

lp -dtest_queue -oOptions /etc/hosts

Note that only the options sheet is printed; not /etc/hosts.

Translation Files for Command Line Options

You can create translation files for your printer. Creating translation files allows you to create a new command line option that can contain a list of features to use or simply rename an existing feature.

You can create two translation files. Both must reside in the installation directory in a directory named trl. If this directory does not exist, it may be created by a superuser.

/opt/Xerox/xpxx/trl

The first file is named common.trl. It is the first translation file that is referenced when the driver searches for an unknown feature name.

/opt/Xerox/xpxx/ppd/xr_N40.ppd => /opt/Xerox/xpxx/trl/xr_N40.trl

The second translation file is named using the printer ppd name with the trl extension added to it.

Translation File Syntax

Each translation contains a required key name, an optional feature label separated with a slash ( / ), and a single feature or a list of features.
Each translation must be contained within a single line of text. A continuous text line may be wrapped to another line by using a backslash ( \ ) at the end of the wrapping line(s).
A pound sign ( # ) marks the beginning of a comment field. All text following the # is ignored.
Use either a colon ( : ) or an equal sign ( = ) to define the type of translation being defined. A colon implies that you are creating a macro (list of features). An equal sign implies that you are creating a definition (renaming an existing feature).

Translation Line Layout

a) name/ b) label : c) feature_x
Line Section	Entry	Definition
a)	name	A unique key word that is used to identify this translation, {a..z, A..Z, 0..9}. May be used as a command line -o option or in other translations.
b)	label	A label text associated with this macro
c)	feature_x	The following items are allowed: i. translation key word ii. built-in feature (see -oOptions) iii. ppd file feature ==> <UI Name>=<UI option name>

Examples:

name/label : feature_1 feature_2 ... feature_n

name/label : feature_1 feature_2 \feature_3 feature_4 \feature_5 ... feature_n

name/label = feature_1

Queue Management Tools

xpq

This utility is an equivalent utility to the UNIX lpq command. It allows you to view the current job list for your print queues. The utility executes and continues to run and update the screen until all jobs are gone from the queue. You can exit the utility by pressing the key combination [Control C].

Use the following command line to execute xpq:

xpq [print_queue_name] [interval]

where:

[print_queue_name] is the queue name to monitor

[interval] is the specified time between screen updates (in seconds). If no interval is specified, the utility will display the current queue status and exit.

xprm

xprm enables an administrator (with ROOT privileges) to delete any print jobs or any general user to delete their own print jobs.

This utility is an equivalent to the UNIX lprm command. It allows you to delete jobs currently in a job queue. Before using xprm, run the xpq utility for the desired queue and note the job number and job name of the print job you want to delete.

Use the following command to execute xprm:

xprm [print_queue_name] [job_number.job_name]

where:

[print_queue_name] is the queue name containing the print job to delete.

[job_number.job_name] is the job number and job name of the print job to delete.

lp and lpr

Use the print submission tools lp and lpr to submit print jobs to the remote server. See Server-based Printing for more information.

If the user interface for the queue you are printing to was enabled during setup, and the display access IDs were properly configured for the server, each print job submitted will enable the graphical mode on the workstation.

If the display access is denied or the queue was configured without the user interface enabled, you will not be able to select any print features. The print job will print using only the predefined print features of the queue.

Contents

Introduction

Installing CentreWare

Network and Hardware Requirements

Printing Models

Workstation to Printer (Peer-to-Peer)

Workstation to Server (Client-Server)

Server-based Printing

NIS-based Printing

Installation Instructions

CD-ROM

FTP Download or Website

Common Install

Accessing CentreWare

Graphical Mode

TTY Mode

Using CentreWare Features

Requirements

Key Features and Benefits

Graphical Mode Features

Menu Bar

Tool Bar

Printers List

Printer Menu

Queue Setup (Add)

Workstation to Printer Procedure

Workstation to Print Server Procedure

Server-based Printing Setup

NIS Server-based printing Setup

Queue Setup (Copy)

Queue Setup (Delete)

Queue Setup (Modify)

Discovery

Subnet Address

Tools Menu

Test Print

Send File

Upgrading Printers

Upgrade Procedure

Preferred Browser

Reset Printer

SNMP Services

Internet Services

Display Settings Menu

SNMP Services

Status Tab

Control Panel

Input

Consumables

Output

General

Network

Properties Tab

Contact

Print Channel

Internet Services

TTY Mode Features

Add a Printer

Server-based Printing Setup

Remove an Existing Printer

Copy an Existing Printer

Modify an Existing Printer

Printing

Xprint Commands

Using Command Line Options

Translation Files for Command Line Options

Translation File Syntax

Translation Line Layout

Queue Management Tools

xpq

xprm

lp and lpr