View Commodity capacity

Table of Contents

View Commodity capacity with the UI

Use the UI to view the raw storage capacity of ViPR Commodity or ECS Appliance storage by total or node.

This article applies to EMC ViPR 2.0.

Note that raw capacity numbers for ViPR Commodity and ECS Appliance do not reflect the reduced capacity caused by disks in unavailable states. To access raw capacity numbers:

Procedure

  1. From the ViPRDashboard, locate the Commodity Raw field in the Capacity section. This field shows the total raw capacity of Commodity storage in GB.
  2. In the Physical Assets section, select Commodity Nodes. On the Commodity Nodes page, locate the Capacity column. This column lists the raw capacity for each node in GB.
Back to Top

View Commodity capacity with the CLI

Use the ViPR CLI to view the raw storage capacity of a Commodity system, ECS Appliance, service, node, or drive.

viprcli fabric capacity

Returns the total raw storage capacity of the fabric.

In this example, the command returns the capacity for the entire fabric in GB.

./viprcli fabric capacity
{
   "total_capacity": 30000
}

viprcli fabricservice capacity

Returns the raw storage capacity assigned to a named service.

The service parameter is required. It specifies the name of a fabric service: either Object or Block. The option names are case sensitive.

In this example, the command returns the capacity for the Object service in GB.

./viprcli fabricservice capacity -service Object
{
   "total_capacity": 30000
}

viprcli fabricnode capacity

Returns the raw storage capacity that the specified node manages.

The node parameter is required. It specifies the system ID of the node.

In this example, first use viprcli fabricnode list to return the list of nodes in the fabric. Then use the viprcli fabricnode capacity command to return the raw storage capacity for the node in GB.

./viprcli fabricnode list
 NAME
  layton-cyan
./viprcli fabricnode capacity -node layton-cyan             
{
   "total_capacity": 30000
}

viprcli fabricdisk capacity

Returns the raw storage capacity of the specified drive.

The disk parameter is required. It specifies the device name of a drive. Use the optional node parameter to specify the drive's node to avoid ambiguity.

In this example, first use viprcli fabricnode disks to return the list of drives for a node. Then use the viprcli fabricnode capacity command to return the raw capacity for the node.

./viprcli fabricnode disks -node layton-cyan                {
   "disk": [
      {
         "id": "urn:fabric:disk:13ccdb86-da59-de47-931d-b8db3b483b8d:",
         "link": {
            "href": "/vdc/fabric/disks/urn:fabric:disk:13ccdb86-da59-de47-931d-b8db3b483b8d:",
            "rel": "self"
         },
         "name": "/dev/sdx1"
      },
.
.
.
      {
         "id": "urn:fabric:disk:fe7f6faf-2aaa-5841-8e81-56afb898093a:",
         "link": {
            "href": "/vdc/fabric/disks/urn:fabric:disk:fe7f6faf-2aaa-5841-8e81-56afb898093a:",
            "rel": "self"
         },
         "name": "/dev/sdl1"
      }
   ]
}
./viprcli fabricdisk capacity -disk "/dev/sd11" -node layton-cyan
{
   "total_capacity": 1000
}

Back to Top

View Commodity capacity with the REST API

To view the raw storage capacity of a Commodity system, ECS Appliance, service, node, or drive in gigabytes, use the REST API.

Test the REST API in your browser

The easiest way to test the REST API is to point your browser towards the IP of your ViPR Controller. You will need to log in when you make the first call.

Here, a controller IP is provided along with the GET /vdc/fabric/capacityendpoint

https://<controller_ip>:4443<rest_api_endpoint>/?using-cookies

https://10.247.98.1:4443/vdc/fabric/capacity/?using-cookies

Get Fabric-level Capacity

Endpoint: GET /vdc/fabric/capacity

Returns the total raw storage capacity of the fabric.

In this example, the call returns the capacity for the entire fabric in GB.

https://10.247.98.1:4443/vdc/fabric/capacity/?using-cookies
<capacity>
	<total_capacity>30000</total_capacity>
</capacity>

Get Service-level Capacity

Endpoint: GET /vdc/fabric/services/{id}/capacity

Returns the raw capacity assigned to a service.

The id parameter specifies the URN of a fabric service.

In this example, the command returns the capacity for the Object service.

https://10.247.98.1:4443/vdc/fabric/services/?using-cookies
<services>
	<service>
		<id>urn:fabric:service:Block:</id>
		<name>Block</name>
		<link rel="self" href="/vdc/fabric/services/urn:fabric:service:Block:"/>
	</service>
	<service>
		<id>urn:fabric:service:Object:</id>
		<name>Object</name>
		<link rel="self" href="/vdc/fabric/services/urn:fabric:service:Object:"/>
	</service>
</services>
https://10.247.98.1:4443/vdc/fabric/services/urn:fabric:service:Object:/capacity/?using-cookies
<capacity>
	<total_capacity>30000</total_capacity>
</capacity>

Get Node-level Capacity

Endpoint: GET /vdc/fabric/nodes/{id}/capacity

Returns the raw storage capacity that the specified node manages.

The id parameter specifies the system ID of the node.

In this example, first use theGET /vdc/fabric/nodes call to return the list of nodes in the fabric. Then use theGET vdc/fabric/nodes/(id}/capacity call to return the raw capacity for the node in GB.

https://10.247.98.1:4443/vdc/fabric/nodes?using-cookies
<nodes>
	<node>
		<id>urn:fabric:node:4e82dba1-e509-11e0-bd1d-001e672902ab:</id>
		<name>layton-cyan</name>
		<link rel="self" href="/vdc/fabric/nodes/urn:fabric:node:4e82dba1-e509-11e0-bd1d-001e672902ab:"/>
	</node>
</nodes>
https://10.247.98.1:4443/vdc/fabric/nodes/urn:fabric:node:4e82dba1-e509-11e0-bd1d-001e672902ab:/capacity?using-cookies
<capacity>
	<total_capacity>30000</total_capacity>
</capacity>

Get Disk-level Capacity

Endpoint: GET /vdc/fabric/disks/{id}/capacity

Returns the raw capacity of the specified disk.

The id parameter specifies the URN of a fabric drive.

In this example, first use theGET /vdc/fabric/nodes/{id}/disks call to return the list of drives for a node in the fabric. Then use theGET /vdc/fabric/disks/{id}/capacity call to return the raw capacity for the drive.

https://10.247.98.1:4443/vdc/fabric/nodes/urn:fabric:node:4e82dba1-e509-11e0-bd1d-001e672902ab:/disks/?using-cookies
<disks>
	<disk>
		<id>urn:fabric:disk:13ccdb86-da59-de47-931d-b8db3b483b8d:</id>
		<name>/dev/sdx1</name>
		<link rel="self" href="/vdc/fabric/disks/urn:fabric:disk:13ccdb86-da59-de47-931d-b8db3b483b8d:"/>
	</disk>
.
.
.
	<disk>
		<id>urn:fabric:disk:fe7f6faf-2aaa-5841-8e81-56afb898093a:</id>
		<name>/dev/sdl1</name>
		<link rel="self" href="/vdc/fabric/disks/urn:fabric:disk:fe7f6faf-2aaa-5841-8e81-56afb898093a:"/>
	</disk>
</disks>
https://10.247.98.1:4443/vdc/fabric/disks/urn:fabric:disk:13ccdb86-da59-de47-931d-b8db3b483b8d:/capacity/?using-cookies
<capacity>
	<total_capacity>1000</total_capacity>
</capacity>

Back to Top