Installing FirstClass Synchronization Services
Before FirstClass users can remotely synchronize their databases, FCSS must be installed and configured to run on your FirstClass server.
To install FCSS on your server:
1 Download fcsync.dll from the Synchronization Services folder in the FCOL Downloads conference to the FCServer folder where Internet Services (fcis) is installed.
2 Ensure there is a cgi-bin folder in FCServer.
 Note
If there is no cgi-bin folder in FCServer, create one.
3 Log into FirstClass as admin.
4 On the administrator's Desktop, open Internet Services > AddHandler.
5 Copy and append the following text to the AddHandler document:
<AddHandler .wbxml>
Site: *
If-Content-Type: application/vnd.syncml+wbxml
ISAPI.Ext:<Internet Services installation location>\fcsync.dll
</AddHandler>
<AddHandler .xml>
Site: *
If-Content-Type: application/vnd.syncml+xml
ISAPI.Ext:<Internet Services installation location>\fcsync.dll
</AddHandler>
6 Replace <Internet Services installation location> with the location path of the fcis executable (e.g. C:\FCServer )
7 Start (or restart) Internet Services.
8 Check the IS console to ensure FCSS was properly loaded. If it was loaded successfully, you will see the following message on the IS console:
HTTP: Loaded extension C:\FCServer\fcsync.dll: 'FirstClass Synchronization Services V 1.0 (Build 0042)', ISAPI v6.0
Note
The FirstClass Synchronization Services console will open when IS starts.
To turn the FirstClass Synchronization Services console on or off:
1 Open the Internet Services console.
2 Choose Diagnostics > FC Sync Services Console On or Diagnostics > FC Sync Services Console Off.
Licensing FCSS
You can run Synchronization Services unlicensed for evaluation purposes with up to 10 test users.
We recommend that you purchase a Synchronization Services license.
To license FCSS:
1 Obtain the license file from Open Text Corp. or your reseller.
2 Open the System Profile on the administrator's Desktop (Admin > System Profile).
3 On the Licensing tab, click Apply License File and browse to the location of your FCSS license file (nnnnnnn.LIC).
FCSS administration
FCSS administration is done from the Control menu on the Synchronization Services console.
Enable Sync |
Enable synchronization (if previously disabled). |
Disable Sync |
Disable synchronization. |
Reset System |
Terminates all sessions and connections, and restarts Synchronization server. |
List Connections |
Lists the currently active connections in the Synchronization Services console. |
List Sessions |
Lists the currently active sessions on the Synchronization Services console. |
Safe Mode |
FCSS is set to run in Safe Mode by default. This allows your synchronization server to monitor and log any exception errors that occurred. |
FCSS logging
Synchronization Services automatically logs FCSS activity as text files in the folder where the fcsync.dll file is located.
The Synchronization Services logs are name FCSYNC_yyyy_mm_dd_hh_nn_ss.txt, where:
• yyyy, mm, dd, is the date (year, month, day) that Synchronization Services was started
• hh, nn, ss is the time (hours, minutes, seconds) that Synchronization Services was shutdown.
If Synchronization Services is still running at midnight each day, the old log is closed and a new log is created.
The type and amount of information displayed on the Synchronization Services console and written to the Synchronization Services logs depend on the logging levels you set. To set the logging level:
1 Open the Synchronization Services console.
2 Choose Log Level.
3 Choose the logging level you desire.
Logging levels Quiet to Debug increase the amount of information written to the log files (Quiet the least and Debug the most).
Trace component allows you to trace specific events and is intended to be used for troubleshooting, if instructed to do so by customer support.
| 
