diff --git a/docs/en-US/add-vm-tier-sharednw.xml b/docs/en-US/add-vm-tier-sharednw.xml
new file mode 100644
index 00000000000..e1a37c8895c
--- /dev/null
+++ b/docs/en-US/add-vm-tier-sharednw.xml
@@ -0,0 +1,64 @@
+
+
+%BOOK_ENTITIES;
+]>
+
+
+ Deploying VMs to a Tier and Shared Network
+
+
+ Log in to the &PRODUCT; UI as an administrator or end user.
+
+
+ In the left navigation, choose Instances.
+
+
+ Select the VM you want to work with.
+
+
+ Click Add Instance.
+
+
+ Select a zone.
+
+
+ Select a template or ISO, then follow the steps in the wizard.
+ For more information about how the templates came to be in this list, see .
+
+
+ Ensure that the hardware you have allows starting the selected service offering.
+
+
+ Under Networks, select networks for the VM you are launching.
+ You can deploy a VM to a VPC tier and multiple shared networks.
+
+
+
+
+
+ addvm-tier-sharednw.png: adding a VM to a VPC tier and shared network.
+
+
+
+
+ Click Next, review the configuration and click Launch.
+ Your VM will be deployed to the selected VPC tier and shared network.
+
+
+
diff --git a/docs/en-US/configure-vpc.xml b/docs/en-US/configure-vpc.xml
index 45237d21cbb..e0e2ee93f19 100644
--- a/docs/en-US/configure-vpc.xml
+++ b/docs/en-US/configure-vpc.xml
@@ -26,6 +26,7 @@
+
diff --git a/docs/en-US/creating-vms.xml b/docs/en-US/creating-vms.xml
index 18995979a80..86d05d3f7bc 100644
--- a/docs/en-US/creating-vms.xml
+++ b/docs/en-US/creating-vms.xml
@@ -21,35 +21,70 @@
under the License.
-->
- Creating VMs
- Virtual machines are usually created from a template. Users can also create blank virtual machines. A blank virtual machine is a virtual machine without an OS template. Users can attach an ISO file and install the OS from the CD/DVD-ROM.
- You can create a VM without starting it. You can determine whether the VM needs to be started as part of the VM deployment. A request parameter, startVM, in the deployVm API provides this feature. For more information, see the Developer's Guide
- To create a VM from a template:
-
- Log in to the &PRODUCT; UI as an administrator or user.
- In the left navigation bar, click Instances.
-
- Click Add Instance.
-
-
- Select a zone.
-
- Select a template, then follow the steps in the wizard. For more information about how the templates came to be in this list, see .
- Be sure that the hardware you have allows starting the selected service offering.
- Click Submit and your VM will be created and started.
- For security reason, the internal name of the VM is visible only to the root admin.
-
-
- To create a VM from an ISO:
- (XenServer) Windows VMs running on XenServer require PV drivers, which may be provided in the template or added after the VM is created. The PV drivers are necessary for essential management functions such as mounting additional volumes and ISO images, live migration, and graceful shutdown.
-
- Log in to the &PRODUCT; UI as an administrator or user.
- In the left navigation bar, click Instances.
- Click Add Instance.
- Select a zone.
- Select ISO Boot, and follow the steps in the wizard.
- Click Submit and your VM will be created and started.
-
-
+ Creating VMs
+ Virtual machines are usually created from a template. Users can also create blank virtual
+ machines. A blank virtual machine is a virtual machine without an OS template. Users can attach
+ an ISO file and install the OS from the CD/DVD-ROM.
+
+ You can create a VM without starting it. You can determine whether the VM needs to be
+ started as part of the VM deployment. A request parameter, startVM, in the deployVm API
+ provides this feature. For more information, see the Developer's Guide
+
+ To create a VM from a template:
+
+
+ Log in to the &PRODUCT; UI as an administrator or user.
+
+
+ In the left navigation bar, click Instances.
+
+
+ Click Add Instance.
+
+
+ Select a zone.
+
+
+ Select a template, then follow the steps in the wizard. For more information about how
+ the templates came to be in this list, see .
+
+
+ Be sure that the hardware you have allows starting the selected service offering.
+
+
+ Click Submit and your VM will be created and started.
+
+ For security reason, the internal name of the VM is visible only to the root
+ admin.
+
+
+
+ To create a VM from an ISO:
+
+ (XenServer) Windows VMs running on XenServer require PV drivers, which may be provided in
+ the template or added after the VM is created. The PV drivers are necessary for essential
+ management functions such as mounting additional volumes and ISO images, live migration, and
+ graceful shutdown.
+
+
+
+ Log in to the &PRODUCT; UI as an administrator or user.
+
+
+ In the left navigation bar, click Instances.
+
+
+ Click Add Instance.
+
+
+ Select a zone.
+
+
+ Select ISO Boot, and follow the steps in the wizard.
+
+
+ Click Submit and your VM will be created and started.
+
+
+
-
diff --git a/docs/en-US/images/addvm-tier-sharednw.png b/docs/en-US/images/addvm-tier-sharednw.png
new file mode 100644
index 00000000000..e60205f7219
Binary files /dev/null and b/docs/en-US/images/addvm-tier-sharednw.png differ