Install Polarion

1. Be sure that all required third-party components are properly installed and configured.

2. Unpack the distribution ZIP archive to a temporary location.

3. Change current directory to Polarion.

4. If SELinux is bundled with/installed on your Linux OS, make sure it is not activated. Check the status of SELinux with the /usr/sbin/sestatus -v. command

5. Create a Unix system account named polarion for the Polarion server.

6. Review the path variables defined in libinstall/default.sh. Set up v_web_user and v_web_group.

7. Execute (under root):

   chmod +x manual_install.sh; ./manual_install.sh

This will install Polarion into the standard /opt/polarion location . Data will be installed into the standard /opt/polarion/data location .

After manual installation you need to set up permissions on unpacked folders.

The standard permissions are:

• Read only for everybody, owner and group root: root on the following folders and their subfolders:

  /opt/polarion/polarion

  /opt/polarion/maven

• Writeable on the /opt/polarion/datafolder and its subfolders.

For "polarion":"web user", where polarion is a system account that you must create manually and web user is user used by Apache.

For more details, see the setPermissions() function in [UnpackDir]/libinstall/helper_functions.sh.

If Polarion is already installed, any user data (repository, builds, reports) will not be overwritten. However, it is recommended to back up any changed files in /opt/polarion (typically polarion.properties and any customized shell scripts), because they will be overwritten.

Possible changes include:

• Change the value of the host.name parameter from localhost to the host name specified in httpd.conf.

• Check that the repository alias in the svn.url parameter corresponds to the one in the httpd.conf file. (See Required Configuration.)

• Check that the correct paths to the passwd and access files are specified in the relevant svn.passwd.file and svn.access.file parameters.

• You may need to reconfigure the htpasswd.path parameter and set it to /usr/sbin/htpasswd2 instead of the usual /usr/local/apache2/bin/htpasswd.

• Check Apache's htpasswd utility path in the htpasswd.path parameter.

• Check that the port specified in the tomcat.ajp13-port parameter corresponds to the port specified in the worker.worker1.port parameter of the workers.properties file.

• Specify the correct SMTP host in the announcer.smtp.host parameter.