Reference10:Concept Faxserver

The innovaphone Faxserver application provides an email-to-fax and fax-to-email gateway. The application polls an external mailbox for arriving emails which are converted to a fax document and sent by an innovaphone FAX interface. Content in the email can be plain text, HTML, PDF files and all other files which can be converted by OpenOffice to pdf. The recipient's fax number is taken from the email address and defined as fax number@fax server domain. Incoming fax documents are converted to a PDF file and forwarded to the email address PBX user name@user domain.

Requirements

• It is needed to have the application platform installed and running.
• A external mailbox is necessary which supports POP3 with TLS. All emails which are sent to a given domain must be forwarded to this mailbox. You can do this by a role in your mail server.

Email addresses

See Email addresses.

Installation

Download the latest version of innovaphone faxserver.

Log into the application platform, go to the Applications tag, click on Upload/Update and upload the downloaded file. The installation will start automatically and the page will refresh every two seconds showing the installation process. If there is no error during the installation you will see at the end "Installation was successful". Otherwise, you will get "installation failed" and the reason why it went wrong.

Hotfix

If you have already installed the latest version of the faxserver, simply download the Faxserver...HotfixIncremental for your platform (VM or IPxx10) or if you have missed some hotfixes, download the Faxserver...HotfixCumulative archive, which contains all hotfixes since hotfix1.

Upload this hotfix archive here.

Configuration

Device

License

It is required to have Fax licenses installed on your device. Check under Reference10:General/License if you already have one. One relay FAX license and for each PBX user with fax feature a user fax license are necessary.

Important: Set the Fax license flag for each PBX user object on the objects properties page which should be allowed to send or receive fax documents.

PBX Gateway Object

It is required to have a PBX gateway object the FAX interface can register to. The prefix option should be enabled. A password must be set if the object is used for the SOAP login.

FAX Interface

Register the FAX interface to the PBX gateway object. The FAX interface is only shown if a relay FAX license is installed.

Webdav Access

If the Faxserver Webdav path should not have public access or force HTTPS is enabled, the authentication of the Faxserver Webdav URL must be configured for the device HTTP Client and the innovaphone-linux certificate must be trusted.

innovaphone Application Platform

If the faxserver URL/user/password is not configured in your device as authenticated URL, configure faxserver/ as public Webdav path with write access on the innovaphone application platform Public Webdav Paths.

Server Configuration

• Active: Tick if this server should be started.
• Server Name: A freely selectable name for this new server instance.
• Description: A freely selectable description for this new server instance.
• User domain: The user domain is used to send the mail to the users. The user email address is generated with the user H.323 name in the PBX and the here configured user domain.
• Fax Server Domain: Incoming mails are checked against the fax server domain.
• Language: The default language for this fax server.
• Cover: The cover file which is used to send a cover page by this fax server.
• Trace: Unused.
• For an other user language or cover file of a specific slave PBX such a configuration can be added with a PBX name configuration line.

Mail Configuration

The email server must support POP3 with TLS.

• Host: The mailbox server address.
• Port: The mailbox server port. The default port with TLS is 995.
• User: The mailbox user name.
• Password: The mailbox password.
• Folder: The mailbox incoming folder.
• Administrator Mail Address: The administrator mail address for error notification mails.

SOAP Configuration

It is necessary to add a normal PBX user with at least CF/group rights and set password to use it for the SOAP login. The user must be in the same group as the fax gateway object and the group active flag must be set. To check the Fax license for users in slave PBX it is also required the SOAP login is available in all slave PBX.

• PBX IP address: The PBX IP address for the SOAP connection.
• Port: The port for the SOAP connection.
• Dyn-PBX-Id: An Id if a dyn-PBX is used.
• User: The user name for the SOAP login.
• Password: The user password for the SOAP login.
• HTTPS: Tick if HTTPS instead of HTTP is to use.
• Fax User: The long name of the PBX gateway object.

Fax Configuration

• Subscriber Id: The subscriber Id of the T.30 protocol, which will be sent with a fax.
• Add User Number: If ticked the user number is appended to the subscriber id.
• Subscriber Name: The subscriber name which will be printed within the header line of each fax page.
• Max Call Tries: The maximum number a call tries, if a call is not successful.
• Resend Delay: Delay in minutes after which a fax is resend.
• Response Timeout: The timeout in seconds within the remote party has to response.

Texts

Customer specific texts can be configured language dependently here. The texts are used for the email correspondence with the users.

Covers

Own cover files can be uploaded, downloaded or deleted here. Once uploaded the cover file can be chosen within the server configuration. Only unused files can be deleted.

Database

Faxserver installs postgreSQL version 8.4 as database management system and creates the innovaphone-faxserver database to store the configuration and the fax job data. PostgreSQL is also available for other applications and any of them could create its own database.

Password

The Faxserver creates the database user innovaphone-faxserver with default password faxserver. This password may be changed at the innovaphone Faxserver page under Config/Database.

Remote Access

There are tools (PgAdmin III) that allow to connect to application databases remotely. It is first needed to configure the IP you are connecting from under Config/Database at the innovaphone Faxserver page.

For the PgAdmin III it is important to use innovaphone-faxserver as service DB. The default login credentials are for the user innovaphone-faxserver with the password faxserver.

Backup and Restore

You can both manually and automatically backup the database and configuration files for the Faxserver application under Administration/Backup in the application platform.

Configuration details for the update server can be found here.

Configuration Files

saveinnovaphone-faxservercfgs is the command used to automatically save the cover page files with the Command File. Other configuration files must not be saved because the configuration of the innovaphone Faxserver is in the Faxserver database.

Data

saveinnovaphone-faxserverdb is the command to automatically backup the whole innovaphone Faxserver database with the Command File. The Faxserver database also includes the Faxserver configuration, but not the cover page files.

Logs

saveinnovaphone-faxserverlogs to save log files with the Command File.

Appendix

Tools

NetDrive

NetDrive is a useful webdav client which can be used to access webdav of the innovaphone application platform.

PGAdmin

PGAdmin is an administration tool for PostgreSQL databases.

Putty

Putty is SSH client to connect to the linux application platform.