CARIS BASE Editor : BASE Manager : Command Prompt Tools : Bathy DataBASE Diagnostics Tool
 

Bathy DataBASE Diagnostics Tool

The Bathy DataBASE Diagnostics tool (BathyDBDiagnostics) provides various metrics about the network communication with BDB Server. The tool is run using a command window and the results are useful to both the system administrator and Customer Service Advisors for diagnosing problems.

The following is the command line format for the Bathy DataBASE Diagnostics tool:

bathydbdiagnostics --login <value> --server <value> --endpoint_port <value> --endpoint_port_span <value> --ops <value>

The following table describes the parameters available for this process.

Parameter

 

Long

Short

Description

--help

-h

Display the help message (command format and descriptions of the available parameters) for the current command.

--login

-l

The credentials used to log into the Node Manager. They must be entered in the format of:

username/password, or

username/password@hostname,

where hostname is the name or IP address of the computer on which the Node Manager is installed. When hostname is not specified, it is assumed to be the local machine.

--server

-s

The name of the database on the server to log into.

--endpoint_port

Identify the port range by specifying the first port number to be used by the server to communicate with the client.

--endpoint_port_span

The number of ports to include in the range of ports. The default is 15. The server will attempt to connect to each port number in order until it finds a free one.

--ops

-n

The number of times to test the push and pull of data on the server. The default is 4, which means the client would attempt to send (push) data to the server four times, then the server would use a callback to attempt to access (pull) data from the client four times.

To use this command:

1. Launch the BASE Editor <version> Command Prompt window.

 

Menu

Start menu > BASE Editor <version> Command Prompt

Tool

2. Type “BathyDBDiagnostics,” followed by the appropriate parameters.

3. To finish, press <Enter>.

The tables below provide some possible results for a server, where:

the username and password are "loader" and "loader",

the hostname is MyMachine.domain.priv, and

the server you want to log in to is called MyServer.

Example: Successful run

Command Entered

bathydbdiagnostics --login="loader/loader@MyMachine.domain.priv" --server="MyServer"

Results

Testing ICMP network ping:

32 bytes from 192.168.41.93: icmp_seq=1, ttl=125, time=0 ms

Testing port access on MyMachine.domain.priv :

Bathy node manager (51000) : Passed

Naming service (2809) : Passed

Logging service (20000) : Passed

Notification service (5156) : Passed

BathyServer Client using endpoint option: -ORBListenEndpoints iiop://:51101/portspan=15

Connecting to node manager: Passed

Connecting to MyServer: Passed

Testing server ping: Passed

Testing data transfer (client push to server, 64K of data):

(1) Success: time=20ms

(2) Success: time=16ms

(3) Success: time=15ms

(4) Success: time=16ms

Statistics:

Blocks: Pushed = 4, Lost = 0 (0% loss)

Approximate times in milli-seconds:

Minimum = 15ms, Maximum = 20ms, Average = 16ms

Testing server's ability to ping client: Passed

Testing data transfer (server pull from client, 64K of data):

(1) Success: time=27ms

(2) Success: time=19ms

(3) Success: time=19ms

(4) Success: time=18ms

Statistics:

Blocks: Pulled = 4, Lost = 0 (0% loss)

Approximate times in milli-seconds:

Minimum = 18ms, Maximum = 27ms, Average = 20ms

Example: Server is unable to make outward connections

Command Entered

bathydbdiagnostics --login="loader/loader@MyMachine.domain.priv" --server="MyServer" /port="61000"

Results

Testing ICMP network ping:

32 bytes from 192.168.41.93: icmp_seq=1, ttl=125, time=0 ms

Testing port access on MyMachine.domain.priv :

Bathy node manager (51000) : Passed

Naming service (2809) : Passed

Logging service (20000) : Passed

Notification service (5156) : Passed

BathyServer Client using endpoint option: -ORBListenEndpoints iiop://:61000/portspan=15

Connecting to node manager: Passed

Connecting to MyServer: Passed

Testing server ping: Passed

Testing data transfer (client push to server, 64K of data):

(1) Success: time=20ms

(2) Success: time=16ms

(3) Success: time=15ms

(4) Success: time=15ms

Statistics:

Blocks: Pushed = 4, Lost = 0 (0% loss)

Approximate times in milli-seconds:

Minimum = 15ms, Maximum = 20ms, Average = 16ms

Testing server's ability to ping client: Failed [timed out]

Testing data transfer (server pull from client, 64K of data):

(1) Failed [timed out]: time=30000ms

(2) Failed [timed out]: time=30000ms

(3) Failed [timed out]: time=30000ms

(4) Failed [timed out]: time=30000ms

Statistics:

Blocks: Pulled = 0, Lost = 4 (100% loss)

Approximate times in milli-seconds:

Minimum = 30000ms, Maximum = 30000ms, Average = 30000ms

Example: Invalid server name is used

Command Entered

bathydiagnostics --login="loader/loader@MyMachine.domain.priv" --server="WrongServer"

Results

Testing ICMP network ping:

32 bytes from 192.168.41.93: icmp_seq=1, ttl=125, time=0 ms

Testing port access on MyMachine.domain.priv :

Bathy node manager (51000) : Passed

Naming service (2809) : Passed

Logging service (20000) : Passed

Notification service (5156) : Passed

BathyServer Client using endpoint option: -ORBListenEndpoints iiop://:51101/portspan=15

Connecting to node manager: Passed

Connecting to WrongServer: Failed [Failed to obtain client session to database: Bathy object requested does not exist]

Example: Invalid hostname is used

Command Entered

bathydbdiagnostics --login="loader/loader@invalidhostname.domain.priv" --server="MyServer"

Results

Testing ICMP network ping:

invalidhostname.domain.priv : No such host is known

Testing port access on invalidhostname.domain.priv :

Bathy node manager (51000) : Failed [No such host is known]

Naming service (2809) : Failed [No such host is known]

Logging service (20000) : Failed [No such host is known]

Notification service (5156) : Failed [No such host is known]

Example: Firewall blocks client from connecting to server

Command Entered

bathydbdiagnostics --login="loader/loader@AnotherUser.domain.priv --server="MyServer"

Results

Testing ICMP network ping:

32 bytes from 192.168.41.153: icmp_seq=1, ttl=125, time=0 ms

Testing port access on AnotherUser.domain.priv :

Bathy node manager (51000) : Failed [An existing connection was forcibly closed by the remote host]

Naming service (2809) : Failed [An existing connection was forcibly closed by the remote host]

Logging service (20000) : Failed [An existing connection was forcibly closed by the remote host]

Notification service (5156) : Failed [An existing connection was forcibly closed by the remote host]