MID v2.1.1 Installation Guide

All to know on installing MaXX Interactive Desktop on both Linux and FreeBSD.

RHEL/CentOS 7 Guide (x64)

This Installation Guide will allow you to install the MaXX Desktop on a RedHat or CentOS Linux Distribution from version 7 and above.
Release Notes for Indigo MAX IMPACT v2.1.1

Backup Older MaXX Desktop Installation

To guaranty a successful installation or upgrade, you must backup your current MaXX Desktop installation.  Follow the simple instructions below.

It is VERY IMPORTANT to backup your older MaXX Desktop installation outside a running MaXX Desktop session.  Ideally from the text console or from another desktop session like GNOME or KDE.

1. Backup you current MaXX Desktop Installation.

$ su -
cd /opt
mv MaXX MaXX-old
exit
$

2. Run the following commands (AS ROOT) to remove deprecated files from older version 2.0 of MaXX Desktop.

This step is optional in case you modified or installed old MaXX GTK Themes. At this point you probably know what your are doing...

$ sudo -s
rm /usr/share/themes/IndigoMagic
rm /usr/share/themes/Rio
rm /usr/share/themes/Gotham
rm /usr/share/themes/MaXX*
exit
$

separator-blue-line.png

Prerequisites

Below are the prerequisites for installing and running MaXX Desktop and some older X11/Motif applications...

Storage Space Requirements

120MB   in  /tmp  partition (something it is part of the / 'root' partition)
500MB   in  /opt  partition (something it is part of the / 'root' partition)

Software Package Requirements

Fedora users must replace 'yum' command with 'dnf'

$ su -
yum update
yum install cpp libXaw pavucontrol ncurses

yum install epel-release      // <-- additional repo for cool CentOS packages

// Older xfonts required as a backward compatibility safety net
yum install xorg-x11-fonts-misc.noarch  bitmap-fonts-compat.noarch
yum install xorg-x11-fonts-75dpi.noarch xorg-x11-fonts-ISO8859-1-75dpi.noarch 
yum install xorg-x11-fonts-100dpi.noarch xorg-x11-fonts-ISO8859-1-100dpi.noarch 

// Mandatory Fonts for Modern Look
yum install dejavu-sans-mono-fonts google-noto-fonts-common google-noto-sans-fonts google-noto-mono-fonts google-noto-sans-ui-fonts

exit
$

separator-blue-line.png
Installation

Now let's install the MaXX Interactive Desktop onto your system.  Follow the simple instructions to download and run the installer.

You will need  ROOT access to run some of the commands...

Download and Install MaXX Interactive Desktop - Indigo MAX IMPACT v2.1.1

$ cd /tmp
$ wget https://s3.ca-central-1.amazonaws.com/cdn.maxxinteractive.com/maxx-desktop-installer/MaXX-Desktop-LINUX-x64-2.1.1-Installer.sh
$ chmod a+x MaXX-Desktop-LINUX-x64-2.1.1-Installer.sh
$ su
 ./MaXX-Desktop-LINUX-x64-2.1.1-Installer.sh
 exit
$

separator-blue-line.png

Post Installation - Upgrade User Preferences

This step is ONLY for MaXX Desktop users of v.2.1 whom are required to upgrade their User Preferences.

1. Run the following commands (UNDER YOUR NORMAL USER) to upgrade your MaXX Desktop User Preferences.

$ cd $HOME
$ /opt/MaXX/share/misc/HOME/MaXX-Desktop-v2.1.1-upgrade.sh
$

separator-blue-line.png

Almost Done

Log out or simply restart your computer to allow GDM to take into account the new addition.

Once your system is rebooted, you can now choose MaXX Interactive Desktop  from  GDM's available session menu.

To customize your environment, refer to this book.

Congratulation and Welcome to MaXX Desktop!

 

Ubuntu Guide (x64)

This Installation Guide will allow you to install the MaXX Desktop on an Ubuntu Linux Distribution from version 18.04 LTS and above.

We cannot confirm if it works 100% for all derivatives of Ubuntu, but it should.

Release Notes for Indigo MAX IMPACT  v2.1.1

Backup Older MaXX Desktop Installation

To guaranty a successful installation or upgrade, you must backup your current MaXX Desktop installation.  Follow the simple instructions below.

It is VERY IMPORTANT to backup your older MaXX Desktop installation outside a running MaXX Desktop session.  Ideally from the text console or from another desktop session like GNOME or KDE.

1. Backup you current MaXX Desktop Installation.

$ sudo -s
cd /opt
mv MaXX MaXX-old
exit
$

2. Run the following commands (AS ROOT) to remove deprecated files from older version 2.0 of MaXX Desktop.

This step is optional in case you modified or installed old MaXX GTK Themes. At this point you probably know what your are doing...

$ sudo -s
rm /usr/share/themes/IndigoMagic
rm /usr/share/themes/Rio
rm /usr/share/themes/Gotham
rm /usr/share/themes/MaXX*
exit
$

separator-blue-line.pngPrerequisites

Below are the prerequisites for installing and running MaXX Desktop and some older X11/Motif applications...

Storage Space Requirements

120MB   in  /tmp  partition (something it is part of the / 'root' partition)
500MB   in  /opt  partition (something it is part of the / 'root' partition)

Software Package Requirements

$ sudo -s
apt update
apt install cpp libxaw7 libjpeg62 libgtk2.0-0 x11-apps freeglut3
apt install pavucontrol   <-- Audio control panel in MaXX Desktop

// Older xfonts required as a backward compatibility safety net
apt install xfonts-100dpi xfonts-75dpi 

// Mandatory Fonts for Modern Look
apt install fonts-dejavu fonts-noto

// Additional Fonts for Japanese support
apt install fonts-noto-cjk fonts-noto-cjk-extra fonts-noto-cjk

// Terminal Info libs for Ubuntu 18.04
apt install libtinfo5
ln -s /usr/lib64/libtinfo.so.6 /usr/lib64/libtinfo.so.5

exit
$

separator-blue-line.png

Installation

Now let's install the MaXX Interactive Desktop onto your system.  Follow the simple instructions to download and run the installer.

You will need  superuser access to run some of the commands...

1. Download and Install MaXX Interactive Desktop - Indigo MAX IMPACT v2.1.1

$ cd /tmp
$ wget https://s3.ca-central-1.amazonaws.com/cdn.maxxinteractive.com/maxx-desktop-installer/MaXX-Desktop-LINUX-x64-2.1.1-Installer.sh
$ chmod a+x MaXX-Desktop-LINUX-x64-2.1.1-Installer.sh
$ sudo -s
 ./MaXX-Desktop-LINUX-x64-2.1.1-Installer.sh
 exit
$

separator-blue-line.png

Post Installation - Upgrade User Preferences

This step is ONLY for MaXX Desktop users of v.2.1 whom are required to upgrade their User Preferences.

1. Run the following commands (UNDER YOUR NORMAL USER) to upgrade your MaXX Desktop User Preferences.

$ cd $HOME
$ /opt/MaXX/share/misc/HOME/MaXX-Desktop-v2.1.1-upgrade.sh
$

separator-blue-line.png

Almost Done

Log out or simply restart your computer to allow GDM to take into account the new addition.

Once your system is rebooted, you can now choose MaXX Interactive Desktop  from  GDM's available session menu.

To customize your environment, refer to this book.

Congratulation and Welcome to MaXX Desktop!

 

Debian Guide (x64)

This Installation Guide will allow you to install the MaXX Desktop on a Debian Linux Distribution from version 9 and above.

We cannot confirm if it works 100% for all derivatives of Debian, but it should.

Release Notes for Indigo MAX IMPACT  v2.1.1

Backup Older MaXX Desktop Installation

To guaranty a successful installation or upgrade, you must backup your current MaXX Desktop installation.  Follow the simple instructions below.

It is VERY IMPORTANT to backup your older MaXX Desktop installation outside a running MaXX Desktop session.  Ideally from the text console or from another desktop session like GNOME or KDE.

1. Backup you current MaXX Desktop Installation.

$ sudo -s
cd /opt
mv MaXX MaXX-old
exit
$

2. Run the following commands (AS ROOT) to remove deprecated files from older version 2.0 of MaXX Desktop.

This step is optional in case you modified or installed old MaXX GTK Themes. At this point you probably know what you're doing...

$ sudo -s
rm /usr/share/themes/IndigoMagic
rm /usr/share/themes/Rio
rm /usr/share/themes/Gotham
rm /usr/share/themes/MaXX*
exit
$

separator-blue-line.pngPrerequisites

Below are the prerequisites for installing and running MaXX Desktop and some older X11/Motif applications...

Storage Space Requirements

120MB   in  /tmp  partition (something it is part of the / 'root' partition)
500MB   in  /opt  partition (something it is part of the / 'root' partition)

Software Package Requirements

$ sudo -s
apt-get update
apt-get install cpp libxaw7 libjpeg62-turbo libgtk2.0-0
apt-get install pavucontrol                 <-- Audio control panel in MaXX Desktop

// Debian 9
apt-get install lib64tinfo5 

// Debian 10
apt-get install libtinfo5


// Older xfonts required as a backward compatibility safety net
apt-get install xfonts-100dpi xfonts-75dpi 

// Mandatory Fonts for Modern Look
apt-get install fonts-dejavu fonts-noto fonts-noto-core fonts-noto-extra fonts-noto-ui-core fonts-noto-ui-extra fonts-noto-mono

exit
$

separator-blue-line.pngInstallation

Now let's install the MaXX Interactive Desktop onto your system.  Follow the simple instructions to download and run the installer.

You will need  superuser access to run some of the commands...

1. Download and Install MaXX Interactive Desktop - Indigo MAX IMPACT v2.1.1

$ cd /tmp
$ wget https://s3.ca-central-1.amazonaws.com/cdn.maxxinteractive.com/maxx-desktop-installer/MaXX-Desktop-LINUX-x64-2.1.1-Installer.sh
$ chmod a+x MaXX-Desktop-LINUX-x64-2.1.1-Installer.sh
$ sudo -s
 ./MaXX-Desktop-LINUX-x64-2.1.1-Installer.sh
 exit
$

separator-blue-line.png

Post Installation - Upgrade User Preferences

This step is ONLY for MaXX Desktop users of v.2.1 whom are required to upgrade their User Preferences.

1. Run the following commands (UNDER YOUR NORMAL USER) to upgrade your MaXX Desktop User Preferences.

$ cd $HOME
$ /opt/MaXX/share/misc/HOME/MaXX-Desktop-v2.1.1-upgrade.sh
$

separator-blue-line.pngAlmost Done

Log out or simply restart your computer to allow GDM to take into consideration the new addition.

Once your system is rebooted, you can now choose MaXX Interactive Desktop  from  GDM's available session menu.

To customize your environment, refer to this book.

Congratulation and Welcome to MaXX Desktop!

 

Manjaro/Arch Linux - Guide (x64)

This Installation Guide will allow you to install the MaXX Desktop on a Manjaro Arch Linux Distribution from version 20 and above.

We cannot confirm if it works 100% for all derivatives of Arch Linux, but it should.

Release Notes for Indigo MAX IMPACT  v2.1.1

Backup Older MaXX Desktop Installation

To guaranty a successful installation or upgrade, you must backup your current MaXX Desktop installation.  Follow the simple instructions below.

It is VERY IMPORTANT to backup your older MaXX Desktop installation outside a running MaXX Desktop session.  Ideally from the text console or from another desktop session like GNOME or KDE.

1. Backup you current MaXX Desktop Installation

$ sudo -s
cd /opt
mv MaXX MaXX-old
exit
$

2. Run the following commands (AS ROOT) to remove deprecated files from older version 2.0 of MaXX Desktop.

This step is optional in case you modified or installed old MaXX GTK Themes. At this point you probably know what your are doing...

$ sudo -s
rm /usr/share/themes/IndigoMagic
rm /usr/share/themes/Rio
rm /usr/share/themes/Gotham
rm /usr/share/themes/MaXX*
exit
$

separator-blue-line.png

Prerequisites

Below are the prerequisites for installing and running MaXX Desktop and some older X11/Motif applications...

Storage Space Requirements

120MB   in  /tmp  partition (something it is part of the / 'root' partition)
500MB   in  /opt  partition (something it is part of the / 'root' partition)

Software Package Requirements

1. Here is the step required to install libjpeg6 missing dependency

Before logging into MID for the first time, ensure libjpeg6 is installed. It can be found in the Arch repositories as
libjpeg6-turbo.

sudo pacman -S libjpeg6
// reference to libjepg6-turbo https://www.archlinux.org/packages/community/x86_64/libjpeg6-turbo/

2. Here is the step required to install libtinfo from ncurses library missing dependency

libtinfo is an ncurses library which is included in most Linux distributions as part of most ncurses packages.

However in Arch it is not included with ncurses, but you can easily install it from the Arch User Repository (AUR) via the ncurses compatibility library: ncurses5-compat-libs

sudo pamac install ncurses5-compat-libs

// reference to ncurses5-compat-libs https://aur.archlinux.org/packages/ncurses5-compat-libs/ (edited) 
// aur.archlinux.org
// AUR (en) - ncurses5-compat-libs
// System V Release 4.0 curses emulation library, ABI 5

3. Mandatory Fonts for Modern Look fonts are required to run MaXX Desktop 2.1.1. Make sure they are present before you login.

$ sudo pacman -S noto-fonts noto-fonts-extra

fonts-dejavu

separator-blue-line.pngInstallation

Now let's install the MaXX Interactive Desktop onto your system.  Follow the simple instructions to download and run the installer.

You will need  root access to run some of the commands...

1. Download and Install MaXX Interactive Desktop - Indigo MAX IMPACT v2.1.1

$ cd /tmp
$ wget https://s3.ca-central-1.amazonaws.com/cdn.maxxinteractive.com/maxx-desktop-installer/MaXX-Desktop-LINUX-x64-2.1.1-Installer.sh
$ chmod a+x MaXX-Desktop-LINUX-x64-2.1.1-Installer.sh
$ su
 ./MaXX-Desktop-LINUX-x64-2.1.1-Installer.sh
 exit
$

separator-blue-line.pngPost Installation - Upgrade User Preferences

This step is ONLY for MaXX Desktop users of v.2.1 whom are required to upgrade their User Preferences.

1. Run the following commands (UNDER YOUR NORMAL USER) to upgrade your MaXX Desktop User Preferences.

$ cd $HOME
$ /opt/MaXX/share/misc/HOME/MaXX-Desktop-v2.1.1-upgrade.sh
$

separator-blue-line.png

Almost Done

Log out or simply restart your computer to allow GDM to take into consideration the new addition.

Once your system is rebooted, you can now choose MaXX Interactive Desktop  from  GDM's available session menu.

To customize your environment, refer to this book.

Congratulation and Welcome to MaXX Desktop!