Sun Logo


Sun Advanced Lights Out Manager (ALOM) 1.6 Administration Guide

819-2445-11



Contents

Figures

Tables

Code Samples

Preface

1. Introduction to Sun Advanced Lights Out Manager

ALOM Features

What ALOM Monitors

Using ALOM

Fault and Failure Terminology

Fault State

Failed State

Server-Specific Information

Keyswitch/Operation Mode Switch/Rotary Switch

ALOM System Controller Card

System Configuration Card

2. Security Guidelines

Securing the System Controller

Selecting a Remote Connection Type

Enabling Solaris Secure Shell

Instructions to Enable SSH

Features Not Supported by SSH

Changing SSH Host Keys

Solaris Operating System Security

3. Configuring ALOM

ALOM Configuration Steps

Planning Your ALOM Configuration

Choosing ALOM Communication Ports

Serial Management Port

procedure iconsmall spaceTo Connect to the Serial Port

Network Management (Ethernet) Port

Default DHCP Connection (Sun Fire V215, V245, and V445 Servers)

Client Identifier (clientid)

Default Password

High-Level Steps to Use DHCP on a New Out-of-Box System

Configuring an External Modem

Using a Sun Connector

Creating Your Own Connector

Configuration Worksheet

Configuration Variable Worksheet

Related Information

Configuring Your Network Using DHCP

Configuring Your Network Manually

Powering On Your Host Server

Related Information

Configuring Email Alerts

Setting Up Email Alerts

Setting Up ALOM

Customize the ALOM Software

Related Information

4. Common ALOM Tasks

Connecting to ALOM

Logging in to Your ALOM Account

procedure iconsmall spaceTo Log in to ALOM

Related Information

Adding ALOM User Accounts

procedure iconsmall spaceTo Add an ALOM User Account From the sc> Prompt

procedure iconsmall spaceTo Add an ALOM User Account Using the scadm Utility

Removing ALOM User Accounts

procedure iconsmall spaceTo Remove an ALOM User Account From the sc> Prompt

procedure iconsmall spaceTo Remove an ALOM User Account Using the scadm Utility

Changing the Password on Your Account or Another User's Account

procedure iconsmall spaceTo Change Your ALOM Password

procedure iconsmall spaceTo Change the ALOM Password for Another User

Switching Between the System Console and ALOM

Redirecting the System Console From ALOM to Other Devices

procedure iconsmall spaceTo Redirect the System Console

procedure iconsmall spaceTo Reset the Default Console Back to ALOM (ttya)

Reconfiguring ALOM to Use the Ethernet (NET MGT) Port

procedure iconsmall spaceTo Run the setupsc Script

procedure iconsmall spaceTo Configure the Network Interface Variables

Using the setsc Command to Set the Network Interface Variables

Using the scadm set Command to Set the Network Interface Variables

Sending and Receiving Alert Messages

procedure iconsmall spaceTo Set Up Email Alerts

Sending Customized Alerts

Receiving Alerts From ALOM

Resetting ALOM

Resetting the Host Server

Displaying Your ALOM Version

Controlling the Locator LED

Viewing Environmental Information About the Server

procedure iconsmall spaceTo Use the showenvironment Command

Creating a Script to Send Alerts From ALOM

Backing Up Your ALOM Configuration

5. Using the ALOM Command Shell

Overview of the ALOM Command Shell

procedure iconsmall spaceEntering Command Options

Related Information

ALOM Shell Commands

Related Information

Descriptions of ALOM Shell Commands

bootmode

procedure iconsmall spaceTo Use the bootmode Command

Command Options

Related Information

break

procedure iconsmall spaceTo Use the break Command

Command Options

Related Information

console

procedure iconsmall spaceTo Use the console Command

Command Option

procedure iconsmall spaceTo Configure the -f Option

Related Information

consolehistory

procedure iconsmall spaceTo Use the consolehistory Command

Command Options

Related Information

dumpconfig

procedure iconsmall spaceTo Use the dumpconfig Command

Command Options

Related Information

flashupdate

procedure iconsmall spaceTo Use the flashupdate Command

Command Options

Related Information

help

procedure iconsmall spaceTo Use the help Command

Related Information

logout

procedure iconsmall spaceTo Use the logout Command

Related Information

password

procedure iconsmall spaceTo Use the password Command

Password Restrictions

Related Information

poweroff

procedure iconsmall spaceTo Use the poweroff Command

Command Options

Related Information

poweron

procedure iconsmall spaceTo Use the poweron Command

Command Options

Related Information

removefru

procedure iconsmall spaceTo Use the removefru Command

Command Option

reset

procedure iconsmall spaceTo Use the reset Command

Command Options

Related Information

resetsc

procedure iconsmall spaceTo Use the resetsc Command

Command Options

Related Information

restartssh

procedure iconsmall spaceTo Use the restartssh Command

Command Options

Related Information

restoreconfig

procedure iconsmall spaceTo Use the restoreconfig Command

Command Options

Related Information

setalarm

procedure iconsmall spaceTo Use the setalarm Command

Related Information

setdate

procedure iconsmall spaceTo Use the setdate Command

Command Options

Related Information

setdefaults

procedure iconsmall spaceTo Use the setdefaults Command

Command Options

Related Information

setfru

procedure iconsmall spaceTo Use the setfru Command

Command Options

Related Information

setkeyswitch

procedure iconsmall spaceTo Use the setkeyswitch Command

setkeyswitch Command Options

setlocator

procedure iconsmall spaceTo Use the setlocator Command

Command Options

Related Information

setsc

procedure iconsmall spaceTo Use the setsc Command

Related Information

setupsc

procedure iconsmall spaceTo Use the setupsc Command

Related Information

showdate

procedure iconsmall spaceTo Use the showdate Command

Related Information

showenvironment

procedure iconsmall spaceTo Use the showenvironment Command

Related Information

showfru

procedure iconsmall spaceTo Use the showfru Command

Command Options

Related Information

showkeyswitch

procedure iconsmall spaceTo Use the showkeyswitch Command

showlocator

procedure iconsmall spaceTo Use the showlocator Command

Related Information

showlogs

procedure iconsmall spaceTo Use the showlogs Command

Command Options

Related Information

shownetwork

procedure iconsmall spaceTo Use the shownetwork Command

Command Option

Related Information

showplatform

procedure iconsmall spaceTo Use the showplatform Command

Related Information

showsc

procedure iconsmall spaceTo Use the showsc Command

Command Options

Related Information

showusers

procedure iconsmall spaceTo Use the showusers Command

Command Option

ssh-keygen

procedure iconsmall spaceTo Use the ssh-keygen Command

Command Options

Related Information

useradd

procedure iconsmall spaceTo Use the useradd Command

Related Information

userdel

procedure iconsmall spaceTo Use the userdel Command

Command Option

Related Information

userpassword

procedure iconsmall spaceTo Use the userpassword Command

Password Restrictions

Related Information

userperm

Permission Levels

procedure iconsmall spaceTo Use the userperm Command

Related Information

usershow

procedure iconsmall spaceTo Use the usershow Command

Related Information

6. Using ALOM Configuration Variables

Overview of the ALOM Configuration Variables

procedure iconsmall spaceTo Use Configuration Variables in the ALOM Command Shell

Related Information

Serial Management Port Variables

Related Information

Network Interface Variables

Related Information

Managed System Interface Variables

Related Information

Network Management and Notification Variables

Related Information

System User Variables

Related Information

Descriptions of Configuration Variables

if_connection

procedure iconsmall spaceTo Use the setsc Command to Set the if-connection Variable

Related Information

if_emailalerts

procedure iconsmall spaceTo Use the setupsc Command to Set the if_emailalerts Variable

procedure iconsmall spaceTo Use the setsc Command to Change the if_emailalerts Variable

if_network

procedure iconsmall spaceTo Use the setupsc Command to Set the if_network Variable

procedure iconsmall spaceTo Use the setsc Command to Change the if_network Variable

if_modem

procedure iconsmall spaceTo Configure the Serial Management Port to Use a Modem

procedure iconsmall spaceTo Return the Serial Management Port to Use Without a Modem

mgt_mailalert

procedure iconsmall spaceTo Use the setupsc Command to Set the mgt_mailalert Variable

procedure iconsmall spaceTo Use the setsc Command to Change the mgt_mailalert Variable

Related Information

mgt_mailhost

procedure iconsmall spaceTo Use the setsc Command to Change the mgt_mailhost Variable

procedure iconsmall spaceTo Use the scadm Utility to Change the mgt_mailhost Variable

Related Information

netsc_dhcp

Related Information

netsc_enetaddr

Related Information

netsc_ipaddr

Related Information

netsc_ipgateway

Related Information

netsc_ipnetmask

Related Information

netsc_tpelinktest

Related Information

sc_backupuserdata

sc_clieventlevel

Related Information

sc_cliprompt

procedure iconsmall spaceTo Use the setsc Command to Change the sc_cliprompt Variable

procedure iconsmall spaceTo Use the scadm Utility to Change the sc_cliprompt Variable

Related Information

sc_clitimeout

Related Information

sc_clipasswdecho

Related Information

sc_customerinfo

Related Information

sc_escapechars

Related Information

sc_powerondelay

Related Information

sc_powerstatememory

Related Information

ser_baudrate

Related Information

ser_data

Related Information

ser_parity

Related Information

ser_stopbits

Related Information

sys_autorestart

Related Information

sys_bootfailrecovery

Related Information

sys_bootrestart

sys_boottimeout

procedure iconsmall spaceTo Use the setsc Command to Change the sys_boottimeout Variable

Related Information

sys_consolegrablogout

Related Information

sys_enetaddr

Related Information

sys_eventlevel

Related Information

sys_hostname

Related Information

sys_maxbootfail

Related Information

sys_wdttimeout

procedure iconsmall spaceTo Use the setsc Command to Change the sys_wdttimeout Variable

Related Information

sys_xirtimeout

Related Information

7. Using the scadm Utility

Overview of the scadm Utility

procedure iconsmall spaceTo Get Started With the scadm Utility

Related Information

procedure iconsmall spaceTo Set Your Path to the scadm Utility

procedure iconsmall spaceTo Find Your System's Platform Name

Related Information

List of scadm Commands

Summary of scadm Commands

procedure iconsmall spaceTo Use the scadm Commands

Related Information

Descriptions of scadm Commands

scadm consolehistory

procedure iconsmall spaceTo Use the scadm consolehistory Command

Related Information

scadm date

procedure iconsmall spaceTo Use the scadm date Command

Related Information

scadm download

procedure iconsmall spaceTo Use the scadm download Command

Command Option

Related Information

scadm fruhistory

procedure iconsmall spaceTo Use the scadm fruhistory Command

Related Information

scadm help

procedure iconsmall spaceTo Use the scadm help Command

Related Information

scadm loghistory

procedure iconsmall spaceTo Use the scadm loghistory Command

Related Information

scadm modem_setup

Related Information

scadm resetrsc

procedure iconsmall spaceTo Use the scadm resetrsc Command

Command Option

Related Information

scadm send_event

procedure iconsmall spaceTo Use the scadm send_event Command

Related Information

scadm set

procedure iconsmall spaceTo Use the scadm set Command

Related Information

scadm show

procedure iconsmall spaceTo Use the scadm show Command

Related Information

scadm shownetwork

procedure iconsmall spaceTo Use the scadm shownetwork Command

Related Information

scadm useradd

procedure iconsmall spaceTo Use the scadm useradd Command

Related Information

scadm userdel

procedure iconsmall spaceTo Use the scadm userdel Command

Related Information

scadm userpassword

procedure iconsmall spaceTo Use the scadm userpassword Command

Password Restrictions

Related Information

scadm userperm

Permission Levels

procedure iconsmall spaceTo Use the scadm userperm Command

Related Information

scadm usershow

procedure iconsmall spaceTo Use the scadm usershow Command

Related Information

scadm version

procedure iconsmall spaceTo Use the scadm version Command

Related Information

8. Using OpenBoot PROM

Switching Between the ALOM Command Shell and the OpenBoot PROM Prompt

procedure iconsmall spaceTo Switch From the sc> Prompt to the ok Prompt

procedure iconsmall spaceTo Switch From the ok Prompt to the sc> Prompt

The reset-sc Command

The .sc Command

A. Troubleshooting

Modem Configuration Troubleshooting

Troubleshooting ALOM Problems

Using ALOM to Troubleshoot Server Problems

Using the System Console Write Lock

Resetting the Host Server After a Time-out

ALOM Shell Error Messages

Usage Errors

General Errors

FRU Errors

Related Information

scadm Error Messages

B. Understanding the ALOM Watchdog Timer

Driver Properties

ntwdt-autorestart

ntwdt-boottimeout

ntwdt-bootrestart

ntwdt-xirtimeout

ntwdt-maxbootfail

ntwdt-bootfailrecovery

Understanding the User APIs

Setting the Time-out Period

LOMIOCDOGTIME

Enabling or Disabling the ALOM Watchdog

LOMIOCDOGCTL

Patting the ALOM Watchdog

LOMIOCDOGPAT

Getting the State of the Watchdog Timer

LOMIOCDOGSTATE

Data Structures

Watchdog/Reset State Data Structure

Watchdog/Reset Control Data Structure

Error Messages

Sample ALOM Watchdog Program

Glossary

Index