KOFAX Document Exchange Server 2.0 Configuration Guide for SMTP 10001783-000
2007 2008 Kofax, Inc., 16245 Laguna Canyon Road, Irvine, California 92618, U.S.A. All rights reserved. Use is subject to license terms. Third-party software is copyrighted and licensed from Kofax s suppliers. For information on third-party software included in this product, see DESTHIRDPARTYLICENSEREADME.txt. This product is protected by U.S. Patent No. 6,370,277. THIS SOFTWARE CONTAINS CONFIDENTIAL INFORMATION AND TRADE SECRETS OF KOFAX, INC. USE, DISCLOSURE OR REPRODUCTION IS PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF KOFAX, INC. Kofax, the Kofax logo, VirtualReScan, the VRS VirtualReScan logo, and VRS are trademarks or registered trademarks of Kofax, Inc. in the U.S. and other countries. All other trademarks are the trademarks or registered trademarks of their respective owners. U.S. Government Rights Commercial software. Government users are subject to the Kofax, Inc. standard license agreement and applicable provisions of the FAR and its supplements. You agree that you do not intend to and will not, directly or indirectly, export or transmit the Software or related documentation and technical data to any country to which such export or transmission is restricted by any applicable U.S. regulation or statute, without the prior written consent, if required, of the Bureau of Export Administration of the U.S. Department of Commerce, or such other governmental entity as may have jurisdiction over such export or transmission. You represent and warrant that you are not located in, under the control of, or a national or resident of any such country. DOCUMENTATION IS PROVIDED AS IS AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
Contents Introduction...1 Additional Documentation...1 System Requirements...2 Configuring Kofax Document Exchange Server...2 Frequently Asked Questions...3 Kofax, Inc. iii
Contents iv Kofax, Inc.
Kofax Document Exchange Server Configuration Guide for SMTP Introduction This guide shows how to configure Kofax Document Exchange Server to send documents by email through an SMTP server. When you release a document to email, index fields appear for entering your email address as the sender, the recipient email addresses, a subject, and any message you want to provide. You can specify multiple recipients by separating email addresses with commas. Figure 1. Index Fields for Email Kofax Document Exchange Server also provides support for specific types of email servers such as Microsoft Exchange and Lotus Notes. Refer to the Kofax Web site or the Kofax Document Exchange Server Release Notes for information about supported email servers and versions and use the appropriate configuration for the type of email server. You can use the SMTP configuration instructions in this document for other types of SMTP-compatible email servers. Additional Documentation This guide should be read with the following documentation: Kofax Document Exchange Server installation guide for the application server Kofax Document Exchange Server Administrator s Guide Kofax Administration Console Help Kofax Document Exchange Help For information about SMTP, refer to the documentation that came with the SMTP server or contact the server administrator for support. Tip For additional information about Kofax products, visit the Kofax Web site and go to the Technical Support pages. These pages provide product-specific information, such as current revision levels, the latest drivers and software patches, technical tips, and a searchable knowledgebase. In addition, updates to product documentation (if any) are available from these pages. Kofax, Inc. 1
Kofax Document Exchange Server Configuration Guide for SMTP System Requirements Configure the email server you will use for sending documents with Kofax Document Exchange Server as follows: Create a user account to be specified in the rs.connector.smtp.properties file. This user account will be used by all Kofax Document Exchange Server users (including the administrative and default user accounts). Use port 25. Disable Secure Socket Layer (SSL). SSL is not supported when sending documents from Kofax Document Exchange. Configuring Kofax Document Exchange Server Copy and edit the necessary files to configure Kofax Document Exchange Server for SMTP. To configure Kofax Document Exchange Server for SMTP 1 Copy rs.connector.smtp.properties from the \DES\setup folder to the following folder: JBoss: The \Avalin\jboss\server\avalin\conf folder where Kofax Document Exchange Server is installed WebLogic: The conf folder in the Kofax Document Exchange Server domain. 2 Open rs.connector.smtp.properties in a text editor. Modify the following lines, and then save and close the file: mail.transport.protocol=smtp (Do not change.) host=smtp server host name (such as smtp.hostname.com) required-authentication=true if authentication is required or false if it is not user=user name for email account (ignored if requiredauthentication=false) password=password for email account (ignored if requiredauthentication=false) For example, suppose the host name is smtp.yourserver.com, and it requires authentication. You created an email account with the user name of kofaxuser and a password of kofaxpassword. The lines would be modified as follows: mail.transport.protocol=smtp host=smtp.yourserver.com required-authentication=true user=kofaxuser password=kofaxpassword Note If you set required-authentication to true and do not supply a valid user name and password, a Release Server: 530 Authentication required error is generated when you attempt to release a document to email. 3 Deploy RSModuleConnectorSMTP.ear as follows: JBoss: Copy the file from the \DES\setup folder to the \Avalin\jboss\server\avalin\deploy folder where Kofax Document Exchange Server is installed. WebLogic: Deploy the file using the WebLogic Server Administration Console. Refer to the Kofax Document Exchange Server Installation Guide for WebLogic for instructions. 2 Kofax, Inc.
Kofax Document Exchange Server Configuration Guide for SMTP 4 Deploy the rs.connector.smtp.properties and RSModuleConnectorSMTP.ear files as shown in the Kofax Document Exchange Server installation guide for the application server. 5 Stop and restart Kofax Document Exchange Server as shown in the Kofax Document Exchange Server installation guide for the application server. Note Kofax Document Exchange Server must be stopped and restarted whenever you change property files. 6 Use Kofax Administration Console to enable the destination type. Refer to the Kofax Administration Console Help for instructions. To display an email destination on the MFP front panel, create and deploy shortcuts with Kofax Document Exchange and Kofax Administration Console. Refer to the Help for these applications for information. Frequently Asked Questions If the software does not work correctly, or if you have questions about how the software operates, refer to the information in this section. You can find additional information and software updates on the Kofax Web site. Why does SMTP not display as a destination type in Kofax Document Exchange? Check the following: Make sure you have performed the procedures shown in Configuring Kofax Document Exchange Server on page 2. Enable the SMTP destination type in Kofax Administration Console. Refresh the browser window. When I send an email, I get a Release Server: 530 Authentication required error. In the rs.connector.smtp.properties file, make sure that you have specified the user name and password of an email account on the server. When I send an email, I get the following error: An error has occurred in the Release Server: Could not connect to SMTP host: host name, port: 25; nested exception is: java.net.connectexception: Connection timed out: connect. Make sure that your email server is configured to use port 25 and does not use SSL. How do I send documents to a destination from the MFP? Create shortcuts in Kofax Administration Console and Kofax Document Exchange. Shortcuts created with Kofax Administration Console are available to all users of an MFP. Users can create their own shortcuts with Kofax Document Exchange. Kofax, Inc. 3
Kofax Document Exchange Server Configuration Guide for SMTP 4 Kofax, Inc.