Equitrac Office and Express 5.5 SUSE Linux iprint Server Guide 2015
Equitrac Office/Express 5.5 SUSE Linux iprint Server Guide Document History Revision Date Revision List June 03, 2015 Updated for Equitrac Office and Equitrac Express 5.5 September 5, 2014 Updated for Equitrac Office and Equitrac Express 5.4 March 31, 2014 Updated for Equitrac Office and Equitrac Express 5.3 November 22, 2013 Updated for Equitrac Office and Equitrac Express 5.2 April 22, 2013 Updated for Equitrac Office and Equitrac Express 5.0 May 9, 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, 2010 Updated for Equitrac Office and Equitrac Express 4.2.1 July 5, 2010 Updated for Equitrac Office and Equitrac Express 4.2.0 June 24, 2009 Updated for Equitrac Office and Equitrac Express 4.1.1 December 19, 2008 Created initial document for Equitrac Office and Equitrac Express 4.1.0 2015 Nuance Communications, Inc. All rights reserved. All rights to this document, domestic and international, are reserved by Nuance Communications, Inc. 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 Nuance. Trademarks Equitrac, Equitrac Express, Equitrac Office, Follow-You Printing, and PageCounter are registered trademarks of Nuance Communications, Inc. 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: Note Caution The accompanying text provides cross-reference links, tips, or general information that can add to your understanding of the topic. The accompanying text provides key information about a step or action that might produce unexpected results if not followed precisely. Warning Read the accompanying text carefully. This text can help you avoid making errors that might negatively affect program behavior.
Contents 1 Overview.............................................................................. 5 System Requirements..................................................................................... 6 On the SUSE Linux Server.......................................................................................... 6 On the Equitrac Office or Express Accounting Server................................................................ 6 On the Windows Management Workstation........................................................................ 6 Server Licensing................................................................................................... 6 SUSE Linux iprint Server Terminology...................................................................... 7 Integrating Equitrac with SUSE Linux iprint Servers.......................................................... 7 Equitrac Office/Express Core Components on the SUSE Linux iprint Server........................................... 7 Equitrac Office/Express Components on a Windows Server.......................................................... 8 Workstation Administrative Applications........................................................................... 8 The Equitrac Office/Express Print Server.................................................................... 9 Printer Control..................................................................................................... 9 Printer Tracking.................................................................................................... 9 Interaction with iprint.............................................................................................. 9 2 Server Installation and Configuration................................................. 11 Installation Overview..................................................................................... 12 Installing Linux for Equitrac Office or Express.............................................................. 13 Running the Setup Script................................................................................. 14 Installed Files............................................................................................ 14 3 Printer Configuration................................................................ 15 Identifying the Core Accounting Server................................................................... 16 Controlling the Equitrac Office/Express Daemons.......................................................... 16 Enabling Accounting for a Printer Agent................................................................... 16 Equitrac Office and Express SUSE Linux iprint Server Guide 3
Contents 4 Equitrac Office and Express SUSE Linux iprint Server Guide
1 Overview Topics System Requirements SUSE Linux iprint Server Terminology Integrating Equitrac with SUSE Linux iprint Servers The Equitrac Office/Express Print Server This guide is intended to help install and configure the Equitrac SUSE Linux iprint Server Guide. It assumes you are familiar with Novell OES11 and Windows network administration. The Equitrac SUSE Linux iprint Server Guide enables accounting on OES11 iprint servers by monitoring printing and reporting printer usage to an Equitrac accounting server. Before installing the Equitrac SUSE Linux iprint Server Guide, configure core Equitrac Office or Express components on your network. For information on installing and configuring Equitrac Office or Express, please see the Equitrac Office and Express Installation Guide and the Equitrac Office and Express Administration Guide. Any references to Windows servers in this document apply to Windows Server 2008, 2008 R2 or 2012. Equitrac Office and Express SUSE Linux iprint Server Guide 5
Chapter 1: Overview System Requirements The following Equitrac, Microsoft, and SUSE Linux components are required in order to configure print tracking on the SUSE Linux iprint Server Guide. On the SUSE Linux Server SUSE Linux Enterprise Server (SLES) 11 SP2 with Novell OES11 SP2 including iprint support (64-bit) You must have the iprint patch Novell iprint Server FTF - Accounting API Fix x86-64 x86 (dated 15 Apr 2010 or newer). On the Equitrac Office or Express Accounting Server Windows Server 2008, 2008 R2 or 2012 Equitrac Office or Equitrac Express 5.5 Core Accounting Server installed and configured On the Windows Management Workstation The management workstation requires: Windows 7 Professional/Enterprise/Ultimate, Windows 8 and 8.1 Professional/Enterprise, or any of the Windows servers listed on the Equitrac Office or Express Accounting Server. Equitrac Office/Express System Manager Equitrac Office/Express Accounts Manager Server Licensing The Equitrac SUSE Linux iprint Server Guide are 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 or Express, refer to the Equitrac Office and Express Administration Guide. 6 Equitrac Office and Express SUSE Linux iprint Server Guide
Chapter 1: Overview SUSE Linux iprint Server Terminology Before you install Equitrac SUSE Linux iprint Server Guide, you should be familiar with the following terms: Term Equitrac Office/Express printer registration Physical printer Print agent iprint Manager Definition Information about a logical printer definition stored in the Equitrac database to track usage. A registration includes a printer name, a user-defined description and the printer s assigned costs. The actual printing device. A logical definition that represents a physical printer on a Linux server. When loaded, the iprint Manager manages a number of printer agents. Integrating Equitrac with SUSE Linux iprint Servers The Equitrac SUSE Linux iprint Server Guide integrates a SUSE Linux OES11 iprint 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 the SUSE Linux iprint Server Equitrac Component eqdred eqctrl eqacctg Integration Communicates with the Core Accounting Server service on the Windows server (Linux version of Equitrac s Document Routing Engine). Control script for eqdred. You can this script with start, stop, restart, and status arguments to perform the corresponding action on eqdred. The Linux RC system also uses this script to automate starting and stopping eqdred when the system changes state (for example, stop, start, reboot, halt). Handles events from iprint when a job starts and ends in order to control if the job will be printed, held, or deleted by eqdred. Also does pagecounting details reporting to eqdred. Equitrac Office and Express SUSE Linux iprint Server Guide 7
Chapter 1: Overview Equitrac Office/Express Components on a Windows Server Equitrac Component Core Accounting Server Equitrac Database Integration 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 Stores information about printing transactions, printing accounts and balances, printers, printer costs, and scheduled events. Workstation Administrative Applications Equitrac Component System Manager Accounts Manager Integration Enables the system administrator to: configure and monitor Windows server components assign costs to printers and copiers Enables the financial administrator to: manage user, department and billing code accounts perform account transactions 8 Equitrac Office and Express SUSE Linux iprint Server Guide
Chapter 1: Overview The Equitrac Office/Express Print Server The Equitrac Office/Express print server components perform two functions on the SUSE Linux OES11 iprint server: printer control and printer tracking. Printer Control On a SUSE Linux OES11 iprint server, the eqacctg process monitors and controls printing activity. When you configure a Printer Agent with accounting via the eqacctg program, it prevents unauthorized users from printing to network printers. When the eqacctg module is notified that a job is about to start printing, it checks with the Document Routing Engine to know how to handle a job. The DRE communicates with the Core Accounting Server to determine if the job can be printed. The DRE may allow the job to print, deny the job, or store the job in a secure queue for later printing. See Advanced Printing Configuration in the Equitrac Office and Express Administration Guide for more information. Printer Tracking The 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. NOTE: The Equitrac SUSE Linux OES11 iprint Server does not support PJL and SNMP page counting. Interaction with iprint When a network workstation generates a print request: The iprint Manager calls eqacctg to signal the job start event Eqacctg calls eqdred and depending on the instructions from DRE, attempts to count the print data stream, allows the print, or tells the iprint Manager to cancel the job. The iprint Manager calls eqacctg to signal the job end event Eqacctg calls eqdred to report the end of the job along with information such as page count details. NOTE: The eqacctg utility does not communicate directly with printers. Its job is to tell the iprint system to allow the job to print or to cancel the job. The iprint system continues to handle sending jobs to the physical device as it did before the Equitrac Office/Express print server components were installed. Equitrac Office and Express SUSE Linux iprint Server Guide 9
Chapter 1: Overview 10 Equitrac Office and Express SUSE Linux iprint Server Guide
2 Server Installation and Configuration Topics Installation Overview Installing Linux for Equitrac Office or Express Running the Setup Script Installed Files Equitrac Office and Express supply a native install package for SUSE Linux. The automated installation uses /usr/local/eq as the base directory for the software. Equitrac Office and Express SUSE Linux iprint Server Guide 11
Chapter 2: Server Installation and Configuration Installation Overview There are three steps to installing and configuring a SUSE Linux OES11 iprint server for Equitrac Office/Express: 1 Copy the files to the SUSE Linux server and run the installation program. 2 On the server, go to /usr/local/eq and run setup. This is the script that calls eqcascfg and eqctrl to configure and start the eqdred daemon. NOTE: You can run eqcascfg at any time to change the Equitrac Accounting Server. You must restart eqdred manually after any changes you make with eqcascfg. See Running the Setup Script on page 14 for script details. 3 Enable accounting on your Printer Agents using the printer agent health monitor. 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. NOTE: If installation is not successful, ensure that the SUSE Linux iprint server is communicating properly with the Equitrac Accounting Server. Ensure that the Accounting Server is online. 12 Equitrac Office and Express SUSE Linux iprint Server Guide
Chapter 2: Server Installation and Configuration Installing Linux for Equitrac Office or Express 1 Copy the installation package, Equitrac_iPrint.5.5.24.0000.zip 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 command would be: rpm ivh --nodeps /tmp/equitrac_iprint.5.5.24.0000.rpm 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 eqcascfg command. NOTE: The server s root user must own eqacctg with the +s privilege in order to enable access to the DRE spool files. Uninstalling Linux rpm -e Equitrac_iPrint Equitrac Office and Express SUSE Linux iprint Server Guide 13
Chapter 2: Server Installation and Configuration Running the Setup Script This 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 server and start the eqdred daemon. Installed Files This section provides a list of all files installed with Equitrac for SUSE Linux OES11 print servers. /usr/local/eq/license /usr/local/eq/eqpce.cfg /usr/local/eq/psinit/coreinit.ps /usr/local/eq/psinit/userinit.ps /usr/local/eq/eqspool /usr/local/eq/eqspool/devmode/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/eqcascfg /usr/local/eq/eqdre.cfg /opt/novell/iprint/bin/eqacctg /etc/init.d/eqctrl 14 Equitrac Office and Express SUSE Linux iprint Server Guide
3 Printer Configuration Topics Identifying the Core Accounting Server Controlling the Equitrac Office/Express Daemons Enabling Accounting for a Printer Agent Printer Agents must first be defined to print to physical printers. Consult your SUSE Linux OES11 iprint documentation. Equitrac Office and Express SUSE Linux iprint Server Guide 15
Chapter 3: Printer Configuration Identifying the Core Accounting Server To configure the DRE, you need to specify the name of the server hosting the Equitrac Office or Express Core Accounting Server (CAS), using the eqcascfg script. For example: /usr/local/eq/eqcascfg e your.server.com You can specify the name of the Equitrac server as a fully-qualified name or an IP address. Controlling the Equitrac Office/Express Daemons To start the Equitrac Office/Express damons on the Linux 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 damons, use the supplied shell script: /usr/local/eq/eqctrl restart To see the status of the Equitrac Office/Express damons, 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 location. For a complete list of installed files and scripts, see Installed Files on page 14. Enabling Accounting for a Printer Agent Each Printer Agent for which you want print control and tracking must be configured to use the eqacctg module. 1 Using a web browser, browse to your OES11 server and use imanager to browse to the iprint tasks. 2 Select Manager Printer, and select the Printer Agent you wish to configure. 3 On the Printer Control tab, click the Printer Health Monitor link. 4 On the new page that is displayed, find and click the Configuration options link. 5 In the Accounting Autoload Command edit field, enter eqacctg, and press the Apply button. 6 Restart the Printer Agent. 7 Repeat steps starting at #2 for each additional Printer Agent to be configured. A physical device, port, and print queue will be created in System Manager in the same manner as any other DRE device. 16 Equitrac Office and Express SUSE Linux iprint Server Guide