Extract the incoming replication usage data from vCloud Availability. The report contains the number of incoming replications and the number of incoming replications aggregated by organizations and by virtual data centers.
Procedure
- Connect to the vCloud Availability vApp Replication Manager appliance by using a Secure Shell (SSH) client.
- Open an SSH connection to Appliance-IP-Address.
- Log in as the root user.
- Obtain a vCloud Availability vApp Replication Manager token.
$ c4 loginroot 'vApp-Replication-Manager-Password'
[ "token-id", { "user": "root", "roles": [ "EVERYONE", "ADMINISTRATORS", "VRADMINISTRATORS" ], "authenticatedSites": [ { "site": "site1", "org": "System" } ] } ]
- (Optional) Retrieve the usage information about the
usage-report
script.$ usage-report --help
- Generate the vCloud Availability usage report.
$ usage-report --output /tmp/report_summary.tsv --details /tmp/report_details.tsv
By not using the
--dry-run
argument, the usage report overwrites the reporting data in the two .tsv files.The /tmp/report_summary.tsv file contains the number of all incoming replications and information about incoming replications grouped by organizations and by virtual data centers. This information is presented in the following format:
vCloud Availability Usage Report generatedOn date-time-stamp buildVersion 3.x-build-number localSite site1 instanceId instance-id Incoming replication counts Replication type Total count Cloud to cloud protections Cloud to cloud migrations vSphere to cloud protections vSphere to cloud migrations Total incoming vApp replications 5 1 0 3 1 Newly started incoming vApp replications 5 1 0 3 1 Carried over incoming vApp replications 0 0 0 0 0 Total incoming VM replications 5 1 0 3 1 Newly started incoming VM replications 5 1 0 3 1 Carried over incoming VM replications 0 0 0 0 0 Incoming vApp replications by org Org Org Id Total count Cloud to cloud protections Cloud to cloud migrations vSphere to cloud protections vSphere to cloud migrations alpha eb410797-9038-4755-a7f1-f28981ef5408 2 1 0 1 0 beta 082ce1a1-7b17-4316-92ab-db82da0c35e0 3 0 0 2 1 Incoming VM replications by org Org Org Id Total count Cloud to cloud protections Cloud to cloud migrations vSphere to cloud protections vSphere to cloud migrations alpha eb410797-9038-4755-a7f1-f28981ef5408 2 1 0 1 0 beta 082ce1a1-7b17-4316-92ab-db82da0c35e0 3 0 0 2 1 Incoming vApp replications by vDC vDC vDC Id Org Total count Cloud to cloud protections Cloud to cloud migrations vSphere to cloud protections vSphere to cloud migrations alphaorgvdc1 33ff6729-b55f-4ae8-bf20-6b0b553542ed alpha 2 1 0 1 0 betaorgvdc1 964ce5f9-e8b9-494c-81dd-4deea158b61e beta 3 0 0 2 1 Incoming VM replications by vDC vDC vDC Id Org Total count Cloud to cloud protections Cloud to cloud migrations vSphere to cloud protections vSphere to cloud migrations alphaorgvdc1 33ff6729-b55f-4ae8-bf20-6b0b553542ed alpha 2 1 0 1 0 betaorgvdc1 964ce5f9-e8b9-494c-81dd-4deea158b61e beta 3 0 0 2 1 End of report. vCloud Availability Detailed Usage Report generatedOn 2019-09-10 10:55:42.359126 buildVersion 3.5.0.14556251-71017ba localSite site1 instanceId cb45ee35-09b8-4c80-b72a-0c0d4290e924 Incoming replication counts Replication type Total count Cloud to cloud protections Cloud to cloud migrations vSphere to cloud protections vSphere to cloud migrations Total incoming vApp replications 5 1 0 3 1 Newly started incoming vApp replications 5 1 0 3 1 Carried over incoming vApp replications 0 0 0 0 0 Total incoming VM replications 5 1 0 3 1 Newly started incoming VM replications 5 1 0 3 1 Carried over incoming VM replications 0 0 0 0 0 Incoming VM Replications Replication Type Migration/Protection vApp Name vApp Id VM Name VM Id Replication ID Source Site Source Org Source vDC Id Source vDC Destination Site Destination Org Id Destination Org Destination vDC Id Destination vDC cloud-to-cloud protection ... vsphere-to-cloud protection ... vsphere-to-cloud protection ... vsphere-to-cloud migration ... vsphere-to-cloud protection ... End of report.
- Download the vCloud Availability usage report to your local machine.
$ scp /tmp/report_summary.tsv /tmp/report_details.tsv user@your-host:/download-target-location
- (Optional) Remove the generated reports from the vCloud Availability vApp Replication Manager appliance.
$ rm /tmp/report_summary.tsv /tmp/report_details.tsv