Changes for page Processor Setup

Last modified by Alexander Mott on 2024/12/02 19:04

From 4.1 to 3.1 From 33.1 to 32.1

From version 32.1

edited by Alexander Mott
on 2022/09/16 21:01

Change comment: There is no comment for this version

To version 4.1

edited by Alexander Mott
on 2022/06/09 19:01

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 0 added, 1 removed)
- 1654807593390-193.png

Details

Page properties

Parent

@@ -1,1 +1,1 @@
--SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.SHOWRUNNER™ Installation and Network Setup.WebHome
++SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.WebHome

Content

@@ -1,28 +1,18 @@
--(% class="box errormessage" %)
++(% class="box warningmessage" %)
  (((
--This page is for typical processor setup; for ZUM-HUB4 deployments, see our [[dedicated ZUM-HUB4 page>>doc:SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.SHOWRUNNER™ Installation and Network Setup.ZUM-HUB4 Processor Setup.WebHome]].
++showrunner is tested against current Crestron firmware releases.  Please use at least the recommended firmware builds.
++3-Series: PUF 1.8001.0146
++4-Series: PUF 2.7000.00052.01
++VC-4: 2.7000.00047
  )))
--(% class="box warningmessage" %)
++(% class="box infomessage" id="HNotes" %)
  (((
--SHOWRUNNER™ is tested against current Crestron firmware releases. **Please use at least the recommended firmware builds.**
--
--* 3-Series: PUF 1.8001.0146
--* 4-Series: PUF 2.7000.00052.01
--* VC-4: 2.7000.00047
--
--**Notes:**
--
--* Static IP or properly setup DHCP/DNS implementation required.
--* Auto-Assigned/Link-Local IP address range of 169.254.x.x not supported (Crestron xPanel issue)
++Notes
++Static IP or properly setup DHCP/DNS implementation required.
++Auto-Assigned/Link-Local IP address range of 169.254.x.x not supported (Crestron xPanel issue)
  )))
--{{box title="**Contents**"}}
--{{toc/}}
--{{/box}}
--
--(% class="row" %)
--(((
  **ShowRunner Installation Tutorial:**
  [[https:~~/~~/www.youtube.com/watch?v=xuJ94cMCCa8>>url:https://www.youtube.com/watch?v=xuJ94cMCCa8]]
@@ -33,139 +33,72 @@
  [[https:~~/~~/www.youtube.com/watch?v=H8CLZ7bp0eI>>url:https://www.youtube.com/watch?v=H8CLZ7bp0eI]]
--= IP Configuration =
++=== IP Configuration and Program Load (Per Processor) ===
--* Connect to the processor via USB and set the processor’s IP Address per your network requirements
--** When connecting to a 4-Series processor or a 3-Series processor with authentication enabled for the first time, it will prompt for the creation of an admin-level CWS user
++* Obtain the latest build of ShowRunner [[https:~~/~~/files.chiefintegrations.com/s/WHNzXrrZbB5jC3E>>url:https://files.chiefintegrations.com/s/WHNzXrrZbB5jC3E]]
++* Set the processor’s IP Address per your network requirements
++** When connecting to a 4-series processor or a 3-series processor with authentication enabled for the first time, it will prompt for the creation of an admin-level CWS user
  *** Input the desired username and password into the dialog box. Save this login information, as it is not possible to recover if it is lost or forgotten
  *** In the event that the processor does not allow you to log in with the chosen credentials (i.e. it repeatedly prompts for credentials)
  **** Attempt to log in with username "crestron" and no password
--**** Once logged into Text Console, run the following commands, replacing the "username" and "password" with your desired credentials
--***** ##adduser -N:username -P:password##
--***** ##addusertogroup -N:username -G:Administrators##
--** Once connected, open Text Console and run the following commands to configure the processor's IP settings (example is for a **10.0.0.0(% style="color:darkgoldenrod" %)/24(%%)** subnet, with a processor IP address of (% style="color:blue" %)**10.0.0.10**(%%))
++**** Once logged into Text Console, run the following commands, replacing [BRACKETS] with your desired credentials
++***** ##adduser -N:[USERNAME] -P:[PASSWORD]##
++***** ##addusertogroup -N:[USERNAME] -G:Administrators##
++** Connect to the processor via USB and open Text Console and run the following commands, replacing [BRACKETS] per your network requirements
  *** Disable DHCP: ##dhcp 0 off##
--*** Set IP address: ##ipa 0 (% style="color:blue" %)**10.0.0.10**(%%)##
--*** Set IP subnet mask: ##ipm 0 (% style="color:darkgoldenrod" %)**255.255.255.0**(%%)##
--*** Set default gateway: ##defr 0 **10.0.0.1**##
--*** Set hostname: ##host AP3-CPP##
--*** Reboot the processor: ##reboot##
++*** Set IP address: ##ipa 0 [IPADDRESS]##
++*** Set IP subnet mask: ##ipm 0 [IPMASK]##
++*** Set default gateway: ##defr 0 [DEFAULTGATEWAY]##
++*** Set hostname: ##host [HOSTNAME]##
  ** It is also possible to configure a processor over Ethernet by using a DHCP server software on your laptop to assign an IP address
  *** Configure your DHCP server software to assign IP addresses in the desired range
  *** Once the processor is assigned an IP address, connect to it via Text Console at the assigned IP address
  *** Run the above commands to disable DHCP and assign a static IP address to the processor
--* For processors with a Control Subnet (CP3N/AV3/PRO3/CP4N/AV4/PRO4/ZUM-HUB4), additional setup is required
++* For processors with a Control Subnet (CP3N/AV3/PRO3/CP4N/AV4/PRO4/ZUM-HUB4), lighting hardware should be connected to the Control Subnet port and the building LAN should be connected to the LAN port. Additional setup is required for the Control Subnet.
  ** Connect to the processor via Text Console and run the command: ##startprogafterrouter on##
--*** This will force the processor to wait until the router has started before attempting to load the showrunner™ program, avoiding potential license validation issues if the processor boots up before the router.
--** The previously listed "ipa," "ipm," etc. commands will configure settings for the processor's LAN port, which should be connected to the building LAN or third party network.
--** Lighting control hardware (e.g. TSWs, DIN-CENCN-2s, etc.) should be connected to the Control Subnet port. The processor acts as a DHCP server on the Control Subnet, with addresses that are determined automatically based on the LAN configuration.
--** The Control Subnet will automatically configure itself based on the LAN configuration, but it can optionally be configured manually:
--*** Using the "Functions>Ethernet Addressing...>Control Subnet" menu of Toolbox:
--**** Set routing to "Manual" with the start address and subnet size
--**** E.g., a setting of "100.64.0.0/20" will have the processor at 10.64.0.1 with an IP mask of 255.255.240.0 and a default gateway and DNS server at 100.64.0.2
--*** Using Text Console commands (example for a **100.64.0.0/20** subnet, with a processor IP address of **100.64.0.1**)
--**** Set CS IP: ##csrouterprefix **100.64.0.0/20**##
--**** Reboot the processor: ##reboot##
--* If the job has multiple processors, then these steps must be repeated for all processors on the job
--** For jobs with Central Control, the IP addresses of the processors matters
--** Chief Integrations will provide an SRTakeoff.xlsx spreadsheet with an IP Table tab that lists the IP address for each processor. If these IP addresses must be changed during startup, then it will be necessary to also change the IP addresses in the Remote System Definition in the configuration file
--** See the[[ CoAP Setup Guide>>doc:SHOWRUNNER™ Integrations Guide.Integration Options.CoAP with Crestron S# Library and Modules.CoAP ShowRunner to ShowRunner Setup Instructions.WebHome]] for details
++*** 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.
++** Networked lighting hardware should be landed on the Control Subnet
++** The processor acts as a DHCP server on the Control Subnet, with addresses that are determined automatically based on the LAN configuration
++** The Control Subnet can be configured manually in the "Functions>Ethernet Addressing...>Control Subnet" menu of Toolbox
++*** Set routing to "Manual" with the start address and subnet size
++*** 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
++*** 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##
++* Connect your computer to the same network as the processor. Make sure your computer’s IP settings are compatible with the lighting hardware.
++* Double click the PUF to install ShowRunner (works best with Toolbox closed)
++* 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)
++* Click Update when prompted to install ShowRunner
++* After loading, you can connect to the UI by navigating to the processor’s IP.
++** **3-Series processors require authentication enabled** (SSL self can be used but steps will need to be repeated).
++** If stuck on "Connecting to Processor" you will need to accept the certificate.
++* Showrunner™ will be loaded but a configuration and license are still needed.  Please proceed with the next section.
--= Program Load =
++=== License and Configuration Deployment ===
--* Download the latest build of SHOWRUNNER™ from the[[ Chief Integrations Portal>>https://files.chiefintegrations.com/index.php/s/WHNzXrrZbB5jC3E]]
--* Connect your computer to the same network as the processor. Make sure your computer’s IP settings are compatible with the lighting network and do not conflict with any devices already on the network
--** While it is possible to load the program via USB, it is not recommended because the transfer speed is significantly slower than loading via Ethernet
--* Double click the PUF to open the Package Update Tool and install SHOWRUNNER™ (works best with Toolbox closed)
--** The Package Update Tool will automatically open your Address Book and prompt you to select a device
--*** If you have not created an Address Book for this job, close the Address Book window and press the pencil icon
--*** Type in the IP address of your processor and click "OK"
--** Double check that the correct PUF file is listed under the "Package Info" section and that the correct IP address is listed under "Target"
--** Press the "Recheck" button
--** Make sure that all three tasks are selected ("Load ShowRunner Program", "Update Crestron App", and "Update XPanel")
--** Press the "Update" button to begin loading SHOWRUNNER™
--* Sometimes the PUF tool will falsely report a failure to load the program
--** Connect to the processor via Text Console
--** Run the command ##sr ver##
--** If the console returns with the newly installed version of SHOWRUNNER™, then the installation was successful
--** If the console returns with "Bad or Incomplete Command (sr)" then the installation was not successful
--*** Rename the downloaded .puf file to be a .zip file and open the archive
--**** Some file archivers (such as 7-Zip) allow you to right click on the PUF file and open the archive without changing the filetype
--*** Extract the "CI.Lighting.ShowRunner.cpz" file
--*** In Toolbox, connect to the processor via Text Console, click the lightning bolt icon, and select "SIMPL Program..."
--**** Alternatively, navigate to Functions>SIMPL Program...>SIMPL Program (Program01)...
--*** Under the "Send Program" section, browse your PC and select the extracted .cpz file
--*** Click the "Send" button and click "Yes" to upload the program
--*** Once it is done loading, you should be able to run the ##sr ver## command and see the currently installed version of SHOWRUNNER™
--* Once SHOWRUNNER™ is loaded, you can connect to the UI by navigating to the processor’s IP. A license and configuration file are still required.
--** **3-Series processors require authentication enabled** (SSL self can be used but steps will need to be repeated)
--** If stuck on "Connecting to Processor" you will need to accept the certificate
--* For jobs with multiple processors, SHOWRUNNER™ will need to be loaded to each processor
--
--= License and Configuration Deployment =
--
--* Download the SrConfig.json or CiLightingConfig.json configuration file from the link provided by Chief Integrations
++* Download the configuration file from the link provided by Chief Integrations
  * Obtain and download the license from [[https:~~/~~/portal.chiefintegrations.com>>url:https://portal.chiefintegrations.com]]
  ** Processors with a Control Subnet should use the LAN MAC address, **not** the Control Subnet MAC address
--* The license and configuration can be loaded with Toolbox using Text Console and File Management, or through the showrunnerHUB™ web interface
--** Using Toolbox:
--*** Connect to the processor via Text Console and via File Management
--*** In File management, navigate to the "NVRAM>sr" folder from the left-hand menu
--*** Right-click on the right-hand side and select "Copy File(s) From..." and select the downloaded License.lic file
--**** Alternatively, drag and drop the file from your computer to the File Management tool
--*** Using the left-hand menu, navigate to the "NVRAM>sr>default" folder
--*** Right-click on the right-hand side and select "Copy File(s) From..." and select the downloaded SrConfig.json file
--**** Alternatively, drag and drop the file from your computer to the File Management tool
--**** If you downloaded a CiLightingConfig.json file, it must be renamed to "SrConfig.json"
--** Using the showrunnerHUB™ UI:
--*** Using Chrome or Firefox, navigate to the processor's IP address
--*** When prompted, input your credentials and log in
--**** 4-Series processor or 3-Series processor with authentication enabled: Log in using the same admin credentials used to connect to the processor
--**** 3-Series processor without authentication enabled: Connect to the processor via Text Console and run the following command, replacing the "username", "name" and "password" with your desired credentials.
--***** ##sradmin username "name" administrators password##
--***** The username and password should be one word each and are the credentials used to log in to the showrunnerHUB™
--***** The name can be multiple words as long as it is in quotes, and is simply a friendly name used to identify each user.
--*** Once logged in to the showrunnerHUB™ UI, you should be automatically redirected to the File Management page
--**** If you are not automatically redirected, then you can navigate to this page by clicking "Setup" in the top right and then selecting "File Management" from the list on the left
--**** [[image:1654807593390-193.png]]
--**** Under “Upload New License File”
--***** Leave "Restart after transfer" unchecked
--***** Select “Choose File” and browse for the license file you downloaded from the portal
++* Navigate to the showrunner™ management page
++* Login to the showrunnerHUB™
++** 4-Series processor: The login created by the processor will work
++** 3-Series processor: Using Toolbox Text Console - type "sradmin [username] [name] administrators [password]"  (not needed if processor authentication is setup)
++* Click Setup then File Management
++** [[image:MicrosoftTeams-image7c355557d0a3ae410e72498ee667de2df50226f3e3940c2df4b51bb7137e176b.png||height="240" width="250"]]
++** Under “Upload New License File”
++*** Leave restart unchecked after transfer
++*** Select “Choose File” find the license file you downloaded from the portal
++*** Select “Upload”
++** Loading Configuration
++*** From Configuration File
++**** Under “Upload New Config File”
++***** Select “Choose File” and find the provided SrConfig.json for this processor from the project link that was sent at project delivery.
  ***** Select “Upload”
--**** Load the configuration file either directly (if you have an SrConfig.json file) or from a backup (if you have an SRBackup.zip)
--***** Direct upload:
--****** Under “Upload New Config File”
--****** Select “Choose File” and find the provided CiLightingConfig.json or SrConfig.json file for this processor from the project link that was sent at project delivery.
--****** Select “Upload”
--***** From a Backup:
--****** Select "Restore"
--****** Select "Choose Backup" and find the SRBackup.zip of the backup you wish to restore
--****** Enter the secret used to create the backup. ShowRunner will upload the file and verify the secret.
--**** Once both the license and either a configuration file or backup have been loaded, click "Restart"
--**** Wait for the processor to finish restarting and then reload the page.
--***** 3-Series processors will take 45 to 90 restart
--***** 4-Series processors should restart considerably faster
--
--= Set System Time =
--
--It is important for the device clock to be accurate in order for scheduled events to trigger at the appropriate time. If Toolbox is still open, this can be done easily:
--
--* Connect to the processor via Text Console
--* At the top of the Toolbox window, navigate to Functions>System Clock...
--* If your computer is in the correct timezone, click Synchronize Device Time with PC
--** The Timezone and Device Time should synchronize automatically
--** If your PC is in the incorrect Timezone or the time did not synchronize properly, then manually adjust the Time, Date, and Timezone
--* Press the Apply button
--
--Note that the Location given in the System Clock... menu of Toolbox is not used by SHOWRUNNER™. Instead, the location used for sunrise/sunset calculations is stored in the configuration and will typically be set by Chief Integrations prior to delivery of the configuration. Both the location and time can be viewed and edited using the SHOWRUNNER™ UI
--
--* SHOWRUNNER™ XPanel UI:
--** Navigate to Settings>Location and System Clock
--** Press the Lock icon to enable editing
--** Adjust the time, timezone, and location as necessary
--** Press Set System Clock to save the changes
--* showrunnerHUB™ Web UI:
--** Navigate to Setup>System Settings>Location and System Clock
--** Adjust the time, timezone, and location as necessary
--** Click Apply to save the changes
++***** 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
++***** The program will restart
++*** From Backup
++**** Select "Restore"
++**** Select "Choose Backup" and find the "SRBackup.zip" of the backup you wish to restore
++**** Enter the secret used to create the backup.  Showrunner will upload the file and verify the secret.
++**** Select "Restart" to load the new configuration
++** Wait about 45 seconds after loading the configuration for the program to restart completely(((
++
  )))

1654807593390-193.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.alexander\.mott@chiefintegrations\.com

Size

...	...	@@ -1,1 +1,0 @@
1		-35.2 KB

Content