Wiki source code of Processor Setup

Version 2.1 by Alexander Mott on 2022/06/09 17:17

Show last authors
1 (% class="box warningmessage" %)
2 (((
3 showrunner is tested against current Crestron firmware releases.  Please use at least the recommended firmware builds.
4 3-Series: PUF 1.8001.0146
5 4-Series: PUF 2.7000.00052.01
6 VC-4: 2.7000.00047
7 )))
8
9 (% class="box infomessage" id="HNotes" %)
10 (((
11 Notes
12 Static IP or properly setup DHCP/DNS implementation required.
13 Auto-Assigned/Link-Local IP address range of 169.254.x.x not supported (Crestron xPanel issue)
14 )))
15
16 **ShowRunner Installation Tutorial:**
17
18 [[https:~~/~~/www.youtube.com/watch?v=xuJ94cMCCa8>>url:https://www.youtube.com/watch?v=xuJ94cMCCa8]]
19
20 **Licensing tutorial:**
21
22 //Note: Please use Chrome or Firefox to download the License from [[https:~~/~~/portal.chiefintegrations.com>>https://portal.chiefintegrations.com]].  Edge and Internet Explorer do not work properly.//
23
24 [[https:~~/~~/www.youtube.com/watch?v=H8CLZ7bp0eI>>url:https://www.youtube.com/watch?v=H8CLZ7bp0eI]]
25
26 === IP Configuration and Program Load (Per Processor) ===
27
28 * Obtain the latest build of ShowRunner [[https:~~/~~/files.chiefintegrations.com/s/WHNzXrrZbB5jC3E>>url:https://files.chiefintegrations.com/s/WHNzXrrZbB5jC3E]]
29 * Set the processor’s IP Address per your network requirements
30 * For processors with a Control Subnet (CP3N/AV3/PRO3/CP4N/AV4/PRO4/ZUM-HUB4): 
31 ** Connect to the processor via Text Console and type "startprogafterrouter on"
32 *** This will force the processor to wait until the router has started before attempting to load the showrunner™ program, avoiding potential license validation issues after a power loss.
33 ** Networked lighting hardware should be landed on the Control Subnet
34 ** The processor acts as a DHCP server on the Control Subnet, with addresses that are determined automatically based on the LAN configuration
35 ** The Control Subnet can be configured manually in the "Functions>Ethernet Addressing...>Control Subnet" menu of Toolbox
36 *** Set routing to "Manual" with the start address and subnet size
37 *** E.g., a setting of "10.0.0.0/24" will have the processor at 10.0.0.1 with an IP mask of 255.255.255.0 and a default gateway and DNS server at 10.0.0.2
38 *** 100.64.0.0/10 is a recommended range as it is unlikely to be used on any corporate network.  Processor IP will be 100.64.0.1 and default gateway/DNS will be 100.64.0.2.  Console command is: ##csrouterprefix 100.64.0.0/10##
39 * Connect your computer to the same network as the processor. Make sure your computer’s IP settings are compatible with the lighting hardware.
40 * Double click the PUF to install ShowRunner (works best with Toolbox closed)
41 * Select the PUF file again if needed, connect to the processor using the pencil, and select Recheck (This verifies the need to install the program, the XPanel UI, and the Crestron App UI)
42 * Click Update when prompted to install ShowRunner
43 * After loading, you can connect to the UI by navigating to the processor’s IP.  
44 ** **3-Series processors require authentication enabled** (SSL self can be used but steps will need to be repeated).
45 ** If stuck on "Connecting to Processor" you will need to accept the certificate.
46 * Showrunner™ will be loaded but a configuration and license are still needed.  Please proceed with the next section.
47
48 === License and Configuration Deployment ===
49
50 * Download the configuration file from the link provided by Chief Integrations
51 * Obtain and download the license from [[https:~~/~~/portal.chiefintegrations.com>>url:https://portal.chiefintegrations.com]]
52 ** Processors with a Control Subnet should use the LAN MAC address, **not** the Control Subnet MAC address
53 * Navigate to the showrunner™ management page
54 * Login to the showrunnerHUB™
55 ** 4-Series processor: The login created by the processor will work
56 ** 3-Series processor: Using Toolbox Text Console - type "sradmin [username] [name] administrators [password]"  (not needed if processor authentication is setup)
57 * Click Setup then File Management
58 ** [[image:MicrosoftTeams-image7c355557d0a3ae410e72498ee667de2df50226f3e3940c2df4b51bb7137e176b.png||height="240" width="250"]]
59 ** Under “Upload New License File”
60 *** Leave restart unchecked after transfer
61 *** Select “Choose File” find the license file you downloaded from the portal
62 *** Select “Upload”
63 ** Loading Configuration
64 *** From Configuration File
65 **** Under “Upload New Config File”
66 ***** Select “Choose File” and find the provided SrConfig.json for this processor from the project link that was sent at project delivery.
67 ***** Select “Upload”
68 ***** Alternatively, you can drop the License.lic using Toolbox’s File Manager or your SFTP client into the NVRAM/sr folder of the processor, the SrConfig.json into NVRAM/sr/default and perform “progreset” from the processor’s console
69 ***** The program will restart
70 *** From Backup
71 **** Select "Restore"
72 **** Select "Choose Backup" and find the "SRBackup.zip" of the backup you wish to restore
73 **** Enter the secret used to create the backup.  Showrunner will upload the file and verify the secret.
74 **** Select "Restart" to load the new configuration
75 ** Wait about 45 seconds after loading the configuration for the program to restart completely(((
76 === TSW Setup (Per Panel) ===
77
78 * Set the TS/TSWs IP Address per your network requirements (If using a panel other than TSW-770 you will need the CI_ShowRunner-UI_v3.xx PUF)
79 * Connect the PUF (CI_ShowRunner_v3.xx) to the TSW to load the UI
80 ** Only add CI_ShowRunner-UI_v3.xx if using touch panel other than TSW-770.  
81 * When finished, connect to the TSW with Text Console and type “addm 10 x.x.x.x” to link the panel to the processor (where x.x.x.x is the processor’s IP or hostname [DHCP/DNS])
82 ** You can also edit the IP table from Toolbox or the touchpanel’s setup screen.  IP-IDs 10 and 11 are reserved for TSWs by default.  If you have more than 2 touchpanels the additional IP-IDs will be provided.
83
84 === GLPAC Setup ===
85
86 * When GLPACs are deployed Chief Integrations will provide a load script that loads and configures the GLPAC hardware.  The script includes Chief Integrations chosen IP addresses unless otherwise requested.
87 * Set the IP addresses on all GLPACs per your network requirements.  The script will need to be updated if IP Addresses are changed from Chief Integrations chosen IP Addresses.
88 * Using Toolbox -> Script Manager, select the Scripting dropdown or right click and select “Load Script”.  Find the text file provided.
89 * Provided the given IPs can be seen on the network, double or right clicking an entry will load the program and link the IP table, enabling control through showrunner™
90 * Say yes to the dialog warning the hardware does not match (if prompted), and yes to overwrite the IP table (if prompted)
91 )))
92 *