Summary

A firewall can prevent Laserfiche Agenda Manager from accessing a Laserfiche repository. This occurs when a firewall is filtering the communication between the Laserfiche Server and Agenda Manager. This article explains how you can configure Laserfiche Agenda Manager to communicate with a Laserfiche Server across a firewall.

Note: This article does not apply to Laserfiche Agenda Manager 7.1 as it does not interact with a Laserfiche repository.

Resolution

The first step that you need to take is to make sure that the Laserfiche Server has been properly configured. For detailed instructions on how the Laserfiche Server should be configured to be firewall compatible, please refer to the following Laserfiche Knowledge Base article:

1000765 Configuring Laserfiche to be Firewall Compatible.

After configuring the Laserfiche Server, you will need to install the client version of the Laserfiche Firewall Compatibility Component on the computer where Laserfiche Agenda Manager is installed. Once it has been installed, you should turn off the automatic reception of repository connection information, as that information will not contain the correct port information.

Laserfiche Agenda Manager will now be able to communicate with the Laserfiche Server using the FCC port. However, Laserfiche Agenda Manager will not automatically detect the FCC port. This means that you will have to modify to manually specify the port for each profile. Port information can be specified using the following notation: the IP address for the Laserfiche Server, a colon, 1888, two colons, and the TCP port assigned to the Laserfiche Server.

Warning: Incorrectly editing the registry may adversely affect your system. Before you edit the registry, make sure you understand how to restore it if a problem occurs.

To allow an existing Agenda Manager 7.0 profile to view a Laserfiche repository

Note: If you are creating a new profile, then you will need to manually specify the name of the desired repository from step 1 of the New Profile wizard. Additionally, you will need to specify the name of the Laserfiche Server using the notation described in the above paragraph.

1. Make sure that the client version of the Laserfiche Firewall Compatibility Component is installed. If you are unsure as to where the installation can be found, please refer to the To locate the client version of the Laserfiche Firewall Compatibility Component procedure below.
2. Disable the automatic reception of repository information.
   1. Load the Windows Registry Editor.
      1. From the Start menu, select Run.
      2. Type the following:

         regedit

      3. Click OK.
   2. Browse to the HKEY_CURRENT_USER\Software\Laserfiche\Client\Profile\Options registry key.
   3. From the Edit menu, select New and then select String Value.
   4. Set the new string value to "Thunk."
   5. From the Edit menu, select Modify.
   6. In the Value data option, type "0."
3. Browse to the HKEY_LOCAL_MACHINE\SOFTWARE\LASERFICHE\Agenda Manager\Databases registry key.
4. Double-click the appropriate Server_x string value to edit it.
5. Change the existing value to:

   IPAddress:1888::ServerPort

   IPAddress is the IP address specified in the FCC configuration file on the Laserfiche Server.
   
   ServerPort is the port that the Laserfiche Server has been configured to use with the Firewall Compatibility Component.

   Note: Two colons separate 1888 and the FCC port.

6. Click OK.
7. Repeat steps 4 through 6 for each desired profile.

To allow Agenda Manager 7.2 to access a repository across a firewall

1. Make sure that the client version of the Laserfiche Firewall Compatibility Component is installed. If you are unsure as to where the installation can be found, please refer to the To locate the client version of the Laserfiche Firewall Compatibility Component procedure below.
2. If the Agenda Manager service is running under the Local System account, modify the service to log in as a Windows user account.
3. On the computer hosting Agenda Manager Server, log in as the same Windows user as the Agenda Manager service.
4. Disable the automatic reception of repository information.
   1. Load the Windows Registry Editor.
      1. From the Start menu, select Run.
      2. Type the following:

         regedit

      3. Click OK.
   2. Browse to the HKEY_CURRENT_USER\Software\Laserfiche\Client\Profile\Options registry key.
   3. From the Edit menu, select New and then select String Value.
   4. Set the new string value to "Thunk."
   5. From the Edit menu, select Modify.
   6. In the Value data option, type "0."
5. Browse to the HKEY_CURRENT_USER\Software\Laserfiche\Client\Profile\IPDatabase registry key.
6. Look for a string value that is named after the desired repository. If it already exists, proceed to the next step. Otherwise, create a new string value and assign it the name of the desired repository.
7. Set the value of the string to:

   IPAddress:1888::ServerPort

   IPAddress is the IP address specified in the FCC configuration file on the Laserfiche Server.
   
   ServerPort is the port that the Laserfiche Server has been configured to use with the Firewall Compatibility Component.

   Note: Two colons separate 1888 and the FCC port.

Note: Agenda Manager 7.2 is compatible with Laserfiche Server 7.1 or later.

To locate the client version of the Laserfiche Firewall Compatibility Component

1. Insert the Laserfiche Client/Server installation CD into your CD/DVD drive. The Laserfiche installation menu should appear. If it does not appear, then you should double-click Autorun.exe from the root folder of the installation CD.
2. Select More Options and then choose Install Firewall Compatibility Component (FCC) 7.1.
3. Select the Install: FCC (Client) option. The installation for the client version of the Laserfiche Firewall Compatibility Component will appear. Step through the installation wizard.