dbts Command

Purpose

Debugs a thin server.

Syntax

dbts [-v] ThinServer

Description

The dbts command starts a thin server in the debug mode. The command checks if the thin server was previously started in the debug mode by searching for a debug boot image that is created for the thin server. If none is found, the common image that the thin server is using is cloned and a debug boot image is created from the clone to allow the thin server to boot into debug mode. The debug boot image clone uses the following naming convention:
{COSI name}_{thin server name}-debug
After the thin server is finished using the debug common image, the swts command must be run to switch the thin server to a different common image. The rmcosi command removes the debug common image that is created from the dbts command. The dbts command can run on either a NIM master or a thin server.

Flags

Item Description
-v Enables verbose debug output while the dbts command runs.

Exit Status

Item Description
0 The command completed successfully.
>0 An error occurred.

Security

Access Control: You must have root authority to run the dbts command.

Examples

  1. To debug boot a thin server named lobo that is using a common image named cosi1, enter:
    dbts lobo
    A debug boot image named cosi1_lobo-debug is created to boot lobo into debug mode.

Location

/usr/sbin/dbts

Files

Item Description
/etc/niminfo Contains variables that are used by NIM.