Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Installing the Connect User Interface (UI)

...

The following steps will facilitate the installation of the Connect UI.

...

...

UI

...

.

  1. To install the Connect UI,

...

  1. download Connect 2018

...

  1. Setup (.exe).

  2. A message displays asking, "What do you want to do with connect2018_setup.exe?" You can save the file to your computer and then double-click to run the file or choose Run to start the installation.

  3. In the Welcome window, choose Install.

...

titleView image

...

  1. This will complete the Connect installation. Choose Finish

Expand

Image Removed

  1. Launch Connect by double-clicking the Connect 2018 icon on the desktop.

  2. The Connect login window displays. A license must be requested via an existing user with licensing authority. An email will be sent to the new user's email address containing a temporary password. The new user may then change the provided password. 

Expand

Image Removed

  1. Open Connect after receiving the email.

  2. Enter username and temporary password. 

...

Expand

Image Removed

...

Download the Users training guide.

...

...

To create a new user

Choose the drop-down arrow to the far right of the menu bar. 

Expand

Image Removed

Choose Edit Users/Roles

Expand

Image Removed

...

Enter the Email Address of the user you are creating. 

Note
titleNote

Each user must have a unique email address.

Choose OK

Expand

Image Removed

...

In the Edit User window, enter the Name and choose the Role for the user. 

Expand

Image Removed

Info

...

The Admin User role is the only installed role. For information on about roles, see [ Working with roles .

...

After the user is created, a success window displays. Choose OK

Expand

Image Removed

The user needs to check their email inbox for an email containing their temporary password. 

Expand

Image Removed

...

...

The assumption is that the new user has installed Connect.

...

  1. In the Login window, choose Forgot Password.

Image Removed

  1. Choose Yes in the confirmation window.

Image Removed

  1. Choose OK in the success window.

Image Removed
Note: A message displays if the email address is not found in the database.
Image Removed

  1. Follow the steps in [ New_user_login_and_password_change .

...

Image Removed

Download the Roles training guide.

 
Sections within this topic:

  • [ Creating a role
  • [ Editing a role
  • [ Deleting a role
  • [ Applying a role to an object
  • [ Object role application rules

...

To create a role:

  1. Choose the drop-down arrow to the far right of the menu bar.

Image Removed

  1. Choose Edit Users/Roles.

Image Removed

  1. In the Users and Roles window, in the Roles tab, choose Add.  

Image Removed

  1. In the Edit Role window, enter the Name of the role you are creating.

Image Removed

  1. The Expires date defaults to one year from the current date, however you can edit this date.  When the role expires, the user will no longer have access to Connect.
  2. Under the Permissions section, choose the permissions that users assigned to this role will have.

Image Removed
Note: If you have several check boxes to mark, choose the Admin check box to mark all of the check boxes and then remove the marks you don't need.

  1. Choose OK.

...

To edit a role:

  1. Choose the drop-down arrow to the far right of the menu bar.

Image Removed

  1. Choose Edit Users/Roles.

Image Removed

  1. In the Users and Roles window, in the Roles tab, choose a role and then choose Edit.  

Image Removed

  1. In the Edit Role window, you can edit name, expiration date, and/or permissions.

Image Removed

  1. Choose OK.

...

To delete a role:

  1. Choose the drop-down arrow to the far right of the menu bar.

Image Removed

  1. Choose Edit Users/Roles.

Image Removed

  1. In the Users and Roles window, in the Roles tab, choose a role and then choose Delete.Users assigned to this role will not have log in Connect.

Image Removed

  1. Choose Yes in the confirmation window.
  2. Choose OK.

...

Roles can be applied to objects to limit a specific set of objects/devices to users who have been assigned to the same role. Users with the Admin role will be able to see all of the objects. Multiple roles may be applied to objects. The [ Object role application rules table indicates if roles may be applied at the top level and the inheritance (if any) to children.
Image Removed
To apply a role to an object:
In this example, a role is applied to a Site.

  1. Choose the Configuration Explorer Image Removed icon, and then expand Campuses and then expand the campus name.  
  2. Right-click on the Site name.

Image Removed

  1. Choose Edit Roles.
  2. In the Object Role Editor, mark/unmark the Can Read and/or Can Edit check boxes next to the roles.

Image Removed
Note: Your user role will not be visible.

  1. Choose OK. All Areas beneath this Site will have the same roles applied.
  2. If you apply roles to a level above the Site, a message asks if it is okay to apply the changes to all of the selected objects, which are the children beneath the object that is selected based on the rules defined in the [ Object role application rules table.
  • Choose Yes and the children beneath this level will be updated to the roles applied at this level.
  • Choose No to return to the Object Role Editor and then choose Cancel to close the window.

...

There are different rules for the top-level objects and how (or if) a role affects the object's children.
Image Removed
 

Object

Apply to Top-Level

Inheritance to children

Additional information

Agents

Yes

All children

A role applied at any level is applied to children.

AutoReports

No

N/A

Roles cannot be applied to any children.

Campuses (Sites, Areas)

Yes

All children

A role applied at any level is applied to children

Energy

No

Inheritance depth is one level.

A role applied to sub-level 1 is applied to sub-level 2, but not to sub-level 2 children.

Profiles

No

Inheritance depth is one level.

A role applied to sub-level 1 is applied to sub-level 2, but not to sub-level 2 children.

Reports

No

No

Roles may only be applied to reports.
Note: You can apply the role to a folder, but users won't see any reports unless the report also has the role applied.

Watchdogs

No

Inheritance depth is one level.

A role applied to sub-level 1 is also applied to sub-level 2, but not to sub-level 2 children.

 
 
 

...

  1. Choose the Configuration Explorer Image Removed icon, and then choose Agents on the tree on the left-hand pane.

Image Removed

  1. You can either choose the New Agent Image Removed icon or you can right-click on the Agents folder and then choose New Agent.

...

  • [ General Settings
  • [ Tags
  • [ Metadata
  • [ Statistics
  • [ Event Log
  • [ Comm Alerts
  • [ Remote Tunneling
  • [ Location & Energy
  • [ Signature Settings

...

  1. On the General Settings tab, enter the Name and Description (optional) of the Agent.

Image Removed

  1. You can choose the Site for the agent by choosing Browse. Choose the site and then choose OK. You can also assign the Site later.

Note: A Site can also be created on-the-fly when assigning a Site to an Agent.

  1. Choose the Connection Type and choose Edit.
  2. In the Connection Settings window, enter the settings as defined in [ Scanning BAS Networks .
  3. Choose OK in the Edit Agent window to close the window.See [ Licensing the Mini Agent to license the agent.

...

Tags are used for additional miscellaneous identification.  A device may have a tag of 'first floor' or 'Area A'.  

...

Metadata is similar to tags, but contains a key (name) and a value. This can be used in reports.  For example, a VAV box might have a metadata for the 'BoxSize', and a value of 10.  

...

The Statistics tab is used to view the count of devices, objects, and trends for this agent. You can also view the overall performance.

...

The Event Log tab allows you to monitor events related to this agent.

...

  1. Choose the Comm Alerts tab to enable/disable communication alerts. You can set this up so that the recipients receive an email notification based on when:
    • Hourly Average PPM is less than xx.
    • Hourly comm errors are above xx.
    • Average Load % is above xx.
  2. Choose the Signature Settings tab to enter the Signature Agent Access Key

Remote tunneling

See [ Remote tunneling .
 

...

Image Removed

Download the Licensing the MiniAgent training guide.

 

  1. In Connect, choose the drop-down arrow located to the right of the menu Image Removed icon, and then choose Mini Agent Licensing.

Image Removed

  1. In the Mini Agent Licenses window, choose the agent and then choose Assign Mini Agent.

Image Removed

  1. In the Agent License Request window, choose Lookup to the right of Serial #.

 
Image Removed

  1. Enter the first 5 digits of the agent's serial number and then choose OK.
  2. Enter the following:

Image Removed

    • Job name
    • Zip Code
    • Misc. Notes
  1. Choose Send now.

...

Assuming the network has internet access, DHCP enabled, and outbound ports open (see IT documentation), the following steps should allow the Mini Agent to reside on the BAS network and communicate directly with the KEY2ACT servers. If the following steps do not automatically turn the globe blue on the Connect UI, you may need to [ assign a static IP address .

  1. Follow the steps in [ Creating an agent .
  2. Plug Mini Agent into power source (120V).
  3. Locate network drop to connect the Mini Agent to the BAS network via Ethernet.
  4. Verify that the Agent connects to the KEY2ACT servers (when the globe turns blue) on the Connect UI.
  5. Once the Agent is connected, proceed to [ Scanning BAS networks section.

...

When you are on the Connect Home page, you can switch views to hide or display campuses. When a campus is hidden, you will see all your agents in the Agent Name column. With the campuses shown, agents are displayed beneath the campus their site is located.
Campuses off - Show Campuses button displayed
Image Removed
Campuses on - Hide Campuses button displayed
Image Removed

...

In some BAS networks, DHCP is not enabled and the Mini Agent will not be able to [ automatically be assigned an IP address . In this situation, a static IP address will need to be assigned to the Mini Agent.

  1. Connect PC, phone or tablet to Connect Mini Agent Wi-Fi hotspot.
  2. Enter the Wi-Fi password: c0nnecT7
  3. Open Browser on device.
  4. Go to 192.168.7.1:57000
  5. Enter the password: c0nnecT7
  6. Go to settings.
  7. Enter the IP address, subnet mask, and default gateway found in [ Obtaining IP information from BAS network .

...

  1. Plug the PC into the network drop for the Mini Agent.
  2. Choose Check Network Status.

Image Removed

  1. The Connect server port is auto-selected.

Image Removed

  1. Choose Check Network Settings.
  2. Note the statuses of each of the ports. An icon displays to the right of each Connect port.

Image Removed

  1. Verify the PC successfully obtained an IP address on the same subnet as the BAS.

...

Download the Installing and Licensing the UI User training guide.