Alcatel-Lucent Applications
All Rights Reserved © Alcatel-Lucent 2007
Alcatel-Lucent
OmniTouch Fax Server
Application
Getting Started
8AL_90214_USAA ed.01
Release 5
July, 2007
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 2
Legal Notice
Alcatel, Lucent, Alcatel-Lucent and the Alcatel-Lucent logo are trademarks of Alcatel-
Lucent. All other trademarks are the property of their respective owners.
The information presented is subject to change without notice.
Alcatel-Lucent assumes no responsibility for inaccuracies contained herein.
Copyright © 2007 Alcatel-Lucent. All rights reserved.
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 3
Table of Contents
1. Introduction and purpose of document ..................................................... 3
2. Overall hardware/software requirements .................................................. 3
2.1. PC server requirements ................................................................................................... 3
2.2. Signaling protocols........................................................................................................... 3
2.3. OXE compatibility............................................................................................................ 3
2.4. Web client requirements ................................................................................................. 3
2.5. Email client requirements................................................................................................ 3
3. Pre-installation steps........................................................................... 3
3.1. C++ shared library ........................................................................................................... 3
3.2. Sendmail.......................................................................................................................... 3
3.3. MySQL.............................................................................................................................. 3
3.4. Java Runtime Environment.............................................................................................. 3
3.5. Bind Library..................................................................................................................... 3
3.6. Apache Tomcat................................................................................................................ 3
3.7. Netpbm Programs............................................................................................................ 3
4. OmniTouch Fax Server installation procedure ............................................. 3
4.1. Installation ...................................................................................................................... 3
4.2. Configuration................................................................................................................... 3
4.3. Running in console mode ................................................................................................. 3
5. Forms for Microsoft Outlook .................................................................. 3
5.1. Configuring Microsoft Exchange....................................................................................... 3
5.2. Publishing the forms........................................................................................................ 3
5.3. Issues............................................................................................................................... 3
6. Installing Lotus Notes forms................................................................... 3
6.1. Signing the database........................................................................................................ 3
6.2. Automatic install ............................................................................................................. 3
6.3. Manual install .................................................................................................................. 3
6.4. Synchronizing the mail template databases..................................................................... 3
6.5. Re-directing the fax domain to the SMTP gateway........................................................... 3
6.6. Configuring the forms – Modifying the language text ....................................................... 3
6.7. Configuring the forms – Changing the fax domain ............................................................ 3
7. Uninstalling OmniTouch Fax Server.......................................................... 3
8. List of abbreviations............................................................................ 3
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 4
1. Introduction and purpose of document
This guide provides the requirements and installation procedures for OmniTouch Fax
Server applications which use the T.38 fax over IP standard. Information on the user
permissions needed for the procedures as well as information on basic system
configuration will also be provided.
Note that only first-time installation procedures are presented in this guide. For more
information about adding or removing server or system client applications, repairing
defective installations or upgrading the software, consult the Maintenance chapter of the
OmniTouch Fax Server Administrator Guide.
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 5
2. Overall hardware/software requirements
The overall hardware and software requirements required to operate OmniTouch Fax
Server applications are listed below. Note that OmniTouch Fax Server applications are
part of a full software solution that does not require any fax boards.
2.1. PC server requirements
• Running on Linux compatible PC server platforms
• Minimum configuration:
o Pentium 4
o 3 GHz
o 1 GB RAM
o 1 GB hard drive, IDE or SATA, for installation process needs only. Actual
hard drive requirements will vary based on the volume of fax pages. As an
example, a 100 GB HDD on the fax server PC will permit the storage of 1
million fax pages.
o Ethernet card
2.2. Signaling protocols
• SIP/T.38
• H323/T.38
2.3. OXE compatibility
• From OXE 6.2
2.4. Web client requirements
• Internet Explorer 6.0, 7.0
• FireFox 1.5, 2.0
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 6
2.5. Email client requirements
Any SMTP based messaging system such as:
• Microsoft Outlook, versions 2000 to 2007
Note: The «Collaboration Objects» component of Outlook must be installed.
• Lotus Notes fax extension for Lotus R6 and R7
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 7
3. Pre-installation steps
IMPORTANT: All of the pre-installation steps listed in this chapter must be followed prior
to the installation of OmniTouch Fax Server! Failure to do so will result in a non-
functional OmniTouch Fax Server installation.
The following software must be installed prior to OmniTouch Fax Server installation.
Note that the following instructions assume that the OmniTouch Fax Server installation
CD-ROM has been mounted to /media/cdrom.
3.1. C++ shared library
OmniTouch Fax Server uses the C++ 3.2.3 shared library. This should be installed by
default on RHEL4, but if not it can be installed using the following command:
# rpm -ivh /media/cdrom/3rd/libstdc++/compat-libstdc++-33-3.2.3-47.3.i386.rpm
3.2. Sendmail
Sendmail must also be disabled so that it does not interfere with the SMTP gateway. You
can disable it by running the following commands:
# /etc/init.d/sendmail stop
# chkconfig --del sendmail
3.3. MySQL
Note: The SELinux security package, if enabled, can interfere with MySQL. It is
recommended that SELinux be disabled as to not prevent the MySQL service from starting
properly at boot-up. To disable SELinux, edit the file /etc/sysconfig/selinux and set
the value of SELINUX to "disabled", then reboot.
OmniTouch Fax Server stores its information in MySQL 5.0.37 databases. Since RHEL4
comes with MySQL 4.1 installed by default, it must be uninstalled prior to installing
MySQL 5.0.37.
To determine if MySQL 4.1 is installed run the following command:
# rpm -qa | grep -i mysql
This will show you the currently installed MySQL RPM version. For example, it may
produce "mysql-4.1.20-1.RHEL4.1.i386". It can then be uninstalled using the following
command:
# rpm -e mysql-4.1.20-1.RHEL4.1.i386
Note: This may fail due to dependency errors. If that is the case, remove the dependant
RPMs before removing MySQL 4.1.
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 8
MySQL 5.0.37 depends on the perl-DBI Perl module. This should be installed by default
on RHEL4, but if not it can be installed using the following command:
# rpm -ivh /media/cdrom/3rd/perl/perl-DBI-1.40-5.i386.rpm
Then install the MySQL server and client as follows:
# rpm -ivh /media/cdrom/3rd/mysql/MySQL-server-community-5.0.37-0.rhel4.i386.rpm
# rpm -ivh /media/cdrom/3rd/mysql/MySQL-client-community-5.0.37-0.rhel4.i386.rpm
Note: SELinux security package must be disabled for MySQL to run. To disable SELinux,
run the following command:
# /usr/sbin/setenforce 0
The MySQL-server RPM should launch the MySQL service after installation. If it does not
then launch it with the following command:
# /etc/init.d/mysql start
Note: The setenforce command is used to temporarily disable the SELinux security
package while installing MySQL. This is necessary for the MySQL server to start up
successfully after installation if SELinux is enabled.
The MySQL-server RPM should launch the MySQL service after installation. If it does not
then launch it using the following command:
# /etc/init.d/mysql start
3.4. Java Runtime Environment
OmniTouch Fax Server requires the Java Runtime Environment (JRE) version 1.5.0_06. To
install it run the following command and follow the instructions:
# /media/cdrom/3rd/java/jre-1_5_0_06-linux-i586-rpm.bin
Once completed, the JRE will be installed to /usr/java/jre1.5.0_06.
3.5. Bind Library
OmniTouch Fax Server requires version 9.2.5 of the bind library in order to parse DNS
records. To upgrade your system's bind library, run the following command:
# rpm -Uvh /media/cdrom/3rd/bind/bind-libs-9.2.5-3.i386.rpm
3.6. Apache Tomcat
OmniTouch Fax server requires Tomcat 5.5 to run web applications. To install it, run the
following commands:
# cd /opt
# tar -xvzf /media/cdrom/3rd/tomcat/apache-tomcat-5.5.23.tar.gz
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 9
This will extract Tomcat into the directory /opt/apache-tomcat-5.5.23 .
3.7. Netpbm Programs
OmniTouch Fax Server requires the netpbm-progs RPM be installed to support printing to
CUPS printers. To determine if it is already installed, run the following command:
# rpm -qa | grep netpbm-progs
If it is not already installed, install it with the following command:
# rpm -ivh /media/cdrom/3rd/netpbm/netpbm-progs-10.25-2.EL4.3.i386.rpm
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 10
4. OmniTouch Fax Server installation procedure
IMPORTANT: Ensure that you have completed all of the pre-installation steps found in
Chapter 3 before continuing with the installation steps below! Failure to do so will result
in a non-functional OmniTouch Fax Server installation.
4.1. Installation
Assuming the OmniTouch Fax server installation CD-ROM has been mounted to
/media/cdrom, run the following command as user root:
# rpm -Uhv /media/cdrom/server/OmniTouchFaxServer-5.6.0-xxx.i386.rpm
(Where, xxx, represents the build version of the OmniTouch Fax Server software.)
4.2. Configuration
After installing the application, for interactive configuration run the following command:
# /opt/ofs/scripts/setup.sh
IMPORTANT: The OmniTouch Fax Server setup process will change the MySQL root
password to 'faxserver'.
Note: The setup process prompts for a language for initial cover sheets and notification
profiles. These can be modified later using the administration tool.
Then, to configure OmniTouch Fax Server for first use, run the following command:
# /opt/ofs/scripts/firsttimesetup.sh
All the changes made by this command can be modified later using the administration
tool.
Then, to configure Tomcat and Apache for use with OmniTouch Fax Server, run the
following command:
# /opt/ofs/scripts/setup_tomcat.sh
4.3. Running in console mode
Once the configuration is complete, the OmniTouch Fax Server services will be launched
automatically using the daemon scripts located in /etc/init.d. You may, however,
choose to run any service in console mode. To do so, perform the following:
1) If necessary stop the currently running service by running:
# /etc/init.d/<service_name> status (to see if the service is currently running)
# /etc/init.d/<service_name> stop
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 11
2) Set the required environment variables using:
# cd /opt/ofs/scripts && . ./environment
3) Run the service executable with the command line parameter 'console' using:
# cd /opt/ofs/Bin && ./<service_name> console
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 12
5. Forms for Microsoft Outlook
OmniTouch Fax Server offers six forms for Outlook:
• Notification Incoming Success
• Notification Incoming Failed
• Notification Outgoing Success
• Notification Outgoing Failed
• Composition
• Preview
In order for users to use these Outlook forms, the administrator must perform a two-
phase process: first configure Microsoft Exchange, and then publish the forms.
5.1. Configuring Microsoft Exchange
For MS Exchange 2000 and 2003, follow the steps below:
Step Action
1
From the MS Exchange – Exchange System Manager, right-click the Connectors node,
then from the appearing menu select New > SMTP Connector:
–continued–
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 13
2
In the Properties window that appears, select the General tab and complete the
following information:
• Complete the Name field.
• Select the Forward all mail through this connector to the following smart hosts
option and enter, in the associated field, the IP address or hostname where the
OmniTouch Fax Server SMTP gateway is running. If you use an IP address, be
sure to enclose it in square brackets, i.e. [192.168.0.1].
• Add a bridgehead server.
–continued–
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 14
3
Still in the Properties window, select the Address Space tab, click Add and then select
Other. The Other Address Space Properties dialog window appears as shown below:
4
In the Other Address Space Properties dialog window, complete the following fields as
follows:
• Type: fax
• Cost: 1
• Address: *
–continued–
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 15
5
Click OK to close the window. The Properties window will have the new entry now
visible in the list, as shown below:
–continued–
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 16
6
Click OK; the new OmniTouch Fax Server SMTP connector appears in the Exchange
System Manager - Connectors node, as depicted below:
–end–
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 17
For MS Exchange 2007, follow the steps below:
Step Action
1
From the Exchange 2007 – Exchange Management Shell, at the command prompt enter
the following command:
New-SendConnector –Name OFS –AddressSpace “fax:*;1” –SmartHosts “<address of
the SMTP gateway>” –DNSRoutingEnabled $false
Note: <address of the SMTP gateway> must be replaced with the hostname or IP
address where the OmniTouch Fax Server SMTP gateway is running, for example:
New-SendConnector –Name OFS –AddressSpace “fax:*;1” –SmartHosts
“faxserver.mycompany.com” –DNSRoutingEnabled $false
–continued–
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 18
2
From the Exchange Management Console, the Send Connector will appear in the
Organization’s Hub Transport List, as shown below:
–end–
5.2. Publishing the forms
You need only publish the forms once to make them available for all Outlook users.
Follow the steps listed in the step table found on the following page.
Note: The OmniTouch Fax Server must already be installed. Microsoft Exchange and
Outlook 2000 or later must also be installed on individual servers. Outlook must not be
set to “Cached Exchange” or offline mode.
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 19
Step Action
1
Insert the OmniTouch Fax Server installation CD-ROM and use Microsoft Internet
Explorer to navigate to the \OutlookForms folder.
2
Double-click on publishforms.exe. An information window will appear, click on the OK
button so that the window depicted below appears.
3
To publish all forms, click Publish all forms, and then proceed to Step 4.
To publish select forms, select one or more forms and then click Publish selected
form(s) and then proceed to Step 4.
Note 1: To refresh the list of forms, click Reload from list
Note 2: To clear the log that appears in the lower half of the window, click Clear log.
–continued–
Alcatel-Lucent Applications
8AL_90214_USAA ed.01
Page 20
4
In the next dialog window that appears, enter the Fax Web Server host name followed
by the Site Name as it was configured on the fax server, and then click the OK button.
5
In the next dialog window that appears, select the Outlook Profile to be used to publish
forms, and then click the OK button.
Note 1: The selected account should have sufficient privileges assigned.
Note 2: As each form is published, you may be prompted to enable or disable the
macros. Choose Disable Macros.
–continued–
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
/
