Reference10:Concept Faxserver: Difference between revisions
No edit summary |
|||
| Line 95: | Line 95: | ||
==== Database ==== | ==== Database ==== | ||
The Fax application | The Fax application 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. The default password is '''faxserver'''. It may be changed at the innovaphone Fax page under Config/Database. | PostgreSQL is also available for other applications and any of them could create its own database. The default password is '''faxserver'''. It may be changed at the innovaphone Fax page under Config/Database. | ||
Revision as of 13:18, 25 June 2013
The innovaphone Fax application provides an email-to-fax and fax-to-email gateway.
The application polls an internal 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 sent document includes a cover page if configured. The recipient's fax number is taken from the email address and defined as fax number@fax server domain. To send an email to the internal mailbox, authenticated SMTP with the configured user and password must be used.
Incoming fax documents are converted to a PDF file and forwarded to the first email address configured for the user in the PBX.
Requirements
- It is needed to have the innovaphone Linux Application Platform installed and running.
- Each user which is allowed to send and receive fax document has got at least one email address and the fax license in the PBX.
Installation
Download the latest version of the innovaphone Fax application.
Log into the Linux 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 fax application, simply download the install_incremental_faxserver_xxxx.tar.gz file for your platform (VM or IPxx10) or if you have missed some hotfixes, download the install_cumulative_faxserver_xxxx.tar.gz archive which contains all hotfixes since the final version.
Upload this hotfix archive here.
Configuration
The innovaphone fax solution consists of the Linux application and several parts of an innovaphone device: a PBX SOAP login, a PBX gateway object, the gateway FAX interface and an route to an external line.
Device
The following configurations must be done in the innovaphone device.
License
It is required to have Fax licenses installed on your device. Check under Reference10:General/License if you already have one. An user fax license is necessary for each PBX user with fax rights. 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 TAPI Login
It is required to have a PBX object which can be used for SOAP login. This object must have at least group CF rights and a set password. It and the fax gateway object must be in the same group and the group active flag must be set for this object.
PBX Gateway Object
It is required to have a PBX gateway object the FAX interface can register to. The prefix option should be enabled. The object must be a member of the tapi group.
FAX Interface
Register the FAX interface to the PBX gateway object with the enabled T.38 option.
Webdav Access
If the fax server Webdav path should not have public access or force HTTPS is enabled, the authentication of the fax server Webdav URL must be configured for the device HTTP Client and the innovaphone-linux certificate must be trusted. The innovaphone-linux certificate is in the untrusted certificates list not before the first access to the Webdav server by the FAX interface if a fax document should be sent.
innovaphone Linux Application Platform
The following configurations are part of the innovaphone Linux Application Platform.
Public Webdav access
If the fax server 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.
- 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: If ticked, the FAX interface trace on the innovaphone device is enabled.
- 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 fax server includes an email server. To send emails to the fax server SMTP authorization must be used with the configurable user and password.
- User: The user for the SMTP authorization. It must be unique for all fax servers.
- Password: The password for the SMTP authorization.
- Fax Server Domain: Incoming mails are checked against this domain and outgoing mails use it for the sender domain.
- Administrator Mail Address: The administrator mail address for error notification mails.
PBX 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
The Fax application 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. The default password is faxserver. It may be changed at the innovaphone Fax page under Config/Database.
There are tools 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 Fax 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 Fax 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 needn't not be saved because the configuration of the innovaphone Fax is in the fax database.
Data
saveinnovaphone-faxserverdb is the command to automatically backup the whole fax database with the Command File. The fax database also includes the fax 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 Linux Application Platform.
PGAdmin
PGAdmin is an administration tool for PostgreSQL databases.
Putty
Putty is SSH client to connect to the Linux Application Platform.