Alcatel-Lucent OmniTouch Fax Server Application Getting Started Manual

Brand: Alcatel-Lucent

Model: OmniTouch Fax Server Application

Type: Getting Started Manual

This manual is also suitable for

T.38

Alcatel-Lucent OmniTouch Fax Server Application is a software solution for sending and receiving faxes over IP networks. It offers a range of features and benefits that can help businesses improve their communication and collaboration.

Key capabilities of the Alcatel-Lucent OmniTouch Fax Server Application include:

T.38 fax over IP support: This allows businesses to send and receive faxes over IP networks, eliminating the need for traditional fax lines.
Integration with Microsoft Outlook and Lotus Notes: The application can be integrated with Microsoft Outlook and Lotus Notes, allowing users to send and receive faxes directly from their email clients.

Key capabilities of the Alcatel-Lucent OmniTouch Fax Server Application include:

T.38 fax over IP support: This allows businesses to send and receive faxes over IP networks, eliminating the need for traditional fax lines.
Integration with Microsoft Outlook and Lotus Notes: The application can be integrated with Microsoft Outlook and Lotus Notes, allowing users to send and receive faxes directly from their email clients.

Alcatel-Lucent Applications

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.

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

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

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

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:

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

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

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

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

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

Insert the OmniTouch Fax Server installation CD-ROM and use Microsoft Internet

Explorer to navigate to the \OutlookForms folder.

Double-click on publishforms.exe. An information window will appear, click on the OK

button so that the window depicted below appears.

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

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.

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 ...

Alcatel-Lucent OmniTouch Fax Server Application Getting Started Manual

Brand: Alcatel-Lucent

Model: OmniTouch Fax Server Application

Type: Getting Started Manual

This manual is also suitable for

T.38

Key capabilities of the Alcatel-Lucent OmniTouch Fax Server Application include:

T.38 fax over IP support: This allows businesses to send and receive faxes over IP networks, eliminating the need for traditional fax lines.
Integration with Microsoft Outlook and Lotus Notes: The application can be integrated with Microsoft Outlook and Lotus Notes, allowing users to send and receive faxes directly from their email clients.

Download PDF

report