2 - C H A P T E R -

There are two types of connections: telnet and serial. If you are using a telnet connection, configure the system controller network settings before using telnet.You can access the system controller main menu using either the telnet or serial connections.

From the main menu, you can select either the platform shell or one of the domain consoles.

If you select the platform, you always obtain a shell.

If you select a domain, you obtain the:

Domain console (if the domain is active)

Domain shell (if the domain is inactive)

You can also bypass the system controller main menu by making a telnet connection to a specific port.

Obtaining the Platform Shell

This section describes how to obtain the platform shell.

To Obtain the Platform Shell Using telnet

Before you use telnet, be sure to configure the network settings for the system controllers.

1. Obtain the system controller main menu by typing telnet schostname (CODE EXAMPLE 2-1).

where:

schostname is the system controller host name.

The system controller main menu is displayed. CODE EXAMPLE 2-1 shows how to enter the platform shell.

% `telnet` schostname Trying xxx.xxx.xxx.xxx Connected to schostname. Escape character is '^]'. System Controller `schostname': Type 0 for Platform Shell Type 1 for domain A Type 2 for domain B Type 3 for domain C Type 4 for domain D Input: `0` Connected to Platform Shell schostname`:SC`>

CODE EXAMPLE 2-1 Obtaining the Platform Shell With telnet

% telnet schostname

Trying xxx.xxx.xxx.xxx

Connected to schostname.

Escape character is '^]'.

System Controller `schostname':

	Type 0 for Platform Shell

	Type 1 for domain A

	Type 2 for domain B

	Type 3 for domain C

	Type 4 for domain D

Input: 0

Connected to Platform Shell

schostname:SC>

Note - schostname is the system controller host name.

2. Type 0 to enter the platform shell.

The system controller prompt, schostname:SC>, is displayed for the platform shell of the main system controller. If you have a redundant SC configuration, the spare system controller prompt is schostname:sc>.

To Initiate a Serial Connection With tip

At the machine prompt, type tip and the serial port to be used for the system controller session.

machinename% tip port_name

connected

The main system controller menu is displayed.

To Obtain the Platform Shell Using the Serial Port

1. Connect the system controller serial port to an ASCII terminal.

The system controller main menu is displayed.

2. From the main menu type 0 to enter the platform shell.

Obtaining a Domain Shell or Console

This section describes the following:

To Obtain the Domain Shell Using telnet

To Obtain the Domain Shell From the Domain Console

To Obtain the Domain Shell Using telnet

1. Obtain the system controller main menu by typing telnet schostname (CODE EXAMPLE 2-2).

The system controller main menu is displayed.

where:

schostname is the system controller host name.

CODE EXAMPLE 2-2 shows entering the shell for domain A.

% `telnet` schostname Trying xxx.xxx.xxx.xxx Connected to schostname. Escape character is '^]'. System Controller `schostname': Type 0 for Platform Shell Type 1 for domain A Type 2 for domain B Type 3 for domain C Type 4 for domain D Input: `1` Connected to Domain A Domain Shell for Domain A schostname:A>

CODE EXAMPLE 2-2 Obtaining a Domain Shell With telnet

% telnet schostname

Trying xxx.xxx.xxx.xxx

Connected to schostname.

Escape character is '^]'.

System Controller `schostname':

	Type 0 for Platform Shell

	Type 1 for domain A

	Type 2 for domain B

	Type 3 for domain C

	Type 4 for domain D

Input: 1

Connected to Domain A

Domain Shell for Domain A

schostname:A>

2. Enter a domain. Type 1, 2, 3, or 4 to enter the appropriate domain shell.

The system controller prompt for the domain shell you connected to is displayed. CODE EXAMPLE 2-2 shows entering the shell for domain A, whose prompt is
schostname:A>.

3. If the domain is active (the domain keyswitch is set to on, diag, or secure which means you are running the Solaris operating environment, or are in the OpenBoot PROM), perform the following steps:

a. Press and hold the CTRL key while pressing the ] key, to get to the telnet> prompt.

b. At the telnet> prompt type send break (CODE EXAMPLE 2-3).


ok `Ctrl-]` telnet> `send break`

To Obtain the Domain Shell From the Domain Console

If the domain is active and the domain keyswitch is set to on, diag, or secure (you are running the Solaris operating environment, are in the OpenBoot PROM, or are running POST), perform the following steps:

1. Press and hold the CTRL key while pressing the ] key, to get to the telnet> prompt.

2. At the telnet> prompt type send break.

CODE EXAMPLE 2-4 shows obtaining the shell for domain A from the domain console. Because the domain is active, you will not see a prompt.


ok `Ctrl-]` telnet> `send break`

System Controller Navigation

This section explains how to navigate between the:

System controller platform

System controller domain console

System controller domain shell

To return to the originating shell, use the disconnect command. In a domain shell, to connect to the domain console, use the resume command. To connect to a domain shell from the platform shell, use the console command.

FIGURE 2-1 shows how to navigate between the platform shell, the domain shell, the domain console by using the console and disconnect commands. FIGURE 2-1 also shows how to connect to both the domain shell and platform shell from the operating environment by using the telnet command.

FIGURE 2-1 Navigating Between the Platform Shell and the Domain Shell

Diagram that shows how to connect to the domain and platform shells.

In the telnet command in FIGURE 2-1, 5000 is the platform shell and

5001 is domain A

5002 is domain B

5003 is domain C

5004 is domain D

In the console command, domainID is a, b, c, or d.

Note - By typing telnet schostname 500x, you will bypass the system controller main menu and directly enter the platform shell, a domain shell or a domain console.

FIGURE 2-2 illustrates how to navigate between the Solaris operating environment, the OpenBoot PROM, and the domain shell. FIGURE 2-2 assumes that the Solaris operating environment is running.

Caution - Note that in FIGURE 2-2, typing the break command suspends the Solaris operating environment.

FIGURE 2-2 Navigating Between the Domain Shell, the OpenBoot PROM, and the Solaris Operating Environment

Diagram that shows how to navigate between the Solaris operating environment, OpenBoot PROM, and the domain shell.

FIGURE 2-3 illustrates how to navigate between the OpenBoot PROM and the domain shell. This figure assumes that the Solaris operating environment is not running.

FIGURE 2-3 Navigating Between the OpenBoot PROM and the Domain Shell

Diagram that shows how to navigate between the domain shell and the OpenBoot PROM.

When you connect to a domain, you will be connected to the domain shell unless the domain is active, in which case you will be connected to the domain console. When you connect to the console, you will be connected to the Solaris operating environment console or the OpenBoot PROM, depending on which of these is currently executing.

To Enter the Domain Console From the Domain Shell If the Domain Is Inactive

Type setkeyswitch on in the domain shell.

schostname:A> setkeyswitch on

The domain console is available only when the domain is active. To make the domain active, you must turn the keyswitch on. You will be automatically switched from the domain shell to the domain console.

This action powers on and initializes the domain. The domain will go through POST and then the OpenBoot PROM. If the OpenBoot PROM auto-boot? parameter of the setupdomain command is set to true, the Solaris operating environment will boot. For details on the domain parameters, refer to the setupdomain command description in the Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual.

To Enter the Domain Shell From the Domain Console

1. Press and hold the CTRL key while pressing the ] key to get to the telnet> prompt (CODE EXAMPLE 2-5).

2. Type send break at the telnet prompt.


ok `Ctrl-]` telnet> `send break`

To Get Back to the Domain Console From the Domain Shell

1. Type resume:

schostname:D> resume

Note that because the domain is active, you will get a blank line.

2. Press the Return key to get a prompt.

Note - If the domain is not active, (the Solaris operating environment or the OpenBoot PROM is not running), the system controller stays in the domain shell and you will obtain an error.

To Enter a Domain From the Platform Shell

Note - This example shows entering an inactive domain.

Type:

schostname:SC> console -d a

Connected to Domain A

Domain Shell for Domain A

schostname:A>

If the OpenBoot PROM is running, you are returned to the console for domain A. If the keyswitch is set to off or standby, you are returned to the shell for domain A.

Note - To enter another domain, type the proper domainID b, c, or d.

Terminating Sessions

This section describes how to terminate system controller sessions.

To Terminate an Ethernet Connection With telnet

Type the disconnect command at the domain shell prompt.

Your system controller session terminates.

schostname:A> disconnect

Connection closed by foreign host.

machinename%

This example assumes that you are connected directly to the domain and not from the platform shell.

Note - If you have a connection to the domain initiated on the platform shell, you must type disconnect twice.

Typing disconnect the first time takes you back to the platform shell connection and keeps your connection to the system controller. Typing disconnect again exits the platform shell and ends your connection to the system controller.

To Terminate a Serial Connection With tip

If you are connected to the System Controller board with the serial port, use the disconnect command to terminate the system controller session then use a tip command to terminate your tip session.

1. At the domain shell or platform shell prompt, type disconnect.

schostname:A> disconnect

2. If you are in a domain shell and are connected from the platform shell, type disconnect again to disconnect from the system controller session.

schostname:SC> disconnect

The system controller main menu is displayed.

3. Type ~. to end your tip session (CODE EXAMPLE 2-6).


System Controller `schostname': Type 0 for Platform Shell Type 1 for domain A Type 2 for domain B Type 3 for domain C Type 4 for domain D Input: `~.` machinename`%`

The machinename% prompt is displayed.