{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Virtual machine disks are listed by ","type":"text"},{"text":"vss-cli compute vm get disk ","type":"text","marks":[{"type":"code"}]},{"text":" and updated, removed and created by ","type":"text"},{"text":"vss-cli compute vm set disk ","type":"text","marks":[{"type":"code"}]},{"text":". This tutorial walks you through the process of managing virtual machine disks.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"List"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-List"}},"macroMetadata":{"macroId":{"value":"60f8da3a-3f95-48c0-91c7-64d5d9ba38d0"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageVirtualDiskswiththevss-cli-List"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-ManageVirtualDiskswiththevss-cli-List"}},"macroMetadata":{"macroId":{"value":"1fb922f9-2717-4ec4-b2bb-ee10899b6b69"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"List","type":"text"}]},{"type":"paragraph","content":[{"text":"To list a summary of current virtual machine disks, use ","type":"text"},{"text":"vss-cli compute vm get disk","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"vss-cli compute vm get disk ","type":"text","marks":[{"type":"code"}]},{"text":" to get specific information of a disk unit. For instance, the following virtual machine has two virtual disks configured:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm get VMName disk\n\nlabel unit controller.virtual_device_node\n----------- ------ --------------------------------\nHard disk 1 1 SCSI controller 0:0\nHard disk 2 2 SCSI controller 1:1\nHard disk 3 3 SCSI controller 1:0","type":"text"}]},{"type":"paragraph","content":[{"text":"Getting specific information of a given disk unit, run ","type":"text"},{"text":"vss-cli compute vm get disk ","type":"text","marks":[{"type":"code"}]},{"text":" as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm get vm-1233 disk 1\n\nlabel : Hard disk 1\nunit : 1\nvirtual_device_node : SCSI controller 0:0\ncapacity_gb : 8\nshares.level : normal","type":"text"}]},{"type":"paragraph","content":[{"text":"Getting backing information of a particular disk is available by including the sub-command ","type":"text"},{"text":"backing","type":"text","marks":[{"type":"code"}]},{"text":" in the disk command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm get vm-1233 disk 1 backing\n\ndescriptor_file_name: None\ndevice_name : None\ndisk_mode : persistent\nfile_name : [CL-NSTOR47-NFS-vol33] 1806P-modest_davinci_66/1806P-modest_davinci_66.vmdk\nlun_uuid : None\nthin_provisioned : True","type":"text"}]},{"type":"paragraph","content":[{"text":"Getting details of the SCSI controller of a particular disk is available by including the sub-command ","type":"text"},{"text":"scsi","type":"text","marks":[{"type":"code"}]},{"text":" in the disk command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm get vm-1233 disk 1 scsi\n\nbus_number : 0\nlabel : SCSI controller 0\ntype : VirtualLsiLogicController","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Update"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-Update"}},"macroMetadata":{"macroId":{"value":"12348e35-d379-4498-96fa-d12e43d4b5a4"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageVirtualDiskswiththevss-cli-Update"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-ManageVirtualDiskswiththevss-cli-Update"}},"macroMetadata":{"macroId":{"value":"003b457e-e659-42de-a189-3f703948358e"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Update","type":"text"}]},{"type":"paragraph","content":[{"text":"There are three allowed actions to modify a given disk unit: remove, update and create as shown by ","type":"text"},{"text":"vss-cli compute vm set disk mk|up|rm --help","type":"text","marks":[{"type":"code"}]},{"text":" command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"Usage: vss-cli compute vm set disk [OPTIONS] COMMAND [ARGS]...\n\n Manage virtual machine disks. Add, expand and remove virtual disks.\n\nOptions:\n --help Show this message and exit.\n\nCommands:\n mk Create new disk\n rm Remove disk from vm\n up Update disk capacity and controller","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Expand"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-Expand"}},"macroMetadata":{"macroId":{"value":"5dfcdca9-32f2-4913-ab9e-62aa87ac600e"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageVirtualDiskswiththevss-cli-Expand"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-ManageVirtualDiskswiththevss-cli-Expand"}},"macroMetadata":{"macroId":{"value":"3db0a4c4-db2f-47a4-be74-b25b3a2d3574"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Expand","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to expand an existing disk, use ","type":"text"},{"text":"vss-cli compute vm set disk up -c ","type":"text","marks":[{"type":"code"}]},{"text":" as shown below:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set vm-1234 disk up 1 --capacity 50","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Controller"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-Controller"}},"macroMetadata":{"macroId":{"value":"3f806a5d-311a-49c1-b094-2c221fd4fb4d"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageVirtualDiskswiththevss-cli-Controller"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-ManageVirtualDiskswiththevss-cli-Controller"}},"macroMetadata":{"macroId":{"value":"4dd7779f-e0e6-4f42-8408-d84e767c53db"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Controller","type":"text"}]},{"type":"paragraph","content":[{"text":"SCSI controllers are also available to update via the CLI. Use ","type":"text"},{"text":"vss-cli compute vm set disk up -s ","type":"text","marks":[{"type":"code"}]},{"text":" as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set vm-1234 disk up 1 --scsi 1","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Backing-Mode"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-Backing-Mode"}},"macroMetadata":{"macroId":{"value":"cb770cb5-8f11-4a7e-b4b1-6486bc875716"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageVirtualDiskswiththevss-cli-Backing-Mode"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-ManageVirtualDiskswiththevss-cli-Backing-Mode"}},"macroMetadata":{"macroId":{"value":"298f7cc2-aa91-4980-899f-2c68c97a2d9c"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Backing Mode","type":"text"}]},{"type":"paragraph","content":[{"text":"Disk backing modes can be updated via ","type":"text"},{"text":"vss-cli compute vm set disk up -m ","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set vm-1234 disk up 1 --backing-mode independent_persistent","type":"text"}]},{"type":"paragraph","content":[{"text":"Refer to the following table to pick the right ","type":"text"},{"text":"backing mode","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"append","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Changes are appended to the redo log; you revoke changes by removing the undo log.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"independent_nonpersistent","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Same as nonpersistent, but not affected by snapshots.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"independent_persistent","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Same as persistent, but not affected by snapshots.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"nonpersistent","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Changes to virtual disk are made to a redo log and discarded at power off.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"persistent","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Changes are immediately and permanently written to the virtual disk.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"undoable","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Changes are made to a redo log, but you are given the option to commit or undo.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Backing-Sharing-Mode"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-Backing-Sharing-Mode"}},"macroMetadata":{"macroId":{"value":"b734dfa1-044f-47bf-a9e3-9134b292091f"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageVirtualDiskswiththevss-cli-Backing-Sharing-Mode"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-ManageVirtualDiskswiththevss-cli-Backing-Sharing-Mode"}},"macroMetadata":{"macroId":{"value":"41652af6-ed8d-4746-8acf-d7c7dbb50266"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Backing Sharing Mode","type":"text"}]},{"type":"paragraph","content":[{"text":"Disk backing sharing modes can be updated via ","type":"text"},{"text":"vss-cli compute vm set disk up -r ","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"paragraph","content":[{"text":"Refer to the following table to pick the right ","type":"text"},{"text":"backing sharing","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sharingmultiwriter","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The virtual disk is shared between multiple virtual machines.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sharingnone","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The virtual disk is not shared.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Create"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-Create"}},"macroMetadata":{"macroId":{"value":"9efcffcc-efd8-4e91-bcee-91731c8d8ce7"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageVirtualDiskswiththevss-cli-Create"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-ManageVirtualDiskswiththevss-cli-Create"}},"macroMetadata":{"macroId":{"value":"c249c013-a2bd-417a-9f9a-4c318670de91"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Create","type":"text"}]},{"type":"paragraph","content":[{"text":"Creating a new virtual machine disk is as simple as updating, but switching the sub-command to ","type":"text"},{"text":"mk","type":"text","marks":[{"type":"code"}]},{"text":", for example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set vm-1233 disk mk --disk 20","type":"text"}]},{"type":"paragraph","content":[{"text":"Also, it supports providing both ","type":"text"},{"text":"backing_mode","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"backing_sharing","type":"text","marks":[{"type":"code"}]},{"text":" in the following format ","type":"text"},{"text":"===","type":"text","marks":[{"type":"code"}]},{"text":". If no ","type":"text"},{"text":"backing_mode","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"backing_sharing","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"backing_vmdk","type":"text","marks":[{"type":"code"}]},{"text":" are provided, defaults are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"backing_mode","type":"text","marks":[{"type":"code"}]},{"text":": ","type":"text"},{"text":"persistent","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"backing_sharing","type":"text","marks":[{"type":"code"}]},{"text":": ","type":"text"},{"text":"sharingnone","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"backing_vmdk","type":"text","marks":[{"type":"code"}]},{"text":": automatically generated by vSphere. (advanced)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"For instance:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set vm-1233 disk mk --disk 100 --disk 100=independent_persistent","type":"text"}]},{"type":"paragraph","content":[{"text":"Or in particular use cases, there could be a need for a ","type":"text"},{"text":"sharingmultiwriter","type":"text","marks":[{"type":"code"}]},{"text":" sharing mode:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set vm-1233 disk mk --disk 100=persistent=sharingmultiwriter","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"--disk","type":"text","marks":[{"type":"code"}]},{"text":" payload can also be provided in ","type":"text"},{"text":"JSON","type":"text","marks":[{"type":"code"}]},{"text":" format:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"vss-cli compute vm set vm-1233 disk mk –disk 100 –disk ‘{“capacity_gb”: 100, “backing_mode”: “independent_persistent”}’","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Specify-SCSI-controller"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-Specify-SCSI-controller"}},"macroMetadata":{"macroId":{"value":"2fc130f3-88bb-421f-ba6e-484c7b67a092"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageVirtualDiskswiththevss-cli-Specify-SCSI-controller"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-ManageVirtualDiskswiththevss-cli-Specify-SCSI-controller"}},"macroMetadata":{"macroId":{"value":"36536e85-bc0e-422b-bfab-c285548746c6"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Specify SCSI controller","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, the ITS Private Cloud API creates disks using the first SCSI controller and available slots in it. If a SCSI controller is full, a new controller will be created using our pre-defined settings based on operating systems.","type":"text"}]},{"type":"paragraph","content":[{"text":"There are cases when a virtual machine has more than one SCSI controller to ensure compatibility during the installation of the operating system and an additional using the VMware Paravirtual SCSI Controller to take advantage of the ","type":"text"},{"text":"greater throughput and lower CPU utilization","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Assuming there is a virtual machine with the following SCSI controller layout:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm get vm-2551 controller scsi\n\nlabel bus_number type\n----------------- ------------ -------------------------\nSCSI controller 0 0 VirtualLsiLogicController\nSCSI controller 1 1 ParaVirtualSCSIController","type":"text"}]},{"type":"paragraph","content":[{"text":"And there is a requirement to create a ","type":"text"},{"text":"100GB","type":"text","marks":[{"type":"code"}]},{"text":" disk on ","type":"text"},{"text":"SCSI controller 1","type":"text","marks":[{"type":"code"}]},{"text":" (Paravirtual), just include the ","type":"text"},{"text":"scsi","type":"text","marks":[{"type":"code"}]},{"text":" attribute with the ","type":"text"},{"text":"bus_number","type":"text","marks":[{"type":"code"}]},{"text":" as value in the ","type":"text"},{"text":"--disk","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"JSON","type":"text","marks":[{"type":"code"}]},{"text":" payload as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set vm-2551 disk mk --disk '{\"capacity_gb\": 100, \"scsi\": 1}'","type":"text"}]},{"type":"paragraph","content":[{"text":"The previous command creates a disk in the next available slot of ","type":"text"},{"text":"SCSI Controller 1","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Import-VMDK"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-Import-VMDK"}},"macroMetadata":{"macroId":{"value":"98020bd6-eb67-4351-96ff-1ce2bd56e3bd"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageVirtualDiskswiththevss-cli-Import-VMDK"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-ManageVirtualDiskswiththevss-cli-Import-VMDK"}},"macroMetadata":{"macroId":{"value":"b81649d2-4f3e-4d7c-a887-3bffe9bca9ec"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Import VMDK","type":"text"}]},{"type":"paragraph","content":[{"text":"Importing existing ","type":"text"},{"text":"VMDK","type":"text","marks":[{"type":"code"}]},{"text":" disks into the ITS Private Cloud hosted VM is also possible. In order to create a new disk from an existent ","type":"text"},{"text":"VMDK","type":"text","marks":[{"type":"code"}]},{"text":" compatible file, please follow these steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upload the ","type":"text"},{"text":"VMDK","type":"text","marks":[{"type":"code"}]},{"text":" file to ","type":"text"},{"text":"VSKEY-STOR","type":"text","marks":[{"type":"link","attrs":{"href":"https://vskey-stor.eis.utoronto.ca"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Execute ","type":"text"},{"text":"vss-cli compute vmdk personal sync","type":"text","marks":[{"type":"code"}]},{"text":" to synchronize the uploaded ","type":"text"},{"text":"VMDK","type":"text","marks":[{"type":"code"}]},{"text":" files.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"List to verify the files have successfully synchronized with ","type":"text"},{"text":"vss-cli compute vmdk personal ls","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":" id path name\n---- ------------------------------------------------------------------------------------ ----------------------------\n 4 [vssUser-xfers] vskey/josem/5012da9a-2563-82dc-f8d0-d5583fbcfde3/disk-0.vmdk disk-0.vmdk","type":"text"}]},{"type":"paragraph","content":[{"text":"4. Submit a VM disk creation request including the ","type":"text"},{"text":"backing_vmdk","type":"text","marks":[{"type":"code"}]},{"text":" attribute with the vmdk ","type":"text"},{"text":"id","type":"text","marks":[{"type":"code"}]},{"text":" in the value as ","type":"text"},{"text":"JSON","type":"text","marks":[{"type":"code"}]},{"text":" payload as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set vm-1233 disk mk --disk 100 --disk '{\"capacity_gb\": 100, \"backing_mode\": \"persistent\", \"backing_vmdk\": 4}'","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The task will first transfer the original VMDK, validate, inflate and convert the file to the right vSphere format.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Copy"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-Copy"}},"macroMetadata":{"macroId":{"value":"f93f8e1c-8262-47a6-a357-33046b9e018f"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageVirtualDiskswiththevss-cli-Copy"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-ManageVirtualDiskswiththevss-cli-Copy"}},"macroMetadata":{"macroId":{"value":"2d2ae016-706e-4808-aa5a-5479ca27c1b8"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Copy","type":"text"}]},{"type":"paragraph","content":[{"text":"Similar to importing a ","type":"text"},{"text":"VMDK","type":"text","marks":[{"type":"code"}]},{"text":", copying virtual disks across virtual machines allows the flexibility to duplicate a disk from one VM to another with a simple command.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Source: 2311P-VM-A","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Target: 2311P-VM-B","type":"text"}]}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Get source VM disk to copy from the ","type":"text"},{"text":"file_name","type":"text","marks":[{"type":"code"}]},{"text":" attribute as follows:","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli -o yaml compute vm get 2311P-VM-A disk","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Submit an import request with the ","type":"text"},{"text":"vss-cli compute vm set vm-2551 disk cp","type":"text","marks":[{"type":"code"}]},{"text":" command:","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set 2311P-VM-B disk cp --disk '{\"capacity_gb\": 100, \"backing_vmdk\": \"[XXXX-NN] vm-name/vm-name_1.vmdk\"}'","type":"text"}]},{"type":"paragraph","content":[{"text":"3. A confirmation prompt will show with the target VM information, if you would like to skip this step, add the ","type":"text"},{"text":"--confirm","type":"text","marks":[{"type":"code"}]},{"text":" option to the ","type":"text"},{"text":"cp","type":"text","marks":[{"type":"code"}]},{"text":" command.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"VMDK","type":"text","marks":[{"type":"code"}]},{"text":" Copy tasks might take a while based on the source VM size and how much resources are available.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Remove"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-Remove"}},"macroMetadata":{"macroId":{"value":"c8ef3309-8501-4ff0-91a1-a2c2534de9a5"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"ManageVirtualDiskswiththevss-cli-Remove"},"legacyAnchorId":{"value":"ManageVirtualDiskswiththevss-cli-ManageVirtualDiskswiththevss-cli-Remove"}},"macroMetadata":{"macroId":{"value":"7a7bc8d3-bb72-4372-b1f6-c26c4d633471"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Remove","type":"text"}]},{"type":"paragraph","content":[{"text":"Disk removal will ask for confirmation if flag ","type":"text"},{"text":"-r/--rm","type":"text","marks":[{"type":"code"}]},{"text":" is not provided. This is just as fail safe for mistakes that can happen and since disk removal is a one way action, it may end in data loss if not used carefully.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following example demonstrates how to remove a disk with a confirmation prompt:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set vm-1233 disk rm 2\n\nAre you sure you want to delete disk unit 2? [y/N]: N\nError: Cancelled by user.","type":"text"}]},{"type":"paragraph","content":[{"text":"If your answer is ","type":"text"},{"text":"N","type":"text","marks":[{"type":"strong"}]},{"text":", the command will exit as shown above.","type":"text"}]},{"type":"paragraph","content":[{"text":"To override disk removal confirmation prompt, just add ","type":"text"},{"text":"-r/--rm","type":"text","marks":[{"type":"code"}]},{"text":" flag as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm set vm-1233 disk rm --rm 2","type":"text"}]}],"version":1}

Browser not supported