Command Line Interface User's Guide for NEC ExpressUpdate Chapter1 About Command Line Interface Chapter2 Component management Chapter3 Group management Chapter4 NEC ExpressUpdate Chapter5 Log management Chapter6 Troubleshooting Chapter7 Terminology Rev.1.
Contents Contents............................................................................................................................................................. 2 Trademarks ........................................................................................................................................................ 3 About This Document .......................................................................................................................................
Trademarks NEC EXPRESSBUILDER and NEC ESMPRO are registered trademarks of NEC Corporation. Microsoft, Windows, Windows Vista, Windows Server are registered trademarks or trademarks of Microsoft Corporation in the United States and other countries. All other company, or product names used in this document are registered trademarks or trademarks of their respective trademark owners. Windows 7 stands for Windows® 7 Professional operating system, and Windows® 7 Ultimate operating system.
About This Document This document introduces command line interface of NEC ExpressUpdate. It is a function of the component management utility "NEC ESMPRO Manager". Before attempting to operate the command line interface, read this document so as to gain an adequate understanding of the contents. Attention This document is intended for persons who are familiar with the operating system's functions and operations and the network's functions and setup.
Chapter1 About Command Line Interface 1.1 Overview This document provides information about a Command Line Interface to NEC ExpressUpdate. This interface is executed by 'esmcli' command. IMPORTANT: • 'esmcli' command does not have a function to registering a component to NEC ESMPRO Manager. In case of registering a component, please use NEC ESMPRO Manager's Web interface. • In case of CLI, following characters are not available in group name.
1.3 Configuring examples When the client PC is different from the management PC, log in to the management PC using remote desktop, Telnet/SSH clients, etc.
1.4 Using the command line All commands in this document are executed by 'esmcli' command. When you install NEC ESMPRO Manager, 'esmcli' command is also installed on the following directories. Windows OS: C:\Program Files\ESMPRO\ESMMNG\bin This path is added to the system environment variable "PATH". CHECK: • The Windows path varies if NEC ESMPRO Manager is not installed in the default location. Linux OS: /opt/nec/es_manager/bin A symbolic link to 'esmcli' is created on /usr/bin directory.
Examples When you specify the encrypted password, please input as follows. See 1.4.3Encrypting of the password. esmcli -u Administrator -p {ENC}c10f239c9f7d203fa4424bffb06b6713 When the log in is successful, 'esmcli' prompt is displayed. NEC ESMPRO Manager Version5 Copyright (C) 2004-2011 NEC Corporation. All Rights Reserved. -> 1.4.1.2 Logging out of the shell mode To exit the shell mode, enter the exit command or input Ctrl + C. -> exit 1.4.1.
1.4.2 One liner mode The one liner mode executes only specified CLI command without starting the shell function of esmcli. To execute the one liner mode, enter a CLI command following to a username and password from a command line as shown below. And please input user name and password of NEC ESMPRO Manager. Please refer to "1.5Basic commands" for the CLI command to execute.
Examples When you encrypt the password, please input it as follows. >esmclipasswd password {ENC}c10f239c9f7d203fa4424bffb06b6713 The encrypted password is displayed on the screen.
1.5 Basic commands This section describes basic commands. These basic commands are based on SMASH style proposed by DMTF (Distributed Management Task Force). Help string, command syntax, of each command appears when "-h | -help" option is specified as the of the command. The argument placed between "[" and "]" is omissible. TIP: • In the case of the user authority is Administrator, the user can execute all basic commands.
delete Syntax delete [] [] Description The delete command is used to remove a target. When you omit , the delete command will delete current target. load Syntax load [] [] Description The load command is used to take a binary image from a specific source location and place it at the specified target address. reset Syntax reset [] [] Description The reset command resets the target’s state.
1.5.1 Target Each basic command functions to a specified target. The target points the managed element by address path much like the path to a file in a file system. Both absolute path, which is started from "/", and relative path are available for pointing the target. Specifically, "." and ".." are supported. The "." means the current default target and the ".." means the parent target. Specifying the target, enter following to each basic command.
Examples (1) Shows only targets Show -d Targets (2) Shows target whose name is “server01” and supported commands. show -d targets=server01,verbs (3) Shows property whose name is “Name” or “Status”, and shows supported commands. show -d properties=(Name,Status),verbs 1.5.3 Specific options This section describes NEC ESMPRO Manager specific options. -exclude [,,…] Description Specifies exceptional items. This option is effective when the target is group.
1.6 Example of command output All commands shows results as following format. -> results -> Each status is listed in below table. Status COMMAND COMPLETED COMMAND PROCESSING FAILED COMMAND EXECUTION FAILED Table 1-2 Statuses Description Command was successful. Following commands skips to show this status. • cd • exit • help • how Syntax error was occurred. Command was unsuccessful.
1.7 Diagram of the entire address space A diagram of the entire address space is as follow.
/ repository localsetting remotesetting uppkgs readme logs 17
Chapter2 Component management 2.1 Component information 2.1.1 Showing a list of components 'show' command at following target shows a list of all managed components. • /cmps Properties of this target are as follow. There is no specified command for this target. Property EntryCount Status ExpUpStatus Table 2-1 Properties of '/cmps' Access Description read Displays a number of registered components. read Displays a representative status of all of the components.
2.1.2 Showing component information 'show' command at following target shows information of managed component. • /cmps/ Properties of this target are as follow. There is no specified command for this target. Property Name Status ExpUpStatus Group IpAddress BmcIpAddress Model SerialNumber Guid OsVersion Table 2-2 Properties of '/cmps/' Access Description read Displays a name of the component. read Displays a representative status of all of the components.
Chapter3 Group management 3.1 Group information 3.1.1 Showing a list of groupset 'show' command at the following target shows a list of groupset. • /grps Property of this target is as follow. There is no specified command for this target. Property EntryCount Table 3-1 Properties of '/grps' Access Description read A number of registered groupset. Example 'show' command shows a list of groupset. More concrete examples are as follows.
3.1.2 Showing information of groupset 'show' command at the following target shows information of groupset. • /grps/ Properties of this target are as follow. There is no specified command for this target. Property Name RootGroup Table 3-2 Properties of '/grps/' Access Description read Displays a name of groupset. read Displays root group's name. Example 'show' command shows information of a groupset. More concrete examples are as follows.
3.1.3 Showing information of group 'show' command at the following target shows information of a group. • /grps// Properties of this target are as follow. There is no specified command for this target. Table 3-3 Properties of '/grps//' Access Description read Displays a name of the group. read Displays a status of the group. read Displays an NEC ExpressUpdate status of the group. GroupCount read Displays a number of groups belonging to the group.
Followings are example of the below hierarchy diagram.
Chapter4 NEC ExpressUpdate 4.1 NEC ExpressUpdate information 4.1.1 Displaying NEC ExpressUpdate information 4.1.1.1 Information of components 'show' command at the below target enables you to view NEC ExpressUpdate information about the specified component. • /cmps//map/expup Properties and specific commands of this target are as follows. Table 4-1 Properties of '/cmps//map/expup' Access Description read Displays NEC ExpressUpdate statuses.
Command load stop Table 4-3 Specific commands of '/cmps//map/expup' Description Updates all modules of to the latest version. Refer to section 4.2.1.1 for more information. Cancels all update command to . Refer to section 4.2.4.1 for more information. Example `show /cmps//map/expup` command enables you to view NEC ExpressUpdate information of the component .
Command load stop Table 4-5 Specific commands of '/grps/grpset//expup' Description Updates all modules of components belonging to the specified group to the latest version. Refer to section 4.2.1.3 for more information. Cancels all update command to . Refer to section 4.2.4.2 for more information. Example `show /grps/grpset//expup` command enables you to view NEC ExpressUpdate information of the group.
Example `show /cmps/ /map/expup/mods` command enables you to view a list of modules for the specified component. -> show /cmps/Server01/map/expup/mods ufip=/cmps/Server01/map/expup/mods ufit=mods Targets: "System BIOS" "BMC Firmware" "NEC ExpressUpdate Agent" Properties: EntryCount=3 Verbs: cd exit help show 4.1.2.2 Information of groups A list of modules for components belongings to the specified group is displayed at the below target.
4.1.3 Displaying module information 4.1.3.1 Information of components Information about each module is displayed at the below target. • /cmps//map/expup/mods/ Properties and specific commands of this target are as follows. Table 4-8 Properties of '/cmps//map/expup/mods/' Property Access Description Module read Displays a name of this module. ExpUpStatus read Displays NEC ExpressUpdate status of this module. Each status is listed in Table 4-2.
4.1.3.2 Information of groups Information about each module is displayed at the below target. • /grps/grpset//expup/mods/ Properties and specific commands of this target are as follows. Table 4-10 Properties of '/grps/grpset//expup/mods/' Property Access Description Module read Displays a name of this module. ExpUpStatus read Displays NEC ExpressUpdate status of this module. Each status is listed in Table 4-2.
4.2 Update, install and uninstall 4.2.1 Update commands 4.2.1.1 For the specified component 'load' command at the below target enables you to update all modules to the latest version. • /cmps//map/expup Specific option of this command is as follow. Option -reboot Table 4-12 Specific option of '/cmps/ /map/expup' Description Enables NEC ExpressUpdate to reboot the system if the update requires it.
TIP: • If the update has been finished, the result is shown in LatestApplyResult property of `show /cmps//map/expup/mods/` command. LatestApplyResult=4/1/2011 12:00:00 Applying the update package has been completed successfully. (NEC ExpressUpdate Agent: 2.0 -> 3.0) 4.2.1.2 For the specified component and module 'load' command at the below target enables you to update the module of the component using the specified update package.
4.2.1.3 For the specified group 'load' command at the below target enables you to update all modules of components belonging to the specified group. Refer to the section 4.1.3.1 for more information about this target. • /grps/grpset//expup Specific option of this command is as follow. Option -exclude -reboot Table 4-14 Specific options of '/grps/grpset//expup' Description Specifies components or groups that are not included in this operation.
4.2.2 Install commands 'load' command at below target enables you to install a module. Refer to the section 4.1.3.1 for more information about this target. • /cmps//map/expup/mods/ Specific option of this command is as follow. Table 4-16 Specific options of '/cmps//map/expup/mods/' Option Description -source Specifies the update package. -reboot Enables NEC ExpressUpdate to reboot the system if the installation requires it.
4.2.4 Cancelling update commands 4.2.4.1 For components 'stop' command at below targets enables you to cancel updates. Refer to the section 4.1.1.1 for more information about this target. • /cmps//map/expup There is no specific option for this command. CHECK: • In the case of the user authority is Operator, "Install Update Packages" of the user level must be enabled. TIP: • This command effects only waiting tasks. A task which has been started is unable to be cancelled.
4.3 Repository and Update package management 4.3.1 Repository settings Repository settings are located at the following target. • /repository Properties and specific commands of this target are as follows. Property RepositoryLocation UpdatePackageServerAddress UpdatePkgLatestDownloaded TotalSizeOfUpdatePackage Command set load Table 4-18 Properties of '/repository' Access Description read/write Displays and sets location of the repository.
Examples When you modify location of the repository in remote, run the following command in the remote repository settings have been set. set /repository RepositoryLocation=REMOTE CHECK: • When you set RepositoryLocation in REMOTE, you should set remote repository settings beforehand. See 4.3.1.2Remote repository settings. • In the case of the user authority is Operator, "Change Environment Setting" of the user level must be enabled. 4.3.1.
Examples 'show' command enables you to view local repository settings. -> show /repository/localsetting ufip=/repository/localsetting ufit=localsetting Targets: Properties: RepositoryPassword=***** AutoUpdate=VALID UpdateInterval=EVERY_SATURDAY UpdateStartTime=23:50 ProxyAddress=ProxyPort=0 ProxyUser=ProxyPassword=Verbs: cd exit help show set Examples 'set' command enables you to set one or more local repository settings properties.
4.3.1.2 Remote repository settings Remote repository settings are located at the following target. • /repository/remotesetting Properties and specific commands of this target are as follows. Table 4-22 Properties of '/repository/remotesetting' Property Access Description RemoteRepositoryAddress read/write Sets OS IP address of the other Manager PC. RemoteRepositoryPort read/write Sets port number of the other Manager PC.
• • RemoteRepositoryPassword In the case of the user authority is Operator, "Change Environment Setting" of the user level must be enabled. Examples When you add -force option, properties are set by force. set -force /repository/remotesetting RemoteRepositoryAddress=192.168.0.111 4.3.2 Adding update packages to repository 'load' command at below targets enables you to add or download update packages. • /repository Specific command of this target is as follow. There is no property for this target.
Examples When you stop monitoring during downloading, press "Ctrl + D" key and return to the input prompt. -> load -wait /repository Downloading update packages. Press Ctrl + D to stop monitoring. ... Monitoring was stopped. Run the show command to the repository and you can confirm the command's result from UpdatePkgLatestDownloaded property. Examples 'load -source' command enables you to add update packages to repository. Specify the path of the update package file.
TIP: • When you delete by force, update packages in use by other Manager PC can be removed. 4.3.3.2 Removing the update package Removing update package is located at the following target. • /repository/uppkgs/ Specific command of this target is as follow. There is no property for this target. Command delete Table 4-30 Specific command of '/repository/uppkgs/' Description Removes update package. Specific option of this command is as follow.
4.3.4.2 The update package information Information about the update package is located at the following target. • /repository/uppkgs/ Property of this target is as follow. There is no specified command for this target. Table 4-32 Properties of '/repository/uppkgs/' Property Access Description Module read Displays the name of firmware or software. Version read Displays the version of the update package. Release read Displays the release date of the update package.
Examples 'show' command enables you to view information about the update package. -> show /repository/uppkgs/"NEC ExpressUpdate Agent_Windows_3.00_20110302171440" ufip=/repository/uppkgs/ "NEC ExpressUpdate Agent_Windows_3.00_20110302171440" ufit="NEC ExpressUpdate Agent_Windows_3.00_20110302171440" Targets: readme Properties: Module=NEC ExpressUpdate Agent Version=3.
4.3.4.3 Readme file information After saving the readme file, you can view the readme file written notes about the update package. Information about the readme file in the update package is located at the following target. • /repository/uppkgs//readme Specific command of this target is as follow. There is no property for this target. Table 4-33 Specific command of '/repository/uppkgs//readme' Command Description dump Saves the readme file to specified directory.
Chapter5 Log management 5.1 Logging You can get the following logs. • NEC ESMPRO Manager application log • NEC ExpressUpdate Agent log 5.1.1 Application log list Information of NEC ESMPRO Manager application logs is located at the following target. • /logs Properties and specific commands of this target are as follows. Property EntryCount MaxEntryCount Command dump Option -destination Table 5-1 Properties of '/logs' Access Description read Displays the number of application log.
Examples 'dump' commands enable you to save application logs to the specified directory. Add -destination option, and specify the directory path to save file. The following shows an example. -> dump -destination C:\temp COMMAND COMPLETED C:\temp\LOG.zip If you want to save the application log file any name, specify the zip file name to the path and execute commands. dump -destination C:\temp\application_log.zip /logs When you add -force option, the zip file is overwritten.
5.1.3 NEC ExpressUpdate Agent log Information of NEC ExpressUpdate Agent log is located at the following target. • /cmps//map/agtlogs/expupagtlog IMPORTANT: • In , specify the component that the update function via NEC ExpressUpdate Agent is effective. • To get NEC ExpressUpdate Agent log, NEC ExpressUpdate Agent must be running. Specific command of this target is as follow. There is no property for this target.
Chapter6 Troubleshooting This section describes the error message and the coping method for it. 6.1 Error message Table 6-1 Error messages What to do Please confirm the user name and the password, and please input again. Failed to connect to NEC ESMPRO Windows OS: Manager. Please confirm that the NEC ESMPRO Manager service (ESMPRO/SM Common Component) is running. Error Message User name or password is not correct. Linux OS: Please confirm that the following process is running by `ps aux` command.
Chapter7 Terminology Term CLI BMC DMTF SMASH Address Space Managed Element UFiT UFiP Component NEC ExpressUpdate NEC ExpressUpdate Agent Module Update package Update package server Repository Table 7-1 Terminology Description Command Line Interface Baseboard Management Controller The management controller to manage the interface between system management software and platform hardware. Distributed Management Task Force An industry standard body that defines WBEM standards for the industry.
Revision History 1.00 1.01 2011/05/11 2011/10/13 Initial edition. Changes cover. NEC ESMPRO Manager Ver.