Advertisement

INSTALLATION AND CONFIGURATION MANUAL
Xeebra
Version 2.6 | March 2022

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Xeebra and is the answer not in the manual?

Questions and answers

Summary of Contents for EVS Xeebra

  • Page 1 INSTALLATION AND CONFIGURATION MANUAL Xeebra Version 2.6 | March 2022...
  • Page 3 You will find the full list of addresses and phone numbers on the following webpage: http://www.evs.com/contact. User Manuals on EVS Website The latest version of the user manual, if any, and other user manuals on EVS products can be found at the EVS download center, on the following webpage: https://www.evs.com/en/download-area. Xeebra  | Disclaimer |...
  • Page 5: Table Of Contents

    INSTALLATION AND CONFIGURATION MANUAL Contents Disclaimer Contents What's New? 1. Introduction 1.1. Product Overview 1.1.1. The Xeebra VAR System 1.1.2. Setup 2. Requirements 2.1. Network Requirements 2.2. Other Technical Requirements 3. Installation 3.1. First Install 3.2. Upgrade 4. Cabling 4.1. Connecting the Client Workstation and Servers 4.2.
  • Page 6 5.4.1. License Manager 5.5. Synchronizing the Time of the Xeebra Servers 5.5.1. Introduction 5.5.2. Configuring the NTP Server 5.5.3. Configuring an NTP Client 5.6. Customizing the Offside Line Display 5.7. Customizing the BEPlay Remote Controls 5.8. Customizing the X-Keys Controller 6. Monitoring and Support 6.1.
  • Page 7: What's New

    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.
  • Page 9: Introduction

    The Xeebra VAR System Xeebra is an instant video review system that enables referees to focus on the content review with the utmost clarity and convenience. It allows the referee to see a number of HD camera feeds on up to two (touchscreen) monitors in a fast, synchronized and efficient way from a variety of locations.
  • Page 10: Requirements

    The Xeebra client workstation and the Xeebra server hardware need to be connected by a 1 GB link (RJ45). When the Xeebra server is connected to 3 clients, or 2 clients with 2 screens, it is necessary to team 2 x 1GB RJ45 cables to double the bandwidth between the client and the server. These links can pass through a switch or be a direct connection.
  • Page 11: Other Technical Requirements

    Even though one client can connect to up to 6 different servers, there is a rule as to how many clients can connect at the same time to a single server: • 2 clients with 2 screens each • 1 client with 2 screens + 2 clients with 1 screen each. Xeebra  | 2. Requirements |...
  • Page 12: Installation

    3. Installation 3.1. First Install Installation Requirements To be able to install Xeebra 2.6 for the first time, the following requirements should be fulfilled: • Xeebra hardware with RAID (XEE-2U-4 or PMX-2U-4), • Xeebra client hardware (XEC-4100S or Lenovo P330/340), •...
  • Page 13 Use a USB port on the laptop instead. 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. Click OK to continue. Xeebra  | 3. Installation |...
  • Page 14 Press F11 to enter the Boot menu. If you're asked to enter a password: evsdvb. Select your USB key as boot device. From the EVS Production menu, select the desired installation package and press ENTER: ◦ Xeebra Server 2.6 - CentOS 7.9 2009 or ◦...
  • Page 15 INSTALLATION AND CONFIGURATION MANUAL ◦ If you are upgrading a Xeebra server, please wait for 2-3 minutes and open the Services Management tool: http://127.0.0.1:9081 to check if everything is ok on the Health page (green or at least orange status for the resolv.conf check) before starting to use Xeebra.
  • Page 16: Upgrade

    3.2. Upgrade This procedure is only to be followed when you want to upgrade from one Xeebra 2.x version to another 2.x version. Prerequisites To be able to upgrade Xeebra, the following prerequisites should be fulfilled: • Xeebra hardware with RAID (XEE-2U-4 or PMX-2U-4), •...
  • Page 17 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. Click OK to continue. Wait until the ISO file has been completely written to the USB key. Xeebra  | 3. Installation |...
  • Page 18 After the machine reboot, please wait a few minutes before starting the Client: ◦ If you are upgrading a Xeebra server, please wait for 2-3 minutes and open the Services Management tool: http://127.0.0.1:9081 to check if everything is ok on the Health page (green or at least orange status for the resolv.conf check) before starting to use Xeebra.
  • Page 19 INSTALLATION AND CONFIGURATION MANUAL ◦ 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. Xeebra  | 3. Installation |...
  • Page 20: Cabling

    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.
  • Page 21: Securing The Sdi Cables

    Xeebraserver. A maximum of two SLSM 3x cameras can be connected. • A SLSM 4x camera has 4 SDI Outs that have to be connected with 4 SDI In connectors of the Xeebra server. A maximum of two SLSM 4x cameras can be connected.
  • Page 22: Connecting The Video Monitors

    Up to two video monitors can be connected to a Xeebra server. Supported Video Monitors Xeebra supports any 16/9 resolution. In case the resolution is higher, black bands will be displayed at the top and bottom of your screen. 4K monitors are not supported.
  • Page 23: Connecting The Beplay Remote, Shuttlepro V2 And X-Keys

    Connecting the Beplay Remote, ShuttlePRO v2 and X-Keys The Beplay remote, ShuttlePRO v2 and X-keys are connected via USB to the Xeebra server. The device is recognized as soon as it is plugged in. Should you encounter any functional issues with the ShuttlePRO Mark In and Mark Out buttons when running Linux CentOS, please contact EVS Support for assistance.
  • Page 24: Configuration

    Address and Hostname Manually Changing the Server's Management IP Address To manually change the IP address of a Xeebra server, proceed as follows: In the top left-hand corner of your desktop, open the Applications menu and select Settings > Network Connections.
  • Page 25 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: Open a terminal window. Type the following command: sudo nmtui Xeebra  | 5. Configuration |...
  • Page 26 The Network Manager text user interface opens. To navigate in the Network Manager TUI, use the arrow keys or press TAB to step forwards and press SHIFT + TAB to step back through the options. Press ENTER to select an option. The SPACEBAR toggles the status of a checkbox.
  • Page 27: Nic Teaming

    5.2. NIC Teaming You can combine or aggregate the ports of a particular network interface card on the Xeebra server, in order to increase the throughput beyond that of a single connection and to provide redundancy in case one of the links should fail.
  • Page 28: Mapping The Touchscreens

    Please confirm which device number to add: Press ENTER to complete your selection. You will be asked to select the expected teaming mode. Select expected teaming mode: 1. Active/Backup 2. Load Sharing 3. LACP Please enter your choice: Enter the number of the desired teaming mode. 5.3.
  • Page 29: 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 in a terminal window. Xeebra  | 5. Configuration |...
  • Page 30 The following system information is displayed: • computer name • server serial number • customer information (company name, first and last name, email, phone) • global expiry date • computer description • a list of installed license keys. If no license keys have been installed yet, this list will be empty. An options menu is also provided.
  • Page 31 Press ENTER again to return to the main menu. Viewing the Customer Information To view the customer information you just entered, type 1 (View Current Customer Information) and press ENTER. Available Licenses The following licenses are currently available for Xeebra: Feature Essential License Plus License Base Package 11 (client installed on X-Client;...
  • Page 32: Synchronizing The Time Of The Xeebra Servers

    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).
  • Page 33: Configuring An Ntp Client

    NTP server, the following message will be displayed: 'This machine is not configured for time synchronization'. Select 2 and press ENTER. The Xeebra services are stopped, the Time Service is installed and the Xeebra services are restarted again. You are prompted to clear all tracks.
  • Page 34 Add the IP address of the NTP server you want to use as reference point and press ENTER to continue. The Xeebra services are stopped, the Time Service is installed and the Xeebra services are restarted again. You are prompted to clear all tracks.
  • Page 35: Customizing The Offside Line Display

    The color and width of the lines, and the area of the pitch used to display offside events can be changed in the json file located in the folder: /home/evs/.config/evs/xeebra/offside.json The following table describes the parameters related to the offside line display.
  • Page 36: Customizing The Beplay Remote Controls

    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.
  • Page 37 PLAY_MINUS_33_PERCENT PLAY_MINUS_50_PERCENT PLAY_MINUS_100_PERCENT PLAY_MINUS_200_PERCENT PLAY_MINUS_300_PERCENT PLAY_MINUS_500_PERCENT PLAY_MINUS_800_PERCENT PLAY_MINUS_1600_PERCENT The second part contains the configuration of each button. The configuration file contains a section for each button. Each section contains three fields: • key: Name of the button. Xeebra  | 5. Configuration |...
  • Page 38 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 application: 'Invalid format for BEPlay configuration file.
  • Page 39: Customizing The X-Keys Controller

    The selected function will appear on a separate line as a press macro event. Press and release the desired keyboard buttons and release the ALT keyboard button. The pressed and released keyboard buttons will appear on an new line a as press macro event. Xeebra  | 5. Configuration |...
  • Page 40 For example, m↓ m↑ <LAlt>↑, where ↓ represents the press of the button, ↑ represents the release of the button. Click Save. 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.
  • Page 41 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. Xeebra  | 5. Configuration |...
  • Page 42: Monitoring And Support

    The Services Management tool is a web tool which allows a system administrator or EVS support 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.
  • Page 43: Dashboard Page

    6.2. Dashboard Page The Dashboard page allows you to view at a glance the status of the different Xeebra micro-services and backend components. To get the latest status, click the refresh button. The backend components can have one of the following health statuses: •...
  • Page 44: Health Page

    • Thinpool free space: It checks the space available for the Docker backend storage. If this check is not passing, please call EVS support as we might need to either free-up some space or allocate more disk space. 36 | March 2022 | Issue 2.6.G...
  • Page 45 Zookeeper OK status: Checks the status 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. Xeebra  | 6. Monitoring and Support |...
  • Page 46: Metrics Page

    The SDI tab allows you to view the incoming and outgoing SDI feeds, check their technical details and monitor 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 •...
  • Page 47 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.
  • Page 48: Sx Storage Tab

    6.4.2. Sx Storage Tab The Sx Storage tab displays information about the storage of 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.).
  • Page 49 I/O request. Idle Percentage of time that the CPU or CPUs were idle and the system did not have an outstanding disk I/O request. %Used Total percentage of CPU utilization. Xeebra  | 6. Monitoring and Support |...
  • Page 50 Disks This area displays the activities by the individual block devices. Parameter Description Device Device (or partition) name as listed in the /dev directory. Avg queue len Average queue length of the requests that were issued to the device. Reads (sector)/sec Number of sectors (kilobytes, megabytes) read from the device per second.
  • Page 51 DHCP. IP address of the EVS DNS server. gateway IP address of the router used to access external networks. dhcp Indicates if the IP address of the network interface was manually or automatically (via DHCP) assigned. Xeebra  | 6. Monitoring and Support |...
  • Page 52 Memory This area displays memory statistics. Parameter Description Buffers Memory used as buffers by the kernel in kilobytes. Cached Memory used to cache data by the kernel in kilobytes. Commit Memory in kilobytes needed for current workload. Commit percent % of memory needed for current workload in relation to the total memory (RAM+swap).
  • Page 53: Temperature Tab

    INSTALLATION AND CONFIGURATION MANUAL 6.4.4. Temperature Tab The temperature page displays real-time information about the temperature of the CPUs and CPU cores of the server. Xeebra  | 6. Monitoring and Support |...
  • Page 54: Ingests Tab

    6.4.5. Ingests Tab The Ingests tab displays more detailed information about the ongoing ingests. Ingests List The area at the top of the Ingests tab lists the ingests currently being performed by the server. The Refresh button allows you to update this list. The following general information is displayed about each ingest: sdi: Type of connection to an input.
  • Page 55 Internal Track Id: Track ID in the Storage API. • Type: The type of content • Destination Format: Target resolution, scan mode and frame rate. • Video Encoder: Codec parameters. • backends: Target container: storage or UCP streaming. Xeebra  | 6. Monitoring and Support |...
  • Page 56: Docker Page

    6.5. Docker Page The Docker page allows you to check the status of the microservices 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.
  • Page 57: Services Page

    INSTALLATION AND CONFIGURATION MANUAL 6.6. Services Page The Services page allows you to check the status of the native microservices running on Xeebra, and to restart them in case they are down. Downloading Log Files You can download the log files of a particular service, or of all services: •...
  • Page 58: Versions Page

    Use Cases If your Xeebra system has 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.
  • Page 59 INSTALLATION AND CONFIGURATION MANUAL Restart Services: If you choose this option, the script will restart the Xeebra services and leave the video content stored on the Xeebra server untouched. 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.
  • Page 60: Consulting System Log Files And Crash Dumps

    Exporting System Log Files To generate and export the latest Xeebra system log files, proceed as follows: Double-click or double-tap the GetLogs icon on your Xeebra server or client workstation desktop. A terminal window is opened. The various system log 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_...
  • Page 61 INSTALLATION AND CONFIGURATION MANUAL • to detect if the Xeebra system has been set up properly, and to see if there are no issues preventing the system from functioning. • to shut down the Xeebra Client application of all Xeebra client workstations, and this from any client workstation in the same network.

Table of Contents

Save PDF