console


Use the console command to connect to the system console from the ALOM command shell. When you use this command, the system displays a standard Solaris login prompt. To exit the system console and return to the ALOM command shell, type #. (pound-period).

Although multiple users can connect to the system console from ALOM, only one user at a time has write access to the system console. Any characters that other users type are ignored. This is referred to as a write lock, and the other user sessions view the console session in read-only mode. If no other users have access to the system console, then the user entering the console session first obtains the write lock automatically by executing the console command. If another user has the write lock, you can use the -f option to force the console to give you the write lock. This forces the other user's connection into read-only mode..

Note: Before you use the -f option, you need to configure both OpenBoot PROM and Solaris operating environment variables on the host server.

How to Use the console Command

Note: You must have c level user permission to use this command.

At the sc> prompt, type the following command:

sc> console option

where option is the option(s) you want to use, if any.

The Solaris system prompt is then displayed.

Note: The Solaris system prompt that appears depends on the default Solaris shell on the host server.

To return to the sc> prompt from the Solaris system prompt, type the escape character sequence. The default sequence is #. (pound-period).

If the admin account has the write lock, ALOM returns the following messages at the console command:

sc> showusers

Username
----------
Connection
-----------
Login Time
-----------
Client IP Addr
---------------
Console
--------
admin serial Nov 13 6:19   system
jeff net-1 Nov 13 6:20 xxx.xxx.xxx.xxx  

sc> console
Enter #. to return to ALOM.

%

If you do not have the write lock, ALOM returns a different message at the console command, as shown in this example:

sc> console

Console session already in use. [view mode]

Enter #. to return to ALOM.

%

If you do not have the write lock and you use the -f option with the console command to obtain the write lock, ALOM returns a message at the console command that is similar to the following:

sc> console -f

Warning: User <admin> currently has write permission to this console and forcibly removing them will terminate any current write actions and all work will be lost. Would you like to continue? [y/n]

 

Command Option

The console command uses one option: -f. This option forces ALOM to release the write lock from another user and assign it to your console session. This places the other user's console session in read-only mode. Using this option returns the following message:

Warning: User <username> currently has write permission to this console and forcibly removing them will terminate any current write actions and all work will be lost. Would you like to continue [y/n]?

At the same time, the user who has the write lock receives the following message:

Warning: Console connection forced into read-only mode.

Configuring the -f Option

Before you use the -f option with the console command, you need to configure variables for both OpenBoot PROM and the Solaris operating environment on your host server.

To configure the OpenBoot PROM variable, type the following command at the ok prompt:

ok setenv ttya-ignore-cd false

For instructions on how to reach the ok prompt, refer to the Administration Guide for your server.

Next, you need to configure the Solaris operating environment. Log in as root and type the following commands at the superuser prompt. Type the second command all on one line, even though it appears on two lines in the example.

# pmadm -r -p zsmon -s ttya


# pmadm -a -p zsmon -s ttya -i root -fu -m
"/dev/term/a:I::/usr/bin/login::9600:ldterm,ttcompat:ttya login\: ::tvi925:n:" -v 1


ALOM shell commands

Permission levels

Serial port variables

Types of ALOM commands