In this article:
- Overview
- Audience
- Prerequisites
- Required Permissions
- Bootstrapping virtual machine templates with the Cloud Application Manager Agent
- Registering a vCenter provider in Cloud Application Manager
- Deploying in Your vCenter
- Registering Instances to Your vCenter Provider
- Getting General Support
Overview
This article is meant to assist users of Cloud Application Manager to configure a VMware vCenter provider and deploy virtual machines with it.
Audience
All users of Cloud Application Manager using VMware vCenter providers.
Prerequisites
- An active Cloud Application Manager account
- Access and credentials to a VMware vCenter version 5.5 or later.
- A virtual machine template (Linux or Windows) on the vCenter server. Virtual machine templates has to be bootstrapped with the Cloud Application Manager Agent.
- If the vCenter is behind a firewall, has to be open on the firewall:
- 443/TCP incoming to vCenter server: for Cloud Application Manager to make API calls on vCenter.
- 443/TCP outgoing: to allow Cloud Application Manager Agents running on the deployed virtual machines to connect back to Cloud Application Manager.
Required Permissions
A vCenter user needs at least the following permissions be able to authenticate, deploy and manage instances through Cloud Application Manager. Although this list was compiled for vCenter 5.5, similar permissions apply for later versions.
Assign access for | With privileges |
---|---|
Datastore | |
Global | Cancel task |
Manage custom attributes | Set custom attribute |
Network | Assign network |
Resource | Assign virtual machine to resource pool |
Scheduled task | |
Tasks | |
Virtual machine (Configuration) | |
Virtual machine (Interaction) | |
Virtual machine (Inventory) | |
Virtual machine (Provisioning) |
Bootstrapping virtual machine templates with the Cloud Application Manager Agent
vCenter templates need elasticbox-init to allow the Cloud Application Manager agent to execute box scripts at deploy time.
Linux
Follow these steps to install elasticbox-init on a Linux template.
-
Log in to the vSphere client and open the Linux virtual machine.
-
SSH into the virtual machine.
-
Run this command with root privileges to install elasticbox-init:
curl -L https://cam.ctl.io/agent/linux/vsphere/template_customization_script.sh | sudo bash
- Note: If running Cloud Application Manager as an appliance, replace cam.ctl.io with the appliance hostname or IP address.
Windows
Follow these steps to run a script that creates a scheduled task on a Windows Server 2012 template. When you deploy, Cloud Application Manager clones this template and installs the agent using the scheduled task.
-
Log in to the Windows Server 2012 virtual machine template using remote desktop protocol (RDP).
-
Download the scheduled task script.
- Note: If running Cloud Application Manager as an appliance, replace cam.ctl.io with the appliance hostname or IP address.
-
Right-click the script and click Run PowerShell.
Registering a vCenter provider in Cloud Application Manager
In order to deploy to a vCenter private datacenter, you must first provide information to connect. Currently, Cloud Application Manager only supports the vCenter API for vSphere.
Steps
-
In Cloud Application Manager, click Providers > New Provider.
-
Select VMware vSphere.
-
Enter the endpoint URL for the vCenter server and a username, password to the vCenter API.
- Note: The endpoint URL can be a hostname or an IP address, and has to be prefixed with https://. Be sure to use https and not http.
By default, newly created providers use the recent implementation of vSphere client, while existing providers stick to a legacy implementation. A toggle labeled Legacy Mode is introduced to migrate away from legacy mode, or to turn back to it, in case an unforseen regression would appear with the upgrade. We recommend all our customers to use the recent implementation, and to migrate away from the legacy implementation as possible.
Deploying in Your vCenter
Select deployment metadata from a deployment profile to launch VMs to your vCenter Server.
Deployment
Deployment Option | Description |
---|---|
Provider | Select a vCenter account registered in Cloud Application Manager. |
Resource
Deployment Option | Description |
---|---|
Datacenter | Select the datacenter whose objects are available for your vCenter deployment like hosts, clusters, resource pools, folders. |
Template | Select the OS template based on which you deploy the instance. Only Linux templates show for Linux boxes as do Windows templates for Windows boxes. |
Flavor | Select a template size for CPU and memory. Tiny, Small, Medium are sizes Cloud Application Manager provides. Or choose from ones you added. For example, if you choose Tiny, the instance is provisioned with 1 CPU and 1GB of RAM. By default, Cloud Application Manager provides template sizes as flavors based on compute and memory capacity. In addition to these flavors, you can add custom ones to the vCenter account in Cloud Application Manager in the Configuration tab. Under Flavors, click New and specify the CPU and memory. |
Customization | This is optional. Apply a custom specification to the instance. It usually has settings to configure the OS and network. |
Instances | Select the number of machines to provision. |
Placement
Deployment Option | Description |
---|---|
Compute Resource | Place the VM in a host, cluster, vApp, or resource pool in the datacenter. Select Any host to place in a host Cloud Application Manager picks randomly. |
Network | Select the network for the instance. |
Folder | From the folders shown, select one to place the VM. |
Proxy
Option | Description |
---|---|
Host | The hostname or domain of the proxy that the agent will use to connect back to Cloud Application Manager, once it has been installed in the deployed instance. |
Port | The port of the proxy that the agent will use to connect back to Cloud Application Manager, once it has been installed in the deployed instance. |
Disks
Deployment Option | Description |
---|---|
Disks | By default, an instance gets the template disk. For more storage, increase the template disk size and add up to seven more disks. |
Registering Instances to Your vCenter Provider
You can also register you exsiting instances to CAM portal. First click on Unregistered Instances Tab, here you can see all the exsting instances in you vCenter that you can import into your CAM portal.
Simply select one server and click on the down arrow button on the right side.
Choose a name for this instance and click on Register
Connect to server and execute the script below with admin privileges.
After running the script you should be able to see the instance has been registered successfully.
Getting General Support
Customers can contact the Lumen Global Operations Support center (support desk) directly for getting help with Cloud Application Manager as well as any other supported product that they’ve subscribed to. Below are three ways to get help.
Contact:
-
Phone: 888-638-6771
-
Email: incident@centurylink.com
-
Create Ticket in Cloud Application Manager: Directly within the platform, users can “Create Ticket” by clicking on the “?” symbol in upper right corner near the users log-in profile icon. This takes users directly to the Managed Servicers Portal where they can open, track and review status of issues that have been raised with the support desk. Additionally, this is how a TAM can be engaged as well.
Instructions:
- Provide your name
- Cloud Application Manager account name
- A brief description of your request or issue for case recording purposes
The support desk will escalate the information to the Primary TAM and transfer the call if desired.