{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The export virtual machine feature automates the Export process generating an ","type":"text"},{"text":"Open Virtualization format (OVF)","type":"text","marks":[{"type":"link","attrs":{"href":"https://en.wikipedia.org/wiki/Open_Virtualization_Format"}}]},{"text":" and then transferring the resulting files to your personal account space in ","type":"text"},{"text":"VSKEY-STOR","type":"text","marks":[{"type":"link","attrs":{"href":"https://vskey-stor.eis.utoronto.ca"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"A virtual machine qualifies to be exported if:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Committed storage (not provisioned) is less than 300G.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Power state is Off.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"No iso backing on CD/DVD unit","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"We use thin provisioning on the ITS Private Cloud to help avoid over-allocating storage space and save storage.","type":"text"}]},{"type":"paragraph","content":[{"text":"Thin provisioning uses just as much storage capacity as currently needed and then add the required amount of storage space at a later time. (Source: ","type":"text"},{"text":"VMware","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":").","type":"text"}]}]},{"type":"paragraph","content":[{"text":"This tutorial walks you through the process of exporting a given virtual machine.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Validate-virtual-machine"},"legacyAnchorId":{"value":"Exportvirtualmachines-Validate-virtual-machine"}},"macroMetadata":{"macroId":{"value":"9014606f-7162-4c2f-91c5-408ea707fd3b"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Exportvirtualmachines-Validate-virtual-machine"},"legacyAnchorId":{"value":"Exportvirtualmachines-Exportvirtualmachines-Validate-virtual-machine"}},"macroMetadata":{"macroId":{"value":"b7e41ce1-4d93-4c65-a336-b96fec40331c"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Validate virtual machine","type":"text"}]},{"type":"paragraph","content":[{"text":"First, we need to double check if the ","type":"text"},{"text":"committed_gb","type":"text","marks":[{"type":"code"}]},{"text":" size is lower than ","type":"text"},{"text":"300GB","type":"text","marks":[{"type":"strong"}]},{"text":". This can be done by executing the command ","type":"text"},{"text":"vss-cli compute vm ls","type":"text","marks":[{"type":"code"}]},{"text":" but modifying the output columns with the ","type":"text"},{"text":"--columns","type":"text","marks":[{"type":"code"}]},{"text":" option as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli --columns \"moref,name,folder.path,provisioned_gb,committed_gb,power_state\" compute vm ls -f moref=vm-10342\n\nmoref name folder.path provisioned_gb committed_gb power_state\n--------- ------------------ ------------------------ ---------------- -------------- -------------\nvm-123456 2210P-FrontEnd-1u0 Public > Customer 123456 60 19.67 poweredOn","type":"text"}]},{"type":"paragraph","content":[{"text":"In this particular case, we can proceed since the committed space is lower than ","type":"text"},{"text":"300GB","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"If the virtual machine ","type":"text"},{"text":"power_state","type":"text","marks":[{"type":"code"}]},{"text":" is ","type":"text"},{"text":"poweredOn","type":"text","marks":[{"type":"code"}]},{"text":", shut it down by sending a ","type":"text"},{"text":"shutdown","type":"text","marks":[{"type":"code"}]},{"text":" signal through the OS via VMware Tools or a hard power ","type":"text"},{"text":"off","type":"text","marks":[{"type":"code"}]},{"text":" as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set state shutdown\n\nHost Name: ubuntu (Ubuntu Linux (64-bit))\nIP Address: 192.168.2.100, fe80::250:56ff:fe92:d463\nAre you sure you want to change the state from \"running to shutdown\" of the above VM? [y/N]: y","type":"text"}]},{"type":"paragraph","content":[{"text":"Finally, verify if the VM’s CD/DVD unit is not backed by an ISO image file:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm get cd\n\nlabel backing connected\n-------------- --------- ------------\nCD/DVD drive 1 client disconnected","type":"text"}]},{"type":"paragraph","content":[{"text":"Execute ","type":"text"},{"text":"vss-cli compute vm set cd --iso client","type":"text","marks":[{"type":"code"}]},{"text":" if an ISO image is shown in CD backing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Export-virtual-machine"},"legacyAnchorId":{"value":"Exportvirtualmachines-Export-virtual-machine"}},"macroMetadata":{"macroId":{"value":"9341d080-0fe1-41de-8abd-a206189bf3d4"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Exportvirtualmachines-Export-virtual-machine"},"legacyAnchorId":{"value":"Exportvirtualmachines-Exportvirtualmachines-Export-virtual-machine"}},"macroMetadata":{"macroId":{"value":"f46d6160-dc60-48a6-9e35-d1b20415aaa5"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Export virtual machine","type":"text"}]},{"type":"paragraph","content":[{"text":"Run ","type":"text"},{"text":"vss-cli compute vm set export","type":"text","marks":[{"type":"code"}]},{"text":" to submit an export task. The command does not require any argument or options.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"Usage: vss-cli compute vm set export [OPTIONS]\n\n Export current virtual machine to OVF.\n\n vss-cli compute vm set export\n\nOptions:\n --help Show this message and exit.","type":"text"}]},{"type":"paragraph","content":[{"text":"Once the command is executed, a VM Export Request is created and all related activity including export status is recorded in it. To check the status, execute ","type":"text"},{"text":"vss-cli request export get ","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli request export get \n\n...\nstatus : Processed\n...\nfiles : disk: ['../disk-0.vmdk', '../2009T-nat.ovf']\n...\ntransferred : Yes","type":"text"}]},{"type":"paragraph","content":[{"text":"The request object holds more attributes, however the above listed are more important for this example. ","type":"text"},{"text":"status=Processed","type":"text","marks":[{"type":"code"}]},{"text":" tells us that the request has been completed. ","type":"text"},{"text":"transferred=yes","type":"text","marks":[{"type":"code"}]},{"text":" indicates that resulting ","type":"text"},{"text":"files","type":"text","marks":[{"type":"code"}]},{"text":" were successfully transferred to your ","type":"text"},{"text":"VSKEY-STOR","type":"text","marks":[{"type":"link","attrs":{"href":"https://vskey-stor.eis.utoronto.ca"}}]},{"text":" space. To confirm, you could either go to a web browser and open ","type":"text"},{"text":"VSKEY-STOR","type":"text","marks":[{"type":"link","attrs":{"href":"https://vskey-stor.eis.utoronto.ca"}}]},{"text":" and sign in or execute ","type":"text"},{"text":"vss-cli stor ls ","type":"text","marks":[{"type":"code"}]},{"text":" and you should get something like:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli stor ls \n\nfiles\n-------------------------------\n2009T-nat-vm-2386/2009T-nat.ovf\n2009T-nat-vm-2386/disk-0.vmdk\n2009T-nat-vm-2386/disk-1.nvram","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Download-virtual-machine-export"},"legacyAnchorId":{"value":"Exportvirtualmachines-Download-virtual-machine-export"}},"macroMetadata":{"macroId":{"value":"377c27c6-de4c-4894-a50c-4db192ce1594"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Exportvirtualmachines-Download-virtual-machine-export"},"legacyAnchorId":{"value":"Exportvirtualmachines-Exportvirtualmachines-Download-virtual-machine-export"}},"macroMetadata":{"macroId":{"value":"ba0a16b4-2a6d-49b1-9f91-41833c945ae0"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Download virtual machine export","type":"text"}]},{"type":"paragraph","content":[{"text":"To download the files you could either go to a web browser and open ","type":"text"},{"text":"VSKEY-STOR","type":"text","marks":[{"type":"link","attrs":{"href":"https://vskey-stor.eis.utoronto.ca"}}]},{"text":" and sign in, go to the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" folder and download the files or execute ","type":"text"},{"text":"vss-cli stor dl /","type":"text","marks":[{"type":"code"}]},{"text":" as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"# OVF descriptor\nvss-cli stor dl 2009T-nat-vm-2386/2009T-nat.ovf -d ~/Downloads\n\nDownload 2009T-nat-vm-2386/2009T-nat.ovf to ~/Downloads/2009T-nat.ovf in progress ⏬\nDownload complete to ~/Downloads/2009T-nat.ovf ✅\n\n# disk file\nvss-cli stor dl 2009T-nat-vm-2386/disk-0.vmdk -d ~/Downloads\n\nDownload 2009T-nat-vm-2386/disk-0.vmdk to ~/Downloads/disk-0.vmdk in progress ⏬\nDownload complete to ~/Downloads/disk-0.vmdk ✅\n\n# Optional: nvram file\nvss-cli stor dl 2009T-nat-vm-2386/disk-1.nvram -d ~/Downloads\n\nDownload 2009T-nat-vm-2386/disk-1.nvram to ~/Downloads/disk-1.nvram in progress ⏬\nDownload complete to ~/Downloads/disk-1.nvram ✅","type":"text"}]},{"type":"paragraph","content":[{"text":"Alternatively, you could just launch the web UI via the ","type":"text"},{"text":"la","type":"text","marks":[{"type":"code"}]},{"text":" command and browse the ","type":"text"},{"text":"ut-vss","type":"text","marks":[{"type":"code"}]},{"text":" bucket to download the files via your web browser:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli stor la gui --show-cred\n\nLaunching 🌎: https://vskey-stor.eis.utoronto.ca:42047\nusername: [REDACTED]\npassword: [REDACTED]","type":"text"}]},{"type":"paragraph","content":[{"text":"That’s it, at this point the OVF and disks are ready to be imported to a desired platform.","type":"text"}]}],"version":1}

Browser not supported