test

Sun Enterprise 10000 SSP 3.5 User Guide

Using netcontool(1M)

The netcontool(1M) GUI program provides the buttons shown in Figure 4-1.

Figure 4-1 netcontool GUI Program

Graphic

Table 4-1 explains the netcontool(1M) buttons.

Table 4-1 netcontool buttons

Button 

Description 

Configure 

Displays the Console Configuration window. See "To Configure the netcontool(1M) Window".

Connect 

Displays the netcon(1M) window and initiates the connection process.

Disconnect 

Disconnects the console window from the domain and removes the console window. The netcontool(1M) window is still available so that you can reconfigure for another connect session.

OBP/kadb 

Breaks to the OpenBoot(TM) PROM (OBP) or kadb(1M) programs.

JTAG 

Toggles the SSP-to-platform connection between a network connection and a JTAG connection. 

Locked Write, Unlocked Write, and Exclusive Write 

Requests the corresponding mode for the console window. For an explanation of the meaning of these modes, see "To Configure the netcontool(1M) Window".

Release Write 

Releases write access and places the console in read only mode. 

Status 

Displays information about all open consoles that are connected to the same domain as the current session, as well as the connection type currently used. 

Help 

Displays information about the netcontool(1M) window.

Exit 

Exits the program and closes the netcon(1M) window if it is still open.

To Display a netcontool(1M) Window From the Command Line

  1. Log in to the SSP as user ssp and type: 


    ssp% domain_switch domain_name
ssp% netcontool &

To Display a netcontool(1M) Window From the CDE Front Panel

  1. From the CDE front panel, select the SSP subpanel and then select the netcontool option.

  2. Specify the domain name when prompted to do so.

To Display a netcontool(1M) Window From the CDE Workspace Menu

  1. From the CDE Workspace menu (right click), select the SSP submenu and then select the netcontool option.

  2. Specify the domain name when prompted to do so.

To Display the netcontool(1M) Window From Hostview

  1. Select a board from the domain for which you want to display a netcontool(1M) window by clicking on that board with the left mouse button.

  2. Select Terminal netcontool.

  3. In the netcontool(1M) window, click the Connect button.

    The netcontool(1M) window (Figure 4-2) is displayed beneath the netcontool(1M) buttons.

    Figure 4-2 netcontool Window in Hostview

    Graphic

To Configure the netcontool(1M) Window

  1. Click the Configure button if you want to configure the netcontool(1M) window before you display a netcon(1M) window.

    The Console Configuration window is displayed (Figure 4-3).

    Figure 4-3 netcontool Console Configuration Window

    Graphic

  2. Select the session type in the left panel, and the terminal emulation type in the right panel.

  3. When you are satisfied with the contents of the window, click Done to accept the settings and dismiss the window, or click Apply to accept the settings without dismissing the window.

    The following table contains the options in the Console Configuration window.

    Table 4-2 Console Configuration Options

    Console 

    Options 

    Default Session 

    Causes the default type of session to be started. If no other session is running, the default is unlocked-write mode. If any other session is running, the default is read-only mode. 

    Read Only Session 

    Displays a console window where you can view output from a domain, but you cannot enter commands. 

    Unlocked Write Session 

    Attempts to display a netcon(1M) window with unlocked write permission. If this attempt succeeds, you can enter commands into the console window, but your write permission is taken away whenever another user requests Unlocked Write, Locked Write, or Exclusive Session permission for the same domain.

    • If another user currently has Unlocked Write permission, it is changed to read-only permission, and you are granted Unlocked Write permission.

    • If another user currently has Locked Write permission, you are granted read-only permission.

    • If another user currently has Exclusive Session permission, you are not allowed to display a netcon(1M) window.

    • If you are granted Unlocked Write permission and another user requests Unlocked Write or Locked Write permission, you are notified and your permission is changed to read only. You can attempt to re-establish Unlocked Write permission at any time, subject to the same constraints as your initial attempt to gain Unlocked Write permission.

    Locked Write 

    Attempts to display a console window with Locked Write permission. 

    • If you are granted Locked Write permission, no other user can remove your write permission unless that user requests Exclusive Session permission.

    • If another user currently has Locked Write permission, you are granted read-only permission.

    • If another user currently has Exclusive Session permission, you are not allowed to display a netcon(1M) window.

    Exclusive Session 

    Displays a console window with Locked Write permission, terminates all other open console sessions for this domain, and prevents new console sessions for this domain from being started. You can change back to multiple session mode by clicking the Release Write button to release write access, or by clicking the Disconnect button to terminate your console session for the domain. You can also simply quit from the console window (using the Control menu of the window). You are not granted Exclusive Session permission if any other user currently has Exclusive Session permission. 

    Terminal Emulation Type 

    The netcon(1M) window is brought up in the specified type of window, otherwise it is grayed out. The xterm(1), dtterm(1), shelltool(1), or cmdtool(1) terminal emulator are available.