Installation and Administration Guide

Table of Contents

Typographical Conventions

Acronyms and Abbreviations

1. Introduction

Foreword
About This Document
Contacting Squoring Technologies Product Support
Responsabilities
Getting the Latest Version of this Manual

2. The Squore Architecture

The Squore Ecosystem
The Squore Database and Data Folder
The Squore Application Server
The Squore Web Interface
Squore CLI
The Squore Licence Server

3. Installing Squore Server

Installation Prerequisites

Supported Operating Systems
Supported Database Management Systems
Browser Compatibility
For All Systems
Prerequisites for Oracle
Obtaining a Licence File
Packages for Windows
Packages for Linux
Packages for CentOS and Red Hat Enterprise Linux
Packages for Ubuntu

Common Deployment Scenarios

Creating Projects using the Web Interface Only
Creating Projects From a Client Machine
Advanced Server Installation using an NFS Mount
Using a Remote Database
Using Squore in Continuous Integration
Access from Mobile Devices

Installing Squore Server on Windows

Installing Squore Server on Linux

Installing Squore Server for NFS-Mounting

Contept and Prerequisites
Installing the Master Squore Server
Installing a Squore Server Instance
Patching Squore Server in a NFS Context

Third-Party Plugins and Applications

Upgrading from a Previous Version

On Windows
On Linux
Upgrading NFS-Mounted Installations

Uninstalling Squore Server

On Windows
On Linux

4. Starting Squore

Starting Squore on Windows

Running Squore as a Windows Service

Services Configuration

Starting Squore on Linux

5. Squore Administration

Getting to Know the Installation Folder

Understanding config.xml

Default Configuration
Adding a Configuration Folder
Giving Each User Their Own Temporary Folder

Backup Tools

Backing-Up the Squore Data
Restoring Squore Data

Managing Project Visibility

Changing Squore Server Port Number

Changing Squore Database Port Number

Changing the Java Heap Size

Changing the path to the Java Installation

Configuring Timeouts

Number of Concurrent Analyses

Theme Control

Updating the Squore Licence File

Connecting to a Remote Licence Server

Managing Squore User Accounts

Deactivating and Deleting Users
Importing and Exporting Users

Setting Perl Environment

Windows
Linux

Usage Statistics

Application Usage Statistics for Administrators
Statistics for Model Developers
Statistics for Project Managers

6. Integrating Squore on Your Network

Accessing Squore via HTTPS

Redirecting from HTTP to HTTPS

Using the LDAP Authentication Module

Key and Certificate Management

Import a private key and a certificate
Import a certificate

Configuring E-Mail Notifications

Notifying Users by E-Mail

Embedding Dashboard Elements

Integration with Atlassian Confluence

Squore Server Configuration
Confluence Admin Configuration
Adding Dashboard Elements

Integration with CollabNet TeamForge

Squore Configuration
TeamForge Configuration
Integration Characteristics

Squore Server Monitoring

7. Sizing Squore Server and Database

Project Size and Growth
Saving Space by Deleting Old Data Files

A. Reference pages

install — Squore install script
sqexport.pl — Squore export utility
sqimport.pl — Squore import utility
sqadm-reset — reset Squore data

List of Tables

7.1. Project Characteristics
7.2. Model Characteristics
7.3. Project Cost