C H A P T E R 4 |
Common Tasks |
Once you have logged in to ALOM CMT as admin and specified the admin password, you might want to perform some common administrative tasks:
There are several ways to connect to ALOM CMT on the system controller:
Ensure that you have established your hardware connections to the system controller ports you plan to use. On your server, the Ethernet port is labeled NET MGT. The serial port is labeled SER 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 CMT through the serial management port for the first time, you are automatically connected as the admin account. This account has full (cuar) permissions. Before you can continue using ALOM CMT, you must specify a password for this account. After you specify the password, you can continue using ALOM CMT. The next time you log in, you must specify the password. When you are logged in as admin, you can add new users and specify passwords and permissions for them.
On systems that support DHCP enabled-by-default you can connect to the network management port prior to connecting to the serial management port. In this case, there is an extra layer of security to ensure that the SC is secure-by-default. You only are allowed to connect with a Secure Shell (ssh) session, and you must provide a system-specific predetermined password. This process is described in Default DHCP Connection. Once the default password is provided and you are allowed to continue, you then must specify a new password for the admin account.
See Permission Levels, useradd, userpassword, and userperm for more information about this process.
To Log In To ALOM CMT |
All users (admin and other users) employ the following procedure to log in to ALOM CMT.
If you connect to ALOM CMT through the SER MGT port, when the connection is established, type #. (Hash-Period) to escape from the system console.
If you connect to ALOM CMT through the NET MGT port, skip to Step 2.
2. Type in your ALOM CMT 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 CMT displays its command prompt:
You can now use ALOM CMT commands or switch to the system console. See ALOM CMT Command Shell Overview and Serial Management Port.
The ALOM CMT event log records login information. If more than five login failures occur within five minutes, ALOM CMT generates a critical event. See showlogs.
Resetting the system controller reboots the ALOM CMT software. You might have to reset the system controller after you have changed settings on ALOM, for example, specifying a new value for certain variables such as netsc_ipaddr.
To Reboot ALOM CMT |
At the sc> prompt, type the resetsc command.
Refer to resetsc.
To Switch Between the System Console and ALOM CMT |
To switch from the console output to the ALOM CMT sc> prompt, type #. (Hash- Period).
To switch from the sc> prompt to the console, type console.
Note - The #. (Hash-Period) character sequence is the default escape character sequence for ALOM CMT. 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 CMT is initially configured to display the system console output. The SER MGT port is shown on the host server as virtual-console.
To Display Your ALOM CMT Version |
For example, to display the ALOM CMT version, type the following at the sc> prompt:
For more details, see To Use the showsc Command.
To Control the Locator LED |
Use ALOM CMT commands to turn the Locator LED on and off, and to check the state of the LED.
To turn the LED on and off use the setlocator command.
For more information refer to setlocator.
To check the state of the LED, use the showlocator command.
For more information refer to ALOM.
To Power the Host Server On and Off |
To power on the server, type the poweron command.
Refer to poweron.
To connect to the system console after powering on the server, type the
poweron -c command.
To perform a graceful reset of the server, type the powercycle command.
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 CMT powers the host server down to standby mode. Refer to powercycle or poweroff.
To force the server to shut down regardless of the state of the host server, type the poweroff -f command.
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.
To Reset the Host Server |
To perform a graceful reset of the server, type the powercycle command.
A graceful reset enables the Solaris OS to shut down. If (instead) you type the poweroff command without typing the poweron command, ALOM CMT powers the host server down to standby mode. Refer to powercycle.
To force the server to shut down regardless of the state of the host server, type the powercycle -f command.
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.
To reset the server immediately without a graceful shutdown, type the reset command.
Refer to reset.
To immediately bring the server to the OpenBoot PROM prompt (ok), type the break command.
Refer to break.
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 View Environmental Information |
Note - You do not need user permissions to use this command. |
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.
Diagnostic control variables specify how ALOM CMT behaves when it encounters an error on the host server.
To Run the setupsc Script |
1. At the sc> prompt type setupsc:
2. To exit the script, take one of the following actions:
For example, the script includes the following messages and questions:
If desired, you can customize all of the ALOM CMT configuration variables at once by following the interactive questions in the script. Refer to ALOM CMT Configuration Variables Overview. To configure only the diagnostic variables, press Return at each prompt until the following prompt is displayed:
See Diagnostic Control Variables for further details.
The system controller's serial management (SER MGT) port can always be used to communicate with an external terminal or other ASCII device. By default, ALOM CMT is also configured to use the Ethernet network management (NET MGT) port using DHCP to obtain network information and accept SSH connections. If desired, the system controller's NET MGT port can be reconfigured or disabled.
The NET MGT port accommodates a standard RJ-45 connector.
Note - When you connect a terminal device to the NET MGT port, the server must be connected to a 10-Mbit or 100-Mbit network. ALOM CMT does not support 1-Gbit networks. |
To reconfigure or disable the NET MGT port, you must specify values for the network interface variables. See Network Interface Variables.
There are two ways to specify values for these variables:
To Configure the Network Interface Variables |
1. At the sc> prompt, type setupsc:
2. Type y to confirm that you want to configure the network interface variables.
The setupsc script returns the following prompt:
3. 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.
4. Follow the interactive questions in the script.
The script prompts you to set values for the following variables:
5. When you finish 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 CMT configuration variables.
Before you can use your network configuration, you must reboot ALOM CMT by resetting the system controller. See To Reboot ALOM CMT.
At the sc> prompt, type the resetsc command.
See resetsc.
You can set values for the network interface variables from the sc> prompt using the setsc command.
Issue the command once for each variable you would like to configure.
Specify values (or use the default values) for each of the following variables:
This section describes the procedure for adding ALOM CMT user accounts.
Note - You can add a maximum of 15 unique user accounts to ALOM CMT. |
To Add an ALOM CMT User Account |
1. At the sc> prompt, type the useradd command, followed by the user name you want to assign to that user.
See useradd.
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 CMT prompts you to specify the password, and to verify the password. Note that ALOM CMT 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.
To View Permissions and Password Status of Users |
You can also view the permission and password status for a single ALOM CMT user, or view information for all ALOM CMT user accounts.
To view the permission and password status for a single ALOM CMT user, at the sc> prompt, type the usershow command followed by the assigned user name.
See usershow.
To see the list of ALOM CMT user accounts, permissions, and password status information, at the sc> prompt type usershow.
sc> usershow Username Permissions Password admin cuar Assigned wwilson --cr none joeuser --cr Assigned |
To remove ALOM CMT user accounts, use the userdel command.
Note - You cannot delete the default admin account from ALOM CMT. |
To Remove an ALOM CMT User Account From the sc> Prompt |
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:
To Change Your ALOM CMT Password |
You can change your own ALOM CMT 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 CMT prompts you for your current password. If you enter the password correctly, it prompts you twice to enter the new password. For example:
sc> password password: Changing password for username Enter current password: ****** Enter new password: ****** Re-enter new password: ****** sc> |
To Change the ALOM CMT Password for Another User |
Note - You must have u level user permission to change another user's password. See userperm. |
At the sc> prompt, use the userpassword command.
See userpassword.
You can customize ALOM CMT to send email alerts to multiple email addresses at the time an event occurs. You can specify at which event level email alerts are sent to each user.
There are three levels of alerts:
Note - You can configure email alerts for up to eight users. |
To Set Up Email Alerts |
1. Ensure that ALOM is set up to use the system controller's Ethernet network management port (NET MGT), and that the network interface variables are configured.
See Reconfiguring ALOM CMT to Use the Ethernet Port.
2. Set the if_emailalerts variable to true.
See if_emailalerts
3. Set values for the mgt_mailhost variable to identify one or two mail hosts on the network.
See mgt_mailhost.
4. Set values for the mgt_mailalert variable to specify email addresses and alert levels for each user.
See mgt_mailalert.
If you are using the ALOM CMT command shell and are not connected to the host server's console, you will receive alert messages from ALOM CMT when it detects a critical-level or major-level event. This can happen while you are typing ALOM CMT commands. If this happens, you can either continue typing or press Control-D and retype the command.
Copyright © 2007, Sun Microsystems, Inc. All Rights Reserved.