Managing Hardware Regions

Note: This document is based on Jelastic version 3.3.1

Click on the Regions option in your JCA > Cluster menu section to see the list of currently available Regions at your Jelastic platform (independent hardware sets from different data centers) and Hardnode Groups (nominal hardware sets with different parameters, allocated within regions).

Note: Starting with the 3.3 Jelastic version, all the hardware your cluster consists of is included to a single Default Region and Default Hardnode Group due to the multi region model implementation, which allows you to handle different types of hardware within the confines of a single platform.

In case you are not planning to use this feature for now, you may leave everything as it is without any changes - your cluster will continue working as usual and your users will notice nothing. Otherwise, i.e. if you decide to benefit on providing multiple regions, you’ll need to specify your own hardware division and consequently adjust it for the end-users.

Here, all the crucial information on Regions is displayed, being divided among the following columns in order to be easily monitored:

  • Name of a region or comprised hardnode group
  • Domain assigned to a region
  • Subnet allocated for a region
  • Migration tick presence marks permission for users to migrate environments from/to current region
  • Status of a region/hardware node group (could be either ACTIVE or under MAINTENANCE)
  • Description with some optional information on a region or hardnode group

Note: that regions themselves aren’t visible throughout the Jelastic dashboard - users operate directly with all of the hardnode groups, available to them.

Use the tools’ panel above to adjust your regions list through the following operations:

Add a New Region

Follow the next steps to add a new hardware region to your Jelastic cluster:

1. Click the Add Region button at the top pane of the Regions section. You’ll see the Add Region frame opened:

2. Here you need to specify the following information:

  • Unique name - special identifier, used within JCA. Can’t be changed later.
  • Display name - changeable region name, that will be visible in JCA (with the maximum value length of 10 characters)
  • Domain - hostname, that will be assigned to a new region
    Note: The appropriate domain name should be purchased beforehand using any preferred domain registrar, i.e. it should already exist
  • Status - state the region will be added with (could be either ACTIVE or under the MAINTENANCE)
  • Subnet - an individual disjoint internal subnet for the users’ containers and traffic routing between different regions
  • Start and End IP - range of the IP addresses (which couldn’t exceed the subnet, specified above) for being assigned to the users’ containers, created in this region
  • Description - a short optional info on the current region to be shown in JCA
  • Allow migration from/to regions - tick this checkbox if you’d like to allow environment’s migration from/to this region for your end-users
    Note that this parameter controls the permission for migration between different regions only, while switching the hardnode group within the same region is available for all users by default and can’t be disabled.

3. Additionally, in the Name servers pane to the right you need to state the IPs (both external and internal ones) for the region’s resolver (or several of them), that will be used as its entrance point and, at the same time, internal and external DNS server.

4. Once all the settings are specified, confirm the creation by selecting the Add button.

Add a New Hardware Node Group

Each region can include several hardnode groups, i.e. a number of hardware nodes’ sets with different parameters like capacity, pricing model or target users. In order to add a new hardware nodes group, follow the instruction below.

1. Click the Add Hardnode Group button while at the Cluster > Regions tab.

2. Within the opened Add Hardnode Group dialog, fill in the given fields with the required data:

  • Unique name - special unique hardnode group identifier. Can’t be changed later.
  • Display name - hardware node group name, that will be displayed at the end-users’ dashboard (with the maximum value length of 10 characters)
  • Status - state this hardware node group will be added with (could be either ACTIVE or under the MAINTENANCE)
  • Description - short optional info on the current hardnode group to be shown in JCA
  • Region - select the region the newly created hardnode group will belong to (or click on the Add Region string to create a new one and follow the instruction in the previous section)

3. After all the values are entered, click Add to allocate a new hardnode group within the chosen region.

Edit Region/Hardware Node Group

You can adjust the existing regions and hardware node groups by simply double-clicking on the required item or selecting the Edit button at the top pane.

After any of these actions, you’ll see the corresponding Edit Hardnode Group/Region frame, which is almost the same as the Add one except the Unique name value for both region and HN group (as this identifier is not editable).

When all the desired changes are made, apply them by clicking Save at the bottom right of the frame.

Remove Region/Hardware Node Group

No longer needed regions and hardware node groups can be deleted with the help of the Remove button at the top tools panel.

Note: You are not able to delete a region or HN group until it comprises at least one container. In this case you need to migrate all of its instances to another hardware set before initiating the removal.

After that just confirm your decision within the appeared pop-up window.