G Updating the BI Publisher Context Root

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

G.1 Updating the BI Publisher URL Context Root

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.

G.2 Example

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

Perform these tasks:

G.2.1 Update the xmlpserver META-INF/application.xml file

To update 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>

G.2.2 Update 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>

G.2.3 Update 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>

G.2.4 Update the xmlp-server-config.xml

To update 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"/>

G.2.5 Update the analytics META-INF/application.xml file

To update the analytics META-INF/application.xml file:

  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>

G.2.6 Update the instanceconfig.xml file

To 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>

G.2.7 Update the bipublisher and analytics Applications in WebLogic Server

  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