Cloudockit now support generating reports and diagrams (Visio and Draw.io) for your on-premises Virtual Infrastructure (Hyper-V and VMware Hosts are supported).
The following short video gives a high level overview of the process
Here are the detailed steps on how to do that:
- Login to https://www.cloudockit.com and select a Microsoft Azure Subscription. (The option for On-Premises documentation is currently only available once you select a Azure subscription which may looks surprising but that allows us to use many of the Azure options – like Drop Off the document in a Azure Storage). In the future, we will give the option using a AWS Account and then with a completely separated On-Premise Section.
- Once the settings popup is open, navigate to the filter section and then select Hyper-V or VMWare in the On-Premises section
- Once you select the option, you will see that you get two links :
- VMware
- Hyper-V
These two links are Powershell scripts that you can download. These scripts will scan you Hyper-V or VMware Host and retrieve the content that is necessary to Cloudockit to generate your documentation and your diagrams.
- The scripts are readable and we made really simple scripts by design so that you see what information gets extracted from the scripts. The scripts extract the following information:
- Hosts Specifications (Nb CPUs, RAM…)
- Virtual Machine information (Nb CPUs, RAM, Name…)
- Network Card Information
- Virtual Hard Drives
- Here is the content of the scripts:
- VMware:
#This script will collect the information needed by Cloudockit to generate the documentation
#It will generate an output file named THECOMPUTERNAME-cdk-export.json
#You will need to upload this file when generating your documentation
#PLEASE UPDATE THE CONNECTION INFORMATION HERE
Connect-VIServer – Server 'Enter_ServerName_Here' -User 'Enter_AdminUser_Here' -Password 'Enter_AdminPwd_Here'
$virtualMachinesJSON = Get-VM | Select * -ExcludeProperty ExtensionData,Client | ConvertTo-Json
$nicsJSON = Get-VM| Get-NetworkAdapter | Select * -ExcludeProperty ExtensionData,Client,Parent | ConvertTo-Json
$hardDrivesJSON = Get-VM| Get-HardDisk | Select * -ExcludeProperty ExtensionData,Client,Parent | ConvertTo-Json
$onPremConfigurationJSON = "{`"exportType`" : `"vmware`",`"exportVersion`" : `"1.0`", `"virtualMachines`" : $virtualMachinesJSON, `"nics`" : $nicsJSON, `"hds`" : $hardDrivesJSON }"
$onPremConfigurationJSON > "$env:computername-cdk-export.json"- Hyper-V
#This script will collect the information needed by Cloudockit to generate the documentation
#It will generate an output file named THECOMPUTERNAME-cdk-export.json
#You will need to upload this file when generating your documentation
$virtualMachinesJSON = Get-VM | ConvertTo-Json -Depth 5
$hostJSON = Get-VMHost| ConvertTo-Json -Depth 5
$onPremConfigurationJSON = "{`"exportType`" : `"hyperV`",`"exportVersion`" : `"1.0`", `"virtualMachines`" : $virtualMachinesJSON, `"host`" : $hostJSON }"
$onPremConfigurationJSON > "$env:computername-cdk-export.json"- Once you run those scripts on all your hosts, you will get multiple xxx-cdk-export.json files that you need to upload to Cloudockit by clicking the Browse button. We plan to release scripts that will scan all your Hosts in the future so that you don’t need to do that by yourself.
- Then click on Generate documentation and enjoy your Documentation and Diagrams !
Here are some example of documents generated :
