Skip to Content
Last modified by Alexander Mott on 2025/06/13 15:26
From version 33.1
edited by Alexander Mott
on 2025/06/13 15:26
Change comment: There is no comment for this version
To version 20.1
edited by Mark Kohlmann
on 2021/10/27 02:00
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -CoAP ShowRunner to ShowRunnerCLC™ Setup Instructions
1 +CoAP ShowRunner to ShowRunner Setup Instructions
Parent
... ... @@ -1,1 +1,1 @@
1 -SHOWRUNNER™ Integrations Guide.Integration Options.CoAP with Crestron S# Library and Modules.WebHome
1 +SHOWRUNNER™ User Guide & Wiki.SHOWRUNNER™ Appendix.Integration Options.CoAP with Crestron S# Library and Modules.WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.alexander\.mott@chiefintegrations\.com
1 +XWiki.mark\.kohlmann@chiefintegrations\.com
Content
... ... @@ -1,44 +1,15 @@
1 -(% class="box warningmessage" id="HUseShowRunnerCLC2122version3.010orlater" %)
2 -(((
3 -Use ShowRunnerCLC™ version 3.010 or later.
4 -)))
1 +===== Use ShowRunner version 3.010 or later =====
5 5  
6 -Terminology:
7 7  
8 -* Client Processor - Processor that will interact with hardware attached to the host processor.
9 -* CWS - Crestron Web Server, the processor's internal web server
10 -* Host Processor (Server) - Processor that hosts the physical hardware
11 -* LWAPI - Lightweight API (CoAP)
12 -* User Page Auth - Requires a username and password to access the internal web server (CWS) on the processor.  3-series always has this enabled if authentication is activated.  4-series processors have an option to have user page auth on or not (default is off).
4 +===== Host processor (LWAPI Server) Setup (DIN-AP3 @ 10.44.5.91) =====
13 13  
14 -Steps:
15 -
16 -1. [[Setup Host Processor>>WebHome||anchor="Host processor (LWAPI Server) Setup (DIN-AP3 @ 10.44.5.91)"]]
17 -11. Verify processor configuration
18 -11. Verify LWAPI is enabled
19 -11. Create API User
20 -11. Create CWS User (if necessary)
21 -11. Save the configuration
22 -1. [[Setup Client Processor>>WebHome||anchor="Client processor (LWAPI Client) Setup (DIN-AP4) Version 3.011 or newer"]]
23 -11. Define the remote system
24 -11. Setup auth for the remote system
25 -11. Save the configuration
26 -1. Verify successful communications with the following commands:
27 -11. On host, verify the client shows up as a web session: ##sr sh lwapi serv cli##
28 -11. On client, verify the session with the host: ##sr sh lwapi cli br##
29 -
30 -=== Host processor (LWAPI Server) Setup (e.g. DIN-AP3 @ 10.44.5.91) ===
31 -
32 32  Steps 1-3 and 5 always needed.
33 33  
34 34  1. If 3-series, Enable Authentication [##authentication on##] or SSL [##ssl self##] if not already enabled.  4-Series have authentication enabled by default.  User Page Auth should be turned off on 4-series.
35 -1. Enable LWAPI
36 -From Console (v 3.011 or later; processor will automatically restart):
37 -## sr lwapi enable true##
38 -In Config (@ root level; reloading the configuration is required):
9 +1. Enable LWAPI In Config (@ root level):
39 39  ## "LwApiEnable": true,
40 40   "LwApiSecurityLevel": "Auth",##
41 -1. Create an API User and record the Key and Secret.  User group must have //LWAPI //role and //Execute //permissions.  This allows the  //Lightweight API Users// group has been created for this purpose:
12 +1. Create an API User and record the Key and Secret.  User group must have //LWAPI //role and //Execute //permissions.  //Lightweight API Users// group has been created for this purpose:
42 42  ##DIN-AP3>sradmin add api user "Central Control" "Lightweight API Users"
43 43  API User Central Control generated with Group permissions Lightweight API Users and Key: (% style="color:blue" %)**YTd2pQn7sjwiOWD9NqCIWw**(%%) Secret: (% style="color:orange" %)**OeiQEFo_-EDfc7sQe_qRpeQzSkZjylV2roa76utpJLI**(%%)##
44 44  1. If 3-series w/ auth enabled or 4-series with user page auth enabled then add a remote user with permissions to connect to the control system.  This is done by adding a local user to the system with user privileges.  Sample values shown, do not re-use these.
... ... @@ -48,21 +48,17 @@
48 48  'lwapi' was successfully added to group 'Users'.##
49 49  1. Save the configuration
50 50  
51 -=== Client processor (LWAPI Client) Setup (e.g. DIN-AP4) ===
22 +===== Client processor (LWAPI Client) Setup (DIN-AP4) Version 3.011 or newer =====
52 52  
53 -==== ShowRunnerCLC™ 3.011 or newer ====
24 +Steps 1-3 and 6 always needed.
54 54  
55 -Steps 1-3 always needed. **Note:** host and client processors must be able to communicate with each other to use this method (i.e. the network must be configured and both processors must have SHOWRUNNER™ program and configuration loaded).
56 -
57 57  1. Define remote system in the config:
58 -## "RemoteSystems": [
59 - {
60 - "SystemId": (% style="color:darkcyan" %)1(%%),
61 - "IpAddressOrHostname": "10.44.5.91",
62 - "Label": "HUB-1-1",
63 - "ConnectionType": "LWAPI"
64 - },
65 - ],##
27 +## {
28 + "SystemId": (% style="color:darkcyan" %)1(%%),
29 + "IpAddressOrHostname": "10.44.5.91",
30 + "Label": "HUB-1-1",
31 + "ConnectionType": "LWAPI"
32 + },##
66 66  1. Add Users :
67 67  if CWS User is not needed:
68 68  ##DIN-AP4>sr remote system auth (% style="color:darkcyan" %)**1**(%%) (% style="color:blue" %)**YTd2pQn7sjwiOWD9NqCIWw**(%%) (% style="color:orange" %)**OeiQEFo_-EDfc7sQe_qRpeQzSkZjylV2roa76utpJLI**(%%)##
... ... @@ -71,19 +71,17 @@
71 71  Success##
72 72  1. Save the configuration
73 73  
74 -==== ShowRunnerCLC™ v3.010 or earlier ====
41 +===== Client processor (LWAPI Client) Setup (DIN-AP4) Version 3.010 or earlier =====
75 75  
76 76  Steps 1-3 and 6 always needed.
77 77  
78 78  1. Define remote system in the config:
79 -## "RemoteSystems": [
80 - {
81 - "SystemId": (% style="color:darkcyan" %)1(%%),
82 - "IpAddressOrHostname": "10.44.5.91",
83 - "Label": "HUB-1-1",
84 - "ConnectionType": "LWAPI"
85 - },
86 - ],##
46 +## {
47 + "SystemId": (% style="color:darkcyan" %)1(%%),
48 + "IpAddressOrHostname": "10.44.5.91",
49 + "Label": "HUB-1-1",
50 + "ConnectionType": "LWAPI"
51 + },##
87 87  1. Add remote user for LWAPI (this is the key and secret created on the host):
88 88  ##DIN-AP4>sradmin add remote user HUB-1 (% style="color:blue" %)**YTd2pQn7sjwiOWD9NqCIWw**(%%) (% style="color:orange" %)**OeiQEFo_-EDfc7sQe_qRpeQzSkZjylV2roa76utpJLI**(%%)
89 89  Remote User HUB-1 ((% style="color:green" %)//**1a920b8b-3ab8-44bd-bc7b-0fc77abf0a13**//(%%)) added with Group permissions Remote Connection##