link start!

This commit is contained in:
cherubin
2026-03-17 13:31:18 -07:00
commit 08abe87cfb
5910 changed files with 386288 additions and 0 deletions
+59
View File
@@ -0,0 +1,59 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Learning More</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="up" href="NavigationTips.html" title="Tips on Navigating the Demo">
<link rel="prev" href="NavigationTips.html" title="Tips on Navigating the Demo">
<link rel="next" href="StoppingDemoStation.html" title="Stopping the Demo Station">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="NavigationTips.html">Prev</a> |
<a href="StoppingDemoStation.html">Next</a>
</p>
<div class="section" lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name="LearningMore"></a>Learning More
</h3>
</div>
</div>
</div>
<p>To learn more about NiagaraAX, see the online Help. To learn more about features of Workbench, see the <em class="citetitle">User Guide</em> sections &#8220;<a href="module://docUser/doc/aWorkbench.html">About Workbench</a>&#8221; and &#8220;<a href="module://docUser/doc/aTourWorkbenchGUI.html">Tour of the Workbench GUI</a>.&#8221;
</p>
<p>For details about SSL and NiagaraAX, see the <a href="module://docSSL/doc/index.html"><em class="citetitle">NiagaraAX SSL Connectivity Guide</em></a>.
</p><a name="d0e525"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">Please understand that NiagaraAX Help evolves as a &#8220;work in progress,&#8221; with many topics still placeholders (or with minimal
details). However, we are committed to delivering a consistent, unified, Help system to lessen the need for printed documents
(PDFs). Furthermore, as PDFs about NiagaraAX become available, they will reflect the same source content as found in the online
Help.
</p>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="NavigationTips.html">Prev</a> |
<a href="StoppingDemoStation.html">Next</a>
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>
+79
View File
@@ -0,0 +1,79 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Tips on Navigating the Demo</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="up" href="index.html" title="Demo Quick Start">
<link rel="prev" href="StartDemo.html" title="Get the Demo Up and Running">
<link rel="next" href="LearningMore.html" title="Learning More">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="StartDemo.html">Prev</a> |
<a href="LearningMore.html">Next</a>
</p>
<div class="section" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a name="NavigationTips"></a>Tips on Navigating the Demo
</h2>
</div>
</div>
</div>
<p>Consider the Workbench GUI as the NiagaraAX &#8220;super browser,&#8221; combined with other familiar Windows-like applications (e.g.
Windows Explorer).
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata2626.png"><br></div>
</div>
<p>On the toolbar, use the <span class="guibutton">Back</span> and <span class="guibutton">Forward</span> buttons to retrace or advance your steps. Both of these buttons offer a &#8220;visited&#8221; drop-down menu.
</p>
<p>Also, an <span class="guibutton">Up Level</span> button is available when you are at some child level, say under a station&#8217;s Config node (also with its own drop-down menu).
</p>
<p>Instead of a normal &#8220;text-only&#8221; URL address bar, Workbench has a graphical <span class="guimenu">locator bar</span>.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata2727.png"><br></div>
</div>
<p>As shown above, the locator bar displays not only the full path of the item in view, but also features a drop-down menu (at
every level) that lists immediate child items.
</p>
<p>The right-side of the locator bar is the <span class="guimenu">view selector</span>, another drop-down menu that lists all available views for the item currently shown in the view pane.
</p>
<p>Right-click menus are woven throughout the Workbench interface, both in the sidebar (Nav tree, by default) as well as in main
views.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata2828.png"><br></div>
</div><a name="d0e502"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24"> Often, multiple ways exist to perform the same operations, either working in the sidebar (e.g. Tree), main view, or from
the menu bar or toolbar. For example, this document provides mostly &#8220;right-click instructions&#8221;.
</p>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="StartDemo.html">Prev</a> |
<a href="LearningMore.html">Next</a>
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>
+60
View File
@@ -0,0 +1,60 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Tree not visible</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="up" href="TroubleshootingDemo.html" title="Troubleshooting the Demo">
<link rel="prev" href="TroubleshootingDemo.html" title="Troubleshooting the Demo">
<link rel="next" href="OpenPlatformIssues.html" title="Cannot open Platform">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="TroubleshootingDemo.html">Prev</a> |
<a href="OpenPlatformIssues.html">Next</a>
</p>
<div class="section" lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name="NoNavTree"></a>Tree not visible
</h3>
</div>
</div>
</div>
<p>Symptom: Workbench starts up <span class="emphasis"><em>without</em></span> the left-side tree (<span class="guilabel">Nav</span> tree in side bar area), showing only a single pane with view. This occurs if Workbench was last used with side bars &#8220;not
shown.&#8221;
</p>
<p>To fix this, from the menu bar, select <span class="guimenu">Window</span>-&gt;<span class="guisubmenu">Side Bars</span>-&gt;<span class="guimenuitem">Show Side Bar</span></p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata3535.png"><br></div>
</div>
<p>It is also possible that the side bar area is visible, but the <span class="guilabel">Nav</span> tree does not show. In this case, select <span class="guimenu">Window</span>-&gt;<span class="guisubmenu">Side Bars</span>-&gt;<span class="guimenuitem">Nav</span></p><a name="d0e670"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24"> From the <span class="guimenu">Window</span><span class="guisubmenu">Side Bars</span> menu, <span class="emphasis"><em>additional</em></span> items are selectable to see in the left pane (sidebar).
</p>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="TroubleshootingDemo.html">Prev</a> |
<a href="OpenPlatformIssues.html">Next</a>
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>
+60
View File
@@ -0,0 +1,60 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Stations missing in Application Director</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="up" href="TroubleshootingDemo.html" title="Troubleshooting the Demo">
<link rel="prev" href="OpenPlatformIssues.html" title="Cannot open Platform">
<link rel="next" href="OpenStationIssue.html" title="Cannot open Station">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="OpenPlatformIssues.html">Prev</a> |
<a href="OpenStationIssue.html">Next</a>
</p>
<div class="section" lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name="NoStationsInAppDirector"></a>Stations missing in Application Director
</h3>
</div>
</div>
</div>
<p>Symptom: After opening a local Platform connection and accessing the <span class="guilabel">Application Director</span>, you do not see any stations listed&#8212;including the demo station. This may occur if Workbench is being run in a small sized
window (similar to one used in screen captures in this document).
</p>
<p>To fix this, drag (click and hold) <span class="emphasis"><em>downwards</em></span> on the divider at the top of the <span class="guilabel">Application Director</span> view.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata3939.png"><br></div>
</div>
<p>Release after you see stations listed&#8212;for example the demo station.</p>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="OpenPlatformIssues.html">Prev</a> |
<a href="OpenStationIssue.html">Next</a>
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>
+84
View File
@@ -0,0 +1,84 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Cannot open Platform</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="up" href="TroubleshootingDemo.html" title="Troubleshooting the Demo">
<link rel="prev" href="NoNavTree.html" title="Tree not visible">
<link rel="next" href="NoStationsInAppDirector.html" title="Stations missing in Application Director">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="NoNavTree.html">Prev</a> |
<a href="NoStationsInAppDirector.html">Next</a>
</p>
<div class="section" lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name="OpenPlatformIssues"></a>Cannot open Platform
</h3>
</div>
</div>
</div>
<p>Symptom: Authentication dialog keeps reappearing after you click <span class="guibutton">OK</span>.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata3636.png"><br></div>
</div>
<p>Cause: Typically, using the default platform &#8220;Basic authentication&#8221;, your entered username and password do <span class="emphasis"><em>not match</em></span> a local user who is a member of the local Windows machine&#8217;s Administrators group.
</p>
<p>To fix: Confirm Windows administrator privileges for the PC, then re-enter your Windows credentials.</p>
<p>Symptom: Nothing happens for a few seconds, and &#8220;Cannot display page&#8221; appears in the view.
Text &#8220;Cannot connect. Ensure server is running on specified port&#8221; displays.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata3737.png"><br></div>
</div>
<p>Cause: The Niagara Platform Daemon (service) is not running on your PC. This occurs if in the last NiagaraAX installation
step, you unchecked &#8220;Install and Start Platform Daemon&#8221;. The platform daemon (service) is needed for local platform/station
operations.
</p>
<p>To fix: Install the platform daemon and retry connection (next).</p>
<div class="procedure"><a name="pInstallPlatformDaemon"></a><ol type="1">
<li>
<p>From the Windows Start menu, select:</p>
<p><span class="guimenu">Start</span>-&gt;<span class="guisubmenu">All Programs</span>-&gt;<span class="guisubmenu">Niagara 3.8.<em class="replaceable"><code>nn</code></em></span>-&gt;<span class="guimenuitem">Install Platform Daemon</span></p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata3838.png"><br></div>
</div>
</li>
<li>
<p>In Workbench, retry &#8220;Open Platform&#8221; to your host (See Step 2 in <a href="StartDemo.html">Get the Demo Up and Running</a>).
</p>
</li>
</ol>
</div>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="NoNavTree.html">Prev</a> |
<a href="NoStationsInAppDirector.html">Next</a>
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>
+74
View File
@@ -0,0 +1,74 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Cannot open Station</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="up" href="TroubleshootingDemo.html" title="Troubleshooting the Demo">
<link rel="prev" href="NoStationsInAppDirector.html" title="Stations missing in Application Director">
<link rel="next" href="aDemoStationSecurityNotes.html" title="Demo stations security notes">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="NoStationsInAppDirector.html">Prev</a> |
<a href="aDemoStationSecurityNotes.html">Next</a>
</p>
<div class="section" lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name="OpenStationIssue"></a>Cannot open Station
</h3>
</div>
</div>
</div>
<p>Symptom: Authentication dialog keeps reappearing when you click <span class="guibutton">OK</span>.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata4040.png"><br></div>
</div>
<p>Likely cause: Username and password do <span class="emphasis"><em>not match</em></span> the station&#8217;s stored credentials for the admin user.
</p>
<div class="itemizedlist">
<ul>
<li>
<p>Username: <code class="literal">admin</code></p>
</li>
<li>
<p>Password: <em class="replaceable"><code>type the password entered in the last &#8220;Reset Password&#8221; popup dialog for user admin, or else the password changed for the admin
user from another station view, such as the User Manager.</code></em></p>
</li>
</ul>
</div>
<p>To fix: Re-enter login credentials last used to access the station as user admin.</p><a name="d0e787"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">If the demo station&#8217;s admin account password has never been changed, you can leave the Password field blank (empty). This
produces the &#8220;Reset Password&#8221; dialog to change this password. See Step 8 in <a href="StartDemo.html">Get the Demo Up and Running</a>.In some cases where the demo station has been previously accessed and configured, the well-known admin user may have been
deliberately <span class="emphasis"><em>disabled</em></span>, and some other &#8220;super user&#8221; created or enabled in place. In this scenario, login using the credentials (Username and Password)
for that user instead.See <a href="aDemoStationSecurityNotes.html" title="Demo stations security notes"><i>Demo stations security notes</i></a>.
</p>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="NoStationsInAppDirector.html">Prev</a> |
<a href="aDemoStationSecurityNotes.html">Next</a>
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>
+197
View File
@@ -0,0 +1,197 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Get the Demo Up and Running</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="up" href="index.html" title="Demo Quick Start">
<link rel="prev" href="index.html" title="Demo Quick Start">
<link rel="next" href="NavigationTips.html" title="Tips on Navigating the Demo">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="index.html">Prev</a> |
<a href="NavigationTips.html">Next</a>
</p>
<div class="section" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a name="StartDemo"></a>Get the Demo Up and Running
</h2>
</div>
</div>
</div>
<div class="procedure"><a name="pStartDemo"></a><ol type="1">
<li>
<p>Start Workbench.</p>
<p>Your host PC appears in the Nav tree (<span class="guilabel">My Host</span> in left pane).
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata11.png"><br></div>
</div><a name="d0e79"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">If you don&#8217;t see the Nav tree, turn on &#8220;side bars.&#8221; See <a href="NoNavTree.html">Tree Not Visible</a>.
</p>
</li>
<li><a name="step2openHost"></a><p>Right-click your host in the Nav tree.</p>
<p>From the popup menu, click: <span class="guimenuitem">Open Platform</span>.
A <span class="guilabel">Connect</span> popup appears, typically with Type set to <span class="inlinemediaobject"><img src="images/imagedata22.png"></span><span class="guilabel">Platform SSL Connection</span></p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata33.png"><br></div>
</div>
<p>In the <span class="inlinemediaobject"><img src="images/imagedata44.png"></span><span class="guilabel">Connect</span> popup (above), click <span class="guibutton">OK</span>.
</p>
</li>
<li><a name="BEJIEFEI"></a><p>In the <span class="guilabel">Authentication</span> popup, type your Windows <span class="emphasis"><em>administrator-level</em></span> username and password.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata55.png"><br></div>
</div><a name="d0e130"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">If you click the &#8220;Remember these credentials&#8221; checkbox, future access of the Platform node will authenticate without re-entering
credentials (Username and Password). Prior to AX-3.7 (and 2013 security updates), this was set by default. However, now this
is cleared by default&#8212;you must set it, if desired.
</p>
<p>Click <span class="guibutton">OK</span>.
</p>
<p>The <span class="emphasis"><em>first time</em></span> you open your platform with SSL, a popup <span class="guilabel">Identity Verification</span> warning appears.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata66.png"><br></div>
</div>
<p>Click <span class="guibutton">Accept</span>. This creates an &#8220;allowed hosts&#8221; certificate exemption for Workbench on this port (5011, if using defaults). For related
details, see <a href="aNewWorkbenchSSLcertificates.html" title="SSL and certificate notes in AX-3.8"><i>SSL and certificate notes in AX-3.8</i></a>.
</p><a name="d0e157"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">If connect <span class="emphasis"><em>Type</em></span> was changed from <span class="inlinemediaobject"><img src="images/imagedata77.png"></span><span class="guilabel">Platform SSL Connection</span> to <span class="inlinemediaobject"><img src="images/imagedata88.png"></span><span class="guilabel">Platform Connection</span> (in the <span class="guilabel">Connect</span> popup shown in Step 2 above), such a warning does not appear. It also does not appear again (after accepting it) in future local platform SSL connections&#8212;at
least for the duration of this certificate.
</p>
<p>Various platform views are listed in the right-side View pane. In the Nav tree, if you expand My Host you now see a Platform
node.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata99.png"><br></div>
</div><a name="d0e188"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">If your Platform does not open, it may be a host login issue, or the Niagara platform daemon may be stopped. See <a href="OpenPlatformIssues.html">Cannot Open Platform</a>.
</p>
</li>
<li><a name="step2StationDirector"></a><p>In the view pane, double-click the <span class="guimenuitem">Application Director</span>.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata1010.png"><br></div>
</div>
<p>The Application Director appears in the view and lists available stations.</p>
<p>The demo station appears with a status of &#8220;Idle.&#8221;</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata1111.png"><br></div>
</div><a name="d0e211"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">If no stations list, a divider may need moving. See <a href="NoStationsInAppDirector.html">Tree Not Visible</a>.
</p>
</li>
<li>
<p>Right-click the demo station in the Application Director.</p>
<p>From the popup menu, click <span class="guimenuitem">Start</span> (or, with the demo station selected, click the <span class="emphasis"><em>right-side</em></span> <span class="guibutton">Start</span> button).
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata1212.png"><br></div>
</div>
<p>The demo status changes to &#8220;Starting,&#8221; and messages start appearing in the view.</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata1313.png"><br></div>
</div>
<p>After several seconds, the demo station status changes to &#8220;Running.&#8221;</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata1414.png"><br></div>
</div>
</li>
<li><a name="step6openStation"></a><p>Right-click your host again in the Nav tree.</p>
<p>From the popup menu, click:<span class="guimenuitem"> Open Station</span></p>
<p>A <span class="guilabel">Connect</span> popup appears, typically with Type set to <span class="inlinemediaobject"><img src="images/imagedata1515.png"></span><span class="guilabel">Station SSL Connection</span></p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata1616.png"><br></div>
</div>
<p>In the <span class="inlinemediaobject"><img src="images/imagedata1717.png"></span><span class="guilabel">Connect</span> popup (above), click <span class="guibutton">OK</span>.
</p>
<p>The <span class="emphasis"><em>first time</em></span> you open your station with SSL, a popup <span class="guilabel">Identity Verification</span> warning appears.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata1818.png"><br></div>
</div>
<p>Click <span class="guibutton">Accept</span>. This creates an &#8220;allowed hosts&#8221; certificate exemption for Workbench on this port (4911, if using defaults). For related
details, see <a href="aNewWorkbenchSSLcertificates.html" title="SSL and certificate notes in AX-3.8"><i>SSL and certificate notes in AX-3.8</i></a>.
</p><a name="d0e299"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">If connect <span class="emphasis"><em>Type</em></span> was changed from <span class="inlinemediaobject"><img src="images/imagedata1919.png"></span><span class="guilabel">Station SSL Connection</span> to <span class="inlinemediaobject"><img src="images/imagedata2020.png"></span><span class="guilabel">Station Connection</span> (in the <span class="guilabel">Connect</span> popup shown in Step 6 above), such a warning does not appear. It also does not appear again (after accepting it) in future local SSL connections to this
station&#8212;at least for the duration of this certificate.
</p>
</li>
<li>
<p>An <span class="guilabel">Authentication</span> popup appears (here, you login using a <span class="emphasis"><em>station</em></span> user account).
</p>
<p>In the <span class="guilabel">Username</span> field, type <code class="literal">admin</code></p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata2121.png"><br></div>
</div>
<p>Leave <span class="guilabel">Password</span> blank <span class="emphasis"><em>(for just this one time)</em></span>, and click <span class="guibutton">OK</span>.
</p>
<p>A &#8220;Reset Password&#8221; popup dialog appears.</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata2222.png"><br></div>
</div><a name="d0e361"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">This &#8220;Reset Password&#8221; request occurs because all users in the AX-3.8 demo station have their account set to require a password
reset upon first login (a <span class="emphasis"><em>change</em></span> from the demo station in releases prior to AX-3.8).
You must enter a <span class="emphasis"><em>new password</em></span> for the admin user in the next step. For related details, see <a href="aDemoStationSecurityNotes.html" title="Demo stations security notes"><i>Demo stations security notes</i></a>.
</p>
</li>
<li><a name="BEJJFJCI"></a><p>Type a new <span class="emphasis"><em>&#8220;strong&#8221; password</em></span> in the &#8220;Password&#8221; field, and repeat it again in the second &#8220;Confirm&#8221; field.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata2323.png"><br></div>
</div><a name="d0e384"></a><p class="tip" border="0" width="24"><img src="module://docUser/doc/images/tip.png" alt="Tip" width="24" height="24">Follow the strong password rules given in the popup (note that &#8220;digit&#8221; means a numeral)<span class="emphasis"><em></em></span>. The demo station&#8217;s <span class="guilabel">User Service</span> is configured to require <span class="emphasis"><em>strong</em></span> passwords. Note that in AX-3.8, these strong password rules are also <span class="emphasis"><em>configurable</em></span>, via a &#8220;Password Configuration&#8221; component under the User Service.
</p><a name="d0e398"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">Make this password unique, and <span class="emphasis"><em>be sure to remember (or make a note of) it!</em></span>
</p>
<p>When your matching password entries meet these rules, the <span class="guibutton">OK</span> button is enabled. Click <span class="guibutton">OK</span>.
</p>
<p>Again, see the section <a href="aDemoStationSecurityNotes.html" title="Demo stations security notes"><i>Demo stations security notes</i></a>.
</p>
</li>
<li>
<p>The demo station opens in the view and appears as a node in the Tree.</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata2424.png"><br></div>
</div><a name="d0e423"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">If the &#8220;Reset Password&#8221; dialog does not appear and the station does not open, some other login issue is likely. See <a href="OpenStationIssue.html">Cannot Open Station</a>.
</p>
</li>
<li>
<p>To explore the station, just click on expand controls in the Tree to browse the station&#8217;s hierarchy. Simply <span class="emphasis"><em>double-click</em></span> on items of interest to see item contents in the view.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata2525.png"><br></div>
</div><a name="d0e438"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">The <span class="emphasis"><em>Config</em></span> node represents the actual station database, and holds components with wire sheet and property sheets views, among many other
view types.
</p>
</li>
</ol>
</div>
<p>See <a href="NavigationTips.html">Tips on Navigating the Demo</a> for <span class="emphasis"><em>some</em></span> of the many Workbench navigation features.
</p><a name="d0e451"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">You can exit Workbench without stopping the demo station, and then restart Workbench and reopen the demo again (until your
PC is rebooted). Start with Step 6 above.
If you&#8217;d rather, you can also stop the demo station first. See <a href="StoppingDemoStation.html">Stopping the Demo Station</a> for more details.
</p>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="index.html">Prev</a> |
<a href="NavigationTips.html">Next</a>
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>
+100
View File
@@ -0,0 +1,100 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Stopping the Demo Station</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="up" href="index.html" title="Demo Quick Start">
<link rel="prev" href="LearningMore.html" title="Learning More">
<link rel="next" href="TroubleshootingDemo.html" title="Troubleshooting the Demo">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="LearningMore.html">Prev</a> |
<a href="TroubleshootingDemo.html">Next</a>
</p>
<div class="section" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a name="StoppingDemoStation"></a>Stopping the Demo Station
</h2>
</div>
</div>
</div><a name="d0e531"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">If you exited Workbench without first stopping the station, and you have not since rebooted your computer (or stopped/restarted
the Niagara platform daemon), the station remains running.
</p>
<div class="procedure"><a name="pStopStation"></a><ol type="1">
<li>
<p>In Workbench, expand your host&#8217;s <span class="guilabel">Platform</span> in the Nav tree.
</p>
<p>Double-click the <span class="guilabel">Application Director</span>.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata2929.png"><br></div>
</div>
</li>
<li>
<p>Right-click the demo station.</p>
<p>From the popup menu, click <span class="guimenuitem">Stop</span> (or, with the demo station selected, click the <span class="emphasis"><em>right-side</em></span> <span class="guibutton">Stop</span> button).
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata3030.png"><br></div>
</div>
</li>
<li>
<p>A confirmation dialog appears. Click <span class="guibutton">Yes</span>.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata3131.png"><br></div>
</div>
<p>The demo station status changes to &#8220;Stopping,&#8221; then to &#8220;Idle.&#8221; The station is now stopped. </p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata3232.png"><br></div>
</div><a name="d0e584"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">If you had the demo station opened in Workbench, notice that it is now &#8220;ghosted&#8221; and collapsed. You cannot open (connect)
to the demo again until you first <span class="emphasis"><em>start</em></span> the demo station, using this Platform view (<span class="guilabel">Application Director</span>).
</p>
</li>
<li>
<p>If finished looking at NiagaraAX, you can simply click the Windows &#8220;Close&#8221; control (X in upper right) to exit as shown, or
to exit from the menu bar, select <span class="guimenu">File</span>-&gt;<span class="guimenuitem">Exit</span>.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata3333.png"><br></div>
</div>
<p>When starting Workbench the next time, your host PC will be collapsed again in the Nav tree.
To restart the demo, expand your host in the tree and double-click the ghosted Platform, then continue from Step 3 in <a href="StartDemo.html">Get the Demo Up and Running</a>.
</p>
<div class="informalfigure">
<div class="mediaobject"><br><img src="images/imagedata3434.png"><br></div>
</div>
</li>
</ol>
</div>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="LearningMore.html">Prev</a> |
<a href="TroubleshootingDemo.html">Next</a>
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>
+68
View File
@@ -0,0 +1,68 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Troubleshooting the Demo</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="up" href="index.html" title="Demo Quick Start">
<link rel="prev" href="StoppingDemoStation.html" title="Stopping the Demo Station">
<link rel="next" href="NoNavTree.html" title="Tree not visible">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="StoppingDemoStation.html">Prev</a> |
<a href="NoNavTree.html">Next</a>
</p>
<div class="section" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a name="TroubleshootingDemo"></a>Troubleshooting the Demo
</h2>
</div>
</div>
</div>
<p>Possible demo issues are covered in the following sections:</p>
<div class="itemizedlist">
<ul>
<li>
<p><a href="NoNavTree.html">Tree Not Visible</a></p>
</li>
<li>
<p><a href="OpenPlatformIssues.html">Cannot Open Platform</a></p>
</li>
<li>
<p><a href="NoStationsInAppDirector.html">Tree Not Visible</a></p>
</li>
<li>
<p><a href="OpenStationIssue.html">Cannot Open Station</a></p>
</li>
</ul>
</div>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="StoppingDemoStation.html">Prev</a> |
<a href="NoNavTree.html">Next</a>
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>
+56
View File
@@ -0,0 +1,56 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Browser access notes</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="up" href="aNewWorkbenchSSLcertificates.html" title="SSL and certificate notes in AX-3.8">
<link rel="prev" href="aNewWorkbenchSSLcertificates.html" title="SSL and certificate notes in AX-3.8">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="aNewWorkbenchSSLcertificates.html">Prev</a> |
Next
</p>
<div class="section" lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name="aDemo38BrowserSSLaccess"></a>Browser access notes
</h3>
</div>
</div>
</div>
<p>Additionally, if you access your local AX-3.8 &#8220;demo&#8221; station using a<span class="emphasis"><em> secure web browser</em></span> connection
(https://localhost if using the default WebService &#8220;Https Port&#8221; of 443), your web browser (client) will <span class="emphasis"><em>also</em></span> issue its own certificate warning for this self-signed &#8220;<code class="literal">tridium</code>&#8221; certificate, asking if you wish to proceed. Again, proceeding should be <span class="emphasis"><em>safe</em></span> in this instance.
</p><a name="d0e1059"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">(Unrelated to SSL) If you access <span class="emphasis"><em>any</em></span> AX-3.8 station with a web browser as a user with a &#8220;Wb Web&#8221; profile, that is &#8220;Web Workbench&#8221;, in order for the Java-based
&#8220;WbApplet&#8221; to load, your browser client PC requires &#8220;unlimited strength policy files&#8221; in its Java installation. For more details,
refer to &#8220;<a href="module://doc2013SecurityUpdates/doc/pInstallingJCE_policyFiles_forWbAppletAccess.html">Additional AX-3.8 client-side Java installation steps</a>&#8221; in the latest <em class="citetitle">NiagaraAX 2013 Security Updates</em> document.
</p>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="aNewWorkbenchSSLcertificates.html">Prev</a> |
Next
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>
+96
View File
@@ -0,0 +1,96 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Demo stations security notes</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="up" href="index.html" title="Demo Quick Start">
<link rel="prev" href="OpenStationIssue.html" title="Cannot open Station">
<link rel="next" href="aNewWorkbenchSSLcertificates.html" title="SSL and certificate notes in AX-3.8">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="OpenStationIssue.html">Prev</a> |
<a href="aNewWorkbenchSSLcertificates.html">Next</a>
</p>
<div class="section" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a name="aDemoStationSecurityNotes"></a>Demo stations security notes
</h2>
</div>
</div>
</div>
<p>Station security changes were made in the AX-3.8 development cycle that affect the standard &#8220;<code class="literal">demo</code>&#8221; station typically installed with NiagaraAX Workbench (as well as the &#8220;<code class="literal">demoAppliance</code>&#8221; station). For the most part these stations remain unchanged from previous releases, meaning that the various default users,
including the &#8220;<code class="literal">admin</code>&#8221; user, still have a default &#8220;blank&#8221; (empty) password.
</p>
<p>Such users include the &#8220;<code class="literal">adminWbBasic</code>&#8221; user, &#8220;<code class="literal">adminHxDefault</code>&#8221; user, and so on&#8212;all of which are &#8220;super users&#8221;. These users exist to demonstrate different &#8220;Web Profiles&#8221; when accessing
the station via a browser. Obviously, this combination of &#8220;well known&#8221; super users, each with a default blank password, is
not a good security practice to maintain.
</p><a name="d0e823"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">For proper security in a production system, the usage of &#8220;super users&#8221; in a station should be <span class="emphasis"><em>minimized</em></span>, as explained in various NiagaraAX documents, including the <em class="citetitle">NiagaraAX Hardening Guide</em>.
</p>
<p>Note that login access of the demo station as <span class="emphasis"><em>any of these users</em></span>, either from Workbench or a browser, now prompts to <span class="emphasis"><em>reset</em></span> the password. This happens because the AX-3.8 demo station now has <span class="emphasis"><em>all station users</em></span> configured for password reset. Once a new password is entered, that super user has <span class="emphasis"><em>full access</em></span> to the station&#8212;just as the &#8220;<code class="literal">admin</code>&#8221; user has.
</p>
<p>Therefore to prevent any &#8220;unauthorized access&#8221; of a demo station, it is strongly recommended that after first accessing the
station as the <code class="literal">admin</code> user, that you do one of the following:
</p>
<div class="itemizedlist">
<ul>
<li>
<p>Change the password for each &#8220;well-known&#8221; default user (<code class="literal">adminWbBasic</code>, <code class="literal">adminFrames</code>, etc.). You can do this by double-clicking each user in the station&#8217;s <span class="guilabel">User Manager</span> view, for the <span class="guilabel">Edit</span> dialog.
</p>
<div class="itemizedlist">
<ul>
<li>
<p>Typically, you specify the same strong password that you previously entered for the admin user.</p>
</li>
<li>
<p>For each user, you also need to set the &#8220;Force Password Reset&#8221; entry from <code class="literal">true</code> to <code class="literal">false</code>.
Otherwise upon the first login as that user, the <span class="guilabel">Reset Password</span> dialog would reappear.
</p>
</li>
</ul>
</div>
<p>Make sure to <span class="guilabel">Save</span> the changes to each of these users.
</p>
</li>
<li>
<p>Disable any of these &#8220;well-known&#8221; default users, which you can also do by double-clicking each user in the station&#8217;s <span class="guilabel">User Manager</span> view. Then set the user&#8217;s Enabled property to <code class="literal">false</code>, and <span class="guibutton">Save</span>.
</p><a name="d0e903"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">Starting in AX-3.7, you can <span class="emphasis"><em>disable</em></span> the user admin&#8212;where previously you could not. However, before doing this, be sure you have at least one working &#8220;super user&#8221;
in the station.
</p>
</li>
</ul>
</div>
<p>Be sure to <span class="guibutton">Save</span> changes to the station after making user adjustments&#8212;right-click the <span class="inlinemediaobject"><img src="images/imagedata4141.png"></span> <span class="guilabel">Station</span> node in the Nav tree and select <span class="guimenuitem">Save Station</span>.
</p>
<p>For more details about station security in NiagaraAX, see &#8220;<a href="module://docUser/doc/Security.html">About Security</a>&#8221; in the <em class="citetitle">NiagaraAX User Guide</em>.
</p>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="OpenStationIssue.html">Prev</a> |
<a href="aNewWorkbenchSSLcertificates.html">Next</a>
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>
+96
View File
@@ -0,0 +1,96 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>SSL and certificate notes in AX-3.8</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="up" href="index.html" title="Demo Quick Start">
<link rel="prev" href="aDemoStationSecurityNotes.html" title="Demo stations security notes">
<link rel="next" href="aDemo38BrowserSSLaccess.html" title="Browser access notes">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="aDemoStationSecurityNotes.html">Prev</a> |
<a href="aDemo38BrowserSSLaccess.html">Next</a>
</p>
<div class="section" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a name="aNewWorkbenchSSLcertificates"></a>SSL and certificate notes in AX-3.8
</h2>
</div>
</div>
</div><a name="d0e935"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">This section explains a little more about the Workbench SSL certificate warnings seen in the section <a href="StartDemo.html">Get the Demo Up and Running</a>. Note that in AX-3.8, a few SSL-related changes were made since the releases for AX-3.7/AX-3.7u1 that affect the &#8220;demo&#8221; station,
which are also described below.
</p>
<p>It is safe to &#8220;<span class="guibutton">Accept</span>&#8221; the certificate (<span class="guibutton">Identification Verification</span>) warnings seen in Workbench when following steps in this document. However, don&#8217;t assume that always accepting similar certificates
is the correct choice. An overview with a <span class="emphasis"><em>few</em></span> background details is below. For complete details about SSL and NiagaraAX, refer to the <em class="citetitle"><a href="module://docSSL/doc/index.html">NiagaraAX SSL Connectivity Guide</a></em>.
</p>
<p>Since AX-3.7, NiagaraAX has included integral support for industry-standard Secure Socket Layer (SSLv3) and Transport Layer
Security (TLSv1) protocols, via an &#8220;SSL Toolset&#8221;. Included are Workbench tools for managing PKI (Public Key Infrastructure)
digital certificates or &#8220;self-signed&#8221; digital certificates, which are used in verifying SSL connections. When you install
NiagaraAX on your PC, a local self-signed &#8220;<code class="literal">tridium</code>&#8221; certificate is generated, and is available for (default) local SSL usage.
</p>
<div class="itemizedlist">
<ul>
<li>
<p>In AX-3.7 (and AX-3.7u1), after installing NiagaraAX on your PC, you could <span class="emphasis"><em>optionally</em></span> enable SSL for your local PC platform, by making a local platform connection and accessing the <span class="guilabel">Platform Administration</span> view. By default, the &#8220;<code class="literal">tridium</code>&#8221; certificate is presented to any Workbench client that attempts an SSL platform connection.
</p>
</li>
<li>
<p>In AX-3.8 this changed&#8212;now when you install NiagaraAX, platform SSL is <span class="emphasis"><em>automatically enabled</em></span> for you Workbench PC platform&#8212;by default using the self-signed &#8220;<code class="literal">tridium</code>&#8221; certificate. In addition, changes were made to the standard &#8220;demo&#8221; station in AX-3.8 to enable SSL for station access (&#8220;Foxs
Enabled&#8221; in the station&#8217;s Fox Service), as well as SSL for browser access (&#8220;Https Enabled&#8221; in the station&#8217;s Web Service)&#8212;again,
(by default) both reference the self-signed &#8220;<code class="literal">tridium</code>&#8221; certificate.
</p>
</li>
</ul>
</div>
<p>In either case just described, when you open the<span class="emphasis"><em> first platform SSL connection</em></span> from Workbench (the client) to your local platform daemon (a server), Workbench presents a warning &#8220;<span class="guilabel">Identity Verification</span>&#8221; popup that shows you the details of your local self-signed &#8220;<code class="literal">tridium</code>&#8221; certificate.
</p>
<div class="itemizedlist">
<ul>
<li>
<p>If you <span class="guibutton">Accept</span>, an &#8220;allowed host&#8221; exemption is created for your Workbench (client), and you proceed to the <span class="guilabel">Authentication</span> dialog to enter your platform credentials. This warning should not appear again unless you delete the allowed host exemption,
or unless the certificate expires.
</p>
</li>
<li>
<p>If you <span class="guibutton">Reject</span>, no exemption is created, nor do you see the <span class="guilabel">Authentication</span> dialog to make a connection. Instead, an error message is generated.
</p>
</li>
</ul>
</div>
<p>Note this Workbench certificate warning <span class="emphasis"><em>repeats</em></span> when you open the <span class="emphasis"><em>first station SSL connection</em></span> (Foxs) to a local station&#8212;in this case to your AX-3.8 &#8220;demo&#8221; station. When you <span class="guibutton">Accept</span>, <span class="emphasis"><em>another</em></span> &#8220;allowed host&#8221; exemption is created for your Workbench client, this time for a different software port: 4911 Foxs default,
(vs. 5011 platformssl default). Similarly, web browser access using a secure connection produces a warning in your client
browser; see <a href="aDemo38BrowserSSLaccess.html" title="Browser access notes"><i>Browser access notes</i></a>.
</p>
<p>In general, usage of PKI signed certificates with NiagaraAX is recommended over the (default) self-signed &#8220;<code class="literal">tridium</code>&#8221; certificate. However, details are well outside the scope of this document. Again, refer to the <em class="citetitle"><a href="module://docSSL/doc/index.html">NiagaraAX SSL Connectivity Guide</a></em> for complete details.
</p>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
<a href="index.html">Index</a> |
<a href="aDemoStationSecurityNotes.html">Prev</a> |
<a href="aDemo38BrowserSSLaccess.html">Next</a>
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>
Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 41 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 603 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 361 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 603 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 547 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 571 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 168 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 57 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 64 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 543 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 361 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 571 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 466 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 353 B

BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 392 B

+107
View File
@@ -0,0 +1,107 @@
<!-- Htmldoc has been run -->
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Demo Quick Start</title>
<link rev="made" href="documentation@tridium.com">
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
<link rel="start" href="index.html" title="Demo Quick Start">
<link rel="next" href="StartDemo.html" title="Get the Demo Up and Running">
<meta name="description" content="Niagara Framework documentation">
<!-- Auto-generated style sheet link -->
<link rel='StyleSheet' href='module://bajaui/doc/style.css' type='text/css' />
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<!-- Auto-generated Header NavBar -->
<p class="navbar">
Index |
Prev |
<a href="StartDemo.html">Next
</p>
<div class="article" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a name="d0e2"></a>Demo Quick Start
</h2>
</div>
</div>
<hr>
</div>
<p>Welcome to the NiagaraAX Framework! This document will get you up and running with a demo station using NiagaraAX-3.8 Workbench.
If you are new to Niagara, then you might want to check out the NiagaraAX <em class="citetitle"><a href="module://docUser/doc/index.html">User Guide</a></em>&nbsp;section &#8220;<a href="module://docUser/doc/aTourWorkbenchGUI.html">Tour of the Workbench GUI</a>&#8221;.
</p><a name="d0e14"></a><p class="note" border="0" width="24"><img src="module://docUser/doc/images/note.png" alt="Note" width="24" height="24">If you are a Java software developer working with the NiagaraAX Framework, you should also see the <em class="citetitle"><a href="module://docDeveloper/doc/index.html">Niagara Developer Guide</a></em>&nbsp;for details on Baja and Java usage in NiagaraAX.
</p>
<p>The following sections are in this Demo Quick Start document:</p>
<div class="itemizedlist">
<ul>
<li>
<p><a href="StartDemo.html">Get the Demo Up and Running</a></p>
</li>
<li>
<p><a href="NavigationTips.html">Tips on Navigating the Demo</a></p>
<div class="itemizedlist">
<ul>
<li>
<p><a href="LearningMore.html">Learning More</a></p>
</li>
</ul>
</div>
</li>
<li>
<p><a href="StoppingDemoStation.html">Stopping the Demo Station</a></p>
</li>
<li>
<p><a href="TroubleshootingDemo.html">Troubleshooting the Demo</a></p>
<div class="itemizedlist">
<ul>
<li>
<p><a href="NoNavTree.html">Tree Not Visible</a></p>
</li>
<li>
<p><a href="OpenPlatformIssues.html">Cannot Open Platform</a></p>
</li>
<li>
<p><a href="NoStationsInAppDirector.html">Tree Not Visible</a></p>
</li>
<li>
<p><a href="OpenStationIssue.html">Cannot Open Station</a></p>
</li>
</ul>
</div>
</li>
<li>
<p><a href="aDemoStationSecurityNotes.html" title="Demo stations security notes"><i>Demo stations security notes</i></a></p>
</li>
<li>
<p><a href="aNewWorkbenchSSLcertificates.html" title="SSL and certificate notes in AX-3.8"><i>SSL and certificate notes in AX-3.8</i></a></p>
<div class="itemizedlist">
<ul>
<li>
<p><a href="aDemo38BrowserSSLaccess.html" title="Browser access notes"><i>Browser access notes</i></a></p>
</li>
</ul>
</div>
</li>
</ul>
</div>
</div>
<!-- Auto-generated Footer NavBar -->
<p class="navbar">
Index |
Prev |
<a href="StartDemo.html">Next
</p>
<!-- Auto-generated copyright note -->
<p class='copyright'>Copyright &copy; 2000-2013 Tridium Inc. All rights reserved.</p>
</body>
</html>