Shortening the URL for OpenPages

You can shorten the IBM OpenPages® application URL. You might shorten the URL to support privacy or to support some mobile uses of the URL. To shorten the URL, change the values for properties in various files.

Before you begin

Before you modify the files that are referenced in this procedure, back up the files.

About this task

In the following example of the default and the shortened URL, the port number of the admin application server is 10108:
Default URL
http://<server_name>:10108/openpages
Shortened URL
http://<server_name>:10108/

Procedure

  1. Log on to the admin application server.
  2. Stop the Cognos services. For more information, see Starting and stopping the Cognos services.
  3. Edit the following file:
    <OP_HOME>/wlp-usr/servers/<server_name>Server<#>/configDropins/overrides/op-apps.xml
  4. Look for the following lines: 
    <!-- Specify an alternative context-root here for the primary OpenPages web application -->
<!-- <web-ext id="taskui" moduleName="taskui" context-root="/" />-->
  5. Uncomment the following line: 
    <web-ext id="taskui" moduleName="taskui" context-root="/" />
  6. Go to the <OP_HOME>/aurora/conf/ directory.
  7. For each of the properties files that are listed in the following table, open the file in a text editor. Change the current value to the new value, and then save the file:
    Table 1. Shorten URL, property values
    File name Current value New value
    aurora.properties 
    application.url.path=http\://server_name\:10108/openpages
    		 
    application.url.path=http\://server_name\:10108
    Server<#>-sosa.properties 
    application.url.path=http\://server_name\:10108/openpages
    		 
    application.url.path=http\://server_name\:10108
    Server<#>-sosa.properties 
    application.context=/openpages
    		 
    application.context=
    Tip: In a load balanced environment, the application.url.path is the fully qualified domain name of the load balancer and its port number.
  8. On the Cognos server, navigate to the following folder: <COGNOS_HOME>/configuration
    1. Open the OpenPagesSecurityProvider_OpenPagesSecurityRealm.properties file in a text editor or XML editor.
    2. Change the current value to the new value, and then save the file:
      Current value
      openpages.application.url=http\://<server_name>\:10108/openpages
      New value
      openpages.application.url=http\://<server_name>\:10108
  9. Restart the OpenPages application servers. For more information, see Starting application servers.
  10. Start the Cognos services. For more information, see Starting and stopping the Cognos services.
  11. After the services are started, log in to OpenPages.
  12. Click Open Administration menu Administration menu > System Configuration > Settings.
  13. Expand the following folders: Platform > Reporting Schema > Object URL Generator > Detail Page. Replace the current value with the new value, and then click Done.
    Current value
    /openpages/view.resource.do
    New value
    /view.resource.do
  14. Re-create the reporting schema. For more information, see Creating or re-creating the reporting schema.