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
1 Getting Started
The VCEM Command Line is a family of executables that provide the facilities necessary for the
most frequently used management operations for the Virtual Connect Enterprise Manager
infrastructure.
The HP Virtual Connect Enterprise Manager Command Line Interface (VCEMCLI) can be used as
an alternate method for managing common Virtual Connect operations. The VCEM.CMD executable
provides failover management. VCEMCLI.EXE is useful when scripting bulk operations on multiple
Virtual Connect server profiles.
VCEMCLI Prerequisites
VCEMCLI supports the same Windows operating environments as the corresponding release of
VCEM. For more information, see the latest version of the HP Insight Software Support Matrix.
Installing VCEMCLI
VCEMCLI is automatically installed from the Insight Software 6.3.1 DVD when VCEM is installed
on the CMS host.
Removing VCEMCLI
VCEMCLI is removed when VCEM is removed from the CMS host.
Workflow tips
This section helps you to use VCEMCLI efficiently.
Leverage the VCEM web user interface
The VCEMCLI is designed to be used in addition to the VCEM web user interface. The web UI is
an easy way to gather information about your VC configuration and to examine the results of
scripted operations during the script development process.
Gather VC environment information
Before using VCEMCLI, gather the following:
• SIM Authentication information
• List of VC Domains
• List of VC Domain Groups
• List of VC server profiles (can be done via the VCEMCLI -export profiles command)
• List of VC networks
• List of VC storage fabrics
• SAN-boot configuration details (if any)
• List of enclosures and a list of bays and servers contained in the enclosures
Script development considerations
The information in this section helps you with some key decisions on how your scripts are structured.
VCEMCLI Prerequisites 5