Installation Prerequisites

Supported Operating Systems

The following is a list of the officially supported operating systems:

CentOS 6
Fedora 19
RedHat EL 6
SuSe Linux 11.1
Ubuntu Server 14.04
Windows 7
Windows 8
Windows 10
Windows Server 2008 R2
Windows Server 2012 R2

Browser Compatibility

Squore is compatible with many browsers. The following is the list of officially supported browsers:

Google Chrome 24 and up
Mozilla Firefox 17 and up
Apple Safari 6 and up
Microsoft Internet Explorer 8 and up
Microsoft Edge 20 and up

For All Systems

For a successful installation of Squore, you will need:

The latest version of the Squore Server installer, which can be downloaded from http://support.squoring.com/download_area.php
A user account with system administrator privileges
The Oracle Java Development Kit version 1.7.0_51 or higher
Warning
- Java 1.8 is not supported.
- It is technically possible to run Squore using a 32-bit JDK, however this will limit the memory available to 1GB of RAM to run the application, which will result in poor performance. If you still want to attempt such an installation, consult the troubleshooting page at http://openwiki.squoring.com/index.php/Running_Squore_On_A_32-bit_Java_Installation
At least 2 GB of space available on the disk for a full installation
At least 8 GB of RAM on the server machine
A valid Squore Server licence file (optional, since the licence file can be added after installation)

Tip

Keep in mind that the requirements above are the strict minimum. In production, Squore Server generally runs on a dedicated machine with a multi-core processor and 8 to 12GB of RAM. Squore reserves 25% of the available RAM of the machine to the database and another 25% to the server. External processes (like CheckStyle or Findbugs) running on the same machine as Squore may add to the amount of RAM required for analysing source code. Linux is known to offer better performances than Windows when running Squore.

Obtaining a Licence File

Because a licence is linked to the hardware on which Squore Server is installed, Squoring usually delivers a temporary licence to try out Squore first. This give you time to send out your host-id to our team, who will then issue a permanent licence file. In order to find out what your host-id is, follow these steps:

Download the host-id checker from http://support.squoring.com/download_area.php
Open a terminal on the machine where you installed or plan to install Squore.
Run the command java -jar squore-hostid.jar.
Send the output to support@squoring.com.

Packages for Windows

A JDK is required for Squore Server. The Windows installer contains the tcl and perl runtimes as well as a portable PostgreSQL installation.

Packages for Linux

On Linux platforms, the following must be installed before installing Squore:

Perl version 5.10.1 or greater including the following extra-modules:
- Mandatory packages:
  - Algorithm::Diff [module details]
  - Archive::Zip [module details]
  - Date::Calc [module details]
  - DBD::Pg [module details]
  - DBI [module details]
  - Digest::SHA [module details]
  - HTTP::Request [module details]
  - JSON [module details]
  - LWP::UserAgent [module details]
  - Time::HiRes [module details]
  - XML::Parser [module details]
- Optional packages for working with Microsoft Excel:
  - HTML::Entities [module details]
  - Spreadsheet::BasicRead [module details]
- Optional packages for working with OSLC systems:
  - Date::Parse [module details]
  - WWW::Mechanize [module details]
  - XML::LibXML [module details]
- Optional packages for working with GitHub systems:
  - Date::Parse [module details]
  - Mail::Box::Manager [module details]
  - Mail::Message::Body::Lines [module details]
  - Mail::Message::Construct [module details]
  - Mail::Mbox::MessageParser [module details]
  - Net::GitHub [module details]
- Optional packages for working with Semios/Prometil systems:
  - File::Slurp [module details]
Tip
If some of these modules are not available as packages on your operating system, use your perl installation's cpan to install the modules. Using the OS packages is recommended, as it avoids having to reinstall via cpan after upgrading your version of perl.
Tcl version 8.5 or greater,
PostgreSQL version 8.4 including at least the server component, and optionally, the pgAdmin utility. Note that your system must use a UTF-8 locale for the database creation to be carried out successfully. You can force this by running export LANG=UTF-8 before installing Squore.
The rsync utility

If you are running on a headless Squore Server, java-1.6.0-openjdk may not sufficient, as it lacks some fonts to render graphics. This is why using Oracle's JDK is recommended.

Packages for CentOS and Red Hat Enterprise Linux

On Red Hat Enterprise Linux and CentOS (6.5 and 7.1), the dependencies are satisfied by the following packages:

Mandatory packages:

java-1.7.0-openjdk
perl
perl-Algorithm-Diff
perl-Archive-Zip
perl-Date-Calc
perl-DBD-Pg
perl-DBI
perl-Digest-SHA
perl-JSON
perl-libwww-perl
perl-Time-HiRes
perl-XML-Parser
postgresql-server
rsync
tcl

Optional packages for working with Microsoft Excel:

perl-HTML-Parser
perl-CPAN (CPAN utility requirement)
perl-Spreadsheet-ParseExcel (available in the EPEL repository)
perl-Spreadsheet-XLSX (available in the EPEL repository)

Warning

The module Spreadsheet::BasicRead is not available as a package and must therefore be installed using cpan (make sure cpan is properly configured, by running cpan without arguments first):

sudo cpan -i Spreadsheet::BasicRead

Optional packages for working with OSLC systems:

perl-TimeDate
perl-WWW-Mechanize (available in the EPEL repository)
perl-XML-LibXML

Optional packages for working with GitHub systems:

perl-TimeDate
perl-Mail-Box (available in the EPEL repository)
perl-Mail-Mbox-MessageParser (available in the EPEL repository)
perl-Net-GitHub (available in the EPEL repository)

Optional packages for working with Semios/Prometil systems:

perl-File-Slurp

For more information about how to install the Extra Packages for Enterprise Linux (EPEL) repository, consult https://fedoraproject.org/wiki/EPEL.

Packages for Ubuntu

On Ubuntu 14.04.3 LTS, the dependencies are satisfied by the following packages: