First Time Startup - 2.1.6

Description:
How to connect to the Hub for the first time from the Desktop and install a Service.
Created:
2/22/2017 8:03:10 PM
Last Updated:
2/27/2017 6:19:18 AM

new

The following document will walk you through one of the simplest installation scenarios: starting up the Hub, Agent and a Service on the same machine that has NodeCode Studio installed.

 

The first step is to install NodeCode onto a Windows 7 - Windows 10 machine.

Downloads

First Time Install

 

After installation, you should have three NodeCode icons on your desktop.

 

You can find out a bit more about the different installed components in the NodeCode overview.

Overview

 

Start the following components in this order.

 

Hub

 

The first time that the Hub is started, it will need to create the small database that will be used to store the state of Agents and Services. Once you see 'Hub Started!' on the console, the Hub is finished setting itself up.

 

Keep in mind that there should only ever be one Hub running on a network.

 

Agent

 

The Agent will listen for the beacons sent out by the Hub and will automatically connect to it.  Once the Agent is running, we can start adding Services to the device it is running on (in this case it will be the same device).

 

NodeCode Studio

 

NodeCode Studio is the visual front end to your Hubs.  You can manage everything on any network in which a Hub is running with one instance of NodeCode Studio.

 

This is where you will spend most of your time using NodeCode.

 

The first time you start NC Studio, it will look bare.  This is because we've not yet connected to our Hub and added Services, Programs and Views.

 

Let's connect to the Hub now and get started! 

 

The first screen that we see in NodeCode Studio is the list of Hubs that we can connect to. This servces as a sort of list of bookmarks that point to known Hubs.

 

Since this is the first time that NodeCode has been started, we will not see any Hubs. Let's fix that!

 

 

Empty Hub List

  

 

To connect to the Hub, we only need provide the address of the Hub and a friendly name to save it with.

 

We can do this manually by clicking on the blue '+' button or we can do this automatically by clicking on the orange search button.  The search works by waiting for a Hub to annouce it's self and then getting the information directly from the Hub.

 

Let's click on the Scan button... you will see the magnifying glass turn into a stop sign while the scan is in progress.  You can cancel at anytime..

 

Add Buttons

If you wanted to manually add the Hub and since this is a simple exaple the Hub is running on the same machine as NC Studio, you can use the shortcut 'localhost' as the address (wss://localhost:53125).  If you are connecting from another machine, you can substitute 'localhost' with the IP address of the machine that the Hub is running on.

 

NodeCode Hubs create a new certficate when they are installed. Every Hub that has ever run has had a different certificate so that there is no way to hack all NodeCode users at the same time. It is a security feature that has been built in since day one and we've put a lot of effort into not letting that complicate things too much.  If you are on the same network, you can download the certificate from the Hub.  If you are outside of your network, you won't be able to get the certificate using this method. You would have to use a thumb drive or some other mechanism to copy the public certificate.

 

This certificate error screen with the option to download the Hub's certificate will automatically be shown if there is a certificate error. There will always be a certificate error on the first connection to the Hub as the NC Studio doesn't have the certificate yet.

 

CertificateScreen

 

 

Click 'Download' to get the Certificates.

 

You should be able to connect and login immediately after that.

 

 Quick Note on Login:

 For the free version of NodeCode, you can log into the Hub using the default 'nodecode' username and password however you won't be able to have more than one user or adjust permissions on who can see the different Agents, Services and Nodes.

 

You should only have to login once, if at all, and you won't be bothered with the login screen again for each node.

When connected, and logged in, you will see the following screen for the Hub:

 

HubView 

 

This is the Hub View that functions as a dashboard and quick link page to the other components. 

 

When you start this for the first time, all of the counts will be at 0, except for Agents (now Devices) which should be 1 since we started the Agent on this machine.

 

You can click on the large cards in on the Hub to drill down to another layer of NodeCode - for this simple example, you can click on Agents card to view the Agent that is running on the same machine as the UI.

 

The next time you open NC Studio, it will auto connect to the Hubs that are saved and you can go straight into programming your Nodes or interacting with your programs.

 

Let's start by creating a simple, starter program to get your feet wet with some more of the NodeCode ideas and terminology.

 

Up next: NodeCode Programs

 

Back to List