{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Having a virtual machine for testing purposes on your workstation is very common nowadays. Once the virtual machine is ready to be imported to the ITS Private Cloud, we provide a method to do so. This example, describes basic steps to import a virtual machine OVF with disks or an OVA appliance to our environment.","type":"text"}]},{"type":"paragraph","content":[{"text":"Please, refer to the official documentation for your virtualization software to produce a virtual machine export in OVF or OVA. If you happen to be using VMware workstation or fusion, please refer to the following links:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VMware Fusion - Export a VM to OVF","type":"text","marks":[{"type":"link","attrs":{"href":"http://pubs.vmware.com/fusion-8/topic/com.vmware.fusion.using.doc/GUID-16E390B1-829D-4289-8442-270A474C106A.html"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VMware Workstation - Export a VM to OVF","type":"text","marks":[{"type":"link","attrs":{"href":"https://pubs.vmware.com/workstation-12/topic/com.vmware.ws.using.doc/GUID-D1FEBF81-D0AA-469B-87C3-D8E8C45E4ED9.html"}}]}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The ITS Private Cloud virtualization platform is ","type":"text"},{"text":"VMware vSphere 7.0","type":"text","marks":[{"type":"strong"}]},{"text":", and the maximum ","type":"text"},{"text":"VMX hardware version is 19","type":"text","marks":[{"type":"strong"}]},{"text":". If you have the latest VMware Fusion or Workstation, update VM compatibility settings to version 19.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"As a best practice, we recommend to remove unused devices such as ","type":"text"},{"text":"sound cards","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"printer ports","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"USB","type":"text","marks":[{"type":"strong"}]},{"text":" and other unused devices, prior exporting the virtual machine.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Source-Image"},"legacyAnchorId":{"value":"DeployInstancefromImage-Source-Image"}},"macroMetadata":{"macroId":{"value":"59b9c744-777e-487f-86bd-138fa36acf64"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"DeployInstancefromImage-Source-Image"},"legacyAnchorId":{"value":"DeployInstancefromImage-DeployInstancefromImage-Source-Image"}},"macroMetadata":{"macroId":{"value":"2b48332c-baf6-4e57-8a12-8478a5694110"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Source Image","type":"text"}]},{"type":"paragraph","content":[{"text":"Once you have exported your virtual machine in OVA or OVF, you can either login to ","type":"text"},{"text":"VSKEY-STOR","type":"text","marks":[{"type":"link","attrs":{"href":"https://vskey-stor.eis.utoronto.ca"}}]},{"text":" with your VSS credentials or ","type":"text"},{"text":"vss-cli stor","type":"text","marks":[{"type":"code"}]},{"text":" to upload the OVA or OVF (including vmdk disks) to deploy.","type":"text"}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"vss-cli stor ul ","type":"text","marks":[{"type":"code"}]},{"text":" to upload OVF and disk files to ","type":"text"},{"text":"VSKEY-STOR","type":"text","marks":[{"type":"link","attrs":{"href":"https://vskey-stor.eis.utoronto.ca"}}]},{"text":" from command line as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli stor ul ~/Downloads/CentOS-7-x86_64-VMware.ovf\nvss-cli stor ul ~/Downloads/disk-0.vmdk","type":"text"}]},{"type":"paragraph","content":[{"text":"Verify files were uploaded successfully with ","type":"text"},{"text":"vss-cli stor ls","type":"text","marks":[{"type":"code"}]},{"text":" :","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli stor ls images/centos\n\nitems : disk-0.vmdk, CentOS-7-x86_64-VMware.ovf","type":"text"}]},{"type":"paragraph","content":[{"text":"At this point, your image is almost ready to be deployed. Sync your images with ","type":"text"},{"text":"vss-cli compute image personal sync","type":"text","marks":[{"type":"code"}]},{"text":" in order to make them available in the API. You can verify if the task has successfully completed by issuing the command ","type":"text"},{"text":"vss-cli request image ls","type":"text","marks":[{"type":"code"}]},{"text":" as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli request image ls -s created_on desc\n\n id created_on updated_on status type\n---- --------------------------- --------------------------- --------- ------\n 68 2018-07-18 Wed 15:36:49 EDT 2018-07-18 Wed 15:36:50 EDT Processed VM","type":"text"}]},{"type":"paragraph","content":[{"text":"Verify its availability by running ","type":"text"},{"text":"vss-cli compute image personal ls","type":"text","marks":[{"type":"code"}]},{"text":" as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute image personal ls\npath name\n------------------------------------------------------------------- -------------------------------------\n[vssUser-xfers] vss-ci/Images/CentOS-7-x86_64-VMware.ovf CentOS-7-x86_64-VMware.ovf","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This version of the VSS CLI supports providing image reference not only using the path, but also using name or Id. In case of multiple results, the CLI prompts to select the right instance.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Save the ","type":"text"},{"text":"path","type":"text","marks":[{"type":"code"}]},{"text":" in ","type":"text"},{"text":"SIMAGE","type":"text","marks":[{"type":"code"}]},{"text":" environment variable.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"export SIMAGE=\"[vssUser-xfers] vss-ci/Images/CentOS-7-x86_64-VMware.ovf\"","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Launch-Instance"},"legacyAnchorId":{"value":"DeployInstancefromImage-Launch-Instance"}},"macroMetadata":{"macroId":{"value":"3f9ec111-b44a-4acd-942e-db6cf887c253"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"DeployInstancefromImage-Launch-Instance"},"legacyAnchorId":{"value":"DeployInstancefromImage-DeployInstancefromImage-Launch-Instance"}},"macroMetadata":{"macroId":{"value":"fbc17e90-fd47-4274-aa16-dcd3b6d00893"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Launch Instance","type":"text"}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"vss-cli compute vm mk from-image","type":"text","marks":[{"type":"code"}]},{"text":" to deploy a virtual machine from OVA/OVF and provide the options and arguments specified in the command, as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"Usage: vss-cli compute vm mk from-image [OPTIONS] [NAME]\n\n Deploy virtual machine from image.\n\nOptions:\n -s, --source TEXT Source Virtual Machine OVA/OVF id, name or\n path. [required]\n -d, --description TEXT A brief description. [required]\n -b, --client TEXT Client department. [required]\n -a, --admin TEXT Admin name, phone number and email separated\n by `:` i.e. \"John\n Doe:416-123-1234:john.doe@utoronto.ca\"\n -r, --inform TEXT Informational contact emails in comma\n separated\n -u, --usage [Test|Prod|Dev|QA] Vm usage.\n -o, --os TEXT Guest operating system id. [required]\n -m, --memory INTEGER Memory in GB.\n -c, --cpu INTEGER Cpu count.\n --cores-per-socket INTEGER Cores per socket.\n -f, --folder TEXT Logical folder moref name or path.\n [required]\n --scsi TEXT SCSI Controller Spec =.\n -i, --disk TEXT Disk spec\n ==.\n optional: backing_mode, backing_sharing\n [required]\n -n, --net TEXT Network adapter =.\n [required]\n -t, --domain TEXT Target fault domain name or moref.\n --notes TEXT Custom notes.\n -p, --custom-spec TEXT Guest OS custom specification in JSON\n format.\n -e, --extra-config TEXT Extra configuration key=value format.\n --power-on Power on after successful deployment.\n --template Mark the VM as template after deployment.\n --user-data TEXT Cloud-init user_data YAML file path to pre-\n configure guest os upon first boot.\n --network-config TEXT Cloud-init network-config YAML file path to\n pre-configure guest os upon first boot.\n --vss-service TEXT VSS Service related to VM\n -w, --firmware TEXT Firmware type.\n --tpm Add Trusted Platform Module device.\n --storage-type TEXT Storage type.\n --retire-type [timedelta|datetime]\n Retirement request type.\n --retire-warning INTEGER Days before retirement date to notify\n --retire-value TEXT Value for given retirement type. i.e.\n ,,\n --help Show this message and exit.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Operating-system"},"legacyAnchorId":{"value":"DeployInstancefromImage-Operating-system"}},"macroMetadata":{"macroId":{"value":"a0cfe496-5f9d-422b-8190-38a0371b670f"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"DeployInstancefromImage-Operating-system"},"legacyAnchorId":{"value":"DeployInstancefromImage-DeployInstancefromImage-Operating-system"}},"macroMetadata":{"macroId":{"value":"28867fa7-1383-4956-bc64-7da09b5e66ac"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Operating system","type":"text"}]},{"type":"paragraph","content":[{"text":"Run ","type":"text"},{"text":"vss-cli compute os ls","type":"text","marks":[{"type":"code"}]},{"text":" to display the list of supported operating systems in the ITS Private Cloud. In order to narrow down the list to only ","type":"text"},{"text":"CentOS","type":"text","marks":[{"type":"strong"}]},{"text":" operating systems, use the ","type":"text"},{"text":"--filter-by/-f","type":"text","marks":[{"type":"code"}]},{"text":" option which is structured ","type":"text"},{"text":"=,","type":"text","marks":[{"type":"code"}]},{"text":" and available operators are ","type":"text"},{"text":"eq, ne, lt, le, gt, ge, like, in","type":"text","marks":[{"type":"strong"}]},{"text":". So, to limit results to just ","type":"text"},{"text":"CentOS","type":"text","marks":[{"type":"strong"}]},{"text":", use the following filter:","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This version of the VSS CLI supports providing OS reference not only using the ","type":"text"},{"text":"guest_id","type":"text","marks":[{"type":"code"}]},{"text":", but also the ","type":"text"},{"text":"full_name","type":"text","marks":[{"type":"code"}]},{"text":" or Id. In case of multiple results, the CLI prompts to select the right instance.","type":"text"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute os ls --filter-by full_name=CentOS\n\n id guest_id full_name family\n---- --------------- ------------------- ----------\n 24 centos64Guest CentOS 4/5 (64-bit) linuxGuest\n 70 centos6_64Guest CentOS 6 (64-bit) linuxGuest\n 26 centos6Guest CentOS 6 linuxGuest\n 15 centos7_64Guest CentOS 7 (64-bit) linuxGuest\n 78 centos7Guest CentOS 7 linuxGuest\n 95 centos8_64Guest CentOS 8 (64-bit) linuxGuest\n 2 centosGuest CentOS 4/5 linuxGuest","type":"text"}]},{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"OS","type":"text","marks":[{"type":"code"}]},{"text":" environment variable to ","type":"text"},{"text":"centos64Guest","type":"text","marks":[{"type":"code"}]},{"text":" to save the ","type":"text"},{"text":"guest_id","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"export OS=centos64Guest","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Network"},"legacyAnchorId":{"value":"DeployInstancefromImage-Network"}},"macroMetadata":{"macroId":{"value":"52c0c4c1-b3b3-44e9-a902-88ff3df14b64"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"DeployInstancefromImage-Network"},"legacyAnchorId":{"value":"DeployInstancefromImage-DeployInstancefromImage-Network"}},"macroMetadata":{"macroId":{"value":"60dd4ee7-8015-4bfc-9906-d1b5c7f4e0c0"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Network","type":"text"}]},{"type":"paragraph","content":[{"text":"Run ","type":"text"},{"text":"vss-cli compute net ls","type":"text","marks":[{"type":"code"}]},{"text":" to list available network segments to your account. You must have at least ","type":"text"},{"text":"VL-1584-VSS-PUBLIC","type":"text","marks":[{"type":"code"}]},{"text":" which is our public network.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This version of the VSS CLI supports managing networks not only using the moref, but also using names. In case of multiple results, the CLI prompts to select the right instance.","type":"text"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute net ls\nmoref name description\n----------------- ------------------ ----------------------------------------\ndvportgroup-11052 VL-1584-VSS-PUBLIC VSS Public network 142.1.216.0/23","type":"text"}]},{"type":"paragraph","content":[{"text":"Save ","type":"text"},{"text":"dvportgroup-11052","type":"text","marks":[{"type":"code"}]},{"text":" in ","type":"text"},{"text":"NET","type":"text","marks":[{"type":"code"}]},{"text":" environment variable:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"export NET=dvportgroup-11052","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, the network adapter will use ","type":"text"},{"text":"vmxnet3","type":"text","marks":[{"type":"strong"}]},{"text":" which provides ideal performance, however a few legacy operating systems does not have the drivers. In such case, you can specify which adapter type between: ","type":"text"},{"text":"e1000e*","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"e1000","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"vmxnet2","type":"text","marks":[{"type":"strong"}]},{"text":" or ","type":"text"},{"text":"vmxnet3","type":"text","marks":[{"type":"strong"}]},{"text":". To do so, append the adapter type to the network adapter network as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"export NET=dvportgroup-11052=e1000e","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Folder"},"legacyAnchorId":{"value":"DeployInstancefromImage-Folder"}},"macroMetadata":{"macroId":{"value":"c4267071-1f47-4c92-aba1-218360ae9232"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"DeployInstancefromImage-Folder"},"legacyAnchorId":{"value":"DeployInstancefromImage-DeployInstancefromImage-Folder"}},"macroMetadata":{"macroId":{"value":"68566aa3-fb08-418c-82c3-bc528cb525c6"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Folder","type":"text"}]},{"type":"paragraph","content":[{"text":"Logical folders can be listed by running ","type":"text"},{"text":"vss-cli compute folder ls","type":"text","marks":[{"type":"code"}]},{"text":". Select the target ","type":"text"},{"text":"moref","type":"text","marks":[{"type":"code"}]},{"text":" folder to store the virtual machine on:","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This version of the VSS CLI supports managing logical folders not only using the moref, but also using name or path. In case of multiple results, the CLI prompts to select the right instance.","type":"text"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute folder ls -f name=like,API%\n\nmoref name parent path\n----------- ------- -------- ----------------------------\ngroup-v6736 APIDemo jm jm > APIDemo","type":"text"}]},{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"FOLDER","type":"text","marks":[{"type":"code"}]},{"text":" environment variable to the target folder (the folder moref may vary):","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"export FOLDER=group-v6736","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Deployment"},"legacyAnchorId":{"value":"DeployInstancefromImage-Deployment"}},"macroMetadata":{"macroId":{"value":"ee40afab-844a-4a4c-beee-0cee4d0a1a70"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"DeployInstancefromImage-Deployment"},"legacyAnchorId":{"value":"DeployInstancefromImage-DeployInstancefromImage-Deployment"}},"macroMetadata":{"macroId":{"value":"e0bf3fbf-be86-4bc4-986c-5f3c56631fec"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Deployment","type":"text"}]},{"type":"paragraph","content":[{"text":"At this point, we have all requirements to run ","type":"text"},{"text":"vss-cli compute vm mk from-image","type":"text","marks":[{"type":"code"}]},{"text":" command to submit a deployment request. For this example, the request is made for 2GB of memory, 2 vCPU, 2x40GB disks.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm mk from-image --source $SIMAGE --client EIS --memory 2 --cpu 2 \\\n--folder $FOLDER --disk 40 --disk 40 --net $NET --os $OS \\\n--description \"CentOS virtual machine from OVF\" CENTOS_1","type":"text"}]},{"type":"paragraph","content":[{"text":"The following command should work as well:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm mk --wait from-image --power-on --source CentOS-7-x86_64-VMware.ovf \\\n--client EIS --folder APIDemo \\\n--memory 2 --cpu 2 --disk 40 --disk 40 --net PUBLIC --os centos \\\n--storage-type ssd \\\n--description \"CentOS virtual machine from OVF\" CENTOS-1","type":"text"}]},{"type":"paragraph","content":[{"text":"A confirmation email will be sent and the command will return the request ","type":"text"},{"text":"id","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"task_id","type":"text","marks":[{"type":"code"}]},{"text":" as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"id : 77\nstatus : IN_PROGRESS\ntask_id : c62e579d-240b-4e1d-8b5d-0c643bfd72f5\nmessage : Request has been accepted for processing\n⏳ Waiting for request 77 to complete...\n🎉 Request 77 completed successfully:\nwarnings : Image file(s) transferred: CentOS-7-x86_64-VMware.ovf, disk-0.vmdk, VM 2004T-CENTOS-1 has been successfully\n deployed from {'name': 'CentOS-7-x86_64-VMware.ovf', 'path': '[vssUser-xfers] vskey/jm/501264bc-5d2d-3330-e0d9-562309e33331/CentOS-7-x86_64-VMware.ovf'},\n Error while updating Memory: Target memory is equals to current memory.\n Successfully powered on.,\n Fault Domain: Cluster1 (domain-cXX) , Created in: VSS > Development > APIDemo (group-XXX),\n Network adapter 1 (vmxnet3): 00:50:56:b0:a8:6c: Quarantine\nerrors :","type":"text"}]},{"type":"paragraph","content":[{"text":"Wait a few minutes until the virtual machine is deployed.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":" vss-cli request new ls -s created_on=desc -c 1\n\n id created_on updated_on status vm_moref vm_name approval.approved built_from\n---- --------------------------- --------------------------- --------- ---------- --------------- ------------------- ------------\n 77 2020-04-24 Fri 16:49:28 EDT 2020-04-24 Fri 16:50:06 EDT PROCESSED vm-2184 2004T-CENTOS-1 True image","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Access-Virtual-Machine"},"legacyAnchorId":{"value":"DeployInstancefromImage-Access-Virtual-Machine"}},"macroMetadata":{"macroId":{"value":"c8f406d0-b0eb-4abd-bd71-ed0301436688"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"DeployInstancefromImage-Access-Virtual-Machine"},"legacyAnchorId":{"value":"DeployInstancefromImage-DeployInstancefromImage-Access-Virtual-Machine"}},"macroMetadata":{"macroId":{"value":"71212c6c-5adc-4465-aa31-697d62911bab"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Access Virtual Machine","type":"text"}]},{"type":"paragraph","content":[{"text":"Since we added the ","type":"text"},{"text":"--power-on","type":"text","marks":[{"type":"code"}]},{"text":" option, the virtual machine should have been powered on right after the Guest Operating System Customization task completed.","type":"text"}]},{"type":"paragraph","content":[{"text":"In a few minutes the virtual machine will show the hostname and ip configuration by running ","type":"text"},{"text":"vss-cli compute vm get guest","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm get docker-node1 guest\n\nhostname : fe2\nip_address : 142.1.217.228, fe80::250:56ff:fe92:323f\nfull_name : CentOS 8 (64-bit)\nguest_id : centos8_64Guest\nrunning_status : guestToolsRunning","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Guest Host Name","type":"text","marks":[{"type":"strong"}]},{"text":" shows that the hostname has been changed, and now you will be able to access via either ","type":"text"},{"text":"ssh","type":"text","marks":[{"type":"code"}]},{"text":" or the virtual machine console:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"ssh username@","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"vss-cli compute vm get Frontend2 vsphere-link -l","type":"text"}]}],"version":1}