OpenText RightFax 10.5 Installation Guide
OpenText RightFax 10.5 Installation Guide
OpenText RightFax 10.5 Installation Guide
5 Installation Guide
ii
Edition
OpenText RightFax 10.5 . This document was last updated October 2, 2012.
Trademarks
OpenText is a registered trademark of OpenText Corporation. All other company names, brand names, and product names are the property and/or trademarks of their respective companies.
Copyright Notice
2012 OpenText, Inc. All rights reserved. OpenText Corporation 275 Frank Tompa Drive Waterloo, Ontario, Canada N2L 0A1 (519) 888-7111 http://www.opentext.com Portions of this product Copyright 2002-2006 Glyph & Cog, LLC. Portions Copyright 2001 artofcode LLC. This software is based in part on the work of the Independent JPEG Group. This software is based in part on the work of the Freetype Team. Portions Copyright 1998 Soft Horizons. Portions Copyright 2001 URW++. All Rights Reserved. Includes Adobe PDF Library technology. Adobe, Acrobat and the Acrobat logo are trademarks of Adobe Systems Incorporated. Portions Copyright TMS, Inc. 1994-2001. All rights reserved.
Contents
Chapter 1
Hardware and Software Requirements ............................ 5 OpenText Knowledge Center .........................................................5 Fax Server Requirements ................................................................5 SQL Requirements and Information .............................................7 Virtualization Support .......................................................................9 FaxUtil Legacy Support ...................................................................9 Fax Board Requirements.................................................................9 Phone Line Requirements...............................................................9 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 Upgrading RightFax Server Software ............................. 15 Upgrade Information...................................................................... 15 Running the RightFax Server Upgrade ..................................... 16
Chapter 4
Installing RightFax Server Software ...............................19 New Installation Overview ............................................................19 Updates may be available .............................................................19 Before Installing .............................................................................20 Preparation Steps for Installing RightFax..................................20 Using RightFax with an Existing SQL Server ...........................22 Adding an Exception to the Windows Firewall ........................25 Uninstalling the RightFax Server .................................................25 Installing RightFax Web Applications.............................27 IIS server requirements .................................................................28 Installing Web Applications..........................................................29 URL for RightFax Web applications ......................................... 30 Configuring Web Access Session Timeout Period ............... 30 Configuring RightFax Web Delivery ...........................................31
Chapter 2
Chapter 5
Chapter 3
iii
iv
Chapter 6
Installing RightFax Client Applications.......................... 33 RightFax Client Computer Requirements .................................35 Upgrading the RightFax Client Applications ............................35 Before You Begin............................................................................35 Installing the Client Applications................................................ 36 Installing the SOAP Client............................................................37 Creating an Automated Client Install or Uninstall .................. 38 Configuring Windows 2008 Terminal Services to Support RightFax Client Sessions...........................................................43 Installing and Configuring the Shared Services Module .................................................... 47 Overview ...........................................................................................47 Server Topology ..............................................................................47 System Requirements................................................................... 49 Installing RightFax Servers to Share a SQL Database......... 49 Performing Daily Maintenance .....................................................53 Installing RightFax in a Windows 2008 R2 Cluster ..... 55 System requirements .....................................................................55 Installing RightFax onto the cluster............................................ 56 Configuring the Integration Module in a Windows 2008 R2 Cluster.......................................................62 Upgrading and Adding Fax Channels, User Licenses, and Optional Components.................... 67 Checking for Installed Components...........................................67 Upgrading the RightFax Server License................................... 68 Licensing Brooktrout SR140 Channels ................................... 69
Chapter 7
Chapter 8
Chapter 9
Chapter 1
Windows 2008 Standard x86 (32-bit) and x64 (64-bit) Windows 2008 Enterprise x86 (32-bit) and x64 (64-bit) Windows Server 2008 R2 Standard x64 (64-bit) Windows Server 2008 R2 Enterprise x64 (64-bit)
Chapter 1
Hardware requirements
Processor Memory Minimum: Single CPU 1GHz (x86) or 1.4 GHz (x64) Recommended: Dual CPU 2.6 GHz or higher Minimum: 1 GB RAM (2 GB with locally installed Microsoft SQL Server Express Edition) Recommended: 2 GB RAM or greater (4 GB with locally installed Microsoft SQL Server Express and Microsoft Office) Available disk space* Minimum: 10 GB Recommended: 40 GB or greater Note: This does not include free space required by the operating system. Display and peripherals Network Interface Monitor, keyboard, and compatible pointing device are required for administration of RightFax Server application. A network interface card is required for network communications.
z z z z z z
Microsoft SQL Server Microsoft Messaging Queue (MSMQ) Server* Reserve network ports Microsoft Primary Interoperability Assemblies 2005* Microsoft Visual C++ runtime components* Microsoft Internet Information Services (IIS) 6.0 SP2 or later IIS 6 Management Tools must be installed on Windows Server 2008 Microsoft .NET 4.0 Framework* Microsoft Data Access Components* Microsoft Internet Explorer 6 SP1 or later Microsoft Windows Installer 3.1* Crystal Reports 13.0 runtime* (used for FaxReporter) A Windows account to run RightFax services. The account you choose must be a member of the local administrators group and must have the right to logon as service on the local computer.
Important Hard disk requirements do not include space for storage of document images. To calculate disk space, estimate 35kb per document page.
*Installed during RightFax setup When installing, log on to the computer using a Windows account that is a member of the domain and local Administrators group.
account is required only for Setup and is neither saved nor used by RightFax. The SQL permissions required for this account are provided below.
z z z z z z
SQL Server 2005 Express SQL Server 2005 Standard Edition SQL Server 2005 Enterprise Edition SQL Server 2008 Express SQL Server 2008 Standard Edition SQL Server 2008 Enterprise Edition SQL Server 2008 R2 Express SQL Server 2008 R2 Standard Edition SQL Server 2008 R2 Enterprise Edition SQL Server 2012 Express SQL Server 2012 Standard Edition SQL Server 2012 Enterprise Edition
Create database Create table Create procedure Create view Create rule Create default
The second account is used by and during Setup to run SQL stored procedures and subsequently by RightFax services requiring a SQL connection.
Server Roles: None required. Select, Update, Insert, Delete, and Execute permissions on all RightFax database objects. DB_writer and DB_reader database roles provide Select, Update, Insert, and Delete permission, but do not grant explicit Execute permission.
Chapter 1
The following ASCII code pages are supported by the RightFax server and client applications:
z
z z
z z z z z z
RightFax supports a wide range of characters and symbols from non-English alphabets. The RightFax server, SQL database, and client applications must all be configured to use the same symbol sets. The symbol sets that are supported on the RightFax server and client computers are determined by the Regional and Language Options configured from Windows Control Panel and can be changed at any time. The symbol set used by the SQL database is based on the current Regional setting on the SQL server. This is true whether you have a separate SQL server or are installing the SQL server during the RightFax installation.
Important: Ensure that the Regional setting on the SQL server is properly configured for your desired character set before installing the RightFax database. If you have already installed a SQL database with the incorrect Regional setting, contact Microsoft for assistance in reconfiguring the SQL regional setting.
1250 Central Europe: Albania, Croatia, Faeroese, Hungarian, Polish, Romanian, Serbian, Slovak, Slovenian 1251 Cyrillic: Byelorussian, Bulgarian, Russian, Ukrainian 1252 Latin 1: Afrikaans, Basque, Catalan, Danish, Dutch (standard and Belgium), English (United States, Britain, Canada, New Zealand, Ireland, South Africa), Finnish, French (standard, Belgium, Switzerland, Canada, Luxembourg), German (standard, Switzerland, Austria, Luxembourg, Liechtenstein), Icelandic, Indonesian, Italian (standard, Swiss), Norwegian (Bokmal, Nynorsk), Portuguese (standard and Brazil), Spanish (Mexican, traditional, modern) and Swedish. 1253 Greek 1254 Turkish 1255 Hebrew 1256 Arabic 1257 Baltic: Estonian, Latvian, Lithuanian 1258 Vietnam
NoteTime strips are printed using the printers available symbol set regardless of the code page in use on the server. For characters on these lines to appear as expected, the code page on the fax server must match the printers available symbol set. Because TTI lines and quick headers are placed onto the fax image by your fax board, RightFax does not support the use of diacritical characters on these lines.
Virtualization Support
RightFax 10.5 server software is supported in the following virutalization environments: VMware ESX server 3.0.1 or later z VMWare vSphere 4.0 or later z VMWare vMotion is supported z Microsoft Hyper-V (Live Migration is not currently supported) VMware Workstation and all other virtualization software is not supported.
z
Requirements for all RightFax servers begin on page 5. Additional requirements for virtual RightFax servers are as follows:
z
z z
Virtual RightFax servers must be installed on ESX platforms that meet the minimum requirements as documented by VMware. Each RightFax server should be installed on a separate virtual machine. Set the same time on the ESX host machine and the Fax Server virtual machine. No virtual RightFax server may contain fax board hardware. Sending and receiving fax documents requires a boardless solution (e.g., FOIP) or dialing rules to route faxes to and from a physical server that contains one or more fax boards. For more information about creating dialing rules, see the RightFax Administrators Guide. RightFax is not compatible with the VMWare tool ThinPrint. Ensure that ThinPrint is disabled before installing RightFax client software. If a virtual machine is configured to use device printers on the host machine, you must manually add print drivers either through the VMWare tools or EFM.
Chapter 1
10
Chapter 2
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 9, 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 a SQL Server 2012 Express database on the RightFax server. 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. On x64 systems, the software installs in the c:\Program Files (x86)\RightFax folder. Do not install the software in the Program Files folder on x64 systems because this folder is reserved for 64-bit program files.
Chapter 2
11
12
The following table describes all of the available RightFax configuration programs.
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
Description The Doc Transport configuration program is used to configure most transport methods including standard fax boards, T.37 Fax-over-IP, SMS (short message service) and fax board simulation. All fax board configuration is initiated from this configuration program. For more information on fax boards 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 Administrators Guide.
Description The RightFax Conversion Engine is a stand-alone, fault tolerant service that is used to invoke applications commonly used in server-side application conversion. These applications convert their associated file types when installed on the RightFax server and remote WorkServers.
The Conversion Engine must be run under an account that has permission to open the conversion applications and permission to create a printer. See Configuring the Service Account on page 73 for more information.
RightFax Sync Module The RightFax Sync Module is an XML/XSLT based tool that RightFax administrators can use to create and synchronize users from Active Directory domains, groups, and organizational units. LDAP compliant data sources are also supported. RightFax Alerting With the RightFax Alerting and Monitoring feature, administrators can 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 Administrators Guide.
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 organizations 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 Administrators Guide, the RightFax Gateway for Microsoft Exchange Guide, or the RightFax Gateway for Lotus Notes Guide. 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 Integration
Description This program provides an internal API used by RightFax .NET applications and services, such as Web Access and the Captaris Sync Module. The Remoting service also provides a statistics API which is used by RightFax services to generate statistics about how often those services start and stop. 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 Guide.
Description 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 Administrators Guide. 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 Administrators Guide.
RightFax WorkServer
Chapter 2
13
14
RightFax Services
The names of all RightFax services begin with the word RightFax so you can 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 Enterprise Fax Manager (described in the RightFax Administrators Guide).
On x64 systems, the LOCAL_MACHINE locations are: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ RightFax z HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ RightFax Client Wherever RightFax features require you to make modifications to the Windows Registry, instructions are provided in the RightFax documentation.
z
Chapter 3
Upgrade Information
You can upgrade to RightFax 10.5 from either: version 10.0 with Service Release 2 or 3 installed version 9.4 with Feature Pack 1 and Service Release 4 installed If you are running an earlier version of RightFax, you must either upgrade to a supported version, or uninstall the RightFax server and perform a new install.
z z
Before upgrading, back up the entire \RightFax folder structure. To get a complete server backup, you must first stop all RightFax services. For information on RightFax backup procedures, see the RightFax Administrators Guide.
Note: RightFax 10.5 only imports the first 21 characters of cover sheet file names from the \FCS folder. File names of imported cover sheets must be unique within the first 21 characters.
For a complete list of fax boards supported by this version, refer to the online list of supported fax boards at the Open Text Knowledge Center at knowledge.opentext.com. 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. After the MSDE to SQL Server 2012 Express upgrade, you may see error messages when attempting to run OSQL backup and restore procedures. These errors are cosmetic and do not cause any loss in functionality. For more information, see Microsoft Knowledge base article 907284.
Any existing files for the RightFax SecureDocs Module or Enterprise Fax Manager Web Edition will be replaced during the upgrade. If you have created customized files for these applications, you must save copies of the customized files before upgrading, and then merge your customizations into the upgraded files. By default, the RightFax Server Module, RPC service, and Queue Handler service are setup to start up automatically. If you have changed the startup type from automatic to manual, Setup will restore the default to automatic during the upgrade. Each service may be reconfigured for manual startup after finishing the upgrade.
Chapter 3
15
16
4. Review the welcome screen and click Next. 5. Carefully read and accept the license agreement and click
Next.
6. The Preview Requirements step lists third-party software
required by your existing features and also lists the status of setup operations. Software that must be installed will have a status of Not Installed. To continue, click Next.
7. If your environment uses remote RightFax servers (e.g., remote
DocTransports, remote WorkServers, remote E-mail Gateways, remote IIS servers, and computers joined to a RightFax shared services environment), you must manually shutdown all running RightFax services on these computers. If you have shutdown all remote RightFax services, or do not use remote RightFax servers, place a check mark in the box next to the text that reads I have shutdown all remote RightFax services. To continue, click Next.
8. RightFax requires TCP ports 10520, 10521, 10062, 34987,
and 34988. Microsoft 2008 and 2008 R2 platforms do not support automated port reservation. If you need to reserve ports to prevent other applications from using them, you must reserve them manually. Click Next.
Note: RightFax uses ports 10520 and 10521 for RPC communication. Third-party programs that use RightFax ports 1052 or 1053 will not work in RightFax 9.4 or later. 9. To apply your upgrade settings and install required third-party
RightFax software, click Next followed by Apply. This step may take several minutes.
11. The third and final phase of Setup guides you through the
Windows Installer 3.1. If this software is not installed on your system, Setup will prompt you to install it. To install, click OK. To cancel Setup and install .NET Framework and Windows Installer 3.1 yourself, click Cancel.
configuration of RightFax settings and will enable your feature set using the Product Licensing Utility. To continue, click Next.
15. To complete Setup, click Apply followed by Finish. Important To complete your upgrade you must run the RightFax Setup on each of your organizations remote RightFax servers (e.g., remote DocTransports, remote WorkServers, remote E-mail Gateways, remote IIS servers, and computers joined to a RightFax shared services environment).
10.5. Before continuing, verify a functional database backup. If your server is joined to a RightFax shared services environment, also verify that all RightFax services and applications on all other computers joined to the environment are stopped and closed. Review the information at the database upgrade screen and check the box next to the text that reads The database has been backed up. To continue, click Next.
13. To launch the Product Licensing Utility (or PLU) and activate
license file.
z
Click Activate to license your RightFax server via the Internet Enter your e-mail address and SUID. When finished, click Continue. Fill-in your information as needed and click Activate. To complete activation, read the license agreement and click Accept. When finished and to return to Setup, click OK. If you are already in possession of a license file and do not need to activate over the Internet, click Import and follow the steps in the Instructions section of the PLU. To complete activation, read the license agreement and click Accept. When finished, close the PLU and click OK to return to setup. To activate your server in the absence of an Internet connection, refer to Activating RightFax components without a RightFax server Internet connection on page 69.
Chapter 3
17
18
Chapter 4
Guide).
5. Set up users and other RightFax database objects using
will be using one or more remote DocTransport computers or will be installing RightFax on a VMware ESX server, you do not need to have fax boards installed in the RightFax server computer. For more information on using remote DocTransport computers, refer to the RightFax Administrators Guide.
2. Install the RightFax server software.
Chapter 4
19
20
Before Installing
RightFax requires that Windows User Account Control (available with Windows Vista and Windows Server 2008) be disabled. See your system documentation for more information.
Note: You cannot run the RightFax installer if any other setup program is currently running. Wait until the other setup program completes before beginning the RightFax installation.
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.
To install RightFax 10.5 1. Log on to the computer using a Windows account that is a
Windows Installer 3.1. If this software is not installed on your system, Setup will prompt you to install it. To install, click OK. To cancel Setup and install .NET Framework and Windows Installer 3.1 yourself, click Cancel.
Note RightFax server software requires.NET. If you dont yet have .NET on your system, RightFax will install it for you. Optionally, you may cancel Setup, install .NET, and re-run RightFax Setup. 4. Review the welcome screen and click Next. 5. Carefully read and accept the license agreement and click
Next.
Typical Server includes all core server components, but does not include fax board and FOIP drivers, RightFax Web Access, and Administrative Utilities. To install fax board drivers, click the box next to Include fax board and FOIP drivers. z Typical Web Server includes the client applications Web Access and the Web Enterprise Fax Manager. For information on installing RightFax Web Applications, see Installing RightFax Web Applications on page 27. z RightFax Exchange Connecter is described in the RightFax Exchange Connector Guide. z Choose Custom to manually choose the components you want to install. After choosing your feature set, click Next.
z
required by your chosen features and also lists the status of setup operations. Software that must be installed will have a status of Must Install. To continue, click Next.
8. If your server does not already have Microsoft Message
Typical installations install to the default Windows program files folder (e.g., C:\Program Files), enables Windows authentication, creates a default instance name (RightFax), and sets the RightFax services to run using the Local System account. z Custom installation has the option to specify the installation folder, authentication method, instance name, and service account and password. For more information on customizing SQL Server Express installs, consult Microsoft Documentation. To continue, Click Next.
z
Queuing installed, Setup will prompt you to install it. Select your option and click Next.
9. Select one of the SQL Server options:
z
and 34988. Microsoft 2008 and 2008 R2 platforms do not support automated port reservation. If you need to reserve ports to prevent other applications from using them, you must reserve them manually. Click Next.
Note: Windows Server 2008 and 2008 r2 have have the windows firewall enabled, which blocks incoming connections on port 10520 and 10521. In order to make client connections (faxutil) work, you must add an exception to the windows firewall. See Adding an Exception to the Windows Firewall on page 25. 3. To apply your settings and install required third-party software,
Install SQL Server Express Edition on this computer. Select this option to install a local instance of SQL Server Express specifically for use with RightFax. To complete this type of setup, see Installing RightFax and SQL Server 2012 Express. Use an existing SQL Server. The performance and reliabaility of the SQL Server are crucial to the operation of the RightFax Product Suite. A standalone SQL Service is strongly recommended for all but the most basic RightFax installations. To complete this type of setup, see Using RightFax with an Existing SQL Server on page 22.
click Apply. This will take several minutes. When finished, click Next.
4. Choose your installation folder and click Next.
Chapter 4
21
22
license file. Click Activate to license your RightFax server via the Internet Enter your e-mail address and SUID. When finished, click Continue. Fill-in your information as needed and click Activate. To complete activation, read the license agreement and click Accept. When finished and to return to Setup, click OK. z If you are already in possession of a license file and do not need to activate over the Internet, click Import and follow the steps in the Instructions section of the PLU. To complete activation, read the license agreement and click Accept. When finished, close the PLU and click OK to return to setup. z To activate your server in the absence of an Internet connection, refer to Activating RightFax components without a RightFax server Internet connection on page 69. Click Close Licensing Utility.
z
Create database Create table Create procedure Create view Create rule Create default
8. To complete Setup, click Apply. 9. When Setup is complete, youll have three options:
z
If the Create database permission is not available to you, a SQL administrator may, in advance of Setup, create an empty database to remove the Create database requirement. This does not, however, eliminate the need for Create table, Create procedure, Create view, Create rule, and Create default permission.
Configure Fax Channels Click this button to go directly to the DocTransport Configuration window and configure Fax Channels. See the RightFax Administrators Guide for more details on this and other configuration options. Configure User Sync Click this button to go directly to the RightFax Sync Module Configuration window and import users. See the RightFax Administrators Guide for more details on this and other configuration options. View Installation Log Click this button to display a log of the installation steps.
as the database name, however, this is not a requirement and custom database names are supported.
2. Assign the database a SQL account that is a member of the
db_datareader and db_datawriter roles and explicitly permitted to Create table, Create procedure, Create view, Create rule, and Create default. This account must be used during Setup, but is not required for or during RightFax production.
Windows account to run RightFax services. This account must be a member of the local administrators group and must have the right to logon as service on the local computer. Click Browse to load and select a user account. Use the Test Account button verify account credentials. When finished, click Next.
Note If you will be accessing files from or printing to Novell queues on a NetWare volume, the service account must also exist in Novell. 8. Choose one of the following database installation options:
and 34988. Microsoft 2008 and 2008 R2 platforms do not support automated port reservation. If you need to reserve ports to prevent other applications from using them, you must reserve them manually. Click Next.
Note: Windows Server 2008 and 2008 r2 have have the Windows firewall enabled, which blocks incoming connections on port 10520 and 10521. In order to make client connections (faxutil) work, you must add an exception to the windows firewall. See Adding an Exception to the Windows Firewall on page 25. 4. To apply your settings and install required third-party software,
Create New RightFax Database Select this option to create a new RightFax database for use with a new RightFax server. This includes the first RightFax server in a RightFax server collective. z Use a Pre-configured Database Select this option to add the RightFax schema and other data to a database created in advance of RightFax Setup. z Add to Shared Services Database Select this option if you have purchased the Shared Services Module and want to add this server to your RightFax server collective. z Assume Ownership Select this option to take ownership of a working RightFax 10.5 database. Typical scenarios for this option included migrating to new server hardware and full system restores. Click Next.
z
click Apply. This will take several minutes. When finished, click Next.
5. Choose your installation folder and click Next. 6. To begin the installation, click Apply. This may take several
Caution If you are assuming ownership of a database that is already in use, you must also migrate the RightFax\Image directory to the new server because the images and library documents are not maintained in the database itself.
Chapter 4
23
24
13. You may activate RightFax using the Internet or using a local
with elevated account permission that Setup can use to execute SQL statements. This account is required only for Setup and is neither saved nor used by RightFax. If necessary, you can click View required permissions to see a list of the SQL statement permissions. You can click the Browse button (...) to display a list of available servers.
Note: If your existing SQL server uses a port number other than the default of 1433, you must specify the port number during Setup. Specify your port in the Server Name field using the following syntax:
license file. Click Activate to license your RightFax server via the Internet Enter your e-mail address and SUID. When finished, click Continue. Fill-in your information as needed and click Activate. To complete activation, read the license agreement and click Accept. When finished and to return to Setup, click OK. z If you are already in possession of a license file and do not need to activate over the Internet, click Import and follow the steps in the Instructions section of the PLU. To complete activation, read the license agreement and click Accept. When finished, close the PLU and click OK to return to setup. z To activate your server in the absence of an Internet connection, refer to Activating RightFax components without a RightFax server Internet connection on page 69. Click Close Licensing Utility.
z
SQLServer,55123 or SQLServer\MyInstance,55123
10. In the same window, accept the default name for the RightFax
create a SQL connection string for RightFax services. You can click View Required Services to display a list of the services this accunt must perform. The service account must have the following permissions:: Select z Update z Insert z Delete z Execute The service account window displays the SQL server information entered in the prior step, but you cant edit it. You can only edit the authentication type, if necessary.
z
14. To complete Setup, click Apply. 15. When Setup is complete, youll have three options:
Configure Fax Channels Click this button to go directly to the DocTransport Configuration window and configure Fax Channels and the optional RightFax Internet Connector. See the RightFax Administrators Guide for more details on this and other configuration options. z Configure User Sync Click this button to go directly to the RightFax Sync Module Configuration window and import users. See the RightFax Administrators Guide for more details on this and other configuration options. z View Installation Log Click this button to display a log of the installation steps. 16. Click Finish to close the RightFax Product Suite Setup.
z
Firewall.
3. Click on Add program. 4. In the Add a program window, browse to c:\program files
RightFax servers are closed or stopped. When ready, click I have shutdown all remote RightFax services and click Next.
6. To shutdown all local RightFax processes, click Next. 7. Click Apply . 8. When Setup is complete, you can click View Installation Log
checked (enabled)
6. Click OK to save the changes.
to display a log of the uninstallation steps. Click Finish to close the RightFax Product Suite Setup.
To verify that the system can now connect, type: "telnet <rfservername> 10520" A flashing curser means the port is now open.
wizard opens.
3. In the list of options, select Uninstall and click Next. The
Chapter 4
25
26
Chapter 5
The information and instructions provided in this chapter assume you have a functional RightFax server that is licensed to use RightFax Web applications. For information on installing RightFax server software, see Installing RightFax Server Software on page 19. To activate RightFax Web applications, see Upgrading and Adding Fax Channels, User Licenses, and Optional Components on page 67. The following RightFax Web applications support Microsoft Internet Information Servers (IIS) version 6.0 SP2 or later, IIS 7, or IIS 7.5
z
RightFax SharePoint Web Service (requires SharePoint). See the RightFax Connector for Microsoft SharePoint Administrators Guide for more information. z RightFax Server Status Dashboard, a browser-based tool for viewing server statistics. RightFax Web applications should not be installed on the same computer as the RightFax server software, even if IIS is installed on the RightFax server. You should install all Web applications on a dedicated IIS server, separate from the RightFax server.
z
z z
RightFax Certified Delivery (requires the RightFax SecureDocs Module). For information on SecureDocs, see the SecureDocs Guide. Enterprise Fax Manager Web Edition. RightFax Web Access, a full-featured browser-based version of FaxUtil. RightFax SOAP Server (requires SOAP client). For information on installing the SOAP client, see Installing RightFax Client Applications on page 33. RightFax Web Client, a browser-based client with basic faxing functionality, compliant with U.S. Section 508 accessibility guidelines.
Certain Multifunction Printer (MFP) device connectors, however, require IIS on the Fax Server for file transfer between the MFP device and the Fax Server. When installing RightFax Web applications, you have the option to allow Setup to configure IIS settings as they relate to RightFax Web applications or you may choose to configure IIS settings yourself. For information on advanced, manual configuration of IIS settings, see Manual setup of Web applications on page 29.
Chapter 5
27
28
z z z
z z
Microsoft .NET Framework * Microsoft Data Access Components Microsoft Internet Explorer (IE) 7 or later Microsoft Internet Information Services (IIS) 6.0 SP2 or later, IIS 7 or IIS 7.5. IIS 6 Management Tools must be installed on Windows Server 2008 Microsoft Visual C++ runtime components* Microsoft Windows Installer 3.1*
follows: WebEFM (Enterprise Fax Manager Web Edition), SecureDocs (RightFax Certified Delivery), RfIpcSoapServer (RightFax SOAP Server), WebUtil (RightFax Web Access), Dashboard (Server Status Dashboard), and WebClient (RightFax Web Client). All RightFax Web sites are set to anonymous authentication. ASP.NET is registered as Web service extension. Active Server Pages, ASP.NET, and ISAPI Extensions are enabled. In IIS 6, this is a global change. In IIS 7 or 7.5, this is a per-site setting. If using IIS 7 or IIS 7.5. Setup will enable these options only at the virtual directory level. ISAPI Extensions are not required by Certified Delivery and will not be enabled during Certified Delivery Setup. IIS directory permissions for each virtual directory are set to Scripts and Executables, Read and Execute and Browse. All RightFax virtual directories are set to use ASP.NET 2.0 or later.
Browser requirements
Pop-up blockers should be disabled on all Internet Explorer clients. Windows User Account Control (available with Windows Vista and Windows Server 2008) must be disabled. Annotating text with RightFax Web Access requires a change to the default Internet Explorer 7 and 8 security settings:
1. Open the IE 7 Internet Properties or IE 8 Internet Options. 2. On the Security tab, click the Internet zone and then click
Custom Level.
3. Under the Miscellaneous section in IE 7 or the Scripting
section in IE 8, select the Allow websites to prompt for information using scripted windows check box.
4. When finished, click OK.
An IIS virtual directory for each Web application is added under the IIS Default Web Site. The default name of each site is as
10. To begin installing RightFax software, click Apply. This may take
several minutes.
11. The third and final phase of Setup guides you through the
wizard.
3. RightFax 10.5 Setup requires Microsoft .NET Framework and
Windows Installer 3.1. If this software is not installed on your system, Setup will prompt you to install it. To install, click OK. To cancel Setup and install .NET Framework and Windows Installer 3.1 yourself, click Cancel.
4. Review the welcome screen and click Next. 5. Carefully read and accept the license agreement and click Next. 6. To install web applications, choose either:
Configure web settings to have Setup configure Microsoft Internet Information Server settings associated with the RightFax web applications you have chosen to install. These settings include the creation of virtual directories, enabling web service extensions, and setting access permissions. z Do not Configure web settings if you want to perform this advanced configuration yourself. Click Next.
z
13. Type the name of your RightFax server and click Next. 14. To complete Setup, click Apply. 15. When Setup is complete, you can click View Installation Log
Typical Web Server to install Web Access and Enterprise Fax Manager Web edition. No other Web Applications are not installed by default. z Custom to create a custom set of Web-based features to install. Click and select the features you want from the displayed list. After choosing your feature set, click Next.
z
to display a log of the uninstallation steps. Click Finish to close the RightFax Product Suite Setup.
Note If Setup fails to apply IIS settings, you must configure Web application settings in IIS. For more information, see the next section.
required by your chosen features and also lists the status of setup operations. Software that must be installed will have a status of Must Install. To continue, click Next.
8. To apply your settings and install required third-party software,
click Apply. This may take several minutes. When finished, click Next.
9. Choose your RightFax installation folder and click Next.
Installing Web Applications on page 29. At step 12, choose Do Not Configure Web Settings.
2. Register ASP.NET as a Web Service Extension.
Chapter 5
29
30
application you have installed. Configure each site with the following attributes: Create a unique site alias. We recommend using the default names of WebEFM (Enterprise Fax Manager Web Edition), SecureDocs (RightFax Certified Delivery), RfIpcSoapServer (RightFax SOAP Server), WebUtil (RightFax Web Access), Dashboard (Server Status Dashboard), and WebClient(RightFax Web Client) z The path to all RightFax Web content is installed during Setup to the \RightFax\WebApps folder. Each application is represented by its own folder, e.g., WebEFM. z Set directory permissions to: Read, Run Scripts, Execute, and Browse. z Set the ASP.NET version for each RightFax virtual directory to version 2.0 or later. 4. Enable Active Server Pages, ASP.NET, and ISAPI Extensions for all RightFax Web sites.
z
z z z z
http://ServerName/WebEFM (Enterprise Fax Manager Web) Edition) http://ServerName/SecureDocs (RightFax Certified Delivery) http://ServerName/WebUtil (RightFax Web Access) http://ServerName/WebClient (RightFax Web Client) http://ServerName/Dashboard (RightFax Server Status Dashboard)
entire Default Web Site, or for the SecureDocs virtual directory which is created when Certified Delivery is installed.
6. Restart the Default Web Site.
Access.
2. Open the web.config file in a text editor and search for the entry
timeout=.
3. Decrease or increase the number in minutes as needed. 4. Save and close the web.config file. 5. In IIS Manager, verify that the DefaultAppPool recycling interval
DefaultAppPool.
2. Click Set Application Pool Defaults. 3. In the (General) section, set Enable 32-Bit Applications to
is equal to or greater than the number of minutes specified in the web.config file. Recycling can also be disabled.
6. If you are using IIS 6, click the Performance tab on the
True.
4. Click OK.
DefaultAppPool Properties dialog box and increase or decrease the Shutdown worker processes after being idle for (time in minutes) value. This option can also be disabled.
3. Browse to
installed.
6. Close Windows registry editor. To add the Web Access URL to the Windows registry in a RightFax Shared Services Environment
If you are using RightFax shared services environment that is advertising its common network name using Microsoft Network Load Balancing or some other IP load balancer, you must create the following registry modifications.
1. Log on to the RightFax server as an administrator. 2. Open the Windows registry editor. 3. Browse to
shown below substituting Server Name with the IIS server where Web Access is installed and RFServer with the advertised network name for the RightFax Server environment. http://ServerName/WebUtil/default.aspx?Action=Show Document({handle})&Server=RFServer.
6. Close Windows registry editor.
Chapter 5
31
32
Configure each user who should receive e-mail notification of a fax with a URL.
1. In Enterprise Fax Manager, double-click a user to edit. The User
modify one or more of the notification messages using the following variables. The maximum length of a notification message is 200 characters, including the URL and the message text. The maximum length of the URL is 80 characters.
Table 5a Defining Custom Messages
Fax Mailbox.
3. On the Notification tab, in the Notification Method box, select
URL Variable Example ~6 You have received a fax; click here to view it ~6 Note: This variable is only available when using WebUtil.
address.
5. To activate email notification of fax status, select one or more of
the check boxes under Notification about outbound faxes or Notification about received faxes. These faxes will be stored only on the RightFax server, and a link to the fax will be included in the notification email.
To configure notification messages to include URLs
Successful send Too many retries Fax number blocked Fax blocked by Do Not Dial
~4 ~9 ~7 ~8
Your fax was sent; click here to view it ~4 Your fax was not sent; click here to view it ~9 Fax abandoned, fax number blocked. Click here to view it ~7 Fax blocked by Do Not Dial restrictions. Click here to view it ~8 Fax to ~1 at ~2 abandoned after ~4 attempts. Click here to view it ~9
You can add a variable that represents the URL of a fax to notification messages.
1. In Enterprise Fax Manager, select the RightFax server to modify. 2. Under Service Name, double-click RightFax Server Module.
Chapter 6
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 33) z RightFax Print Driver (page 34) z SOAP client (page 34) z FaxUtil (page 34) z Outlook Advanced Fax Extensions (page 34) z MAPI Print Driver (page 34) z VIM Print Driver (page 34) The client applications can be installed in the following languages:
z z z z z z z z z z z
Before installing the RightFax client applications to 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 Administrators 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 nearly all of 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 RightFax Web Applications on page 27.
English French French Canadian German Italian Japanese Portuguese Simplified Chinese Spanish Arabic (RightFax Web Access client only)
Chapter 6
33
34
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. SOAP client The SOAP client installation lets RightFax users use the Print-to-Fax feature from any computer with an internet connection. The SOAP server must be installed on an IIS server running RightFax Web Access. The SOAP client then accesses RightFax through that server. This provides RightFax functionality to home-office or other remote employees who do not have direct access to your organizations network. There are two components to the SOAP installation: install the SOAP server on the IIS computer running RightFax Web Access, and then install the SOAP client on the remote client computers. 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). A Web-based version of FaxUtil (RightFax Web Access) 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 RightFax Web Applications on page 27. 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 Connector for Microsoft Exchange Guide. 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. 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 clients computer. MAPI printing is supported only on Windows XP x86 (32-bit) client workstations. 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 clients computer. VIM printing is supported only on Windows XP x86 (32-bit) client workstations.
Microsoft VSTO Tools 4.0 (if using Microsoft Outlook)* Microsoft .NET Framework * Microsoft Visual C++ Runtime Components* * Installed during Setup
Chapter 6
35
36
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.
Note Due to limitations on printer sharing in Windows 2008R2, the firewall service must be running in order to create the HPFAX print driver. It doesnt matter if the firewall is on or off.
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 (x64: HKEY_LOCAL_MACHINE\Software\Wow6432Node\ RightFax\Faxserver). When users run FaxUtil for the first time, they will be automatically configured to disable the loading of users.
Administered users are users that appear in a RightFax administrators or group administrators 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.
To install the RightFax client applications 1. Log on to the computer using a Windows account that is a
14. When Setup is complete, you can click View Installation Log
to display a log of the uninstallation steps. Click Finish to close the RightFax Product Suite Setup.
Note: Depending on the settings you chose, a prompt may appear telling you that you need to reboot your machine to complete the installation.
If this software is not installed on your system, Setup will prompt you to install it. To install, click OK. To cancel Setup and install .NET Framework yourself, click Cancel.
4. Review the welcome screen and click Next. 5. Carefully read and accept the license agreement and click Next. 6. Select the components for this install. A Typical Client includes
FaxUtil, RightFax print driver, and Outlook fax extensions. An Admin Client install Enterprise Fax Manager and FaxUtil. To create a custom set of features to install, click Custom. After choosing your feature set, click Next.
7. The Preview Requirements step lists third-party software
required by your chosen features and also lists the status of setup operations. Software that must be installed will have a status of Must Install. To continue, click Next.
8. To apply your settings and install required third-party software,
click Apply. This may take several minutes. When finished, click Next.
9. Choose your RightFax installation folder and click Next. 10. To begin installing RightFax software, click Apply. This may take
www.MyCompany.SOAPServer.com) and the machine name of the RightFax server when prompted. When finished, click Next.
5. To begin the installation, click Install. A status bar indicates the
several minutes.
11. The third and final phase of Setup guides you through the
Chapter 6
37
38
documents directly to the RightFax Fax Printer (a new printer type that the client installation adds), which prompts for fax addressing information and transmits the document via the RightFax server.
The RightFax print processor installation uses the following msiexec switches:.
Table 1:
Property /i
Description Indicates this is an installation process. Enter the MSI name and path for the installation. Example: In the case of installing the print processor: /i RightFax Print Processor x64.msi Indicates this is an uninstallation process. Enter the MSI name and path for the installation. Example: In the case of uninstalling the print processor: /xRightFax Print Processor x64.msi b - indicates that setup does not prompt the user for information. It does display progress indicators and a completion message at the end of the installation. Example: /qb n - indicates that 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 Example: /qn r - indicates that setup does not prompt the user for information. It does display a completion message at the end of the installation. Example: /qr f - indicates that setup prompts the user for information. It does display progress indicators and a completion message at the end of the installation. Example:/qf
/x
/q
In addition, you can use any of the following custom RightFax actions:
Table 2:
Property INSTALLDIR= Description Specify the path and the folder on the server where the RightFax software will be installed. The value must end with a backslash (\). The default is C:\program files\rightfax\ Example: INSTALLDIR="C:\Program Property /i
Table 3:
Description Indicates this is an installation process. Enter the MSI name and path for the installation. Example: In the case of installing the client: /i RightFax Product Suite Client.msi /x Indicates this is an uninstallation process. Enter the MSI name and path for the installation. Example: In the case of uninstalling the client: /xRightFax Product Suite Client.msi NOTE: The silent uninstall may not completely remove all registry entries associated with the RightFax client.
Files\RightFax\"
RUNFROMSETUP= 1 - indicates that the installation is not run from setup. Example: RUNFROMSETUP=1
To install the print processor on a 64-bit client machine, a typical command line would be: msiexec.exe /i "RightFax Print Processor x64.msi" /qn RUNFROMSETUP=1 INSTALLDIR="C:\Program Files (x86)\RightFax\" Installing the RightFax Client Once youve installed the prerequisite files and (for 64-bit clients only) the print processor, install the RightFax client. The following tables describe the command line options and properties you can use.
Chapter 6
39
40
Table 3:
Property /q Description b - indicates that setup does not prompt the user for information. It does display progress indicators and a completion message at the end of the installation. Example: /qb n - indicates that 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 Example: /qn r - indicates that setup does not prompt the user for information. It does display a completion message at the end of the installation. Example: /qr f - indicates that setup prompts the user for information. It does display progress indicators and a completion message at the end of the installation. Example:/qf Property INSTALLDIR=
Table 4:
Description Specify the path and the folder on the server where the RightFax software will be installed. The value must end with a backslash (\). The default is C:\program files\rightfax\ Example: INSTALLDIR="C:\Program
Files\RightFax\"
REBOOT= Force - Always prompts for a restart at the end of the installation. Example: REBOOT=Force Suppress - prompts for a restart at the end of the installation. Example: REBOOT=Suppress ReallySuppress - Suppress all restarts and restart prompts initiated by ForceReboot during the installation. Example: REBOOT=ReallySupress /log Enter the installation log path and file name. Example: /log "C:\RFInst.log" 2 - indicates that this is launched for a silent installation and that setup.exe was not used for this installation. Example: RUNBYRIGHTFAXSETUP=2 CONFIGUREFAXCTRL= 1 - Specifies MSI to configure and launch faxctrl. 2 - Specifies MSI to remove faxctrl and its printer. Example: CONFIGUREFAXCTRL=1
In addition, you can use any of the following custom RightFax actions:
RUNBYRIGHTFAXSETUP=
Table 4:
Property RFSERVERNAME= Description 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. Example: RFSERVERNAME=<myservername>
Table 4:
Property CONFIGUREFAXUTIL= Description 1 - Specifies MSI to configure and launch faxutil. 2 - Specifies MSI to remove faxutil. Example: CONFIGUREFAXUTIL=1 CONFIGUREOUTLOOKCLIENT= 1 - Specifies MSI to configure and launch the Outlook client. 2 - Specifies MSI to remove the Outlook client. INSTALLVIMPRINTER= 1 - Specifies MSI to install the VIM printer. 2 - Specifies MSI to remove the VIM printer. Note that this parameter is only compatible with Windows XP 32 bit systems. Example: INSTALLVIMPRINTER=1 INSTALLMAPIPRINTER= 1 - Specifies MSI to install the MAPI printer. 2 - Specifies MSI to remove the MAPI printer. Note that this parameter is only compatible with Windows XP 32 bit systems. Example: INSTALLMAPIPRINTER=1 Property ADDLOCAL=
Table 4:
Description Specify which local components to install. Valid options are: FaxUtil FaxCtrl EFM OutlookAdvancedAddin Separate parameters by commas and enclose in quotes. Example: ADDLOCAL="FaxUtil,FaxCtrl,EFM"
Following are examples of common operations that can be performed. Note that these examples wrap to fit on this page. The command line must not include a carriage return. To silent install on a client machine, a typical command line would be: msiexec.exe /i "RightFax Product Suite - Client.msi" /qn /log C:/RFInst.log REBOOT=ReallySuppress RUNBYRIGHTFAXSETUP=2 CONFIGUREFAXCTRL=1 CONFIGUREFAXUTIL=1 CONFIGUREOUTLOOKCLIENT=1 ADDLOCAL="FaxUtil,FaxCtrl,EFM,OutlookAdvancedAd din" INSTALLDIR="C:\Program Files\RightFax" RFSERVERNAME=myservername To silently uninstall on a client machine, a typical command line would be: msiexec.exe /x "RightFax Product Suite - Client.msi" RUNBYRIGHTFAXSETUP=2 CONFIGUREFAXCTRL=2 /log "C:\RFUnInstall.log" /qb
Chapter 6
41
42
A command line to uninstall (not silent) would be: msiexec.exe /x "RightFax Product Suite - Client.msi" RUNBYRIGHTFAXSETUP=2 CONFIGUREFAXCTRL=2 /log "C:\RFUnInstall.log"
HKLM\Software\Microsoft\Windows\CurrentVersion\Uninstall\<fin d component GUIDs for RIghtFax> HKLM\Software\Microsoft\Windows NT\CurrentVersion\Ports\<C:\Documents and Settings\All Users\Application Data\RightFax\SpoolJob> HKLM\Software\Microsoft\Windows NT\CurrentVersion\Print\Printers\RightFax Fax Printer\ HKLM\Software\RightFax Client\ HKLM\System\ControlSet001\Control\Print\Printers\RightFax Fax Printer\ HKLM\System\CurrentControlSet\Control\Print\Printers\RightFax Fax Printer\ HKEY_USERS\*.*\RightFax Fax Printer HKEY_USERS\*.*\RightFax Fax Printer\ HKEY_USERS\*.*\RightFax Client\
1. Log on to the Windows 2008 or 2008 R2 server using an account with administrative access. 2. Install the RightFax client application according to the instructions in the section Installing the Client Applications on page 36. 3. Open Terminal Services RemoteApp Manager. 4. From the Action menu choose Add RemoteApp Programs. The RemoteApp Wizard opens. 5. At the welcome screen, click Next. 6. In the RemoteApps Programs list, click the box next to each RightFax client application you wish to make available over terminal services. When finished, click Next. 7. Review your application settings and click Finish.
Possible solutions Verify that the RightFax Database module and RightFax RPC Server module services are running on the RightFax server.
Chapter 6
43
44
Table 6a
Table 6a
Error or error message The common network protocol being used is not routed between LAN segments
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. z Update the server and clients to use a routed protocol. z 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.
z
Error or error message There is no SAP agent computer accessible to both the client and server machines
Possible solutions Verify that the client and server machines can log on to a NetWare server. Verify that the SAP Agent is installed on the Windows server. z 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 0640 messages.
z
The Windows server running RightFax is not configured to support NetWare clients
Verify that the Windows 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 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 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. The password supplied is incorrect
The NetWare clients are using different frame types than the Windows NT server
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. 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.
Table 6a
Error or error message The RightFax fax addressing dialog box opens, but nothing appears in FaxUtil
Possible solutions 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. z In Windows, the port setting for the fax printer may be incorrect. Complete the Configure Fax Printers dialog box according to the instructions in Configuring Windows 2008 Terminal Services to Support RightFax Client Sessions on page 43.
z
Chapter 6
45
46
Chapter 7
Overview
The capacity of RightFax servers can be multiplied by combining two or more servers that share a common RightFax database (known as a shared services environment). This is accomplished by installing and configuring multiple RightFax servers to share a database and corresponding resource folders. Benefits of the Shared Services Module may include:
z
Server Topology
The following examples describe some basic shared configurations.
Figure 7.1 Two RightFax servers share a SQL database. Common disk storage is used to store shared RightFax resources.
z z
Increased throughput for sending faxes due to internal load sharing among RightFax services. Multiple RightFax servers share all SQL stored data (e.g., users, delegates, phonebook entries, distribution lists, and document data such as fax status). All received faxes are stored on the SQL server and are available to all clients in the network. Redundant data is eliminated thus saving storage space. Remote RightFax services can be shared by multiple machines to balance the workload from many RightFax clients.
Note This feature is only available on RightFax Enterprise Servers and must be purchased separately.
Chapter 7
47
48
Figure 7.2 Two RightFax servers share a SQL database. DocTransport services are located on remote servers to off-load processing from the RightFax servers. Dialing rules specify the DocTransport services and RightFax servers from which documents will be sent. Common disk storage is used to store shared RightFax resources.
Figure 7.3 Two RightFax servers share a SQL database. DocTransport and WorkServer services are located on remote servers to off-load processing from the RightFax servers. Dialing rules specify the DocTransport services and RightFax servers from which documents will be sent. Common disk storage is used to store shared RightFax resources.
Figure 7.4 Two RightFax servers share a SQL database. Common disk storage is used to store shared RightFax resources. An application traffic manager, such as BIG IP, directs RightFax client traffic to available RightFax servers.
System Requirements
The requirements for RightFax Server environments are described beginning on page 5, Hardware and Software Requirements. In addition to these requirements, you must also possess the following:
z
A minimum of two RightFax servers capable of network communication. Each of these must be licensed for the shared services feature. A maximum of four RightFax servers joined to the shared services environment. Each of these must be licensed for the shared services feature. An existing SQL Server. SQL Express installations are not supported. IP v6 environments must use host names to resolve IP addresses. IP v6 IP addresses are not supported. Windows GDI printing is not supported in a shared services environment.
registry key HKEY_LOCAL_MACHINE\ Software\RightFax so that you have a copy of any changes that have been made to customize the system. In a typical shared database configuration, customization should be identical on each RightFax server.
2. Install the RightFax server on the first RightFax server computer
(described in the next section). During the installation, choose the option to Create New RightFax Database.
Chapter 7
49
50
installation. During the installation, choose the option to Add to Shared Services Database and point the install to the SQL database that you defined when you installed the first RightFax server.
4. Repeat steps 1 through 3 for each added RightFax server. 5. Configure your RightFax shared services environment using the
all core server components, but does not include fax board and FOIP drivers, RightFax Web Access, and Administrative Utilities. To install fax board drivers, click the box next to Include fax board and FOIP drivers. To create a custom set of features to install, click Custom. After choosing your feature set, click Next.
Tip If you dont select the install fax board drivers check box, a dialog box appears asking for confirmation. Click Yes to continue. 6. The Preview Requirements step lists third-party software
information provided in this chapter. Additional information about RightFax servers is located in the RightFax Administrators Guide.
Important In a shared services environment, each server must have a DocTransport configured for outbound faxing or have dialing rules that specify a fax be sent from a specific server. For information about dialing rules, see the RightFax Administrators Guide. To install RightFax server software in a shared services environment
required by your chosen features and also lists the status of setup operations. Software that must be installed will have a status of Must Install. To continue, click Next.
7. You must select the option to Use an existing SQL Server.
Select this option to add a RightFax database instance to an existing SQL server running on your network. To continue, click Next.
8. RightFax requires TCP ports 10520, 10521, 10062, 34987,
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.
1. Log on to the computer using a Windows account that is a
and 34988. Microsoft 2008 and 2008 R2 platforms do not support automated port reservation. If you need to reserve ports to prevent other applications from using them, you must reserve them manually. Click Next.
9. To apply your settings and install required third-party software,
wizard.
3. Review the welcome screen and click Next. 4. Carefully read and accept the license agreement and click
click Apply. This will take several minutes. When finished, click Next.
10. Choose your installation folder and click Next. 11. To begin installing RightFax software, click Apply. This may take
Next.
several minutes.
12. The third and final phase of Setup guides you through the
configuration of RightFax settings and will enable your feature set using the Product Licensing Utility (PLU). To continue, click Next.
account must be a member of the local administrators group and must have the right to logon as service on the local computer. Click Browse to load and select a user account. Use the Test Account button to verify account credentials. When finished, click Next.
Note If you will be accessing files from or printing to Novell queues on a NetWare volume, the service account must also exist in Novell. 14. When you are setting up the first RightFax server, choose the
Enter your SQL server name, authentication type, and a service account. If your existing SQL server uses a port number other than the default of 1433, you must specify the port number during Setup. Specify your port in the Server Name field using the following syntax:
For example:
option to Create New RightFax Database. On subsequent installations, choose the option to Add to Shared Services Database and point the install to the SQL database that you defined for the first server. Click Next.
15. Setup must execute SQL write and create statements that
name or type a new name for the RightFax database and click Next. On subsequent installations, the wizard will skip this step.
17. Create a SQL connection string for RightFax services. These
require elevated account permissions. This account is required only for Setup and is neither saved nor used by RightFax. Required SQL statement permissions are as follows:
z z z z z z
Create database Create table Create procedure Create view Create rule Create default
items are critical and should be documented safely and securely. You must have configured a user on the SQL instance whose account RightFax will use to run database services. Enter this account information here. The service account must have the following permissions on all database objects: Select z Update z Insert z Delete z Execute If you are logged in as that user, choose Windows Authentication and enter the user name and password for the account RightFax will use in its connection string. Use the Text Connection button to verify the connection. When finished, click Next.
z
Chapter 7
51
52
19. Click Activate to license your RightFax server via the Internet
provided below. Image (contains sent and received faxes stored as compressed graphic image files). z SIG (contains graphic images of user signatures for placement on faxes). z Papers (contains the names of overlay form files). z FCS (contains fax cover sheets). z Outgoing (contains outbound files from all submission methods that are held while being processed into fax images, such as temporary fax queue spool files). z BFT (contains text files created by the OCR process). z CmdData (contains transaction files for each fax sent via e-mail or via SecureDocs). Each of these folders can be located in common disk storage, such as a storage area network (SAN), network-attached device (NAS), network share on file server, or network access to a local drive on one of the RightFax servers. The folders must be accessible to all the servers in the shared configuration.
z
(see the next paragraph to activate with an existing license file). Enter your e-mail address and SUID. When finished, click Activate. It may take a minute or two to display the license agreement. To complete activation, read the license agreement and click Accept. When finished and to return to Setup, click OK. Click Close to close the PLU. If you already have a license file and do not need to activate over the Internet, click Import and follow the steps in the Instructions section of the PLU. To complete activation, read the license agreement and click Accept. When finished, OK to return to close the dialog box and click Close to close the PLU.
20. To complete Setup, click Apply. Completing the Setup may take
a minute or two. When the splash screen indicates the Setup is complete, click Close.
Access to these locations can be expressed differently for each server due to permissions and network layout. Each server can be configured to use unique paths and user accounts to gain access to each storage location.
For Example: Server A may access a local storage area network
(SAN) using the path S:\RightFax\Image and use the local system account for RightFax services to access this path. Server B might access the same location remotely using the path \\ServerA\RightFax\Image which would require use of an account that had permissions to access that network path (such as, DomainA\RightFax).
remote, DocTransport modules should be discrete and should not be shared. A remote DocTransport module can connect to one RightFax server. It cannot access multiple RightFax servers. For information about installing and configuring Remote DocTransports see the RightFax Administrators Guide. A remote WorkServer can connect to one RightFax server. It cannot access multiple RightFax servers. Refer to Figure 7.2 on page 48 for a basic illustration of remote services.
Chapter 7
53
54
The purging process removes documents from the SQL database that are both marked for deletion and have reached the configured limit. The purging process deletes the corresponding image files that are stored in the Image directories on the RightFax servers in the shared configuration. One event triggers the aging and purging process.
Orphan Scanning
The orphan process scans the \RightFax\Image directories on the RightFax servers for fax image files that are not referenced by any document or library document in the SQL database. The image files are called orphans because RightFax has no record of their existence and cannot access them. To manually delete orphan image files from the RightFax server, use the Orphan.exe utility.
Recovery
The RightFax 10.5 event queue is stored in the SQL database on the SQL server, and it is shared among RightFax servers. The queue is persistent, that is, it retains its objects and values if the RightFax Server module stops. If one of the RightFax Server modules in the shared configuration stops, then it is not necessary to rebuild the queue. The recovery process is performed daily on the RightFax servers as a fail safe.
Chapter 8
Caution Because the RightFax server software architecture is not fully cluster-aware with replayable transaction logs, some in-process data may be lost during a cluster failover. If failover occurs, faxes that were in-process may fail conversion, may have fax conversion delayed, or may be lost and unrecoverable.
Ensure that both servers pass the Microsoft Cluster Validation tests.
These instructions describe how to install RightFax 10.5 on an existing Microsoft Windows 2008 R2 Server cluster. This is not meant as a general guide on clustering concepts, configuration, operation, or support. You must be familiar with clustering concepts and the Windows 2008 R2 Cluster service before beginning this procedure.
System requirements
Microsoft Windows Server 2008 R2 Enterprise clusters are supported only on RightFax 10.5 with Feature Pack 1.
SQL Server
Install a local or remote SQL Server 2005, 2008, or 2012. SQL Server Standard Edition cannot be installed on a RightFax cluster. Set the SQL server to Mixed Mode, with SQL authentication enabled.
Important If SQL Server is installed on the same cluster, add the RightFax resources to the same cluster group that contains the SQL instance. For each RightFax resource, create a dependency upon the SQL instance. This will prevent the RightFax services from attempting to start if the SQL instance is unavailable.
Cluster Servers
Before you install RightFax in a Windows Server 2008 R2 cluster environment, configure two servers with the following components:
z z
Windows Cluster service. Windows Application Server role with Distributed Transaction Coordinator (MSDTC) and Message Queuing (MSMQ) installed.
Chapter 8
55
56
In these instructions, the name RightFax group means the network name of the cluster group containing the RightFax resources.
Figure 8.1 Failover Cluster Manager
Optional Components
If your organization uses the optional RightFax Integration Module, install Print Services for Unix. For more information, see Configuring the Integration Module in a Windows 2008 R2 Cluster on page 62.
Configuring the MSMQ cluster resource Configuring the MSDTC cluster resource. Installing the RightFax server software on each node. Configuring RightFax services to be cluster resources Configuring the print spooler, HPFAX, and TCP/IP print server Providing the cluster name to the RightFax services Installing the remote DocTransports Creating the MSMQ queues
To create cluster resources for required networking services 1. Run Failover Cluster Manager and right-click Services and
To verify failover and failback 1. In Failover Cluster Manager, right-click the RightFax group and
then click Properties. Confirm that the primary node is the Preferred Owner.
2. Click the Failover tab, select the Allow for failback
click Next.
3. On the Select Service or Application page, select Message
group. Client software will use this name to access the cluster. Click Next.
5. On the Select Storage page, select the storage device where
group, click Add a Resource, and then click Add Distributed Transaction Coordinator.
8. Double-click the MSDTC resource. 9. On the Dependencies tab, select the disk drive resource and
running RightFax services. Set the Startup type of all RightFax services to Manual.
3. In Control Panel, open Printers. 4. Right-click the HPFAX printer and then click Stop sharing. 5. In Failover Cluster Manager, right-click the RightFax group and
Chapter 8
57
58
To create the File Share resource 1. In Failover Cluster Manager, right-click the RightFax group and
software on the shared drive. Use the same options you used on the primary node.
2. When asked whether to overwrite the existing database or add
running RightFax services. Set the Startup type of all RightFax services to Manual.
4. In Control Panel, open Printers. 5. Right-click the HPFAX printer and then click Stop sharing.
browse to the folder on the shared drive where RightFax was installed and click Next.
3. Set the appropriate NTFS permissions for the file share. 4. in the Share Name box, type RightFax. 5. Set the appropriate SMB Share Permissions 6. Finish the wizard by following the prompts.
To create the RightFax RPC Server Module resource 1. In Failover Cluster Manager, right-click the RightFax group, click
RightFax File Share RightFax RPC Server Module RightFax Remoting Service RightFax DocTransport RightFax Server Module RightFax Queue Handler RightFax Sync Module RightFax Conversion Engine RightFax Paging Module HPFAX Print Queue RightFax E-mail Gateway, If your organization uses an optional E-mail Gateway module. TCP/IP Print Server, if your organization uses the RightFax Integration Module. See Configuring the Integration Module in a Windows 2008 R2 Cluster on page 62.
resource, network name, and IP address. If you are clustering your SQL Server, you must also add the SQL server name as a dependency.
6. On the Registry Replication tab, click Add and type
SOFTWARE\Wow6432Node\RightFax. This allows the registry information stored by RightFax to dynamically change from one node to another in the event of a failure.
7. To add the resource to the group, click OK.
To create the RightFax Remoting Service resource 1. In Control Panel, open RightFax Remoting Service. In the
To create the RightFax Server Module resource 1. In Failover Cluster Manager, right-click the RightFax group and
RightFax Remoting Configuration window, click OK to write service information to the Windows registry.
1. In Failover Cluster Manager, right-click the RightFax group, click
(RFRPC).
6. On the General tab, select the Use Network Name for
(RFRPC).
6. On the General tab, select the Use Network Name for
Chapter 8
59
60
To create the RightFax Sync Module resource 1. In Control Panel, open RightFax Sync Module. In the RightFax
8. Click OK. To create the RightFax Paging Module resource 1. In Failover Cluster Manager, right-click the RightFax group and
Sync Module Configuration window, define sources and destinations as required. For more information about the RightFax Sync Module, see the RightFax Administrators Guide.
2. In Failover Cluster Manager, right-click the RightFax group and
RightFax Conversion Engine Configuration window, click OK to write the service information to the Windows registry.
2. In Failover Cluster Manager, right-click the RightFax group and
click Next.
3. On the Select Service or Application page, select Print Server,
software will use to print to the HPFAX queue (the name of the print server resource), then click Next.
5. On the Select Storage page, select the storage device that will
8. Under Actions, click Add Printer. 9. Click Add a TCP/IP or Web Services Printer by IP Address or
(RFSERVER).
6. On the General tab, select the Use Network Name for
the cluster.
16. In the Protocol list, select RAW. 17. in the Port Number box, enter 53199. 18. Click Install a new Driver and select HP LaserJet 4250 PCL6. 19. In the Printer Name box, type HPFAX. 20. Select the Share Printer check box. Share the printer as
HPFAX.
21. Click OK. 22. After the printer is installed, right-click the printer and then click
HKLM\SOFTWARE\Wow6432Node\RightFax\Capasync\. Change the RemoteHost value to the name of the RightFax group.
4. Browse to
Properties.
23. On the Advanced tab, click Separator Page. 24. In the separator page box, type:
<SharedDrive>:\RightFax\bin\SepFiles\RightFax.sep Where <SharedDrive> is the drive letter of the shared drive where RightFax is installed.
25. Click OK to close the Separator Page window. 26. Click OK to close the Properties window. To create the RightFax E-mail Gateway resource
HKLM\SOFTWARE\Wow6432Node\RightFax\Capasync\Profi les\<GUID> (the GUID subkey is a unique, 32 character name that is associated with Sync Module profiles). Change the RemoteHost value to the cluster name of the RightFax group.
5. Browse to
HKLM\SOFTWARE\Wow6432Node\RightFax\Install\. Change the value RFServerName to the name of the RightFax group.
6. Browse to
HKLM\SOFTWARE\Wow6432Node\RightFax\Remoting. Change the RemoteHost value to the name of the RightFax group.
Chapter 8
61
62
resources start correctly on each node. Correct any issues before proceeding.
Setting the RightFax Group as the MSMQ Server To set the RightFax group as the MSMQ server:
1. On each node, open the Server Module configuration in
the option to use an existing SQL Server, and enter the server name (clustered instance name if applicable) and credentials.
4. After installation, on the Remote DocTransport server, open the
Integration.
Note If RightFax Integration does not appear in Control Panel, locate the Shared Files folder in the RightFax folder, and open rfprod_ctl.cpl. 2. Click Integration Setup Wizard to configure the Integration
Private Queue.
4. In the Queue Name box, type faxserver_sendfax and click
Module with the setup wizard, or configure the Integration Module manually. For detailed instructions, see the RightFax Integration Module Guide.
3. Click General in the left pane. Under RightFax information, in
OK.
the Server name box, enter the name of the RightFax group.
HKLM\SOFTWARE\Wow6432Node\RightFax\Production\. Change the RightFaxServerName value to the name of the RightFax group.
6. Browse to HKLM\SOFTWARE\Wow6432Node\RightFax\
Integration. Use the same options you used on the primary node.
13. Click OK to create the service. 14. Verify that the Startup Type of the RightFax Integration Module
Production\RFProd. The three default printer inputs are represented by the NPListen1, NPListen2, and NPListen3 subkeys.
7. In each subkey, modify the command line to use TCP/IP ports
rather than named pipes by using the table below. Named pipes will not function in the cluster environment. The numbers at the end of the new command lines are the TCP/IP port numbers. If the suggested ports are in use, you can enter any port number that is available on both nodes of the cluster.
Table 8a
If your organization uses the the RightFax Integration Module, add a TCP/IP Print Server resource.
1. On both nodes, install Print Services for Unix. For information
about installing Print Services for Unix on Windows 2008 R2, see Microsoft documentation.
2. On both nodes, stop the LPD service (Print Services for Unix)
Chapter 8
63
64
Configuring Integration Module Printers 1. From either node, in Failover Cluster Manager, right-click the
12. Click Install a new Driver and select one of the following:
z z z
Print Server resource, and then click Manage Printers. Repeat the following steps to create three printers, a generic printer, a PCL printer, and a PostScript printer:
2. Under Actions, click Add Printer. 3. Click Add a TCP/IP or Web Services Printer by IP Address
Generic/Text Only for the generic printer. HP LaserJet 4250 PCL6 driver for the PCL printer. A PostScript driver for the PostScript printer. HostFax for the generic printer. HFPCL for the PCL printer. HFPS for the PostScript printer. HostFax for the generic printer. HFPCL for the PCL printer. HFPS for the PostScript printer.
14. Select the Share Printer check box. Share the printer as:
z z z
HostFax for the generic printer. HFPCL for the PCL printer. HFPS for the PostScript printer.
7. Click Custom. 8. In the Port Name box, type one of the following:
z z z
HPFAX for the generic printer. HFPCL for the PCL printer. HFPS for the PostScript printer.
To use FTP with the Integration Module, add a virtual directory to each node by using IIS Manager. Set the local path to the \RightFax\Production\Inbox folder on the shared drive. You do not need to cluster the FTP service.
the cluster.
10. In the Protocol list, select RAW. 11. in the Port Number box, enter one of the following:
z z z
8201 for the generic printer. 8202 for the PCL printer. 8203 for the PostScript printer.
If the suggested ports are in use, be sure that the port numbers match the port numbers in the command lines in Table 8a:
WorkServers.
6. From Failover Cluster Manager, bring the RightFax services
online.
Chapter 8
65
66
Chapter 9
Upgrading and Adding Fax Channels, User Licenses, and Optional Components
You can easily expand and extend the functionality of your RightFax server by upgrading your RightFax server license, adding fax channels and user licenses, or by enabling new components. 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 the Product Licensing Utility, which is included with the server installation of RightFax.
To check for installed components 1. Log on the RightFax server as an administrator. 2. Click Start > All Programs > OpenText > Product Licensing
Chapter 9
Upgrading and Adding Fax Channels, User Licenses, and Optional Components
67
68
To upgrade the RightFax server license, add channels, add user licenses, and enable new components
The following steps require an Internet connection on the RightFax server. If your RightFax server is not connected to the Internet, follow the instructions in the next section, Activating RightFax components without a RightFax server Internet connection.
1. Contact your RightFax distributor and purchase the appropriate
Description This RightFax server supports unlimited user accounts, It includes one fax channel, and is expandable to 30 fax channels. 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 Access 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.
license. You will be sent a new license card that includes a new SUID (required for activation).
2. Log on to the RightFax server as an administrator. 3. Click Start > All Programs > OpenText > Product Licensing
Enterprise server
Activate.
8. If activation is successful, the RightFax license agreement will
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.
If you experience problems with activation, call the RightFax product support group at (520) 320-7070.
Satellite server
This RightFax server supports up to 15 user accounts. It includes two WorkServers and two fax channels.
11. To process your license and generate a license file, click Finish.
If your RightFax server is without Internet access, you may use another computer with Internet access to assist with activation. Requirements for this process are: Computer with Internet access z Network access to the RightFax server or access to a removable storage medium such as a compact disc or compact flash drive. 1. Contact your RightFax distributor and purchase the appropriate license. You will be sent a new license card that includes a new SUID (required for activation).
z
If successful, click the Download License Activation File link. Save this file (RightFax.XML) to a removable storage medium or otherwise make it available to the RightFax server. When finished, close the Web browser and return to the RightFax server.
12. On the PLU toolbar, click Import. Use the button next to the
License File field at the bottom of the PLU to browse to the location of the RightFax.XML file. When finished, click OK. When prompted to overwrite your existing license, click the option to Backup existing license and click Yes.
13. Review your new license summary. When finished, click Close.
2. Log on to the RightFax server as an administrator. 3. Click Start > All Programs > OpenText > Product Licensing
If you experience problems with activation, call the RightFax product support group at (520) 320-7070.
Activation String.
6. Take the activation string to another computer with Internet
activation string.
8. Click the drop-down arrow and pick RightFax from the product
Opening the Brooktrout License Manager From RightFax Enterprise Fax Manager:
1. Stop the RightFax DocTransport Module. 2. Open the RightFax DocTransport Module applet. 3. Expand the Brooktrout item in the left-hand side of the applet.
click Next.
Chapter 9
Upgrading and Adding Fax Channels, User Licenses, and Optional Components
69
70
4. Click SR140. 5. Click the Configure Brooktrout button in the right-hand side of
3. Choose your preferred method for activation, and click Next. 4. If you choose to activate Automatically or via Email/Fax, you are
prompted to enter all purchased license keys. Use the Add button to enter your new License Keys.
5. Follow the remainder of the Wizard to complete activation. 6. At completion of the process, your new licenses should show in
with the Brooktrout License Manager. For quick access to the Help, click the ? located on the license manager toolbar.
the main Brooktrout License Manager window, along with existing licenses. Migrating SR140 Licensing to a New System To activate Dialogic SR140 Feature Pack or Upgrade licenses on a new system in conjunction with moving existing SR140 licensing to the new system from another server, you must re-host the license files on the new server by returning the old license and obtaining a new license. If you have already activated the new Dialogic SR140 Feature Pack or Upgrade licenses on another system, you will also need to re-host those licenses for the new server using the same process. Copy existing licensing information using one of the following methods:
z
You will need the license key provided to you upon ordering the Feature Pack or Upgrade licensing. You should not remove your original license when you get an upgrade license. For example, if you have a R1 SR140 existing license and you get an R3 upgrade SR140 license, use your upgrade license in conjunction with your existing license so that the combined SR140 installation has all features that come with a R3 SR140. To activate SR140 R3 Feature Pack or Upgrade licenses on a system with no existing SR140 licensing, you must first activate your original SR140 licenses on the system. Refer to the RightFax Administrators Guide or RightFax Installation Guide contained in your product documentation. These documents are also available online under the Open Text Knowledge Center.
On the existing server, run the Brooktrout License Manager. z Highlight the SR140 license that you want to move, then select Display Node Lock from the Utilities menu. z Copy the information displayed. Refer to the contents of the SR140 license (*.LIC) file. z License files are located in the path specified by the BRKTD_LICENSE_FILE environment variable. It is easily accessible by entering %BRKTD_LICENSE_FILE% in the Start > Run menu under windows. The file is typically located in C:\Program Files\Common Files\Brooktrout. z Open the file in Notepad to view the contents.
in the Dialogic Brooktrout Fax Products Windows End User Guide (www.dialogic.com/webhelp/Brooktrout/SDK63/WindowsE ndUserGuide.pdf) or the he online Help shipped with the Brooktrout License Manager. For quick access to the Help, click the ? located on the license manager toolbar.
Chapter 9
Upgrading and Adding Fax Channels, User Licenses, and Optional Components
71
72
Index
A
an 22 ASCII code pages 8
E
e-mail notifications 32 error messages common network protocol being used is not routed between LAN segments 44 NetWare clients are using different frame types than the Windows NT server 44 no SAP agent computer accessible to both the client and server machines 44 password supplied is incorrect 44 server is unavailable 43 user ID was not found in database 44 Windows NT server running RightFax is not configured to support NetWare clients 44
I
installing client applications in Windows Terminal Server 43
B
browser requirements 28
K
Knowledge Center 5
C
character set support 8 Citrix MetaFrame 43 client applications 14 client applications troubleshooting installation 43 Windows Terminal Server installation Configuration Web Delivery 31 configuration e-mail notifications 32 list of programs 12 custom message variables 32
L
Loop-start phone lines 10
M
MetaFrame, Citrix 43 Microsoft SQL server 7
43
F
fax board requirements 9 Fax Server requirements 5 FaxUtil Legacy Support 9
N
notifications custom messages 32 e-mail 32 including URL 32
D
database character set 8 Direct Inward Dial (DID) requirements 10
H
hardware requirements 6
O
operating systems 5
73
74
P
phone line requirements 9 prerequisites Windows Server 2008 R2 20
T
timeout 30 troubleshooting client installation 43
R
registry entries locations 14 WebClientServer 31 WebLinkURL 31 requirements browser 28 Direct Inward Dial (DID) fax boards 9 Fax Server 5 hardware 6 IIS server 28 phone lines 9 server 6 SQL 7
U
uninstalling server 25 upgrade basics 15 steps 16 URL 30 in notifications
10
32
V
variables in custom messages 32 virtualization support 9
S
server configuration programs 12 IIS 28 requirements 6 SQL 7 uninstalling 25 Server, Windows Terminal 43 Session Timeout 30 shared services web access 31 SQL 21 requirements 7 supported server versions 7 supported character set 8 legacy FaxUtil 9
W
web access configuring 31 in shared services 31 web applications installation 29 manual setup 29 WebClientServer registry entry 31 WebLinkURL registry entry 31 Windows Server 2008 R2 20 Windows Terminal Server 43