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
if ERRORLEVEL 1 goto ERRORHANDLER
)
echo ------------------------------------------
echo The server in bay %%I is off. Assigning profile PROFILE-%%I
%CLI% -assign profile -profilename PROFILE-%%I -enclosureName %ENCLNAME% -bayname %%I
if ERRORLEVEL 1 goto ERRORHANDLER
)
)
goto END
:ERRORHANDLER
echo Error processing last command. ERRORLEVEL = %ERRORLEVEL%
:END
exit /b %ERRORLEVEL%
Authenticating with VCEM
VCEMCLI allows two types of authentication:
• SIM certificate based (administrators only): If the vcemcli user is logged in as the local
administrator, then no credentials are required for command execution. This is the
recommended authentication method.
• Username and password credential pair: If you are not logged in as an administrator, a
username and password credential pair must be provided. If only the password argument is
provided, VCEMCLI uses the username of the current Windows user for authentication.
Username and Password Logon
Logging on requires a username and password credential set which is passed to the VCEM server
for authentication. In this case, a successful logon is accomplished when the supplied credentials
are validated by Systems Insight Manager. If the logon attempt is unsuccessful, an error message
indicating the failure is reported.
Username and password authentication is simple to configure, easier for testing scripts, and more
suited for use with Role-based access control (RBAC). Username and password information must
be gathered at the time that the script is run, or you must define a sufficiently secure mechanism
in your environment to store the username and password so the information is available to the
script when it executes.
Logging on without a password
If you log on to the CMS as an administrator, it is possible to execute VCEMCLI without providing
credentials. This method uses a pre-installed authentication certificate available only to the CMS
administrator . HP recommends this method for executing the VCEMCLI because no password is
required as an argument on the command line.
Session Lifetime
VCEM CLI logon sessions remain active for a single command execution. The CLI automatically
logs out of the VCEM server after the execution completes, whether the command succeeded or
failed.
Role based Access Control (RBAC)
Role based access control allows you to designate which operations and resources can be
manipulated.
Authenticating with VCEM 9