C H A P T E R  1

Features and Issues From 11-2007 to 02-2008

This chapter describes the new features that have been implemented and issues that have been addressed in the ILOM 2.0.x releases between November 2007 and February 2008.


ILOM 2.0.x Cross-Platform Features From 11-2007 to 02-2008

TABLE 1 summarizes the ILOM features that were introduced into the firmware between November 2007 and February 2008. Refer to your platform ILOM Supplement, platform Product Notes, or other platform documentation to determine which of the features applies to a specific platform and specific ILOM firmware release.

The table also includes the Sun internal tracking number (CR) for each feature. Sun Service personnel should refer to the CR number for more information about the feature.


TABLE 1 New ILOM 2.0.x Cross-Platform Features

ILOM Features

Sun Internal Tracking Number (CR)

Power Monitoring Feature Added

6619797

ILOM Service Snapshot Utility Available for x64 Platforms

6647039

Alternative Naming Conventions Supported for Active Directory Group Information

6627792

show faulty Alias Added to ILOM CLI

6551735

show components Alias Added to ILOM CLI

6586938

-o table Option Condenses CLI Output

6544915

Maintenance --> Configuration Management Window Description Revised

6569312


Power Monitoring Feature Added

CR: 6619797

Description: A Power Monitoring feature has been added to ILOM. This feature is managed using the ILOM CLI. The Power Monitoring functionality enables you to perform the following power monitoring tasks:

For more information about the Power Management feature, see Appendix A, Power Consumption Monitoring.

ILOM Service Snapshot Utility Available for x64 Platforms

CR: 6647039

Description: The ILOM Service Snapshot utility gathers service processor (SP) state data on x64 platforms. The utility is not supported on SPARC-based platforms running ILOM 2.0.x.

The ILOM Service Snapshot utility collects log files, runs various commands and collects their output, and sends the data collection as a downloaded file to a user-defined location. This utility enables you to produce a snapshot of the SP at any instant in time. You can run the utility using either the ILOM command-line interface (CLI) or the ILOM web interface. The CLI and web interface procedures follow.



Note - The purpose of the Snapshot utility is to collect data for use by Sun Service personnel to diagnose problems. Customers should not run this utility unless requested to do so by Sun Service personnel.


Run the Snapshot Utility Using the ILOM CLI

To run the Snapshot utility using the ILOM CLI:

1. Log in to the ILOM CLI as Administrator or Operator.

For example:

ssh root@host_ip_address
Password: password

2. Type these commands:

->set /SP/diag/snapshot/dataset=data
->set /SP/diag/snapshot/dump_uri=URI

Where data and URI are one of the following:


Variable

Option

Description

data

normal

Specifies that ILOM, operating system, and hardware information is to be collected.

full

Specifies that all data is to be collected ("full" collection).

Note - Using this option may reset the running host.

normal-logonly or full-logonly

Specifies that only log files are to be collected.

URI

Any valid target directory location

Specifies the URI of the target directory. The URI format is as follows: protocol://username:password@host/directory

For example, to store the snapshot information in the directory named data on the host, define the URI as follows:

ftp://joe:mypasswd@host_IP_address/data

The directory data is relative to the user’s login, so the directory would probably be /home/joe/data.


Run the Snapshot Utility Using the ILOM Web Interface

To run the Snapshot utility using the ILOM web interface:

1. Log in to the ILOM web interface as follows:

a. Open a browser window and enter the URL of the ILOM SP.

For example:

http://system_IP_address

b. Enter your user name and password.

The ILOM web interface appears.

2. Select the Maintenance --> Data Collector tabs.

The Data Collector window appears.


Data Collector window

3. Select the desired Data Set radio button: Normal or Full.

Note that selecting Full may reset the system.

4. Select the desired Log Collection Only radio button: Enable or Disable.

5. Click Run.

A Save As dialog box appears.

6. In the dialog box, specify the directory to which to save the file and the file name.

7. Click Ok.

The file is saved to the specified directory.

Alternative Naming Conventions Supported for Active Directory Group Information

CR: 6627792

Description: The Microsoft Active Directory configured group information supports the standard Distinguished Name (DN) format as well as simple group names.

Group information can be configured in the following ways:

show faulty Alias Added to ILOM CLI

CR: 6551735

Description: The show faulty alias is available for Sun Blade 8000 Series server modules (blades) and SPARC systems only. The alias is a shortcut for the following ILOM command-line interface (CLI) command string:

-> show -o table -level all /SP/faultmgmt

The alias produces the same output as the above command. Thus, it enables users to view all active faults in the system in a concise, tabular form. For example, it produces output similar to the folllowing:


-> show faulty

Target           | Property    | Value
-----------------+-------------+-------------------
/SP/faultmgmt/0  | fru         | /SYS/MB
/SP/faultmgmt/0  | timestamp   | Jan 16 12:53:00
/SP/faultmgmt/0/ | sunw-msg-id | NXGE-8000-0U
faults/0         |             |
/SP/faultmgmt/0/ | uuid        | e19f07a5-580e-4ea0-ed6a-f663aa61
faults/0         |             | 54d5
/SP/faultmgmt/0/ | timestamp   | Jan 16 12:53:00
faults/0         |             | 
 

show components Alias Added to ILOM CLI

CR: 6586938

Description: The show components alias is available for SPARC systems only. The alias is a shortcut for the following command-line interface (CLI) command string:

-> show -o table -level all /SYS component_state

The alias produces the same output as the above command. Thus, it enables users to restrict the table output to a single property below each target. For example, it produces output similar to the following:


-> show components

Target    | Property        | Value
----------+-----------------+--------------
/SYS/FRU1 | component_state | Enabled
/SYS/FRU2 | component_state | Disabled
/SYS/FRU3 | component_state | Enabled

-o table Option Condenses CLI Output

CR: 6544915

Description: The ILOM command-line interface (CLI) option, -o table, condenses the command output to table form. Previously, when you viewed faults using show -level all /SP/faultmgmt for example, several pages of output were produced for just a few faults. Now, when you use the -o table option, the output is formatted in a condensed, three-column table of targets, properties, and values. The following command example shows the new condensed, three-column output:


-> show -o table -level all /SP/sessions
Target          | Property  | Value
----------------+-----------+-------------------------
/SP/sessions/90 | username  | root
/SP/sessions/90 | starttime | Tue Apr 10 10:57:22 2007
/SP/sessions/90 | type      | shell 



Note - The default output of the -o table is DMTF-compliant.


Maintenance --> Configuration Management Window Description Revised

CR: 6569312

Description: In the ILOM web interface, the description of the Configuration Management window has been corrected, making the text more useful. Previously, the description for the Maintenance --> Configuration Management window read as follows:

“Manage the system configuration on this page. Clicking Reset Defaults will restore the system configuration to factory settings.”

This description is not correct because this window is used to manage the service processor (SP), not the system.

The corrected text for the Maintenance --> Configuration Management window is as follows:

“Manage the SP configuration. Clicking Reset Defaults will restore the SP configuration to factory settings.”

To manage the system configuration, you use Remote Control tabs in the ILOM web interface, such as Redirection, Remote Power Control, Mouse Control Settings and Diagnostics.

ILOM 2.0.x Cross-Platform Issues From 11-2007 to 02-2008

TABLE 2 summarizes the ILOM issues reported between November 2007 and February 2008. Refer to your platform ILOM Supplement, platform Product Notes, or other platform documentation to determine which of the issues applies to a specific platform and specific ILOM firmware release.

The table also includes the Sun internal tracking number (CR) for each issue.
Sun Service personnel should refer to the CR number for more information about the issue.


TABLE 2 ILOM 2.0.x Cross-Platform Issues

ILOM Issue

Sun Internal Tracking Number (CR)

ILOM CLI Cannot Properly Parse Values Surrounded by Quotation Marks

6559544

lanplus Interface Recommended for ipmiflash

6597289

<USERNAME> Value of User Domains Table Does Not Appear in Active Directory Web Interface

6641113

Active Directory Web Interface Does Not Display logdetail Trace Messages

6630310

Web Interface Does Not Allow Removal of Active Directory Alternate Server Configurations

6626645

Alternate Server Table Is Misaligned in Active Directory When Using Internet Explorer 6.0

6612204

Alt Graph Key Renders the Keyboard Unusable; Requires a Remote Console Restart

6654272

Certain Keys and Key Combinations Are Unsupported on International Keyboards

6547563

Documentation Updates and Errata

6654413


ILOM CLI Cannot Properly Parse Values Surrounded by Quotation Marks

CR: 6559544

Description: Users are unable to input values in the command-line interface (CLI) that are surrounded by quotation marks. The first character of the string is dropped and the string is incorrectly parsed, which results in a bad value. You need to enclose a value within quotation marks only when the value being entered contains spaces.

Workaround: If you enclose a character string within double quotes, you have to add an extra character to parse the value correctly. For example, if you want to set the LDAP binddn value to "cn=Space Manager,dc=sun,dc=org", you would add an extra, initial character:

-> cd /SP/clients/ldap
-> set binddn="Xcn=Space Manager,dc=sun,dc=org" 

lanplus Interface Recommended for ipmiflash

CR: 6597289

Description: This issue applies to x64 systems only. When using ipmiflash, the lanplus interface is recommended. The alternative interface, called bmc on Solaris and open on Linux, is not designed to handle large amounts of data. Flashing firmware using bmc or open can take over an hour, as opposed to 10 minutes or less for lanplus. For example, suppose you are using the following Linux command:

ipmiflash -I open write imagefile

Or the following Solaris command:

ipmiflash -I bmc write imagefile

Both commands should be changed to:

ipmiflash -I lanplus -H ipaddress imagefile

Where ipaddress is the service processor IP address, and imagefile is the image file being flashed.

Workaround: Use the lanplus interface when using ipmiflash to flash the firmware.

<USERNAME> Value of User Domains Table Does Not Appear in Active Directory Web Interface

CR: 6641113

Description: The <USERNAME> value is not displayed in the User Domains table in the top level of Microsoft Active Directory using the ILOM web interface.

Workaround: Use the ILOM command-line interface (CLI) to view the <USERNAME> value. However, you can verify the <USERNAME> value in the ILOM web interface by clicking the radio button next to any User ID in the User Domains table, then clicking the Edit button.

Active Directory Web Interface Does Not Display logdetail Trace Messages

CR: 6630310

Description: Certain logdetail trace messages and some error messages from Microsoft Active Directory do not display in the ILOM web interface. However, the logdetail trace messages are displayed correctly in the command-line interface (CLI).

Workaround: Use the ILOM CLI to display logdetail trace messages from the Microsoft Active Directory.

Web Interface Does Not Allow Removal of Active Directory Alternate Server Configurations

CR: 6626645

Description: The ILOM web interface does not allow you to remove Alternate Server configurations by setting the address to an empty string.

Workaround: Set the address to 0.0.0.0 to remove Alternate Server configurations.

Alternate Server Table Is Misaligned in Active Directory When Using Internet Explorer 6.0

CR: 6612204

Description: When using the Internet Explorer 6.0 browser, the Microsoft Active Directory’s Alternate Server Table rows are misaligned. As a result, the unset value displays as a “none” check box in Administrator-level access, and as an empty string to users with Operator-level access.

Workaround: This is a browser display issue only, and the inconsistency does not affect the functionality of the Alternate Server table.

Alt Graph Key Renders the Keyboard Unusable; Requires a Remote Console Restart

CR: 6654272

Description: On international keyboards, when running the ILOM Remote Console application (JavaRConsole) in a Windows OS (Java 1.5, 1.6), pressing the Alt Graph key causes the keyboard to become slow or unresponsive in the JavaRConsole window, then ultimately unusable until JavaRConsole is restarted.

Workaround: Restart JavaRConsole and do not press the Alt Graph key. Instead, use the Keyboard menu drop-down list to select the Alt Graph option.

Certain Keys and Key Combinations Are Unsupported on International Keyboards

CR: 6547563

Description: When accessing the ILOM Remote Console application (JavaRConsole) using an international keyboard (non-English), certain international keyboard keys and key combinations operate incorrectly. In addition, this issue applies to some international keys that represent more than one character (for example, Shift and Alt Graph). This issue pertains to the following locales and international keyboards:

Workaround: As of January 31, 2008 all international keyboards listed above have been fixed.

Documentation Updates and Errata

This section describes errors that have been found in the Sun Integrated Lights Out Manager 2.0 User’s Guide (820-1188). Specific change request (CR) identification numbers and workarounds for the issues are provided, where available.


Documentation Issue

Sun Internal Tracking Number (CR)

“Edit Existing IP Addresses in ILOM Using the CLI” Procedure Gives Incorrect Instruction

6654413

-force Option Is Not Described

none


“Edit Existing IP Addresses in ILOM Using the CLI” Procedure Gives Incorrect Instruction

CR: 6654413

Description: A typographical error appears in the following passage in the section titled “Edit Existing IP Addresses in ILOM Using the CLI” in the Sun Integrated Lights Out Manager 2.0 User’s Guide (820-1188-11):

set pendingipaddress=129.144.82.26

set pendingipnetmask=255.255.255.0

set pendingipnetmask=129.144.82.254

set commitpending=true

In the above passage, set pendingipnetmask= appears twice. The second instance should be set pendingipgateway=129.144.82.254.

set pendingipaddress=129.144.82.26

set pendingipnetmask=255.255.255.0

set pendingipgateway=129.144.82.254

set commitpending=true

Workaround: The correct information is documented in the latest version of the Sun Integrated Lights Out Manager 2.0 User’s Guide (820-1188).

-force Option Is Not Described

CR: None

Description: You can use the -force option in the command-line interface to specify that an action will be performed immediately. The -force option works with the start, stop and reset commands.

Workaround: The -force option is documented in the -12 version of the Sun Integrated Lights Out Manager 2.0 User’s Guide (820-1188).