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 CARIS Customer Services for diagnosing problems.

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

BathyDBDiagnostics [/h] /l <str> /s <str> [/port <num>] [/span <num>] [/n <num>]

Parameters in square brackets (“[...]”) are optional.

The following table describes the parameters available for this process.

Parameter

Description

/h

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

/l

The credentials used to login to 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.

/s

The name of the server to log in to.

/port

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

/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.

/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

Example: Server is unable to make outward connections

Example: Invalid server name is used

Example: Invalid hostname is used

Example: Firewall blocks client from connecting to server