<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>10.10. Appending a Display Name to the Guest VM’s Internal Name</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Apache_CloudStack-Admin_Guide-4.2.0-en-US-1-" /><script type="text/javascript" src="../../../../../toc.js"></script><script type="text/javascript">
              addID('Apache_CloudStack');
              
	      addID('Apache_CloudStack.4.2.0');
              
              addID('Apache_CloudStack.4.2.0.books');
	      addID('Apache_CloudStack.4.2.0.Admin_Guide');
              </script><link rel="home" href="index.html" title="CloudStack Administrator's Guide" /><link rel="up" href="virtual-machines.html" title="Chapter 10. Working With Virtual Machines" /><link rel="prev" href="changing-vm-name-os-group.html" title="10.9. Changing the VM Name, OS, or Group" /><link rel="next" href="changing-service-offering-for-vm.html" title="10.11. Changing the Service Offering for a VM" /></head><body class="toc_embeded "><div id="tocdiv" class="toc"><iframe id="tocframe" class="toc" src="../../../../toc.html">This is an iframe, to view it upgrade your browser or enable iframe display.</iframe></div><p id="title"><a class="left" href="http://cloudstack.apache.org"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="http://cloudstack.apache.org/docs"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="changing-vm-name-os-group.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="changing-service-offering-for-vm.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="append-displayname-vms" lang="en-US"><div class="titlepage"><div><div><h2 class="title">10.10. Appending a Display Name to the Guest VM’s Internal Name</h2></div></div></div><div class="para">
		Every guest VM has an internal name. The host uses the internal name to identify the guest VMs. CloudStack gives you an option to provide a guest VM with a display name. You can set this display name as the internal name so that the vCenter can use it to identify the guest VM. A new global parameter, vm.instancename.flag, has now been added to achieve this functionality.
	</div><div class="para">
		The default format of the internal name is i-&lt;user_id&gt;-&lt;vm_id&gt;-&lt;instance.name&gt;, where instance.name is a global parameter. However, If vm.instancename.flag is set to true, and if a display name is provided during the creation of a guest VM, the display name is appended to the internal name of the guest VM on the host. This makes the internal name format as i-&lt;user_id&gt;-&lt;vm_id&gt;-&lt;displayName&gt;. The default value of vm.instancename.flag is set to false. This feature is intended to make the correlation between instance names and internal names easier in large data center deployments.
	</div><div class="para">
		The following table explains how a VM name is displayed in different scenarios.
	</div><div class="informaltable"><table border="1"><colgroup><col width="20%" align="left" class="c1" /><col width="20%" align="left" class="c2" /><col width="20%" align="left" class="c3" /><col width="20%" align="left" class="c4" /><col width="20%" align="left" class="c5" /></colgroup><thead><tr><th class="" align="left">
						<div class="para">
							User-Provided Display Name
						</div>
					</th><th class="" align="left">
						<div class="para">
							vm.instancename.flag
						</div>
					</th><th class="" align="left">
						<div class="para">
							Hostname on the VM
						</div>
					</th><th class="" align="left">
						<div class="para">
							Name on vCenter
						</div>
					</th><th class="" align="left">
						<div class="para">
							Internal Name
						</div>
					</th></tr></thead><tbody><tr><td class="" align="left">
						<div class="para">
							Yes
						</div>
					</td><td class="" align="left">
						<div class="para">
							True
						</div>
					</td><td class="" align="left">
						<div class="para">
							Display name
						</div>
					</td><td class="" align="left">
						<div class="para">
							i-&lt;user_id&gt;-&lt;vm_id&gt;-displayName
						</div>
					</td><td class="" align="left">
						<div class="para">
							i-&lt;user_id&gt;-&lt;vm_id&gt;-displayName
						</div>
					</td></tr><tr><td class="" align="left">
						<div class="para">
							No
						</div>
					</td><td class="" align="left">
						<div class="para">
							True
						</div>
					</td><td class="" align="left">
						<div class="para">
							UUID
						</div>
					</td><td class="" align="left">
						<div class="para">
							i-&lt;user_id&gt;-&lt;vm_id&gt;-&lt;instance.name&gt;
						</div>
					</td><td class="" align="left">
						<div class="para">
							i-&lt;user_id&gt;-&lt;vm_id&gt;-&lt;instance.name&gt;
						</div>
					</td></tr><tr><td class="" align="left">
						<div class="para">
							Yes
						</div>
					</td><td class="" align="left">
						<div class="para">
							False
						</div>
					</td><td class="" align="left">
						<div class="para">
							Display name
						</div>
					</td><td class="" align="left">
						<div class="para">
							i-&lt;user_id&gt;-&lt;vm_id&gt;-&lt;instance.name&gt;
						</div>
					</td><td class="" align="left">
						<div class="para">
							i-&lt;user_id&gt;-&lt;vm_id&gt;-&lt;instance.name&gt;
						</div>
					</td></tr><tr><td class="" align="left">
						<div class="para">
							No
						</div>
					</td><td class="" align="left">
						<div class="para">
							False
						</div>
					</td><td class="" align="left">
						<div class="para">
							UUID
						</div>
					</td><td class="" align="left">
						<div class="para">
							i-&lt;user_id&gt;-&lt;vm_id&gt;-&lt;instance.name&gt;
						</div>
					</td><td class="" align="left">
						<div class="para">
							i-&lt;user_id&gt;-&lt;vm_id&gt;-&lt;instance.name&gt;
						</div>
					</td></tr></tbody></table></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="changing-vm-name-os-group.html"><strong>Prev</strong>10.9. Changing the VM Name, OS, or Group</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="changing-service-offering-for-vm.html"><strong>Next</strong>10.11. Changing the Service Offering for a VM</a></li></ul></body></html>
