Jelastic Dashboard Guide

Note: This document is based on Jelastic version 3.3.1.

The following guide will provide you with the basic information on Jelastic dashboard functionality and help you get acquainted with the possibilities it provides.  

Hopefully you have already created an account at Jelastic Cloud (otherwise, do not waste any time and follow these simple steps). Simply access your dashboard with the help of our Jelastic site or by using the direct link (http://app.{hoster's_domain}/), sign in with your credentials and start exploring.

Here is a list of main sections:

Creating and Managing Environments

1. Click New environment in the upper left corner of the dashboard.

Note: You can also use the down arrow (if displayed) next to the mentioned button to expand a list with the following extra options:

  • Create - will open the topology wizard for a new environment creation (the same as the New environment button)
  • Import - will display the Open file window, which allows you to choose a file with the previously exported environment from another Jelastic installation, for being imported to the current one (to get more information on this functionality, refer to the Environment Export and Import article)

2. The Environment topology dialog box will be opened, where you can fully customize your environment settings.

The full possibilities of this window are described in the Setting Up Environment article.

3. When you finish your configurations, just type a name for your environment and click the Create button. Your environments will be listed in the upper pane of the admin panel along with the following information in the columns:

  • Name column includes the name (or an alias if specified) of the environment, its domain and region icon. Using the triangle mark before the environment’s name you can expand the list of nodes it includes.

  • Status column shows the state of your environment (Running, Sleeping, Stopped) or the interim process it is currently undergoing (Creating, Launching, Stopping, Cloning, Exporting, Installing, Migrating, Deleting).

  • Deployed column indicates if any application package has been deployed (and which exactly) to this environment or is currently deploying now. In case several projects are handled within different contexts, their overall amount is displayed.

  • Usage column shows the amount of cloudlets and disk space that environment currently consumes. You can also find the Billing history  button here, which leads to a separate tab with statistics on your spends (both overall and for every node separately), divided according to the specified time period.

  • Owner is an optional column (appearing only in the case you are included to the Account Collaboration) with the environment’s owner name.

Function Icons for Environments

Hover over a running environment to see a few more icons showing up: 
  • Region
  • Open in browser
  • Settings
  • Clone environment
  • Change environment topology
  • Delete environment
  • Start/Stop

1. Hover over the region icon_dev.png icon to instantly display its label (name). Clicking on it will open the Migration section within the Settings frame below.

2. Click theOpen in browser icon to open the environment in a new browser tab.

Note that this option could be absent in case your environment consists of Docker®-based containers or just does not include an application server (i.e. no web interface is handled by default).

3. Click on Settings to open a tab with a number of configurations available. There are ten options here: Custom domains, Custom SSL, SSH Access, Monitoring, Endpoints, Migration, Account Management, Change Owner, Export and Info.

  • Select Custom domains to access the following suboptions: Domain binding and Swap domains.

    More info:

  • Choose the Custom SSL option and upload the necessary files in order to apply your custom SSL Certificate.

    More info:

  • Click on SSH Access to add your public SSH keys and get the ability to connect securely to your environments’ containers and execute the required commands there.

    Note that SSH settings are applied to the whole account but not to a separate environment.

    More info:

  • Select Monitoring in order to start tracking the amount of resources your environment consumes.

    Note that this feature is currently unavailable for the Docker®-based containers.

    Use Load Alerts to set sending of email notifications in case the specified resource’s usage exceeds the stated limits.

    Within the Auto Horizontal Scaling suboption you can configure triggers for changing the amount of nodes depending on your web/application node CPU or RAM consumption.

    The Logs section contains records about all the events that occurred due to the configurations, set using the two abovementioned sections.

    More info:

  • Within the Endpoints section you can manage the mapping of your containers’ TCP/UDP ports for ensuring their collaboration with the external resources via a direct connection.

    More info: Endpoints

  • Choose Migration to move your environment to another set of hardware.

    Note that the availability of this option, as well as its allowance for each particular environment region, depends on your hosting provider’s settings.

    More info:

  • Select Account Management to see the list of accounts which have access to the current environment.


    If you need to share the environment with another account, click Add and fill in the Email field. You can also tick Change Topology / SSH Access if you would like to give such permissions to a user. Click Save.

    More info: Account Collaboration

  • Click Change Owner in order to transfer the environment to another user’s account within the confines of a single platform.

    More info: Environment Transferring

  • Select Export in order to pack all your environment’s settings and data into a single downloadable file, that can be subsequently restored at another hosting provider’s platform for creation of the identical and ready-to-use environment.

    More info: Environment Export and Import

  •  Switch to the Info section to see the additional information on an environment’s domain (except the Docker®-based ones and environments with no application server), creator/owner (they can differ due to the account collaboration feature), region and the date/time of its creation.

4. To Clone the environment, click on the appropriate button. In the opened frame, specify the name for a new environment and click Clone.

More info:

5. In order to Change the environment topology, select the needed option . Perform the required changes in the appeared Environment topology dialog box and click Apply to submit them.

6. To Delete an environment, click on the red cross icon and confirm that you really want to do this by entering your password.

7. To change the status of an environment, use the Start  and Stop buttons (located in the Status environment column).

Note: When environment is stopped, only the SettingsClone environmentDelete environment and Start buttons are available. 

Also, the opened Settings tab for such an environment will contain only four active options: Migration, Account ManagementChange Owner and Info.

Function Icons for Each Instance

Click the triangle before the name of the environment in the upper frame to expand the drop-down menu with the list of selected application servers, databases and other instances. You can also expand any of them in just the same way to access the separate containers and contexts with the deployed applications.

Hover over a particular instance or container to see the pop-up icons with different functions.

Use these icons to perform the following actions:

  • Click the Open in browser option to open the application server, database, balancer, VPS node, Docker® container or application context in a new browser tab.

  • In order to Restart node, select the same-named option and confirm your decision. In just the same way this can be done for a set of the same-type nodes.

  • Select the Config option to open the Configuration Manager tab, where you can change the node’s settings by means of uploading and modifying files.

  • Select the Log option to view the log files for a separate node or for the set of the same-type ones. Log files list can differ depending on the selected instance.

  • Select the Statistics option to track the statistics on CPU, RAM, Network I/O and Disk space consumption for a separate node or a set of nodes in a real time.

  • Some nodes can also have optional buttons, such as Add-ons (for installing available pluggable modules) and Add project (for deploying apps via GIT/SVN).

    In particular, the Windows-based nodes are supplied with their own specific options, that are grouped under the Remote desktop  list, namely: Open in browser (for accessing them via Guacamole RDP tool - don’t confuse it with the already described same-named environment option), Reset RDP passwordInfo and a direct link for establishing the remote desktop connection via local client.

    In addition, the IIS application server has a unique Publish info  list, which contains Info on direct apps deployment from Visual Studio IDE and the corresponding link.
    Also, the Delete button is available for all deployed applications, allowing you to easily remove them from the application server.

  • Other possible options are hidden within the drop-down list, that can be accessed by means of clicking the Additional button (with gear icon), for example: Info, Reset password, attached internal and external IP addresses, etc.

While hovering over a separate node, you’ll see one more Set Alias icon. It allows you to set an alternative name for your node instead of the default Node ID label (e.g. to define master and slave servers in a DB cluster). The same thing can be done with the environment name, wherein its domain name will remain the same.

Marketplace

Next to the New environment option at the top panel of the dashboard, you can find the Marketplace button, which is also expandable:

  • Click the Applications suboption (or the Marketplace button itself) to access the list of preconfigured packaged applications.

    Locate the desired package (using the categorized list or search box) and click Install in order to automatically create an appropriate environment and deploy the chosen application to it.

  • Choosing the Docker® Containers suboption (or switching to the same-named section within the Marketplace tab) will open the panel, where you can find and subsequently deploy the desired Docker® image using one of the three available tabs:
    • Quick Start contains a set of the most popular templates
    • Search on Hub Registry allows finding of required template at the central Docker® templates registry
    • Custom provides the ability to add your own template from a custom registry

The detailed information on the use of these sections can be found in the corresponding article.

Deployment Manager

The Deployment Manager is used to upload application packages and subsequently deploy them to an application server of your running environment.

1. Click the Upload button to access the Upload archive dialog box. Using it you can browse to the desired local file or specify a URL (http://, https:// or ftp://) in the appropriate tab.

Note that the maximum available size of the uploaded local file is 150 MB. If your application size exceeds this limit, please use the URL for uploading.

Fill in the Comment field if required and then click Upload.

2. Select the uploaded file and click the Deploy to button to see the list of suitable environments. Choose the one you would like to deploy your application to.

3. In the opened dialog box, you can either just confirm the deployment (in this case the default ROOT context will be used) or optionally set the desired custom context. Herewith, depending on the programming language used, this should be performed as following:

  • for Java/PHP/.NET - type the context name to the special field
  • for Ruby - choose out of the proposed variants
  • for Python and Node.js - a single predefined deployment path is used, thus specifying your custom contexts for these programming languages is not available

Note: Also, in case no custom context is specified, you can enable the ZDT deployment mode for your PHP application using the appropriate checkbox below.

Click Deploy to initiate the process itself.

In our Deployment Guide you can find a variety of links to the instructions on different ways of deploying apps, according to the programming languages they have been written in.

Tasks Panel

The Tasks panel is placed at the very bottom of the dashboard and contains live and historical data on the tasks that Jelastic engine is doing or has already done.

This panel includes the Date, Name and Status columns, which give you the detailed information on each task:

  • when the action has taken place
  • what has been performed
  • result of this action (i.e. Success if everything is OK or an error description if some problem occurred)

Task panel tracks all global processes (like Creating environment, Adding node(s) or Deploying context), as well as the subsequent changes and actions performed in the File manager (Getting the list of files, Creating file etc).

Account Settings

Click the Settings button at the top-right corner of the dashboard in order to access a few more configurations, which are applied to the whole account.

You’ll see two sections available here: SSH Keychain and Collaboration.

  • SSH Keychain - here you can find general information on the SSH protocol usage at Jelasic and several useful links to our documentation with instructions for both private and public SSH keys. The same-named subsections can be found within the menu to the left.

    The Private one gives you the possibility to add the pre-generated private SSH keys to your Jelastic account. Subsequently, they can be used for authentication at your private GIT/SVN repositories, allowing to work with the remote secured projects directly from the Jelastic dashboard.

    More info:

    The Public subsection allows binding of a public SSH key to your account, required for getting the ability to securely access and manage your containers via this protocol.

    More info:

  • The Collaboration option includes two items - Account Management and Shared with Me. Here, the first one allows you to share certain activities with other accounts by means of creating and configuring your own collaboration, while the second one is intended for managing the already shared with you accounts.

    More info: Account Collaboration

Upgrade Trial Account & Balance

Depending on your account type (trial or billing) you’ll see either the Upgrade trial account or Balance button at the top of the dashboard panel.

1. If you are a trial user, you can see the Upgrade trial account button. Click it to open a drop-down menu with the following options: Upgrade trial account, Learn about trial limitations, Learn about pricing and See statistics on recent resource usage.

  • Use the Upgrade trial account option to get a fully functional account with no limitations.

    More info: Billing system

  • The Learn about trial limitations button will open the information about your account limits, provided software stacks and tariffs.

    More info: Quotas System

  • Click on Learn about pricing to be redirected to the hoster's page with information about pricing.

    More info: Pricing System

  • Select the See statistics on recent resource usage option to open your Billing history.

2. If you are a billing user, you can click the Balance button to see such options as: your Balance, Refresh balance, Refill balance, Configure auto-refill, Payment methods, Quotas & pricing, Billing history, View invoices.

  • Balance shows your general current balance and its components: cash and bonus. By clicking on this option you can open the tab of balance refilling.

  • Refresh balance option allows you to see the changes of your balance while working in the dashboard.

  • Click on Refill balance to submit the payment.

  • Using the Configure auto-refill item you can set Auto refill of the balance by choosing one of the options: Weekly, Monthly or when Balance is less than specified sum.

  • Payment methods option gives you an opportunity to choose your default payment method or add the new one.

  • Click on the Quotas & pricing item to see the information frame with a set of tabs about Jelastic pricing and account limitations. In addition, depending on your hosting provider’s settings, you may also see the additional tab with details on the available environment regions here.

  • Billing history shows your spends for the specified period, which can be arranged by such intervals as hour, day, week and month. Data shown is grouped within environments. After choosing the necessary environment you’ll see the list of nodes it consists of, with information on each node’s Name, its resources consumption (Reserved/Dynamic Cloudlets & Storage), used Paid traffic and Cost for using this node.

  • Click on the View invoices option to see the invoices which should be paid.  

Additional Options: Search Box, Help, Email Address

There are several additional options in the upper right corner of the dashboard:
  • Search box
  • Help (Contact support, Docs, API docs, Video, Go to community, Show Jelastic tutorial)
  • Email address (Change password, Language, Signout)

1. If you have any questions on using our platform, you can use the How do I..? search box. Simply enter the question you are interested in and you'll be redirected to the list of appropriate Jelastic documents which may help you.

2. The Help drop-down menu gives you access to the Contact support, Docs, API docs, Video, Go to community and Show Jelastic tutorial options.

  • Contact support is a hyperlink to your hoster's Support page (sometimes available only for billing users)
  • The Go to community option links to the Jelastic online community
  • The Show Jelastic tutorial button switches on the step-by-step instruction for beginners showing you how to get started with Jelastic

3. The last option is your Login (email address). Click on it to open the drop-down list with the following options: Change password, Language and Signout.

  • Click Change password to open the Change password dialog box. Fill in the required fields: Current password, New password and Confirm password. Then click Change password.
  • Use the Language option to change the language of the dashboard interface.
  • Click Signout to leave the dashboard.

Now you know all of the basic dashboard possibilities and hopefully won’t have any problems using it. If you still have additional questions, please contact the Support team of your hosting provider.