Installing FlashConnect

FlashConnect Socket Server must be installed to implement an mvDesigner interface.

1. Log on to UNIX as root.
2. (Upgrades Only) Stop the FCService and the FlashConnect Servlet Server if they are running by typing the following two commands:

   FCdebug -s
   fcsocketserver stop

3. Download the FlashConnect installer from the Rocket Customer Portal to the /tmp directory. The file is named flashconnect_xxx.tar where xxx is the FlashConnect version number.
4. 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.

5. Type ./FlashConnect_install to install FlashConnect.
   Note: 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.
6. 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 directory 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):	mvDesigner requires Java components.
   Enter the path to the directory for the Java library files [usr/lib/rocketsoftware](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