Getting Started with JMcloud

This chapter help users to start working with JMcloud introducing basic concepts related to JMcloud. In this chapter you’will learn to:

• Login to JMcloud
• Create users with different roles/permissions
• Register new devices and connect it to JMcloud
• Connect to the devices

Requirements

We assume that those reading this chapter have a basic understanding of PCs, Microsoft Windows, JMobile Suite and the type of network environment in which you will run the application.

We assume also that JMcloud service provider has already provide to you a domain (called organization in JMcloud) and an account administrator for it that allows you to access to JMcloud for registering users and devices.

Account administrator (superuser with full control of domain/organization):

• Organization: domain.com
• Username: admin@domin.com
• Password: mypass2015$

We assume you’ve already follow instuctions reported in this manual to install JMcloud Connect into the workstation (used for supervision) and the HMI Cloud Enabler into one of your HMIs (used for connecting it to JMcloud).

HMI Cloud Enabler require that a BSP >= 1.89 is installed into the HMI device.

HMI Cloud Enabler is part of JMobile Suite starting from v1.91.00.432.

Connecting to JMcloud

To connect to JMcloud proceed as follow:

1. Open JMcloud Connect
2. Introduce your account administrator credentials:

• Username: admin@domain.com
• Password: mypass2015$

3. If you’re in a network where a proxy is used (to access to internet), use tab Advanced of JMcloud Connect for configuring it.
4. Click on Sign In to connect to JMcloud.
5. Wait few seconds until connection is established.

As account administrator, all main tabs appears once connected to JMcloud. Tabs visibles are: Connections, Users, Devices, Applications and Organizations.

Change your password

For security reasons, it’s important default password provide by service provider is changed first time you access to the JMcloud before you start registering any device and user. To change your password proceed as follow:

1. Once connected to JMcloud, on the top right appears the Settings link. Click it to open the dialog.
2. Click on tab User Information
3. Type in Old password your current password (mypass2015$ in this example)
4. Type in New password and Confirm password your new password
5. Click on Change password to confirm and save
6. Close dialog
7. Logout using Logout link on the top right of the main window
8. Login again to confirm new password is working and secured as expected.

Register a new device to JMcloud

In this section user is guide to register a new device (an HMI in this example) into JMcloud. This section assume HMI Cloud Enabler has been already installed into the HMI, if not ref. to previous chapters for installing it into the HMI.

To register a new device proceed as follow:

1. Connect to JMcloud using JMcloud Connect as account administrator (admin@domain.com in this example).
2. Open Tab Devices.
3. Click on Add gateway to add a new gateway (the gateway in this example is the device, the HMI with installed the HMI Cloud Enabler software).
4. A form with all settings for the gateway appears.
5. Introduce following settings:

• Name: mydevice1 (this is the name of the device we’ll use in this example)
• Password: mydevice2015$
• Organization: domain.com
• Description: This is my first gateway registered (this text is free and will be visible later for users)

6. Open the Endpoints Tab (here user can define the list of devices accessible through the gateway).
7. In Maximum number of endpoints set value to 14 (this means that current device will expose up to 14 devices connected to it).
8. Click on Add row to add gateway itself as endpoint (because when an HMI is used as a gateway, to make it accessible must be exposed as an endpoint).
9. Introduce following settings for endpoint (and leaves the others as default):

• Name: myendpoint1
• IP Address: 127.0.0.1
• Description: This is my first endpoint registered

Now is possibile (if wish) to add also other endpoints (ex. a PLC in LAN with HMI if it’s required to expose also it to JMcloud). In this case specify the device name (Name) and it’s IP Address (IP Address) where IP Address is the LAN IP of endpoint.

10. Click on Add to save all and close configuration form.
11. As result, table of devices is updated reporting the new device.

Connect device to JMcloud

1. Install the HMI Cloud Enabler into your HMI (following instuctions reported in previous chapters).
2. Open the HMI Cloud Enabler (following instuctions reported in previous chapters).
3. Open security tab (the second tab, the padlock icon) and introduce following:

• Username: mydevice1@domain.com (name of the gateway registered followed by @organization)
• Password: mydevice2015$ (password of the gateway defined before)
• Remember credentials checked

4. Open the configuration tab (the third tab, the gear icon) and introduce following:

• Auto start at boot: Checked (to force autostart of connection at boot and avoid manual reconnection)
• Sub networks: select it if other endpoints (apart 127.0.0.1) has been defined for this gateway (ex. a PLC in LAN with HMI)

5. Return back to the connection tab (the world icon)
6. Click on Enable Remote Control if you wish to enable remote visualization and control of the Gateway (HMI). When enabled appear in orange.
7. Click on VPN to start connection to the server

Wait few seconds, when connection is established the VPN button will apprear in orange.

Create new users and grant access to your devices

Account administrator (superuser) has full access to JMcloud limited to own organization (domain.com) and sub organizations of it. However, usually is required to define users restricted in permissions compared to the Account administrator. In this example we’ll create two new users:

• regular@domain.com, a user able just to connect to the endpoints (devices) specified, not to manage it
• manager@domain.com, a user able to manage users/devices specified

For simplicity in this example will not be used groups, however, it’s always recommend to organize users & devices in groups and link groups of users with groups of devices, not directly users to devices because complicate maintenance (when many users and devices are there).

To create regular@domain.com, proceed as follow:

1. Connect to JMcloud Connect as account administrator (admin@domain.com in this example)
2. Open tab Users.
3. Click on Add user* and introduce following:

• Name regular
• Password regular2015$
• Organization domain.com
• Description This is a regular user

4. Open tab Permissions
5. Select regular user of
6. Click on gateway: mydevice1@domain.com to grant to user permission to the device
7. Click on Add to save new user configuration.

To create manager@domain.com, proceed as before but replacing regular user of with manager of in tab Permissions.

Connect to JMcloud as regular user or as manager

A regular user like regular@domain.com or a manager like manager@domain.com registered in previous chapter, can access to JMcloud using JMcloud Connect. To connect to JMcloud, use regular@domain.com as Username into the Log In form of JMcloud Connect.

Once connected, based on permissions, just a subsets of tabs will be shown.

• regular@domain.com can see tab Connection tab.
• manager@domain can see tabs Connections, Devices

From Connection tab, user can connect to devices (end points) registered that will appears in this page. Click on Connect icon in Action column to established a connection to the endpoint (device). Click again to the same icon later to disconnect it if needed.

The IP shown on each endpoint is a VPN IP that can be used to access to the device using tools like JMobile. Endpoint VPN IP is also reachable with a simple ping VPN_IP from JMcloud Connect workstation.

Warning

JMcloud does not support broadcasting. Services like JMobile HMIs autodiscovery so are not working. Type VPN IP manually to reach the device.