F Updating the BI Publisher Context Root

This chapter describes how to change the default URL context root for BI Publisher.

Updating the BI Publisher URL Context Root

Change the default context to update the BI Publisher URL.

When you install BI Publisher with Oracle Business Intelligence, by default the context for the BI Publisher URL is

http://<hostname>:<port>/xmlpserver

To change the default context like this:

http://<hostname>:<port>/<new context>/xmlpserver

perform the following general steps (detailed in the next section):

  1. Unzip the xmlpserver.ear file.

  2. Update the following xmlpserver configuration files:

    • META-INF/application.xml

    • WAR/WEB-INF/web.xml

    • WAR/WEB-INF/weblogic.xml

    • $DOMAIN_HOME/bidata/components/bipublisher/repository/Admin/Configuration/xmlp-server-config.xml

  3. Repackage the xmlpserver.ear.

  4. Unzip the analytics.ear file.

  5. Update the following analytics file:

    • META-INF/application.xml

  6. Repackage the analytics.ear.

  7. Update the instanceconfig.xml.

  8. In WebLogic Server, update the bipublisher and analytics applications.

The following Example details the required updates in each file.

Example

This example details the required updates to change the BI Publisher context from xmlpserver to /sales/xmlpserver.

Perform these tasks:

Updating the xmlpserver META-INF/application.xml File

Update the context-root of the META-INF/application.xml file.

  1. Unzip the xmlpserver.ear file.

  2. Navigate to META-INF/application.xml under the xmlpserver WAR.

  3. Update the context-root to match you new context. In this example the context root is updated to /sales/xmlpserver:

        <web>
       <web-uri>xmlpserver.war</web-uri>
       <context-root>/sales/xmlpserver</context-root>
      </web>

Updating the xmlpserver WAR/WEB-INF/web.xml File

Under the xmplserver WAR/WEB-INF folder, update the web.xml file.

  1. Navigate to the WAR/WEB-INF/web.xml file.

  2. Update the following parameter values in the file:

    <init-param> 
<!-- This is the root webdir for the xmlpserver application. Modify this if
 xmlpserver.ear is not deployed to its standard location. -->
    <param-name>xmlp-online-web-dir</param-name>
    <param-value>/sales/xmlpserver</param-value>
</init-param> 
<init-param> 
<!-- Path to the ServiceGateway SOAP end point. Most likely this will be the
 path for services deployed with Axis. -->
 <param-name>service-endpoint</param-name>
 <param-value>/sales/xmlpserver/services/ServiceGateway</param-value> 
</init-param> 
<init-param> <!-- Path to report service web directory. -->
    <param-name>web-dir</param-name> 
    <param-value>/sales/xmlpserver/report_service</param-value> 
</init-param>

Updating the xmlpserver WAR/WEB-INF/weblogic.xml File

Under the xmplserver WAR/WEB-INF folder, update the weblogic.xml file.

  1. Navigate to the WAR/WEB-INF/weblogic.xml file.

  2. Update the cookie-path and context-root in the file:

     <wls:session-descriptor> 
     <wls:cookie-path>/sales/xmlpserver</wls:cookie-path>
  </wls:session-descriptor>
  <wls:context-root>sales/xmlpserver</wls:context-root>

Updating the xmlp-server-config.xml File

Update an element in the xmlp-server-config.xml file.

  1. Navigate to:

    Oracle_Home/user_projects/domains/bi/bidata/components/bipublisher/repository/Admin/Configuration/xmlp-server-config.xml

  2. Update the following element in the file:

    <property name="SAW_URL_SUFFIX" value="sales/analytics/saw.dll"/>

Updating the analytics META-INF/application.xml File

Update the elements in the file to match your context-root.

  1. Unzip the analytics.ear file.

  2. Navigate to the META-INF/application.xml file.

  3. Update the following elements to match your context-root:

    <display-name>analytics</display-name> 
<module> 
   <web> 
      <web-uri>analytics.war</web-uri> 
      <context-root>sales/analytics</context-root> 
   </web> 
</module> 
<module> 
   <web> 
      <web-uri>analytics-ws.war</web-uri>
      <context-root>sales/analytics-ws</context-root> 
   </web> 
</module> 
<module> 
   <web> 
      <web-uri>analytics.war</web-uri>
      <context-root>sales/analytics-bi-adf</context-root> 
   </web> 
</module>

Updating the instanceconfig.xml File

Update the instanceconfig.xml file.

  1. Navigate to the instanceconfig.xml located at

    [ORACLE_INSTANCE]\config\OracleBIPresentationServicesComponent\coreapplication_obips1\instanceconfig.xml

  2. Update the <ServerBasedURL> and <WebURL> elements under <AdvancedReporting> in the file:

        <AdvancedReporting>
    <ServerBaseURL>/sales/xmlpserver</ServerBaseURL>
    <WebURL>/sales/xmlpserver</WebURL>
    </AdvancedReporting>

Updating the bipublisher and analytics Applications in WebLogic Server

Update the bipublisher and analytics applications in the Oracle WebLogic Server Administration Console.

  1. Repackage the xmplserver.ear file.

  2. Repackage the analytics.ear file.

  3. Open your Oracle WebLogic Server Administration Console.

  4. In the Change Center of the Administration Console, click Lock & Edit.

  5. In the left pane of the Console, select Deployments. A table in the right pane displays all deployed Enterprise Applications and Application Modules.

  6. In the table, select the bipublisher application.

  7. Click Update.

  8. Click Finish (do not change the source path).

  9. Repeat Step 6 through Step 8 for the analytics application.

  10. In the Change Center of the Administration Console, click Activate Changes and then click Release Configuration.