Introduction

This manual will guide you through the installation of your own local TeamDrive Registration Server. This document is intended for system administrators who need to install and configure a TeamDrive Registration Server.

This Installation Guide outlines the deployment of a single node installation, where all required components are located on the same OS instance. Please consult the TeamDrive Registration Server Administration Guide for recommendations about scalability and/or high availability.

Requirements

Required Skills

When installing the TeamDrive Registration Server, we assume that you have basic knowledge of:

  • VMware: importing and deploying virtual machines, configuring virtual networking and storage (when installing the TeamDrive Server components in a virtual environment or when using a pre-installed Virtual Appliance)
  • Linux system administration:
    • Adding/configuring software packages
    • Editing configurations files with a text editor (e.g. vi or nano)
    • Starting/stopping services, enabling them at system bootup time
    • Creating user accounts
    • Assigning file ownerships and privileges
    • Creating and mounting file systems
    • Setting up environment variables
  • Apache HTTP Server: installation and configuration, adding and enabling modules, modifying configuration files
  • MySQL Database: installation and configuration, administration/maintenance, using the MySQL command line client, basic SQL
  • MTA configuration: installing and configuring a local MTA like the Postfix mail server
  • Basic knowledge of application server technology

Network Requirements

The system must have IP connectivity, using a fixed IP address and a resolvable fully qualified domain name. The Registration Server itself needs to be able to properly resolve host names, too.

../_images/TeamDriveHosting-Networking-Overview.png

TeamDrive Enterprise Server Networking Overview

If the Registration Server is located behind a firewall, please ensure that it is reachable via HTTP (TCP port 80) by the TeamDrive Clients. HTTPS access (TCP port 443) is only required for accessing the web-based Administration Console and can be restricted based on your requirements.

If the Registration Server has been configured to contact the TeamDrive TDNS service, it needs to be able to establish outgoing HTTP connections (TCP port 80) to http://tdns.teamdrive.net/ and its Master Registration Server (http://reg.teamdrive.net by default), either directly or via an existing HTTP proxy server.

For more details about TDNS, see chapter TeamDrive Name Server (TDNS) in the TeamDrive Registration Server Reference Guide.

For the initial registration and the exchange of cryptographic keys, the Host Server must be able to contact the Registration Server via HTTP (TCP port 80). After the registration and activation, no further connections from the Host Server to the Registration Server will be established.

To perform API calls (e.g. to create new Space Depots or to query for existing Spaces for a particular user), the TeamDrive Registration Server must be able to establish outgoing HTTP or HTTPS connections to the TeamDrive Hosting Service.

If you use External Authentication for Authenticating user accounts, the Registration Server needs to be able to establish outgoing HTTP or HTTPS connections to the host providing the external Authentication Service.

Hardware Requirements

Operating a TeamDrive Registration Server requires an Intel/AMD-based server system, which should have at least a dual-core x86-64 CPU (quad-core or more is recommended), with a minimum of 2 GB of RAM. This could be a physical or a virtual instance.

Operating System

The TeamDrive Registration Server is based on TeamDrive-specific services (based on the Yvva Runtime Environment) and a “LAMP-Stack” (Linux/Apache/MySQL/PHP) for managing the Registration Server (e.g. user/provider accounts, licenses, etc).

We recommend an up to date 64-bit version of Red Hat Enterprise Linux 6 (RHEL 6) or a derivative distribution like CentOS 6, Oracle Linux 6 or Scientific Linux 6. Alternatively, Amazon Linux can be used, too.

The following Linux operating system components are required:

  • Apache HTTP Server (version 2.2, version 2.4 is not supported yet)
  • MySQL server (5.1 or later, 5.5 or 5.6 are recommended for better performance)
  • PHP 5.3
  • A working MTA configuration (e.g. a local Sendmail or Postfix instance that relays outgoing messags to a remote MTA)

We suggest to start with a minimal OS installation, adding the required components using the yum package manger afterwards.

The Registration Server installation packages have been developed and tested with this OS environment in mind — the names of packages, configuration files and path names might be different on other Linux distributions. If you have any questions about using other Linux distributions, please contact sales@teamdrive.net.

TeamDrive Server Components

The following TeamDrive-specific components will be installed:

  • Yvva Runtime Environment 1.2 (or newer)
  • TeamDrive Registration Server and the PHP-based Administration Console Version 3.5 (or newer)