Create an application

What is an IOhub application

An IOhubTM Application consists of one or more Docker containers grouped together to execute an extensive and complex task.

As a result of the applications, IOhubTM executes specific tasks.

One or more applications may run and coexist within IOhubTM.

Please check the the introduction to IOhubTM section of this document for further details on IOhubTM’s architecture and philosophy.

Creation methods

In order to create an application, please access IOhubTM in the EZ BoxTM management interface (IOhubTM/EZ BoxTM name) and enable Edit Mode.

<iohub></iohub> Edit mode status

Check Edit Mode if you need further information.

Applications can be added to IOhubTM in the following ways:

  • Choose an application from Catalog.
  • Create a new application.
  • Rebuild an application from a template.

Choose an application from the Catalog

IOhubTM provides some ready-to-use applications that can be chosen from an internal catalog. These applications have been packaged and customized by EZ VPN to perform specific tasks like internal debugging or monitoring.

From the IOhubTM section in the EZ BoxTM management interface (IOhubTM/EZ BoxTM name):

  1. Click Choose from Catalog button to access IOhubTM catalog and select the application.
  2. Click +Add button to add the application to IOhubTM.
Iohub choose from catalog
<iohub></iohub> add application

Repeat the above steps to add other applications from the catalog.

All configured applications will be shown in the IOhubTM application list section.

Create a new application

Create a new application from the IOhubTM section of the EZ BoxTM management interface (IOhubTM/EZ BoxTM name) by following these steps:

  1. Type the application name.
  2. Tick Enable Global MQTT to enable the system MQTT that allow inter-application MQTT communication within the same IOhubTM instance.
  3. Tick Global MQTT is default to set Global MQTT as the default MQTT broker used by the application.
  4. Type additional notes.
  5. Click Add Application button.
<iohub></iohub> add application manually

Application name is required, it must be lowercase and cannot contain the following prefix: ezvpn-

The "Notes" field is optional and may contain any character.

When the application has been created you'll need to add the containers that will be part of the application.

Rebuild an application from a template

This is a fast way to replicate an application within IOhubTM. “Applications Templates” includes a list of preconfigured containers that users can save for future use. The saved Application Templates are available in all IOhubTM enabled devices. Templates are useful when the same application need to be configured on other devices. In scenarios where users need to replicate the same configuration on several devices, templates can save a lot of time.

In order to create an application from a template you need first to create a template.

Create an application template

When an application has been built within IOhubTM you can save it as a template to replicate on other devices.

In the IOhubTM section of the EZ BoxTM management interface (IOhubTM/EZ BoxTM name), locate the application you want to create the template from

  1. Click Create Template button
<iohub></iohub> create template
A template with the same name of the application is created. You may now assign a different name for your template.
  1. Type the new name for your template
  2. Click Update Template button to save the changes.
<iohub></iohub> update template

The Application templates list page will appear.

<iohub></iohub> template list

To access the templates list:

  1. Click IOhubTM menu.
  2. Click Templates menu.
<iohub></iohub> templates menu

Using a template to create an application

When a template has been created you may use it to rebuild new applications. From the IOhubTM section of the EZ BoxTM management interface (IOhubTM/EZ BoxTM name) you can create a new application:

  1. Type a name for your application.
  2. Click Add Application button.
<iohub></iohub> add application
  1. Click Choose a Template button
<iohub></iohub> choose template
  1. Click +Add button to add the template
<iohub></iohub> add template

The application has been configured using the template.