Last reviewed: 2017-10-19

Introduction

This page describes the requirements and tasks for installing, upgrading and uninstalling Ubisecure Single Sign-On (Ubisecure SSO). Instructions on using Ubisecure SSO are found on the pages in SSO Management.

When following the instructions given in this manual, it is advisable to type the commands manually instead of copy/pasting them. This is because sometimes characters may be lost or modified in the copying process.

Please refer to the Release notes - SSO page for details of new features and other latest version related information.

System Overview

The Ubisecure SSO consists of an LDAP database for the Ubisecure Directory and several independent web applications implemented with Java 2 Platform technology:

Ubisecure SSO Authentication Server (also known as UAS for historical reasons)
- Core SSO engine
Ubisecure SSO Management (Ubilogin)
- User Interface for delegated management of configuration
Ubisecure Password application
- Password management tools for end users
Ubisecure Logviewer
- Web-based log file viewer
Ubisecure SSO Search
- Web-based tool for searching for users, sites, groups and applications
OTP Server
- One time password engine

Software Package Structure

Ubisecure SSO includes the following software packages:

Tomcat
OpenLDAP on Linux

For specific version numbers, please refer to current release notes.

File System Directory Structure

Relative to the platform-specific base directory, the directory structure of the Ubisecure SSO is organized in the following way:

Path	Content
/	The base directory of the Ubisecure SSO, e.g. `/usr/local/ubisecure/ubisecure-sso` on Linux or `C:\Program Files\Ubisecure\ubilogin-sso` on Windows
/tomcat/	The Tomcat server
/adam/	On Windows, the location of the Microsoft ADAM installer
/openldap/	On Linux, the location of the OpenLDAP server
/openssl/	On Linux, the location of the SSL library
/berkeley-db/	On Linux, the location of the Berkeley database
/template/	The template directory for the configuration file of the platform
/tools/	The Ubisecure SSO software tools
/ubilogin/	The software for the Ubisecure SSO itself
/VersionInfo.txt	The version information of the Ubisecure SSO and its components
/setenv.*	Utility script for getting the installation directory information
/ubilogin/config/	The directory for the base configuration file of the platform
/ubilogin/custom/	Directory for the customized settings
/ubilogin/ldap/	Ubisecure Directory installation data
/ubilogin/methods/	External Authentication methods
/ubilogin/webapps/	The Ubisecure SSO’s web applications
/ubilogin/config.index	List of the locations of Ubisecure Authentication Server’s configuration files
/ubilogin/setup.*	The setup script for the Ubisecure SSO

Installation Steps, Configuration and Security

Browser not supported