Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update and rename ReadMe to ReadMe.md #972

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 0 additions & 44 deletions static_vm_package/ReadMe

This file was deleted.

44 changes: 44 additions & 0 deletions static_vm_package/ReadMe.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# vCenter Static VM Shell Example

Release Date: February 2019

This article explains how to add a VM, which already exists on a vCenter server, as a CloudShell inventory resource. Once added to CloudShell, users will be able to add the VM resource to their blueprint and sandbox diagrams and use it like a regular resource. The vCenter Static VM shell is provided for this purpose.

This is useful if the VM is too complex or time consuming to power on or off, or if the VM is always on and is not added or deleted from the vCenter as part of the sandbox lifecycle. For example, in VMs that maintain a database or a production server.

_**Note:** CloudShell does not automatically power off static VMs at the end of the sandbox because they are commonly used as shared resources._

**To load an existing VM as a resource:**

1. Download the vCenter Static VM shell. If you choose to develop your own shell, make sure it has an Autoload command and supports loading the VM's information into CloudShell.

2. Import the vCenter Static VM shell into CloudShell Portal. You can drag the shell's zip file into CloudShell Portal or use the **Import Package** option in the user menu.

3. In the **Inventory** dashboard, in the **Resources** tab, click the folder in which you want to create the resource.

4. Click **Add New**.

5. In the **Create New Resource** dialog box, select the **vCenter Static VM** Shell from the list.

6. Enter a **Name** for the VM resource that you want to create in CloudShell.

_**Note:** The resource's name has a limit of 100 characters and can only contain alpha-numeric characters, spaces, and the following characters: | . - _ ] [_

7. In the **Address** field, enter the IP address of the VM, or enter **na** if the IP address is not known or does not exist.

8. Click **Create**.

The **Resource** dialog box is displayed.</br>

9. Enter the required information.

* **vCenter Name**: vCenter cloud provider resource. The cloud provider resource defines the settings of the VM's vCenter server and provides commands such as **Power On**, **Refresh IP** and connectivity commands for the resource in the sandbox. For additional information, see <a href="https://help.quali.com/Online%20Help/9.2/Portal/Content/CSP/INVN/Add-vCenter-Shell.htm" target="_blank">Adding VMware vCenter Cloud Provider Resource</a>.
vCenter VM: Path to the vCenter VM. The path is relative to the datacenter defined in the selected vCenter cloud provider resource and must include the VM's name. For example: *Temp/My VM*

_**Note:** If the VM is powered off, the end user will need to power it on in the sandbox._

10. Click **Start Discovery**.

When the discovery process completes, a confirmation message is displayed. The resource is displayed in the **Inventory** dashboard and can be used in blueprints and sandboxes.

In the sandbox, the VM resource behaves like the VM of a deployed App and uses the commands provided by the vCenter cloud provider, as explained in <a href="https://help.quali.com/Online%20Help/9.2/Portal/Content/CSP/LAB-MNG/Sndbx-Use-Apps.htm#Running" target="_blank">Run App commands</a>.