Installation

Installing and configuring the integration module for use.

To begin the installation of the EIM, download the etherFAX Integration Module MSI installer package and have your etherFAX account number and service credentials available. Once the installation is complete, you may configure to the EIM to suit your own needs.

Installer welcome screen:

500

To complete the installation, simply click Next and select the directory where you'd like the installer to reside. The default directory is C:\etherFAX.

The default directory structure will look something like this:

Folder PATH listing
C:.
|   EtherFax.IM.exe
|   EtherFax.IM.exe.config
|   fax2ps.exe
|   glut32.dll
|   jpeg62.dll
|   libimage.dll
|   libpng13.dll
|   libtiff3.dll
|   local.config
|   log4net.dll
|   zlib1.dll
|   
+---Inbox
|   \---Images
|           
+---Logs
|       module.log
|       
+---Queue
+---Scripts
|       report.err
|       report.ok
|       
\---Status

Setting the Account and Password

Once the installation is completed, use the command prompt and navigate to the installation directory. Use the etherfax.im.exe executable to set the account, username and password.

Example:

C:\etherFAX>etherfax.im /setaccount efax-9999-9999/myuser mypassword

The /setaccount operation will update the local.config file in your installation with an encrypted password that is unique to your computer:

<!-- account settings -->
<account>
	<transport>etherfax</transport>
	<user>efax-9999-9999/myuser</user>
<password>AQAAANCMnd8BFdERjHoAwE/Cl+sBAAAAMXRUwFPQ7E2PNA5cnar61wQAAAACAAAAAAAQZgAAAAEAACAAAADJOITm81RYr1QaiAJ/E8SDgBXeTVrmlMFt8kxCPguwNQAAAAAOgAAAAAIAACAAAAAkP0p8Pu6H/+LMrZeB1KHeyGCiV4My5s0SVpRmUoGydBAAAADlVXQ9swg6uMD6gr/MNmRAQAAAANZhWNxqijjWV/ad7mzXzdIAYBhG6xSWOPWsHb5tRHh3avZlr6r/eUflg+slx8+JpdIdXOE3a+XGMZh0TdNJ2vk=</password>
</account>

After you have set your account credentials, you may start the EIM service using the Services control panel application. Observe the output of the C:\etherFAX\Logs\module.log file and look for the text "loading transport: etherfax". If loaded correctly, you'll see the number of channels in service for your account or some type of error. In this case, the service is operational, 4 ports/channels are available for use and the service is now monitoring the C:\etherFAX\Queue directory.

2018-06-12 09:25:12,200 INFO  - service has started: 1.0.12.0
2018-06-12 09:25:12,216 INFO  - loading transport: etherfax
2018-06-12 09:25:12,466 INFO  - channels in service: 4
2018-06-12 09:25:12,466 INFO  - adding formatter RightFax FCL
2018-06-12 09:25:12,466 INFO  - adding formatter etherFAX XML
2018-06-12 09:25:12,466 INFO  - adding formatter NextGen
2018-06-12 09:25:12,466 INFO  - adding formatter GFI FaxMaker
2018-06-12 09:25:12,466 INFO  - scheduler thread started
2018-06-12 09:25:12,466 INFO  - monitor thread started: C:\etherFAX\Queue

Now that the service is operational, you may begin sending faxes by placing job files into the outbound Queue directory.


What’s Next