Changes for page VC-4 Setup

Last modified by Alexander Mott on 2024/10/24 15:00
From version 19.1
edited by Alexander Mott
on 2023/05/15 22:47
Change comment: There is no comment for this version
To version 4.1
edited by Alexander Mott
on 2022/09/16 20:56
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -5,10 +5,10 @@
5 5  
6 6  (% class="box warningmessage" %)
7 7  (((
8 -ShowRunnerCLC™ on VC-4 requires version 4.000.0007 of VC-4
8 +showrunner on VC-4 requires version 4.000.0007 of VC-4
9 9  )))
10 10  
11 -{{box cssClass="floatinginfobox" title="**CONTENTS**"}}
11 +{{box title="**Contents**"}}
12 12  {{toc/}}
13 13  {{/box}}
14 14  
... ... @@ -26,7 +26,7 @@
26 26  
27 27  = Program Install =
28 28  
29 -* Download //CI_ShowRunner_vx.xx.cpz// and //Redirect.zip// from the VC-4 folder on the ShowRunnerCLC™ releases site
29 +* Download //CI_ShowRunner_vx.xx.cpz// and //Redirect.zip// from the VC-4 folder on the showrunner releases site
30 30  * Connect to the VC-4 server [[https:~~/~~/(Your_VC-4_IPAddress)/VirtualControl/config/settings/>>https://(Your_VC-4_IPAddress)/VirtualControl/config/settings/]]
31 31  * Load the Program
32 32  ** Go to the //Settings// tab
... ... @@ -41,29 +41,43 @@
41 41  **** Configuration Pages: Select Redirect.zip
42 42  [[image:1663090552845-124.png||height="326" width="404"]]
43 43  * Navigate to the "Device Info" section under the "Status Tab"
44 -** Record the serial number and MAC address
45 -* Create a new room and load the ShowRunner™ License as the User File for the room
46 -** ShowRunner™ license requires the Room ID and Room Name, as well as the MAC address
47 -** Room ID is always one word, all caps and is case-sensitive for the license
44 +** Record the serial number
48 48  
49 -= Accessing the ShowRunner™ Console =
46 += Update NVRAM Folder Permissions =
50 50  
51 -To access the ShowRunner™ console, connect to the VC-4 with PuTTY or another text console, log in to Linux, and then run the command ##telnet 127.0.0.1 50001##
48 +* Ensure that the NVRAM folder permissions are set correctly using a third party SFTP program:
49 +** FileZilla instructions ([[video example>>attach:FileZilla HUB4 NVRAM Permissions Change.mp4]]):
50 +*** Connect to the processor at port 22
51 +*** Locate the "nvram" folder
52 +*** Right click the folder and select "Change File Attributes"
53 +*** Change "Numeric Value" to 777
54 +*** Disconnect from the processor
55 +** WinSCP instructions:
56 +*** Connect to the processor at port 22
57 +*** Locate the "nvram" folder
58 +*** Right click the folder and select "Properties"
59 +*** Change "Octal Value" to 2777
60 +*** Disconnect from the processor
52 52  
53 -This command will open a telnet session with the ShowRunner™ program running on the VC-4, enabling the use of typical "sr" commands. To leave the ShowRunner™ console and close the telnet application, press the escape character '^]' ('ctrl+]'), type "quit", and then press enter.
62 += Crestron License Generation =
54 54  
55 -The ShowRunner™ console can be used track normal Crestron console messages to the /var/log/messages log by setting up a VC-4 API token and registering it in ShowRunner™. To do this, navigate to the VC-4 configuration page, navigate to the "Settings" tab and open the "Tokens" section. Click "Add Token" and name it "showrunner". Copy the token to your clipboard and then go into the ShowRunner™ console. Run the command "##sradmin set vc4 api token [paste the api token]##" and then run the command "##sradmin restart##"
64 +* 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
65 +* Connect to the ZUM-HUB4 in Crestron Toolbox
66 +** Run the "##ver##" and verify that the reported firmware is v2.7100.00016 or greater
67 +** Navigate to Functions>License Management...>Add License
68 +** Open [[Crestron's SW-HUB4-PROG licensing form>>https://app.smartsheet.com/b/form/e06b27d442ba4e668e31ffdf5f6e6322]] in a web browser and generate the license key
69 +*** The Customer Number and PO# must be provided by the Crestron Agent for the job
70 +*** The Hostname and System Key can be viewed in Toolbox by navigating to Functions>License Management...>Add License
71 +** In Toolbox, paste the generated license key into the "License Key:" field of the Add License menu
72 +** Click the "Apply" button
73 +* Continue [[SHOWRUNNER™ deployment>>SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.SHOWRUNNER™ Installation and Network Setup.Processor Setup.WebHome||anchor="HProgramLoad"]] as normal
56 56  
57 -By running the command "##sudo tail -f /var/log/messages##", the Linux console will start tracking messages that you would normally see if you connected to an ordinary processor via Text Console.
75 += Accessing the showrunnerHUB™ Web UI =
58 58  
59 -= Accessing the ShowRunnerHUB™ Web UI =
77 +Due to Crestron's Zūm Program running in parallel with the SHOWRUNNER™ program, navigating to the processor's IP address in a web browser will no longer redirect you to the showrunnerHUB™ UI.
60 60  
61 -The ShowRunner™ configuration should be uploaded to the processor using the ShowRunnerHUB™ web UI. It is not possible to access the ShowRunnerHUB™ web UI by directly navigating to the IP address of the VC-4 server, instead it is necessary to navigate to the following URL: https:~/~/**vc-4ip**/VirtualControl/Rooms/**ROOMID**/cws/showrunner/app/ (Bold portions should be modified with your specific IP and Room ID, **DO NOT OMIT THE LAST "/"**)
79 +Instead, you must add "/cws/showrunner/app/" after the IP address in order to access the Web UI (e.g. [[https:~~/~~/100.64.0.1/cws/showrunner/app/>>https://100.64.0.1/cws/showrunner/app]]) **DO NOT OMIT THE LAST "/"**
62 62  
63 -Prior to logging in to the ShowRunnerHUB™ UI, it is necessary to create a ShowRunner™ user. Open the ShowRunner™ console as described above and run the following command, replacing the "username", "name" and "password" with your desired credentials: ##sradmin add user **username** "**name**" Administrators **password**##
64 -
65 -The username and password should be one word each and will be the credentials used to log in to the ShowRunnerHUB™ UI. The name can be multiple words as long as it is in quotes, and is simply a friendly name used to identify each user.
66 -
67 -VC-4 Currently does NOT serve the XPANEL:
68 -The XPanel does not launch from the ShowRunnerHUB webpage. To access the XPanel, extract the VTZ file from the ShowRunnerCLC™ puf file and launch. Select Options>Host Settings and input the Host IP, IPID, Port 41794, check SSL, enter the Room ID, and Open. Type in the username and password (if applicable) and wait for the XPanel to connect.
81 +ZUM-HUB4 Currently does NOT support XPANEL:
82 +The XPanel does not launch from the Showrunner HUB webpage. To access the XPanel, extract the VTZ file from the showrunner™ puf file and launch. Select Options>Host Settings and input the Host IP, IPID, Port 41794, check SSL, and Open. Type in the username and password and wait for the XPanel to connect.
69 69  )))