Installing FlashConnect

If this is an existing FlashConnect installation, prompts indicate that a directory or file already exists. The installation asks you to confirm the existing directory or file and asks if it should be overwritten.

To install FlashConnect:

Log on to UNIX as root.
(Upgrades Only) Stop the FCService if it is running by typing:

FCdebug -s

Insert the product CD into the CD-ROM drive, and then mount the CD. Type:

AIX	mount -v cdrfs -r /dev/cd0 /cdrom
Linux	mount -r -t iso9660 /dev/cdrom /mnt/cdrom

Locate the file FlashConnect_xxx.tar.

where xxx is the FlashConnect version number.

Type cd /tmp to change to the /tmp directory.
Copy the tar file to the /tmp directory by typing:

AIX	cp /cdrom/FlashConnect/FlashConnect_xxx.tar ./
Linux	cp /mnt/cdrom/FlashConnect/FlashConnect_xxx.tar ./

Type tar -xvf FlashConnect_xxx.tar to extract the FCService software.

where xxx is the FlashConnect version number.

Unbundling the FCService software creates the following files:

File Name	Description
FCconf.template	Template file used to build the file FlashConnect.conf.
FlashConnect_install	Installation script for the Web server.
w3_src.tar.Z	Platform-specific components of FlashConnect including w3Library components and examples.
FCSS.template	Template file used to create the fcsocketserver script.
fcss.jar	A generic Java Library file. fcss.jar is the FlashConnect Socket Server Java archive.
examples.jar	Java program examples.
License.txt	Text file describing the end user license agreement.

Type ./FlashConnect_install to install FlashConnect.

TIP	If this is an upgrade or reinstallation and the file w3_src.tar already exists in the current directory, a prompt displays requesting confirmation to overwrite the existing file. Answer Yes to overwrite the old file.

Press ENTER after each prompt or type your value:

Screen Prompt	Description
View the End User License Agreement?	Y allows you to read the license agreement. N skips reading the license agreement. Q quits installation.
Do you accept the terms of the End User License Agreement?	Y starts the installation. N quits installation. Q quits installation.
Enter the path to the Document Root directory [/var/www/html](Q=QUIT):	Topmost directory of the documents contained on your Web site.
Enter the path to the CGI-BIN Root directory [/var/www/cgi-bin](Q=QUIT):	Topmost directory of the executable applications used on your Web site.
Enter the path to the directory to place the FCService executable[/usr/bin](Q=QUIT):	Location for the FCService executable file.
Do you want to load the w3library demonstration files? [Y](Y/N/Q=QUIT):	Y loads the demonstration files. N does not load the demonstration files. The w3library demonstration files contain examples (w3admin.html) and diagnostic applications.
Enter the path relative to the Document Root (/var/www/html) where you want to place the DIRECTORY containing the demonstration files. Do not place '.' or './' at the beginning of the path.(Q=QUIT):	w3library demonstration files are placed in this directory. Specify the path relative to the Document Root directory.
The directory /var/www/html/w3library does not exist. Do you want to create it? [Y](Y/N/Q=QUIT):	This prompt displays if you are creating the w3library for the first time.
Enter the path to the directory for the FlashConnect configuration file, FlashConnect.conf file [/etc] (Q=QUIT):	If the FlashConnect.conf file is not located in /etc, the –c option must be used when FCService is started (so FCService can find it).
Enter the directory for FlashConnect named pipes[/tmp] (Q=QUIT):	FlashConnect uses named pipes (such as FC2000) for interprocess communication. Specify the directory where these named pipes will be located. The Web server must be able to read and write to files in this directory. FCService must be able to read, write, create, and delete files in this directory.
Enter the path to the directory for the FlashConnect log file [/var/log](Q=QUIT):	Specify the path where the FlashConnect log file (FlashConnect.log) will be located.
Enter the number of server slots[16](Q=QUIT):	Set the maximum number of server slots. This value can be changed at a later time.
Enter the FlashConnect environment size [4096] (Q=QUIT):	Set the upper limit on the number of environment variables passed to the database from the FlashConnect Server.
Enter the FlashConnect TCP/IP port number [1505](Q=QUIT):	Value is typically 1505 for both Windows and UNIX platforms.
Enter the FlashConnect heartbeat in seconds (0=no heartbeat)[0](Q=QUIT):	Heartbeat period value determines how long after the last communication with FCService that the w3Monitor terminates the connection.
Enter the FlashConnect translation specification string (empty=no translation):	Translation specification string indicates language choice.
Do you wish to install the FlashConnect Java component? [Y](Y/N/Q=QUIT):	FlashConnect applets requires Java components.
Enter the path to the directory for the Java library files [usr/lib/tigerlogic](Q=QUIT):	Specify the path where the Java library files will be located.
Enter the path to the directory for the FCSocketServer script used to start and stop the FlashConnect Java component [usr/bin](Q=QUIT):	Value is usr/bin for UNIX platforms.

The installation of the UNIX component is complete. All files have been copied to the appropriate directories, and the FlashConnect.conf file has been generated using the values specified during installation. To change any of these values, modify the FlashConnect.conf file.

NOTE

For SUN Only: The LD_LIBRARY_PATH environment variable must be set properly to allow the Apache Web server to execute FlashConnect’s fccgi.exe program. To accomplish this, insert these lines into Apache’s httpd.conf file, then restart Apache.

# Need LD_LIBRARY_PATH for FlashConnect’s fccgi.exe to

# run. The process that starts httpd must already have set

# up LD_LIBRARY_PATH so that fccgi.exe will run from that

# process’s command line.

# The PassEnv directive makes httpd inherit the named env

# var from the parent that starts httpd.

PassEnv LD_LIBRARY_PATH

Starting FCService

FCService is the Web server component of FlashConnect. FCService must be installed on the same physical computer as the Web server, but can be located on a different machine than the database.

Locating FCService and the database on different machines optimizes performance, and when used with a firewall, increases security.

To start FCService:

Go to the /usr/bin directory and type ./FCService to start FCService.
Verify that the service has started by typing:

AIX	ps -ef
Linux	ps –aux

USER	PID	%CPU	%MEM	VSZ	RSS	TTY	STAT	START	TIME	COMMAND
root	1065	0.1	0.6	1568	772	?	S	10:40	0:00	./FCService
root	1066	0.0	0.6	1568	776	?	S	10:40	0:00	./FCService
root	1067	0.0	0.6	1568	772	?	S	10:40	0:00	./FCService
root	1068	0.0	0.6	1568	776	?	S	10:40	0:00	./FCService

NOTE	Add the location of the JRE to the PATH before executing the ./fcsocketserver command.

Start the FlashConnect Socket Server.
- In GUI mode, type ./fcsocketserver start 6886 gui & from the /usr/bin directory.

[root@ptrh bin]# Starting FCSocketServer

[1]+ Done ./fcsocketserver start 6886 gui

TIP	Always use GUI mode in your first installation, which allows you to monitor errors in the FlashConnect Socket Server Manager.

- In terminal mode, type ./fcsocketserver start 6886 from the /usr/bin directory.

Starting FCSocketServer

[root@ptrh bin]# On the single server mode:

FCSocketServer started on port [6886]

The FlashConnect Socket Server Manager displays and allows you to monitor activities in FlashConnect.