Required third-party software components

Apache HTTP Server is a required application for Polarion. We highly recommend installing it first.

You can download the appropriate distribution at the Apache website at:

http://httpd.apache.org/.

Installation Help for Apache HTTP server is available from Apache at:

http://httpd.apache.org/docs/2.4/install.html.

htpassword Utility

After installation you must ensure that the htpasswd utility is executable. The apache/bin folder must be present among other paths in PATH system variable, or the full path needs to be specified in the system configuration file polarion.properties.

The Subversion version control system (versions 1.6.x, 1.7.x, 1.8.x or 1.9.x) is also required for Polarion. You can download the appropriate distribution at http://subversion.apache.org/. Full user/administrator documentation is available on a third-party website at http://svnbook.red-bean.com/.

For new Polarion installations:

The following property is added automatically and set to "False":

com.polarion.platform.repository.canHaveEmptyRolesInSvnAccessFile=false

A dummy user is automatically assigned to every Group. (It's only visible in the svn access file.)

For existing Polarion installations:

If you update your Linux distribution to a version that contains SVN (1.10.x – 1.11.x) you should either:

1. Add the following property to the polarion.properties file and manually assign a user to all Groups in the AuthZ file:

   com.polarion.platform.repository.canHaveEmptyRolesInSvnAccessFile=false

2. Check whether your selected Linux distribution has already incorporated the patched SVN. (1.10.6 – 24 July 2019 and onwards)

Issue details:

If a Group is defined in an AuthZ file without an associated user, SVN 1.10 to 1.11.x generate an error and will not allow the AuthZ file to be used.

Example:

[groups]
	goodGroup = acct1
	goodGroup2 = acct1, acct2
	badGroup =
 
	[repoName:/someplace]
	@badGroup = rw
	results in:
 
	svnauthz: E220003: Error while parsing authz file: ...
	svnauthz: E220003: Access entry refers to undefined group ...

In new installations beginning with version 2015 SR2, Polarion server cannot start if PostgreSQL is not installed and configured. Please use your distribution's package manager to download these two packages: postgresql and postgresql-contrib. On RedHat you will need the postgresql-server package instead of the postgresql package.

You can follow the instructions posted online at http://www.postgresql.org/download/ or use one of the following command sets:

CentOS, RedHat:

• yum install postgresql

• yum install postgresql-contrib

Debian, Ubuntu:

• apt-get install postgresql

• apt-get install postgresql-contrib

SUSE: Available from openSuse Build Service (https://build.opensuse.org/) in the server:database:postgresql project:

• yast --install postgresql

• yast --install postgresql-contrib

After installing PostgreSQL, you must configure it and Polarion. This configuration is covered in the Configuration of third-party components.

1. Go to AdoptOpenJDK 11 (LTS) .

   (AdoptOpenJDK 11 (LTS) is the recommended OpenJDK distribution because it's continuously tested with Polarion and offers long-term support.)

2. Select the HotSpot implementation for the Linux x64 platform and download the JDK archive with your preferred tool and extract the files to a preferred location.

3. Set the JDK_HOME and JAVA_HOME environment variables. (Refer to the manual for your Linux distribution.)

4. You can test the configuration by executing $JDK_HOME/bin/java -version and $JAVA_HOME/bin/java -version

   (This should display the information about AdoptOpenJDK 11)

Match default file encoding:

1. Search for the file.encoding property in the main log file (/opt/polarion/data/logs/main/).

2. If the default file encoding for the new Open JDK 11 differs, then define it explicitly as a Java Runtime property by adding the following property to the config.sh file:

   (Default location: /opt/polarion/etc/config.sh.)

   • -Dfile.encoding=file_encoding

     Replace file_encoding with the one you use.

Phantom JS, used for previewing and exporting highcharts in PDF, is installed on all OS platforms. On SUSE and CentOS, URW fonts must be explicitly installed (see Server software requirements), otherwise exported diagrams rendered by Phantom JS will display rectangles instead of letters.