Using the FCServlet Diagnostic

The FCServlet Diagnostic tool is a servlet diagnostic application that tests whether a system is capable of running the FlashConnect Java Components.

Run the FCServlet Diagnostic to ensure that the FlashConnect Java Components are set up properly. In addition, if any of the FlashConnect Java Components, such as FCServlet or FlashConnect Socket Server Manager, fail to serve the request/response, run the FCServlet Diagnostic to determine the problem.

NOTE	The FCServlet Diagnostic tool is available to Windows and UNIX users that installed the FlashConnect Socket Server Manager graphical user interface. Windows users must also have set the FlashConnect Socket Server Manager to interact with the desktop.

Use the FCServlet Diagnostic dialog box to run tests, view a test report log, reconfigure the setup parameters, reset the test selection, and view information about FCServlet.

The FCServlet Diagnostic tool is nested within the FlashConnect Socket Server Manager. To use the FCServlet Diagnostic tool, launch the FlashConnect Socket Server Manager first.

To launch FCServlet Diagnostic and set the parameters:

Launch the FlashConnect Socket Server Manager.

The FlashConnect Socket Server Manager dialog box displays.

Click Help.

The Help Options dialog box displays.

Select the Diagnostic option, then click OK.

The Diagnostic Options box displays.

Select FCServlet Diagnostic, then click OK.

The FCServlet Diagnostic dialog box and the FCServlet Diagnostic Configuration box displays.

The configuration box provides the parameters needed to run the FCServlet Diagnostic.

Enter the appropriate parameters, then click OK to return to the FCServlet Diagnostic dialog box.

The FCServlet Diagnostic is ready to test the FlashConnect Java components.

Testing

Once the FCServlet Diagnostic is ready, perform any of the five tests to check the compatibility of the system.

Test 1 verifies that the FCServlet shared library is available on the system. Run this test to confirm that the FlashConnect shared library file, which is a part of FlashConnect Java Components, is properly installed.
Test 2 verifies that the FCService Connectivity exists on the system. Run this test to check if FCService is currently running on the system (confirms whether or not FlashConnect is started.)
Test 3 verifies that FCService is running. Run this test to confirm that FCService is ready and the D3 Server Pool is already started.
Test 4 verifies that the FC Java Native Interface is working properly. Run this test to ensure that the interface layer between the Java application and FCService is working.
Test 5 verifies that the servlet add-on engine is available on the system. Run this test to confirm that the third party servlet engine is installed correctly on the system.

The table below lists each test and explains why each test is passed or failed.

Test Number	Passed	Failed
1	The shared library file is located on the system running FlashConnect.	The FCServlet shared library file is not located on the system. The system cannot run the FCServlet.
2	FlashConnect is running.	FlashConnect is not started yet.
3	D3 is running.	D3 is not started and/or FlashConnect is not started yet.
4	The FC Java Native Interface and the FCService can communicate with each other.	There is broken communication between the FC Java Native Interface and FCService. Check to see if the shared library is installed. It is usually installed in: For UNIX: /usr/bin/lib/FCServlet.so For Windows: C:\Winnt\system32\FCServlet.dll
5	A Java Servlet Engine is installed on the system and available.	A Java Servlet Engine is not configured properly to run FlashConnect, the Web server is not running, the Web server port number is incorrect, or FlashConnect is not running.

To test the FlashConnect Java components:

Select any of the check boxes to run the tests.

The results display in the FCServlet Diagnostic dialog box.

Click Run Check.

After each test completes, a dialog box displays noting whether the test succeeded or failed.

Viewing FCServlet Diagnostic Report

After running tests, view the test report that describes the test results.

To view the report:

Click View Report from the FCServlet Diagnostic dialog box.

The FCServlet Diagnostic Report displays.

Do one of the following:

- Click Save to save the report. Enter the file name for the report, then click OK.
- Click Open to view a report previously saved on the system or, click Browse to locate the file, then click OK.
- Click Reset to clear the report without saving the results.
- Click Exit to close the report and return to the FCServlet Diagnostic dialog box without saving the test results.

Reconfiguring FCServlet Diagnostic Parameters

You can reconfigure the parameters to reflect the current setup of FCServlet on the system.

To reconfigure setup parameters:

Click Reconfigure from the FCServlet Diagnostic dialog box.

The FCServlet Diagnostic Configuration box displays.

Change any of the parameters, then click OK.

Resetting the Test Selection

You can clear the FCServlet Diagnostic dialog box and reselect the tests to perform.

To clear the FCServlet Diagnostic dialog box and select new tests:

Click Reset in the FCServlet Diagnostic dialog box.

The test check boxes and the data in the comments section are cleared.

Select any of the check boxes next to the tests that you want to perform.
Click Run Check.

Viewing Information about the FCServlet Diagnostic Application

You can display the current version and copyright information.

To display version and copyright information:

In the FCServlet Diagnostic dialog box, click About.