Cisco Fax Server Installation Guide, Release 9.0

Version 9.0
Installation Guide
RightFax 9.0 Installation Guide
Edition
Information in this document applies to version 9.0 of the RightFax Installation Guide.
Copyright Notice
©2004 Captaris. All rights reserved. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language in any form by any means without the written permission
of Captaris. Captaris products Interchange, RightFax and Teamplate are trademarks of Captaris. All other company, brand and product names are the property and/or trademarks of their respective companies.
Captaris
10885 NE 4th Street
Suite 400
Bellevue, WA 98004
(425) 455-6000
http://www.captaris.com
Information in this document is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted.
JetPCL PCL Emulation Software copyright 1990-2003 Tech Know Systems, Ltd. Company, All rights reserved. Portions copyright ©1999 Ligature. All rights reserved. Portions copyright ©1988, 1996 Aladdin Enterprises. All
rights reserved. Portions copyright ©1993 Soft Horizons. All rights reserved. Outside In® Viewer Technology copyright ©1992-2003 Inso Corporation. All rights reserved. Copyright © TMS, Inc. 1994-2002. All rights reserved.
Portions copyright ©2001 artofcode LLC. Portions Copyright ©1996, 2001 Artifex Software Inc. Portions Copyright ©1998 Soft Horizons. All Rights Reserved. Adobe, Acrobat, and the Acrobat logo are trademarks of Adobe
Systems Incorporated. Includes Adobe® PDF Library technology. All rights reserved. PostScript is a trademark of Adobe Systems Incorporated. This software is based in part on the work of the Independent JPEG Group.
For More Information
Captaris is a leading provider of Business Information Delivery solutions that integrate, process and automate the flow of messages, data and documents. Captaris produces a suite of proven products and services, in partnership
with leading enterprise technology companies, delivered through a global distribution network. Captaris has installed over 80,000 systems in 44 countries, with 93 of the Fortune 100 using the company's award-winning products
and services to reduce costs and increase the performance of critical business information investments. For more information please contact us at www.captaris.com or call +1.520.320.7000.
ii
RightFax 9.0 End User License Agreement
IMPORTANT – READ CAREFULLY: This End User License Agreement
(“EULA”) is a legal agreement between you (either an individual or a single
entity) and Captaris, Inc. (“Captaris”) for the Captaris software product
identified above, which includes computer software and may include
associated media, printed materials, and “online” or electronic documentation
(“Product”).
YOU AGREE TO BE BOUND BY THE TERMS OF THIS EULA BY
INSTALLING, COPYING OR OTHERWISE USING THE PRODUCT. IF YOU
DO NOT AGREE TO THE TERMS OF THIS EULA, DO NOT INSTALL, COPY
OR USE THE PRODUCT. INSTEAD, YOU MAY RETURN THE PRODUCT
TO YOUR PLACE OF PURCHASE FOR A FULL REFUND.
Software License
Subject to the terms and conditions herein, Captaris grants you a
non-exclusive, non-transferable, personal license to install, run and use one
copy of the software provided as part of the Product on a single computer that
is owned or controlled by you for use in the capacity and by the number of
concurrent users for which you have paid license fees. For purposes of the
preceding sentence, the capacity licensed by you is determined based on the
number of ports (also referred to as channels), seats, CPUs or other capacity
limitations on which software pricing is based.
Documentation
You may make and use a reasonable number of copies of any documentation
provided with the Product; provided, that such copies will only be used for
internal business purposes and are not to be republished or redistributed
(either in hard copy or electronic form) beyond your premises.
Updates
Any software provided to you by Captaris which updates or supplements the
original Product is governed by this EULA unless separate license terms are
provided with such updates or supplements, in which case, such separate
terms will govern.
License Limitations
The preceding licenses apply only to the extent you have ordered and paid for
the applicable licenses. The preceding states the entirety of your rights with
respect to the Product. Captaris reserves all rights not expressly granted to you
in this EULA. Without limiting the foregoing, you will not, and you will not
authorize or permit any third party to:
a. use the Product for any purpose other than your internal business
purposes;
b. license, distribute, lease, rent, lend, transfer, assign or otherwise dispose
of the Product or use the Product in any commercial hosted or service
bureau environment;
c. reverse engineer, decompile, disassemble or attempt to discover the
source code for or any trade secrets related to the Product, except and
only to the extent that such activity is expressly permitted by applicable
law notwithstanding this limitation;
d. modify, alter or create any derivative works of the Product;
e. exceed the capacity or concurrent user limitations for the license
purchased by you; or
f. remove, alter or obscure any copyright notice or other proprietary rights
notice on the Product.
Backup
You may make one copy of the Product for back-up and archival purposes.
iii
RightFax 9.0 Installation Guide
Audit
Captaris shall have the right to audit your compliance with the terms of this
EULA. You agree to grant access to Captaris to facilities, equipment, books,
records and documents and to otherwise reasonably cooperate with Captaris
in order to facilitate any such audit.
Ownership
The Product is valuable property of Captaris and its suppliers and is protected
by copyright and other intellectual property laws and treaties. Captaris or its
suppliers own all right, title and interest in and to the Product and all copyright
and other intellectual property rights in the Product.
Limited Warranty
Captaris warrants to you that the Product will perform substantially in
accordance with the accompanying Product manual for a period of thirty (30)
days from the date of receipt. To the maximum extent permitted by applicable
law, Captaris’s and its suppliers’ entire liability and your exclusive remedy for
failure of the software to conform to the foregoing warranty is, at Captaris’s
option, either (a) return of the price paid by you for the Product, update or
module (as applicable) in exchange for return of the Product, update or module
(as applicable) by you, or (b) repair or replacement of the Product that does not
meet the warranty. The foregoing warranty is void if the failure of the Product is
due to accident, abuse or misapplication. Any replacement Product will be
warranted for the remainder of the original warranty period, if any.
Indemnification
Captaris will defend you against any judicial proceeding based upon a third
party claim that the Product infringes any U.S. patent, U.S. trademark,
copyright or trade secret and will indemnify you against any damages,
judgments and costs finally awarded against you in such proceeding; provided
that, you: (a) give Captaris prompt written notice of the claim; (b) permit
Captaris to control the defense and settlement of the claim; and (c) cooperate
with Captaris in the defense and settlement of the claim. Captaris's defense
and indemnification obligations will not apply to any actual or alleged
infringement based upon: (i) modification of the Product by anyone other than
Captaris, (ii) abuse, misapplication or casualty loss, (iii) use of the Product in
combination with any other program or device, if such infringement would have
been avoided but for such modification or combination, or (iv) failure to install
or use any error corrections, fixes or other updates furnished by Captaris, if
such infringement could have been avoided by such installation or use. In the
event the Product or your use of the Product is held to infringe or in Captaris’s
reasonable judgment is likely to infringe any third party intellectual property
right, Captaris may, at its option, (x) obtain a license for you to continue to use
the Product, (y) modify the Product so that it is noninfringing, or (z) terminate
this EULA and refund a portion of the license fee paid by you for the Product
prorated over three (3) years from the date of purchase.
Disclaimer of Warranties
EXCEPT AS EXPRESSLY SET FORTH ABOVE, CAPTARIS AND ITS
SUPPLIERS PROVIDE THE PRODUCT “AS IS” AND WITH ALL FAULTS.
CAPTARIS AND ITS SUPPLIERS HEREBY DISCLAIM ALL OTHER
WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, ARISING BY LAW
OR OTHERWISE, INCLUDING BUT NOT LIMITED TO ANY IMPLIED
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE OR USE, TITLE AND NONINFRINGEMENT, WITH REGARD TO
THE PRODUCT. WITHOUT LIMITING THE FOREGOING, CAPTARIS
DOES NOT WARRANT THAT THE PRODUCT WILL BE FREE OF BUGS,
ERRORS, VIRUSES OR OTHER DEFECTS.
Disclaimer of Certain Damages
IN NO EVENT WILL CAPTARIS OR ITS SUPPLIERS BE LIABLE FOR THE
COST OF COVER OR FOR ANY INCIDENTAL, INDIRECT, SPECIAL,
PUNITIVE, CONSEQUENTIAL OR SIMILAR DAMAGES OR LIABILITIES
WHATSOEVER (INCLUDING, BUT NOT LIMITED TO LOSS OF DATA,
INFORMATION, REVENUE, PROFIT OR BUSINESS) ARISING OUT OF
OR RELATING TO THE USE OR INABILITY TO USE THE PRODUCT OR
OTHERWISE UNDER OR IN CONNECTION WITH THIS EULA OR THE
PRODUCT, WHETHER BASED ON CONTRACT, TORT (INCLUDING
NEGLIGENCE), STRICT LIABILITY OR OTHER THEORY EVEN IF
CAPTARIS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
Limitation of Liability
CAPTARIS’S AND ITS SUPPLIERS’ LIABILITY ARISING OUT OF OR
RELATING TO THE USE OR INABILITY TO USE THE PRODUCT OR
OTHERWISE UNDER OR IN CONNECTION WITH THIS EULA OR THE
PRODUCT IS LIMITED TO THE AMOUNT ACTUALLY PAID BY YOU FOR
THE PRODUCT REGARDLESS OF THE AMOUNT OF DAMAGES YOU
MAY INCUR AND WHETHER BASED ON CONTRACT, TORT (INCLUDING
NEGLIGENCE), STRICT LIABILITY OR OTHER THEORY. The foregoing
iv
disclaimer of warranties, disclaimer of certain damages and limitation of liability
will apply to the maximum extent permitted by applicable law. The laws of some
states/jurisdictions do not allow the exclusion of implied warranties or the
exclusion or limitation of certain damages. To the extent that those laws apply
to this EULA, the exclusions and limitations set forth above may not apply to
you.
Export Restrictions
You acknowledge that the Product is subject to U.S. export restrictions. You
agree to comply with all applicable laws and regulations that apply to the
Product, including without limitation the U.S. Export Administration
Regulations.
U.S. Government License Rights
All Product provided to the U.S. Government is provided with the commercial
license rights and restrictions described in this EULA. By installing, copying or
using the Product, the U.S. Government agrees that the Product is
“commercial computer software” or “commercial computer software
documentation” within the meaning of FAR Part 12.
Trademarks
This EULA does not grant you any rights in connection with any trademarks or
service marks of Captaris or its suppliers.
Termination
Without prejudice to any other rights, Captaris may terminate this EULA if you
do not abide by the terms and conditions contained herein. In such event, you
must cease use of the Product and destroy all copies of the Product and all of
its component parts.
Transfer
You may not transfer your rights under this EULA to any third party.
Governing Law; Jurisdiction
Unless expressly prohibited by local law, this EULA is governed by the laws of
the State of Washington, U.S.A. without regard to any conflict of law principles
to the contrary. The 1980 U.N. Convention on Contracts for the International
Sale of Goods or any successor thereto does not apply. You hereby irrevocably
submit to jurisdiction of the state and federal courts located in King County,
Washington with respect to any proceeding under this EULA or relating to the
Product. You will not prosecute any action, suit, proceeding or claim arising
under or by reason of this EULA except in such courts.
Attorneys' Fees
In any action or proceeding to enforce rights under this Agreement, the
prevailing party will be entitled to recover costs and reasonable attorneys' fees.
Severability
If any provision of this EULA is held by a court of competent jurisdiction to be
invalid, illegal, or unenforceable, the remainder of this EULA will remain in full
force and effect.
English Language
It is the express wish of the parties that this Agreement and all related
documents be drawn up in English. C'est la volonté expresse exigé par les
parties que cette convention et tous les documents y afférents, soient rédigés
en anglais seulement.
Entire Agreement
This EULA sets forth the entire agreement of Captaris and you with respect to
the Product and the subject matter hereof and supersedes all prior and
contemporaneous understandings and agreements whether written or oral. No
amendment, modification or waiver of any of the provisions of this EULA will be
valid unless set forth in a written instrument signed by the party to be bound
thereby.
Captaris Inc. Software License Agreement
v
RightFax 9.0 Installation Guide
vi
Contents
Chapter 1
Hardware and Software Requirements............................ 9
Fax Server Requirements ................................................................9
Fax Board Requirements.................................................................9
Phone Line Requirements............................................................ 10
Chapter 2
What Is Installed on the RightFax Server?.................... 11
RightFax Software.......................................................................... 11
RightFax Configuration Programs .............................................. 11
RightFax Services .......................................................................... 14
RightFax Registry Entries ............................................................. 14
RightFax Client Applications ....................................................... 14
Chapter 3
Installing the RightFax Server Software ........................15
Before You Begin............................................................................15
Upgrading from a Previous Version of RightFax......................15
Installation Overview ......................................................................19
Installing the RightFax Server Software ....................................19
Enabling Your Licensed Product Feature Set ..........................22
Installing the Fax Board Drivers...................................................22
Installing the RightFax Administrative Utilities..........................23
Installing the RightFax Web Applications..................................24
Repairing the RightFax Server Installation ................................26
Uninstalling the RightFax Server .................................................26
Using Enterprise Fax Manager.....................................................27
Running Silent Installs of the Server
and Fax Board Drivers ................................................................28
vii
RightFax 9.0 Installation Guide
Chapter 4
Installing the RightFax Client Applications .................. 37
RightFax Client Computer Requirements ................................ 39
Upgrading the RightFax Client Applications ........................... 39
Before You Begin........................................................................... 40
RightFax Client Installation Methods..........................................41
Installing the Client Applications
from the RightFax CD .................................................................41
Installing the Client Applications
from a Network File Share .........................................................42
Creating an Automated Client Install .........................................43
Configuring Windows Terminal Server
to Support RightFax Client Sessions..................................... 46
Troubleshooting the Client Installation
and Configuration ....................................................................... 46
Chapter 5
Upgrading and Adding Fax Channels,
User Licenses, and Optional Components.................... 49
Checking for Installed Components.......................................... 49
Upgrading the RightFax Server .................................................. 50
Adding Fax Channels and User Licenses .................................51
Enabling New RightFax Optional Components .......................52
Chapter 6
Documentation and Support............................................. 53
RightFax Documentation...............................................................53
Getting Help Online .......................................................................55
Captaris Training Services............................................................55
Captaris Implementation Services ............................................. 56
Customer Support......................................................................... 56
Appendix A
Installing RightFax in a Windows 2000
or Windows 2003 Cluster57
System Requirements....................................................................57
Configuring the Cluster Group....................................................57
Configuring RightFax BoardServers...........................................57
Installing the RightFax Server ..................................................... 58
Creating the RightFax Cluster Resources ............................... 59
Configuring the RightFax Printer ................................................ 60
Configuring the SQL Server Database .....................................61
Completing the Installation...........................................................61
viii
Chapter 1
Hardware and Software Requirements
Fax Server Requirements
This version of the RightFax server can be installed and run only on
computers running the following operating systems:
Recommended hardware requirements
Computer/Processor 966 MHz or higher Pentium III-compatible CPU
Microsoft Windows Server 2003 Standard Edition
Memory
512 MB RAM
Hard drive
2 GB free space
Microsoft Windows Server 2003 Enterprise Edition
Microsoft Windows Server 2003 Cluster
CPU support
Single and dual CPU systems
Microsoft Windows 2000 Advanced Server with SP4 installed
Drive
CD-ROM or DVD drive
Microsoft Windows 2000 Server with SP4 installed
Display
SVGA or higher resolution monitor running at a
resolution of 800 × 600 or higher
Keyboard
Required
Minimum hardware requirements
Computer/Processor 500 MHz or higher Pentium III-compatible CPU
Memory
512 MB RAM
Hard drive
1 GB free space
CPU support
Single and dual CPU systems
Drive
CD-ROM or DVD drive
Display
VGA or higher resolution monitor running at a
resolution of 800 × 600 or higher
Keyboard
Required
Fax Board Requirements
RightFax supports Brooktrout fax boards, Intel Dialogic (also known
as GammaLink) fax boards, and Eicon fax boards. For a list of all
supported fax board types, refer to the RightFax Fax Board Guide.
Installing the fax boards
Fax boards can be installed in the computer running the RightFax
server software, or on a separate computer called a Remote
BoardServer. For information on using Remote BoardServer
computers, refer to the RightFax Administrator’s Guide.
Chapter 1 Hardware and Software Requirements
9
RightFax 9.0 Installation Guide
Phone Line Requirements
The fax boards that RightFax supports can make use of several
different types of phone lines: loop-start (regular analog phone
lines), Direct Inward Dial (DID), Dialed Number Identification
Service (DNIS), Integrated Services Digital Network (ISDN), and
several types of digital phone lines. Different types of fax boards
support different types of phone lines. For information on the types
of fax boards that are compatible with your available phone lines,
refer to your fax board supplier or manufacturer.
four digits of the phone number dialed. The fax board collects these
digits and passes them to RightFax. Each RightFax user has a
personal fax mailbox which is assigned one of the DID trunk’s
numbers (known as the “routing code”). Received faxes are routed
to the mailbox whose routing code matches the dialed DID number.
Warning Never plug a loop-start phone line into a DID fax board when
there is any voltage present on the phone line. Doing so will damage the
fax board and void all warranties.
Dialed Number Identification Service (DNIS) phone lines
Loop-start phone lines
Loop-start lines can be used for incoming or outgoing faxes. A line
can be installed by the local telephone company if one is not
already available through your organization’s existing phone
system. Loop-start lines are also called POTS (Plain Old Telephone
Service) lines.
Direct Inward Dial (DID) phone lines
Each DID phone line is called a “trunk.” When a DID trunk is
installed, it is assigned a bank of numbers. For example, a DID
trunk may be assigned the bank of 20 numbers ranging from
321-7450 to 321-7469. All calls to any of the assigned numbers
are routed to the DID trunk.
DID phone lines have a few special attributes. First, DID lines are
used for incoming faxes only. Outgoing faxes must be sent through
a standard loop-start line. Second, the customer, rather than the
phone company, supplies the power (called the “talk battery”)
necessary to drive the phone line. For this reason, DID fax boards
come with an additional power adapter which provides the
necessary –48 volt current.
DID allows RightFax to route incoming faxes to their intended
destinations within your company. Whenever someone dials a
number within the range, the DID trunk is activated by the phone
company and the fax board accepts the incoming fax. Along with
the fax data, the phone company sends the board the last three or
DNIS is a T1-based version of DID service. For information on
configuring your fax boards for DNIS, refer to the hardware guide
included with your fax board.
Integrated Services Digital Network (ISDN) phone lines
ISDN is a worldwide standard communications network for digital
data, voice, and video communication. The main advantages of
ISDN over analog telephone lines are fast call setup and release
and additional cost-recovery information included with the call.
PRI, BRI, E1, and T1 digital phone lines
RightFax supports PRI, BRI, E1, and T1 digital phone lines
assuming you have purchased and installed the appropriate type of
fax boards and network interface card. For more information on
digital phone lines, refer to the RightFax Fax Board Guide.
10
Chapter 2
What Is Installed on the RightFax Server?
The RightFax server installation program installs the complete suite
of RightFax products. The capabilities of the server and the
modules that are enabled depend on your product licensing.
Because all of the RightFax software is installed, the RightFax
server can be upgraded and optional modules can be added simply
by purchasing a license and activating the feature. For information
about upgrading the server and adding new RightFax modules, see
Chapter 5, “Upgrading and Adding Fax Channels, User Licenses,
and Optional Components”.
In addition to the installed software, The RightFax installation
creates several Windows services, adds RightFax configuration
settings to the Windows Registry, adds configuration programs to
Windows Control Panel, and installs the FaxUtil and Enterprise Fax
Manager client programs.
RightFax uses a SQL database to store all data on faxes, users,
and dialing rules. If you do not connect to an existing SQL
database on your network during installation, RightFax will install
and use an MSDE SQL database on the RightFax server computer.
This is a fully functional SQL database, but lacks the SQL
management tools that accompany the full version of Microsoft
SQL server.
RightFax Software
All of the RightFax software is installed on the server in the folder
you specify during installation. By default, the software installs in
the C:\Program Files\RightFax folder. Third-party software that is
used by the RightFax server, such as fax board drivers, may be
installed in other locations.
RightFax Configuration Programs
The RightFax server includes several configuration programs that
let you customize the RightFax services. The RightFax configuration
programs can be run from Windows Control Panel or from
Enterprise Fax Manager (described in the RightFax Administrator’s
Guide).
Chapter 2
What Is Installed on the RightFax Server?
11
RightFax 9.0 Installation Guide
The following table describes all of the RightFax configuration
programs that are available.
Note Some of these configuration programs may not be enabled on the
server, depending on the type of RightFax server you have licensed and
the modules that are enabled.
Table 2a RightFax Server Configuration Programs (Continued)
Configuration
program
RightFax Doc
Transport
Table 2a RightFax Server Configuration Programs
Configuration
program
Use this program to configure the RightFax Alerting
and Monitoring feature. This feature lets RightFax
administrators create custom server statistics to
monitor and define thresholds on which to send
alerts. For more information on the Alerting and
Monitoring feature, refer to the RightFax
Administrator’s Guide.
RightFax BoardServer
This is a configuration program used for most of the
fax boards supported by RightFax. Use the
BoardServer configuration program to customize
each installed fax board and each fax channel.
Although you may have only one BoardServer
service installed on a single computer, you can
optionally create RightFax BoardServer services on
remote computers to offload fax board processes or
to expand your network’s fax board and fax channel
capacity. For more information on BoardServers,
refer to the RightFax Administrator’s Guide.
The BoardServer configuration program can only be
launched from within the Doc Transport program
(described next.)
For more information on the fax boards you use and
their configuration requirements, and the T.37 and
T.38 Fax-over-IP features, refer to the RightFax Fax
Board Guide. For information on document
transport via SMS, refer to the RightFax
Administrator’s Guide.
The Doc Transport configuration program is used to
configure several transport methods for your
RightFax documents including standard fax boards,
T.37 Fax-over-IP, and SMS (short message service).
All fax board configuration, including BoardServer
configuration, is initiated from this configuration
program.
Description
RightFax Alerting
Description
For more information on the fax boards you use and
their configuration requirements, and the T.37 and
T.38 Fax-over-IP features, refer to the RightFax Fax
Board Guide. For information on document
transport via SMS, refer to the RightFax
Administrator’s Guide.
RightFax EDC
Use this program to configure connections between
RightFax and third-party document delivery systems
such as FileNet applications and Xerox
multi-function products. The RightFax EDC (External
Document Connector) is a generic connector that
allows the RightFax server to communicate with
external systems. Instructions for how to configure
the RightFax EDC are included in the
documentation for each supported external system.
RightFax E-mail
Gateway
Use this program to create and modify the RightFax
e-mail gateway services. E-mail gateway services
act as the communication link between the RightFax
server and your organization’s e-mail software. It is
possible to install multiple e-mail gateways, each
communicating with a different e-mail server. For
more information on e-mail gateways, refer to the
RightFax Administrator’s Guide, the RightFax
Gateway for Microsoft Exchange Guide, or the
RightFax Gateway for Lotus Notes Guide
(depending on the gateway you add).
12
Table 2a RightFax Server Configuration Programs (Continued)
Configuration
program
Description
Table 2a RightFax Server Configuration Programs (Continued)
Configuration
program
Description
RightFax Integration
Use this program to modify the RightFax Integration
Module service. The Integration Module integrates
the RightFax server with applications on mainframe,
mid-range, and local area network host systems. For
more information on the RightFax Integration
Module, refer to the RightFax Integration Module
Guide.
RightFax Server
Use this program to modify the RightFax Server
service. The Server service controls all of the
RightFax services and coordinates communication
between the server computer, client computers, fax
boards, and the fax database. For more information
on the RightFax Server service, refer to the RightFax
Administrator’s Guide.
RightFax SAP
Connector
Use this program to create and modify the RightFax
SAP gateway services. SAP gateway services act
as the communication link between the RightFax
server and SAP clients. It is possible to install
multiple SAP gateways, each communicating with a
different SAP client. For more information on the
SAP gateway module, refer to the RightFax
Connector for SAP R/3 Guide.
RightFax WorkServer
Use this program to create and modify the RightFax
WorkServer services. WorkServer services perform
the most processor-intensive functions required by
the RightFax server, such as cover sheet generation,
PCL-to-fax conversion, and optical character
recognition. By default, three separate WorkServer
services are installed on the RightFax server, and
each WorkServer service can be customized to
perform specific functions. You can also create
RightFax WorkServer services on remote computers
to offload your most processor-intensive functions.
For more information on WorkServers, refer to the
RightFax Administrator’s Guide.
Chapter 2
What Is Installed on the RightFax Server?
13
RightFax 9.0 Installation Guide
RightFax Services
The names of all RightFax services begin with the word “RightFax.”
This lets you easily identify all of RightFax services that are currently
running. You can modify most RightFax services through their
configuration programs, which can be run from Windows Control
Panel or from the RightFax administrative program, Enterprise Fax
Manager (described in the RightFax Administrator’s Guide).
RightFax Registry Entries
All of the RightFax registry entries are located in the Windows
Registry under the following keys:
HKEY_LOCAL_MACHINE\SOFTWARE\RightFax
HKEY_LOCAL_MACHINE\SOFTWARE\RightFax Client
HKEY_CLASSES_ROOT\RF...
HKEY_CLASSES_ROOT\RightFax...
In most cases, you should not have to make changes or additions
to the RightFax registry settings. However, some RightFax features
do require you to make modifications to the Windows Registry.
Wherever this is true, instructions are provided in the RightFax
documentation.
RightFax Client Applications
In addition to the RightFax server software, several RightFax client
applications are available that allow administration of the fax
servers (Enterprise Fax Manager), user access to fax mailboxes
(FaxUtil), print drivers that allow users to print documents directly
to fax format for delivery to the RightFax server (RightFax print
drivers), and Web-based versions of these applications. For more
information FaxUtil, Enterprise Fax Manager, the RightFax print
drivers, and the Web-based equivalent applications, refer to the
RightFax Administrator’s Guide.
14
Chapter 3
Installing the RightFax Server Software
Before You Begin
Before you begin, ensure that your computer hardware and
software meets the minimum requirements for server installation as
outlined in Chapter 1, “Hardware and Software Requirements”.
Upgrading from a Previous Version of RightFax
You can only upgrade to version 9.0 from RightFax versions 8.5
and 8.7. If you are running an earlier version of RightFax, you must
either upgrade your earlier version to version 8.5 or 8.7, or
uninstall the RightFax server and perform a new installation of
RightFax 9.0.
Support for some fax boards has been discontinued with this
release. For a complete list of fax boards supported by this
version, refer to the RightFax Fax Board Guide. If you have
already installed one or more fax boards that do not appear on
this list, do not upgrade to this version of RightFax.
In RightFax version 9.0, the proprietary database used in
previous versions has been changed to a Microsoft SQL
database. During an upgrade, all existing RightFax database
objects will be converted to SQL with no loss of data. The
RightFax installation allows you to install a version of SQL directly
on the RightFax server, or you can connect to an existing SQL
database on your network. Note that the version of SQL provided
with RightFax has limited administrative functionality and includes
no database backup or maintenance tools. If you do not connect
to an existing full copy of Microsoft SQL database during
installation, you will probably need to acquire a suite of SQL
backup and maintenance tools separately.
Before upgrading from a previous version of RightFax, Captaris
recommends that you check the RightFax database for errors.
Run the DBCheck.exe program, and clean up the database if
needed. For instructions on DBCheck.exe, refer to the RightFax
Administrator’s Guide for your installed version of RightFax.
Before upgrading, back up the entire Program Files\RightFax
folder structure. To get a complete backup of your RightFax
server software, you must first stop all RightFax services.
Chapter 3 Installing the RightFax Server Software
15
RightFax 9.0 Installation Guide
Before upgrading an earlier version of the RightFax remote
BoardServer software, you must uninstall the existing remote
BoardServer software. To uninstall RightFax remote BoardServer
software, run the uninstall program from the Add/Remove
Programs application in Windows Control Panel. You must then
perform a new install of both the RightFax server software and fax
board drivers.
Before upgrading an earlier version of a Dialogic series fax driver,
you must remove the existing drivers. To uninstall the drivers, run
the uninstall program from the Add/Remove Programs
application in Windows Control Panel. You must then perform a
new install of the fax board drivers.
The RightFax Web Client shipped will RightFax versions prior to
9.0 has been replaced with a completely new Web client called
RightFax Web Access. If you will be installing RightFax Web
Access on the same IIS server on which an earlier version of the
RightFax Web client was installed, you must first uninstall the
existing RightFax Web Client software. Any custom pages
designed for your old Web client application will be lost.
Any existing files for the RightFax SecureDocs Module or
Enterprise Fax Manager Web Edition will be deleted when you
upgrade these applications on the Microsoft IIS server. If you
have created customized files for any of these applications, you
must save copies of the customized files before upgrading, and
then merge your customizations into the upgraded files.
The RightFax 8.5 SecureDocs Module must be uninstalled
before upgrading to RightFax 9.0. The earlier version of the
SecureDocs Module uses an MSDE database that is not
compatible with RightFax 9.0 and will cause installation to fail.
After upgrading a Windows 2003 server from a RightFax version
prior to version this version, you may receive error messages on
restart reporting that one or more RightFax services have shut
down improperly. This is a result of the earlier-version services
being shut down during installation. These messages can be
closed and disregarded.
By the time you receive this software, new information or software
updates may be available. For the latest information on RightFax
software, visit the RightFax support Web site at
www.captaris.com/customer_support. This Web site may provide
up-to-date information on installing and upgrading the RightFax
server.
Rolling out a software upgrade
If you have a large enterprise with a complex server and client
system, you may want to gradually phase in the RightFax software
upgrade.
Because the RightFax server software is backward-compatible with
all supported versions of the RightFax client software, you should
plan to upgrade the server first, and then upgrade the client
systems later.
The RightFax servers need not all be upgraded at the same time.
You can run a network of RightFax servers of different versions
without loss of functionality. The same is true for RightFax client
applications.
To automate the installation of the server on a network with a
network management system such as SMS, see “Running a silent
install of the RightFax server software” on page 30.
To install the RightFax client applications, refer to the RightFax
Administrator’s Guide.
Upgrading the RightFax Server
When upgrading a RightFax server, you must upgrade both the
server software and the hardware drivers. First upgrade the server,
then upgrade the hardware drivers.
The RightFax server upgrade copies your existing RightFax
database to an existing SQL server or lets you install an MSDE
2000 Release A database directly on the RightFax server. MSDE
does not include any SQL management tools such as database
backup utilities. If you intend to install MSDE, which is provided
16
When installing MSDE on a computer that is running Windows
2000 Server, the Microsoft Data Access Components (MDAC) are
automatically updated to MDAC 2.7 SP1a, unless a newer version
already exists on the server. These files are updated during a
MDAC 2.7 SP1a upgrade:
Warning If you will be installing the RightFax database to an existing
SQL server, the SQL server must be configured to use SQL mixed-mode
authentication. If the SQL server is set to use NT authentication only, the
database will not install properly. If your SQL server is configured to use
NT authentication, you must set it to use mixed-mode authentication
before installing RightFax. After the installation is complete, you can
re-set the SQL server for NT authentication. For instructions on
configuring RightFax to use NT authentication to the SQL server, refer to
the RightFax Administrator’s guide.
Table 3a Files updated during an MDAC upgrade
Running the RightFax server upgrade
with RightFax, Captaris recommends that you purchase a separate
SQL backup utility and any additional SQL management tools you
feel necessary for proper management of your RightFax database.
cliconfg.dll
cliconfg.exe
dbmsadsn.dll
dbmsrpcn.dll
dbnmpntw.dll
ds32gt.dll
instcat.sql
msadce.dll
msadcer.dll
msadcf.dll
msadcfr.dll
msadco.dll
msadcor.dll
msadcs.dll
msadds.dll
msaddsr.dll
msado15.dll
msadomd.dll
msador15.dll
msadox.dll
msadrh15.dll
msdadc.dll
msdaenum.dll
msdaer.dll
msdaora.dll
msdaosp.dll
msdaprsr.dll
msdaprst.dll
msdaps.dll
msdarem.dll
msdaremr.dll
msdasc.dll
msdasql.dll
msdasqlr.dll
msdatsrc.tlb
msdatt.dll
msdaurl.dll
msdfmap.dll
msjro.dll
msorcl32.dll
msxactps.dll
odbcbcp.dll
odbcconf.dll
odbcconf.exe
odbcconf.rsp
odbccp32.cpl
odbccp32.dll
odbccr32.dll
odbccu32.dll
oledb32.dll
oledb32r.dll
1. Log on to the computer using an ID with NT administrative
access. If you do not log on with administrative access, the
upgrade will fail.
2. Insert the RightFax server CD. If AutoRun is enabled, a menu of
install options appears. If AutoRun is not enabled, browse the
CD and run Setup.exe. The RightFax install wizard opens.
3. Click Next at the opening screen to view the RightFax license
agreement. You must accept the license agreement in order to
continue the installation. Click Next.
4. On the Advanced Options screen, you will be prompted to
enter configuration information based on your previous RightFax
installation. It is recommended that you do not change the
settings on this screen during an upgrade. Click Next.
Chapter 3 Installing the RightFax Server Software
17
RightFax 9.0 Installation Guide
5. On the Database Options screen, select the type of SQL
database you want use for RightFax:
11. If the command executed properly, a success message will
display.
Install an MSDE Database. Select this option if your do not
have or do not have access to an existing SQL database on
your network. RightFax will install a stripped-down version of
SQL sever.
12. Finally, all existing SecureDocs recipients will be prompted to
recreate their login information when accessing SecureDocs
documents on the SecureDocs Web site.
Use an Existing SQL Server. Select this option if you have a
SQL server already running on your network and want to
install the RightFax database schema directly to that server.
Upgrading the RightFax fax board drivers
Click Next. If you connect to an existing SQL database, a
screen will open prompting you for connection and login
information so the RightFax server can access the SQL
database. Complete the options on this dialog box according to
your existing SQL installation and then click Next.
6. Click Install to begin the installation.
7. When the software update is complete, click Finish.
If you have the RightFax SecureDocs Module installed and
running, you must complete an additional step to make sure that
your existing RightFax database is properly synchronized with
the new SQL database.
8. Open a command line prompt.
9. Change to the RightFax\WebApps\SecureDocs\Apps folder.
10. Run the following command:
synchdb RFServer 4 RightFax SQLLoginID Password
Where RFServer is the name of the RightFax server being
upgraded. SQLLoginID is the login ID used to access the SQL
database. This will be the DSN login ID if you are connecting to
an existing SQL server or “sa” if you installed the MSDE SQL
database. Password is the password for the SQL login you
specified. If you installed the MSDE database, the password is
blank which is indicated by two double quotes.
Examples synchdb RFServ 4 RightFax JaneDoe MyPassword
synchdb RFServ 4 RightFax sa ““
1. After the RightFax server has been upgraded, remain logged on
to the computer using an ID with NT administrative access.
2. Insert the RightFax hardware drivers CD. If AutoRun is enabled,
a menu of install options appears. If AutoRun is not enabled,
browse the CD and run Setup.exe. The RightFax install wizard
opens.
3. Click Next at the opening screen to view the RightFax license
agreement. You must accept the license agreement in order to
continue the installation. Click Next.
4. On the Fax Hardware Selection screen, select the type of fax
boards you have installed (Brooktrout and/or Dialogic). If you
select Dialogic, specify whether you have installed the
GammaLink CPI or Dialogic DM3 models. Click Next.
5. Click Install to begin the installation.
6. When the Transport Configuration screen opens, click OK to
keep your existing fax hardware configuration.
7. When all of the updated drivers have been installed, click Finish
to complete the RightFax Fax Board Driver install wizard.
18
Installation Overview
7. Test the fax boards (described in the RightFax Fax Board
Guide).
Important If you are installing RightFax in a Windows 2000 or 2003
cluster, refer to “Installing RightFax in a Windows 2000 or Windows 2003
Cluster” on page 57 for special instructions.
8. Set up users and other RightFax database objects using
Enterprise Fax Manager (described in the RightFax
Administrator’s Guide).
The RightFax server is the computer that runs the fax server
software. The server performs all the work required for sending and
receiving faxes, including managing the fax database, converting
documents into fax images, adding signatures, overlaying forms,
maintaining logs, printing faxes, and creating fax cover sheets.
To ensure that your RightFax server installation goes smoothly and
to avoid unnecessary delays, it is important to perform each step in
the installation completely and correctly before proceeding to the
next step.
A complete RightFax server installation is comprised of these major
tasks:
Installing the RightFax Server Software
1. Optionally install the fax boards into your RightFax server
chassis. If you will be using one or more remote BoardServer
computers to house the fax boards, you do not need to have fax
boards installed in the RightFax server computer. For more
information on using remote BoardServer computers, refer to
the RightFax Administrator’s Guide.
By the time you receive this software, new information or software
updates may be available. For the latest information on installing
RightFax servers, visit the RightFax support Web site at
www.captaris.com/customer_support. This site may provide
up-to-date information on installing and upgrading your RightFax
server.
Note This step does not include installing the fax board driver
software. The fax board drivers should be installed only after installing
the RightFax server software.
The RightFax server installation lets you create a new RightFax
database on an existing SQL server or install an MSDE 2000
Release A database directly on the RightFax server. MSDE does
not include any SQL management tools such as database backup
utilities. If you intend to install MSDE, provided with RightFax,
Captaris recommends that you purchase a separate SQL backup
utility and any additional SQL management tools you feel
necessary for proper management of your RightFax database.
2. Install the RightFax server software (see “Installing the RightFax
Server Software” on page 19).
3. Enable your licensed product feature set (see “Enabling Your
Licensed Product Feature Set” on page 22).
4. Install the fax board drivers (see “Installing the Fax Board
Drivers” on page 22).
5. Install the RightFax administrative utilities (see “Installing the
RightFax Administrative Utilities” on page 23).
6. Configure the RightFax Server, WorkServer, and Doc Transport
modules (described in the RightFax Administrator’s Guide).
Chapter 3 Installing the RightFax Server Software
19
RightFax 9.0 Installation Guide
When installing MSDE on a computer that is running Windows
2000 Server, the Microsoft Data Access Components (MDAC) are
automatically updated to MDAC 2.7 SP1a, unless a newer version
already exists on the server. These files are updated during a
MDAC 2.7 SP1a upgrade:
Table 3b Files updated during an MDAC upgrade
cliconfg.dll
cliconfg.exe
dbmsadsn.dll
dbmsrpcn.dll
dbnmpntw.dll
ds32gt.dll
instcat.sql
msadce.dll
msadcer.dll
msadcf.dll
msadcfr.dll
msadco.dll
msadcor.dll
msadcs.dll
msadds.dll
msaddsr.dll
msado15.dll
msadomd.dll
msador15.dll
msadox.dll
msadrh15.dll
msdadc.dll
msdaenum.dll
msdaer.dll
msdaora.dll
msdaosp.dll
msdaprsr.dll
msdaprst.dll
msdaps.dll
msdarem.dll
msdaremr.dll
msdasc.dll
msdasql.dll
msdasqlr.dll
msdatsrc.tlb
msdatt.dll
msdaurl.dll
msdfmap.dll
msjro.dll
msorcl32.dll
msxactps.dll
odbcbcp.dll
odbcconf.dll
odbcconf.exe
odbcconf.rsp
odbccp32.cpl
odbccp32.dll
odbccr32.dll
odbccu32.dll
oledb32.dll
oledb32r.dll
Warning If you will be installing the RightFax database to an existing
SQL server, the SQL server must be configured to use SQL mixed-mode
authentication. If the SQL server is set to use NT authentication only, the
database will not install properly. If your SQL server is configured to use
NT authentication, you must set it to use mixed-mode authentication
before installing RightFax. After the installation is complete, you can
re-set the SQL server for NT authentication. For instructions on
configuring RightFax to use NT authentication to the SQL server, refer to
the RightFax Administrator’s guide.
To install the RightFax server software
1. Log on to the computer using an ID with NT administrative
access. If you do not log on with administrative access, the
installation and configuration of RightFax will fail.
NoteIf you are installing on a Novell network, the SAP Agent,
NWLINK IPX/SPX, and Gateway for NetWare must be installed on
your RightFax server. File and Print services for NetWare should be
installed if you plan to connect DOS clients.
2. Insert the RightFax server CD. If AutoRun is enabled, a menu of
install options appears. If AutoRun is not enabled, browse the
CD and run Setup.exe. The RightFax install wizard opens.
3. Click Next at the opening screen to view the RightFax license
agreement. You must accept the license agreement in order to
continue the installation. Click Next.
4. Enter your name, organization name, and your product serial
number when prompted. Click Next.
5. On the Setup Type screen, select Typical Server to install the
RightFax server components, the Enterprise Fax Manager server
management tool, and FaxUtil, the RightFax fax mailbox. If you
want to install additional server and client components, select
Custom. Click Next.
6. On the Setup Features screen you can select any additional
server components you want to install. Some of these additional
components require separate licensing, and may need
20
additional configuration after the server is installed. For
information on which components you have licensed, refer to
the software product license card that was included with your
RightFax software package. When you have selected the
components to install, click Next.
7. On the Advanced Options screen, you will be prompted to
enter additional configuration information for the RightFax
installation. Disabled options are not required for the feature set
you selected.
SMTP Host. Enter the name of the SMTP server on your
network that will transport all SMTP alerts and notifications and
fax-over-IP messages. If you will not be using SMTP to deliver
RightFax alerts or send documents via fax-over-IP, you may
leave this option blank.
IIS User Account. If you have selected to install server
components that require IIS server, enter the IIS user account
that RightFax will use to access the IIS server.
RightFax Server Name. This option will only be available when
installing clients, services, and gateways on remote computers.
This tells the remote software where to locate the RightFax
server.
Certified Delivery Webserver. If you are installing the Certified
Delivery feature of the RightFax SecureDocs Module, enter the
name of the IIS server on which the Certified delivery Web site
will be located. Click Next.
8. On the Database Options screen, select the type of SQL
database you want use for RightFax:
Install an MSDE Database. Select this option if you do not
have access to an existing SQL database on your network.
RightFax will install a stripped-down version of SQL server.
Use an Existing SQL Server. Select this option if you have a
SQL server already running on your network and want to
install the RightFax database schema directly to that server.
Caution After it is installed, the RightFax SQL database is
permanently associated with the name of the RightFax server you are
installing. If for any reason you need to replace or rebuild this
RightFax server, the new server must have the exact same network
identification as the original.
Click Next. If you connect to an existing SQL database, a
screen will open prompting you for connection and login
information so the RightFax server can access the SQL
database. Complete the options on this dialog box according to
your existing SQL installation and then click Next.
9. Click Install to begin the installation.
10. When prompted, select the service account that the RightFax
services will use to start. This should be an account with
administrative privileges on the RightFax server. You can click
Load Users to list all the user accounts accessible to the server
computer and select the user account you want.
Note If you will be accessing files from or printing to Novell queues
on a NetWare volume, the service account must exist in Novell as an
account.
11. You will be prompted to add an e-mail gateway. E-mail gateways
let your organization’s fax users send and receive faxes through
their e-mail client applications. To add one or more e-mail
gateways, click Add Gateway and select the type of gateway to
add. When you add a new gateway, a configuration dialog box
opens. For information on completing the options in this dialog
box, refer to the RightFax Administrator’s Guide.
Chapter 3 Installing the RightFax Server Software
21
RightFax 9.0 Installation Guide
12. On new installations, the install wizard installs all of the selected
RightFax components, but does not fully enable the software.
The RightFax software must have its licensed feature set
enabled, which you can do either via the Web, or by contacting
the Captaris support department. For more information on
enabling the licensed feature set, see “Enabling Your Licensed
Product Feature Set” on page 22.
When the software installation is complete, click the Register
Online button to enable your licensed product feature set via
the Web. If you would prefer to contact the Captaris support
department to enable your licensed product feature set, click
Finish.
Enabling Your Licensed Product Feature Set
NoteIf you are upgrading an existing RightFax server, your existing
feature set will be retained and this step is unnecessary.
After you complete a new installation of RightFax, the server will be
licensed only for a limited feature set. To enable the full licensed
functionality of your RightFax server, you must register the software
with Captaris. At that time, you will be issued a “bump” code that
enables your full feature set. Captaris provides two methods for
registering your RightFax software.
Registering via the Web
On the last screen of the RightFax installation wizard is a Register
Online button. You can click this button to register your RightFax
software online during installation. Follow the instructions provided
on the Web page to complete the registration and enable the full
feature set of your RightFax server.
Registering through the Captaris support department
You can also register your RightFax server by contacting the
RightFax product support group at (520) 320-7070. The support
engineer will assist you through the registration process.
Installing the Fax Board Drivers
Regardless of the type of fax boards you use, you must run a
separate fax board hardware driver install program on all
computers containing the fax boards after installing the server. This
install program is provided with your RightFax server software on a
separate CD labeled “Fax Board Driver Install.”
Follow these steps to install the fax board hardware drivers. Be
sure to run this installation on all RightFax servers and remote
BoardServer machines after installing or upgrading the RightFax
server.
To install the fax board drivers
1. Insert the Fax Board Driver Install CD. If AutoRun is not
enabled, run Setup.exe. The RightFax Hardware Module install
wizard opens.
2. Click Next at the opening screen to view the RightFax license
agreement. You must accept the license agreement in order to
continue the installation.
3. On the Fax Hardware Selection screen, select the type of fax
boards you have installed (Brooktrout and/or Dialogic). If you
select Dialogic, specify whether you have installed the
GammaLink CPI or Dialogic DM3 models. Click Next.
4. Click Install to begin the installation.
22
5. When the files are installed, the Transport Configuration
dialog box opens. This is the configuration screen for the
RightFax DocTransport module which lets you configure the
methods by which RightFax will be able to transmit documents.
This module lets you configure fax boards for conventional fax
transmission, as well as set up RightFax for SMS messaging,
Fax-over-IP, DOCPlus, and some specific Intel and Eicon fax
boards. For information on properly completing the options in
the DocTransport module Transport Configuration dialog box,
refer to the RightFax Administrator’s Guide.
6. After you close the Transport Configuration dialog box, click
Finish to complete the RightFax Hardware Module install
wizard.
If you installed drivers for the Dialogic DM3 fax board series, a
separate Dialogic board configuration program will run. For
information on completing this configuration, refer to the
documentation included with your fax board or contact your
board manufacturer.
The following table lists each of the administrative utilities that are
installed in this procedure. For more information the RightFax
administrative utilities, refer to the RightFax Administrator’s Guide
Table 3c The RightFax Administrative Utilities
Utility
Description
ChgUser.exe
Changes RightFax privileges and options for all
users or groups of users at once.
DSender.exe
Uploads RightFax user IDs to the HP 9100C
Digital Sender so that RightFax can apply users’
specific fax transmission and notification options.
FaxAge.exe
Deletes faxes from RightFax users’ mailboxes at
scheduled interval.
FaxDump.exe
Outputs fax data in text format for import into
other databases.
Fax Reporter
Organizes and presents data from your RightFax
database for reporting and billing purposes.
7. When prompted to restart the computer, select Yes.
The Fax Reporter installation includes
components of Crystal Reports 8.0. If you have
installed other software that uses a different
version of this software, a conflict may occur.
Installing the RightFax Administrative Utilities
The RightFax server includes several administrative utilities that are
installed separately from the RightFax server. It is strongly
recommended that you install the administrative utilities on the
RightFax server immediately after installing the server software. The
administrative utilities are installed in the RightFax\AdmUtils folder
on the RightFax server.
FaxStat.exe
Remotely monitors any RightFax server on the
network.
ImpUser.exe
Imports users from a comma-delimited ASCII file.
ModUser.exe
Changes user settings for multiple RightFax
users.
ODBCSync.exe Imports user, printer, and billing code information
from an ODBC source.
Perl
The Perl scripting language for use with the
RightFax Integration Module.
PhnPrint.exe
Prints the published and private phonebook
entries of one or more RightFax users.
Chapter 3 Installing the RightFax Server Software
23
RightFax 9.0 Installation Guide
Table 3c The RightFax Administrative Utilities (Continued)
Utility
Description
RFDiag.exe
Displays diagnostic information about the
RightFax server.
ServSync.exe
Compares database objects on two RightFax
servers.
To install the RightFax administrative utilities
1. Insert the RightFax server CD. If AutoRun is enabled, a menu of
install options will appear. Click Exit.
2. Browse the CD and run Support\Admin Utilities\Setup.exe. The
RightFax Admin Utilities install wizard opens.
3. Click Next at the opening screen to open the RightFax license
agreement. You must accept the license agreement in order to
continue the installation.
4. Enter your name and company name when prompted. Click
Next.
5. Select Complete or Custom install. If you select Complete, all
of the administrative utilities will be installed except Perl. To
install Perl or to install only selected administrative utilities,
select Custom.
If you select the custom install, a message will appear asking
you to specify the applications you want. When you have
specified the administrative utilities to install, click Next.
Note The custom install option also lets you change the destination
folder for the administrative utilities files. Because the Crystal Reports
components of the Fax Reporter utility must be installed on the same
drive as Microsoft Windows, it is recommended that you do not
change the default destination drive.
6. Click Install. The Setup program will install the specified utilities
on the RightFax server. When the files have all been installed,
click Finish to complete the installation.
Installing the RightFax Web Applications
RightFax includes these Web-based applications that can be
installed on servers running Microsoft IIS version 5.0 or higher:
Enterprise Fax Manager Web Edition (also requires .NET
Framework 1.1 or greater)
RightFax Web Access (also requires .NET Framework 1.1 or
greater)
RightFax Certified Delivery
These IIS applications should not be installed on the same
computer as the RightFax server software, even if IIS is installed on
the RightFax server. Captaris recommends that all IIS applications
be installed on a dedicated IIS server, separate from the RightFax
server.
Tip Servers running Microsoft Windows 2003 do not have IIS installed
by default. On Windows 2003, IIS 6.0 must be selected as an optional
component during the operating system installation
To install one or more of these applications, run the server
installation (described on page 19) and select the applications to
install under the “IIS” heading in the Setup Features screen.
If you are installing any of these applications on a server running IIS
version 6.0, you must change some of the default settings in the IIS
configuration. These changes can be made either before or after
24
you install the RightFax client applications, but they must be
completed before these applications will work on computers
running IIS 6.0:
For Windows 2000 Server and Windows 2003 Server, you must
register ASP.NET as a Web Service Extension. To do this, click
Start > Run, then type cmd. Enter the following at the command
prompt, and press ENTER:
C:\Windows\Microsoft.NET\Framework\v1.*\aspnet_regiis -i
where v1.* is the most recent version of .NET Framework on your
server.
In Internet Information Services Manager, Active Server Pages,
ASP.NET, and ISAPI Extensions must be enabled. These
features are enabled from the Web Service Extensions folder.
Parent Paths must be enabled, either for the Default Web Site as
a whole, or for the SecureDocs virtual directory which appears
after the installation of Certified Delivery. Edit the properties of
either of these sites and select the Directory tab. Click
Configuration, open the Options tab, and select Enable Parent
Paths.
Configuring SQL Server for RightFax Web Access
If you install SQL Server using Windows Authentication mode and
plan to use RightFax Web Access, then you must configure
specific RightFax services to run as a Domain Administrator, and
then edit a configuration file so that users are able to login.
To configure RightFax services
1. Choose Start > Settings > Control Panel, then double-click
Administrative Tools.
2. Double-click Services.
3. Right-click RightFax DocTransport Module and choose
Properties.
4. Display the Log On tab, then select This account. Enter the
credentials of a user with Domain Administrator rights.
5. Click OK.
6. Repeat this procedure for these services:
RightFax Database Module
RightFax Server Module
RightFax Remoting
To configure SQL Server for RightFax Web Access
1. Navigate to ..\RightFax\Bin and open
Captaris.RightFax.RemotingService.exe.config in a text editor.
2. Edit Captaris.RightFax.RemotingService.exe as follows:
Locate the add key element and clear the data associated
with the User Id and Password entries.
Edit the data source entry to reflect the name of your SQL
server.
Add "Integrated Security=SSPI;Persist Security Info=True;"
to the beginning of the value for the SqlConnectionString.
For example:
<appsettings>
<add key=”Integrated Security=SSPI;Persist Security
Info=True;SqlConnectionString” value=”user id=;data
source=MySqlServer;initial catalog=RightFax;password=”/>
</appsettings>
3. Reset your IIS server.
For a description of Enterprise Fax Manager Web Edition, refer to
the RightFax Administrator’s Guide. For a description of RightFax
Web Access, refer to the RightFax Web Access Online Help. For a
description of the Certified Delivery Web site refer to the RightFax
SecureDocs Module Guide.
Chapter 3 Installing the RightFax Server Software
25
RightFax 9.0 Installation Guide
Repairing the RightFax Server Installation
The RightFax Repair installation replaces missing or corrupted
RightFax program files or Windows Registry settings, and retains
your fax database and configuration settings.
To repair an installation
1. Insert the RightFax server CD. If AutoRun is enabled, a menu of
install options appears. If AutoRun is not enabled, browse the
CD and run AutoRun.exe.
2. In the menu of install options, select the option to install the
RightFax server. The RightFax install wizard opens.
3. Click Next at the opening screen, select the Repair option, and
then click Next.
To uninstall the RightFax server
WarningWhen you uninstall the RightFax server, all RightFax program
files, Windows Registry settings, and shortcuts are removed. In addition,
all of your RightFax configuration settings are removed as well as the fax
database. Captaris recommends that you back up the contents of the
entire RightFax folder before uninstalling the software. For information on
creating a backup of the RightFax server, refer to the RightFax
Administrator’s Guide.
1. Insert the RightFax server CD. If AutoRun is enabled, a menu of
install options appears. If AutoRun is not enabled, browse the
CD and run AutoRun.exe.
2. In the menu of install options, select the option to install the
RightFax server. The RightFax install wizard opens.
4. Click Install to begin the Repair installation.
3. Click Next at the opening screen, select the Remove option,
and then click Next.
5. When the Repair installation is complete, click Finish.
4. Click Remove to uninstall the RightFax server.
5. When the uninstall process is complete, click Finish.
Uninstalling the RightFax Server
To ensure that all RightFax components are completely uninstalled,
you must remove all separately installed RightFax components (the
fax hardware drivers, administrative utilities, AutoReply, etc.) before
uninstalling the RightFax server. These components can be
uninstalled from Add/Remove Programs in Windows Control
Panel.
Note The RightFax installation will use the first compatible printer driver
it finds to create the HPFAX printer. If no compatible driver is found,
RightFax will install one automatically. If this occurs, this driver and its
associated files will not be removed if RightFax is uninstalled. In a
Microsoft Windows 2000 and 2003 installation, the printer driver files
reside at ..Windows\System32\Spool\Drivers\W32X86\3 and include
the following:
HPLJ5.BUD
HPLJ5.GPD
PCL5ERES.DLL
STDNAMES.GPD
TTFSUB.GPD
UNIDRV.DLL
UNIDRV.HLP
UNIDRVUI.DLL
UNIRES.DLL
26
Using Enterprise Fax Manager
With the Enterprise Fax Manager program, an administrator can
manage users, groups, signatures, forms, printers, billing codes,
library documents, and more, for all RightFax servers from one
application.
Enterprise Fax Manager (EFM) is a client application that can be
run from any Windows 2000 or Windows 2003 computer, and it is
installed on the RightFax server computer when you run the server
installation.
The right pane displays details of the selected fax server or
component. Items listed on the right, such as individual users or
library documents, are referred to as database objects. Database
objects can be added, deleted, and modified according your
needs.
Figure 3.1 The Enterprise Fax Manager Window
Running the Enterprise Fax Manager program
After the RightFax server software has been installed, run
Enterprise Fax Manager from the Programs list in the Start menu.
When you run Enterprise Fax Manager for the first time, it will try to
log on under your network user ID. If you did not log on to the
network as “Administrator” a Login dialog box will appear. Enter a
user ID and password with RightFax administrative access.
Important When the RightFax server software is installed, a RightFax
user account is created called “administrator” with a blank password. Use
this account to open Enterprise Fax Manager for the first time. Once you
are running Enterprise Fax Manager, you can create a new administrative
account with password protection.
For more information on configuring fax servers and database
objects using Enterprise Fax Manager, refer to the RightFax
Administrator’s Guide.
The Enterprise Fax Manager window
Enterprise Fax Manager displays data and statistics about RightFax
servers and the components of each server such as users and
groups. In the left pane of the window is a tree structure that
displays each of the fax servers on your network and each fax
server’s components. To appear in this list, a RightFax server must
be opened. To open a RightFax server on your network, select
File > Open and enter the name of the server when prompted.
Chapter 3 Installing the RightFax Server Software
27
RightFax 9.0 Installation Guide
Running Silent Installs of the Server
and Fax Board Drivers
Both the RightFax server and Fax Board Driver installation
programs uses Microsoft Windows Installer (Msiexec.exe), which is
an executable program that interprets packages and installs
products. Msiexec.exe enables you to install or upgrade the
RightFax server silently (without user interaction or prompts). A
silent installation can be used for a large-scale enterprise
deployment to multiple RightFax servers.
Table 3d Command Line Options for Microsoft Windows Installer (Continued)
Property
Parameters
Description
/l
[i|w|e|a|r|u|c|m|o|p|v
|+|!]Logfile
Specifies the path to a log file. Use the
following flags to indicate the information
to log:
i - Status messages
w - Nonfatal warnings
e - All error messages
a - Startup of actions
The installation program is not designed to run on a remote
computer. To use it to install on a remote computer, a third-party
application such as SMS is required.
r - Action-specific records
The following table describes some of the Msiexec.exe installation
command line options you can use. For more detailed information
and additional options, please refer to Microsoft documentation for
Msiexec.exe.
m - Out-of-memory or fatal exit
information
u - User requests
c - Initial UI parameters
o - Out-of-disk-space messages
p - Terminal properties
Table 3d Command Line Options for Microsoft Windows Installer
v - Verbose output
Property
Parameters
Description
+ - Append to existing file
/i
path/filename
Installs or configures a product from a
specified path and filename.
Use the format: /i path\filename
! - Flush each line to the log
“*” - Wildcard; log all information except
the v option. To include the v option,
specify “/l*v”.
28
Table 3d Command Line Options for Microsoft Windows Installer (Continued)
Table 3d Command Line Options for Microsoft Windows Installer (Continued)
Property
Parameters
Description
Property
Parameters
Description
/q
n|b|r|f
Sets the user interface level.
reboot
Force|Suppress
|ReallySuppress
Force - Always prompts for a reboot at
the end of the installation. The setup
program will prompt the user with an
option to reboot at the end. If there is no
user interface, the system automatically
reboots at the end of the installation.
n - Setup does not prompt the user for
information. It does not display progress
indicators as it installs, and it does not
display a completion message at the end
of the installation.
b - Setup does not prompt the user for
information, but it does display progress
indicators and a completion message at
the end of the installation.
r - Setup does not prompt the user for
information. It does display progress
indicators as it installs, but it does not
display a completion message at the end
of the installation.
f - Setup prompts the user for
information, and it does display progress
indicators and a completion message at
the end of the installation.
Suppress - Suppresses prompts for a
reboot at the end of the installation. The
setup program will prompt the user with
an option to reboot during the installation
if it detects that a reboot is required to
complete the installation. If there is no
user interface, the system automatically
reboots if one is required to complete the
installation. Reboots at the end of the
installation. For example, reboots that are
caused by an attempt to install a file in
use are suppressed.
ReallySuppress - Suppresses all reboots
and reboot prompts if the setup program
detects that a reboot is required to
complete the installation. Suppresses all
reboots and reboot prompts at the end of
the installation. Both the reboot prompt
and the reboot itself are suppressed. For
example, reboots at the end of the
installation that are caused by an attempt
to install a file in use are suppressed.
To obtain information about installation errors, you must generate a
log file with the /L option. Problems with the installation or
configuration are preceded by “Error” in the log.
Chapter 3 Installing the RightFax Server Software
29
RightFax 9.0 Installation Guide
As part of the silent installation, you must install Microsoft
Windows Installer, version 2.0 or later. This program is included on
the root of the RightFax server CD and is called Instmsiw.exe.
Table 3e RightFax Advanced Command Line Options (Continued)
Property
Parameters
Description
RFLANGUAGE
<language>
Specify what language the RightFax
clients will use. This is set to English
by default.
RFSERVERNAME
<servername> Specify the RightFax server the
clients, IIS, or remote services will
connect to. For clients, this sets the
server the client will open when first
installed. For IIS and remote services
it is used to specify the server to
connect to for configuration info or
settings.
Running a silent install of the RightFax server software
There are also several advanced RightFax command line options
you can set, described in the following table. The command line
format for these options is option=“value”
The silent install for RightFax does not support installing a separate
MSDE SQL database on the RightFax server. The silent installation
option can only be used when connecting to an existing SQL
server.
Table 3e RightFax Advanced Command Line Options
Property
Parameters
Description
INSTALLLEVEL
1|2|3
Controls what features are visible to
the user.
1 = Clients with no EFM
2 = Clients with EFM
3 = All features available
IS_SQLSERVER_
DATABASE
<database>
The name of the database to create
on the SQL server. Default is
RightFax.
IS_SQLSERVER_
PASSWORD
<password>
Password used to log on to the SQL
server if SQL authentication is used.
IS_SQLSERVER_
SERVER
<server>
The name of the SQL server to
connect to.
IS_SQLSERVER_
USERNAME
<user>
User name used to log on to the SQL
server if SQL authentication is used.
The install properties text file
You must specify RightFax server installation properties and
installed components in a file called ServerProperties.txt. A sample
properties text file is included on the RightFax server CD.
Unspecified properties use the default values. The RightFax server
properties are listed in “Table 3f: RightFax Server Installation
Properties” on page 31.
For a new server installation, the ServerProperties.txt file must
contain these settings:
INSTALL_SERVER = TRUE
RFLANGUAGE = English
SMTPHOST = <ServerName>
SERIALNUM = <SerialNumber>
WORKSRV_USERID = <Domain\UserName>
WORKSRV_PASSWORD = <Password>
INSTALLDIR = C:\Program Files\RightFax\
ALLUSERS = 1
IS_SQLSERVER_SERVER = <Server>
IS_SQLSERVER_USERNAME = <User>
30
IS_SQLSERVER_PASSWORD = <Password>
For a server upgrade, the ServerProperties.txt file must contain
these settings:
INSTALL_SERVER = TRUE
RFLANGUAGE = English
ALLUSERS = 1
Caution The RightFax silent install performs no error checking. If you
attempt to install components for which the server does not meet the
minimum requirements, the silent install will fail.
Table 3f RightFax Server Installation Properties
Property
Value
Description
SMTPHOST
<servername>
Specify the name of the SMTP server on the network through which fax documents that are addressed to
e-mail recipients will be sent.
INSTALLDIR
<install path>
Specify the path and the folder on the server where the RightFax software will be installed.
Default: c:\program
files\rightfax\
The value must end with a backslash (\).
<serial number>
Specify the product serial number.
SERIALNUM
This property is required for new installations.
If you are upgrading from an earlier version, this property is not required. You must delete this line or comment
it from the properties text file so that it is not read by the installation program. If you keep this property in the
properties text file without specifying the product serial number, then the serial number that is stored on your
RightFax server will be deleted.
WORKSRV_
PASSWORD
<password>
This property is required for new installations. If you are upgrading from an earlier version, this property is not
required.
Specify the password for the service account that the RightFax services will use to start. This should be an
account with administrative privileges on the RightFax server.
The password is case-sensitive.
WORKSRV_USERID
<domain\userID>
This property is required for new installations. If you are upgrading from an earlier version, this property is not
required.
Specify the domain or workgroup and user ID for the service account that the RightFax services will use to
start. This should be an account with administrative privileges on the RightFax server.
Use the format domain\userID.
RFSERVERNAME
<server>
Specify the RightFax server the modules of the install will communicate with. This property is required for all
subfeatures except the server.
Chapter 3 Installing the RightFax Server Software
31
RightFax 9.0 Installation Guide
Table 3f RightFax Server Installation Properties (Continued)
Property
Value
Description
IUSRACCOUNT
<userID>
Specify the anonymous IIS user account to use for IIS features.
ALLUSERS
1 or 0
Specify “1” to install for all users on the system, “0” to have it install for only the current user. This value must
be set to 1 for a server install.
NUMREMOTEWORK
SERVERS
<number>
Specify the number of remote WorkServers to install on the remote machine. This number must not push the
total number of WorkServers above 16.
INOUTDIR
<path\folder>
Specify the directory to put the In/Out directories into for the Exchange 2000 Connector feature.
INSTALL_SERVER
TRUE
Set to “TRUE” to install the RightFax Server feature.
INSTALL_EFM
TRUE
Set to “TRUE” to install the Enterprise Fax Manager feature.
INSTALL_FAXCTRL
TRUE
Set to “TRUE” to install the RightFax Print Driver feature.
INSTALL_FAXUTIL
TRUE
Set to “TRUE” to install the FaxUtil feature.
INSTALL_OUTLOOK
TRUE
Set to “TRUE” to install the RightFax Outlook Client feature.
INSTALL_MAPI
PRINTER
TRUE
Set to “TRUE” to install the MAPI Print Driver feature.
INSTALL_VIMPRINTER
TRUE
Set to “TRUE” to install the VIM Print Driver feature.
INSTALL_AUTOREPLY
CLIENT
TRUE
Set to “TRUE” to install the AutoReply Client feature.
INSTALL_INTERACTION
TRUE
Set to “TRUE” to install the Interaction Client feature.
INSTALL_PAPERPORT
TRUE
Set to “TRUE” to install the Paperport Client feature.
INSTALL_WEBEFM
TRUE
Set to “TRUE” to install Enterprise Fax Manager.
INSTALL_WEBCLIENT
TRUE
Set to “TRUE” to install the Web Client feature.
INSTALL_CERTIFIED
DELIVERY
TRUE
Set to “TRUE” to install the Certified Delivery feature.
INSTALL_EXCH2K
CLIENT
TRUE
Set to “TRUE” to install the Exchange 2000 MMC Client feature.
INSTALL_EXCH2K
CONNECTOR
TRUE
Set to “TRUE” to install the Exchange 2000 Connector feature.
32
Table 3f RightFax Server Installation Properties (Continued)
Property
Value
Description
INSTALL_REMOTE
ALERTING
TRUE
Set to “TRUE” to install the Remote Alerting and Monitoring feature.
INSTALL_REMOTE
WORKSERVER
TRUE
Set to “TRUE” to install the Remote WorkServer feature.
INSTALL_REMOTE
BOARDSERVER
TRUE
Set to “TRUE” to install the Remote Boardserver feature.
INSTALL_JAVAXML
TRUE
Set to “TRUE” to install the Java/XML feature.
Chapter 3 Installing the RightFax Server Software
33
RightFax 9.0 Installation Guide
The following is an example of a batch file that silently installs
Microsoft Windows Installer and the RightFax server. It generates
the log file named “RightFax Server.log”:
@echo installing msiwi
@time /T
D:\instmsiw.exe /Q
@time /T
@echo calling silent install
@time /T
msiexec PROPERTIESFILE=“%temp%\ServerProperties.txt” /i
“D:\RightFax Product Suite.msi” /q /l*v “%temp%\RightFax
Server.log”
@time /T
After the silent installation, additional configuration of the server
may be needed. Refer to the RightFax Administrator’s Guide for
instructions on configuring the server.
Running a silent install of the fax board drivers
You must specify fax board driver installation properties at the
command line or in a properties text file. An example properties text
file called HardwareProperties.txt is included on the root of the
RightFax server CD. The fax board driver properties are listed in the
following table.
Table 3g Fax Board Driver Installation Properties
Property
Value Description
BOARD_BROOK
TRUE Install Brooktrout fax board drivers.
You can specify both Brooktrout and
Intel Dialogic fax board drivers in the
command.
BOARD_DIALOGIC TRUE Install Intel Dialogic fax board
drivers.
You can specify both Brooktrout and
Intel Dialogic fax board drivers in the
command.
GAMMATYPE
CPI
DM3
If Dialogic, you must specify CPI or
DM3 fax board drivers.
34
Following is an example of a batch file that silently installs Microsoft
Windows Installer and the RightFax fax board drivers. It generates
the log file named “RightFax Hardware.log”:
@echo installing msiwi
@time /T
D:\instmsiw.exe /Q
@time /T
@echo calling silent hardware install
@time /T
msiexec PROPERTIESFILE=“%temp%\HardwareProperties.txt” /i
“D:\RightFax Fax Board Driver.msi” /q /l*v “%temp%\RightFax
Hardware.log”
@time /T
After the silent installation, additional configuration of the fax
boards may be needed. To configure the boards after installation
using the BoardServer configuration program, refer to the RightFax
Administrator’s Guide.
Chapter 3 Installing the RightFax Server Software
35
RightFax 9.0 Installation Guide
36
Chapter 4
Installing the RightFax Client Applications
The RightFax software includes the following client applications
that let RightFax users send and receive faxes via the RightFax
server and also let administrators manage RightFax servers from
remote computers:
“Enterprise Fax Manager” (page 37)
“RightFax Print Driver” (page 38)
“FaxUtil” (page 38)
“Outlook Advanced Fax Extensions” (page 38)
“MAPI Print Driver” (page 38)
“VIM Print Driver” (page 38)
“AutoReply Client” (page 38)
These client applications can be installed in the following
languages:
English
French
French-Canadian
German
Italian
Portuguese
Spanish
Document Version xx-xxxx October 21, 2004
Before installing the RightFax client applications to your users’
computers, you should identify which applications are appropriate
for each user and then install only those applications.
Enterprise Fax Manager
Enterprise Fax Manager is a Windows-based application that
provides RightFax administrators access to all RightFax servers on
the network. Enterprise Fax Manager lets administrators manage all
aspects of the RightFax server including managing users and other
database objects, starting and stopping RightFax services, and
monitoring server statistics. This application should be installed on
all computers from which RightFax administrators will be managing
the servers. For information about running Enterprise Fax Manager,
refer to the RightFax Administrator’s Guide.
A Web-based version of Enterprise Fax Manager (Enterprise Fax
Manager Web Edition) can be installed on a Microsoft IIS server on
your network. This version of Enterprise Fax Manager provides all
the same functionality as the Windows version, but is accessible
both locally and remotely via the Web using any Web browser. This
version of Enterprise Fax Manager is not installed as a client
application. For information on installing Enterprise Fax Manager
Web Edition, see “Installing the RightFax Web Applications” on
page 24.
37
RightFax 9.0 Installation Guide
RightFax Print Driver
The RightFax Print Driver lets users fax documents directly from the
applications used to create them (such as Microsoft Word.) The
print driver also installs a RightFax tray icon in the Windows
taskbar that lets users configure fax options, run fax client
applications, send faxes, and set the default printer. This
application should be installed on all computers from which
RightFax users will be sending and receiving faxes.
FaxUtil
FaxUtil is a Windows-based fax mailbox tool that lets users send,
receive, view, edit, and manage faxes. This application should be
installed on all computers from which RightFax users will be
sending and receiving faxes, unless you will be installing alternative
client applications such as the RightFax Web Client, the Client for
Microsoft Outlook (described in the RightFax Gateway for
Microsoft Exchange Guide), or the Lotus Notes Client (described
in the RightFax Gateway for Lotus Notes Guide). For information
about running FaxUtil, refer to the FaxUtil online help which is
installed with FaxUtil.
A Web-based version of FaxUtil (The RightFax Web Client) can be
installed on a Microsoft IIS server on your network. This version of
FaxUtil provides all the same functionality as the Windows version,
but is accessible both locally and remotely via the Web using any
Web browser. This RightFax mailbox tool is not installed as a client
application. For information on installing the RightFax Web Client,
see “Installing the RightFax Web Applications” on page 24.
MAPI Print Driver
The RightFax MAPI (Messaging Application Programming
Interface) Print Driver lets fax users send fax images as e-mail
attachments using MAPI-compliant applications such as Microsoft
Outlook, Microsoft Mail, and Novell Groupwise. When the user
prints a document using this print driver, a MAPI-compliant e-mail
application window opens with the document attached as a TIFF
file. The e-mail message can then be addressed and sent. This
application should be installed on all computers to which you want
to provide this functionality. Before installing this application, make
sure that a PCL print driver is installed on the client’s computer.
Note When faxing from Excel 97 with the MAPI print driver, in the Excel
Page Setup settings, set the print quality to 200 dots-per-inch (DPI) to
obtain the correct TIFF image quality.
VIM Print Driver
The RightFax VIM (Vendor Independent Messaging) Print Driver
lets fax users send fax images as e-mail attachments using
VIM-compliant applications such as Lotus Notes and Lotus cc:Mail.
When the user prints a document using this print driver, a
VIM-compliant e-mail application window opens with the document
attached as a TIFF file. The e-mail message can then be addressed
and sent. This application should be installed on all computers to
which you want to provide this functionality. Before installing this
application, make sure that a PCL print driver is installed on the
client’s computer.
AutoReply Client
Outlook Advanced Fax Extensions
The Outlook Advanced Fax Extensions enable advanced fax
functionality in your users’ Outlook mailboxes. This application
should be installed on computers running Microsoft Outlook only if
you will be installing the RightFax Gateway for Microsoft Exchange.
For information about using the Advanced Fax Extensions, refer to
the RightFax Gateway for Microsoft Exchange Guide.
The AutoReply service monitors one or more RightFax mailboxes
for inbound faxes and automatically faxes a response to the sender
based on each sender's caller service identification (CSID)
number. The AutoReply Client lets administrators configure the
AutoReply service from any computer on the network This
application should be installed on all computers from which
38
RightFax administrators will be managing the AutoReply service.
For information about AutoReply, refer to the RightFax
Administrator’s Guide.
Minimum hardware requirements for Microsoft Windows
2000 Professional
Computer/Processor 133 MHz or higher Pentium-compatible CPU
RightFax Client Computer Requirements
RightFax client applications for this version can be installed only on
computers running the following operating systems:
Memory
64 MB RAM
Hard drive
2 GB with 650 MB free space
CPU support
Up to two CPUs per computer
Microsoft Windows XP Professional, SP1A
Drive
CD-ROM or DVD drive
Microsoft Windows 2000 Professional, SP4
Display
VGA monitor running at a resolution of 800 ×
600 or higher
Keyboard/Mouse
Required
The minimum hardware requirements for the client computer vary
depending on the operating system you are running.
Minimum hardware requirements for Microsoft Windows
XP Professional
Computer/Processor 233 MHz or higher Pentium-compatible CPU
(300 MHz recommended)
Memory
64 MB RAM (128 MB recommended)
Hard drive
1.5 GB
CPU support
Up to two CPUs per computer
Drive
CD-ROM or DVD drive
Display
VGA monitor running at a resolution of 800 ×
600 or higher
Keyboard/Mouse
Required
Upgrading the RightFax Client Applications
Because newer versions of the RightFax client applications may not
be compatible with older versions of the RightFax server, all of the
RightFax servers on your network that will be accessed by fax users
should be upgraded before upgrading the client applications.
To upgrade existing client applications, complete the steps for
client installation (page 41).
Warning In FaxUtil versions 8.0 and later, users can create nested
folders, which is not supported in earlier versions. In an environment
where users can switch between FaxUtil version 8.0 (or later) and earlier
versions, any folders created in the later version of FaxUtil won’t appear
in earlier versions of the client. Similarly, folders created in earlier
versions of FaxUtil will not appear in FaxUtil 8.0. However, folders
created in earlier versions of FaxUtil will appear in FaxUtil versions 8.5
and later in the All folder.
Chapter 4 Installing the RightFax Client Applications
39
RightFax 9.0 Installation Guide
Before You Begin
By default, the RightFax client installation will use the first
compatible printer driver it finds to create the RightFax Print Driver.
If no compatible printer driver is found, RightFax will install one
automatically.
Note If RightFax installs a printer driver automatically, this driver and its
associated files will not be removed if RightFax is uninstalled. In a
Microsoft Windows 2000 and XP Professional installation, the printer
driver files reside at ..Windows\System32\Spool\Drivers\W32X86\3 and
include the following:
HPLJ5.BUD
HPLJ5.GPD
PCL5ERES.DLL
STDNAMES.GPD
TTFSUB.GPD
UNIDRV.DLL
UNIDRV.HLP
UNIDRVUI.DLL
UNIRES.DLL
You can force the client installation to use a specific printer driver
(if installed on the client computer) by modifying the file Setup.ini in
the folder that contains the Setup.exe file (described in the next
section). To specify a printer driver, edit the file Setup.ini with any
text editor. Add a new section entitled [CmdLine]. Add a property
to this section called PreferredDriver and set it to one of the
following values.
Value
Print driver
-1
Select automatically (default)
0
PCL-5
1
PCL-5E
2
Adobe PostScript
For example, to force the RightFax Print Driver installation to use
the Adobe PostScript print driver, add the following section to the
Setup.ini file:
[CmdLine]
PreferredDriver=2
In addition to requiring one of these printer drivers, all RightFax
client computers must have network access to the HPFAX print
queue on the RightFax server.
Decreasing FaxUtil load time
The time required for each user to load the FaxUtil client application
depends largely on the number of RightFax users configured on the
RightFax server that FaxUtil is accessing. If the RightFax server
contains a large number of users, FaxUtil may be noticeably slow to
load.
If the number of users configured on the RightFax server results in
slow FaxUtil load times, you can create a registry entry on client
computers that disables the automatic loading of users when
FaxUtil is run. The loading of user records will occur only if a user
performs actions in FaxUtil that require it.
You can disable the loading of two types of user: administered
users and unprotected users.
Administered users are users that appear in a RightFax
administrator’s or group administrator’s FaxUtil mailbox.
Unprotected users are users who have the Unprotected mailbox
permission set in their user profiles. These users appear in all
other FaxUtil user lists as though they had delegated everyone
else to allow them to access their fax mailboxes.
For RightFax administrators, disabling the loading of both
administered and unprotected may be necessary. For all other
FaxUtil users, it is only necessary to disable the loading of
unprotected users.
40
To disable the loading of administered users
To disable the loading of administered users in FaxUtil on startup,
close FaxUtil and then add a REG_DWORD value called
LoadAdministeredUsers to HKEY_CURRENT_USER\
Software\RightFAX Client\FUW32 and set the value data to 0
(zero).
To disable the loading of unprotected users
To disable the loading of unprotected users in FaxUtil on startup,
close FaxUtil and then add a REG_DWORD value called
LoadUnprotectedUsers to HKEY_CURRENT_USER\Software
\RightFAX Client\FUW32 and set the value data to 0 (zero).
To automatically disable user loading for new FaxUtil users
These REG_DWORD values can also be applied for all new
FaxUtil users on a particular computer. Modify the Windows
Registry to add the REG_DWORD values described above to
HKEY_LOCAL_MACHINE\Software\RightFAX Client\FUW32.
When users run FaxUtil for the first time, they will be automatically
configured to disable the loading of users.
RightFax Client Installation Methods
The RightFax client applications can be installed using any of the
following methods:
“Installing the Client Applications from the RightFax CD”
(page 41)
“Installing the Client Applications from a Network File
Share”(page 42)
“Creating an Automated Client Install” (page 43)
Installing the Client Applications
from the RightFax CD
Follow these steps to install the client applications directly from the
RightFax software CD. This method is recommended only if you
have a small number of RightFax client installations.
To install the RightFax client applications from the CD
1. Log on to the client computer and insert the RightFax server
CD. If AutoRun is enabled, a menu of install options appears. If
AutoRun is not enabled, browse the CD and run AutoRun.exe.
2. In the menu of install options, select the option to install the
RightFax product suite. The RightFax install wizard opens.
3. Click Next at the opening screen to view the RightFax license
agreement. You must accept the license agreement in order to
continue the installation. Click Next.
4. Enter your name, organization name, and your product serial
number when prompted. Click Next.
5. On the Setup Type screen, select Typical Client and then click
Next.
6. On the Custom Setup screen you can remove or select
additional client applications you want to install. Enterprise Fax
Manager, FaxUtil, the RightFax print driver, and the Microsoft
Outlook fax extension (for creating and sending faxes directly
from Microsoft Outlook) are already selected. When you have
selected the components to install, click Next.
Chapter 4 Installing the RightFax Client Applications
41
RightFax 9.0 Installation Guide
7. On the Advanced Options screen, you will be prompted to
enter additional configuration information for the RightFax client
installation. Disabled options are not required for the feature set
you selected.
RightFax Server Name. This option tells the client software
where to locate the RightFax server by default. You can also
change or add RightFax servers to connect to within each client
application.
Language. Select the language to use for the client
applications that will be installed. This option will be set to the
operating system’s default language setting. To change the
language setting, select the desired language from the list.
Click Next.
8. Click Install to begin the installation.
Installing the Client Applications
from a Network File Share
You can install the RightFax client applications using a special
client-only install that you place on a network file share. This
installation is identical to client installation on the RightFax CD,
except that only the client applications can be installed. First the
client-only installation is placed on a network file share, and then
the RightFax client applications can be installed from there.
To copy the client-only install files to a network file share
1. Log on to the file server computer and insert the RightFax server
CD. If AutoRun is enabled, a menu of install options appears. If
AutoRun is not enabled, browse the CD and run AutoRun.exe.
2. In the menu of install options, select the option to install the
RightFax product suite. The RightFax install wizard opens.
3. Click Next at the opening screen to view the RightFax license
agreement. You must accept the license agreement in order to
continue the installation. Click Next.
4. Enter your name, organization name, and your product serial
number when prompted. Click Next.
5. On the Setup Type screen, select Copy Client Install Files
and then click Next.
6. On the Copy Install Source Files screen, you will be prompted
to enter a RightFax server name. Enter the name of the RightFax
server that you want installed clients to connect to by default.
Click Next.
7. Click Copy to begin the installation.
8. When the installation is complete, the client install files will be
copied to the C:\RightFax Clients folder. Create a share of this
folder that can be accessed by all users who will be running the
client installation.
To install the RightFax client applications from the
network file share
1. Log on to the client computer and browse to the shared folder
on your network that contains the RightFax client install and run
setup.exe. The RightFax install wizard opens.
2. Click Next at the opening screen to view the RightFax license
agreement. You must accept the license agreement in order to
continue the installation. Click Next.
3. Enter your name and organization name when prompted. Click
Next.
4. On the Setup Type screen, select Typical Client and then click
Next.
42
5. On the Custom Setup screen you can remove or select
additional client applications you want to install. FaxUtil, the
RightFax print driver, and the Microsoft Outlook fax extension
(for creating and sending faxes directly from Microsoft Outlook)
are already selected. When you have selected the components
to install, click Next.
6. On the Advanced Options screen, you will be prompted to
enter additional configuration information for the RightFax client
installation. Disabled options are not required for the feature set
you selected.
RightFax Server Name. This option tells the client software
where to locate the RightFax server by default. You can also
change or add RightFax servers to connect to within each client
application.
Language. Select the language to use for the client
applications that will be installed. This option will be set to the
operating system’s default language setting. To change the
language setting, select the desired language from the list.
Click Next.
7. Click Install to begin the installation.
You must install the RightFax client applications using a special
client-only install that you place on a network file share. This
installation is identical to client installation on the RightFax CD,
except that only the client applications can be installed. First the
client-only installation is placed on a network file share, and then
the RightFax client applications can be installed from there. For
instructions on copying the client-only installation on a network file
share, see “To copy the client-only install files to a network file
share” on page 42.
Installation options are set in the installer settings file, Setup.ini,
which is located by default in the C:\RightFax Clients folder on the
file server where you copy the client-only install.
Modifying the command line
To create the command line, edit the Setup.ini file with a text editor.
In the [Startup] section, edit the CmdLine= command.
The following table describes the installation command switches
you can use. Refer to Microsoft documentation on the Windows
Installer for the latest information on these command line switches.
Switch
Description
/qb
Setup does not prompt the user for information. It
does display progress indicators and a completion
message at the end of the installation.
/qn
Setup does not prompt the user for information. It
does not display progress indicators as it installs.
Does not display a completion message at the end
of the installation
/qr
Setup does not prompt the user for information. It
does display a completion message at the end of the
installation.
/qf
Setup prompts the user for information. It does
display progress indicators and a completion
message at the end of the installation.
Creating an Automated Client Install
If your network is equipped with Microsoft Systems Management
Server (SMS), LanDesk, or a similar network management system,
you can automate the installation of RightFax client software using
an SMS script or equivalent command. The RightFax client
installation program uses Microsoft Windows Installer
(Msiexec.exe) which, when run at a command prompt, can include
switches to force a quiet install, output an SMS status .smf file, and
more. Refer to Microsoft documentation on the Msiexec.exe for
detailed information on running it with a command.
Chapter 4 Installing the RightFax Client Applications
43
RightFax 9.0 Installation Guide
The following tables describe the command line options and
properties you can use..
Table 4a RightFax Advanced Command Line Options
Property
Parameters
Description
INSTALLLEVEL
1|2|3
Controls what features are visible to
the user.
Table 4a RightFax Advanced Command Line Options (Continued)
Property
Parameters
Description
RFLANGUAGE
<language>
Specify what language the RightFax
clients will use. This is set to English
by default.
RFSERVERNAME
<servername> Specify the RightFax server the
clients, IIS, or remote services will
connect to. For clients, this sets the
server the client will open when first
installed. For IIS and remote services
it is used to specify the server to
connect to for configuration info or
settings.
1 = Clients with no EFM
2 = Clients with EFM
3 = All features available
Table 4b RightFax Client Installation Properties
Property
Value
Description
INSTALLDIR
<install path>
Specify the path and the folder on the server where the RightFax software will be installed.
Default: c:\program
files\rightfax\
The value must end with a backslash (\).
<serial number>
Specify the product serial number.
SERIALNUM
This property is required for new installations.
If you are upgrading from an earlier version, this property is not required. You must delete this line or comment
it from the properties text file so that it is not read by the installation program. If you keep this property in the
properties text file without specifying the product serial number, then the serial number that is stored on your
RightFax server will be deleted.
44
Table 4b RightFax Client Installation Properties (Continued)
Property
Value
Description
ALLUSERS
1 or 0
Specify “1” to install for all users on the system, “0” to have it install for only the current user. This value must
be set to 1 for a server install.
INSTALL_EFM
TRUE
Set to “TRUE” to install the Enterprise Fax Manager feature.
INSTALL_FAXCTRL
TRUE
Set to “TRUE” to install the RightFax Print Driver feature.
INSTALL_FAXUTIL
TRUE
Set to “TRUE” to install the FaxUtil feature.
INSTALL_OUTLOOK
TRUE
Set to “TRUE” to install the RightFax Outlook Client feature.
INSTALL_MAPI
PRINTER
TRUE
Set to “TRUE” to install the MAPI Print Driver feature.
INSTALL_VIMPRINTER
TRUE
Set to “TRUE” to install the VIM Print Driver feature.
INSTALL_AUTOREPLY
CLIENT
TRUE
Set to “TRUE” to install the AutoReply Client feature.
INSTALL_INTERACTION
TRUE
Set to “TRUE” to install the Interaction Client feature.
INSTALL_PAPERPORT
TRUE
Set to “TRUE” to install the Paperport Client feature.
INSTALL_WEBEFM
TRUE
Set to “TRUE” to install Enterprise Fax Manager.
INSTALL_WEBCLIENT
TRUE
Set to “TRUE” to install the Web Client feature.
INSTALL_CERTIFIED
DELIVERY
TRUE
Set to “TRUE” to install the Certified Delivery feature.
INSTALL_EXCH2K
CLIENT
TRUE
Set to “TRUE” to install the Exchange 2000 MMC Client feature.
INSTALL_EXCH2K
CONNECTOR
TRUE
Set to “TRUE” to install the Exchange 2000 Connector feature.
Chapter 4 Installing the RightFax Client Applications
45
RightFax 9.0 Installation Guide
Configuring Windows Terminal Server
to Support RightFax Client Sessions
RightFax client applications can be installed on and run in multiple
sessions from a Windows Terminal Server. Running the RightFax
client in the Windows Terminal Server environment requires only
one client install directly on the Terminal Server, but supports an
unlimited number of simultaneous client sessions.
This installation also supports (but does not require) Citrix
MetaFrame.
To install and configure the RightFax client on Windows
Terminal Server
1. On the RightFax server, run the Server module configuration
program from Enterprise Fax Manager.
2. In the Number of Fax Queues to Create box, enter the number
of fax print queues to create to allow multiple users to send
simultaneous print-to-fax jobs via Windows Terminal Server. This
is the maximum number of sessions that can simultaneously
access the fax print queue.
The number of queues you should specify depends on the total
number of fax users that will be supported concurrently by
Terminal Server. Twenty print queues is enough to easily
support hundreds of concurrent Windows Terminal Server
sessions, but you should specify more if necessary to prevent
sessions from hanging if the queue becomes full.
Note You can increase or decrease the number of fax queues at any
time to best match your level of fax traffic. If you do, you must start
and then quit the RightFax Client program in Control Panel on the
Windows Terminal Server to make the changes take effect.
3. On the Terminal Server, go to a command prompt and enter
install mode by typing:
change user /install
4. Install the RightFax client to the Terminal Server according to
the instructions in the RightFax Administrator’s Guide.
5. Open the RightFax Client program in Control Panel on the
Windows Terminal Server and select Use All Available HPFAX
Queues. Click OK.
6. Finally, on the Terminal Server, go to a command prompt and
type:
change user /execute
Troubleshooting the Client Installation
and Configuration
The following table lists the most common error messages that may
appear after installing the RightFax client applications with the
probable causes and solutions.
Error or error
message
Possible solutions
The server is unavailable
Verify that the RightFax Database module
and RightFax RPC Server module
services are running on the RightFax
server.
The server is using
different network
protocols
Check the Networking program in
Control Panel on the Windows NT server
and verify that the protocols installed and
enabled match those used by the clients.
46
Error or error
message
The common network
protocol being used is
not routed between LAN
segments
The Windows NT server
running RightFax is not
configured to support
NetWare clients
The NetWare clients are
using different frame
types than the Windows
NT server
Possible solutions
Try running a client on the same LAN
segment as that of the server. Modify
the appropriate bridge or routers to
route the proper protocols.
Update the server and clients to use a
routed protocol.
If the server machine has multiple
network adapters installed, try
removing all but one of the adapters
and allow other routers on the network
to route the packets.
Verify that the Windows NT server is
running gateway services for NetWare
and the SAP Agent. Verify that the
IPX/SPX transport is properly configured
using the Network program in Windows
Control Panel.
On the client computer, the frame type is
in the Link Driver section of the
NET.CFG. On the Windows NT server,
the frame type is in the configuration of
the NWLink IPX/SPX transport object in
the Network program in Windows
Control Panel. If the Windows NT server
must support more than one frame type,
ensure that the internal network number
is a unique, non-zero number and that the
Auto Frame Type Detection is disabled.
Error or error
message
Possible solutions
There is no SAP agent
computer accessible to
both the client and server
machines
Verify that the client and server
machines can log on to a NetWare
server. Verify that the SAP Agent is
installed on the Windows NT server.
Verify that the client and server are on
the same network segment and that the
router between the segments is
configured to transport SAP type
0×640 messages.
Unable to find FaxDB
service
Verify that the user logged in has access
to the RightFax host file server. If the
RightFax host file server is not a member,
backup, or primary domain controller,
then the user may not have access to the
RightFax files or resource \PIPE\FAXDB.
You may have to assign Guest privileges.
User ID was not found in
database
RightFax has its own list of fax users and
the user ID specified is not on that list.
You can use Enterprise Fax Manager to
add users, either individually or by
reading them from the domain or file
server. When RightFax is first installed,
the users “Administrator” and “Default”
are loaded. Initially, neither user ID has a
password.
The password supplied
is incorrect
You must use the correct password for
the user specified. If the user has lost his
password, a RightFax administrator can
re-set the password in Enterprise Fax
Manager.
Chapter 4 Installing the RightFax Client Applications
47
RightFax 9.0 Installation Guide
Error or error
message
Possible solutions
The RightFax fax
addressing dialog box
opens, but nothing
appears in FaxUtil
You are using a different user ID than
expected. Check the RightFax Client
program in Control Panel to see what
user ID the software is using.
On Windows NT, the port setting for
the fax printer may be incorrect.
Complete the Configure Fax Printers
dialog box according to the instructions
in “Configuring Windows Terminal
Server to Support RightFax Client
Sessions” on page 46.
48
Chapter 5
Upgrading and Adding Fax Channels,
User Licenses, and Optional Components
You can easily expand and extend the functionality of your RightFax
server by:
Upgrading the server (described on page 50)
Adding fax channels and user licenses (described on page 51)
Adding optional components (described on page 52)
Most of these additions to your fax server can be made without
installing or re-installing software. You can add new functionality to
all RightFax servers using “bump codes.” Bump codes are special
activation codes that enable specific functionality on the server.
Bump codes are provided by Captaris support engineers or your
RightFax distributor, as described in this chapter.
To check for installed components
1. Run Enterprise Fax Manager (see “Using Enterprise Fax
Manager” on page 27) and select the server you want to check.
2. In the list of services in the lower-right pane, double-click
RightFax Server Module. The RightFax Server Configuration
window opens.
Checking for Installed Components
The different types of RightFax servers are installed with different
numbers of licensed fax channels and users, and different optional
components enabled. Follow these steps to display a list of the fax
channels, users, and components that have been enabled on the
server.
Chapter 5
Upgrading and Adding Fax Channels, User Licenses, and Optional Components
49
RightFax 9.0 Installation Guide
3. Click the Feature Activation tab. The server type, number of
licensed fax channels and users, and enabled components are
listed in the window on this tab.
Upgrading the RightFax Server
Captaris RightFax servers can support small, medium, and large
enterprises. The following servers are available.
Figure 5.1 The List of Enabled RightFax Components
Table 5a RightFax Server Types
RightFax
server
Description
Business server
This RightFax server supports unlimited user accounts, It
includes one fax channel, and is expandable to 30 fax
channels.
Enterprise
server
This RightFax server supports unlimited user accounts. It
includes three WorkServers and one fax channel,
expandable to support unlimited fax channels. This server
includes the RightFax Web Client™ and the OCR
Router™, OCR Converter™, Docs-on-Demand™, and
TeleConnect™ modules.
The Enterprise server is also available as a product suite
that includes the RightFax Enterprise server, plus the
Gateway for Microsoft® Exchange, the Gateway for Lotus
Notes®, the Document Management Connector™, and the
SNMP Alerting™, and PDF modules.
Integration
server
The RightFax server and the RightFax Integration Module
enable applications for information exchange. The
Integration Module integrates RightFax with applications
on mainframe, mid-range, and local area network host
systems.
The RightFax Business Integration Module can be
installed on the RightFax Business and Enterprise servers.
The RightFax Enterprise Integration Module can be
installed on the RightFax Enterprise server.
Satellite server
This RightFax server supports up to 15 user accounts. It
includes two WorkServers and two fax channels.
50
To upgrade the RightFax server
1. Contact your RightFax distributor and purchase the appropriate
server license. You will be sent a new license card that includes
a new product serial number.
2. Run Enterprise Fax Manager (see “Using Enterprise Fax
Manager” on page 27) and select the server that you want to
upgrade.
3. In the service name list in the lower-right pane, double-click
RightFax Server Module. The RightFax Server Configuration
window opens.
4. Click the Feature Activation tab.
5. In the Enter the System Identifier field, enter the RightFax
system ID that was provided with your RightFax server software.
Do not enter the product serial number, which is a separate
identifier.
6. Click Get Bump. The RightFax service will be stopped, and a
bump code will be displayed. Be prepared to provide this bump
code to a Captaris support engineer.
7. Call the RightFax product support group at (520) 320-7070.
Important Some RightFax service plans require that you contact
your RightFax distributor for bump codes rather than the RightFax
support group. If so, you must contact your distributor at the phone
number that was provided as part of your service agreement.
8. From the voice menu, select the option for support with a
Captaris faxing product, and then select the option for a bump
code. Your call will be routed to a support engineer.
9. Follow the instructions provided by the support engineer for
upgrading your server. You will be provided with a new bump
code to enter in the Feature Activation tab.
Adding Fax Channels and User Licenses
To add fax channels
1. Contact your RightFax distributor and purchase the appropriate
channel or user license. You will be sent a new license card that
includes a new product serial number.
2. Run Enterprise Fax Manager (see “Using Enterprise Fax
Manager” on page 27) and select the server to which you are
adding channels or user licenses.
3. In the service name list in the lower-right pane, double-click
RightFax Server Module. The RightFax Server Configuration
window opens.
4. Click the Feature Activation tab.
5. Click Get Bump. The RightFax service will be stopped, and a
bump code will be displayed. Be prepared to provide this bump
code to a Captaris support engineer.
6. Call the RightFax product support group at (520) 320-7070.
Important Some RightFax service plans require that you contact
your RightFax distributor for bump codes rather than the RightFax
support group. If so, you must contact your distributor at the phone
number that was provided as part of your service agreement.
7. From the voice menu, select the option for support with a
Captaris faxing product, and then select the option for a bump
code. Your call will be routed to a support engineer.
8. Follow the instructions provided by the support engineer for
upgrading your server. You will be provided with a new bump
code to enter in the Feature Activation tab.
Chapter 5
Upgrading and Adding Fax Channels, User Licenses, and Optional Components
51
RightFax 9.0 Installation Guide
9. After you have added the new fax channels or user licenses,
they must be configured for use by RightFax. New fax channels
are configured in the BoardServer configuration program. New
users are configured in Enterprise Fax Manager. For information
on running the BoardServer configuration program or
Enterprise Fax Manager, refer to the RightFax Administrator’s
Guide.
Enabling New RightFax Optional Components
To enable new RightFax components
1. Contact your RightFax distributor and purchase the appropriate
component license. You will be sent a new license card that
includes a new product serial number.
2. Run Enterprise Fax Manager (described in the RightFax
Administrator’s Guide) and select the server to which you are
adding the new component.
3. In the service name list in the lower-right pane, double-click
RightFax Server Module. The RightFax Server Configuration
window opens.
4. Click the Feature Activation tab.
5. Click Get Bump. The RightFax service will be stopped, and a
bump code will be displayed. Be prepared to provide this bump
code to a Captaris support engineer.
6. Call the RightFax product support group at (520) 320-7070.
Important Some RightFax service plans require that you contact
your RightFax distributor for bump codes rather than the RightFax
support group. If so, you must contact your distributor at the phone
number that was provided as part of your service agreement.
7. From the voice menu, select the option for support with a
Captaris faxing product, and then select the option for a bump
code. Your call will be routed to a support engineer.
8. Follow the instructions provided by the support engineer for
upgrading your server. You will be provided with a new bump
code to enter in the Feature Activation tab.
9. After you enter the new bump code, the new RightFax
component(s) will be available. For information on configuring
and using RightFax components, refer to the documentation for
your particular products.
52
Chapter 6
Documentation and Support
RightFax Documentation
Documentation for the RightFax server, the RightFax client
applications, and all of the RightFax components and modules is
installed in PDF format on the RightFax server. For your
convenience, Captaris also provides three of these guides in
printed form: the RightFax Installation Guide, the RightFax
Administrator’s Guide, and the RightFax Integration Module Guide
(provided only with a licensed copy of the RightFax Integration
Module). The remaining guides are formatted to be easily viewed
on-screen or printed.
All of the RightFax user guides (including PDF versions of the
printed guides) are located in the RightFax\Docs folder on the
RightFax server and on the product CD. In addition, most of these
documents can be downloaded from the RightFax Web site at
www.captaris.com/customer_support/tech_docs/5609.html.
The following table describes all of the user guides available for
RightFax and lists the RightFax components that each guide
supports.
Note To view these files, you must have Adobe Acrobat Reader
installed. A copy of Adobe Acrobat Reader can be found on the RightFax
server installation CD in the Docs folder.
Table 6a RightFax User Guides
Guide name
Description
Activating and Using
PDF Module
A guide to installing, configuring, and using the
RightFax PDF Module.
Activating and Using
the OCR Converter
Module
A guide to installing, configuring, and using the
RightFax OCR Converter Module.
Activating and Using
the OCR Router
Module
A guide to installing, configuring, and using the
RightFax OCR Router Module.
Administrator’s
Guide
A comprehensive guide to configuring and
maintaining all RightFax servers.
API Reference Guide A reference for C programmers and Visual Basic
programmers for using the RightFax API. This guide
is only available through the RightFax Developer’s
Network.
Chapter 6
Documentation and Support
53
RightFax 9.0 Installation Guide
Table 6a RightFax User Guides (Continued)
Table 6a RightFax User Guides (Continued)
Guide name
Description
Guide name
Description
Client for Lotus
Notes Quick
Reference Card
A reference card for users who will send and manage
faxes with the RightFax Gateway for Lotus Notes.
RightFax Lotus Notes
Module Guide
A guide to installing, configuring, and using the
RightFax Lotus Notes Module.
Client for Microsoft
Outlook Quick
Reference Card
A reference card for users who will send and manage
faxes with the RightFax Gateway for Microsoft
Exchange.
RightFax Microsoft
Exchange Module
Guide
A guide to installing, configuring, and using the
RightFax Microsoft Exchange Module.
Installation Guide
COM Reference
Guide
A guide to using the RightFax COM module for
creating custom RightFax applications with Visual
Basic. This guide is provided in PDF format on the
RightFax COM Module installation CD.
A guide to installing the RightFax server, upgrading
the server, and adding new components.
Installing and Using
the InterAction
Integration Software
A guide to configuring RightFax to work with the
InterAction contact management system.
Connector for Oracle
CRM Guide
A guide to installing, configuring, and using the
RightFax Connector for Oracle CRM.
Integration Module
Guide
A guide to installing, configuring, and using the
RightFax Integration Module.
InternetLink Module
Guide
A guide to installing, configuring, and using the
RightFax InternetLink Module.
SecureDocs Module
Guide
A guide to installing, configuring, and using the
RightFax SecureDocs Module.
SNMP Alerting
Module Guide
A guide to installing, configuring, and using the
RightFax SNMP Alerting Module.
TeleConnect Guide
A guide to installing, configuring, and using RightFax
TeleConnect.
Connector for Oracle A guide to installing, configuring, and using the
E-business Suite
RightFax Connector for Oracle E-business Suite.
Guide
Connector for FileNet
P8 Guide
A guide to installing, configuring, and using the
RightFax Connector for Panagon Image Services.
This guide is only available with the FileNet P8
integration software.
Connector for SAP
R/3 Guide
A guide to installing, configuring, and using the
RightFax Connector for SAP R/3.
Docs-on-Demand
Guide
A guide to installing, configuring, and using RightFax
Docs-on-Demand.
Document
Management
Connector Guide
A guide to integrating RightFax with iManage and
Hummingbird content management applications.
Fax Board Guide
A guide to all the fax boards supported by RightFax,
including required hardware and software
configuration.
FaxUtil Quick
Reference Card
A reference card for users who will send and manage
faxes with RightFax FaxUtil.
54
Getting Help Online
Editing Contact Information in FaxUtil
Most of the RightFax windows and dialog boxes include
context-sensitive help. Typically, this help describes each field and
option in a dialog box. This context-sensitive help can be launched
from the question mark icon in the title bar of a dialog box.
In the FaxUtil Help menu, users can select Contact Information,
and a dialog box opens that lists RightFax technical support
contact information.
Figure 6.1 The Contact Information Dialog Box
Click the
question mark icon
Click this icon, and then click any option on the dialog box to view
its definition.
Or, press F1 to view a definition.
Online help for tasks or conceptual topics also is available. View
this help by selecting the Help menu. You can browse the help for
a topic or use the index to look up key words and terms.
Select the
Help menu
The RightFax Web site offers the latest product information.
Updated documentation, a searchable customer support
knowledgebase, software downloads, and the latest product
offerings are all online at www.captaris.com/rightfax.
This contact information appears in English with RightFax contact
information, but you can edit the text to provide customized
information. To do so, edit the text file Contact.txt located in the
\RightFax\Bin folder on the RightFax server. You can enter 24 lines
of text and up to 59 characters per line.
Captaris Training Services
RightFax training gives you the skills to optimize your RightFax
solution. Our comprehensive technical, administrative, and user
training programs produce full utilization and understanding of
RightFax products. Regular classes are held at the state-of-the-art
RightFax Training Center in Tucson, Arizona, throughout the year, or
you can choose the convenience of training at one of our regional
locations. Training materials and computer-based training tools are
also available. For more information on RightFax training, please
Chapter 6
Documentation and Support
55
RightFax 9.0 Installation Guide
visit our Web site at www.captaris.com/training, or call us at
(520) 320-7098 and let us help you develop a customized training
plan for your organization.
Captaris Implementation Services
Captaris Implementation Services offers a team of highly skilled
engineers who are experts in the deployment, implementation, and
integration of RightFax solutions. Implementation services include
installation and configuration, upgrades, configuration review, and
advanced integration services. Whether it's through remote dial-in,
an on-site implementation, or a combination of both, the
Implementation Services team can quickly integrate RightFax
solutions with your existing applications.
Customer Support
Your Customer Support Guide includes detailed information about
the support options available to RightFax customers. Please fill out
the RightFax Software Warranty & Registration Card and return it
immediately. If you have questions of a technical nature, contact
your organization’s RightFax administrator or network administrator
before calling the RightFax customer support department. On the
RightFax Web site, a database of customer support knowledge
contains a wealth of information on installing, configuring, and
maintaining RightFax software.
RightFax Customer Support:
Captaris
Suite 210
6303 E. Tanque Verde
Tucson, Arizona 85715 USA
Voice:
Fax:
Web:
E-mail:
(520) 320-7070
(520) 321-7461
www.captaris.com/rightfax
tech@captaris.com
5:00 A.M. to 5:00 P.M. Pacific time, Monday through Friday
7:00 A.M. to 3:00 P.M. Pacific time, Saturday
Support Sales and Administration: (520) 320-7000
56
Appendix A
Installing RightFax in a Windows 2000
or Windows 2003 Cluster
System Requirements
Installing RightFax in a Windows cluster environment requires that
you have two servers that are on the Microsoft Clustering
Hardware Compatibility List (located on the Microsoft Web site)
running Windows 2000 Advanced Server or Windows Server
2003 Enterprise Edition. You must also have an external SQL
Server 2000 installation and two network cards. A hardware RAID
controller is required for external array and is recommended for
internal array. Windows Cluster Service must be installed,
configured, and operational. There also must be an external RAID
array running either SCSI or fiber channel.
Configuring the Cluster Group
All of the clustered RightFax resources must be maintained in a
single cluster group. This provides complete failover protection in
the event of individual resource failures. This cluster group must
also include a disk resource, a server name resource, and an IP
address resource. The combination of these core resources
creates a virtual RightFax server. Configure the cluster group to
have a preferred server and to allow fail-back.
The default group created during the Cluster service installation,
named “Cluster Group,” may also be used for the RightFax
resources. In this case, the quorum drive is typically used as the
shared installation drive for the RightFax software. While this
approach may add complexity to recovery procedures in the event
of a Cluster service or disk device failure, it will not affect
configuration or performance, and it is a good choice when
hardware resources are limited to a single RAID controller.
Configuring RightFax BoardServers
It is strongly recommended that no RightFax BoardServers be
installed on the clustered hardware. Phone lines and T1 lines
cannot be clustered and will not failover in the event of a hardware
problem. Captaris recommends that you use remote BoardServers,
connecting to the virtual RightFax server.
Appendix A
Installing RightFax in a Windows 2000 or Windows 2003 Cluster
57
RightFax 9.0 Installation Guide
Installing the RightFax Server
When the software installation is complete, create the RightFax
cluster resources (described on page 59).
Installing RightFax on the two cluster nodes
Before installing RightFax on the two cluster nodes, ensure that a
PCL5 printer driver (such as HP LaserJet 4) is installed on both
computers. If not, install the driver by adding a printer in Windows.
When prompted for a printer port, select File. Use the default
printer name and do not print a test page. This step allows RightFax
to create a print-to-fax queue during the server installation.
1. On both nodes, ensure that System group has full control of the
the shared (cluster) drive to which RightFax will be installed.
2. On the primary node, install the RightFax server software to the
shared drive according to the instructions in Chapter 3,
“Installing the RightFax Server Software”. If prompted to restart
the computer at the end of the installation, select No. Do not
install the fax board hardware drivers.
3. After RightFax is installed on the primary node, open the
DocTransport configuration program in Windows Control Panel,
select RightFax Boardserver, and then click Configure
Boardserver. This creates the RightFax BoardServer service on
the primary node.
4. Open the Windows Services configuration program, stop all
RightFax services, and set them all to manual start.
5. Open the Printers configuration program in Windows Control
Panel and turn off sharing for the HPFAX printer.
6. Move the cluster group containing the disk, IP address, and
network name resources to the node where RightFax was just
installed.
7. On the secondary node, install the RightFax server software to
the same shared drive you used for the first node. If prompted to
re-start the computer at the end of the installation, select No.
Do not install the fax board hardware drivers.
8. After RightFax is installed on the secondary node, open the
DocTransport configuration program in Windows Control Panel,
select RightFax Boardserver, and then click Configure
Boardserver. This creates the RightFax BoardServer service on
the secondary node.
9. After RightFax is installed on the secondary node, open the
Services configuration program in Windows Control Panel and
set all of the RightFax services to manual start.
10. Open the Printers configuration program in Windows Control
Panel and turn off sharing for the HPFAX printer.
11. Re-start the first node and move the group back over to it.
Configuring the shared drive
1. Using a text editor, edit the file Setup.ini located in the folder
where you placed the RightFax client installation files
(described in the RightFax Installation Guide). By default, this is
installed in C:\RightFax Clients. Change the RFSERVERNAME
value to the name of the cluster.
2. Create a folder on the shared drive called “Spool.” This folder
will be used to specify where the Print Spooler service will place
its spool files.
58
Creating the RightFax Cluster Resources
To create the RightFax cluster resources, run Cluster Administrator
and open the RightFax cluster group. You will create the following
resources.
Table A1 RightFax Cluster Resources
Creating the RightFax Server Module resource
1. Right-click Resources, and then select New > Resource. The
Generic Resource wizard opens.
2. In the Name and Description boxes, enter “RightFax Server
Module.”
3. Set Resource Type to Generic Service.
Name of Resource
Type of Resource Service Name
RightFax File Share
File Share
N/A
RightFax Server Module
Generic Service
RFSERVER
RightFax Queue Handler
Generic Service
RFQUEUE
4. Select the RightFax group.
5. In the Possible Owners box, enter the names of both nodes in
the cluster by selecting them and clicking Add.
RightFax RPC Server Module Generic Service
RFRPC
6. In the Resource Dependencies box, add the Disk Resource,
Network Name, and IP Address resources.
RightFax Paging Module
RFPAGE
7. In the Generic Service Parameters box, type “RFSERVER.”
Generic Service
Creating the File Share resource
1. Right-click Resources, and then select New > Resource. The
Generic Resource wizard opens.
2. In the Name and Description boxes, enter “RightFax File
Share.”
3. Set Resource Type to File Share.
4. Select the RightFax group.
8. Select the Use Network Name for Computer Name check
box.
9. Under Registry Replication, click Add and type
“SOFTWARE\RightFax.” This allows the registry information
stored by RightFax to dynamically change from one node to
another if the server goes down.
10. Click Finish to add the resource to the group.
Creating the RightFax Queue Handler resource
5. In the Possible Owners box, enter the names of both nodes in
the cluster by selecting them and clicking Add.
1. Right-click Resources, and then select New > Resource. The
Generic Resource wizard opens.
6. In the Resource Dependencies box, add the Disk Resource,
Network Name, and IP Address resources.
2. In the Name and Description boxes, enter “RightFax Queue
Handler.”
7. In the Generic File Share Parameters box, enter the path to
the RightFax directory on the shared drive. Be sure to use
RightFax as the share name.
3. Set Resource Type to Generic Service.
8. Click Finish to add the resource to the group.
4. Select the RightFax group.
5. In the Possible Owners box, enter the names of both nodes in
the cluster by selecting them and clicking Add.
6. In the Resource Dependencies box, add the Disk Resource,
Network Name, and IP Address resources.
Appendix A
Installing RightFax in a Windows 2000 or Windows 2003 Cluster
59
RightFax 9.0 Installation Guide
7. In the Generic Service Parameters box, type “RFQUEUE.”
8. Select the Use Network Name for Computer Name check
box.
9. Click Finish to add the resource to the group.
Creating the RightFax RPC Server Module resource.
6. In the Resource Dependencies box, add the Disk Resource,
Network Name, and IP Address resources.
7. In the Generic Service Parameters box, type “RFPAGE.”
8. Select the Use Network Name for Computer Name check
box.
9. Click Finish to add the resource to the group.
1. Right-click Resources, and then select New > Resource. The
Generic Resource wizard opens.
2. In the Name and Description boxes, enter “RightFax RPC
Server Module.”
3. Set Resource Type to Generic Service.
Configuring the RightFax Printer
Creating a clustered print spooler
4. Select the RightFax group.
1. Run Windows Cluster Administrator and select the RightFax
group.
5. In the Possible Owners box, enter the names of both nodes in
the cluster by selecting them and clicking Add.
2. Create a new resource called “Print Spooler.”
6. In the Resource Dependencies box, add the Disk Resource,
Network Name, and IP Address resources.
7. In the Generic Service Parameters box, type “RFRPC.”
8. Select the Use Network Name for Computer Name check
box.
9. Click Finish to add the resource to the group.
Creating the RightFax Paging Module resource
1. Right-click Resources, and then select New > Resource. The
Generic Resource wizard opens.
2. In both the Name and Description boxes, enter “RightFax
Paging Module.”
3. Set Resource Type to Generic Service.
4. Select the RightFax group.
5. In the Possible Owners box, enter the names of both nodes in
the cluster by selecting them and clicking Add.
3. Set the resource type to “Print Spooler” and verify that the
RightFax group is the owner.
4. Verify that both cluster nodes are listed under Possible
Owners.
5. Set the cluster IP address, cluster name, and share drive as
dependencies.
6. Set the path to the “Spool” folder you created on the shared
drive.
7. Start the print spooler resource in Cluster Administrator.
Creating the HPFAX print queue
1. Open the Printer folder on the RightFax virtual server.
2. Create a new TCP/IP port, using the shared cluster IP address
as the target IP address and HPFAX as the port name.
3. Select Custom Device Type, and click Settings. Select RAW
as the protocol and set the port number to 53199.
60
4. Select an HP LaserJet III, LaserJet 4, or LaserJet 5 printer driver
and share the printer as HPFAX.
5. Open the Properties of the HPFAX printer, click the Advanced
tab, and then click Separator Page. Enter the following for the
separator page:
SharedDrive:\RightFax\bin\RightFax.sep
Where SharedDrive is the drive letter of the shared drive on
which RightFax is installed.
Completing the Installation
1. Bring all of the RightFax resources on-line.
2. On the secondary node, open Cluster Administrator and verify
that the primary node currently owns all resources.
3. Shut down the primary node and verify that all resource fail over
to the secondary node.
4. Re-start the primary node and verify that all resources fail back.
6. Re-start both nodes.
Configuring the SQL Server Database
Before you activate RightFax on the nodes, you must open the
RightFax database and edit the ServerGUID to reflect the correct
licensing information. This licensing information is stored in the
registry.
Obtaining the ServerGUID value
1. Choose Start > Run, then type regedit.
2. In the Registry Editor, navigate to HKEY_LOCAL_MACHINE >
SOFTWARE > RightFax > Faxserver.
3. Locate the ServerGUID key and note the String Value.
4. Exit the Registry Editor.
Editing the ServerGUID value
1. Open SQL Server Enterprise Manager, locate the RightFax
database, expand the treeview, and select Tables.
2. Select the Configuration table, then choose Action > Open
Table > Return all rows.
3. Edit the ServerGUID column to reflect the data obtained from
the Registry Editor, then exit SQL Server Enterprise Manager.
Appendix A
Installing RightFax in a Windows 2000 or Windows 2003 Cluster
61
RightFax 9.0 Installation Guide
62
Download PDF
Similar pages