Documente Academic
Documente Profesional
Documente Cultură
ii
Contents
Introduction .........................................................................................8
Technology ..............................................................................................................8
System Requirements...............................................................................................9
Access to Oracle Support .......................................................................................10
Concepts and Terms ...............................................................................................10
Typical Workflow ..................................................................................................11
iii
Applications .......................................................................................53
Create an Application ............................................................................................54
Publish an Application ...........................................................................................56
Auto-Stop Applications .........................................................................................58
Stop All Instance VMs ...........................................................................................58
Start All Instance VMs...........................................................................................58
Restart All Instance VMs .......................................................................................59
Edit Application Design .........................................................................................59
View Application VM Details ...............................................................................59
Summary Tab ...................................................................................................60
General Tab ......................................................................................................60
System Tab.......................................................................................................60
Disks Tab .........................................................................................................61
Network Tab ....................................................................................................61
Services Tab .....................................................................................................62
Manage Application VMs ......................................................................................63
Start a VM ........................................................................................................63
Stop a VM ........................................................................................................63
Restart a VM ....................................................................................................63
Recover a VM ..................................................................................................64
Start and Stop Application VMs in Stages ......................................................64
Open the VM Console ...........................................................................................65
Delete an Application ............................................................................................66
iv
Blueprints ...........................................................................................76
Create a Blueprint ..................................................................................................77
View a Blueprint ....................................................................................................78
Delete a Blueprint ..................................................................................................78
Share a Blueprint....................................................................................................79
Share a Blueprint with a User in Another Organization ..................................79
Share a Blueprint on Ravello Repo..................................................................80
View/Edit a Shared Blueprint ................................................................................83
vi
vii
Introduction
Oracle Ravello Cloud Service (Ravello) enables you to use leading public cloud providers to
develop and test your existing on-premises applications.
Deploy your existing VMware or KVM based data center workloads on public cloud such as
Oracle Public Cloud (OPC), Amazon Web Services (AWS), and Google Cloud Platform, as-is,
without any modification to the virtual machines, network, or storage. You can create blueprints
of multi-tier applications and spin up as many instances as you need for testing, without having
to build out massive on-premises test capacity that sits idle most of the time.
Technology
Ravellos unique Cloud Application Hypervisor technology. This technology enables an
enterprise to completely encapsulate and abstract an entire multi-VM application and its
environment so that it can run on any cloud (public or private) without modifications. Ravello
requires no changes to the VMs, the networking or the application itself.
Ravello consists of three key technology components:
Application framework
Once a copy of the application is running in the cloud, the enterprise can create a blueprint of the
application. That done, each developer and test engineer can:
Log in to Ravello and deploy a replica of the production application in any cloud for
development and testing
Connect the enterprise Continuous Integration server (e.g., Jenkins) to Ravello, so that
every time a developer checks in code the system automatically spins up a replica of the
production application in the cloud (public or private), runs tests, returns the results, and
shuts down the application.
Snapshot entire applications and share with developer and test engineer team members
Rapidly prototype new applications based on the enterprises specific VMs and
application building blocks.
Manage the entire application infrastructure as code and version it in the enterprise
standard source control.
System Requirements
The following are the system requirements for Ravello:
Operating Systems:
Guest VMs: Ubuntu 12.4, 12.10, 14.x; CentOS 6.0, 6.1, 6.2, 7.x; RHEL 5.8, 5.9,
6.0, 6.1, 6.2, 7.x; openSUSE 12.3; WIN 2003 Server R2; WIN 2008 Server R2;
WIN 2012 Server R2
KVM
Supported devices:
Disk: ide, LSI Logic SAS, LSI Logic Parallel, pvscsi, virtio
Supported clouds:
Application: Any set of virtual machines, network and storage devices and their
configuration that you want to make available to users. In Ravello, an application also
refers to an instance of an application that can be published or that is already running on
the cloud. Multiple instances (or copies) of the same application can run at the same time.
Key Pairs: When working with generic or public VM templates, you can connect to
VMs using predefined SSH key pairs. Key pairs are managed on the Library > Key Pairs
page, however you can also add or import key pairs on-the-fly while creating a new
application that is based on a public VM. Similarly, you can access key pair functionality
from the General tab of the Details pane when a public VM is selected (for applications
or blueprints).
10
Ravello Repo: A portal where Ravello users can share their blueprints, VMs, and disk
images with others.
Service: The interface on the virtual machine that exposes a service on a specific port
and provides an entry point for accessing the applications/software that are installed on
the virtual machine.
Sharing: A process whereby Ravello users can share library items (blueprints, VM
images, or disk images) with users in other organizations or on the Ravello Repo portal.
Sharing enables others to view and create copies of an item. Those copies can then be
edited to suit the needs of other organizations. If you make changes to the shared item in
your library, they are automatically reflected in the version that is visible to other users.
(If users make changes to their own copies of the item, these changes do not affect the
item in your library in any way.)
Virtual machine image: A virtual machine image represents the definition of a virtual
machine and hard disks, designed to run on a virtualization platform.
Typical Workflow
In this version, you can create and publish an application instance according to the following
suggested workflow:
11
You can also create and publish an application based on a blueprint, and view, start and restart
specific VMs in a published application.
12
13
Navigation Pane
The navigation pane enables access to each of the system modules:
Library: Lists the available VMs, blueprints, disk images, key pairs,
and elastic IP addresses.
Admin: Lists the users authorized to use the system and enables
Admin users to add users, define permissions groups and ephemeral
access, view private clouds, usage information, and logs.
The Learn link enables you to view a Quick Tour of the application and
guided flows for the most common operations.
The navigation pane also includes shortcuts to recently opened applications
and blueprints, when applicable.
Title Bar
The following links appear at the top of the application at all times:
Upgrade: Enables you to upgrade and register your account at Ravello. For details, see
Upgrade Your Account.
Ravello Repo: Displays the Ravello Repo portal, where you can share VMs and disk
images with other Ravello users.
Logged on account: Displays the name of the logged on user. Click to access the
following options:
14
Details Pane
The properties of a selected component are displayed in the Details pane on the right side of the
user interface. Depending on the component type, the properties may be displayed in a series of
tabs.
Applications Module
You can design, deploy and manage your applications from the Applications page.
The Applications page lists the applications instances created, and indicates the aggregated status
of their VMs. From this page you can create application instances and manage existing ones. For
details, see Applications.
Tip: You can filter the list in any tab by entering a partial or full string in the Filter field.
Click an application name to display its properties. The name of the application appears at the
top of the page as shown in this example:
.
15
Library Module
The Library module includes these libraries:
Blueprints: This page lists all of your Blueprints. A blueprint is a kind of application
template. You can use blueprints to create multiple application instances.
VMs: The first time you open the VMs library page, it lists only the predefined (vanilla)
set of virtual machine images provided by Ravello. If you have already installed and used
the VM Uploader Tool, this list includes any images you have uploaded into Ravello.
Disk Images: This is the central repository of reusable disk images. You can import an
ISO file or save a disk image from an existing VM.
Key Pairs: This is the central repository of reusable Key Pairs. Key Pairs are the secured
and recommended way to access a VM without the use of a password. For details, see
Key Pair Assignment.
To open a library, select Library from the navigation pane and then select the specific library.
Virtual Machines
Ravello service is provided with a set of predefined Virtual Machine (VM) images. In addition,
you can import VMs into the service using the VM Import Tool. The imported VMs are
managed on the Library > VMs page and are used to create application instances.
You can import VM images as a separate action or you can import them in the course of creating
an application instance.
16
Extract and upload VMs from vCenter or directly from your ESX server.
Upload VMs from an OVF file or pre-exported Ravello Export file from your laptop or
desktop.
Upload a single disk image (ISO, VMDK, QCOW) or create a new VM by uploading
existing disk files
From the CLI, which allows you to import your VMs offline and automate the import
process.
On the Library > Disk Images page, click Import Disk Image. If the Import Tool has not yet
been installed, the following webpage is displayed.
Select Download GUI VM Import Tool. This allows you to import VMs from within the
Ravello user interface.
On the Library > Disk Images page, click Import Disk Image. If the Import Tool has not yet
been installed, the Download VM Import Tool window is displayed.
In the Download VM Import Tool window, select Windows from the OS list.
In the popup dialog box, select Save File and click OK. The install file is downloaded.
Open the Downloads folder, and extract the zip file into a folder with the same name.
Open the Windows command prompt, then navigate to the unzipped folder.
On the Library > Disk Images page, click Import Disk Image. If the Import Tool has not yet
been installed, the Download VM Import Tool window is displayed.
In the Download VM Import Tool window, select Linux or Mac from the OS list.
In the popup dialog box, select Save File and click OK. The installation file is downloaded.
Open the Downloads folder, and extract the zip file into a folder with the same name.
Import VM Images
The first stage in preparing an application for deployment is to import your VMs.
Note: You can also import a VM on-the-fly when creating an application.
You can import VMs as described in the following sections:
Extract and Upload VMs from vCenter or vSphere directly from ESX server
Imported VMs are automatically added to the Ravello VM Library with an initial status of
Pending verification. An imported VM or disk image cant be used in an application before its
configuration is verified. See Verify Imported VMs.
Note: Before you can import VMs using the Ravello VM Import Tool, you need to install it.
Extract and Upload VMs from vCenter or vSphere
If your VM is running on a vCenter or vSphere, you can extract it directly from its location and
upload it to your Ravello account.
This process has no impact on the source VM.
Note: You must stop the VMs before extracting them.
To extract and upload VMs from vCenter or an ESX server:
1
On the Library > Disk Images page, click Import Disk Image.
When prompted, enter the password you use to log on to Ravello. The Ravello VM Import
Tool main page opens, listing the VMs already imported and their status.
19
20
21
Select Extract and upload directly from vCenter or vSphere, and click Next.
Enter the vCenter or an ESX IP address or host name, together with the necessary login
credentials, and then click Next.
Note: If you do not know the credentials, contact your System Administrator for assistance.
22
Note: The top level of the hierarchy displayed varies according to whether you connect to a
vCenter or a an ESX server.
6
On the Select a VM page, drill down to locate and select the VM to extract.
23
(Optional) If you prefer to extract the VM now but upload it later, select Export only and
click Choose folder to specify the location where you want to save the extracted VM.
Note: You can upload the VM later by selecting Upload a VM from OVF file or Ravello
Export file in the Ravello VM Import Tool.
Click Upload.
The VM is added on the VM Import Tool main page. The progress of the upload process is
indicated for each VM.
Upload a VM from a File
You can upload a VM from an OVF file or Ravello export file.
To upload a VM from a file:
1
When prompted, enter the password you use to log on to Ravello. The Ravello VM Import
Tool main page opens, listing the VMs already imported and their status.
24
Select Upload a VM from OVF file or Ravello Export file, and click Next.
25
The VM is added on the VM Import Tool main page. The progress of the upload process is
indicated for each VM.
Create a VM by Uploading Existing Disk Files
You can create a VM by uploading existing disk files in these formats: VMDK and QCOW.
To create a VM by uploading disk files:
1
On the Library > Disk Images page, click Import Disk Image.
26
When prompted, enter the password you use to log on to Ravello. The Ravello VM Import
Tool main page opens, listing the VMs already imported and their status.
27
Select Create a new VM by uploading existing data files, and click Next.
(Optional) Filter the list of available files by entering search criteria in the Filter field.
to move it to the Selected Files list. Repeat for
Click Upload.
The VM is added on the VM Import Tool main page. The progress of the upload process is
indicated for each VM.
28
On the Library > Disk Images page, click Import Disk Image.
When prompted, enter the password you use to log on to Ravello. The Ravello VM Import
Tool main page opens, listing the VMs already imported and their status.
29
From the Type dropdown list, select the type of file (OVF or Ravello Export File).
(Optional) Filter the list of available files by entering search criteria in the Filter field.
In the Browse for VM template file dialog box, select the virtual image machine data file
(.vmx), and then click OK.
Description
Name
Description
Description
# CPUs
Mem Size
Platform
30
11 If MAC address information is not included in the VMX file, enter it manually in the
Networks tab (it should match the MAC address of your NIC).
Define the NIC name, its MAC address, and device type.
(Optional) If it is the first NIC defined for the VM and you want to enable inbound
access, click Add external service. For details on configuring an elastic IP
address, see Configure Elastic IP Addressing.
(Optional) Click the Advanced link to configure additional IP addresses and the
network connection mode (Access or Trunk).
13 (Optional) Define the supported and required service interfaces in the Services tab. The
service interfaces indicate how the VM is used, and which IP addresses and ports it exposes.
You can also define external services, meaning that they can be accessed from outside your
network.
To add a supplied interface, click + Add New in the Supplied Services area. A
blank entry is added to the Supplied Services list. Configure the service properties
as required.
31
Note: Although it is recommended that you define the service interfaces prior to completing
the upload process, you can add or edit the service interfaces in the instance design as well.
14 (Optional) If the VM configuration management properties were not preconfigured, and Chef
configuration management is enabled for the VM, you can configure the Chef settings in the
General tab. For details, see Configuration Management.
15 Click Upload. The import process starts and a progress bar indicates its status. The image is
added to the list of images in the Library page. When the upload process is complete, the
image status changes to Done.
While the import process is in progress, you can only delete the VM being imported.
Import VMs using the CLI
If you have installed the CLI VM Uploader, you can use the CLI to upload VMs into Ravello.
To upload VMs using the CLI:
1
In the CLI, type ravello upload -- disk_file= <path to the VM image> -u user@ravello.com
--name<name of the VM>
When the summary appears, verify the information that it contains, and type Yes. The upload
is initialized.
On the Library >VMs page, select the VM image. The VM properties are displayed in a
series of tabs in the Details pane.
Review the VM properties in each of the tabs and click Save. The status of the VM in the
Library changes from Pending verification to Ready.
32
Select the VM image in the Library page. The VM properties are displayed in a series of
tabs in the Details pane.
Edit VM Images
You can edit the general properties of an image, for example, when less memory or computing
power is required for testing purposes.
To edit a virtual machine image:
1
On the Library > VMs page, select the image you want to edit. The VM properties are
displayed in a series of tabs in the details pane.
33
Select an existing IP address or click Create Elastic IP Address to add an IP address to the
repository.
34
Make sure that the most updated GUI import tool is installed on your machine.
Note: To download the tool, click Download VM Import Tool on the Library page.
By default, this page lists all of your disk images (i.e., My Images list).
3
Click Import Disk Image. If needed, allow the loading of insecure content by your browser.
In the Browse for VM Template File dialog box, browse to and select the ISO file.
35
Make sure that the most updated CLI import tool is installed on your machine.
Note: To download the tool, click Download VM Import Tool on the Library page.
36
On the application canvas, drag the VM onto the workspace (or use any unpublished VM).
Click Add, then select Add CD-ROM. A blank entry is added to the Disks list.
37
On the Library > VMs page, select the image you want to delete, then click Delete.
Save VM to Library
You can save a VM that is included in your application design to the library for future use. The
saved VM is based on a snapshot and will have the same properties as the currently selected VM.
38
In the Application design workspace, select the VM and click More > Save to Library.
If the VM is running, the following Save to Library dialog box is displayed.
Enter a name for the VM and click OK. The VM is added to the library.
39
Configuration Management
The Chef Server configuration tool can help you to more efficiently configure your VMs.
Note: Chef configuration management can only be applied to vanilla VMs that support cloudinit,
Chef settings in the VM are automatically retained by any blueprint created from it, and by any
applications created from those blueprints.
To enable Chef configuration management:
1
On the Application page, on the Canvas tab or VMs tab, select the VM and click Application
Configuration.
From the Chef Server dropdown list, select the server or click
Click Save.
On the Application page, on the Canvas tab or VMs tab to display the VM properties in the
details pane.
In the Run List field, enter the roles and recipes to run when the VM starts the
40
In the User Data Script field, enter the script to run during the Cloud Init process when
the VM starts.
The Node Name is automatically assigned when the VM is published. The name is in the
format <applicationname>.<vmname>, where any special characters in the source names are
replaced by hyphens (-).
Share a VM
Sharing a VM enables others to view and create copies of the VM, which can then be edited to
suit the needs of other organizations. If you make changes to the shared VM in your library, they
are automatically reflected in the version that is visible to other users. (If users make changes to
their own copies of the item, these changes do not affect the VM in your library in any way.)
You can share VMs with users in other organizations or on the Ravello Repo portal.
Note: Sharing permissions must be defined in the users permissions group. If you are not
authorized to share VMs, contact your system administrator.
Important: Make sure that the VM does not contain any confidential or proprietary information
before sharing it.
Share a VM with a User in Another Organization
You can share a VM with a user from another organization only.
Note: To allow a user from your own organization to view and use a library item, they must be
assigned to permissions groups where the viewing of shared items is enabled. Contact your
Ravello administrator for additional details.
Important: Make sure that the VM does not contain any confidential or proprietary information
before sharing it.
To share a VM with a specific user:
1
In the Library > VMs page, select the VM you want to share, then do one of the following:
Click Share > Manage sharing, and click Another Organization in the Manage VM
Sharing dialog box.
41
In the Share with Users field, enter the email address of the user with whom you want to
share your VM.
If you have not already done so, read the Terms of Service and Additional Terms of Service,
then select I accept.
Click Share.
42
In the Library > VMs page, select the VM you want to share, then do one of the following:
Click Share > Manage sharing, and click Ravello Repo in the Manage VM Sharing
dialog box.
In the Step 1: Short description field, enter a brief description of the VM (maximum 160
characters).This description will appear on the front page of Ravello Repo. Then click Next.
43
44
If you have not already done so, read the Terms of Service and Additional Terms of Service,
then select I accept.
View/Edit a Shared VM
You can view any VM that has been shared with you and make a copy for your own use. You
can then modify the VM to meet the specific needs of your organization.
To view/edit a shared VM:
1
In the Library > VMs page, click Shared with me to view a list of the VMs shared with you.
(This list remains empty until a VM has been shared with you.)
45
To make an editable copy for your own use, click Actions > Copy to My VMs.
Enter a new name for the VM and click Copy. The VM is added to your My VMs list.
46
In the Library > Disk Images page, select the Disk Image you want to share, then do one of
the following:
Click Share > Manage sharing, and click Another Organization in the Manage
Disk Image Sharing dialog box.
47
(Optional) Click Review/edit disk image documentation to update the description of the
disk image that will be visible to others.
In the Share with Users field, enter the email address of the user with whom you want to
share your disk image.
If you have not already done so, read the Terms of Service and Additional Terms of Service,
then select I accept.
Click Share.
In the Library > Disk Images page, select the disk image you want to share, then do one of
the following:
48
Click Share > Manage sharing, and click Ravello Repo in the Manage Disk Image
Sharing dialog box.
In the Step 1: Short description field, enter a brief description of the disk image (maximum
160 characters).This description will appear on the front page of Ravello Repo. Then click
Next.
49
Click Review/edit Disk Image Documentation to update the documentation section of the
disk image and provide useful information to the other Ravello users. The documentation
provided is important to improving the usability of shared items. After updating the
documentation, click Next.
Note: The documentation section is written in a markdown editor.
If there is no documentation attached to the disk image when you click Next, you are
prompted to add it now.
If you do not wish to do so, click Continue Anyway.
50
Verify that the disk image does not contain any confidential or proprietary information
before sharing it, then click Share. The disk image is shared on the Ravello Repo portal.
In the Library > Disk Images page, click Shared with me to view a list of the disk images
shared with you. (This list remains empty until a disk image has been shared with you.)
51
To make an editable copy for your own use, click Actions > Copy to My Disk Images.
Enter a new name for the disk image and click Copy. The disk image is added to your My
Disk Images list.
52
Applications
Applications are managed from Applications page.
The Applications page lists the application instances created in Ravello and running on the
cloud, together with the status of their virtual machines.
Description
Status
Name
Creation Date
Owner
Cloud
53
Parameter
Description
Auto-stop in
You can view additional details on a specific instance, including the status of each VM, by
selecting it in the list. For more information, see View Application VM Details.
From the Applications page, you can:
Create an Application
Create an Application
You can create a new application instance from scratch or based on an existing blueprint.
To create an application from scratch:
1
On the Applications page, click Create Application or in the Blueprint design workspace,
click Create Application. The Create Application dialog box is displayed.
Select From blueprint, then select the base blueprint from the dropdown list (If you selected
Create Application from the blueprint design workspace, the blueprint is selected for you by
default.)
If you are creating an application based on a public VM, select an existing key pair from the
Key Pair dropdown list or click
to add a new key pair. For details on generating and
importing key pairs, see Key Pair Assignment.
In the Publish application section, select Publish later if you do not want to publish the
instance now or select Auto-publish upon creation.
Click OK. The application instance canvas opens in a new tab automatically.
55
Publish an Application
When you are satisfied with the application design, you are ready to publish it.
Ravello enables you choose a publishing option based on cost optimization or performance
optimization. You can view the specific pricing based on your selections prior to publishing the
application.
Publishing the application instance moves the application to the cloud.
56
To publish an application:
1
In the Application design tab, click Publish. The Publish Application dialog box is
displayed.
In the Optimize for area, select Cost or Performance. (The option label appears in orange
when selected.)
If you select Cost, then Ravello selects the cloud and region for you. If you select
Performance, then you have to select the region that is closest to you.
In the Set Application Auto-Stop area, configure how long the application runs before it is
automatically stopped or select Never to let it run indefinitely. (The default setting is 2
hours.)
(Optional) Click Detailed Pricing to view the publishing cost for the selected type of
optimization, cloud provider, and region.
57
Click Publish. When the publish process is complete, the application instance is started.
Note: The publish process might take a few minutes.
Auto-Stop Applications
The auto-stop feature enables you to configure long the application is run before it is
automatically stopped. This eliminates the need to manually stop those applications that you
know are required for a limited time.
The auto-stop feature is configured as part of the publishing process.
The balance of time remaining until the application is automatically stopped appears in the Auto
Stop in column on the Applications page.
On the Applications page, select the instance you want to stop, then click Stop.
On the Applications page, select the instance you want to start, then click Start.
On the Applications page, select the instance you want to start, then click Restart.
On the Applications page, click the application instance name. The Canvas tab is displayed.
Edit the application instance design as required. (For details, see Design Canvas).
Click Publish to publish the application for the first time or click Update to apply the
changes to a published application, as applicable.
Note: The update changes process does not republish the entire instance, only the relevant
changes. In some cases, a published machine will be rebooted as part of the process.
Description
General Properties
Name
Description
Created
Hostnames
Key Pair
The key pair assigned to the VM. Key pair assignment is applicable for
VMs created based on generic of public VM templates.
Configuration Management
Cloud Init is installed on
this VM
Application Configuration
User Data Script
System Tab
When a VM is selected on the Application page, the following details are displayed on the
System tab.
Option
Description
System Properties
# CPUs
60
Option
Description
Mem Size
Platform
Disks Tab
When a VM is selected on the Application page, the following details are displayed on the Disks
tab.
Option
Description
Disk
Disk Size
Controller
Boot
The boot status. If you do not want to book from the disk, select Skip
CD boot.
CD
Image
Controller
Network Tab
When a VM is selected on the Application page, the following details are displayed on the
Network tab.
Option
Description
Name
MAC
Auto MAC
Device Type
61
Option
Description
IP Configuration
Reserved IP
External Access
Inbound
Outbound
Enables the virtual machine to access external resource through the NIC.
Advanced
Mode
VLAN Tag
Additional IP Addresses
Static IP address
Netmask
Gateway
Services Tab
The service interfaces indicate how the VM is used, and which IP addresses and ports it exposes.
When a VM is selected on the Application page, the following details are displayed on the
Services tab.
Option
Description
Supplied Services
Name
Connection type
Protocol
Port
Advanced >
Enable SNAT
Enables source NAT, which replaces the source IP address with a local
IP address.
Required Services
Name
62
Option
Description
Connection type
In the VMs tab, select the VM you want to start and click Start. Alternatively, in the
published instance design, select the virtual machine object and click Start VM.
Stop a VM
You can temporarily stop a VM.
To stop a VM:
1
In the VMs tab, select the VM you want to stop and click Stop. Alternatively, in the
published instance design, select the virtual machine object and click Stop.
Restart a VM
You can restart only a VM that has Started as its status.
To restart a VM:
1
In the VMs tab, select the VM you want to restart and click Restart. Alternatively, in the
published instance design, select the virtual machine object and click Restart.
63
Recover a VM
Recovering a VM can be useful when unknown issues occur, for example, problems with cloud
providers (such as a machine that is inexplicably terminated).
To recover a VM:
1
In the VMs tab or in the published instance design, select the VM you want to recover and
click More > Recover. The VM Recovery dialog box is displayed.
Republish: The VM will revert to the most recent snapshot. All content on the VM will
be replaced. You must select I understand the risk in order to enable this option.
In the Settings tab, under Start/Stop Stages, click See Full List.
The Settings > Startup and Shutdown Stages page is displayed.
An unstaged VM is a VM that has not been assigned to a stage. The number of unstaged
VMs is listed together with the number of stages defined for the application.
2
To create a stage:
In the New Stage dialog box, enter the name of the stage and specify the number of
minutes to wait after starting this stage before starting VMs in the next stage.
Click Create.
64
The stages are listed in the table. The following example shows that two stages have been
defined for this application, with a 10 minute delay configured between the first stage and the
next stage. No VMs have been assigned to either stage. The application has three unstaged
VMs.
To assign a VM to a stage:
Click Unstaged VMs Pool to view the list of VMs not yet assigned to a stage.
Select the VM, then select the stage you want to assign it to from the Move to >
dropdown menu.
Repeat for additional VMs as required. (Each VM can be assigned to only one stage.)
In the Shutdown area (at the bottom of the page), select one of these options to define the
shutdown order:
Reverse Startup Order, the first stage started is the last stage shut down.
Click Save.
In the VMs tab or in the published instance design, select the VM you want to connect to
and click Console to open the console.
65
Delete an Application
You can permanently delete an application that is no longer required.
To delete an application:
1
On the Applications page, select the application you want to delete, then click Delete.
Design Canvas
The Ravello Canvas enables you to create and edit your application instance designs.
When you open an application or blueprint, a Canvas tab is added to the Application page. The
name of the page reflects the name of the application instance or blueprint currently displayed,
for example, Application: MyApp23.
Description
Opens a menu of available VMs. You can select from the list or import a
VM to include in your application.
Save as Blueprint
Publish/ Update
Auto stop in
Published in
Application status
66
Option
Description
Cloud errors
The toolbar at the bottom of the Canvas tab includes the following options:
Option
Description
Save status
Indicates whether the current design has been saved or is in the process of
saving.
Zoom In
Zoom Out
Select
Pan
1:1
Cancels any zooming and returns the view to its default size.
Fit
VM Library
The VM Library (Library > VMs) lists all of the virtual machine images that have been loaded
into the service and are available to include in your design.
If the image you require does not appear in the list, you can click Import VM to add it to the
library, making it available for use.
Design Objects
The key design objects that can be included in your application instance design are virtual
machine image objects, service interface objects, connections, and groups.
67
Description
A virtual machine draft (not yet published).
A published virtual machine that is in the process of being started, restarted or stopped.
68
(Optional) Change the name of the group object in the Group Properties in the details pane.
Tip: You can drag and drop the object to any location on the workspace.
In the design tab, drag an image name from the VM Library onto the workspace. If you
want it to be part of a group, drag it directly onto the group object (the group object
outline turns blue when selected).
Tip: When you select a virtual machine image on the workspace, its details appear in the
details pane, where you can edit the image properties for this design only. The source image
in the library is not modified.
Add and Connect Service Interfaces
You can manually add supplied and required service interfaces to the virtual machines images in
your design to provide entry points for accessing the application functionality.
If you know that all of the design objects are part of a network that communicates using DHCP
or are on the same subnet with automatic IP address assignment, you do not need to manually
create the connection; Ravello creates the network for you.
To configure the service interfaces:
1
Select the VM instance on the canvas or on the VMs tab, then select the Services tab in the
VM details pane.
69
To add a supplied interface, click + Add in the Supplied Services area. A new entry open
in the Supplied Services list. Configure the service properties as required.
To add a required interface, click + Add in the Required Services area. A new entry
opens in the Required Services list. Configure the service properties as required.
button.
Select the VM instance on the canvas or on the VMs tab, then select the Services tab in the
VM details pane.
70
Stop: Stops the selected VM. For details, see Stop a VM.
Start: Starts the selected VM. For details, see Start a VM.
Restart: Restarts the selected VM. For details, see Restart a VM.
More:
Recover: Recovers the selected VM. For details, see Recover a VM.
SSH: Uses SSH to connect to the VM. For details, see Using SSH key pairs to connect
to VMs.
71
Manage IP Filters
Configure SNAT
Manage IP Filters
You can define and enable an IP filter that allows traffic from authorized source IP addresses
only.
Alternatively, you can disable the IP filter and allow traffic from all IP addresses.
To enable the IP filter:
In the Network tab of your application design or blueprint, click the IP Filtering
icon. The IP Filter Properties are displayed in the details pane.
72
Enter the IP address and subnet mask in the designated fields. (These parameters are
mandatory).
Click Save.
button.
icon.
73
icon.
icon.
Configure SNAT
Source NAT (SNAT, patent pending) replaces the source IP address with a local IP address,
allowing the user to access a specific port that is open only for the same subnet.
SNAT is typically used when an application with VMs has several subnets and a VM doesnt
have access to the internet, but you need to access it for management purposes via RDP or SSH.
To configure SNAT:
1
In the Details pane, on the Network tab, locate the NIC to which the service will be
connected.
Enter the Gateway address. (This should be a fake IP address in the same range as the main
address. Make sure that the gateway address is not in use.)
Use of a public IP address is recommended. If you choose port forwarding, use the forwarded
port number (usually port 10,000).
Click Save.
Note: Because SNAT opens a back door to the VM, it is highly recommended to use the VM
firewall (Windows or Linux).
SNAT replaces the source IP address with the Ravello router IP address, thereby allowing
you to connect to a port that is closed for access from an address outside its subnet.
75
Blueprints
A blueprint is a self-contained set of definitions that describe your application, and can be used
to create instances and deploy them on the cloud. A blueprint is created from an application
design.
A blueprint comprises a snapshot of an application instance design, including virtual machine
images and their disks, and the service interfaces that enable access to the application
functionality. This snapshot reflects the configuration and states of the virtual machines and their
disks when the blueprint was created.
You can publish multiple application instances based on the same blueprint. For example, QA
testers use blueprints to create application instances for testing purposes.
Blueprints cannot be edited. Blueprints are managed in the Blueprints library.
To view the Blueprints list, select Library > Blueprints from the navigation pane.
By default, this page lists all of your blueprints (i.e., My blueprints list).
76
An icon appears in the first column indicating whether the blueprint is public (
) or private (
).
If you have shared a blueprint, it is indicated in the share status (
) column.
To view the blueprints that have been shared with you, click Shared with me.
Create a Blueprint
Blueprints are created from application instance designs, either draft designs or designs with all
VMs running.
To create a blueprint:
1
On the Applications page, open the instance based on which you want to create blueprint.
(Optional) On the Canvas tab for that instance, edit the design as required. (For details, see
Design Canvas)
77
To take a snapshot without shutting down the VM, select No Shutdown: Take a
snapshot now, ....
To shut down the VM before taking the snapshot, select Shutdown first. The VM
will be restarted after the snapshot.
Enter a name for the blueprint and click OK. The blueprint is added to the library.
Note: The blueprint capture process might take a few minutes.
View a Blueprint
To view a blueprint:
On the Library > Blueprints page, click the blueprint name. The blueprint is displayed on
the Canvas tab in read-only format.
Delete a Blueprint
You can delete blueprints that are no longer needed.
To delete a blueprint:
78
On the Library > Blueprints page, select the blueprint you want to delete, then click Delete.
Share a Blueprint
Sharing a blueprint enables others to view and create copies of the blueprint, which can then be
edited to suit the needs of other organizations. If you make changes to the shared blueprint in
your library, they are automatically reflected in the version that is visible to other users. (If users
make changes to their own copies of the item, these changes do not affect the blueprint in your
library in any way.)
You can share blueprints with users in other organizations or on the Ravello Repo portal.
Note: Sharing permissions must be defined in the users permissions group. If you are not
authorized to share blueprints, contact your system administrator.
Share a Blueprint with a User in Another Organization
You can share a blueprint with a user from another organization only.
Note: To allow a user from your own organization to view and use a library item, they must be
assigned to permissions groups where the viewing of shared items is enabled. Contact your
Ravello administrator for additional details.
Important: Make sure that the blueprint does not contain any confidential or proprietary
information before sharing it.
To share a blueprint with a specific user:
1
In the Library > Blueprints page, select the blueprint you want to share, then do one of the
following:
Click Share > Manage sharing, and click Another Organization in the Manage
Blueprint Sharing dialog box.
79
In the Share with Users field, enter the email address of the user with whom you want to
share your blueprint.
If you have not already done so, read the Terms of Service and Additional Terms of Service,
then select I accept.
Click Share.
In the Library > Blueprints page, select the blueprint you want to share, then do one of the
following:
Click Share > Manage sharing, and click Ravello Repo in the Manage Blueprint
Sharing dialog box.
In the Step 1: Short description field, enter a brief description of the blueprint (maximum
160 characters).This description will appear on the front page of Ravello Repo. Then click
Next.
81
If you have not already done so, read the Terms of Service and Additional Terms of Service,
then select I accept.
Click Share. The blueprint is shared with on the Ravello Repo portal.
82
In the Library > Blueprints page, click Shared with me to view a list of the blueprints shared
with you. (This list remains empty until a blueprint has been shared with you.)
To make an editable copy for your own use, click Copy to My Blueprints.
83
Enter a new name for the blueprint and click Copy. The blueprint is added to your My
blueprints list.
Additional Functionality
Key Pair Assignment
When working with generic or public VM templates, you can connect to VMs using predefined
SSH key pairs. Ravello enables you to choose between importing or automatically generating
key pairs.
Whether imported or automatically generated, the public key is stored in Ravello, whereas the
private key is stored on the client.
Key pairs are managed on the Library > Key Pairs page, however you can also add or import key
pairs on-the-fly while creating a new application that is based on a public blueprint. Similarly,
you can access key pair functionality from the General tab of the Details pane when a public VM
is selected on the canvas (for applications or blueprints).
Note: The key pairs generated by Ravello are compatible with Linux and Mac platforms only.
Windows not does have a native Windows SSH client. To use these key pairs with Windows, it
is necessary to convert the private key from the standard OpenSSH format to PuTTy's
proprietary format using the PuTTygen tool.
Generate a Key Pair
If you are using one of the images or blueprints supplied by Ravello (public images and public
blueprints), you need to create or import a key pair in order to SSH into the VM.
When you generate a key pair using Ravello, the private key is downloaded as a file. The private
key is not saved by Ravello. The public key is saved by Ravello and used when the VM is
started.
84
On the Library > Key Pairs page, click Create Key Pair. The Key Pairs dialog box is
displayed.
Click Create. The key pair is added to the Key Pairs list and a link to the downloaded private
key appears near the bottom of your screen.
85
On the Library > Key Pairs page, click Create Key Pair. The Key Pairs dialog box is
displayed.
Select Import a Public Key. The dialog box expands to include an additional text box.
In the Public Key box, enter (or copy-paste) the public key of an existing public key.
Click Create. The imported key pair is listed in the Key Pairs list.
86
Locate your private key file (for example, ravelloDevKey.pem). The wizard automatically
detects the key you used to launch the instance.
To verify that the key permissions of the private key correct, run this command:
chmod 400 ravelloDevKey.pem
Browse to and select the *pem file that contains the key you want to convert, and click
Open.
Note: By default, PuTTYgen displays only files with extension .ppk. Select All Files from
the dropdown list to view all file types.
When the PuTTYgen notice appears advising you to select the Save Private Key command to
save it in PuTTys proprietary format, click OK .
When prompted to indicate whether you want to save the key without a passphrase, click
Yes. The key is saved in .ppk format and can be used to connect to your VM using PuTTy
SSH.
Verify that you have created an external supplied service on the VM, with port 22 open. For
details, see "How to add and connect a service" and "How to edit service properties".
From the Windows Start menu, select All Programs > PuTTY > PuTTY
In the Host Name field, enter the host name or IP address in the following format:
ravello@<hostname>
88
Click Browse to locate and select the PuTTY private key file you generated using
PuTTyGen.
Click Open.
Note: If a security alert is displayed asking if you trust the host you are connecting to, click
Yes.
In the SSH session window, log in with the required username (if requested). No password is
required because the selected public/private key pair is used for authentication.
89
After saving the file in the specified location, restart the Ravello Import tool service from
Administrative Tools > Services.
If the proxy uses basic authentication, then you need to add the user and password to the
same configuration file:
[upload]
proxy_address = <ip address of proxy server>
proxy_port = <port on which the proxy server accepts connections>
proxy_username = < proxy user >
proxy_password = <proxy password >
Share a VM
Share a Blueprint
Ephemeral Access
Ephemeral access allows you to provide limited, time-based access to a specific resource or set of
resources to another person, without them being a part of your organization. This option can be
advantageous when integrating your own portal on Ravello infrastructure or when you want to provide
90
an external user with temporary access. For example, you can use these tokens to grant your partners
limited access to a specific demo environment, without creating a user in your environment.
This article describes these aspects of working with Ephemeral Access Tokens
Managing Tokens
Note: You must have the appropriate permissions assigned to you in order to create and view
ephemeral tokens.
91
b. Select the permissions to grant and the time limit for access.
3. If you selected more than one resource, selected the preferred creation method (Different
token for every application or All applications in a single token).
4. Click Create. The dialog box is refreshed to display the Ravello UI URL and the API token details.
Managing Tokens
You can view a list of all tokens on the Admin > Ephemeral Access Tokens page. Alternatively, you can
create and edit tokens from the Applications and Blueprints modules.
To view the details for a specific token:
On the Applications page or Blueprints page, select the resource and click More > Show Ephemeral
Tokens.
92
93
Admin Module
The Admin module includes the following pages:
Users: Lists the users who are authorized to use Ravello, and enables an administrator to
invite new users and reset the passwords and permissions of other users. For details, see
User Management.
Permissions Groups: Lists the permissions groups for your organization, and enables
authorized users to view/edit permissions and assign users to permissions groups. For
details, see Permissions Group Management.
Ephemeral Access Tokens: Lists the ephemeral access tokens defined in the system. For
details, see Ephemeral Access.
Billing: Lists billing information for your organization by category and by month.
Usage: Displays the status of available resources. For details, see Monitor Resource
Usage.
Log: Displays the messages logged by the system. For details, see View the System Log.
User: The default Ravello user has read only permissions for all resource types.
Because the Ravello console might be used by different individuals in the enterprise for different
purposes, Ravello enables the creation of customized permissions groups.
When a custom permissions group is created, it does not contain any permissions. The specific
permissions must be added manually by the administrator. Different levels of permissions can be
added for each resource type in keeping with the needs of your organization and the functionality
required by different types of users. For example, you might want to grant finance department
94
personnel access pricing information and edit payment method details, without granting them
permissions to manage applications, VMs, and blueprints.
If a user is assigned to more than one permissions group, that user inherits the combined
permissions of both groups. For example, if one group assigns Read permissions for applications
and another allows Read and Create permissions for application, a user that is assigned to both
permissions groups can Read and Create applications.
On the Admin > Permissions Groups page, click Create Permissions Group.
In the Create Permissions Group dialog box, enter a name and short description for the
group, then click Create. The Permissions page is displayed.
95
From the Resource Type dropdown list, select the resource for which want to add
permissions.
In the Actions section, select the checkboxes for the permission levels required for the users
to be assigned to this permissions group.
(Optional) In the Filter area, configure additional criteria for applying permissions to specific
resources:
From the Filter dropdown list, select the condition for the filter (OR, AND, or
Custom Filter).
Click Create Criterion, then select the object to be matched, the condition for a
match (Equals or Not Equals), and the partial or full string to be matched. Repeat this
step for additional criteria, as required.
96
Note: If a filter is not defined, the permission will apply to all the objects of the resource
type.
7
Click Save. A resource type is added to the Permissions page for this group.
Repeat steps 48 for additional resource types until all of the necessary permissions have
been set.
On the Admin > Permissions Groups page, click the name of the permissions group. The
Permissions page is displayed.
Note: The number of users assigned to the permissions group appears in the lower left
corner. To view the users in this group, click Users.
2
To set permissions for an additional resource type, click Create Permission. Configure the
permissions as described in Define Permissions Groups.
97
To delete the existing permissions for a resource type, click the corresponding Trash Can
icon.
On the Admin > Permissions Groups page, select the permissions group, the click Delete.
When prompted for confirmation, click Yes. The permissions group is deleted.
User Management
Depending on your permissions, various user management functions may be available from the
Admin module.
Users are managed from the Admin > Users page.
Invite Users
If you have admin permissions, you can invite additional persons to use Ravello.
To invite a user:
1
Enter the users name and email address, then click Invite. An invitation is sent to the user.
permissions for application, a user that is assigned to both permissions groups can Read and
Create applications.
Note: If you need to prevent a user from performing a specific action, make sure that the user is
not assigned to any permissions group that allows that action.
To add a user to a permissions group:
1
On the Admin > Users page, select the user, then click Add to Permissions Group.
In the Permissions Group dialog box, select the relevant permissions group and click Select.
Click Save.
Change Password
You can change the password you use to access Ravello.
To change your password:
1
On the title bar, click your username and select Change Password.
Enter your old password and a new password in the designated fields, and click OK. Your
password is updated accordingly.
Note: If you have admin permissions, you can select another user on the Admin > Users page
and reset their password for them.
Disable a User
If you have Admin permissions, you can disable other users.
To disable a user:
99
On the Admin > Users page, select the user then click d Disable.
The Admin > Usage & Quota page provides the following details:
Concurrent Running VMs: The number of Running VMs as a portion of the maximum
number of VMs that you are allowed to run simultaneously. When the number of VMs
reaches the maximum value, you cannot start new VMs without first stopping some of
the running VMs.
Public IPs: The number of Public IP addresses as a portion of the maximum number that
you are allowed to run simultaneously.
Elastic IPs: The number of Elastic IP addresses as a portion of the maximum number
that you are allowed to run simultaneously.
An orange progress bar indicates that the available resources are almost entirely utilized. When
additional resources are no longer available, the progress bar turns red.
100
Note: The CPU resources available during the two-week free trial period are limited and cannot
be increased. To change your account status, click Upgrade at the top of the Ravello
Management Console.
Click your username at the top of the Ravello interface and select My Profile from the
dropdown list.
To enable others to view your profile, select Show my profile in Ravello Repo.
In the Public name field, enter the username to be displayed in Ravello Repo. (This
username does not have to be the same as your Ravello username.)
(Optional) Add a brief description of your role or other pertinent information about you or
your account.
(Optional) To enable others to contact you via the email associated with your Ravello
account, select Allow people to contact me via email.
(Optional) Select Show my social networks to Include social media accounts information.
Click the edit icon to configure the account information accordingly.
Click Save.
101
Tip: To preview your profile as it will appear in Ravello Repo, click View in Ravello Repo.
102
IO Overlay/software-defined network
Application framework
Guest VMs: Ubunto 10.2, 12.4, 12.10; CentOS 6.0, 6.1, 6.2; RHEL 5.8, 5.9, 6.0, 6.1, 6.2;
openSUSE 12.3; WIN 2003 Server R2; WIN 2008 Server R2; WIN 2012 Server R2
For complete details, including CPU and cloud provider info, refer to the Support Matrix table.
What VM formats does Ravello support?
Ravello supports the following virtualization versions:
Terminology
What is an application?
An application is any set of virtual machines, network and storage devices and their
configuration that you want to make available to users. In Ravello, an application also refers to
an instance of an application that can be published or that is already running on the cloud.
Multiple instances (or copies) of the same application can run at the same time.
What is an application design?
An application design is a set of definitions that describe an application, including virtual
machine images, supplied and required service interfaces, and connectivity, as applicable.
104
What is a service?
Services provide entry points for accessing the application functionality on the VM. A supplied
service opens a port on the VM, and a required service enables the connection to the VM.
Multiple required interfaces can be connected to a single supplied service.
You can manually add supplied and required service interfaces to the virtual machines images in
Ravello. You can also edit the properties of both supplied and required services, including the
service name, hostname, protocol, ports, and more.
What is a blueprint?
A blueprint is a self-contained set of definitions that describe your application, and which can be
used to create applications and deploy them on the cloud. A blueprint comprises a snapshot of an
application instance and is created from an application design. The same blueprint can be used
multiple times, however it cannot be edited.
What is publishing?
Publishing is the process of deploying the application in a cloud environment. Publishing the
application instance creates multiple virtual machines in the cloud and defines the network
overlay, or if changes are made to the instance design, implements those changes on a running
instance.
Alternatively, if your browser displays a security shield, click the Shield and then click the Load
Anyway button.
If the problem persists, contact our support team.
Can I use CLI to upload VMs?
The VM Import Tool can be used in two ways:
From the CLI, which allows you to upload your VMs offline and automate the upload
process.
For details on installing the necessary CLI, see How to install the CLI VM Import Utility on
Windows platforms or How to install the CLI VM Import Utility on Linux/Mac platforms.
What is the user for public images?
The user for public images in Ravello systems is "ravello".
How do I change the IP address of my VM?
1
In the application design, select the VM. Its properties are displayed in the Details pane
If the VM is already published, the VM network should be restarted in order the changes to
take effect.
106
Key pair format: If you are trying to connect to the VM with a Windows platform, you
need to use PuTTy to connect and the keys need to be in PPK format. Key pairs
generated by Ravello are in PEM format, but they are easily converted to PPK format
using the PuTTyGen tool. For details, see Using SSH key apirs to connect to VMs with
Windows.
107
icon.
Running VMs: The number of Running VMs as a portion of the maximum number of
VMs that you are allowed to run simultaneously. When the number of VMs reaches the
maximum value, you cannot start new VMs without first stopping some of the running
VMs.
An orange progress bar indicates that the available resources are almost entirely utilized. When
additional resources are no longer available, the progress bar turns red.
108
Open the Virtual Infrastructure client and connect to the vCenter or ESX host in which the
VM is running.
Select the intended VM from the inventory, shut it down if it is running, and then select File
> Export > Export OVF Template.
This process might take some time, depending on the size of the disks and other parameters. At
the end of the export process, an OVF file and 1 or more VMDK files should appear in your
target directory.
109
In the Details pane, create a supplied service in the Services tab as follows:
Click Add.
Select RDP from the Protocols dropdown list. If you need RDP to be exposed on a
single IP only, select the IP address from the Listen on dropdown list; otherwise, leave
the default setting All IPs.
Click Save.
If your application has already been published, click Update to push your changes to the
cloud.
110