# viprcommand
**Repository Path**: mirrors_thecodeteam/viprcommand
## Basic Information
- **Project Name**: viprcommand
- **Description**: ViPR Command provides command line interface for ViPR REST APIs.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-18
- **Last Updated**: 2026-01-11
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ViPR Command
ViPR Command provides command line interface for [ViPR Controller](http://www.emc.com/vipr) / [COPRHD](https://coprhd.github.io/) REST APIs.
### Contents
- [Introduction](#introduction)
- [Dependencies](#dependencies)
- [Install](#install)
- [Context tree](#context-tree)
- [Commands](#commands)
- [Contributing to ViPRCommand](#contributing-to-viprcommand)
## Introduction
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.
## Dependencies
**ViPR**: 2.3
**Python**: 2.7, 3.2.5, 3.4 (Additional modules: requests, configparser)
## Install Setuptools
Follow these steps only if you have python 2.7.
If you don't know what version of python you have,
type in the commnad line "python --version".
1. Download the code for [Setuptools](https://bootstrap.pypa.io/ez_setup.py).
2. Open a new Command Line.
3. Navigate to the folder where that code is being stored.
4. Run the code by typing "python ez_setup.py".
5. Close Command line window.
## Install
1. Copy downloaded package to any location
2. Windows & Linux only: Open cmd/terminal prompt
3. Navigate to ViPR command downloaded folder.
4. Type `python setup.py install` to install dependent modules.
5. Navigate to "config" folder and enter your ViPR host in cli_config.ini.
6. Type `viprcommand` in cmd/terminal prompt and 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
```
viprcommand -username {user} -password {pswd}
```
# Context tree
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](http://www.emc.com/techpubs/api/vipr/v2-3-0-0/index.htm) guide for details on these contexts, actions, payloads etc.
# Commands
## Log in/Log out from CLI
### login
This command will log user to ViPR.
_Options_
-username
-password
_Example_
login -username root -password ChangeMe
### logout
This command will log out user from ViPR
## Unix-like commands
### ls
This command will list all resources in current context
### ll
This command will list all resources in current context along with their names
### cd
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).
### find
This command will find all matching context paths for a given resource
_Arguments_
{Resource_name}
_Example_
find tenant
### quit
This command will exit ViPR Command
## REST operations
### POST
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
_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
### PUT
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
### GET
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
### Others
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:-
_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
### General rules
1. "help" will show input fields in table and xml format
2. Before running command, run "ls" to see what actions are supported
3. 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`
4. Fields can be repeated if they allow multiple values ("MAX" is "unbounded")
For example: `-cluster name:clusetr1 -cluster name:cluster2`
## Searching for a resource
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
## Deleting a resource
Resource can be deleted if "deactivate" is found in "actions"
For example: to delete a block volume
cd /block/volumes
deactivate -id {volume_id}
## Using Query Parameters
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 | |
## Contributing to ViPRCommand
The ViPRCommand project has been licensed under the [MIT](http://opensource.org/licenses/MIT "The MIT License (MIT)") License. In order to contribute to the project you will to do two things:
1. License your contribution under the [DCO](http://elinux.org/Developer_Certificate_Of_Origin "Developer Certificate of Origin") + [MIT](http://opensource.org/licenses/MIT "The MIT License (MIT)")
2. Identify the type of contribution in the commit message
### 1. Licensing your Contribution:
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”
### 2. Identifying the Type of Contribution
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).
## Licensing
ViPRCommand is licensed under the [MIT](http://opensource.org/licenses/MIT "The MIT License (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.
## Support
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.