Steps needed to make Dashboards use custom Style (like replacing oracle logo with custom logo, displaying custom images, etc) in OBIEE 12c.
Prerequisites :
1. Install OBIEE 12.2.1.0 and Download and Apply Patch 22140759 for your respective platform
Note : OBIEE 12.2.1.1.0 release already includes the above patch fix.
2. lsinventory confirming the right patch in use.
Post Apply Patch, you can see the details as:
Interim patches (7) :
Patch 22140759 : applied on Thu Apr 21 17:10:01 PDT 2016
Unique Patch ID: 20016066
Patch description: “One-off”
Created on 8 Apr 2016, 16:42:54 hrs PST8PDT
Bugs fixed:
22140759
Follow these steps to deploy bicustom.ear
Step 1 :
Copy ORACLE_HOME/bi/bifoundation/jee/bicustom-template.ear to ORACLE_HOME/user_projects/domains/bi/bidata/components/OBIPS/bicustom.ear
Note : Documentation lists this step incorrectly – it states to copy bicustom.ear file to ORACLE_HOME/bi/bifoundation/jee. This is incorrect – It should be copied over to ORACLE_HOME/user_projects/domains/bi/bidata/components/OBIPS which is the right location for 12c.
The following internal bug documents the correct directory to place the bicustom.ear file:
22140759 CUSTOM DASHBOARD STYLE NOT WORKING Sev 1 SR
The following documentation bug has been logged:
23190546 – DOCUMENT CORRECT BICUSTOM.EAR FILE LOCATION
Step 2 :
Make changes to the ear file as per your requirement – for example replace oracle_logo with your custom logo.
- Extract the bicustom.war file from the bicustom.ear file.
- Extract the files from the bicustom.war file.
- Edit the files to create your custom style and save your changes. See Section 17.9.5, “Customizing Your Style” for additional information. Note that By default, s_Custom extends s_Skyros, which is defined in the filemap.xml file. Please make sure to update filemap.xml file with the Style folder name as per your environment. Default one is s_Custom.
- Update the bicustom.war file with your changes.
- Update the bicustom.ear file with your new bicustom.war file.
Note : the default folder name which has the files is s_Custom. This name can be changed to your requirement. In this example the folder name used was s_SampleAppStyle
Step 3 :
Delete existing bicustom.ear deployment if it exists
-Go To Control, stop all the services and delete the existing bicustom.ear file.
Step 4 :
Deploy the bicustom.ear file by selection of the 12C path => ORACLE_HOME/user_projects/domains/bi/bidata/components/OBIPS
-Click Lock & Edit
-Click Install
Step 5 :
Select “Install this deployment as an application”
Step 6 :
Select “bi_server1” as deployment targets
Step 7 :
Select the following 12C deployment accessible location
Step 8 : Click Next and Finish
Step 9 : Now restart all the services ./stop.sh (meaning re-start from WLS / bi_server1 / all component services)
Step 10 : Go to /console and start the services for deployed “bicustom.ear”.
Step 11 :
After start bicustom should be in “Active” state.
Step 12 :
Now login to the application , open any dashboard or create any dashboard , go to dashboard properties , click on Style , see that the following “SampleAppStyle” appeared.
Step 13 :
Check the dashboard to verify if you see the custom logo, changed banner color, etc
The above steps will apply the custom SampleAppStyle to a specific dashboard.
If you wish to apply this Style across entire application so the custom logo,etc are seen in landing page, home page, all dashboards, etc you need to change the DefaultStyle setting in instanceconfig.xml file as follows
After this change, restart the services and retest. Screenshot below shows landing page showing custom logo
Note :
In order for the custom styles to show up in BI Publisher , add the following line in
[Middleware Home]/user_projects/domains/bi/bidata/components/bipublisher/repository/Admin/Configuration/xmlp-server-config.xml
<property name=”THEME_MASTER_CSS_URL” value=”/custom/s_skyros/master/master.css”/>
Once xmlp-server-config.xml file is modified to reference the custom style, restart all services and retest.
The bicustom.ear file which has the SampleAppStyle used in this testing has been attached for reference.
Source:
Steps to Configure OBIEE 12c to Use Custom Style in Dashboards (Doc ID 2131220.1)