background image

Xeebra

Version 2.6 | March 2022

INSTALLATION AND CONFIGURATION MANUAL

Summary of Contents for Xeebra

Page 1: ...Xeebra Version 2 6 March 2022 INSTALLATION AND CONFIGURATION MANUAL ...

Page 2: ......

Page 3: ...ormational purpose and use only and subject to change without notice This manual cancels and replaces any previous versions thereof Copyright Copyright 2003 2022 EVS Broadcast Equipment SA All rights reserved This manual may not be reproduced transcribed stored in a database or a retrieval system translated into any language computer language transmitted in any form or by any means electronically ...

Page 4: ......

Page 5: ...4 1 Connecting the Client Workstation and Servers 12 4 2 Cabling the SDI Connectors 12 4 3 Securing the SDI Cables 13 4 4 Connecting the Video Monitors 14 4 5 Connecting the Beplay Remote ShuttlePRO v2 and X Keys 15 4 6 DisplayPort Cable Warning 15 5 Configuration 16 5 1 Changing the Server s Management IP Address and Hostname 16 5 2 NIC Teaming 19 5 3 Mapping the Touchscreens 20 5 4 Managing the ...

Page 6: ... X Keys Controller 31 6 Monitoring and Support 34 6 1 Services Management Tool 34 6 2 Dashboard Page 35 6 3 Health Page 36 6 4 Metrics Page 38 6 4 1 SDI Tab 38 6 4 2 Sx Storage Tab 40 6 4 3 Sys Stats Tab 40 6 4 4 Temperature Tab 45 6 4 5 Ingests Tab 46 6 5 Docker Page 48 6 6 Services Page 49 6 7 Versions Page 50 6 8 Resetting Xeebra 50 6 9 Consulting System Log Files and Crash Dumps 52 6 10 Suppor...

Page 7: ...d upgrade procedure See section First Install on page 4 and Upgrade on page 8 Changing the server s management IP address procedure See section Changing the Server s Management IP Address and Hostname on page 16 Extended range of Xeebra licenses Managing the Xeebra Licenses on page 21 Customization of the offside line display See section Customizing the Offside Line Display on page 27 INSTALLATION...

Page 8: ......

Page 9: ...tly zoom into the replay directly with a touch and zoom and mark and label the most important situations for review and export later With Artificial Intelligence inside Xeebra can simplify the calibration and execution of offside calls for VAR reviews Xeebra is based on a client server architecture that guarantees the highest level of flexibility and scalability 1 1 2 Setup The following diagram s...

Page 10: ... the Cat 6 cable with fiber media converters or by ordering the SFP Fiber option on the client and or the server Type of Switch When choosing a switch the following recommendations should be followed 1 server 2 servers 3 servers Clients hosted on server machines Should work with most switches or direct attached Ethernet connections Should work with most switches or direct attached Ethernet connect...

Page 11: ...ndation in terms of distances between the machine and USB device and grade of cable Recommendations When Working with Two Screens When working with 2 screens both screens must be the same resolution either 2 touch screens or 2 non touch screens Recommendations When Using Several Servers Even though one client can connect to up to 6 different servers there is a rule as to how many clients can conne...

Page 12: ...g the USB Key 1 Connect the USB key to a Windows 7 10 machine If the USB key is not empty please format it 2 Launch the Rufus utility using the following link https github com pbatard rufus releases download v3 14 rufus 3 14 exe 3 In the Device field select your USB key 4 Click the SELECT button to the right of the Boot selection field 5 Browse for the Xeebra ISO file select it and click Open The ...

Page 13: ... you are using a laptop with a docking station please ensure not to plug the USB key into the docking station Use a USB port on the laptop instead 7 Select the option Write in DD Image mode and click OK You will be notified that all data already on the USB drive will be overwritten 8 Click OK to continue INSTALLATION AND CONFIGURATION MANUAL Xeebra 3 Installation 5 ...

Page 14: ...Start Operating System and press ENTER 9 Press ENTER when you are prompted to start the operating system again 10 Enter the serial number of the server and press ENTER You can find the serial number on the back of your machine Completing the Installation If the installation was successful the following messages are displayed EVS System is configured EVS Reboot EVS Reboot in i seconds If the instal...

Page 15: ...ok on the Health page green or at least orange status for the resolv conf check before starting to use Xeebra If you are upgrading a Xeebra Client the Services Management page is not present so please just wait for 30 seconds to be sure everything has started before beginning to use Xeebra INSTALLATION AND CONFIGURATION MANUAL Xeebra 3 Installation 7 ...

Page 16: ...bra client hardware XEC 4100S or Lenovo P330 340 1 USB key 16 GB or higher by preference USB 3 0 Preparing the USB Key 1 Connect the USB key to a Windows 7 10 machine If the USB key is not empty please format it 2 In the Device field select your USB key 3 Click the SELECT button to the right of the Boot Selection field 4 Browse for the Xeebra ISO file select it and click Open The ISO file should h...

Page 17: ...cking station please ensure not to plug the USB key into the docking station Use a USB port on the laptop instead 6 Select the option Write in DD Image mode and click OK You will be notified that all data already on the USB drive will be overwritten 7 Click OK to continue Wait until the ISO file has been completely written to the USB key INSTALLATION AND CONFIGURATION MANUAL Xeebra 3 Installation ...

Page 18: ...sh Once the upgrade script has ended successfully the following messages are displayed EVS Upgrade evs xeebra server or client with success Remove the USB stick and press a key to reboot the system After pressing any key the screen will display Rebooting If the upgrade failed the following messages are displayed EVS Upgrade of evs xeebra server or client failed logs are available at var log evs ev...

Page 19: ... a Xeebra Client the Services Management page is not present so please just wait for 30 seconds to be sure everything has started before beginning to use Xeebra INSTALLATION AND CONFIGURATION MANUAL Xeebra 3 Installation 11 ...

Page 20: ...link 4 2 Cabling the SDI Connectors The SDI In connectors at the back of the server can be used for incoming SDI feeds The incoming feeds will be recorded A camera s SDI Out has to be connected with one of the Xeebra server s SDI connectors using a mini BNC cable A maximum of 8 cameras can be connected and require the use of genlock in line with the video format The Genlock should not be connected...

Page 21: ...curing the SDI Cables It is essential to maintain the cable connections horizontal to the server to avoid one or more of the SDI connections failing owing to the weight of the SDI cables which might also cause the video card to shift inside the server chassis We therefore recommend to let the cables rest on one of the following support types a cable lacing bar attached at the back of the rack a ri...

Page 22: ...esolution is higher black bands will be displayed at the top and bottom of your screen 4K monitors are not supported Connectors When working with a XEE2 4601D server or XEC1 4100S client workstation the following connectors can be used DVI I connector 2 DisplayPort connectors When working with a PMX2 4601D server the following connectors can be used 4 DisplayPort connectors The monitors have to be...

Page 23: ...directly connect a server with a monitor using a DisplayPort cable you need to make sure that pin 20 DP_PWR of the cable is not wired and does not carry any power If in doubt use a multimeter to verify this According to the VESA specification the DP_PWR pin 20 is not supposed to be wired in standard cables because both source and sink devices are designed to provide power Ignoring this will in cer...

Page 24: ...ra server proceed as follows 1 In the top left hand corner of your desktop open the Applications menu and select Settings Network Connections The Network Connection window opens 2 Select the connection you want to edit and click on the gear wheel icon The Editing dialog box opens The General tab is selected by default 3 Click the IPv4 Settings tab 16 March 2022 Issue 2 6 G ...

Page 25: ...click the Add button 6 Enter the new IP Address Netmask and IP address of the Gateway then click Save After running the script you will need to reboot See section First Install on page 1 Manually Changing the Server s Hostname To change the server s hostname after it was set during installation proceed as follows 1 Open a terminal window 2 Type the following command sudo nmtui INSTALLATION AND CON...

Page 26: ... TAB to step back through the options Press ENTER to select an option The SPACEBAR toggles the status of a checkbox 3 Select Set System Hostname and press ENTER 4 Enter the desired hostname and press ENTER You will be asked to confirm the new hostname 5 Press ENTER to continue 6 Select Quit and press ENTER to exit the tool 18 March 2022 Issue 2 6 G ...

Page 27: ...enu will appear Select expected operation 1 Add teaming 2 Remove teaming Please enter your choice 2 Type 1 A list with available network ports will be listed In the example below 2 network ports are listed 1 eno1 2 eno2 Please confirm which device number to add 3 Enter the number of the port you want to team For example 1 The name of the port will be added to the team Current selection eno1 1 eno1...

Page 28: ...that half and not on the same half of the other monitor If the touchscreen monitors are not mapped and the user selects an element on the left half of the secondary screen an element on the left half of the primary screen will be selected instead If the user selects an element on the right half of the primary screen an element on the right half of the secondary screen will be selected instead Touc...

Page 29: ...ed to tap your main screen 2 Tap your main screen to start the mapping You are notified when your screens have been successfully mapped 5 4 Managing the Xeebra Licenses 5 4 1 License Manager Overview The License Manager allows you to request and activate the necessary Xeebra license keys Double click the License Manager shortcut on your server or client workstation desktop to open the application ...

Page 30: ...elect a menu item type the corresponding number and press ENTER Setting and Viewing the Customer Information Setting the Customer Information When you start the License Manager for the first time the customer information will be empty To set the customer information proceed as follows 1 Type 2 Set Customer Info and press ENTER 2 Enter the following information Company Name First Name Last Name Ema...

Page 31: ...lient installed on X Client 1 server 20 multiple servers SLSM 30 SuperMotion ingest Offside Line 70 Certified offside line Xeebra API 60 Extended Channels 80 1080p FHD extended channels Please refer to the Release Note Requesting and Importing a License Key Requesting a License Key To request a license key proceed as follows 1 Type 3 Generate a Request Key File and press ENTER A request license ke...

Page 32: ...leted 5 5 Synchronizing the Time of the Xeebra Servers 5 5 1 Introduction In Xeebra synchronization is achieved by time stamping every image ingested in the server When two images are ingested on two different servers at the same time they must have the same timestamp This is achieved by synchronizing the time of all the Xeebra servers and clients using the NTP Network Time Protocol The NTP Config...

Page 33: ...ed and the Xeebra services are restarted again You are prompted to clear all tracks 4 Press ENTER to continue Information is displayed about the synchronization status of the server e g UTC reference time number of seconds delay compared with the UTC time etc You also see confirmation that the server is configured as the time server 5 5 3 Configuring an NTP Client To configure one of your servers ...

Page 34: ...ra services are restarted again You are prompted to clear all tracks 4 Press ENTER to continue Information is displayed about the synchronization status of the server e g synchronization with the NTP server UTC reference time etc You also see confirmation that the server is now configured to use a time server When you start the ingest on a server there is a check to see if frames aleady exist on t...

Page 35: ...tatic_lines_show_z true false Enables the Z axis to be displayed for a stationary line false moving_lines_show_x true false Enables the X axis to be displayed for a moving line true moving_lines_show_z true false Enables the Z axis to be displayed for a moving line true triangulation_lines_show_x true false Enables the X axis to be displayed in triangulation mode false area_rendering_limit atkline...

Page 36: ...stomizing the BEPlay Remote Controls It is possible to change the default action assignation of the white BEPlay buttons operational block 2 and 3 by modifying the remoteConfig json file in the home xeebra bin directory The configuration file consists of two parts The first part lists the names of the available buttons and the actions that can be assigned to each button The available buttons are T...

Page 37: ..._ON_SECONDARY UI SHOW_HIDE_OVERLAY_CAM SHOW_HIDE_TIMECODE SHOW_HIDE_EVENT_LIST SHOW_HIDE_VIDEO_BROWSING Player MINUS_ONE_THIRD_FIELD PLAY_IN_SLOMO PLUS_ONE_THIRD_FIELD MINUS_ONE_FIELD PLUS_ONE_FIELD MINUS_TEN_FIELDS PLUS_TEN_FIELDS MINUS_TEN_SECONDS INVERT_PAUSE_STATE PAUSE PLAY_16_PERCENT PLAY_25_PERCENT PLAY_33_PERCENT PLAY_50_PERCENT PLAY_100_PERCENT PLAY_200_PERCENT PLAY_300_PERCENT PLAY_500_P...

Page 38: ...d at startup Changes while the Client application is running will be taken into account at the next restart To reset the buttons to their default assignation you can delete the remoteConfig json file Xeebra will automatically regenerate it at the next Client application restart If the format of the configuration file is not valid a warning message will appear at the startup of the Client applicati...

Page 39: ... blue check mark 3 To reconfigure the X keys controller repeat the following steps for each key a In the Layout tab double click the key you want to configure You can also select the key in question on your X keys controller b The Macro programming window opens c Switch to the Keystrokes tab In this tab keystrokes are captured while you type them d Hold down the ALT keyboard button LAlt will appea...

Page 40: ...ss of the button represents the release of the button l Click Save 4 Open the File menu and select Write to Device The Macro List offers a view of every macro you programmed with more detailed information about each macro 32 March 2022 Issue 2 6 G ...

Page 41: ...sconnect the device from MW3 1 and it is now safe to plug it into a Linux box for use 7 If you ever need to reprogram the X keys just plug it in launch MW3 1 and follow the prompts but make sure you change the endpoint Step 6 when you finish Default keypad shortcuts can be found in the Xeebra user manual appendices INSTALLATION AND CONFIGURATION MANUAL Xeebra 5 Configuration 33 ...

Page 42: ... person to monitor for a particular Xeebra server in more detail the health and status of its micro services to restart them in case of a problem and to export their logs It also allows to check in more detail certain system metrics Accessing the Services Management Tool The Services Management tool can be accessed via the following link http serverip 9081 34 March 2022 Issue 2 6 G ...

Page 43: ...lick the refresh button The backend components can have one of the following health statuses Passing green Warning orange Critical red In case of an error more detailed information can be viewed A search bar allows you to filter the list of components and quickly find a specific backend component INSTALLATION AND CONFIGURATION MANUAL Xeebra 6 Monitoring and Support 35 ...

Page 44: ...nd it might need to be replaced It is recommended to take action because if you lose another disk then you will lose the content and the system will not be available HDD disk health It checks the state of the internal disk Megaraid status It check for any problem with the LSI megaraid If there is a problem please contact EVS support Serf Health Status It checks for a degraded service state It shou...

Page 45: ...atus of Zookeeper After an installation all checks on the Health page will be in orange for a while This is because the data RAID must be built for the first time INSTALLATION AND CONFIGURATION MANUAL Xeebra 6 Monitoring and Support 37 ...

Page 46: ...tor their status You can also see whether the feeds are genlocked or not SDI Engine Version Current version number of the evs sxe sdi service Board Board type Brand of the SDI board Driver version Device driver version SDK version Version of the software development kit Firmware version Firmware version of the SDI board Genlock Status Generic genlock status of the SDI board Channel Contains inform...

Page 47: ...or No Signal There is no incoming video signal or the cable is disconnected Bad Signal The signal is not in the configured format Unknown There is no stream Running Status of the evs sxe sdi service SyncWithRef Indicates if the incoming video signal is genlocked Signal The Signal section lists the actual characteristics of the input signal monitored by the SDI adapter card The following informatio...

Page 48: ...f the Xeebra server For example total amount vs used storage number of storage partitions number of tracks etc 6 4 3 Sys Stats Tab The Sys Stats page displays real time statistics about the performance of various Linux subsystems CPU Memory I O Network etc 40 March 2022 Issue 2 6 G ...

Page 49: ...Percentage of CPU utilization that occurred while executing at the user level application System Percentage of CPU utilization that occurred while executing at the system level kernel Nice Percentage of CPU utilization that occurred while executing at the user level with nice priority IOWait Percentage of time that the CPU or CPUs were idle during which the system had an outstanding disk I O reque...

Page 50: ...ansfer sec Number of transfers per second that were issued to the device A transfer is an I O request to the device Multiple logical requests can be combined into a single I O request to the device A transfer is of indeterminate size Avg wait Average time in milliseconds for I O requests issued to the device to be served This includes the time spent by the requests in the queue and the time spent ...

Page 51: ...ets transmitting rate unit Kbytes second mac MAC address of the network interface connected Indicates if the network interface is physically connected to the network or not speed Speed of the network interface state Status of the network interface ip4 IP address of the network interface Either manually added or automatically assigned by DHCP dns IP address of the EVS DNS server gateway IP address ...

Page 52: ...orkload Commit percent of memory needed for current workload in relation to the total memory RAM swap Mem used Memory used excluding kernel usage Mem free Free memory available in kilobytes Mem used percent Percentage of memory used Swap This area displays the swap statistics Parameter Description Swap used Used swap in kilobytes Swap free Free swap in kilobytes Swap used percent Percentage of swa...

Page 53: ... 4 Temperature Tab The temperature page displays real time information about the temperature of the CPUs and CPU cores of the server INSTALLATION AND CONFIGURATION MANUAL Xeebra 6 Monitoring and Support 45 ...

Page 54: ...information is displayed about each ingest 1 sdi Type of connection to an input 2 IngestId Unique identifier assigned to the ingest 3 Destinations The number of video and audio target formats being generated by this ingest The target formats can be stored on the server in loop recording or streamed to a Multiviewer or both To display more detailed information about a particular ingest simply selec...

Page 55: ...ations area displays more detailed information about each target format being generated and where the target formats should be sent loop recording or streaming To view the details of a specific destination click its ID Content Track Id Track ID in the Content API Internal Track Id Track ID in the Storage API Type The type of content Destination Format Target resolution scan mode and frame rate Vid...

Page 56: ...s running in a Docker container to download the logs of all microservices or only a selection and to restart microservices that are down Restarting a Service To restart a specific service hover your mouse pointer over the service and click the Restart button 48 March 2022 Issue 2 6 G ...

Page 57: ...r mouse pointer over the service and click the Download Logs button A ZIP file containing the logs will be generated and downloaded on your computer having the following filename format service name _ date To download the log files of all services click the Download Logs button at the top of the page A ZIP file containing the logs will be generated and downloaded on your computer having the follow...

Page 58: ...as crashed and you can no longer restart it or if you have imported new license keys and you want them to take effect you will have to reset your Xeebra system making use of the Reset script Reset Script The Reset script is a script that stops and restarts the Xeebra services It also cleans the video content stored on the Xeebra server if requested by the user To open the script double click the R...

Page 59: ... stored on the Xeebra server untouched 2 Clean All If you select this option the script will restart the Xeebra services removes all video content stored on the Xeebra server and delete all tracks The tracks will have to be recreated afterwards INSTALLATION AND CONFIGURATION MANUAL Xeebra 6 Monitoring and Support 51 ...

Page 60: ... files are generated and exported to the Logs directory on your desktop in the form of a tgz file with the following filename format evs_logs_ hostname _YYYYMMDD_ HHMMSS tgz You can either remove or keep all the log files 2 Enter Y and press ENTER to remove all logs Enter N and press ENTER to keep all logs 3 Tap or click X to close the terminal window again 6 10 Support and HealthCheck Tool The Su...

Page 61: ... Xeebra client workstations and this from any client workstation in the same network to shut down all client workstations and servers in the network in a safe and timely manner For more information about how to install set up and use the Support HealthCheck tool see the Xeebra Support Tool application note INSTALLATION AND CONFIGURATION MANUAL Xeebra 6 Monitoring and Support 53 ...

Page 62: ......

Page 63: ......

Page 64: ......

Reviews: