|C H A P T E R 3|
Common ALOM Tasks
Once you have logged in to ALOM as admin and specified the admin password, you might want to perform some common administrative tasks:
Here are several ways to connect to ALOM:
Resetting ALOM reboots the ALOM software. You might have to reset ALOM after you have changed settings on ALOM, for example, specifying a new value for certain variables such as for netsc_ipaddr.
At the sc> prompt, type the resetsc command.
Refer to resetsc.
Note - The #. (Pound-Period) character sequence is the default escape character sequence for ALOM. If desired, you can change the first character in the escape sequence by using the sc_escapechars variable. For example, sc> setsc sc_escapechars a. See sc_escapechars for more information.
When you first start to apply power to the host server, ALOM is initially configured to display the system console output. The SER MGT port is shown on the host server as virtual-console.
The showsc command displays information about the ALOM software configuration.
For example, to display the ALOM version, type the following at the sc> prompt:
For more details, see To Use the showsc Command.
Use ALOM commands to turn the Locator LED on and off, and to check the state of the LED.
There are several ways to power the host server on and off from the sc> prompt.
A graceful reset enables the Solaris Operating System (Solaris OS) to shut down. If (instead) you type the poweroff command without typing the poweron command, ALOM powers the host server down to standby mode. Refer to powercycle or poweroff.
This resets the host server immediately, even if the Solaris OS fails or hangs for any reason. Note that this is not a graceful shutdown, and work might be lost.
There are four ways to reset the host server from the sc> prompt:
A graceful reset enables the Solaris OS to shut down. If (instead) you type the poweroff command without typing the poweron command, ALOM powers the host server down to standby mode. Refer to powercycle.
This section discusses displaying and monitoring the server's environmental status.
The showenvironment command displays a snapshot of the server's environmental status. The information this command can display includes system temperatures, hard disk drive status, power supply and fan status, front panel LED status, voltage and current sensors, and so on.
To use the showenvironment command, at the sc> prompt, type:
The display output differs according to your host server's model and configuration. Some environmental information might not be available when the server is in standby mode. See showenvironment.
By default, ALOM uses the serial management port (SERIAL MGT) to communicate with an external terminal or other ASCII device. If desired, you can reconfigure ALOM to use the Ethernet network management (NET MGT) port, and then you can connect to ALOM through telnet.
The NET MGT port accommodates a standard RJ-45 connector.
To configure the ALOM software to communicate using the NET MGT port, you need to specify values for the network interface variables. See Network Interface Variables.
There are two ways to specify values for these variables:
1. To run the setupsc script, at the sc> prompt type setupsc:
The setup script starts.
2. To exit the script, take one of the following actions:
For example, the script includes the following messages and questions:
Entering interactive script mode. To exit and discard changes to that point, use Ctrl-C or to exit and save changes to that point, use Ctrl- Z.
If desired, you can customize all of the ALOM configuration variables at once by following the interactive questions in the script. Refer to Overview of the ALOM Configuration Variables. To configure only the network interface variables, press Return at each prompt until the following prompt is displayed:
See Network Interface Variables for further details.
1. At the sc> prompt, type y to confirm that you want to configure the network interface variables.
The setupsc script returns the following prompt:
2. Type y or press Return to enable the network interface, or type n to disable it.
This sets a value for the if_network variable. See if_network.
3. Follow the interactive questions in the script. The script prompts you to set values for the following variables:
4. When you have finished setting up the network interface variables, type Control-Z to save your changes and exit the setupsc script.
If desired, you can finish configuring all of the ALOM configuration variables.
Before you can use your network configuration, you must reset ALOM.
At the sc> prompt, type the resetsc command.
You can set values for the network interface variables from the sc> prompt using the setsc command. You issue the command once for each variable you would like to configure. For example:
Specify values (or use the default values) for each of the following variables:
This section describes the procedure for adding ALOM user accounts.
1. At the sc> prompt, type the useradd command, followed by the user name you want to assign to that user.
2. To assign a password to an account, type the userpassword command followed by the user name you assigned to the account.
For more on the userpassword command, refer to userpassword. ALOM prompts you to specify the password, and to verify the password. Note that ALOM does not echo the password to the screen. For example:
Note - User passwords have certain restrictions. Make sure that the password you assign observes these restrictions. See Password Restrictions.
3. To assign permissions to an account, type the userperm command followed by the user name you assigned to the account and the permission levels you want that user to have.
For further information, see userperm or Permission Levels.
You can also view the permission and password status for a single ALOM user, or view information for all ALOM user accounts.
To remove ALOM user accounts, use the userdel command.
To remove an ALOM user account from the sc> prompt, perform the following step:
At the sc> prompt, type the userdel command followed by the user name of the account you want to delete.
You can change your own password or that of another user by following these steps:
You can change your own ALOM account password from the sc> prompt. You do not need to have any permissions to change your own password.
At the sc> prompt, type the following command:
When you use this command, ALOM prompts you for your current password. If you enter the password correctly, it prompts you twice to enter the new password. For example:
Note - You must have u level user permission to change another user's password. See userperm.
To change the password for another user's ALOM account:
At the sc> prompt, use the userpassword command.
You can customize ALOM to send email alerts to all users logged in to ALOM at the time an event occurs. You can specify at which event level (critical, major, minor) email alerts are sent to each user, and you can send customized event messages as emails to each user.
The ALOM software enables you to send and receive alerts directly or using a script. There are three levels of alerts:
1. Ensure that ALOM is set up to use the Ethernet network management port (NET MGT), and that the network interface variables are configured.
See Reconfiguring ALOM to Use the Ethernet Port.
2. Set the if_emailalerts variable to true.
3. Set values for the mgt_mailhost variable to identify one or two mail hosts on the network.
4. Set values for the mgt_mailalert variable to specify email addresses and alert levels for each user.
If you are using the ALOM command shell and are not connected to the host server's console, you will receive alert messages from ALOM when it detects a critical-level or major-level event. This can happen while you are typing ALOM commands. If this happens, press Return and retype the command.
Ensure that you have established your hardware connections to the ALOM ports you plan to use. On your server, the Ethernet port is labeled NET MGT. The serial port is labeled SERIAL MGT. Refer to your server's installation guide for more information about these ports and how to connect devices to them.
When you connect to ALOM for the first time, you are automatically connected as the admin account. This account has full (cuar) permissions. Before you can issue any of ALOM's privileged commands, you need to specify a password for this account. After you specify the password, you can issue privileged commands. The next time you log in to the admin account, you must specify the password. When you are logged in as admin, you can add new users and specify passwords and permissions for them.
Refer to useradd, userpassword, and userperm for more information about this process.
All users (admin and other users) employ the following procedure to log in to ALOM.
1. Connect to ALOM.
See Connecting to ALOM.
2. When the connection is established, type #. (Pound-Period) to escape from the system console.
3. Type in your ALOM login name and password.
Your password is not echoed to the screen; instead, the host server displays an asterisk (*) for each character that you type. After you successfully log in, ALOM displays its command prompt:
You can now use ALOM commands or switch to the system console. See Overview of the ALOM Command Shell and Serial Management Port.
The ALOM event log records login information. If more than five login failures occur within five minutes, ALOM generates a critical event. See showlogs.