15. Configuring Repositories

Although Polarion has its own integrated Subversion repository, which stores Polarion artifacts like Work Items, wiki pages, etc. as well as other artifacts of users, some organizations adopting Polarion want to have Polarion work with multiple repositories. These may either be existing repositories external to Polarion ALM's repository, or new repositories established to work with Polarion ALM.

This chapter provides basic information about multi-repository support and points you to the information you need to set up Polarion to work with repositories in addition to the default one set up during Polarion ALM installation.

Feature Overview

There are two Polarion features which can deal with multiple repositories, but they are fundamentally different. You need to understand the basics of each feature before deciding which approach to multiple repositories best meets your needs.

  • External Repositories: this feature gives you the ability to link Polarion ALM artifacts stored in the integrated repository with changes (revisions) in source code stored on one or more external SVN or Git repositories. After installation, you can configure Polarion ALM to use one or more external repositories in addition to the SVN repository installed and/or configured during installation of Polarion ALM.

  • The Clustering feature enables you to run Polarion ALM on multiple servers, either physical, virtual, or a combination. The topography can be set up to host multiple servers running on separate machines each with its own Polarion ALM repository, and/or multiple machines all accessing a single Polarion repository. (Polarion ALM servers on any node can optionally be configured to access external repositories, as described above.)

    Special installation and configuration procedures beyond the scope of Help documentation are required to set up a clustered multi-server environment. These are covered fully in the Polarion Enterprise Setup Guide, available at SIEMENS' Doc Center.

The remainder of this section is devoted to configuring external repositories to work with Polarion ALM.