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 22.2
edited by Scott Kohlmann
on 2021/12/08 21:05
Change comment: Update document after refactoring.

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -CoAP ShowRunner to ShowRunnerCLC™ Setup Instructions
1 +CoAP ShowRunner to ShowRunner Setup Instructions
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.alexander\.mott@chiefintegrations\.com
1 +XWiki.scott\.kohlmann@chiefintegrations\.com
Content
... ... @@ -1,11 +1,8 @@
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 6  Terminology:
7 7  
8 -* Client Processor - Processor that will interact with hardware attached to the host processor.
5 +* Client Processor - Processor that will interact with hardware attached to the host procesor.
9 9  * CWS - Crestron Web Server, the processor's internal web server
10 10  * Host Processor (Server) - Processor that hosts the physical hardware
11 11  * LWAPI - Lightweight API (CoAP)
... ... @@ -13,29 +13,26 @@
13 13  
14 14  Steps:
15 15  
16 -1. [[Setup Host Processor>>WebHome||anchor="Host processor (LWAPI Server) Setup (DIN-AP3 @ 10.44.5.91)"]]
13 +1. [[Setup Host Processor>>SHOWRUNNER™ User Guide & Wiki.SHOWRUNNER™ Appendix.Integration Options.CoAP with Crestron S# Library and Modules.CoAP ShowRunner to ShowRunner Setup Instructions.WebHome||anchor="Host processor (LWAPI Server) Setup (DIN-AP3 @ 10.44.5.91)"]]
17 17  11. Verify processor configuration
18 18  11. Verify LWAPI is enabled
19 19  11. Create API User
20 20  11. Create CWS User (if necessary)
21 21  11. Save the configuration
22 -1. [[Setup Client Processor>>WebHome||anchor="Client processor (LWAPI Client) Setup (DIN-AP4) Version 3.011 or newer"]]
19 +1. [[Setup Client Processor>>SHOWRUNNER™ User Guide & Wiki.SHOWRUNNER™ Appendix.Integration Options.CoAP with Crestron S# Library and Modules.CoAP ShowRunner to ShowRunner Setup Instructions.WebHome||anchor="Client processor (LWAPI Client) Setup (DIN-AP4) Version 3.011 or newer"]]
23 23  11. Define the remote system
24 24  11. Setup auth for the remote system
25 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 29  
30 -=== Host processor (LWAPI Server) Setup (e.g. DIN-AP3 @ 10.44.5.91) ===
24 +===== Host processor (LWAPI Server) Setup (DIN-AP3 @ 10.44.5.91) =====
31 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 35  1. Enable LWAPI
36 -From Console (v 3.011 or later; processor will automatically restart):
30 +From Console (v 3.011 or later):
37 37  ## sr lwapi enable true##
38 -In Config (@ root level; reloading the configuration is required):
32 +In Config (@ root level):
39 39  ## "LwApiEnable": true,
40 40   "LwApiSecurityLevel": "Auth",##
41 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:
... ... @@ -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) ===
45 +===== Client processor (LWAPI Client) Setup (DIN-AP4) Version 3.011 or newer =====
52 52  
53 -==== ShowRunnerCLC™ 3.011 or newer ====
47 +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 - ],##
50 +## {
51 + "SystemId": (% style="color:darkcyan" %)1(%%),
52 + "IpAddressOrHostname": "10.44.5.91",
53 + "Label": "HUB-1-1",
54 + "ConnectionType": "LWAPI"
55 + },##
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 ====
64 +===== 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 - ],##
69 +## {
70 + "SystemId": (% style="color:darkcyan" %)1(%%),
71 + "IpAddressOrHostname": "10.44.5.91",
72 + "Label": "HUB-1-1",
73 + "ConnectionType": "LWAPI"
74 + },##
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##