Configuring FlexNet Code Insight 6.x for a Friendly URL

Configuring FlexNet Code Insight 6.x for a Friendly URL

Summary

Configuring FNCI 6.x for a Friendly URL

Question

FlexNet Code Insight deploys the web UI under the "palamida" Tomcat webapp on port 8888, accessible by a URL like:
http://my-server.com:8888/palamida

This article is useful if a user wants to remove the /palamida webapp portion of the URL, the port number, or both, to make the web UI accessible by a simpler URL. This article also helps to redirect SSL enabled deployment.

Answer

Removing /palamida from the URL

To remove /palamida from the URL, we can deploy the ROOT webapp on Tomcat and have this redirect to the "/palamida" webapp/URL. In $palamida/tomcat/webapps/ make a directory called ROOT, then add the following index.html file to it:

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="refresh" content="0;URL=http://my-server.com:8888/palamida">
  </head>
  <body></body>
</html>

Edit the "my-server.com" portion of the URL to point to the appropriate hostname Use the URL value with "https" for SSL enabled deployment. This ROOT webapp will deploy under the URL:

http://my-server.com:8888

Requests to this URL will be redirected to http://my-server.com:8888/palamida

For https enabled deployment, https://my-server:8888 will be redirected to https://my-server:8888/palamida


Removing the port number on Windows

NOTE: Do NOT use these instructions on Linux. See below.

Windows does not restrict low-numbered ports like 80 to admin users, so changing the port number for Tomcat is a simple matter. Edit the Connector element in $palamida/tomcat/conf/server.xml to use port 80 instead of 8888:

<Connector port="80" protocol="HTTP/1.1"
           connectionTimeout="30000"
           maxPostSize="10485760"
           redirectPort="8443" />

This will deploy Tomcat on port 80, and users can access Palamida with the URL:

http://my-server.com/palamida

See above to also remove the need to use /palamida.

Removing the port number on Linux

On Linux, port 80 is a privileged port, meaning that a process must be started with root privileges to have the permission to bind to this port. However, you should NOT deploy Tomcat with root privleges for security reasons.

Apache httpd is designed to run a main process with root privileges to bind to port 80, and then delegate requests to child processes with restricted user permissions.

Redirecting via Apache httpd

To redirect using Apache httpd:

  1. Install httpd if it is not already. For example:

    sudo yum install httpd
  2. Place a redirect file as above in the Apache's webroot folder. This is typically /var/www/html/index.html. The contents of the file should be like the following (replace my-server.com with your address and URL=https for SSL enabled deployments):

    <html>
      <head>
        <meta http-equiv="refresh" content="0;URL=http://my-server.com:8888/palamida">
      </head>
      <body></body>
    </html>
  3. Restart the httpd service.

This will allow users to access Palamida with:

http://my-server.com
Labels (1)
Was this article helpful? Yes No
No ratings
Version history
Revision #:
1 of 1
Last update:
‎Oct 22, 2018 05:01 PM
Updated by: