Email Integration for Open Text Fax Appliance and Open Text Fax Appliance, Premier Edition Open Text Fax and Document Distribution Group October 2009
2 White Paper Contents Introduction...3 Who Should Read This Document?...3 Which Email Gateway Is Best For You?...4 Microsoft Exchange and Outlook environments...4 Integrating Microsoft Outlook with Open Text fax servers: Open Text s Outlook direct...14 IBM Lotus Notes environments...18 Novell GroupWise email environments...21 SMTP-compatible email environments...29
3 White Paper Introduction Open Text s email gateways provide a variety of fax and email integration options for both the Open Text Fax Appliance, FaxPress Edition and Open Text Fax Appliance, Premier Edition product lines. Serving as a link between the Open Text fax server and your network's mail server, the gateways allow fax messages to be sent and received as easily as email, right from the user s mail client. Open Text s email gateways provide email integration solutions for most email environments, including Microsoft Exchange and Outlook, Lotus Notes and Novell GroupWise, as well as most Simple Mail Transfer Protocol (SMTP)- compliant mail systems. Open Text s email integration solutions are standard, nocharge features for the Fax Appliance and Premier Fax Appliance product lines. With the email gateways, familiar email commands are used to create, address, and send faxes, making fax messaging as simple as emailing. Attachments are rendered into fax file format for most applications, allowing attached files to be sent to fax and email recipients simultaneously. The email gateways fax features are available to both local and offsite Fax Appliance and Premier Fax Appliance users. All Fax Appliance email gateways can also be configured for automatic inbound fax routing or fax notification via email. Who Should Read This Document? Network Administrators, IT Managers, Systems Integrators and consultants who will be implementing Fax Appliance or Premier Fax Appliance in a Microsoft Exchange server environment should read this document.
4 White Paper Which Email Gateway Is Best For You? The email gateway you decide to implement will depend on your email environment and requirements, the number of users on your network, and whether you prefer a server-side or client-side solution. Both the Fax Appliance and Premier Fax Appliance product lines provide reliable and efficient serverbased email integration solutions for fax-enabling Microsoft Exchange, Microsoft Outlook, IBM Lotus Notes, Novell GroupWise, and other SMTP-based mail systems. Open Text s Outlook direct provides a client-side email integration option for Microsoft Exchange and Outlook environments. Microsoft Exchange and Outlook environments The Fax Appliance and Premier Fax Appliance provide both server-based and client-based email integration options for Microsoft Exchange and Outlook environments. The server-based option, the Exchange connector and email gateway, is a two-part solution provided on the Fax Appliance or Premier Fax Appliance product CD. The client-based option, Outlook direct, is also provided on the product CD and, as a service added to the user s Outlook email profile, does not require an Exchange server. Server-side vs. client-side email integration solutions For enterprises running an Exchange server with a large number of users, the server-based Exchange connector and email gateway email integration solution is ideal. The Exchange connector and email gateway option is also ideal for remote, dial-up, or Virtual Private Network (VPN) connections. The Exchange connector/email gateway requires one-time deployment on the server side only, and consequently is ideal for large enterprises where client installations on individual workstations are inconvenient. For smaller environments without an Exchange server and for environments whose users do not require remote, dial-up, or VPN connections, the client-based Outlook direct is ideal. For information on Outlook direct, please refer to this white paper s Integrating Microsoft Outlook with Open Text s Fax Servers section. Integrating Exchange with Open Text Fax Servers: Open Text s Exchange connector and email gateway Both the Fax Appliance and Premier Fax Appliance product lines provide a reliable and efficient server-based email integration solution for fax-enabling Microsoft Exchange. The Exchange connector and email gateway for Fax Appliance and Premier Fax Appliance enable inbound and outbound faxing through Exchange, as well as synchronizing of fax server and Exchange user databases. Offering quick and convenient server-side network faxing deployment with no client software to install, these email integration options are especially
5 White Paper well suited to enterprise Exchange server environments with a large number of users. With the Exchange connector and email gateway, familiar email commands are used to create, address, and send faxes, making fax messaging as simple as sending an email. Attachments are rendered into fax file format for most applications, allowing attached files to be sent to fax and email recipients simultaneously. The Exchange connector and email gateway s fax features are available to both local and offsite Fax Appliance and Premier Fax Appliance users. Open Text s Fax Appliance and Premier Fax Appliance fax forms for Exchange provide further simplified fax messaging, integrating custom fax interfaces into the existing Outlook client. The Exchange connector and email gateway are similar in operation, although the implementation is different. Both solutions consist of a connector and a gateway. In both the Fax Appliance and the Premier Fax Appliance, the Exchange connector implementation is the same: the connector is installed from the product CD and run on the Exchange server. The email gateway implementation, however, is specific to each product line. With the Premier Fax Appliance, the email gateway is an embedded service that is enabled and run on the Premier Fax Appliance server. With the Fax Appliance, the email gateway is service software installed from the Fax Appliance 8.x CD and run as a service on a network workstation. Open Text s email integration solutions for Microsoft Exchange are standard features for the Fax Appliance and Premier Fax Appliance product lines. Premier Fax Appliance and the Exchange connector and email gateway Premier Fax Appliance email integration for Microsoft Exchange is a two-part solution consisting of a connector that runs on the Exchange server, and an embedded gateway that runs as a service on the Premier Fax Appliance server. The Premier Fax Appliance s Exchange connector and embedded email gateway work together to enable the Premier Fax Appliance s integration with your Exchange server. The Premier Fax Appliance Exchange connector, installed from the Premier Fax Application 3.x CD onto the Exchange server, acts as a message transport agent between the Exchange server and the email gateway, scanning the Exchange server and forwarding all fax messages to the email gateway. The connector also provides fax-addressing templates for Exchange users. The connector consists of a service and a connector object, allowing administration of the Exchange connector itself and the gateway through the Exchange server administration utility, Exchange manager. The Exchange connector supports Exchange 5.5 in a Windows NT or Windows 2000/2003 environment, or on Exchange 2000/2003 in mixed or native mode. The Exchange connector may also be installed in an Exchange 2000 cluster server environment. The Exchange connector can also read a user list
6 White Paper from NT/Win200 server or Active Directory and synchronize it with Premier Fax Appliance. Once installed from the Premier Fax Appliance 3.x CD, the Premier Fax Appliance Exchange connector is configured to use either the Microsoft Exchange Connector Using SMTP option or the Microsoft Exchange Connector Using MAPI option of the Premier Fax Appliance s embedded email gateway service. Both options enable inbound and outbound faxing through Exchange, synchronizing of the Premier Fax Appliance and Exchange user databases, and use of the global address book for faxing. The only difference between the two Exchange connector options is in the kinds of fax forms available to users. The Exchange Connector Using MAPI option provides both the FaxPress_Send form and the FaxPress_View form. The Exchange Connector Using SMTP option provides the FaxPress_Send form only. (See Fax Forms for more information on forms.) The Premier Fax Appliance email gateway service converts attached files to faxable images by invoking a background printing of attachments. Easily enabled from the Premier Fax Appliance s embedded services folder, the Premier Fax Appliance s email gateway converts your fax messages attached files to faxable format, then passes them to the Premier Fax Appliance server s outgoing queue for processing. The gateway relieves the Exchange server of the resourceconsuming processes involved in converting document attachments to faxable format, off-loading the processor-intensive job of this file conversion, which, if run on the Exchange server, might compromise performance. The gateway opens the file in its native application, then prints to a.tiff file, a format the Premier Fax Appliance can process and fax. The gateway uses Microsoft s Object Linking and Embedding (OLE) method in the conversion of document attachments to faxable format. OLE requires that all applications associated with your Exchange users file attachments be installed on the Premier Fax Appliance. Examples include Microsoft Office, Lotus Smart Suite, etc. To prevent failed file attachments, software application versions should be consistent across the network. The following illustration shows how the Premier Fax Appliance s Exchange connector passes attachments to the email gateway, which processes the messages for the Exchange server, then passes them on to the Premier Fax Appliance server..
7 White Paper Figure 1: Network with Premier Fax Appliance, Exchange connector, and embedded email gateway. Administering the Premier Fax Appliance Exchange connector and email gateway The Premier Fax Appliance Exchange connector and email gateway provide convenient centralized user management and administration through the Exchange 5.5 or Exchange 2000 administration utilities. The Exchange connector administration utility is accessible from the Exchange manager utility.
8 White Paper Figure 2: The Exchange administration utility. The Premier Fax Appliance s email gateway is started, stopped, and configured from the embedded services folder on the Premier Fax Appliance. Figure 3: The Premier Fax Appliance s email start, stop, and configure tool. The Premier Fax Appliance s email gateway configuration utility, accessed from the embedded services folder, is used to configure and administer the gateway. The windows-based configuration utility provides an efficient, centralized way to manage your network s fax messaging; allowing you to register the Premier Fax Appliance server for use with the Exchange connector, configure incoming and outgoing fax transmission parameters, and map the Exchange email database to the Premier Fax Appliance user database, enabling integration of the two databases. The configuration utility also includes ways to enable or disable access to the Premier Fax Appliance server, set up load sharing, enable trace files, and test communication status.
9 White Paper Figure 4: The Premier Fax Appliance s email gateway configuration utility. Fax Appliance and the Exchange connector and email gateway Fax Appliance email integration for Microsoft Exchange is a two-part solution consisting of a connector that runs on the Exchange server and a gateway that runs as a service on a network workstation. The Fax Appliance Exchange connector and email gateway work together to enable the Fax Appliance server s integration with your Exchange server. The Fax Appliance Exchange connector, installed from the Fax Appliance 8.x CD onto the Exchange server, acts as a message transport agent between the Exchange server and the email gateway, provides fax-addressing templates for Exchange users, and enables use of Exchange administrative tools and the global address book for faxing. The Exchange connector scans the messages on the Exchange server and forwards all of the fax messages found to the email gateway. The connector consists of a service and a connector object, allowing administration of the Fax Appliance Exchange connector itself and the email gateway through the Exchange server administration utility, Exchange manager. The Exchange connector can be installed on Exchange 5.5 in a Windows NT or Windows 2000 environment, or on Exchange 2000 in mixed or native mode. With Fax Appliance 7.0, the Exchange connector may also be installed in an Exchange 2000 cluster server environment. Exchange connector can also read a user list from NT/Win200 server or Active Directory and synchronize it with Fax Appliance. Once installed from the Fax Appliance 8.x CD, the Fax Appliance Exchange connector is configured to use either the Microsoft Exchange Connector Using SMTP option or the Microsoft Exchange Connector Using MAPI option of the Fax Application s embedded email gateway service. Both options enable inbound and outbound faxing through Exchange, synchronizing of the Fax Appliance and
10 White Paper Exchange user databases, and use of the global address book for faxing. The only difference between the two Exchange connector options is in the kinds of fax forms available to users. The Exchange Connector Using MAPI option provides both the FaxPress_Send form and the FaxPress_View form. The Exchange Connector Using SMTP option provides the FaxPress_Send form only. (See Fax Forms for more information on forms.) The Fax Appliance email gateway, installed from the Fax Appliance 8.x CD onto a network workstation, is a service designed to run on Windows XP, Windows NT workstation or server, or Windows 2000 server or professional edition. The gateway converts attached files to faxable images by invoking a background printing of attachments. The gateway relieves the Exchange server of the resource-consuming processes involved in converting document attachments to faxable format. The email gateway runs on a separate workstation specifically to off-load the processor-intensive job of this file conversion, which, run on the Exchange server, might compromise performance. The gateway opens the file in its native application, then prints to a.tiff file, a format the Fax Appliance can process and fax. The gateway uses Microsoft s OLE method in the conversion of document attachments to faxable format. OLE requires that all applications associated with your Exchange users file attachments be installed on the Fax Appliance. Examples include Microsoft Office, Lotus Smart Suite, etc. To prevent failed file attachments, software application versions should be consistent across the network. The following illustration shows how the Fax Appliance Exchange connector passes attachments to the email gateway, which processes the messages for the Exchange server, then passes them on to the Fax Appliance server.
11 White Paper Figure 5: Network with Premier Fax Appliance, Exchange connector, and email gateway. The Fax Appliance Exchange connector and email gateway provide convenient centralized user management and administration through the Exchange 5.5 or Exchange 2000 administration utilities. The Exchange connector administration utility is accessible from the Exchange manager utility. The Exchange connector administration utility displays the email gateway machine or machines, allows remote access to the gateway configuration utility, and displays the Exchange connector machine name. The Exchange connector administration utility also provides delivery restrictions that enable the administrator to allow or deny users the ability to send and receive faxes with the Exchange connector, as well as a queues list to view the Exchange connector s list of outgoing fax jobs.
12 White Paper Figure 6: The Exchange connector administration utility. The email gateway configuration utility can be accessed from the email gateway workstation or server, as well as from the Exchange server s Microsoft Exchange Administrator (for 5.5), or the Microsoft System Manager (for 2000). The email gateway configuration utility is used to register the Fax Appliance server, or servers, for use with the Exchange connector, configure incoming and outgoing fax transmission parameters, and map Exchange email database to the Fax Appliance user database, enabling integration of the two databases. The email gateway configuration utility also includes a way to set up load sharing, a troubleshooting trace tool, and a test utility to determine communication status with each of the email gateway-configured Fax Appliance servers.
13 White Paper Figure 7: Fax Appliance email gateway configuration. Fax forms The Exchange connector setup automatically installs two Fax Appliance forms, FaxPress_View for incoming faxes, and FaxPress_Send for outgoing faxes. These forms consist of.oft files, user templates that fax-enable the Outlook mail client and provide seamless Microsoft Exchange/Fax Appliance client-side integration. FaxPress_View - this form allows users "one-click" viewing of inbound fax messages. FaxPress_Send - this form allows users access to a fax form right from the Outlook client, and also allows users to configure outbound fax jobs with a variety of easily customized delivery options. Sending faxes Sending faxes is the same for both the Fax Appliance and Premier Fax Appliance product lines. The Exchange connector allows users to send faxes as easily as email messages, right from the Outlook inbox. The message must be addressed to the recipient s fax number. Addressing can be done manually using the Exchange connector s manual addressing format, the Fax Appliance address template, or by utilizing the Exchange connector s address book and contact list integration. After addressing the message and composing the cover page/email message, the sender can attach files and send the message. Attachments are rendered into fax file format, allowing the user to send attached files to both fax and email recipients simultaneously. Additionally, documents can also be sent directly from most third-party applications, or by using Open Text s Fax Appliance fax forms for Exchange. The
14 White Paper fax forms offer custom fax interfaces integrated into the existing Outlook client. Using the Fax Appliance forms for sending faxes is optional, but ideal if the sender would like to specify a variety of fax job parameters. Receiving faxes Receiving faxes is the same for both the Fax Appliance and Premier Fax Appliance product lines. If the phone system supports some form of automatic routing, such as Direct Inward Dialing (DID), the Exchange connector will route incoming faxes directly to the specified Fax Appliance or Premier Fax Appliance user s mailbox. The Exchange connector monitors the Fax Appliance or Premier Fax Appliance server for incoming faxes and, when a new fax arrives, checks its user map to determine where to send the email notification. Depending on how the Exchange connector is configured, the fax will either be attached to the email notice or can be viewed through Faxmain. If the phone system does not support automatic routing, the Exchange connector will place incoming faxes in the default unaddressed mailbox or an assigned line user s mailbox, where the faxes can be manually routed to the recipient s email inbox. Integrating Microsoft Outlook with Open Text fax servers: Open Text s Outlook direct The client-based Outlook direct, installed on the user workstation, works independently of your network s mail server. For this reason, Outlook direct is the ideal email integration solution in Microsoft Outlook environments operating without an Exchange server. Although no Exchange server is required, Outlook direct does support Exchange 5.5 or 2000/2003, and is a good solution for Exchange environments where a client-based rather than server-based solution is preferred. Since Outlook direct runs as a Microsoft messaging transport service on the user workstations, and no connector is installed on the mail server, Outlook direct leaves the mail server free for processes unrelated to faxing. With Outlook direct, familiar email commands are used to create, address, and send faxes, making fax messaging very similar to sending and receiving email. Attachments are rendered into fax file format for most applications, allowing attached files to be sent to fax and email recipients simultaneously. Faxes can be easily addressed using the existing business fax entries in the user s contacts list. Incoming faxes can be received as attached.tiff,.dcx, or.pdf files. Outlook direct is not suitable for a remote, dial-up, or VPN connection. For remote, dial-up, or VPN connections, either Open Text s Exchange connector/email gateway or Open Text s generic gateway for SMTP option should be considered. And although Outlook direct does support Microsoft Outlook and Exchange, Outlook direct does not support Microsoft Outlook Express. Open Text's client-side Fax Appliance Outlook direct service software, designed to operate in network environments running Microsoft Outlook, provides a
15 White Paper convenient way for Outlook users to send and receive faxes using the Fax Appliance or Premier Fax Appliance. Client rather than server-based, Outlook direct is able to operate independently of an Exchange server, making it ideal for smaller networks running Microsoft s most basic Exchange or Outlook email system. For both the Fax Appliance and Premier Fax Appliance, the Outlook direct service software is installed from the product CD onto the user workstations, and plugs in as a fax transport and a fax extension for Microsoft Outlook. The Open Text Fax Appliance transport, a service added to the user s email profile, creates a seamless connection between Outlook and the Fax Appliance or Premier Fax Appliance server. Outlook direct also extends the Outlook user interface by adding a Fax Appliance menu. The Fax Appliance menu allows the user to directly view and manipulate the incoming or outgoing fax queue and configure the properties of the fax transport. How Outlook direct works The Open Text Fax Appliance transport, a service added to the user s email profile, connects Outlook to the Fax Appliance or Premier Fax Appliance server. The Fax Appliance transport delivers messages to the fax server for faxing, enables viewing of inbound and outbound faxes, provides real time fax status, allows the user to set faxing parameters and, if your phone system supports automatic routing, will also notify users of personal incoming faxes.
16 White Paper Figure 8: How Outlook direct works. Administering Outlook direct Outlook direct is administered on the client machine through the Fax Appliance transport properties added to the user s Outlook client profile. The Fax Appliance transport properties are used to customize incoming and outgoing transmission parameters, as well as configure the Outlook direct client settings according to your users individual requirements.
17 White Paper Figure 9: Fax Appliance transport properties. Sending faxes Using Outlook direct to send a fax message requires that you address your email to the recipient's fax number, rather than the email address. Fax messages can be addressed either by using the existing business fax entries from the Outlook contacts list, or manually by entering the fax recipient's fax number according to the Outlook direct fax addressing format. Figure 10: Using the business fax entries in Outlook contacts. Users can attach multiple files to a single fax message or send one fax message to multiple recipients. Attachments are rendered into fax documents and can be sent to both fax and email recipients simultaneously. Documents may also be sent as fax messages directly from within most third-party applications, using the File>Send To>Open Text Fax Appliance option. Outlook direct's fax address
18 White Paper template and real time fax status viewing tools further simplify your fax messaging. Receiving faxes The Fax Appliance Outlook direct transport periodically polls the Fax Appliance queues for incoming faxes and can notify the user of personal faxes received on the Fax Appliance. If your telephone system employs some kind of automatic inbound routing that provides you with a personal fax number, the transport will send you an e-mail notice when a new fax is found in the user's mailbox. The fax can be converted to your choice of.tiff,.dcx, or.pdf format and attached to the email notice, or viewed from Faxmain. Your Fax Appliance transport's incoming faxes settings allow you to configure the email notices to be received with or without the fax attached, to specify the number of notices the transport can send in a specified amount of time, and also allow you to forward or simply print incoming faxes. If your network does not employ some kind of automatic or assigned line routing that provides you with a personal fax number, all incoming faxes will be stored in the Fax Appliance's unaddressed mailbox. The administrator then assigns a router, operator, or supervisor-privileged user to route the unaddressed faxes to the appropriate client mailbox. IBM Lotus Notes environments Both the Fax Appliance and Premier Fax Appliance product lines provide a reliable and efficient server-based email integration solution for fax-enabling IBM Lotus Notes. The Lotus Notes gateway for Fax Appliance and Premier Fax Appliance enables inbound and outbound faxing from the Notes client, as well as mapping of fax server and Notes user databases. By extending the Notes user interface, the Lotus Notes gateway allows familiar email commands to be used to create, address, and send faxes, making fax messaging as simple as emailing. Attachments are rendered into fax file format for most applications, allowing attached files to be sent to fax and email recipients simultaneously. The Lotus Notes gateway s fax features are available to both local and offsite Fax Appliance and Premier Fax Appliance users. Open Text s Fax Appliance and Premier Fax Appliance fax forms for Exchange provide further simplified fax messaging, integrating custom fax interfaces into the existing Notes client. Integrating IBM Lotus Notes with Open Text fax servers: Open Text s Lotus Notes gateway Open Text s native Vendor Independent Messaging (VIM)-based Lotus Notes gateway for Fax Appliance and Premier Fax Appliance extends the Notes client interface and makes for user-friendly and convenient fax transactions. The gateway provides a New Fax Appliance option, the fax equivalent of the Notes New Memo option, and also adds a Fax Address option that provides access to the Lotus Notes phonebooks, access to custom fax transmission parameters, and access to a variety of cover sheet options.
19 White Paper How the Lotus Notes gateway works Open Text s Lotus Notes integration involves a set of Lotus Notes script files and VIM gateway software supplied on the Fax Appliance or Premier Fax Appliance product CD. The Lotus Notes script files are installed and configured on the Lotus Domino server, while the VIM gateway is installed on any one of the Notes client machines. The VIM gateway is responsible for logging into the Domino server and retrieving outgoing fax jobs in its Domino server user account. The VIM gateway will then convert the jobs to faxable format and then forward the fax jobs to the Fax Appliance or Premier Fax Appliance for faxing. When multiple Fax Appliance or Premier Fax Appliance units are deployed, the VIM gateway can be configured to load share by distributing fax jobs evenly among multiple Fax Appliance and/or Premier Fax Appliance units. This feature is very beneficial when a large number of Notes users are sending a large number of faxes. Figure 11: Open Text s Lotus Notes gateway integrates Fax Appliance or Premier Fax Appliance with IBM Lotus Notes. Administering the Lotus Notes gateway Open Text s Lotus Notes gateway for Fax Appliance and Premier Fax Appliance offers centralized user management and administration through convenient administration utilities. The Lotus Notes gateway configuration manager allows you to specify the Fax Appliance or Premier Fax Appliance server or servers to be used with the gateway and map the Notes user database to the Fax Appliance or Premier Fax Appliance user database. The configuration manager also allows you to configure incoming, outgoing, and unaddressed fax settings, specify the fax attachments format, and enable or disable auto registration. With the Lotus Notes gateway s auto registration feature enabled, a new Fax Appliance or Premier Fax Appliance user account will be automatically created, if there isn t an existing one, from the user s Lotus Notes email profile information the first time a
20 White Paper fax message is sent. The Notes administrator can also specify which Notes clients will be given access to certain Fax Appliance or Premier Fax Appliance units. Notes users can be automatically added to the Fax Appliance or Premier Fax Appliance user database. Sending faxes Open Text s Lotus Notes gateway unifies your Lotus Notes users fax and email environments, allowing faxes to be sent and received directly from the Notes client. Faxing becomes as simple as sending and receiving email. Users can attach multiple files to a single fax message, or send one fax message to both email and fax recipients simultaneously, all without consuming the Domino server s resources. After Lotus Notes script files are installed on the Domino server, the administrator can decide which Notes users may access the Fax Appliance or Premier Fax Appliance. The Notes users with access rights to use the Fax Appliance or Premier Fax Appliance will have a New Fax Appliance Fax button appear on their Notes tool bar. When the New Fax Appliance Fax button is clicked, further fax sending options will be made available to the user. Figure 12: The New Fax Appliance Fax option is located next to the Notes New Memo option in the Notes client interface. In the New Fax Appliance Memo window, the Fax Address button provides access to the Lotus Notes phonebooks, where the office fax entries can be selected to address the Fax Appliance fax, and also provides access to custom fax transmission and cover sheet options. Faxes may also be sent to user groups specified in the Lotus Notes address book.
21 White Paper Figure 13: The new Fax To: field added below the existing To: and Cc: fields provides the additional option of manually addressing a fax. Receiving faxes If your telephone system employs some kind of automatic inbound or assigned line routing, the Lotus Notes gateway will send out an email notice to the recipient whenever a new fax arrives in the recipient s Fax Appliance or Premier Fax Appliance mailbox. Depending on how the Lotus Notes gateway is configured, the fax will either be attached to the notice or may be viewed through Faxmain. If your network does not employ some kind of automatic inbound routing, all incoming faxes will be stored in the Fax Appliance or Premier Fax Appliance unaddressed mailbox. The administrator then assigns a router, operator, or supervisor-privileged user to route the unaddressed faxes to the appropriate client mailbox. Novell GroupWise email environments Both the Fax Appliance and Premier Fax Appliance product lines provide the email gateway for generic SMTP, a reliable and efficient SMTP-based email gateway solution for fax-enabling Novell GroupWise. The Fax Appliance product line s email gateway for generic SMTP is provided on the Fax Appliance 8.x CD; the Premier Fax Appliance product line s email gateway for generic SMTP is one of the embedded services on the Premier Fax Appliance server. Once installed on a network workstation, in the case of the Fax Appliance products, or enabled on the Premier Fax Appliance server, in the case of the Premier Fax Appliance products, the email gateway for generic SMTP allows users to send and receive faxes directly from their GroupWise mail clients. The email gateway for generic
22 White Paper SMTP is a standard feature for the Fax Appliance and Premier Fax Appliance product lines. Integrating Novell GroupWise with Fax Appliance: Open Text s email gateway for generic SMTP The email gateway for generic SMTP acts as an intermediary between the Fax Appliance or Premier Fax Appliance server and your GroupWise email system, offering your company the benefit of centralized fax and email management, and your staff the convenience of an integrated messaging environment. With the email gateway for generic SMTP, GroupWise users can send and receive faxes without ever leaving the mail client. Familiar email commands are used to create, address, and send faxes, making fax messaging as simple as sending an email. Attachments are rendered into fax file format for most applications, allowing attached files to be sent to fax and email recipients simultaneously. The fax features provided by the email gateway for generic SMTP are available to both local and offsite Fax Appliance and Premier Fax Appliance users. The email gateway for generic SMTP provided with the Fax Appliance product line and the email gateway for generic SMTP provided with the Premier Fax Appliance product line are identical in operation, although the implementation is slightly different. The Premier Fax Appliance product line s email gateway for generic SMTP, an embedded service, is enabled, configured, and run on the Premier Fax Appliance server rather than on a network workstation, and requires no software installation. Unlike the Premier Fax Appliance s email gateway, the Fax Appliance product line s email gateway is service software provided on the Fax Appliance 8.x CD, and is installed, configured, and run on a network workstation. How the email gateway for generic SMTP works with Novell GroupWise Although the implementation varies, the email gateway for generic SMTP provided with the Fax Appliance product line and the email gateway for generic SMTP provided with for the Premier Fax Appliance product line operate the same way. Both are RFC-821 compliant, 32-bit Windows-based services that use SMTP to communicate with your GroupWise server and Open Text program interface to communicate with the Fax Appliance or Premier Fax Appliance server. The email gateway for both product lines also includes a configuration utility that allows the gateway to be configured while running or when shut down. The email gateway for generic SMTP supports the Internet s open standards for message transmission and formatting: TCP/IP, SMTP, and RFC-822/MIME. Novell s GroupWise is a Local Area Network (LAN)-based messaging system with its own proprietary mail protocol, and so requires an agent to translate messages from the GroupWise messaging format to the TCP/IP and SMTP protocols the email gateway uses.
23 White Paper Novell offers two Internet messaging solutions that allow GroupWise to communicate with the email gateway: GroupWise Internet Agent (GWIA) GroupWise SMTP/MIME gateway Both solutions support TCP/IP and SMTP, and will convert GroupWise mail protocol to SMTP protocol and SMTP protocol to GroupWise mail protocol, allowing the Fax Appliance SMTP gateway and the GroupWise mail server to send messages back and forth. The GWIA is shipped with GroupWise versions 5.x and above. The GroupWise SMTP/MIME gateway can be purchased through Novell resellers. The GWIA does not require a smart host, can perform IP address resolution directly with a Domain Name System (DNS), and is Mail Exchanger (MX) record aware. If you are not using DNS, however, your email server must have a host file for lookup. This file will contain the IP addresses associated with the host names of servers or workstations external to the GroupWise system, but in communication with GroupWise users. The email gateway for generic SMTP is in this category of servers and workstations external to GroupWise. The Fax Appliance product line s email gateway for generic SMTP is included on the Fax Appliance 8.x CD and is installed and run on a network workstation or file server. The gateway runs as a service on a Windows NT/2000/XP workstation or server, allowing the gateway to invoke the applications required to convert email attachments to a faxable format. The Fax Appliance SMTP gateway appears as an SMTP (Internet) email server on the network, and is an excellent alternative to NetWare Loadable Modules (NLMs) or connectors, since it runs on a workstation rather than on the NetWare server.
24 White Paper Figure 14: The Fax Appliance SMTP gateway appearing as an SMTP. Administering the Fax Appliance s email gateway for generic SMTP Open Text s Fax Appliance email gateways guide provides instructions that make installation, configuration, and use of the email gateway for generic SMTP in the Novell environment simple and straightforward. Once the email gateway is installed from the Fax Appliance CD, the email gateway configuration utility can be used to configure and administer the gateway. The windows-based email gateway configuration utility provides an efficient, centralized way to manage your network s fax messaging, allowing you to map the Fax Appliance user database to your GroupWise mail server
25 White Paper database, add Fax Appliance servers as needed, and enable or disable access to the Fax Appliance. Figure 15: Fax Appliance email gateway configuration for generic SMTP configuration utility. Multiple Fax Appliance units/auto load balancing Multiple Fax Appliance servers can be registered for use with the gateways. The email gateway configurator lists each unit and displays the inbound and outbound fax line numbers for that unit in the configuration utility. When multiple units are used, the gateways use load balancing to distribute the fax jobs. For outbound faxes, load balancing allows the gateways to distribute outgoing faxes as evenly as possible among the available outbound fax lines. The gateways maintain a list of the outbound fax lines and keep track of the most recent line used. Because the sender must have a Fax Appliance account to send faxes, the gateway will check each Fax Appliance server until one with a mailbox for the sender is found. The fax is then sent to an outbound fax line on that fax server. If the sender does not have a fax server mailbox, the outgoing fax will fail, unless the gateway s auto-registration feature is enabled. Autoregistration, if enabled, allows users to be created automatically each time. Integrating Novell GroupWise with Premier Fax Appliance: Open Text s email gateway for generic SMTP The Premier Fax Appliance s email gateway is one of the embedded services on the Premier Fax Appliance server, and is an excellent alternative to NLMs or connectors, since it runs on the Premier Fax Appliance rather than on the NetWare server. Once started and configured, the email gateway service appears as an SMTP (Internet) email server on the network and invokes applications installed on the
26 White Paper Premier Fax Appliance that are required to convert email attachments to a faxable format. Figure 16: Premier Fax Appliance with email gateway for generic SMTP enabled. Administering the email gateway for generic SMTP Open Text s Premier Fax Appliance email gateways guide provides instructions that make configuration and use of the email gateway for generic SMTP in the Novell environment simple and straightforward.
27 White Paper The Premier Fax Appliance s email gateway for generic SMTP is started, stopped, and configured from the Premier Fax Appliance s embedded services folder. Figure 17: Embedded services folder. The Premier Fax Appliance s email gateway configuration utility, accessed from the embedded services folder, is used to configure and administer the gateway. The Windows-based configuration utility provides an efficient, centralized way to manage your network s fax messaging, allowing you to map the Premier Fax Appliance user database to your GroupWise mail server database and enable or disable access to the Premier Fax Appliance. Figure 18: Premier Fax Appliance email gateway configuration utility. Sending faxes Sending faxes using the email gateway for generic SMTP is the same for both Fax Appliance and Premier Fax Appliance users: the sender must include the recipient s fax number and the SMTP gateway s subdomain name in the email
28 White Paper address string. To send a fax from the GroupWise email client, the GroupWise user addresses the email to the recipient s fax number at the Gateway s subdomain name, e.g., recipient_fax_number@gateway s_subdomain_name If the gateway s subdomain name is fax.company.com, then an example of a faxable email address is: 14084960502@fax.company.com. The email message is sent via SMTP from the sender s mail client to the GroupWise server. The mail server then forwards the message to the IP address corresponding to the gateway s domain name fax.company.com, in this case. The email address string can also be used to provide other information for the fax. Cover page information (recipient s name, recipient s company name, recipient s voice number) and other instructions for the Fax Appliance or Premier Fax Appliance (bill back code, Private Branch Exchange (PBX) password, personal cover page, etc.) may be added using key codes and delimiting characters. After the GroupWise server passes the message to the gateway, the gateway prepares the message for the Fax Appliance or Premier Fax Appliance. The gateway first extracts the fax number and other address information from the email address header, then logs onto the Fax Appliance or Premier Fax Appliance and accesses the user s account for additional information. The gateway prepares the email message body text. If the message body text satisfies the requirements for the cover page text (up to 960 characters), the gateway puts the text on the cover page. If the message body text exceeds the parameters for the cover page text, the gateway starts the text on a separate page. The gateway then converts any attached files to faxable format, using the available NT services to open files in their native application OLE to create a faxable format. The native applications must be installed on the email gateway computer or, in the case of the Premier Fax Appliance, on the Premier Fax Appliance itself, and the gateway user must have access to them. The gateway sends the prepared fax to the Fax Appliance or Premier Fax Appliance fax server. The Fax Appliance or Premier Fax Appliance then merges the recipient information (name, phone number, and message) to the cover page. The fax is placed in a queue and the gateway polls the fax server for outgoing fax status. When the fax attempt is complete, the gateway dispatches the sender an email notification as to its success or failure. Failure notices can also be configured to go to the gateway administrator. Receiving faxes Receiving faxes using the email gateway for generic SMTP is the same for both Fax Appliance and Premier Fax Appliance users: the gateway periodically polls
29 White Paper the fax server for incoming faxes. When a registered gateway user s fax server account receives a fax, the gateway sends the user an email notice with the fax attached, assuming the phone system supports some form of automatic routing (e.g. DID). If the recipient s fax server account isn t registered with the gateway, or if the phone system does not support automatic routing, a notice is sent to the gateway administrator. GroupWise mail server requirements Using either of the gateways with GroupWise requires the GroupWise mail server be set up to support SMTP and TCP/IP protocols. The required Novell network preparation and GroupWise mail server configuration involves confirming that either the GWIA or the GroupWise SMTP/MIME gateway is installed. The GroupWise mail server will need to be able to resolve the host name of the SMTP gateway either through DNS or through the local host file. Step-by-step instructions on preparing your Novell environment are included in the Fax Appliance email gateways guide and the Premier Fax Appliance email gateways guide. SMTP-compatible email environments The Premier Fax Appliance s versatile embedded email gateway for generic SMTP enables users of SMTP-compatible email systems to send and receive faxes. The embedded email gateway for generic SMTP has been tested in a variety of email environments. It has proven to be a very reliable alternative to NLMs or connectors, especially since it runs as a service on the Premier Fax Appliance, and does not run on the NetWare or Windows server of the email system. The embedded email gateway for generic SMTP provides a robust and efficient way to fax-enable Novell GroupWise. Open Text provides a simple set of instructions that make configuration and use of the Premier Fax Appliance email gateway for generic SMTP in the Novell environment simple and straightforward. Integrating SMTP mail systems with Open Text fax servers: Open Text s email gateway for generic SMTP The email gateway for generic SMTP is a reliable and efficient SMTP-based email gateway solution for fax-enabling SMTP compatible mail systems. Although Open Text s Exchange connector/email gateway solution is generally recommended for environments running Exchange servers, the email gateway for generic SMTP can also be used in Exchange environments where the administrator prefers not to have a connector running on the Exchange server. The email gateway for generic SMTP provided with the Fax Appliance product line and the email gateway for generic SMTP provided with the Premier Fax Appliance product line are identical in operation, although the implementation is slightly different. The Premier Fax Appliance product line s email gateway for
30 White Paper generic SMTP, an embedded service, is enabled, configured, and run on the Premier Fax Appliance server rather than on a network workstation, and requires no software installation. Unlike the Premier Fax Appliance s email gateway, the Fax Appliance product line s email gateway is service software provided on the Fax Appliance 8.x CD, and is installed, configured, and run on a network workstation. Once installed on a network workstation, in the case of the Fax Appliance products, or enabled on the Premier Fax Appliance server, in the case of the Premier Fax Appliance products, the email gateway for generic SMTP allows users to send and receive faxes directly from their GroupWise mail clients. The email gateway for generic SMTP is a standard feature for the Fax Appliance and Premier Fax Appliance product lines. Open Text s email gateway for generic SMTP acts as an intermediary between the Fax Appliance or Premier Fax Appliance server and your SMTP mail server, offering your company the benefit of centralized fax and email management, and your staff the convenience of an integrated messaging environment. With the email gateway for generic SMTP, network users can send and receive faxes without ever leaving the mail client. Familiar email commands are used to create, address, and send faxes, making fax messaging as simple as sending an email. Attachments are rendered into fax file format for most applications, allowing attached files to be sent to fax and email recipients simultaneously. The fax features provided by the email gateway for generic SMTP are available to both local and offsite Fax Appliance and Premier Fax Appliance users. How the email gateway for generic SMTP works Although the implementation varies, the email gateway for generic SMTP provided with the Fax Appliance product line and the email gateway for generic SMTP provided with for the Premier Fax Appliance product line operate the same way. Both are RFC-821 compliant, 32-bit Windows-based services that use SMTP to communicate with your mail server and Open Text program interface to communicate with the Fax Appliance or Premier Fax Appliance server. The email gateway for generic SMTP supports the Internet s open standards for message transmission and formatting: TCP/IP, SMTP and RFC-822/MIME. Fax Appliance and the email gateway for generic SMTP The Fax Appliance product line s email gateway for generic SMTP is included on the Fax Appliance 8.x CD and is installed and run on a network workstation or file server. The gateway runs as a service on a Windows NT/2000/XP workstation or server, allowing the gateway to invoke the applications required to convert email attachments to a faxable format. The Fax Appliance email gateway for generic SMTP appears as an SMTP (Internet) email server on the network and is an excellent alternative to NLMs or connectors, since it runs on a workstation rather than on the mail server.
31 White Paper Figure 19: Fax Appliance server with email gateway for generic SMTP installed on network workstation. Administering the Fax Appliance s email gateway for generic SMTP Open Text s Fax Appliance email gateways guide provides instructions that make installation, configuration, and use of the email gateway for generic SMTP in the Novell environment simple and straightforward. Once the email gateway is installed from the CD, the email gateway configuration utility can be used to configure and administer the gateway. The Windows-based email gateway configuration utility provides an efficient, centralized way to manage your network s fax messaging, allowing you to synchronize the Fax Appliance user database with your GroupWise mail server database, add Fax
32 White Paper Appliance servers as needed, and enable or disable access to the Fax Appliance. Figure 20: Email gateway for generic SMTP configuration utility. Multiple Fax Appliance units/auto load balancing Multiple Fax Appliance or Premier Fax Appliance servers can be registered for use with the gateways. The email gateway lists each unit and displays the inbound and outbound fax line numbers for that unit in the configuration utility. When multiple units are used, the gateways use load balancing to distribute the fax jobs. For outbound faxes, load balancing allows the gateways to distribute outgoing faxes as evenly as possible among the available outbound fax lines. The gateways maintain a list of the outbound fax lines and keep track of the most recent line used. Because the sender must have a Fax Appliance or Premier Fax Appliance account to send faxes, the gateway will check each Fax Appliance or Premier Fax Appliance server until one with a mailbox for the sender is found. The fax is then sent to an outbound fax line on that fax server. If the sender does not have a fax server mailbox, the outgoing fax will fail, unless the gateway s auto-registration feature is enabled. Auto-registration, if enabled, allows users to be created automatically each time. Premier Fax Appliance and the email gateway for generic SMTP The Premier Fax Appliance s email gateway is one of the embedded services on the Premier Fax Appliance server, and is an excellent alternative to NLMs or connectors, since it runs on the Premier Fax Appliance rather than on the SMTP server.
33 White Paper Once started and configured, the email gateway service appears as an SMTP (Internet) email server on the network, and invokes applications installed on the Premier Fax Appliance that are required to convert email attachments to a faxable format. Figure 21: Premier Fax Appliance with email gateway for generic SMTPenabled. Administering the email gateway for generic SMTP Open Text s Premier Fax Appliance email gateways guide provides instructions that make configuration and use of the email gateway for generic SMTP simple and straightforward.
34 White Paper The Premier Fax Appliance s email gateway for generic SMTP is started, stopped, and configured from the Premier Fax Appliance s embedded services folder. Figure 22: Embedded services folder. The Premier Fax Appliance s email gateway configuration utility, accessed from the embedded services folder, is used to configure and administer the gateway. The Windows-based configuration utility provides an efficient, centralized way to manage your network s fax messaging, allowing you to synchronize the Premier Fax Appliance user database with your GroupWise mail server database, add Premier Fax Appliance servers as needed, and enable or disable access to the Premier Fax Appliance. Figure 23: Premier Fax Appliance email gateway configuration utility.
35 White Paper Sending faxes Sending faxes using the email gateway for generic SMTP is the same for both Fax Appliance and Premier Fax Appliance users: the sender must include the recipient s fax number and the SMTP gateway s subdomain name in the email address string. To send a fax from the GroupWise email client, the GroupWise user addresses the email to the recipient s fax number at the gateway s subdomain name, e.g.: recipient_fax_number@gateway s_subdomain_name If the gateway s subdomain name is fax.company.com, then an example of a faxable email address is: 14084960502@fax.company.com. The email message is sent via SMTP from the sender s mail client to the GroupWise server. The mail server then forwards the message to the IP address corresponding to the gateway s domain name fax.company.com, in this case. The email address string can also be used to provide other information for the fax. Cover page information (recipient s name, recipient s company name, recipient s voice number) and other instructions for the Fax Appliance or Premier Fax Appliance (bill back code, PBX password, personal cover page, etc.) may be added using key codes and delimiting characters. After the GroupWise server passes the message to the gateway, the gateway prepares the message for the Fax Appliance or Premier Fax Appliance. The gateway first extracts the fax number and other address information from the email address header, then logs onto the Fax Appliance or Premier Fax Appliance and accesses the user s account for additional information. The gateway prepares the email message body text. If the message body text satisfies the requirements for the cover page text (up to 960 characters), the gateway puts the text on the cover page. If the message body text exceeds the parameters for the cover page text, the gateway starts the text on a separate page. The gateway then converts any attached files to faxable format, using the available NT services to open files in their native application OLE to create a faxable format. The native applications must be installed on the email gateway computer or, in the case of the Premier Fax Appliance, on the Premier Fax Appliance itself, and the gateway user must have access to them. The gateway sends the prepared fax to the Fax Appliance or Premier Fax Appliance fax server. The Fax Appliance or Premier Fax Appliance then merges the recipient information (name, phone number, and message) to the cover page. The fax is placed in a queue and the gateway polls the fax server for outgoing fax status. When the fax attempt is complete, the gateway dispatches the sender an email notification as to its success or failure. Failure notices can also be configured to go to the gateway administrator.
36 White Paper Receiving faxes Receiving faxes using the email gateway for generic SMTP is the same for both Fax Appliance and Premier Fax Appliance users: the gateway periodically polls the fax server for incoming faxes. When a registered gateway user s fax server account receives a fax, the gateway sends the user an email notice with the fax attached, assuming the phone system supports some form of automatic routing (e.g. DID). If the recipient s fax server account isn t registered with the gateway or if the phone system does not support automatic routing, a notice is sent to the gateway administrator. Pre-Sales Support and Additional Information For more help determining which email integration option will best serve your purposes, Open Text sales staff is available to answer any questions you may have.
37 White Paper About Open Text Open Text is a leader in Enterprise Content Management (ECM). With two decades of experience helping organizations overcome the challenges associated with managing and gaining the true value of their business content, Open Text stands unmatched in the market. Together with our customers and partners, we are truly The Content Experts, supporting 46,000 organizations and millions of users in 114 countries around the globe. We know how organizations work. We have a keen understanding of how content flows throughout an enterprise, and of the business challenges that organizations face today. It is this knowledge that gives us our unique ability to develop the richest array of tailored content management applications and solutions in the industry. Our unique and collaborative approach helps us provide guidance so that our customers can effectively address business challenges and leverage content to drive growth, mitigate risk, increase brand equity, automate processes, manage compliance, and generate competitive advantage. Organizations can trust the management of their vital business content to Open Text, The Content Experts. FaxSolutions.OpenText.com Sales: Support: captaris.sales@opentext.com +1-800-304-2727 support@opentext.com +1-800-540-7292 www.opentext.com For more information about Open Text products and services, visit www.opentext.com. Open Text is a publicly traded company on both NASDAQ (OTEX) and the TSX (OTC). Copyright 2009 by Open Text Corporation. Open Text and The Content Experts are trademarks or registered trademarks of Open Text Corporation. This list is not exhaustive. All other trademarks or registered trademarks are the property of their respective owners. All rights reserved. 09FXDD0034EN