{{ :level2:level2_logo_.png?direct&200|}}

====== Connecting WebHMI to Level2 ======

<WRAP center round info 60%>
The information in this section relates to the hardware WebHMI & Virtual box version. The cloud running version is connected automatically during creation phase.
</WRAP>

----

The "connection" means getting API key from Level2 system, which then WebHMI uses for data sending to the cloud. Other part of the connection is the WebHMI VPN client connection to the Level2 VPN server which facilitates remote accessing to the WebHMI using HTTP proxy service. 


Depending on the fw version, there are 2 ways how to setup the connection:
  - For the fw versions __starting from 3.5__, the connection (both VPN and data sending) can be made right from the WebHMI project setup, and further adjusted in the Level2 system. You must have valid Level2 account  or you will be prompted((if you don't have one)) to do this during the setup. 
  - For the older versions, the setup is made a bit different:
    -A node condiguration is created on the Level2, which generates API key and VPN client credentials
    -On the WebHMI, you enter this API key and VPN credentials to get connected.

===== Connecting from WebHMI project setup menu, newer method (#1) =====

You can connect WebHMI to Level2 following Setup / Level2 link from side bar menu:

{{network:l2_signing_in_from_webhmi.png?direct&912|}}

Then you have several options how to proceed:
  *if you don't have any Level2 account, you can follow __Register now__ link and create new account
  *if you have Level2 account, you can __Sign-in__ and use step-by-step procedure right from this page. 
  *if you already have an account and some node created there in advance, you can just input API key from this node following __Enter API key directly__

<wrap em>As of 3.6 fw version, Level2 setup link resides in the popup setup menu</wrap>

{{ :level2:l2_link_in_menu.png?direct&600 |}}


==== Registering in Level2 system ====

You may follow the above mentioned __Register now__ link or use this URL - [[http://level2.webhmi.com.ua | level2.webhmi.com.ua]]. 

{{network:l2_registation_window.png?direct&500}}

  -Enter e-mail you want to use as a login for Level2 
  -Enter password
  -Choose currency to use in Level2 tarriffs, reports, billing etc.
  -Starts registration process ( confirmation e-mail will be sent to the e-mail indicated as login )
  -To Enter into existing account with login and password provided
  -Recover password link
  -Language selection for Level2 interface

==== Adding a node to Level2 using WebHMI sign-in option ====

With this method you can add WebHMI node into Level2 system right from Setup / Level2 menu. Pressing Sign-in button will lead to this step where you can create a new node or choose an existing one:

{{network:l2_from_webhmi_create_node.png?direct&600}}

After successful creation, this page is displayed which indicates, that the node with title "webhmi" was added to Level2 account "myLevel2account@gmail.com". You can remove node from here by clicking "Disconnect" or setup some basic Level2 services:
  *VPN
  *data storage
  *real-time data storage and visualization 
  *weather forecast

{{network:l2_node_after_creation.png?direct}}

After WebHMI and its node settings in Level2 were tied together, you can enable basic Level2 services right from the WebHMI.



==== VPN setup from WebHMI Level2 menu ====

----

There is a simple way to setup VPN connection for WebHMI to Level2 right from this page - turn the switch button on and press **Save**.

{{network:vpn_-_turn_on.png?direct}}

Then a new L2TP connection will be created on the WebHMI with settings that match Level2 network setting for this node. 

{{network:l2tp_auto_creation.gif?direct}}

The VPN account settings were automatically created in Level2 node settings and applied to VPN network interface in WebHMI:

{{network:vpn_-_auto_setup_l2.png?direct}}

If VPN option is turned on, HTTP proxy service also can be turned on:

{{network:http_proxy_addition.png?direct}}

Another powerful feauture based on Level2 VPN is a Virtual IP. With this feature you can remotely access other devices in WebHMI local network using Virtual IPs set in these settings:

{{ network:enable_virtual_ip.png?direct&840 |}}

===== Connecting using old method, #2 (for fw below 3.5) =====

First, create a node in the Level2 node list:

{{ :level2:add_node_button_l2.png?direct&800 |}}

Turn on VPN and Http proxy services:
{{ :level2:l2_node_vpn_http_highlighted.png?direct&600 |}}

In the Information tab of the nodes properties, copy the following:
  - API key for sending data
  - VPN credentials

{{ :level2:information_tab_blurred.png?direct&600 |}}
 
Then in the WebHMI project setup enter the API key from the node's properties and set respective checkbox. 

{{ :level2:old_style_l2_integration.png?direct&600 |}}

For the VPN setup please refer to [[network_connections_setup#connecting_to_custom_vpns|this]] page. 

The Level2 node setup is given in more details in the following section.