## Contents

- Accessing CentreWare (R)

- Graphical Mode Features

Menu Bar

Tool Bar

Printers List

Printer Menu

Tools Menu

Display Settings Menu

SNMP Services

Internet Services

- TTY Mode Features

Add a Printer

Remove an Existing Printer

Copy an Existing Printer

Modify an Existing Printer

Xprint Commands

Using Command Line Options

## Introduction

Xerox CentreWare (R) is a fast, easy-to-use tool which allows you to configure and check the status of network connected printers.

CentreWare (R) can be used to quickly set up a printer on your network as well as monitor the operation of the printer once it has been installed.

When CentreWare (R) is used, maintenance checks can be performed at any time. This minimizes down time by enabling you to check consumables status any time you wish and then schedule replacement during off-peak usage.

CentreWare (R) for UNIX supports a variety of UNIX and Linux platforms, and supports Xerox printers as well as non-Xerox printers. The procedures presented will enable you to connect your printer in these environments.

DCPR and DCxxx are no longer supported. To print with DCPR or DCxxx, see Printing for more information.

## Installing CentreWare (R)

The information presented provides an experienced Systems Administrator with information about installing the CentreWare (R) application and configuring a printer on the various UNIX and Linux systems.

## Network and Hardware Requirements

The requirements needed for printer connection and setup include:

- A workstation with an appropriate UNIX operating system software installed.
- A network interface on your printer and appropriate cabling for your network or a parallel printer to connect your workstation and printer.

## Printing Models

Before installing CentreWare (R), decide which of the following printing models to use.

### Workstation to Printer (Peer-to-Peer)

Print jobs are spooled locally. The Workstation to Printer model requires that CentreWare (R) is installed on each workstation.

### Workstation to Server (Client-Server)

Print jobs are spooled on the server. The Workstation to Server model requires that CentreWare (R) is installed on each workstation and the server.

### Server-based Printing

Print jobs are spooled on the server. CentreWare (R) must be installed on the server. Workstations use native operating system tools (lp, lpr) for print job submission.

The advantage of server-based printing is that in graphical mode, workstation users are able to select printing features for each print job without having CentreWare (R) installed on their workstations.

### NIS-based Printing

NIS uses a printer configuration map on the server. When new printer queues are added to a print server, only the configuration file in the master NIS server has to be updated, then run make. NIS clients can then print to queues listed on the server map without setting up any local queue.

Consult your UNIX operating system manual for more information on how to set up NIS based printing.

## Installation Instructions

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

The installation files are available on the CentreWare (R) Print and Fax Drivers CD-ROM, via FTP (ftp.xerox.com), or the Xerox website (www.xerox.com).

Two installation files are required:

1. Printer Definition file (one file for all operation systems) which is contained in PrinterPkg_200x_xx_xx.tar.
2. Code file (unique for each operating system) which is contained in the following .tar files:

AIX_XPXX_xx.xx.xx.tar

DECUXXPXX_xx.xx.xx.tar

HPUX_XPXX_xx.xx.xx.tar

Linuxi386_XPXX_xx.xx.xx.tar

Linuxppc_XPXX_xx.xx.xx.tar

SGIXPXX_xx.xx.xx.tar

Solaris_2.5x_XPXX_xx.xx.xx.tar

Solaris_XPXX_xx.xx.xx.tar.

UnixWareXPXX_xx.xx.xx.tar

Note that each .tar file, when expanded, will require disk space up to 4 times the size of the .tar file.

### CD-ROM

1. Mount the CD-ROM (local or remote) to your file system.
2. Type cd [directory].
3. Type tar -xvf [path] {filename} [RETURN]. (This step must be done for each of the two required .tar files.)

where:

[directory] = path to where files will be expanded

[path] = path to the CD-ROM

4. Perform the Common Install procedure, which follows.

### FTP Download or Website

1. Download the .tar files from the Xerox FTP Site (ftp.xerox.com) or the Xerox website (www.xerox.com) to a temporary directory.
2. Type tar -xvf [filename} [RETURN]. This step must be done for both the Code and the Printer Definition .tar files.

The files are expanded and two directories are created with names that match the Code and Printer Definition .tar file names.

3. Perform the Common Install procedure, which follows.

### Common Install

1. Change your current directory to the install directory created by the expansion of the . tar file for the Code file.
2. Enter ./setup.
3. Change your current directory to the install directory created by the expansion of the .tar file for the Printer Definition file.
4. Enter ./setup.

The installation creates a Xerox directory in /usr or /opt depending on your operating system. After installation, the .tar files or the expanded files are not deleted.

## Accessing CentreWare (R)

CentreWare (R) 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 (R) 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 (R) Features

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

Note that not all CentreWare (R) 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 (R) 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 (R) for UNIX provides links to CentreWare (R) 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 (R) 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 (R).

### 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 (R). 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

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

OR

Select Printer>Queue Setup>Add.

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

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

1. From Features, enable or disable print features when submitting a print job to your printer.
2. From User interface, enable or disable the graphical mode when submitting a print job to your printer.
3. From Banner page printing, enable or disable printing of a CentreWare (R) banner page with each print job.
4. Click Configure Printer Features to change the default print options for your printer.
5. 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.
6. When finished, click Apply.
7. Click OK to save your settings.
8. 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

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

OR

Select Printer>Queue Setup>Add.

3. In Queue name, enter the name for the queue created on the remote print server.
4. From Printer Type, choose your printer.
5. From Printing model, select workstation to print server.
6. From Printer connection, select a connection method for your printer.
7. In Print host name, enter the host name of the remote workstation to be used as a print server.
8. In Print server queue name, enter the queue name on the remote workstation used for your printer.
9. From Default printer, select Yes to make this printer your default printer.
10. From Features, enable or disable the setting of print features when submitting a print job to your printer.
11. From User interface, enable or disable the graphical mode when submitting a print job to your printer.
12. From Banner page printing, enable or disable the printing of a banner page with each print job.
13. Click Configure Printer Features to change the default print options for your printer.
14. 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.
15. When finished, click Apply.
16. Click OK to save your settings.
17. 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

1. Set up a queue on the server using the Workstation to Printer model with User interface (graphical mode) enabled.
2. 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)

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

#### Queue Setup (Copy)

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

#### Queue Setup (Delete)

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

#### Queue Setup (Modify)

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

1. Select Printer>Queue Setup>Modify.
2. Select a queue to modify from the Print Queue List.
3. Click Modify.
4. Make the desired changes to the queue features.
5. 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

1. Select Printer>Discovery.
2. Select the Subnet Address tab.
3. 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).

4. Click Add to add the subnet to the list.
5. 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 (R) 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 (R) 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 (R) 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).

1. Start CentreWare (R) from your workstation.
2. Select Tools>Upgrade. If the upgrade entry is not available, the selected printer requires a direct connection (serial or parallel port) for upgrading.
3. Enter the path where the upgrade file is located and click OK.
4. Select the queue for the printer that you want to upgrade and click Send File.
5. 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.
6. 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 (R) 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.

1. Before you add a printer, decide which printing model to use. See Printing Models for more information.
2. Access the Printer Administration Tool and enter 1 [RETURN].
3. From the Add a Printer menu enter 1 [RETURN] and enter a printer name.
4. Enter 2 [RETURN] to choose the printer.
5. Enter s [RETURN] to save.
6. 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.

OR

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

7. 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.
8. 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

1. Set up a queue on the server using the Workstation to Printer model with User interface (graphical mode) enabled.
2. 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

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

#### Copy an Existing Printer

1. Access the Printer Administration Tool and enter 3 [RETURN].
2. Select the queue you want to copy from the Existing printer list.
3. Enter <queue_name> [RETURN].
4. Enter 1 [RETURN].
5. Enter a new <queue_name> [RETURN].
6. Enter 2 [RETURN] to select the printing model.
7. Enter a menu option number to toggle through the available settings.
8. 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.
9. Enter e [RETURN] to exit the Printer Administration Tool.

#### Modify an Existing Printer

1. Access the Printer Administration Tool and enter 2 [RETURN].
2. From the Modify a Queue menu enter 1 [RETURN] to toggle to the desired user interface.
3. Enter a menu option number to toggle through the available settings.
4. 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.
5. 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

1. Each translation contains a required key name, an optional feature label separated with a slash ( / ), and a single feature or a list of features.
2. 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).
3. A pound sign ( # ) marks the beginning of a comment field. All text following the # is ignored.
4. 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.