netcontool(1M)

NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT VARIABLES | SEE ALSO

NAME

netcontool- network console tool

SYNOPSIS

netcontool

DESCRIPTION

netcontool is a GUI-driven interface to the netcon(1M) command. It accepts configuration information necessary for console connection to the domain specified by the SSP's SUNW_HOSTNAME environment variable, makes that connection, and lets you press buttons that correspond to the escape sequences recognized by the Netcon program. These sequences are described in netcon(1M).

When you execute the netcontool command, the Domain Console Window is displayed with the following buttons enabled:

Exit

Press to exit netcontool.

Configure

Press to display the Console Configuration dialog box (described below).

Connect

Press to begin the Netcon session. If more configuration information is required before the connection can be made, a message to that effect is displayed. In this case, press the Configure button.

The Console Configuration dialog box, which is displayed when you select the Configure button, lets you specify the following information:

Terminal Type

Press the appropriate button to select the terminal type. Note that, in the Domain Console Window, vi(1) runs properly and the escape sequences (tilde commands) work as intended only if the terminal type specified here is the same as the TERM environment variable of the Domain Console Window. For example, if TERM for the Domain Console Window is xterm, it must be xterm (shown as Xterm) here. The default is Xterm.

Session Type

Press the Read Only Session, Unlocked Write (netcon -g), Locked Write (netcon -l) or Exclusive Session (netcon -f) button.

The default setting is Read Only. However, your new session comes up this way only if at least one other session is already running; if yours is the first console session to be started, it comes up in Unlocked Write mode, even if you selected the Read Only button.

When you click the Done button, the Connect button in the window becomes available, and you can press it to start the session. If you have not supplied sufficient configuration information, netcontool displays an error message that states the problem.

When you press Connect, netcontool executes the netcon(1M) program, the Domain Console Window appears in the specified terminal type, and all buttons in the netcontool Window except Configure and Connect become available. These buttons correspond to the escape sequences described in the netcon(1M) man page. The escape sequences cannot be entered from the keyboard while netcontool is in use.

The Domain Console Window acts independently of the netcontool Window during window-management operations.

ENVIRONMENT VARIABLES

The environment variable SUNW_HOSTNAME must be set to the name of the domain.

SEE ALSO

netcon(1M)

NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT VARIABLES | SEE ALSO