HP Virtual Connect Enterprise Manager 6.3.1 CLI Guide
Table Of Contents
- HP Insight Software Virtual Connect Enterprise Manager
- Contents
- 1 Getting Started
- 2 Using VCEMCLI
- 3 Using VCEM commands
- add profile
- set profile
- assign profile
- export profiles
- unassign profile
- add enet-connection
- set enet-connection
- remove enet-connection
- add fc-connection
- set fc-connection
- remove fc-connection
- add fcoe-connection
- set fcoe-connection
- remove fcoe-connection
- add iscsi-connection
- set iscsi-connection
- remove iscsi-connection
- set iscsi-boot-param
- remove iscsi-boot-param
- add server-port-map
- set server-port-map
- remove server-port-map
- poweroff devicebay
- poweron devicebay
- show power-status
- show job
- show version
- show vcem-status
- startvcdmaint
- cancelvcdmaint
- completevcdmaint
- 4 Error messages
- 5 Troubleshooting VCEMCLI
- VCEMCLI calls result in access denied errors
- VCEMCLI calls result in errors for invalid leading character or invalid characters
- VCEMCLI calls result in 404 errors
- API timeouts
- High CPU usage on the CMS server while running a VCEMCLI client
- Job reports failed status
- Completed with warning job status
- Unable to assign a profile to a Domain Group
- VC Domain reports Configuration Mismatch status
- VC Domain reports Expired License status
- Error on database operation occurs
- Failed to execute VCEM operation because VC firmware not supported
- Creating a server profile fails
- Server profile edit operation fails when target server is powered on
- Server profile job completed with success but changes have not occurred
- After a server profile assignment, some connections defined in the server profile are not functional
- Commands -add profile or -set profile error messages
- Command -add profile error messages
- Additional Troubleshooting Information and tools
- 6 Support and other resources
- Index
------------------------------------------------------------------
Managed Elements
------------------------------------------------------------------
devicebay : Bay which can contain a Virtual Connect server.
enet-connection : Ethernet Network Connection
fc-connection : Fibre Channel SAN Fabric Connections
fcoe-connection : FCoE Fabric Connections
iscsi-boot-param : iSCSI Boot Parameter information
iscsi-connection : iSCSI Network Connections
job : VCEM jobs
power-status : Bay power status
profile : Virtual Connect Server Profile
profiles : VCEMCLI profile export information
server-port-map : Shared Server Downlink Port Mapping Configuration
vcem-status : The VCEM management status of the VC domain
version : VCEMCLI Version Information
Error Reporting
All VCEMCLI commands can report errors. These error messages contain both a text description
of the exception and a numeric value in string form that represents the error code for the
corresponding exception.
VCEMCLI sets the DOS ERRORLEVEL environment variable based on the success or failure of the
command. Success is indicated by a level of zero (0). Failure is indicated by levels of one (1) or
greater where the specific value corresponds to an error described in the error message tables.
For the -show command, the ERRORLEVEL environment variable is set to indicate state, not an
error condition. This allows for a script to execute -show for jobs or power states and then based
on the value of ERRORLEVEL change the control flow of a script. For example:
for /L %%I in (1,1,%MAXBAYS%) DO (
%CLI% -show power-status -enclosureName %ENCLNAME% -bayname %%I
if ERRORLEVEL 240 (
echo There is no server in bay %%I
) else (
if ERRORLEVEL 1 (
echo Server in bay %%I is already on
) else (
echo Turning on server in bay %%I
%CLI% -poweron devicebay -enclosureName %ENCLNAME% -bayname %%I
if ERRORLEVEL 1 goto ERRORHANDLER
)
)
)
See “Error Messages” (page 66) or the System Insight Manager documentation for more information.
16 Using VCEMCLI