Overview
ScoreLink bots can connect to a BotControl server for remote configuration and support.
There are 4 support command line applications available when logged in to the virtual machine:
- controlcommandclient: to connect to ScoreLinkI and ScorelinkII.
- remotesupport: to connect to ScoreLink+.
- botfirmwareupdate: to update ScoreLinkII firmware.
- configurebotclient: to remotely configure ScoreLinkII to a specific scoreboard controller.
Guide
1️⃣ Download and install Azure CLI
- Windows: Download MSI Installer here. For more information see official documentation.
-
Linux: Use the installation script
curl -L https://aka.ms/InstallAzureCli | bash. Or follow the official documentation to install a package manager.
2️⃣ Login to Azure CLIOpen your terminal/powershell and run the command below.
az login
az account set --subscription 859db762-cc7e-4fff-9790-992f46bcbd5d
3️⃣ Connect to BotControl server via SSH, open a terminal/powershell and run the command below.
az ssh vm --hostname remotesupport.sportzcast.net
4️⃣ If the SSH extension is missing, the window requiring to install it will pop up. In this case - select YES to continue.
connection closed error may occur when
connecting
if the
correct RBAC
permission is not assigned in Azure.
|
Error |
Solution |
SSH' is misspelled or not recognized by the system
|
|
Please ensure you have network connection … SSL: CERTIFICATE_VERIFY_FAILED … self-signed certificate in certificate chain
|
|
1️⃣ Once logged in, run controlcommandclient
command
to use the
Command Client utility to connect to ScoreLink.
Example:
name.lastname@geniussports.com@az-vm-botcontrolserver-prod:~$ controlcommandclient
Sportzcast BOT Control Client Ver 1.0.0.0
Socket connected to 127.0.0.1:1404
Ctrl-Z to Disconnect
Device Type: scorelink
2️⃣ Add -i or --interactive flag
to
prevent automatic
typing of credentials when connecting to a bot.
controlcommandclient -i
1️⃣ In ScoreConnectIII go to "Other" and select “Support Tools“ to get the ID for the remote access.
2️⃣ Click on "Enable Remote Support".
3️⃣ The code for the remote access will be generated automatically.
4️⃣ Go back to the terminal, and use the command
remotesupport to
connect to ScoreLink+ Remote SSH using the copied support
code.
Example:
name.lastname@geniussports.com@az-vm-botcontrolserver-prod:~$ remotesupport
Enter Support Port Number: 25524FF
[... SSH Session starts ...]
1️⃣ Use the command botfirmwareupdater to update
ScoreLinkII firmware.
2️⃣ As a parameter use the bot number.
Example:
name.lastname@geniussports.com@az-vm-botcontrolserver-prod:~$ botfirmwareupdater 50292
[... firmware update process start for bot 50292 ...]
Requirements:
- ScoreLinkII: Access to BotControl server.
- ScoreLink+: Software version v2.5.0.10 or above.
Configuration:
1️⃣ Use configurebotclient command to remotely
configure a
ScoreLink+ or ScoreLinkII to work with a scoreboard controller.
2️⃣ As parameters use:
- Bot number;
- Vendor Sport Code
Example:
name.lastname@geniussports.com@az-vm-botcontrolserver-prod:~$ configurebotclient 50292 44
3️⃣ As Vendor Sport Codes can have multiple connection types,
the
configurebotclient command will prompt
the available connection
for the vendor sport issued.
4️⃣ For wireless configurations, the command will prompt to enter additional wireless settings.
5️⃣ Configuration status updates will be listed during the process.
Logs are saved to /usr/share/ControlServer/Logs/ folder, and can be accessed by any logged in user.
# Follow latest logs
tail -f /usr/share/ControlServer/Logs/*.txt
# Navigate specific log file using 'less'
less "/usr/share/ControlServer/Logs/BOTControlService2 2022-05-25.txt"
Users with the Virtual Machine Administrator Login role can
use
sudo command to control this service, if needed.
sudo systemctl restart ControlService
sudo systemctl status ControlService