fbpx

Knowledge Base

You are here:
Print

Connect your On-Premises Environment

Now that you are logged into Cloudockit (click here if you are not logged in yet), we can connect to your On-Premises environment.

Cloudockit is a solution that is 100% agent-free, meaning you do not have to install any agent or extension in your environment. 

The way Cloudockit scans your Hyper-V or VMware environments is simple: execute a PowerShell script that calls built-in Hyper-V/VMWare PowerShell/PowerCLI Cmdlet and generate a .json file.  

Afterward, upload the .json files into Cloudockit in order to generate the full documentation and diagrams. 

Let’s get started. 

From the list of platforms, select VMware Hyper-V. 

On the pop-up, navigate to the Workloads tab and select your On-Premises virtualization solution. Once you’ve selected it, click on the link to download the PowerShell script to retrieve your information: 

With VMWare or Hyper-V:

With ARM Templates (no script needed, just upload the ARM templates):

These scripts will scan your Hyper-V or VMware Host and retrieve the content that is necessary for Cloudockit to generate your documentation and your diagrams.

  • The scripts are readable and we made them simple by design so that you see what information gets extracted. 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.

To start the document generation, click on the Generate button

Table of Contents