Diagnosing FlashConnect Configuration Problems (D3 Only)

The checkup program examines the overall FlashConnect configuration and checks for potential and fatal problems. The checkup program does not change the D3 or FlashConnect configuration.

There are two ways to run the diagnostic:

run bp checkup

When the checkup program starts, the following screen displays:

This program performs simple checks to uncover problems which commonly cause FlashConnect to not work. This program displays as a series of questions and answers. Other than starting this program the user does not enter any information.

Problems which will probably cause FlashConnect to not work or not work with a specific host are labeled 'FATAL'.

Problems which might cause problems while FlashConnect is running are marked, 'NO'.

Tests which pass are marked with 'YES'.

These tests run in a few seconds, do not change the FlashConnect configuration and can be used on a running FlashConnect system.

See the FlashConnect documentation for more information about each test.

Press 'Q' to quit or 'Enter' to continue?

If Q is entered, the program stops without performing any checks.

The report displays fatal errors which indicate that the tested feature will not work:

 

Starting Diagnostic

Verifying that D3 is activated for FlashConnect

Yes

Verifying that this FlashConnect version is activated

Yes

Verifying user licenses are available

Yes ... 50 available

Verifying that phantom processes are available

Yes ... 26 available

Verifying that the database version is supported

Yes ... <version>

 

Can FlashConnect connect to the configured hosts?

 

FC Host Port

 

Local host 1505

FATAL..Could not connect

172.16.250.218 1505

Yes

eng.rainingdata.com 1505

Yes

Are there enough available phantoms to run the:

Minimum number of connections

Yes … Requested 10

Maximum number of connections

Yes … Requested 60

Are there enough available licenses to run the:

Minimum number of connections

Yes … Requested 20

Maximum number of connections

Yes … Requested 60

Do the host names appear valid?

172.16.250.218

Yes

host.rainingdata.com

Yes

Local host

No

Done

 

Message

Example Values

Comments

Starting

 

The program is starting the evaluation.

Checking if FlashConnect is activated.

Yes

FATAL … not activated

FlashConnect must be activated before it can be used.

Are there user licenses available?

Yes ... 5008 available

FATAL no free licenses

Calculates the number of currently available D3 user licenses. If there are no available D3 user licenses FlashConnect cannot run. Either take action to free up user licenses or purchase more licenses.

Are there phantom processes available?

Yes ... 21 available

FATAL no free phantoms

Calculates the number of currently available phantom processes. If there are no available phantom processes D3 cannot run. Either reconfigure D3 making more phantom processes available or take other action to free up phantom processes.

Can this version of D3 run FC?

Yes … <version>

FATAL unsupported version … <version>

FlashConnect requires a minimum D3 release level to run. To run FlashConnect, D3 must be upgraded.

Can FlashConnect connect to the configured hosts?

FC Host Port

  • FC Host Port

  • 172.16.250.218 1505 Yes

  • host.rainingdata.com 1505 Yes

  • local host 1234 FATAL … could not connect.

  • FATAL … could not create socket.

  • No … Cannot open w3Config file

  • No configuration found

Each host/server pool combination defined in the w3Config file is checked to verify that the indicated connection can be reached. This indicates that the host and port can be reached and there is a process servicing the port. It does not verify the listening process is FCService. In addition, the ability to create a socket is verified.

If no configuration is found or the w3Config file cannot be opened, and there are no fatal errors, FlashConnect can be manually started and stopped.

Server pool names are checked for validity. An error message displays the invalid server pool name as well as the formatting rules for server pool names.

Are there enough available phantoms to run the minimum number of connections?

Yes … requested <count>

No … requested <count>

Number of minimum connections for each server pool/host/name combination is totaled and compared to the number of currently available phantom processes. If there are sufficient available phantom processes to run the minimum number of connections, Yes is displayed. If there is an insufficient number of available phantom processes to run the minimum number of connections, No is displayed. The number of minimum requested connections is displayed.

Are there enough available phantoms to run the maximum number of connections?

Yes … requested <count>

No … requested <count>

Number of maximum connections for each server pool/host/name combination is totaled and compared to the number of currently available phantom processes. If there are sufficient available phantom processes to run the maximum number of connections, Yes is displayed. If there is an insufficient number of available phantom processes to run the maximum number of connections, No is displayed. The number of maximum requested connections is displayed.

Are there enough available licenses to run the minimum number of connections?

Yes … requested <count>

No … requested <count>

Number of minimum connections for each server pool/host/name combination is totaled and compared to the number of currently available D3 user licenses. If there are sufficient available D3 user licenses to run the minimum number of connections, Yes is displayed. If there is an insufficient number of available D3 user licenses to run the minimum number of connections, No is displayed. The number of minimum requested connections is displayed.

Are there enough available licenses to run the maximum number of connections?

Yes … requested <count>

No … requested <count>

Number of maximum connections for each server pool/host/name combination is totaled and compared to the number of currently available D3 user licenses. If there are sufficient available D3 user licenses to run the maximum number of connections, Yes is displayed. If there is an insufficient number of available D3 user licenses to run the maximum number of connections, No is displayed. The number of maximum requested connections is displayed.

Do the host names appear valid?

172.16.250.218 Yes

host.rainingdata.com Yes

Local host No

Each host name is examined. If the host name contains a space, it is considered invalid. Otherwise, the host name is considered valid.

None

 

The program has finished the evaluation.

See Also

Debugging and Diagnosing FlashConnect Configuration

Running the Loop-Back Test (D3 Only)

Roving Tandem Debugger

Static Application Debug Strategy

Dynamic Application Debug Strategy

Determining if the Application is in the Debugger

Using the FlashConnect Server Debug Program

Debugging Server Pools

Debugging w3Monitor

Recording Outgoing HTML Code and Incoming Variables

Testing FCService on a Specified Machine and Port

Logging Diagnostic Messages for FCService and FCSocketServer

Examining CGI and Form Variables

Diagnostic Messages Displayed On the Browser

Determining Release Levels