Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This section covers installing Squirro on a supported Linux system, either Red Hat® Enterprise Linux® (RHEL) or its open source derivative CentOS Linux.

...

If some of these conditions can not be met, please contact support.

Linux setup

The installation of the base system is not covered in this manual. A fully functional RHEL or CentOS installation is assumed to be set up. The supported versions of these Linux distributions are documented on the System Requirements (servers) page.

...

Create the file /etc/yum.repos.d/squirro.repo. The exact content of the file will be provided to you by Squirro support, when delivering the license.

The following is an example for RHEL 6.57, though the username and password for the YUM repository have not been filled in:

...

languagetext
title/etc/yum.repos.d/squirro.repo

...

Squirro depends on Python, which is provided by a separate YUM repository. Execute the following commands to set up this repository. Please answer y for yes in response to the yum install command prompts.

...

Code Block
languagetext
title/etc/yum.repos.d/squirro.repo
[squirro-stable]
name=Squirro - Red Hat Enterprise

...

 

...

languagetext
title/etc/yum.repos.d/squirro.repo

...

Linux 7 - Stable
baseurl=https://<user name>:<password>@mirror.squirro.net/centos/7/stable/$basearch/<specific version or 'latest'>/
enabled=1
gpgkey=https://mirror.squirro.net/

...

rhel/RPM-GPG-KEY-squirro-stable
gpgcheck=1
sslverify=1
metadata_expire=300

Storage Node Installation

Installation of the storage node happens with two separate packages. The first package installs the required Linux users and the second installs the services. Furthermore, we also need to explicitly install a few dependencies. Use the following commands for the installation:

...

Code Block
yum install java-1.8.0-openjdk

...

...


Squirro

...

Code Block
yum install python27-python

EPEL and libgomp (Skip this in "Offline" mode)

...

Code Block
languagebash
yum install wget
wget http://download.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
yum localinstall epel-release-6-8.noarch.rpm
yum install libgomp
Code Block
languagebash
yum install wget
wget https://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/e/epel-release-7-12.noarch.rpm
yum localinstall epel-release-7-12.noarch.rpm

Squirro Cluster node

Note

You can choose to run MySql server and Redis servers remotely, i.e. not residing on the Squirro Cluster Node if you go through the trouble of setting up MySql and Redis Server installations with a specific configuration.

To set up Squirro with remote MySql server and Redis server "Backends", please create a readable file /etc/squirro/backends.ini with the content:

Code Block
is_mysql_server_remote = true
is_redis_server_remote = true

...

...

n/a

...

The default MySQL variant for MySQL on RHEL7/CentOS7 is MariaDB.

Please execute the following before you proceed further:

Code Block
languagebash
echo "Installing Squirro dependency MariaDB"
yum install -y mariadb-server
yum install -y policycoreutils-devel
if [ -f /lib/systemd/system/mariadb.service ]; then
    systemctl stop mariadb
    mv /lib/systemd/system/{mariadb,mysqld}.service
    systemctl enable mysqld
    systemctl start mysqld
fi

Once we have released MariaDb RPM packages, the corresponding upgrade will undo this indirection.


Installation of the Squirro cluster node happens with two separate packages. The first package installs the required Linux users and the second installs the services. Use the following commands for the installation:

Code Block
languagebash
yum install squirro-cluster-node-users
yum install squirro-cluster-node

...

Finally start the Squirro Services

service monit start monit -g all-manual start
RHEL6 / Centos 6RHEL7 / Centos 7
Code Block
languagebash


Code Block
languagebash
echo "Starting Squirro services"
cd /lib/systemd/system
for service in $(ls sq*d.service); do
    echo "Starting $service"
    systemctl restart $service
done
Note
We are deprecating the use of monit and have removed monit from our centos 7 installations already.



Multi-node cluster setup

There are some additional steps that need to be performed when you wish to run Squirro across multiple nodes, as some orchestration between cluster members is needed. 

...