C H A P T E R 13

Managing Remote Host Power States, BIOS Boot Device, and Host Server Console

Topics
Description | Links
--- | ---
Control the power state of a remote server module | Issuing Remote Power State Commands for Host Server or CMM
Remote Host Control - Boot Device on x86 system SP | Managing BIOS Boot Device on x86 Hosts
Learn how to start the Host Console, change the display properties, as well as view the console history or bootlog. | Managing the Host Console

Related Topics
For ILOM | Chapter or Section | Guide
--- | --- | ---
Concepts | Remote Host Management Options | Oracle Integrated Lights Out Manager (ILOM) 3.0 Concepts Guide (820-6410)
Web interface | Managing Remote Hosts Power States | Oracle Integrated Lights Out Manager (ILOM) 3.0 Web Interface Procedures Guide (820-6411)
The ILOM 3.0 Documentation Collection is available at: `http://docs.sun.com/app/docs/prod/int.lights.mgr30#hic`.

##

Issuing Remote Power State Commands for Host Server or CMM

Topics
Description | Links | Platform Feature Support
--- | --- | ---
Manage remote power control of host server | Issue Remote Power State Commands From Server SP or CMM CLI | x86 system server SP SPARC system server SP CMM

### Issue Remote Power State Commands From Server SP or CMM CLI

From a command window or terminal, you can issue the following commands that are described in TABLE 13-1 and TABLE 13-2 to remotely control the power state of a host server or CMM.

TABLE 13-1 Server SP Remote Power State Commands
Power State Command | Description | Command Syntax Example
--- | --- | ---
`start` | Use the `start` command to turn on full power to the remote host server. To issue the `start` command: |
From the server SP CLI, type: | `start /SYS`
From CMM CLI for a blade server with a single dedicated SP, type: | `start /CH/BL` n`/SYS`
From CMM CLI for a blade server with two dedicated SPs, type: | `start /CH/BL` n`/NODE` n`/SYS`
`stop` | Use the `stop` command to shut down the OS gracefully prior to powering off the host server. To issue the `stop` command: |
| From the server SP CLI: | `stop /SYS`
| Form the CMM CLI for a blade server with a single dedicated SP: | `stop /CH/BL` n`/SYS`
| For blade server with two dedicated SPs: | `stop /CH/BL` n`/NODE` n`/SYS`
`stop -force` | Use the `stop``` `-force` command to immediately turn off the power to the remote host server. To issue the `stop -force` command: |
From the server SP CLI, type: | `stop -force /SYS`
From CMM CLI for blade server with single dedicated SP, type: | `stop -force /CH/BL` n`/SYS`
From CMM CLI for a blade server with two dedicated SPs, type: | `stop -force /CH/BL` n`/NODE` n`/SYS`
`reset` | Use the `reset` command `to immediately` reboot the remote host server. To issue the `reset` command: |
From the server SP CLI, type: | `reset /SYS`
From CMM CLI for a blade server with single a dedicated SP, type: | `reset /CH/BL` n`/SYS`
From CMM CLI for a blade server with two dedicated SPs, type: | `reset /CH/BL` n`/NODE` n`/SYS`

TABLE 13-2 Chassis Monitoring Module (CMM) Remote Power State Commands
Power State Command | Description | Command Syntax Example
--- | --- | ---
`start` | Use the `start` command to turn on full power to the remote chassis. To issue the `start` command to the remote chassis from the CMM CLI, type | `start /CH`
stop | Use the stop command to shut down the power on the chassis and its components gracefully. To issue the `stop` command to the remote chassis from the CMM CLI, type: | `stop /CH`
`stop -force` | Use the `stop` `-force` command to immediately turn off the power to the chassis and its components. To issue the `stop` `-force` command to the remote chassis from the CMM CLI, type: | `` `` `` `` `stop -force /CH`

For information about connecting to a host server or issuing commands from the ILOM CLI, see Configuring ILOM Communication Settings.

##

Managing BIOS Boot Device on x86 Hosts

Topics
Description | Links | Platform Feature Support
--- | --- | ---
Review the prerequisites | Before You Begin | x86 system server SP
Control BIOS boot device order | Configure BIOS Host Boot Device Override

### Before You Begin

- The Reset and Host Control (`r`) role is required to change the host boot device configuration variable.

Note - The Host Control BIOS boot device feature is supported on x86 system SPs. This feature is not supported on the CMM or on SPARC system SPs. For information about ILOM Host Control boot options on SPARC systems, consult the online ILOM Supplement guide or platform Administration guide provided for that system.

Follow the steps in the following procedure to override the BIOS boot device setting from ILOM by using the Host Control features.

### Configure BIOS Host Boot Device Override

1. Log in to the ILOM SP CLI.

2. Use the `cd` and `show` commands to navigate to the host system.

For example:

    ->cd /HOST
    /HOST

    ->show

    /HOST
       Targets:
           diag

       Properties:
           boot_device = default
           generate_host_nmi = (Cannot show property)

       Commands:
           cd
           set
           show

3. To set the host boot device for the next time the system is powered on, type:

`->``set boot_device=`value

Possible values are:

- `default` - Setting the value to `default` means that there is no override to the BIOS settings. Setting to `default` will also clear any previously chosen selection.

- `pxe` - Setting the value to `pxe` means that at the next host boot, the BIOS boot order settings will be temporarily bypassed and instead the host will boot from the network, following the PXE boot specification.

- `disk` - Setting the value to `disk` means that at the next host boot, the BIOS boot order settings will be temporarily bypassed and instead the host will boot from the first disk as determined by BIOS. The specific disk chosen depends on configuration. Typically, hosts use this option by default and the host's behavior might not change by selecting this option.

- `diagnostic` - Setting the value to `diagnostic` means that at the next host boot, the BIOS boot order settings will be temporarily bypassed and instead the host will boot into the diagnostic partition, if configured.

- `cdrom` - Setting the value to `cdrom` means that at the next host boot, the BIOS boot order settings will be temporarily bypassed and instead the host will boot from the attached CD-ROM or DVD device.

- `bios` - Setting the value to `bios` means that at the next host boot, the BIOS boot order settings will be temporarily bypassed and instead the host will boot into the BIOS Setup screen.

##

Managing the Host Console

Topics
Description | Links | Platform Feature Support
--- | --- | ---
Review the prerequisites | Before You Begin | x86 system server SP SPARC server
View and set Host Console properties | View and Configure Host Console Properties
Start Host Console and view Console History or Bootlog History | Start Host Console and Display Console History and Bootlog

### Before You Begin

- To change the Host Console properties, you must have the Admin (`a`)role enabled.

- As of ILOM 3.0.12, Host Console properties (`line_count,` `pause_count` and `start_from`) are no longer persistent across all sessions. The values for these properties are valid only for the length of that particular spsh session.

### View and Configure Host Console Properties

1. Log in to the ILOM SP CLI.

2. Use the `cd` and `ls` commands to navigate to the host console properties.

For example:

    -> cd /HOST/console
    /HOST/console

    -> ls

     /HOST/console
        Targets:
            history

        Properties:
            escapechars = #.
            line_count = 0
            pause_count = 0
            start_from = end

        Commands:
            cd
            show
            start
            stop

Note - Each time an spsh session is started, it initializes these properties to their default values: l`ine_count` `=` `0`, `pause_count` `=` `0`, `start_from` `=` `end`. The values for these properties are valid only for the length of that particular spsh session.

3. Use the `help` command to view descriptions about the Host Control proeprties.

For example:

    -> help escapechars
        Properties:
            escapechars : set escape chars using the console connection
            escapechars : User role required for set = a

    -> help line_count
        Properties:
            line_count : total number of lines to display
            line_count : Possible values = 0-2048 where 0 means no limit
            line_count : User role required for set = c

    -> help pause_count
        Properties:
            pause_count : number of lines to display before each pause
            pause_count : Possible values = 0-2048 where 0 means no limit
            pause_count : User role required for set = c

    -> help start_from
        Properties:
            start_from : from which end of the available history to list
            start_from : Possible values = beginning,end
            start_from : User role required for set = c

4. Use the `set` command to configure the Host Console properties.

For example:

- To set a value for the `line_ count` property, type

-> `set line_count=`value

Where value can range from 1 to 2048 lines.

- To set a value for the `pause_count` property, type:

-> `set pause_count=`value

Where value can range from 1 to any valid integer or for infinite number of lines. The default is not to pause.

- To set a value for the `start_from` property, type:

-> `set start_from=`value

Where the value can equal end or beginning. The end value is the last line (most recent) in the buffer (the default). The beginning value is the first line in the buffer.

- To set a value for `escapechars`, type:

->`set escapechars=`value

Where the value is limited to two characters. The default value is `#.` (Hash-Period).

Note - The `/SP/console` `escapechars` property enables you to specify an escape character sequence to use when switching from a system console session back to ILOM. Changing the escape character does not take effect in a currently active console session.

### Start Host Console and Display Console History and Bootlog

1. Log in to the ILOM SP CLI.

2. Set the Host Console display properties, see View and Configure Host Console Properties.

Note - As of ILOM 3.0.12, Host Console properties (`line_count,` `pause_count` and `start_from`) are no longer persistent across all sessions. The values for these properties are valid only for the length of that particular spsh session.

3. To start the host console, type:

->`start /SP/console`

4. To display the Console History, type:

-> `show /SP/console/history`

The Console History buffer is a circular buffer that can contain up to 1 Mbyte of information. The buffer captures all POST and boot information as well as any OS information that is controlled through the Host Console.

5. To display the Bootlog type:

->`show /SP/console/bootlog`

The Bootlog tracks the systems’s start-up progress and logs any problems that might occur.

Copyright © 2010, Oracle and/or its affiliates. All rights reserved.