Command connectivity options

This topic describes the command connectivity options, which are a set of parameters that relate to the ASU connection on the IMM.

The connectivity options might be required when you connect the ASU to a local IMM. When you attempt to connect the ASU to a local IMM and none of the connectivity parameters are specified, the ASU attempts to connect to the IMM by using the default LAN over USB interface settings.

The default settings include user ID, password, and host. The values for these settings are defined by the IMM hardware. If none of these settings are specified on a local connection and the default LAN over USB interface settings fail, the ASU attempts to connect over the KCS interface. The KCS interface does not require any of these parameters.

To connect the ASU remotely to the IMM, also referred to as out-of-band way, the host, "user, and password must all be specified. Beginning with version 9.41, ASU will not provide a default user and password in out-of-band way.

ASU also supports connecting the ASU remotely to the IMM with the mtsn parameter, which is a string composed with machine type and model and serial number if the server running ASU and the IMM are in one LAN.

When mtsn is specified, the net parameter is optional. The net parameter is used to specify the network interface through which the ASU sends messages to a LAN.

If the mtsn and net parameters are specified, the ASU tries to search the target IMM whose machine type, model, and serial number are equal to the mtsn parameter in the LAN the network interface specified by the net parameter is in. If the mtsn parameter is specified and the net parameter is not specified, the ASU will try to search the target IMM whose machine type, model, and serial number are equal to the mtsn parameter in the LAN to which the server running ASU is linked.

If the server running ASU has more than one network interface that is linked to different LANs, ASU tries to search the target IMM in the LANs one by one. After the target IMM is found, ASU obtains the host IP address from the target IMM and tries to use it to connect to the IMM.

In the Linux version of ASU, the net parameter should be the name of the network interface, such as eth0, eth1, lo, and so on.

In the Windows version of ASU, the net parameter should be an integer that indicates the index of the network interface. You can use the command arp -a to get all of the indexes of the network interfaces that exist. For example, the information in the following table may be shown when you use the command: arp -a:

Table 1. Show network interface.

Interface : 9.111.23.166 --- 0xc
Internet address Physical address Type
9.111.23.1 00-00-0c-07-ac-01 dynamic
9.111.23.3 d4-d7-48-bc-82-40 dynamic
9.111.23.4 d4-d7-48-bc-a1-c0 dynamic
9.111.23.255 ff-ff-ff-ff-ff-ff static
224.0.0.22 01-00-5e-00-00-16 static
224.0.0.252 01-00-5e-00-00-fc static
239.255.255.253 01-00-5e-7f-ff-fd static
255.255.255.255 ff-ff-ff-ff-ff-ff static
Interface: 9.111.30.161 --- 0xf    
Internet address Physical address Type
9.111.30.1 00-00-0c-07-ac-01 dynamic
9.111.30.255 ff-ff-ff-ff-ff-ff static
224.0.0.252 01-00-5e-00-00-fc static
255.255.255.255 ff-ff-ff-ff-ff-ff static

Table 56 shows two interfaces whose indexes are 0xc and 0xf and whose IP addresses are 9.111.23.166 and 9.111.30.161, respectively. The indexes shown in Table 56 are in hexadecimal format. Before being input to ASU as the --net parameter, they should be transferred to decimal integers.

In the following example, the two decimal integers should be 12(0xc) and 15(0xf). If you want ASU to scan IMMs in the LAN to which the network interface 12 is linked, add --net 12 to the list of parameters for the ASU command.

Command Example:
C:\asu>asu.exe show BootOrder.BootOrder --mtsn  791525Z06CNZ14 --net 10 
--user USERID --password PASSW0RD
Lenovo Advanced Settings Utility version 9.41.__
Licensed Materials - Property of Lenovo
(C) Copyright Lenovo Corp. 2007-2013 All Rights Reserved
Searching for IMM's IP Address...
Round: 1
Round: 2
The Target IMM's IP Address is:9.111.66.95
Connected to IMM at IP address 9.111.66.95
BootOrder.BootOrder=Legacy Only=CD/DVD Rom=Hard Disk 0=Hard Disk 1=Hard Disk 2
The mtsn and net parameters are only suitable for IMM-based servers, not CMM, AMM, and Blade servers. They are also not suitable for ESXi. ASU supports the mtsn and net parameters in ASU version 9.41 and later. The commands supported by the mtsn and net parameters are listed below.
Command Description
show Display IMM server setting
set Update IMM server setting
showdefault Display IMM default server setting
showvalues Display IMM values server setting
showgroups Display IMM setting for server groups
batch Execute several ASUcommands simultaneously
createuuid Generate a UUID value and set it
Comparedefault Compare the default value with the current value
delete Delete an instance of a setting
deletecert Delete an IMM certificate
export Export an IMM certificate
generate Generate a selected certificate
help Show description for selected settings
import Import a certificate into the IMM
loaddefault Load the default value
rebootimm Reboot IMM
replicate Replicate settings saved in a settings file
restore Restore settings saved in a settings file
save Save all or some settings to a settings file
setenc Apply an encrypted value to a setting

Any local or remote LAN over USB connection requires authentication. The default authentication parameters are the default user ID and password that come configured with each IMM. For the default authentication settings, see the documentation that comes with the server or optional devices.

Table 2. Command connectivity options
Connectivity option Description Syntax
host Specifies the host name or IP address of the IMM to which the ASU should connect. asu cmd [command_modifier] options --host host_name|ip asu cmd [command_modifier] options --host=host_name | ip
mtsn Specifies the machine type and model and serial number of the IMM to which the ASU should connect asu cmd [command_modifier] options --mtsn machinetype_model_ serialnumber asu cmd [command_modifier] options --mtsn=machinetype_model_serailnumber
net When the mtsn parameter is specified, the net parameter is optional to specify the network interface of the server running ASU. asu cmd [command_modifier] options --net network_interface asu cmd [command_modifier] options --net=network_interface
user Specifies the user name to use when you are authenticating with the IMM. asu cmd [command_modifier] options --user user_id asu cmd [command_modifier] options --user=user_id
password Specifies the password to use when you are authenticating with the IMM. asu cmd [command_modifier] options --password password asu cmd [command_modifier] options --password=password
password-file Specifies the name of a file that contains the password to use when you are authenticating with the IMM. asu cmd [command_modifier] options --password-file file_name asu cmd [command_modifier] options --password-file=file_name
kcs

Specifies to send commands by using the KCS IPMI interface only.

This option requires the IPMI device driver. For more information, see IPMI device driver support for Windows or IPMI device driver support for Linux.

This option does not require authentication.

asu cmd [command_modifier] options --kcs