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

Contents
1 Getting Started..........................................................................................5
VCEMCLI Prerequisites..............................................................................................................5
Installing VCEMCLI...................................................................................................................5
Removing VCEMCLI..................................................................................................................5
Workflow tips...........................................................................................................................5
Leverage the VCEM web user interface...................................................................................5
Gather VC environment information........................................................................................5
Script development considerations..............................................................................................5
Choosing a location for the script files....................................................................................6
Initiating multiple commands.................................................................................................6
Security on the CMS............................................................................................................6
Authentication.....................................................................................................................6
Using delays in script commands...........................................................................................6
Profiles and powering off or powering on................................................................................6
Running scripts as Windows Scheduled Tasks..........................................................................6
Comparing VCMCLI scripts to VCEMCLI scripts........................................................................6
2 Using VCEMCLI.........................................................................................7
Executable...............................................................................................................................7
Environment Variable................................................................................................................7
Common options......................................................................................................................7
Using VCEMCLI in a script ........................................................................................................8
Authenticating with VCEM.........................................................................................................9
Username and Password Logon..................................................................................................9
Logging on without a password..................................................................................................9
Session Lifetime........................................................................................................................9
Role based Access Control (RBAC)..............................................................................................9
RBAC Details.....................................................................................................................10
RBAC Best Practices...........................................................................................................11
Working with server profiles.....................................................................................................11
Creating a server profile.....................................................................................................12
Deleting a server profile......................................................................................................12
Modifying a server profile...................................................................................................12
Displaying job details.........................................................................................................14
Accessing VCEMCLI help.........................................................................................................15
Error Reporting.......................................................................................................................16
3 Using VCEM commands............................................................................17
add profile............................................................................................................................17
set profile..............................................................................................................................19
assign profile.........................................................................................................................20
export profiles........................................................................................................................22
unassign profile......................................................................................................................23
add enet-connection...............................................................................................................24
set enet-connection.................................................................................................................27
remove enet-connection...........................................................................................................30
add fc-connection...................................................................................................................31
set fc-connection.....................................................................................................................33
remove fc-connection...............................................................................................................35
add fcoe-connection...............................................................................................................36
set fcoe-connection.................................................................................................................38
remove fcoe-connection...........................................................................................................40
Contents 3