Equitrac Express 3.0 UNIX Print Server Module Guide · Equitrac Office/Express UNIX Print Server...

© 2012 Equitrac Corporation

Equitrac Office/Express 4.2.5

UNIX Print Server Guide

Equitrac Office/Express UNIX Print Server Guide

Document History

© 2012 by Equitrac Corporation

All rights to this document, domestic and international, are reserved by Equitrac Corporation. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise) without prior written permission of Equitrac.

Trademarks

Equitrac is a registered trademark of Equitrac Corporation.

All other brands and their products are trademarks or registered trademarks of their respective holders, and should be noted as such.

Symbols used in this guide:

The following symbols are used in the margins of this guide:

Revision Date Revision List

November 2, 2012 Updated for Equitrac Office and Equitrac Express 4.2.5

May 2, 2012 Updated for Equitrac Office and Equitrac Express 4.2.4

December 5, 2011 Updated for Equitrac Office and Equitrac Express 4.2.3

July 11, 2011 Updated for Equitrac Office and Equitrac Express 4.2.2

February 10, 2011 Updated for Equitrac Office and Equitrac Express 4.2.1

August 4, 2010 Updated for Equitrac Office and Equitrac Express 4.2.0

June 29, 2009 Updated for Equitrac Office and Equitrac Express 4.1.1

July 11, 2008 Created initial document for Equitrac Office and Equitrac Express 4.1

Caution The accompanying text provides key information about a step or action that might produce unexpected results if not followed precisely.

Note The accompanying text provides cross-reference links, tips, or general information that can add to your understanding of the topic.

Warning Read the accompanying text carefully. This text can help you avoid making errors that might adversely affect program behavior.

Equitrac Office/Express UNIX Print Server Guide 3

Contents

1. Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Equitrac Office/Express UNIX Print Server Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

On the UNIX Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6On the Equitrac Office/Express Accounting Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7On the Windows Management Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Server Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

UNIX Print Server Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Integrating Equitrac Office/Express and UNIX Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Equitrac Office/Express Core Components on a UNIX Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Equitrac Office/Express Components on a Windows Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Workstation Administrative Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

The Equitrac Office/Express Print Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Printer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Printer Tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Interaction with UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2. Server Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

HP-UX Installation Equitrac Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

HP-UX Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

HP-UX Installation Equitrac Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

HP-UX Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Solaris Installation for Equitrac Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Solaris Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Solaris Installation for Equitrac Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Solaris Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Linux Installation for Equitrac Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Linux Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Linux Installation for Equitrac Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Linux Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Running the Setup Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Installed Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Cross-Platform Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21HP-UX Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Linux Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Solaris Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Contents

4 Equitrac Office/Express UNIX Print Server Guide

3. Printer Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

General Printer Configuration (All Platforms) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Identifying the Core Accounting Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Adding Printers from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Deleting Printers from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Creating Printers on HP-UX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Creating Printers on Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Adding a Printer using lpadmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Creating Printers on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Defining Printers Using LPRng . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Printer Registration Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

UNIX Utility Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

4. Configuring Equitrac Office/Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Controlling the Equitrac Office/Express daemons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Adding Physical Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Connecting Network Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35


Overview

This guide is intended to help you to install and configure the Equitrac Office/Express UNIX Print Server. It assumes you are familiar with UNIX and Windows network administration.

The Printer Accounting Server UNIX Print Server enables accounting on UNIX print servers by monitoring printing and reporting printer usage to an Equitrac Office/Express accounting server.

Before installing the Equitrac Office/Express UNIX Print Server, configure core Equitrac Office/Express components on your network. For information on installing and configuring Printer Accounting Server, please see the Equitrac Office or Equitrac Express Installation Guide and the Equitrac Office or Equitrac Express Administration Guide.

Any references to Windows servers in this document apply to Windows Server 2003 or 2008.

TopicsEquitrac Office/Express UNIX Print Server Support

System Requirements

UNIX Print Server Terminology

Integrating Equitrac Office/Express and UNIX Servers

The Equitrac Office/Express Print Server

1

Chapter 1: Overview


Equitrac Office/Express UNIX Print Server SupportThe UNIX Print Server supports network print-tracking and charging for print devices shared on a UNIX print server, including Data Stream Interpreter page counting. The Equitrac Office/Express version 4.2.5 UNIX Print Server supports secure printing and Follow-You Printing.

You should be using the standard UNIX printing subsystem. While Equitrac Office/Express UNIX printing supports CUPS and LPRng printing subsystems, it does not support some third-party printing subsystems, such as PDQ (Print, Don’t Queue).

The Equitrac Office/Express UNIX Print Server does not support the following:

• pop-up billing codes

• PJL and SNMP page counting

System RequirementsThe following Equitrac Office/Express, Microsoft, and UNIX components are requirements in order to configure printer tracking on a UNIX print server.

On the UNIX ServerYour UNIX server must host one of the following operating systems before you install the Equitrac Office/Express UNIX Print Server component:

• HP-UX IA64 or 11.231

• Solaris 9 SPARC1

• Solaris 10 SPARC, x641

• RedHat Enterprise 4 or 51

• Red Hat Fedora Core 3 to 71

• SUSE Linux Enterprise Server 9 or 101

• OpenSUSE Linux 9 or 101

NOTE: Equitrac Office/Express is not supported on Solaris for Intel, or on Linux running on non-Intel platforms.

1 Supported with LPR and CUPS

On the Equitrac Office/Express Accounting Server• Windows Server 2003 or 2008

• Equitrac Office/Express 4.2.5 Core Accounting Server installed and configured


Chapter 1: Overview

On the Windows Management WorkstationThe management workstation requires:

• Windows XP Professional, Windows Vista Business/Enterprise/Ultimate, Windows 7 Professional/Enterprise/Ultimate or any of the Windows servers listed On the Equitrac Office/Express Accounting Server on page 6.

• Equitrac Office/Express System Manager

• Equitrac Office/Express Accounts Manager

Server LicensingThe Equitrac Office/Express UNIX Print Server is licensed per server. Each server uses a print server license on the Equitrac Office/Express core accounting server. If the number of print servers or devices exceeds the number of licenses you have, the unlicensed components will not record any printing activity.

For information on licensing components with Equitrac Office/Express, refer to the Equitrac Office/Express Administration Guide.

UNIX Print Server TerminologyBefore you install Equitrac Office/Express UNIX Print Server, you should be familiar with the following terms:

UNIX Print Server Term Definition

Equitrac Office/Express printer registration

information about a logical printer definition stored in the Equitrac Office/Express database to track usage. A registration includes a printer name, a user-defined description and the printer’s assigned costs.

physical printer the actual printing device.

print filter the final print queue component on Linux.

print interface the final print queue component on Solaris and HP-UX.

print queue a logical definition that represents a physical printer on a UNIX server.

Chapter 1: Overview


Integrating Equitrac Office/Express and UNIX ServersThe Equitrac Office/Express UNIX Print Server integrates a UNIX server with the Equitrac Office/Express print tracking environment. You can accomplish this integration by installing a number of cooperating software components on your network. The following table provides an overview of the required components.

Equitrac Office/Express Core Components on a UNIX Server

For additional information on utility programs included with the Equitrac Office/Express UNIX module (eqcascfg, eqaddprinter, eqdeleteprinter, eqviewprinter), see UNIX Utility Programs on page 27.

Equitrac Office/Express Component Integration

eqdred Communicates with the Core Accounting Server service on the Windows server (UNIX version of Equitrac’s Document Routing Engine).

eqprint Handles printing, page counting, details reporting. The print server calls this function for each print job submitted through the LPR printing chain (for example, on Solaris/HP-UX it is eq.interface, on Linux eq.filter). These scripts extract the correct printing info, then call eqprint with the appropriate parameters. eqprint first does the page counting, checks any accounting restrictions or problems, then sends the print transaction to the networked printer.

eqctrl Control script for eqdred. You can run this script with start, stop, restart and status arguments to perform the corresponding action on eqdred. The UNIX RC system also uses this script to automate starting and stopping eqdred when the system changes state (for example, stop, start, reboot, halt). The RC system differs from platform to platform, so the you must create different symbolic links for each platform. For example, some systems have their base directory as /etc/rc.d/init.d and some use /etc/init.d

eq.filter (Linux) eq.interface (Solaris.HP-UX)

Wrapper scripts for processes that communicate with the printers.


Chapter 1: Overview

Equitrac Office/Express Components on a Windows Server

Workstation Administrative Applications


Core Accounting Server • Functions as a Windows service.• Coordinates the activity of all Equitrac Office/Express components.• Handles account management requests; controls database access.• Calculates charges, assigns them to correct accounts.

Equitrac Office/Express Database

Stores information about printing transactions, printing accounts and balances, printers, printer costs, and scheduled events.


System Manager Enables the system administrator to:

• configure and monitor Windows server components• assign costs to printers and copiers

Accounts Manager Enables the financial administrator to:

• manage user, department and billing code accounts• perform account transactions

Chapter 1: Overview


The following diagram illustrates one way in which you can configure Equitrac Office/Express components and administrative applications on your network:

• Equitrac System Manager• Equitrac Accounts Manager

Components

• Equitrac print filter or interface• Utilities: eqdred, eqcascfg,

eqaddprint, eqviewprinters, eqdeleteprinter

• Core Accounting Server• Equitrac Database

Windows Equitrac Server

Database

Solaris/Linux Server

Printer 1

Printer 2

Printer 3

Windows Management Workstation

Components

Components


Chapter 1: Overview

The Equitrac Office/Express Print ServerThe Equitrac Office/Express print server components perform two functions on the UNIX server: printer control and printer tracking.

Printer ControlOn a UNIX server, the Equitrac Office/Express print server monitors and controls printing activity. When you configure an Equitrac Office/Express print queue, the Equitrac print monitors associated with that queue prevent unauthorized users from accessing network printers. When the print server receives a print request, it checks with the Equitrac Office/Express accounting server to ensure that the user sending the request has a valid printing account. The accounting server checks the Equitrac Office/Express database for the administrator-defined list of valid printing accounts and indicates when print jobs are authorized to proceed.

Printer TrackingThe Equitrac Office/Express print server also monitors printing traffic to determine the size and attributes—such as page color, duplexing, page size, and so on—of each print job. The print server passes this detailed information back to the accounting server. Based on the print job’s page count and document attributes, and the administrator-defined costs assigned to the destination printer, the accounting server calculates printing charges and levies them against the appropriate printing account.

Chapter 1: Overview


Interaction with UNIXThe following diagram illustrates how Equitrac Office/Express, UNIX, and printing components interact when a network workstation generates a print request, so that the Equitrac database can track the print job.

eqprint sends the job to the printer

LPR calls required script (piosm, eq.interface, eq.filter)

Print job

UNIX Scripts extract print job parameters and call eqprint

eqprint calls eqdred, attempts to count the print, reports print details to CAS

eqdred receives printer and accounts information from CAS

Local or network


Server Installation and Configuration

Equitrac Office/Express supplies the set of port monitors as a native install package specific to the UNIX variant on which you wish to run the software. The automated installation uses /usr/local/eq as the base directory for the software. Please refer to the appropriate section in this chapter for the relevant installation instructions for your platform.

TopicsInstallation Overview

HP-UX Installation Equitrac Office

HP-UX Installation Equitrac Express

Solaris Installation for Equitrac Office

Solaris Installation for Equitrac Express

Linux Installation for Equitrac Office

Linux Installation for Equitrac Express

Running the Setup Script

Installed Files

2

Chapter 2: Server Installation and Configuration


Installation OverviewThere are four steps to installing and configuring a UNIX print server for Equitrac Office/Express on your network:

1 Copy the files to the UNIX server and run the installation program appropriate to your UNIX platform.

2 On the server, go to /usr/local/eq and run setup. This is the script that calls eqcascfg and eqctrl (to enable you to configure the Equitrac Office/Express server) and start the eqdred daemon.

NOTE: You can run eqcascfg at any time to change the Equitrac Office/Express Accounting Server. You must restart eqdred manually after any changes you make with eqcascfg. See Running the Setup Script on page 18 for script details.

3 Define your printers to Equitrac Office/Express using eqaddprinter. This automatically registers your printers into the database on the Core Accounting Server, and these should be immediately visible in System Manager if you refresh the Devices listing in the right pane.

4 Define your printers to the operating system using the same names you used with eqaddprinter.

With most of the UNIX systems this is a two-step process:

a Define the printer.

b Modify it to use the Equitrac Office/Express printing backend.

NOTE: You should first verify that the printer works as expected without Equitrac software in the process, to help eliminate any simple configuration issues, such as if the print stream is not in the correct data format for the printer.



HP-UX Installation Equitrac Office1 Copy the installation package, EquitracOffice.4.2.0.3962-hpux.depot.gz, to a temporary folder on

the server, such as the /tmp directory.

2 Install the package using the HP-UX package installer. Assuming that you copied the package to /tmp, the appropriate commands to unzip and install the files would be: gunzip /tmp/EquitracOffice.4.2.0.3962-hpux.depot.gz

swinstall -s /tmp/EquitracOffice.4.2.0.3962-hpux.depot EquitracOffice

3 Run /usr/local/eq/setup and respond to the prompts as required, including the name of the accounting server. Ensure that the accounting server is accessible via the DNS name or IP address you specify. To modify this name at a later time, run the command eqaddprinter.

NOTE: The server’s root user must own eqprint with the +s privilege in order to enable access to the LPR ports in the RFC 1179 specifications.

HP-UX Uninstallationswremove EquitracOffice

HP-UX Installation Equitrac Express1 Copy the installation package, EquitracExpress.4.2.0.3962-hpux.depot.gz, to a temporary folder on

the server, such as the /tmp directory.

2 Install the package using the HP-UX package installer. Assuming that you copied the package to /tmp, the appropriate commands to unzip and install the files would be: gunzip /tmp/EquitracExpress.4.2.0.3962-hpux.depot.gz

swinstall -s /tmp/EquitracExpress.4.2.0.3962-hpux.depot EquitracExpress



HP-UX Uninstallationswremove EquitracExpress



Solaris Installation for Equitrac Office 1 Copy the installation package, EquitracOffice.4.2.0.3962-solaris[9/10].pkg, to a temporary folder

on the server, such as the /tmp directory.

2 Install the package using the Solaris package installer. Assuming that you copied the package to /tmp, the appropriate commands to unzip and install the files would be: pkgadd -d /tmp/EquitracOffice.4.2.0.3962-solaris[9/10].pkg

3 During the installation, Solaris warns that you are installing scripts or programs with suid privileges. You must accept this warning, or eqprint will not function.



Solaris Uninstallationpkgrm EquitracOffice

Solaris Installation for Equitrac Express 1 Copy the installation package, EquitracExpress.4.2.0.3962-solaris[9/10].pkg, to a temporary

folder on the server, such as the /tmp directory.

2 Install the package using the Solaris package installer. Assuming that you copied the package to /tmp, the appropriate commands to unzip and install the files would be: pkgadd -d /tmp/EquitracExpress.4.2.0.3962-solaris[9/10].pkg

3 During the installation, Solaris warns that you are installing scripts or programs with suid privileges. You must accept this warning, or eqprint will not function.



Solaris Uninstallationpkgrm EquitracExpress



Linux Installation for Equitrac Office1 Copy the installation package, EquitracOffice.4.2.0.3962-linux.rpm, to a temporary folder on the

server, such as the /tmp directory.

2 Install the package using the Linux package installer. Assuming that you copied the package to /tmp, the appropriate commands to unzip and install the files would be: rpm -ivh /tmp/EquitracOffice.4.2.0.3962-linux.rpm



Linux Uninstallationrpm -e EquitracOffice

Linux Installation for Equitrac Express1 Copy the installation package, EquitracExpress.4.2.0.3962-linux.rpm, to a temporary folder on the

server, such as the /tmp directory.

2 Install the package using the Linux package installer. Assuming that you copied the package to /tmp, the appropriate commands to unzip and install the files would be: rpm -ivh /tmp/EquitracExpress.4.2.0.3962-linux.rpm



Linux Uninstallationrpm -e EquitracExpress



Running the Setup ScriptThis script points to the /usr/local/eq directory, automatically calling the eqcascfg script in interactive mode, and restarting the eqctrl daemon. Run this script to configure the Equitrac Office/Express server and start the eqdred daemon.

#!/bin/sh

# setup - a setup shell script for Equitrac

# Print Monitors for Unix

#

# $Id: //depot/Wasabi/Unix/Package/common/setup#2 $

# $DateTime: 2004/03/15 22:55:37 $

# $Author: bnurse $

# $Change: 120531 $

#

EO_LOC=/usr/local/eq

$EO_LOC/eqcascfg -i

echo "** Activating Changes **"

$EO_LOC/eqctrl restart



Installed FilesThis section provides a list of all files installed with Equitrac Office/Express for UNIX print servers.

Cross-Platform Files/usr/local/eq/LICENSE

/usr/local/eq/Docs/README

/usr/local/eq/smpce.cfg

/usr/local/eq/PSInit/CoreInit.ps

/usr/local/eq/PSInit/UserInit.ps

/usr/local/eq/cups/README

/usr/local/eq/cups/eq.interface

/usr/local/eq/cups/equitrac

/usr/local/eq/lprng/README

/usr/local/eq/lprng/eq.filter

/usr/local/eq/EQSpool

/usr/local/eq/EQSpool/devmod/DevLib

/usr/local/eq/EQCASMsg.bin

/usr/local/eq/Settings

/usr/local/eq/logs

/usr/local/eq/eqdred

/usr/local/eq/eqctrl

/usr/local/eq/eqprint

/usr/local/eq/eqaddprinter

/usr/local/eq/eqcascfg

/usr/local/eq/eqdeleteprinter

/usr/local/eq/eqviewprinters

HP-UX Files/usr/local/eq/eq.interface

/sbin/init.d/eqctrl

/sbin/rc1.d/K280eqctrl

/sbin/rc2.d/S720eqctrl



Linux Files/usr/local/eq/eq.filter

/etc/rc.d/init.d/eqctrl

/etc/rc.d/rc0.d/K10eqctrl


/etc/rc.d/rc2.d/S90eqctrl





Solaris Files

Solaris 8/9/10

/usr/local/eq/eq.interface

/etc/init.d/eqctrl

/etc/rc0.d/K39eqctrl

/etc/rc1.d/K39eqctrl

/etc/rc2.d/S80eqctrl

/etc/rcS.d/K39eqctrl


Printer Configuration

Prior to defining the printers in Equitrac Office/Express, you must define the printers in your operating system. Please refer to the appropriate section of this chapter for platform-specific instructions.

This chapter also provides information for troubleshooting potential printer registration errors.

TopicsGeneral Printer Configuration (All Platforms)

Creating Printers on HP-UX

Creating Printers on Solaris

Creating Printers on Linux

Defining Printers Using LPRng

Printer Registration Errors

UNIX Utility Programs

3

Chapter 3: Printer Configuration


General Printer Configuration (All Platforms)

Identifying the Core Accounting ServerTo configure the port monitors, you need to specify the name of the server hosting the Equitrac Office/Express suite, using the eqcascfg script. An example of this is:

/usr/local/eq/eqcascfg -e your.server.com

You can specify the name of the Equitrac Office/Express server as a fully-qualified name or an IP address.

Adding Printers from the Command LineTo define printers so that Equitrac Office/Express can use them, use the eqaddprinter command, as shown in the following examples.

NOTE: eqdred should be running before you register printers on the UNIX server.

Adding an LPR-based Printer

1 At the command line, type eqaddprinter.

2 Specify the new printer name.

3 Specify the device host name/IP address.

4 Specify whether or not the server should Hold port open.

5 Specify whether the printer is LPR based (in this case, type Y for Yes).

6 Type the queue name to create for this printer.

7 Confirm the printer data using the eqviewprinters command.

Adding a Non-LPR Printer

1 At the command line, type eqaddprinter.

2 Specify the new printer name.

3 Specify the device host name/IP address.

4 Specify whether or not the server should Hold port open.

5 Specify whether the printer is LPR based (in this case, type N for No).

6 Select a manufacturer by number. If your printer manufacturer is not listed, you must know the port number on which the printer accepts jobs. You can then select "9999 Unknown" as the printer manufacturer, and eqaddprinter will prompt for the port number.

7 Specify the model by number.

8 Confirm the printer data using the eqviewprinters command.



Deleting Printers from the Command LineYou can delete any printer created on this server using the following procedure.

1 At the command line, type eqdeleteprinter.

2 Type the name of printer to delete.

3 Confirm that you want to delete this printer (type Y or N for Yes or No).

Creating Printers on HP-UXThe following example illustrates how to use lpadmin to add a printer called printer1 to the LPR subsystem:

1 Stop the spooler using the command:/usr/sbin/lpshut

2 Add the printer, as shown in this example:/usr/sbin/lpadmin -p printer1 -i/usr/local/eq/eq.interface -v/dev/null

3 Tell the new printer to accept requests:/usr/sbin/accept printer1

4 Enable spooling on the new printer:/usr/bin/enable printer1

5 Re-start the spooler:/usr/sbin/lpsched

To verify that you added the printer successfully, a copy of eq.interface should appear as /etc/lp/interface/printer1.



Creating Printers on SolarisAdd your printer as you normally would, using lpadmin.

Adding a Printer using lpadmin1 Add the printer. You should specify eq.interface as the interface program for the printer, and then use /

dev/null as the actual device, as shown in this example:/usr/lib/lpadmin -p printer1 -v /dev/null -i /usr/local/eq/eq.interface -I any

The -p parameter identifies the name of the printer. This name must match the printer name given in eqaddprinter.

The -i option points to a script that interprets the incoming job attributes, and passes them to the EQ port monitor.

2 Activate the printer with:/usr/lib/accept printer1

/usr/bin/enable printer1

NOTE: If your installation directory is not /usr/local/eq, you must specify the -d <installpath> parameter to eq.interface.



Creating Printers on LinuxFollow these instructions to define printers on Linux using CUPS.

CAUTION: Before you create printers, ensure that the version of CUPS you use is 1.1.23 or later. The version of CUPS that ships with some Linux platforms will not create printers correctly.

1 Install the Equitrac CUPS backend.

Copy the equitrac file that matches your platform to the backend directory of your CUPS installation such as /usr/lib/cups/backend. Ensure that permission and ownership settings on the file are identical to those on the backends provided with your CUPS installation.

2 Run the following command to restart CUPS and allow it to discover the new backend.cp /usr/local/eq/cups/equitrac /usr/lib/cups/backend

chown root:root /usr/lib/cups/backend/equitrac

/etc/init.d/cups restart

3 Install printers.

a Launch the CUPS Admin web site at http://localhost:631

b Switch to the Printers tab.

c From the bottom of the printer list, select Add Printers.

d Enter the printer Name, Location, and Description, then click Continue.

e Select the device for the printer. This should be: Document Accounting (Equitrac)

f For the Device URI, use equitrac://printername where printername is the name of the printer as defined to the system and to CUPS. This should be the same name as was used in step "d".

g After adding the device URI, select the type of device. You can continue installing your printer as you normally would under CUPS.

4 Define each printer.

Run the eqaddprinter utility, and ensure that the printer name(s) match the name(s) used on the CUPS Admin web site.



Defining Printers Using LPRng1 Define the printer to Equitrac Office/Express using eqaddprinter.

2 Edit the /etc/printcap.local file and add an entry of the following form:printer1 | PRINTER1:\

:sd=/var/spool/lpd/printer1:\

:lp=/dev/null:\

:af=printername:\

:filter=/usr/local/eq/lprng/eq.filter:

where printername is the same name that you used in step 1.

3 Create the spool directory /var/spool/lpd/printer1 and make sure it is owned by lp.

4 Restart lpd.

Printer Registration ErrorsAfter creating your printers, if you encounter “Printer not registered” errors, it is likely due to a mismatch in the “registered” system name through System Manager, and the System Name that eqdred sends to the Equitrac Office/Express accounting server when validating the user.

The name you use in System Manager for registering a printer to the accounting server must match identically.

eqdred reports the SystemName as the value that is also returned if you run “hostname” on the UNIX server. If this name is not accessible from System Manager then you must add a hosts file entry in system32\drivers\etc\hosts, or modify the hostname on the UNIX box.



UNIX Utility Programs

Use the utilities outlined in the table below to configure printers and the print servers.

Program Description Usage

eqaddprinter Add a new printer. no parameters, completely interactive

eqviewprinters Show the current configuration for all defined printers.

no parameters, completely interactive

eqdeleteprinter Delete a currently defined printer. no parameters, completely interactive

eqcascfg Show/set current Equitrac Office/Express Core Accounting Server.

eqcascfg -e <server> [set the server]

eqcascfg -i [prompt user interactively for input rather than specifying on the command line]

eqcascfg -s [show current server]

where server = IP address or name of server


Configuring Equitrac Office/Express

Once you have configured the printers on the UNIX server, you must register both the UNIX server and the printers in Equitrac Office/Express, using the System Manager application.

TopicsControlling the Equitrac Office/Express daemons

Adding Physical Devices

Connecting Network Workstations

4

Chapter 4: Configuring Equitrac Office/Express


Controlling the Equitrac Office/Express daemonsTo start the Equitrac Office/Express daemons on the UNIX server, use the supplied shell script:

/usr/local/eq/eqctrl start

To stop the Equitrac Office/Express daemons, use the supplied shell script:

/usr/local/eq/eqctrl stop

To restart the Equitrac Office/Express daemons, use the supplied shell script:

/usr/local/eq/eqctrl restart

To see the status of the Equitrac Office/Express daemons use the supplied shell script:

/usr/local/eq/eqctrl status

To automate the startup/shutdown process of the daemons, a copy of the eqctrl script is installed into the appropriate locations, which are not the same for all UNIX variants. The daemons are designed to start up in any run-level in which the lpr system also starts.

For a complete list of installed files and scripts, see Installed Files on page 19.



Adding Physical DevicesUse this option to register a physical device manually with Equitrac Office/Express, using the System Manager component.

You cannot manually register a UNIX print server within Equitrac Office/Express, but when you define physical devices that point to remote print servers (UNIX or otherwise), Equitrac Office/Express will have visibility to that print server via the device activity.

Equitrac Office/Express automatically registers any device you create using Equitrac Port Monitors through the Windows Add Printer Wizard in the Control Panel > Printers window.

1 In System Manager > Devices, select the Standard, Custom, Group, Server, or Type view.

2 Select Add physical device under Current Tasks, or right-click in the listing pane and select Add physical device from the context menu.

3 In the Device summary window, type the Device, Hostname/ IP address, and Description for this physical device.

4 Select the appropriate Manufacturer and Model for this device from the drop lists.

The Monthly volume Speed data appears automatically, based on the Manufacturer/Model selections. The device Type displays Physical device.

5 Click Pricing to assign a price list to this device. If desired, apply a Primary price list for each applicable function on the device.

NOTE: If you wish to have a different price list apply to certain user types, or during peak times of the day, you can define one price list for that situation, and a secondary price list to apply at all other times. Refer to the Equitrac Office/Express Administration Guide for more information on configuring price lists.

6 Select a printing Ruleset for this device.

7 Click the Printer languages option to select the printer languages interpreted by this print driver.

8 Click OK to save these settings, or Cancel to close the window without saving any of the data.

Connecting Network Workstations1 On the network workstations, connect to the new printers that you configured on the UNIX server.

2 Install printer drivers on each workstation as needed.

Equitrac Express 3.0 UNIX Print Server Module Guide · Equitrac Office/Express UNIX Print Server...

Documents

Transcript of Equitrac Express 3.0 UNIX Print Server Module Guide · Equitrac Office/Express UNIX Print Server...