TigerLogic.com
Products    |    Solutions    |    Support & Services    |    Education    |    Partners    |    Corporate    |    Events    |    Contact Us

Information about FlashCONNECT®
for Internet Service Providers

Table of Contents

An ISP is concerned about any software running on their servers. Concerns may be about security, resource consumption, installation or configuration. This Web page is designed to provide the information needed to safely install and run FlashCONNECT applications from your servers. Topics about the components which reside on the D3 server are not addressed. Some of the information presented here is release specific and may not be as accurate or apply to the specific version of FlashCONNECT being installed on your systems.

What is FlashCONNECT?

FlashCONNECT, Using a CGI, ISAPI, or upcoming Java Servlet interface, provides the ability to run D3 applications from the Internet.

FlashCONNECT consists of two components, the Web server component and the D3 component. This discussion focuses on the Web server component. While both components can reside on the same physical system, generally, for security reasons the Web server and the D3 component are usually physically different systems.

FlashCONNECT components can be mixed and matched across Web server and D3 platforms. One or more Web servers running the FlashCONNECT Web component can work one or more D3 database servers. Each server can be running on a different hardware or O/S platform. List of supported platforms.

What is installed?

This is an overview of what is installed onto the Web server during the installation process and the files created while FlashCONNECT is running. Installation instructions are found in the appropriate version of the FlashCONNECT Installation, Administration, and Programming Guide.

Programs:

fccgi.exe/fcisapi.dll
Run by the httpd server, fccgi.exe or fcisapi.dll pass to the D3 database server the request to the FCService process, then any reponse from the D3 server is passed back to the httpd server.

Regardless of the number of D3 database servers being supported, only one copy of fccgi.exe/fcispai.dll is needed on a Web server. fccgi.exe can be renamed (for example to fc.cgi) as needed to work with a Web server.

FCService.exe
Must be started before the first connection can be established and is generally done in a system startup script. It acts as a queuing and switching agent between the Web client requests and the D3 servers.

On FlashCONNECT 1.x releases, the FCService program was named w3Agent.

FCdebug/FCdebug.exe
A diagnostic program which provides detailed information about the state of FlashCONNECT and the state of each connection.

Files:

FC2000000, FC2*
Named pipes created by the FCService used to communicate with the fccgi.exe and fcisapi.dll programs. Location is configurable, however they are usually placed in /tmp.
flashconnect.conf
Contains the configuration of the FlashCONNECT Web server components. Usually placed in /etc, but can be placed anywhere on the system.
FCDebug.out
A log file created in /tmp when FlashCONNECT Web server component debugging is turned on.
w3library
An optionally installed account containing diagnostic tests and examples. It is best if this account is installed directly under the customers document root directory.

On FlashCONNECT version 1.x, many of the above files were named w3Agent.* rather than flashconnect.*.

What are the Security Issues?

All of the FlashCONNECT components are designed with security in mind, and with the expectation that they will be run on a third-party system, and be attacked by hackers. As such, they do not execute any user specified strings, the C++ "system" function is not used and care was taken to prevent buffer overflow errors.

FCService listens on an administrator specified TCP/IP port (usually 1505 or 505) for requests from the D3 servers. Access to this port should be limited to D3 servers only.

Is there a FlashCONNECT customer support discussion forum?

Yes.

Join the FlashCONNECT discussion group. Please see our forum Website to subscribe.

What ongoing administation is
   
needed for the Web server component?

Unix systems

  1. Messages are written to the flashconnect.log file (usually found in /var/log). As with any log file, the file must be archived and cleared on an occassional basis. The directory in which the log file resides is administrator specified.
  2. If debugging is enabled on the Web server component, the log file /tmp/FCdebug.out is created and needs to be deleted as appropriate.
  3. Optionally, the named pipes can be deleted when FCService is not running.

Windows NT systems

  1. Messages are written to the event log.

What resources does the FlashCONNECT
   
Web server component consume?

FlashCONNECT is designed to consume minimal system resources. The following resource consumption is approximate:

Unix systems

  • A shared memory segment (0xfc000000): The size depends upon the number of connections configured. It should not often exceed 1 MB.
  • Named pipes, one per connection to D3.
  • 5 typical or standard processes, plus one if the heartbeat is used, and one per connection to D3.
  • 1 semaphore per connection to D3.
  • 1 TCP/IP port, plus one TCP/IP port per connection to D3.

Windows NT systems

  • 5 typical or standard threads, plus one if the heartbeat is used, and one per connection to D3.
  • 1 semaphore per connection to D3.
  • 1 TCP/IP port, plus one TCP/IP port per connection to D3.

What are the configuration options?

The following FlashCONNECT Web server features can be configured:

Both Unix and Windows NT Web servers

  • The maximum number of concurrent connections supported.
  • The names of environment variables passed to the D3 servers.
  • The amount of memory used to store the environment variables passed to the D3 server.
  • The TCP/IP port FCServer uses to communicate with the D3 servers.
  • The directory where the flashconnect.log file is placed.
  • The heartbeat period.

Unix Web servers only

  • The directory where the named pipes will be kept.
  • The directory and name of the FlashCONNECT configuration file.

 

Back to Top

 

FlashCONNECT
Introduction
Product Information
Online Documentation & Downloads
FAQs
Reference Manual
mvDesigner

Copyright 2008. Raining Data. All Rights Reserved