ViPR Command provides command line interface for ViPR Controller / COPRHD REST APIs.
Application that provides unix/linux shell-like command line interface (CLI) for ViPR APIs. It uses WADL & XSD to auto generate the interface. It can be used with any ViPR version that has WADL and XSD available.
ViPR: 2.3
Python: 3.2.5, 3.4 (Additional modules: requests, configparser)
- Copy downloaded package to any location
- Windows only: Open cmd prompt
- Navigate to ViPR command downloaded folder
- Navigate to "config" folder and enter your ViPR host in cli_config.ini.
- Navigate to "bin" folder
- Type
python ViPRCommand.pyand press ENTER. The log in prompt appears:
login as:
Type ViPR username and press ENTER. A password prompt appears:
Password:
Type password and press ENTER. Instead you could also run
python ViPRCommand.py -username {user} -password {pswd}
After logging into ViPR Command it will initially land in root context. From there using "cd" command (explained below) one can navigate to different contexts and sub-contexts. There are 3 components to each context: resources, sub-context and actions.
Resources: these are ViPR resources in current context, identified by URN. To navigate to resource, use "cd {resource_urn}".
Sub-context: these are children to current context. For example: if you are in "block" context, "exports", "volumes" are some of its sub-contexts. To navigate to sub-context, use cd {sub_context}.
Actions: List of actions that can be performed on current context. These are commands by themselves.
Refer to ViPR REST API guide for details on these contexts, actions, payloads etc.
This command will log user to ViPR.
Options
-username
-password
Example
login -username root -password ChangeMe
This command will log out user from ViPR
This command will list all resources in current context
This command will list all resources in current context along with their names
This command will change context. If new context starts with "/" it is treated as absolute path.
Arguments
{New_context}
Examples
cd /block/volumes
cd projects
###cd ../cd..
This command will change context to parent (if exists).
This command will find all matching context paths for a given resource
Arguments
{Resource_name}
Example
find tenant
This command will exit ViPR Command
This command will create resource in current context. You can write xml or json to file and input that to command or provide them as parameters.
Building parameters:-
Parameters are flat view of XML elements. There should be 1 parameter for each required element. All child elements should be typed along with its parents. Ignore XML's root element.
For example:
XML
<block_export_create>
<clusters>
<cluster/>
</clusters>
<hosts>
<host/>
</hosts>
<initiators>
<initiator/>
</initiators>
<name/>
<project/>
<type/>
<varray/>
<volumes>
<volume>
<id/>
<lun/>
</volume>
</volumes>
</block_export_create>
Parameters:
-name {name} -project name:{project_name} -type cluster -clusters:cluster {cluster_id} -clusters:cluster {cluster_id} -volumes:volume:id {volume_id} -volumes:volume:lun {volume_lun} -varray name:{varray_name}
If "MIN" in table is 1, then that element is required. If "MAX" in table is "unbounded", that that element can have multiple values.
Arguments
help
json
xml
Examples
POST help
POST json payload.json
POST xml payload.xml
Using paramters: create volume example
POST -name kbvol -project name:kb -size 1GB -varray name:KB_test_varray -vpool name:KB_json_update
This command will update current resource. This works same as POST.
Arguments
help
json
xml
Examples
PUT help
PUT json payload.json
PUT xml payload.xml
This command will return current resource details. By default this command will return data in table format. To format output as xml or json use "accept" option.
Arguments
help
Options
-accept {xml/json}
Examples
GET -accept xml
GET -accept json
All "Actions" can be run as commands. Run "help" on them and check if they require any parameters.
ViPRCommand:/block/volumes/urn:storageos:Volume:00088e2e-7510-4be7-9a30-75d1bcdc29ab:vdc1/> expand help
Payload Fields:-
| NAME | TYPE | MIN | MAX |
| new_size | xs:string | 1 | 1 |
XML Payload:-
<?xml version="1.0" ?>
<volume_expand>
<new_size/>
</volume_expand>
Examples
Expand block volume (Navigate to block volume resource /block/volumes/{id})
expand -new_size 10
Delete volume (Navigate to block volume resource /block/volumes/{id})
deactivate
- "help" will show input fields in table and xml format
- Before running command, run "ls" to see what actions are supported
- If a field requires URN to be passed you can either send URN or send its name and prefix it with "name".
For example: to send project as name
-project name:DemoProject - Fields can be repeated if they allow multiple values ("MAX" is "unbounded")
For example:-cluster name:clusetr1 -cluster name:cluster2
Search can be performed on resources if it is listed as "sub-context". For example: to search for a volume by name
cd /block/volumes/search
GET -name vol1
Resource can be deleted if "deactivate" is found in "actions"
For example: to delete a block volume
cd /block/volumes
deactivate -id {volume_id}
Query parameters can be sent in command just like other parameters. To get list of query parameters on a command type "help".
For example: to get a zone details by its name
ViPRCommand:/vdc/network-systems/urn:storageos:NetworkSystem:8c7be854-2a08-43f9-bb69-966d98ed278f:vdc1/san-fabrics/1/san-zones/>ls
Actions:-
PUT POST activate remove GET
ViPRCommand:/vdc/network-systems/urn:storageos:NetworkSystem:8c7be854-2a08-43f9-bb69-966d98ed278f:vdc1/san-fabrics/1/san-zones/>GET help
Query Parameters:-
| Name | Type |
| exclude-members | xs:boolean |
| zone-name | xs:string |
ViPRCommand:/vdc/network-systems/urn:storageos:NetworkSystem:8c7be854-2a08-43f9-bb69-966d98ed278f:vdc1/san-fabrics/1/san-zones/>GET -zone-name 'SDS_nh1_tz_fc_view_647316423649600_485565236431_0701_FA2F1'
| Name | Value |
| san_zone | |
| name | SDS_nh1_tz_fc_view_647316423649600_485565236431_0701_FA2F1 |
| members | |
| wwn | 21:00:48:55:65:23:64:31 |
| wwn | 50:00:09:73:10:0A:F5:45 |
ViPRCommand:/vdc/network-systems/urn:storageos:NetworkSystem:8c7be854-2a08-43f9-bb69-966d98ed278f:vdc1/san-fabrics/1/san-zones/>GET -zone-name 'SDS_nh1_tz_fc_view_647316423649600_485565236431_0701_FA2F1' -exclude-members True
| Name | Value |
| san_zone | |
| name | SDS_nh1_tz_fc_view_647316423649600_485565236431_0701_FA2F1 |
| members | |
The ViPRCommand project has been licensed under the MIT License. In order to contribute to the project you will to do two things:
- License your contribution under the DCO + MIT
- Identify the type of contribution in the commit message
As part of the contribution, in the code comments (or license file) associated with the contribution must include the following:
“The MIT License (MIT)
Copyright (c) [Year], [Company Name (e.g., EMC Corporation)]
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
This code is provided under the Developer Certificate of Origin- [Insert Name], [Date (e.g., 1/1/15]”
For example:
A contribution from Joe Developer, an independent developer, submitted in May 15th of 2015 should have an associated license (as file or/and code comments) like this:
“The MIT License (MIT)
Copyright (c) 2015, Joe Developer
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
This code is provided under the Developer Certificate of Origin- Joe Developer, May 15th 2015”
In addition to identifying an open source license in the documentation, all Git Commit messages associated with a contribution must identify the type of contribution (i.e., Bug Fix, Patch, Script, Enhancement, Tool Creation, or Other).
ViPRCommand is licensed under the MIT license:
“The MIT License (MIT)
Copyright (c) 2015, EMC Corporation
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please file bugs and issues at the Github issues page. For more general discussions you can contact the EMC Code team at Google Groups or tagged with EMC on Stackoverflow.com. The code and documentation are released with no warranties or SLAs and are intended to be supported through a community driven process.