5 Managing Ravello Applications

Manage your Ravello applications, library items, and learn how to use your ISO file.

Topics

• Managing Ravello Applications

• Sharing Library Items With an External User

• Uploading and Using an ISO Image

Managing Ravello Applications

The Applications page lists the applications instances that are created in Ravello, and indicates the aggregated status of their VMs. You can view additional details on a specific instance, including the status of each VM, by selecting it in the list.

Here are some of the main features of Ravello applications.

Recovering a VM

Recovering a VM can be useful when unknown issues occur. For example, you may have 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.

2. Select one of the following options:

   • Repair — Repairs and restarts the VM with its current settings.

   • Republish — The VM will revert to its original state in this application and any changes made to it will be lost. All content on the VM will be replaced. You must select I understand the risk in order to enable this option.

Starting and Stopping Application Instances in Stages

In an application with multiple VMs, you can configure the VMs to start and stop in stages rather than all at once. Each stage can include multiple VMs. To start and stop VMs in stages:

1. In the Applications page, go to Settings tab and click See Full List, which is under Start/Stop stages.

   Note:

   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, click +Create 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. Repeat to create additional stages.

3. 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 > drop-down list. Repeat for additional VMs as required. Note that each VM can be assigned to only one stage.

4. At the bottom of the page, in the Shutdown area, select one of these options to define the shutdown order:

   • All at Once, regardless of stages.

   • Reverse Startup Order, the first stage that was started will be the last one to shut down.

Stopping All Instances

You can temporarily stop an application instance if it is not required. Stopping an instance does not remove its configuration; the instance retains all of its settings. You can stop all instances at once by selecting the instances and clicking Stop. If you are not using the application instance again, then delete it.

Viewing VM Properties

When you click an application instance name on the Applications page, its Canvas tab is displayed by default. To view information on its virtual machines in a table, select the VMs tab. The VMs included in the application instance are listed. Select a VM to view its properties in the Details pane (on the right side of the screen). The VM properties are contained in these tabs in the Details pane.

• Summary tab — When a VM is selected on the Application page, the Summary tab indicates the name of the VM, its CPU, memory, total storage space, and network connections. To edit the values of a parameter, click the corresponding link.

• General tab — Indicates the name, description of the VM and when it was created. You can configure key pairs, cloud-init and add scripts to run your VMs.

• System tab — Details the system properties of the VM.

• Disks tab — Details the disk size, controller and the boot status. You can even add CD–ROM image. See Uploading and Using an ISO Image.

• Network tab — You can implement fine-grained control over network access if required to your Oracle Cloud Infrastructure Ravello Service instances, both from other instances as well as from external hosts. When you import your VMs and create an instance, by default, your network configuration is preserved. Verify your network architecture for your application or blueprint on the Network tab of the Application page. See Viewing the Network Architecture.

• Services tab — The service interfaces indicate how the VM is used, and which IP addresses and ports it exposes. You can even configure SNAT, which replaces source IP address with a local IP address.

Sharing Library Items

Share your VMs, disk images, blueprints that are saved in your Ravello library with users in other organizations or on the Ravello Repo portal. Sharing an item enables other Ravello users to view and create their own copies of the item, which can then be edited to suit the needs of other organizations.

Topics

• Sharing Library Items on Ravello Repo

• Sharing Library Items With an External User

Sharing Library Items on Ravello Repo

You can share your VMs or disk images on Ravello Repo to collaborate with others.

You must have a public profile before you can share or use library items on Ravello Repo. For details on setting up your profile, refer to Setting up Public Profile.

If you make changes to the shared VM or Disk Images in your library, they are automatically updated in the version that is visible to other users. If users make changes to their own copies of the item, it will not change your VM or Disk Image. To share an item on Ravello Repo:

1. Navigate to Library > VMs / Disk Images and select your item that you want to share with others.
2. Click Share and select one of the options:
   1. Manage Sharing
   2. Share Publicly on Ravello Repo
3. Follow the prompts and share on Ravello Repo.

You can view any disk image or VM that has been shared with you. To view shared items, go to the Library > Disk Images or VMs page, click Shared with me . If the list is empty, then it means that you do not have any shared items.

Sharing Library Items With an External User

Share your disk images or VMs with a user from another organization.

Make sure that the disk image does not contain any confidential or proprietary information before sharing it.

To share a library item with a specific user:

1. From the Library > Disk Images or VMs page, select the item you want to share and:
   • Click Share > Manage sharing, and click Another Organization in the Manage Blueprint Sharing dialog box.
   • Click Share > Share with Others.
   A screen Share with Users In a Different Organization is displayed.
2. (Optional) Click Review/edit blueprint documentation to update the description.
3. In the Share with Users field, enter an email address to share your library item.
4. Read the terms and conditions and share.

Instructions regarding your shared blueprint will be emailed to the user.