Enabling Roving Edge Exportability

Learn how to enable Roving Edge Exportability for a listing.

Oracle Roving Edge Infrastructure is a cloud-integrated service and an extension of your Oracle Cloud Infrastructure (OCI) tenancy. It uses the fundamental OCI services to generate and consume data regardless of network connectivity. Oracle Roving Edge Device (RED) is the key component in Oracle Roving Edge Infrastructure that delivers cloud computing and storage services at the edge of networks and in disconnected locations. You request to have virtual machines and objects from your tenancy loaded onto a RED by creating and configuring a Node or Cluster resource in OCI. For more information, see Roving Edge Infrastructure in OCI Documentation.

The Roving Edge Exportability feature is a Marketplace extension for Roving Edge customers to transfer workloads launched from the OCI Marketplace to the REDs. This feature allows you to:

  • Create or update a Roving Edge compatible Marketplace listing.
  • Launch instances from Rover Edge compatible listings and create custom images.
  • Export the custom images to REDs.
Note

  1. Roving Edge Exportability is allowed only for Free or Bring Your Own License (BYOL) listings. Paid listings do not have this support.
  2. Ensure that the listings you use to enable Roving Edge Exportability,
    • Are not Windows-based.
    • Are image-based and supports the OCI/ QCOW2 image format.
    • Use UEFI64 loader and not the BIOS.

Prerequisites

Before you begin, ensure that:

  • You are registered as an Oracle Cloud Marketplace publisher.

  • You are granted access to Partner Portal and assigned a user role.
  • You have an Oracle account.

For more information, see Using Oracle Cloud Marketplace Partner Portal documentation.

Configuring Roving Edge Exportability

To configure Roving Edge Exportability for a Marketplace listing, do the following:

  1. Sign in to Partner Portal.
  2. Create an artifact for OCI Image listing. For detailed procedure, see Creating an Artifact for Image Listing in Roving Edge.
  3. Create an OCI application listing that is free or supports BYOL, and set Allow Rover Exportability to true. For detailed procedure, see Creating an OCI Application Listing.
  4. Submit a listing for approval. For more information, see How to Publish an OCI Image Listing.
  5. After approval, publish the listing or publish the listing as private.

Creating an Artifact for Image Listing in Roving Edge

Before you begin, ensure to upload the image to OCI before creating the artifact. For more information, see Creating an OCI Image Listing in Partner Portal.

To create an artifact for an image listing, do the following:

  1. Sign in to Partner Portal.
  2. Click Artifacts. The Artifacts page displays information such as artifact name and other details related to the artifacts.
  3. Click Create Artifact.
  4. In the Artifact Type drop-down list, select OCI Compute Image.
  5. In the Artifact Name field, enter a name for the artifact. Ensure that the length of the name is less than 200 characters.
  6. Select the Allow Snapshot check box to allow your customers to take a snapshot of their instance. This enables your customers to use your listing to launch an instance, customize the instance, and then take a snapshot of the instance. Customers can then use this snapshot to replicate their customized environment.
  7. Click the eyeglass icon next to the Image OCID field to select an Oracle Cloud Infrastructure Compute Image from your tenancy. Ensure to select an image that is Roving Edge compatible. The OCI Compute Images dialog box appears.
    1. Select an Oracle Cloud Infrastructure tenancy, region, and compartment.

      Images, which match your selection, are displayed with details such as image name, source image OCID, and created date.

    2. Identify an OCI Compute Image from the list, and then click Selectto load the selected artifact.

      In the Create Artifact page, the compartment OCID and compatible shapes are displayed for the OCI Compute Image that you have selected.

  8. In the Compatible Shapes section, select all the shapes that you want to provide as an option to your customers.
  9. In the User Name field, enter the user name that you’ll use to access the instance. The user name that you provide is used to validate the artifact. Ensure that the user name you provide has root access to the image, otherwise artifact validations may fail. If you do not enter a user name, it defaults to opc for an Oracle Linux image or ubuntu for an Ubuntu image. For other types of images, you must enter a user name as there are no default values for these images. The user name is limited to 32 characters and can contain only alphanumeric characters.
  10. Review the mandatory image guidelines specified at Guidelines for Images, and then select the I have reviewed and applied all the mandatory image guidelines check box.
  11. Click Create.

The Compute Image in your tenancy is launched, validated against the guidelines for images, and scanned for malware. This process could take up to six hours to complete. In general, the average time taken for this process is around one hour. During this time, the status of the artifact is In Progress. If there are no validation errors, the status of the artifact changes to Available.

If there are any validation errors, the status of the artifact changes to Unavailable. To view the validation errors, see Viewing Artifact Details.

Creating an OCI Application Listing

To create a listing, do the following:

  1. Go to the Home page in Partner Portal.
  2. Click Create Listing.
  3. Click OCI Application Listing.
  4. Select the primary language for your listing.
  5. Click Create.
  6. On the Create Listing page, enter the following required information and save your changes:
    • App Name or Service Name — Enter a descriptive name for your listing. This should be the name of your application. Avoid using Oracle product names in the title. Your app name can contain a maximum of 80 characters.

    • Headline — Enter a brief description that will show at the top of your listing. This should indicate the application’s purpose.

    • Categories or Industry Focus — Make sure that you select the product/category that has integration with your listing. Your selection helps people to find your listing.

      Note

      If your listing does not have an Oracle SaaS integration but runs independently on OCI, you must select OCI as the product/category instead of the Oracle SaaS product. You can select multiple categories ensuring that your selections have integration with your listing. If your listing does not have an integration with any of the Oracle SaaS services, do not select any of the SaaS product categories (even though your solution itself is in that category) for your Marketplace listing. In such cases, you must only select the OCI product categories. Oracle may choose to recategorize the application as part of the curation review process.

    • Select Pricing Model (only app listings) — Select one of the following options to specify whether your app is free, paid, or requires the user to use an existing license.

      • Free — There are no charges for use of your offering.
      • BYOL — The Oracle customer contracts with you directly for licensed use of the software. This option is available only for Oracle Cloud Infrastructure application listings.
  7. Go to Roving Edge Exportability and click Edit.
  8. Select the check box Allow exporting instance of package(s) attached to the listing to roving edge.
  9. Click Save.
  10. Fill out the other sections on the form, and save your changes.
    • You can complete the other sections in any order. For example, you can upload the icon, add information to one or more sections, and then upload a banner.

    • Only one section can be active for editing at a time. You must close a section (either by saving or canceling your changes) before you can edit another section. Otherwise, the Upload, Edit, and Add options aren’t active.

    • You don’t have to complete the form all at once. You can enter some information, preview the listing, and then return to edit or add details. You can continue to preview and revise your listing until it’s exactly right.

  11. Click the App Install Package tab.
  12. To create a new install package, select the OCI Compute package type and click Create Package.
  13. Enter the basic information for the install package such as version and description. The "version" field is shown to

    customers during the Install flow. In the Terms of Use field, select the terms of use for this app and install package.

  14. Click Save. After the package is initially created, you can click Edit in the Define Package Information section to modify the basic

    information at any time.

  15. In the Configure OCI Compute Image section, click Edit to configure a resource. Select the artifact you just created and

    click Save. You can click Edit in the Configure OCI Compute Image section to modify the resource information at any time.

For more information, see How to Publish an OCI Image Listing.