[English]
README_CentOS.TXT        MATROX GRAPHICS INC.           2018.04.20

                        Matrox Mura IPX Series
                   Linux System Update version 1.1.0
                      (For CentOS distribution)


Contents
========

Section 01 - System requirements
Section 02 - OS installation
             1 - Operating system
             2 - Display/Login manager
Section 03 - Dependencies
             1 - Mono
             2 - Matrox C-Series driver
             3 - VLC
             4 - Other
Section 04 - DisplayWall package
             1 - Install
             2 - Uninstall
             3 - Update


Section 01 - System requirements
================================

This release was tested on CentOS 7.2 using the following:

Kernel: 3.10.0-327 and 3.10.0-514

X versions: 1.17.2

Mono versions: 4.8* or later

Login manager: kdm

Cards:

    - MURA-IPX-I4DF
    - MURA-IPX-I4DHF
    - C680


Section 02 - OS installation
============================

1 - Operating system
--------------------

When installing CentOS, you need to select the proper software.
For the best initial configuration, select "KDE Plasma Workspaces"
as the base environment, then add the "Development Tools" option. 
The specific packages required for installation are GCC and 
kernel-devel.The rest of the initial OS configuration is user 
specific.

Once the OS is installed, the following additional repositories 
need to be added: 

    1. EPEL (https://fedoraproject.org/wiki/EPEL)
    2. RPMFusion (https://rpmfusion.org)
    3. Mono (http://www.mono-project.com - Xamarin packages)

For instructions on how to add the repositories to CentOS, see the 
corresponding web sites.

Also, the CentOS firewall needs to be configured to allow 
access to the Network API. Access to port 23 needs to be granted. 
This can be done by running the following commands as root:

    firewall-cmd --permanent --add-port=23/tcp
    firewall-cmd --reload

Note: The kernel must be updated to version 3.10.0-514 *before* the 
C-Series drivers and DisplayWall package are installed. The 
proper version of the kernel-devel package must also be installed. 
If you upgrade the kernel after you install your drivers and 
DisplayWall package, you will need to uninstall both, and then 
reinstall them.

2 - Display/Login manager
-------------------------

During the installation of CentOS, one of the following desktop 
environments can be installed: GNOME Desktop or KDE Plasma 
Workspaces. 

Note: On CentOS, the only desktop environment supported by the 
VideoWall package is KDE Plasma Workspaces. Make sure you install 
and run KDE Plasma Workspaces.


Section 03 - Dependencies
=========================

1 - Mono
--------

IMPORTANT: Multiple versions of Mono packages are available on 
mono-project.com. The DisplayWall package was developed and tested 
with original Xamarin packages only. Make sure you select and use 
Xamarin repositories. 

Once the Mono repositories are correctly added, Mono can be 
installed by running the following command as root:

    yum install mono-complete

2 - Matrox C-Series driver
--------------------------

WARNING: THE MURA IPX SERIES PACKAGE SUPPORTS ONLY THE MATROX 
C-SERIES LINUX DRIVER (VERSION 15.302.2201) PROVIDED ON THE MATROX 
WEB SITE.


To download the latest C-Series drivers, see the Matrox web site 
(http://www.matrox.com/graphics/en/support/drivers/download/?id=667).

The driver comes as a .run file. This file must be executed as root.

The installation offers multiple choices. We recommend simply 
installing the driver (i.e. don't create a distro-specific package).

IMPORTANT: If, while the C-Series driver is being installed, the 
system is running X, don't try to switch to a virtual terminal or 
kill X. Run the installer from the terminal in graphical mode.

3 - VLC
-------

The DisplayWall package needs a VLC media player. If the 
repositories listed above are properly set up, the media player 
can be installed from the default repositories using your preferred 
package manager.

4 - Other
---------

The Mura IPX Series package needs telnet-server to run. This can be 
installed using your preferred package manager.

The Mura IPX Series package includes Chrome runtime to display HTML 
sources. For this to work, the following dependencies must be 
installed:

nss
gtk+
gtkglext-libs


Section 04 - DisplayWall package
================================

1 - Install
-----------

To install the DisplayWall package, simply execute the .run package 
as root. A reboot is required after the installation has completed.
Upon installation, make sure that netapi/chrome-sandbox is owned by 
root and its permissons are set to 4755.


2 - Uninstall
-------------

An uninstall script is provided to remove the DisplayWall package 
and all components installed by it. This script is located in the 
same directory that was specified during installation and is called 
"uninstall". Run this script as root.

3 - Update
----------

If a new Mura IPX Series package becomes available, uninstall the 
currently installed package by running the uninstall script 
before installing the new package.