1. Administration Basics

This section introduces the basic concepts of Polarion administration and configuration.

1.1. Administration rights

To be able to access Polarion's administration facilities you must have a user account with Administrator level access rights. Access rights are defined by the "Role" assigned to the user account. Administration rights can have one of 2 scopes:

  1. Global: administrations rights for the entire repository

  2. Project: administration rights for a specific Project

1.1.1. The Default Administration Account

Polarion is installed with one default user account with user name "System Administrator" which has Global administration rights. The default log-in credentials for this account are:

  • User ID: admin

  • Password: admin

NOTE: Changing the default password

The procedure for changing the password for the default System Administrator account is detailed in the Installation Guide that comes in the Polarion installation bundle. Look for: "Changing the default System Administrator password".

The default System Administrator account provides access to all Polarion administration and configuration features for the Polarion system and all Projects in the Subversion repository, and access to the repository itself.

1.1.2. Defining Additional Administrators

The main System Administrator may find it useful or necessary to grant administrative access to other Polarion users. For example, if the main administrator is absent for some reason, someone else in the organization should be able to perform system administration functions with Polarion. Another example: the manager of each Project might be given administrative rights for the Project(s) he/she manages. This enables the manager to add user accounts and assign user roles for the Project, among other things.

To define an additional administrator, first create a user account if one does not already exist. You can specify the new user's role(s) for the global system and/or per Project in the process of creating the account. For an existing user, you need to edit the user's account and specify his/her role(s) for the global installation and/or per Project.

For information on creating user accounts and defining user roles, see User Management.

1.2. The Administration Interface

There are two ways that you can perform administrative functions in Polarion:

  1. Graphical User Interface

  2. XML configuration files

1.2.1. Graphical User Interface

Actually, all administration functions are accessible via Polarion's graphical user interface (GUI). However, not all configurations can be performed using graphical controls in the portal, though many can.

1.2.2. XML Configuration Files

Administrative functions such as customizing feature configurations are mostly performed by editing the relevant XML configuration files in the Subversion repository. Some configurations can be performed directly in the portal using graphical controls. These configurations are noted on the documentation.

Where some configuration requires editing a configuration file, you generally have 2 options:

  • Download a copy of the configuration file to your local system, edit it locally, upload the modified file back to Polarion upload and download is provided in the portal GUI)

  • Edit the XML file online using the text-based editor portlet provided in the portal UI for the particular configuration. Most configurations have this option available.

Figure 1.1. Accessing configuration files

Accessing configuration files

Edit XML config files locally or online

Sometimes configuration or customization is possible not only globally, but also for projects or sometimes project groups . Initially, there will be no configuration file for the more granular scope. In this case, you can download the global configuration file, modify it for the scope in which it applies, and upload the modified file to the repository URL applicable for the scope, or, in some cases, to the same URL but with the file renamed in a way that Polarion recognizes as applying to the more granular scope. You will find help texts in the GUI screen where you access to the configuration file which indicate where you need to upload the modified file, and/or how the modified file must be named to apply in a narrower scope.

You can create some project-scope configurations online without having to download/upload the XML configuration file. Where this capability is available, you will see the Edit Project Configuration portlet and a button: Paste Global Configuration.. Clicking this button pastes the XML from the global configuration into the text box control where you can modify it as needed for the project, and save the project configuration.

Figure 1.2. Project configuration

Project configuration

Customizing global configuration for a project

1.3. Resolving Problems & Troubleshooting

Polarion ALM is designed to be very easy to administrate and configure. But it is a very robust system, and no system is ever perfect. If you experience any problems, we suggest you try to look into the log files first (see Administration Reference: Log Files).

If you see that some items are missing from view, or do not display correctly, you check the Index and Reindex section in this guide. The index repair and rebuild procedures described there can resolve many issues.

If you are sill unable to resolve some problem, please contact Polarion technical support. It will expedite matters if you can provide the following:

  • a detailed description of the problem and symptoms observed

  • log files from the time the problem occurred, and also log files from any reindex operation if you may have run when attempting to fix a problem.

Tip

On Linux you can use /etc/init.d/polarion tar-log to gather all relevant log files.