ExtraFax Installation Guide

How to install the ExtraFax Plug-in for Lotus Notes 8

1. Introduction.

By extending the features of the IBM Lotus Notes 8 client which is based on the Lotus Expeditor platform, ExtraFax provides an Eclipse plug-in that allows you to send a FAX/SMS/MMS using ExtraFax.

Important Note:

In order to use this feature:

1. ExtraFax 7.03 Server (or later) must be installed on the Domino 7/8 server.
2. The HTTP task must be running on your Domino 7/8 server, where the ExtraFax server is running.
3. The ExtraFax web service must be enabled in the ExtraFax server configuration document

2. Domino Server Installation.

1. As a part of the ExtraFax installation (ExtraFax 7.0.3 onwards), you will have the opportunity to install the ExtraFax Plug-in onto the Domino server, so that the ExtraFax Plug-in for Lotus Notes 8 can be deployed at a later time. The path where the ExtraFax plug-in will be installed on the Domino server is as follows: Domino\data\domino\html\ExtraFaxPlugin

Prompt to install the ExtraFax plug-in program, while installing ExtraFax on the Domino server

3. Lotus Notes 8 Client Installation.

1. To expose the Eclipse update manager in Lotus Notes 8 and allow users to install or update custom or third-party Eclipse features and plug-ins into an existing IBM® Lotus® Notes® installation, you can enable display of the Eclipse update manager user interface. By default, the Eclipse update manager is not displayed. You can enable this user interface option using either an IBM® Lotus® Domino™ desktop policy or a PLUGIN_CUSTOMIZATION.INI file setting.

Enabling user-initiated update using a Domino desktop policy

You can enable users to manually install or update custom or third-party features from an update site by setting a Domino desktop policy, as described below.

Using the IBM® Lotus® Domino™ Administrator client, open the Desktop policy settings document.
On the Basics tab, locate the Provisioning section at the bottom of the document.
In the Allow user to do user initiated updates field, click Enable to allow user-initiated updates or Disable to prevent user-initiated updates.

Once this setting is resident, users can access the Eclipse update manager from within Lotus Notes by clicking File - Application - Install. Information about using the update manager is available in the Notes help.

This setting overrides the user-initiated update setting that may reside in the PLUGIN_CUSTOMIZATION.INI file.

2. If you do not use Desktop Policies, you can enable the option manually as follows:

In order to install the SecurTrac Notes 8 plug-in, you must first close the Lotus Notes 8 client.

if necessary add the following line to the user’s PLUGIN_CUSTOMIZATION.INI file (e.g. D:\Program Files\IBM\Lotus\Notes\framework\rcp
\plugin_customization.ini)

com.ibm.notes.branding/enable.update.ui=true

Remember to press <Enter> after you have inputted this line.

3. Start the Lotus Notes client and go to File -> Application -> Install.

4. The Install/Update screen will appear. Select Search for new features to install and click Next.

5. Click the Add Remote Location button, in order to specify the location of the Eclipse Update Site database, where the ExtraFax Plug-in is located.

6. Specify a "Name" for the new update site(can be any descriptive name) and specify the URL where the ExtraFax plug-in is located. Click OK.

7. Once the Update Site location has been added, click Finish.

8. Select ExtraFax from the feature list and click Next.

9. Review and accept the license agreement terms. Click Next.

10. Click Finish.

11. Select Install this plug-in and click OK.

12. Click Yes to restart the Lotus Notes 8 client, when prompted.

13. After the Lotus Notes 8 client has been restarted, you can find the ExtraFax plug-in located in the side bar of the Lotus Notes 8 client.

4. Configuring the ExtraFax Plug-in.

1. After the installation is complete, click the “Wrench” icon to configure the ExtraFax plug-in.

2. The ExtraFax plug-in preferences page will be displayed. Complete the configuration as required. Once completed, click “Apply” and “OK”.

ExtraFax Plug-in Configuration Page Parameter Descriptions:

Setting	Description
ExtraFax Web Services Server	The server hosting the ExtraFax.nsf database. This server should have the http task running. e.g.: server01.acme.com
Web Services Port	HTTP port number. e.g. 80
ExtraFax Web Services User ID	User ID to be used for HTTP authentication.
ExtraFax Web Services Password	http password for user id specified in the ExtraFax Web Services User ID.
ExtraFax Web Services Timeout(seconds)	default: 120 (There should be no need to change this setting).
ExtraFax Web Services Name	default: faxserver (There should be no need to change this setting).
ExtraFax PO Path	file name of the ExtraFax post office database. e.g. extrafax.nsf. If the extrafax.nsf is in a directory, specify the directory name as well. e.g. apps/extrafax.nsf.
Fax Domino Domain	specify the fax domain name as specified in your ExtraFax server configuration. e.g. ExtraFax.
SMS Domino Domain	If applicable specify the SMS domain name as specified in your ExtraFax server configuration. e.g. ExtraSMS.
MMS Domino Domain	If applicable specify the MMS domain name as specified in your ExtraFax server configuration. e.g. ExtraMMS.
Sender Address (optional)	For the purpose of populating the Fax cover page, you can specify this optional information.
Sender Mail Address (optional)	For the purpose of populating the Fax cover page, you can specify this optional information.
Sender Telephone (optional)	For the purpose of populating the Fax cover page, you can specify this optional information.
Sender Fax Number (optional)	For the purpose of populating the Fax cover page, you can specify this optional information.
Sender Company Name (optional)	For the purpose of populating the Fax cover page, you can specify this optional information.
Sender Job Title (optional)	For the purpose of populating the Fax cover page, you can specify this optional information.

5. Un-installation of the ExtraFax Plug-in.

1. In the Lotus Notes 8 client, select File->Application->Application Management.

2. The Application Management window will appear. Select the ExtraFax Plugin Feature 1.0.0.

3. Select Uninstall from the right window.

4. Click OK to uninstall the plug-in.

5. Click Yes to restart the Lotus Notes 8 client.

For details about how to use the ExtraFax Plug-in for Lotus Notes 8, consult Chapter 6

Using the ExtraFax Plug-in for Lotus Notes 8

which can be found in the ExtraFax User Guide.

-------------------------------------------------------------------------------------------------------------------------------------------
If you're connected to the Web , click here to comment to Extracomm on this documentation.