Customize the Logon page

You can customize the Polarion portal logon page to display a custom logo image on the background near the Siemens logo, and/or a custom image identifying the server in the user logon dialog box. The latter is useful if you are running multiple Polarion servers in a clustered network environment.

Custom logo image on the background

The image must be hosted online in a location accessible to your Polarion server via http protocol. The image format may be GIF, PNG, or JPEG. Recommended width is 100 pixels. Height is scaled automatically.

In a clustered environment where Polarion is served over multiple physical and/or virtual servers, if a custom image is configured on the server that is the entry point for the entire system, that same image will be used on each server's logon page. In an environment utilizing a single server, the custom image appears beside the Siemens logo.

Note:

You must restart the Polarion server after the following procedure.

  1. Using a text editor, open the system properties file polarion.properties (follow link for location).

  2. Add the following line to the file: login.companylogo=[IMAGE_URL]

    Replace [IMAGE_URL] with the URL of the image you want to display on the logon screen background.

  3. Save the file.

  4. Restart the Polarion server.

Custom server image in the logon dialog box

Polarion displays a default image in the dialog box where users enter their logon credentials. The same image appears on the Navigation panel. In an environment hosting multiple Polarion servers, it can be useful to change this image on each Polarion server in the topography to make it easier for both administrators and users to identify which server they are using. This default image is named repo_logo.png. Its URL is http://localhost/polarion/ria/images/logos/repo_logo.png (localhost example). It resides in a plugin folder on the Polarion file system, specified later in the procedure steps.

  1. Obtain a custom image for the server you want to configure.

    • The image must be 300 x 300 pixels.

    • The image file format must be PNG.

  2. Use your file system explorer tool to open the plugin folder (Windows example): $POLARION_HOME$\Polarion\polarion\plugins\com.polarion.alm.ui_N.NN.N - where N.NN.N is a version number like 3.19.1.

  3. From that folder, drill down to \webapp\ria\images\logos.

    You should now be navigated to this path (Windows example):

    $POLARION_HOME$\Polarion\polarion\plugins\com.polarion.alm.ui_N.NN.N\webapp\ria\images\logos

  4. Rename the default repo_logo.png file to something else. For example, repo_logo.png.orig

  5. Copy your custom PNG image file into the logos folder and rename it as repo_logo.png.

  6. Restart the Polarion server at a convenient time.

    7. The custom image appears in the user logon dialog box, and in the Navigation panel after users log on.

    Tip:

    If you do not see the custom image after you restart the server, clear your browser's image cache and reload the page.