see on GitHub

Cloud Portal: The Products Tab

Provisioning a New Product

To provision a new product, open your Portal's Products tab and click Add Product.
"Add Product"
The New Product wizard will open, and walk you through four simple stages:

  1. Plan
  2. Billing
  3. Customize
  4. Summary

1. New Product: Plan

Use the Plan page to choose your product's cloud provider, region and tier.
"Products Tab Plan"

  • Cloud Provider
    Choose your cloud host. It can currently be one of two providers: Amazon AWS and Microsoft Azure.

  • Region
    Select where your equipment would be physically located.

    You can currently locate Free Instances only in the US East (N. Virginia) - us-east-1 region.

  • Tier
    You can raise a Free node, a Development node or a Production cluster.
    Learn more about them in the Tiers and Instances page.


2. New Product: Billing

Enter your billing details and click Next,
or click Later to evaluate the cloud service using a basic free product.
"New Product: Billing"


3. New Product: Customize

Choose your product's display name and allowed IP addresses.
"New Product: Customize"

  • The display name is simply the name by which this product would appear in your Products tab.
  • The Allowed IPs selection is important.
    It determines which addresses would be allowed to manage your database, adding an important layer to your database security.
    You can set it to 0.0.0.0/0, which would allow access from any location, or you can specify certain IPs or IP ranges.
    Be aware that you will not be able to access your instance from locations that are not specified in the allowed IPs list.
    You can edit the list at any time through the Portal.
    Regardless of the allowed IPs setting, your RavenDB Cloud instances will always require authentication using X509 certificates for access. The allowed IPs list limits service as an additional layer of security, but isn't the only one.

    Azure products do not permit overlapping of addresses in the Allowed IPs list.
    If addresses in your list overlap, your product will not be created. E.g. -

    • Listing both 13.64.151.161/32 and 13.74.249.156/32 is not permitted.
    • Listing 0.0.0.0/0 and any other address is not permitted.
    • Listing both 51.140.148.192/27 and 13.74.249.156/32 is permitted.


    4. New Product: Summary

    The Summary stage shows you your choices and lets you edit them if you wish.
    "New Product: Summary"


    When you finish defining your product, the cloud provisioning routine will show you your new product's status until it's ready to go.
    "New Product: Provisioning"
    "New Product: Active"


Managing an Existing Product

To modify an existing product, find it in the Products tab and click its Manage button.
"Manage Product: Manage Button"
You can set it using its three tabs:

  1. General
  2. Security
  3. Danger Zone

1. Manage Product: The General tab

You can view your configuration and change your product's instance type and storage size here.
"Manage Product tab"

  • Change Instance Type
    Click this button to scale your product up or down by choosing yourself another configuration.
    "Manage Product: Scale"
    You can upscale or downscale only within the current product tier. The development-tier DEV30 configuration, for example, can upscale to Dev50, but not to the production-tier PB10 configuration.
    Your databases and data will be automatically migrated into your new configuration.

  • Change Storage
    Click this button to modify your product's storage.
    "Manage Product: Storage"

You can allocate more disk space to your cluster (but not reduce it), and you can select Premium disks and the number of IOPS reserved for them.


2. Manage Product: The Security tab

Use the security tab to download your certificate or determine which addresses are allowed to connect your database instance.
"Manage Product: Security"

  • Download
    Click this button to download your certificate.
    Your product will communicate only with trusted sources. Install this certificate only on trusted machines.

  • Edit
    Click this button to edit your product's list of Allowed IPs.
    "Manage Product: Edit IPs"
    The default setting, 0.0.0.0/0, grants access to all IP addresses.
    All your RavenDB Cloud instances are secured using TLS 1.2 and X509 certificates, but you can increase your system's security further using this in-depth security measure and restrict access to your cloud instance to well-known sources, e.g. your application servers. We recommend it.

    Cross-instance communication inside the cluster is not subject to these restrictions.

    Azure products do not permit overlapping of addresses in the Allowed IPs list. E.g. -

    • Listing both 13.64.151.161/32 and 13.74.249.156/32 is not permitted.
    • Listing 0.0.0.0/0 and any other address is not permitted.
    • Listing both 51.140.148.192/27 and 13.74.249.156/32 is permitted.


    3. Manage Product: The Danger Zone tab

    Use this tab's Terminate button to eliminate your cluster.
    "Manage Product: Terminate"

    Terminating your instance is irreversible. Your data and cluster properties will be permanently lost.