Managing your environment

December 21, 2021

Jahia Cloud Dashboard is the administrative application that you use to create, manage, configure, and monitor your Jahia Cloud environments. An environment is a group of instances configured in a cluster for a specific client, such as Jahia or jExperience. The following image shows the Jahia Cloud dashboard home page.

JahiaCloudUI.PNG

The left panel displays a list of your cloud environments, and provides access to the Jahia Customer Support portal and Jahia Cloud documentation. At the top right, you can open the Jahia site for the selected environment, open Support Tools, and access Datadog. Support Tools is an interface that you use to run commands on your server, such as activating maintenance mode, getting information about the system, displaying thread dumps, and viewing your cache and cluster statistics. For more information, see Monitoring your server for performance. You use Datadog to monitor your cloud environments. Datadog is a Jahia partner that provides platform monitoring and optimization capabilities.

You can use the five tabs at the top of the main pane to navigate pages in Jahia Cloud dashboard .

  • General
    View information about the selected environment, upgrade, start, stop or delete an environment, and perform other advanced actions such as enabling auto scaling.
  • Configuration
    Modify and create properties to customize your environment. For example, you can modify session time-out settings or switch a cluster to maintenance mode.
  • Nodes
    Access or restart specific node of your environment.
  • Backups
    Schedule backups for an environment, and restore environments if necesssary.
  • Domains
    Bind external domains, swap domains between environments, and configure TLS certificates.
Note: You cannot access the Jahia Cloud Dashboard home page until you have created at least one environment.

To rename an environment, click the edit button edit_environ_name.png beside the name for the selected environment, provide a new name and click the save button save_environ_name.png.

Logging in to Jahia Cloud Dashboard

You can get the URL for your Jahia Cloud Dashboard from your support team.

To log in to Jahia Cloud Dashboard:

  1. Enter the URL to your cloud environment in your browser.
  2. On the Jahia page, enter your credentials and click Login.

If you are a new visitor, the page prompts you to create a new cloud environment. Otherwise, the Jahia Cloud Dashboard home page displays.

Creating an environment

Environment creation is automated and takes only a couple of minutes. You can deploy the following environments:

  • Jahia
  • jCustomer

You can deploy any Jahia module on these environments.

To create an environment:

  1. Click the Create a new environment button. Select the subscription item you want to use, based on your contract.
    JahiaCreateBands.PNG
  2. In the Configure your environment page, in General, specify an environment name and subdomain and platform type.
    • Environment name
      The environment is visible to you when you administer your Jahia Cloud environments and does not display to end visitors of your sites. The name can contain any kind of characters and must be at least six characters long.
    • Environment subdomain
      An environment key that is used only for internal purpose. This parameter makes your environment available through <subdomain>.cloud.jahia.com and does not display to your site visitors. You cannot change the subdomain name after defining it.
    • new_environment.PNG

Next, you can manage your environment and log in to your Jahia site.

Starting and stopping an environment

You can start and stop an environment when you want to make it unavailable to users. After stopping an environment, you can no longer perform most operations on the environment, such as upgrades or backups.

To stop an environment:

  1. In the left panel, select the environment that you want to start or stop.
  2. In the Danger Zone, click Stop.
    stop_env.PNG

    After stopping the environment, the status updates in the left panel and in Environment information.

This action will stop all components of the related environment and shouldn't be use to restart the Jahia and jCustomer services. Instead, please use the rolling restart feature under the "Nodes" tab.

To start an environment:

  1. In the left panel, select the environment that you want to start.
  2. In the Environment information, click Start.
    jahia-cloud-env-start.png

About upgrading an environment

To upgrade an environment, select it tehn go to General>Environment upgrade. You can then select the version you want to upgrade to, then click the "Upgrade platform" button, as shown in the following example.

upgrade.PNG
 

For each software upgrade that contains significant changes (indicated by the first two digits in Jahia version numbers), we release code migration guides to make the code upgrade process as easy as possible. If in doubt, don't hesitate to reach out to your support team for guidance.

The upgrade process differs for development and production environments.

About upgrading a development environment

When you upgrade a development environment that is not in production, the upgrade service upgrades environments without generating any downtime for the end visitor. The service also changes the content editing mode to read-only mode for a few minutes. For a development environment, the upgrade service:

  • Stops all environment nodes
  • Upgrades the Jahia processing node
  • Upgrades all Jahia browsing nodes
  • Updates the environment metadata to reflect changes such as new configuration entries

To upgrade a development environment, see Upgrading an environment.

About upgrading a production environment

As a best practice, before upgrading your production environment Jahia recommends that you:

  • Create a backup of your environment
  • Perform the upgrade on copies of your production environment to ensure that your environment and custom modules run as expected

To perform a zero-downtime environment upgrade in production:

  1. Create a backup of your production environment. For more information, see Backing up an environment.
  2. Change your production platform to read-only mode. For more information, see Making an environment read only.
  3. Duplicate your production environment. For more information, see Backing up an environment.
  4. Switch traffic to your duplicate environment. For more information, see Jahia Cloud environment domains and endpoints.
  5. Upgrade your production environment, as described above.
  6. Validate that the platform works as expected and check the Datadog dashboards.
  7. Switch traffic back to your the production environment. For more information, see Jahia Cloud environment domains and endpoints.
  8. Delete the duplicate environment. For more information, see Deleting an environment.

Making an environment read only

Before upgrading your environment, you may need to make the environment read only. In read only mode, users can access the Jahia site and cannot make changes.

To make an environment read only:

  1. To modify the mode in Jahia Cloud Dashboard:
    1. In the Configuration tab, in the Filter field, type read only and press Enter.
    2. Select the checkbox beside Read Only Mode and type true in property value field.
    3. Click Save configuration.
    4. Restart your application nodes.
  2. To modify the mode in Support Tools:
    1. At the top of Jahia Cloud Dashboard, click Go to the Tools.
    2. In the login dialog, enter manager for your user name and provide the Tools password that you specified when you created your environment.
    3. In Support Tools>System and Maintenance, click System maintenance.
    4. In the System maintenance page, under Read-only Mode, click enable read-only mode.

 

Enabling auto scaling

 

Auto scaling increases the number of servers assigned to your environment when your site experiences a spike in traffic. Servers are added when traffic increases above the threshold of more than 80% for five minutes. When traffic returns to its normal activity level, the additional servers are removed.

Auto scaling ensures that your site visitors are unaffected by sudden changes in overall traffic to your site. 

Note: Additional fees apply when you enable auto scaling.

To enable auto scaling:

  1. In the left panel, select an environment.
  2. In General>Advanced options>Auto scaling, select Auto scaling CPU enabled.
    auto_scaling_enabled.png

The number of servers assigned to your environment are now automatically adjusted based on capacity.

Deleting an environment

You can delete environments that you no longer require.

Warning: When you delete an environment, all data belonging to the environment is also deleted and cannot be recovered.

To delete an environment:

  1. In the left panel, select an environment.
  2. In General>Danger Zone>Delete environment, enter delete environment in the Type confirmation phrase box.
    delete_environment.png
  3. Then, click Delete environment.
    delete_environment_button.png
  4. Click OK in the dialog that indicates that environment was deleted.

The environment is deleted from the system.

About dynamic load balancers

Load balancers enable you to restart any node on a cluster without generating downtime and to deploy configurations to a cluster one server after another. Load balancers are automatically installed for each new environment. These load balancers are composed on nginx servers and a layer of automation ensures that Jahia Cloud does not redirect traffic to a server that is unavailable. 

If no nodes are available to answer visitors page and API requests, a Jahia page indicates that the requested website is in maintenance.

About code deployment

Jahia comes with great built-in code deployment capabilities and allows for cluster module deployment from APIs or file upload. To learn more, see Jahia module deployment explained.

There is no restriction whatsoever on the type of modules, and built-in and custom integrations that you can deploy on Jahia Cloud.