Tag Archives: Obiee

OBIEE 12c – Repository Password Corruption Issue

Here at Rittman Mead we’ve been working with OBIEE 12c for some time now, as part of the beta programme and more recently with clients looking to get the most out an upgrade to OBIEE 12c. We’ve also been hard at work on our brand new OBIEE 12c training course. What we’ve seen in terms of the stability of OBIEE 12c has been pleasantly surprising. Anyone who’s worked with software long enough will be familiar with the reputation that first releases in general have for nasty bugs, and it’s probably fair to say that with the first release of 11g (11.1.1.3) this was proven out. With the first release of OBIEE 12c, however, we’re seeing a stable tool with very few issues so far.

That said…I’m going to demonstrate an issue here that is a bit of a nasty one. It’s nasty because the trigger for it appears innocuous, and what it breaks is one of the really new things in OBIEE 12c—the way in which the RPD is stored on disk and accessed by the BI Server. This makes it a bit of a tough one to get to the bottom of at first, but it’s a good excuse to go digging!

Summary

If you open the RPD in online mode (use File –> Copy As and then use the Save option), the password on the server gets corrupted.

[nQSError: 43113] Message returned from OBIS  
[nQSError: 13042] Repository password is wrong

obiee 12c repository password corruption

From this point on you cannot checkin any changes, and when you restart the BI Server it will fail to start up.

Details

In OBIEE (12c, and before) it is possible to open the RPD as a straight binary file on disk (“Offline” mode), or by connecting directly to the BI Server and opening the copy that it is currently running (“Online mode”). Offline mode suits larger changes and development, with the RPD then being deployed onto the server once the development work is ready to be tested. Online mode is a good way for making changes on a dedicated dev server, minor changes on a shared server, or indeed just for viewing the RPD that’s currently being run.

Here’s what we’ve seen as the problem:

  1. Open RPD in online mode
  2. File -> Copy As
  3. Enter a password with which to protect the RPD being saved on disk.
  4. Do one of:
    • File -> Close, and then when prompted to save changes click Yes
    • File -> Save
    • Click the Save icon on the toolbar
    • Ctrl-S

obiee 12c repository password error

What happens now is two-fold:

  1. You cannot check in any changes made online—the check in fails with an error from the Administration Tool:
    [nQSError: 43113] Message returned from OBIS  
    [nQSError: 13042] Repository password is wrong
  2. The BI Server will fail on restart with the same error:
    Opening latest versioned cached RPD for : /app/oracle/biee/bi/bifoundation/server/empty.rpd which is /app/oracle/biee/user_projects/domains/bi/bidata/service_instances/ssi/metadata/datamodel/customizations/liverpd.rpd_5  
    [nQSError: 13042] Repository password is wrong. [[

We saw this on SampleApp v511, as well as on vanilla installations of OBIEE. Versions on both were 12.2.1.0.0.

After we reported this to Oracle, they agreed it was a bug and have logged it as bug number 22682937, with no patch currently (February 10, 2016) available.

Workaround

If you open the RPD online and use File -> Copy As, don’t hit save or check in, even if prompted by the Admin Tool. Close the RPD straightaway.

Often people will use File -> Copy As to take a copy of the current live RPD before doing some changes to it. At Rittman Mead, we’d always recommend using source control such as git to store all code including the RPD, and using this approach you obviate the need to open the RPD online simply to get the latest copy (because the latest copy is in source control).

You can also use the data-model-cmd downloadrpd option to download the actual live RPD—that’s exactly what this option is provided for.

Solution – if BI Server (OBIS) has not yet been restarted

If you’ve hit this bug and are hitting “Repository password is wrong” when you try to checkin, and if the BI Server is still running, then redeploy the RPD using the data-model-cmd uploadrpd tool. By redeploying the RPD the password appears to get sorted out.

If the BI Server is down, then this is not an option because it has to be running in order for data-model-cmd uploadrpd to work.

Solution – if BI Server (OBIS) has been restarted and failed

At this point using data-model-cmd uploadrpd is not possible because OBIS is not running and so the data-model-cmd uploadrpd will fail with the error:

[oracle@demo ~]$ /app/oracle/biee/user_projects/domains/bi/bitools/bin/data-model-cmd.sh uploadrpd -I /home/oracle/rmoff.rpd -W Password01 -U weblogic -P Admin123 -SI ssi  
Service Instance: ssi

Operation failed.  
An exception occurred during execution, please check server logs.

The only option from this point is to use importServiceInstance to reset the service instance, either to an empty, SampleAppLite, or an existing .bar export of your environment. For example:

/app/oracle/biee/oracle_common/common/bin/wlst.sh  
importServiceInstance('/app/oracle/biee/user_projects/domains/bi','ssi','/app/oracle/biee/bi/bifoundation/samples/sampleapplite/SampleAppLite.bar')

This will enable OBIS to start up correctly, from which point the desired RPD can then be re-uploaded if required using data-model-cmd uploadrpd.

Conclusion

The easiest thing is to simply not use File -> Copy As in online mode. Whilst this on its own is fine, the UI means it’s easy to accidentally use the Save option, which then triggers this problem. Instead, use data-model-cmd downloadrpd, and/or use source control so that you can easily identify the latest RPD that you want to develop against.

If you do hit this repository password corruption problem, then keep calm and don’t restart the BI Server—just re-upload the RPD using data-model-cmd uploadrpd. If you have already uploaded the RPD, then you need to use importServiceInstance to restore things to a working state.

As part of the diagnostics that we did to get to the bottom of this issue, we found some interesting things in OBIEE 12c, such as a web service endpoint for RPD upload/download, as well as the detailed workings of the RPD upload process and that infamous liverpd.rpd file. Stay tuned for a blog post on this and more soon! And in the meantime, be sure to get in touch with us to discuss how we can help you with your OBIEE systems, including OBIEE 12c upgrade, and OBIEE 12c training.

The post OBIEE 12c – Repository Password Corruption Issue appeared first on Rittman Mead Consulting.

Implementing OBIEE Commentary

My Application Development Experience with Rittman Mead

Greetings, readers! My name is Nick Padgett, and this is my first blog post with Rittman Mead. I started with Rittman Mead as an intern over a year ago while I was attending Kennesaw State, a local university, but I’ve graduated from both school and the internship. Since then I’ve been working on several interesting applications. Today, I would like to take some time to discuss developing one such application, our OBIEE Commentary tool, as well as my learning experiences working at Rittman Mead.

When I first started with Rittman Mead in October 2014, I was beginning my final year in a Computer Science program. When I joined, I knew very little about Business Intelligence but was eager to learn everything I could. Learning BI while still in school created a powerful synergy between my class studies and the real world. As I learned web development and security in class, I learned about data warehouses and agile development at work. In addition, I had the opportunity to practice my new knowledge and skills on a daily basis.

The most important lesson I learned during my time as an intern was the importance of developing primarily to meet the user requirements. This subject was often ignored in school, except for the obligatory Software Engineering course. But now, as a formal developer, I was always being reminded of the users we were developing for. All features for all projects were first qualified by asking “Is this what the user wants or needs?” or “Will this add value for the users?”

The first project I was assigned was the Rittman Mead commentary tool. As I assisted in development, the team always looked back to the initial requirements: “Users want commentary in OBIEE.” All development was focused in that direction, and any feature which hindered the goal, despite the technical impressiveness, was removed from the application.

Now, after spending many hours developing the commentary tool, the team is confident it has effectively answered the primary user requirements. We’re all very excited to provide this tool to our customers, and we are confident it will meet all the requirements we spent so long accumulating and developing for.

The Primary Use-case: OBIEE Commentary

In a typical environment, users are required to leave the application to communicate with their peers. This often involves screenshots, long text descriptions of the subject, and a service such as email or Slack. However, forcing users to leave the application in order to do their job is less than optimum. What’s to keep them using the expensive tool you purchased for them if they have to leave it every few minutes?

Many organizations recognize this issue and seek to implement commentary themselves. Frequent approaches typically use either a text object on a dashboard, a write-back enabled input, or even strange iFrame solutions to achieve the desired capabilities. Obviously, these implementations have serious drawbacks, and may not be maintainable or feasible for many organizations.

The commentary tool we have developed uses none of the above approaches, but instead uses a standard web deployment, hosted in WebLogic, to provide similar capabilities. This means no RPD modifications, no requirement for dashboard designers to become involved, and no security threats with iFrames or Cross-Site Scripting (XSS) attacks, while still fulfilling the primary use case of adding commentary to your OBIEE dashboards.


obiee 12c commentary

Our tool allows for users to create several different types of comments, all displayed through standard HTML in a web browser. Comments can be added on a dashboard to provide commentary for the page as a whole, while other comments can be placed on reports, which will be shown anywhere the report is located. You can even submit replies to existing comments, allowing for comment threads over a particular subject. All of these comments are available for use without having to leave the application.

A Second Use-case: Documentation

Some comments are highly structured and curated, containing a wealth of information. Some users like to add comments explaining how a measure is calculated, or a post-mortem for the launch of a new product. These comments are best classified as documentation, as they don’t serve to engage in a conversation, but to present information. In addition, there may be formal documentation that is required to be on a dashboard, and relates directly to a series of reports. The most common way to provide this is to supply links to external applications specifically suited for documentation. Among a myriad of issues pertaining to accessibility concerns, this approach forces users to leave the application, some of whom may never return.

As an alternative, documentation can be placed directly on a dashboard or report, but this leads to design problems. Having a twenty-page document on a dashboard is hardly an acceptable solution, even though this is the best place to put your documentation. In addition, users will have to write their documentation in HTML, or at least be able to understand it.


obiee 12c documentation tool

The commentary tool also allows for this use case. Documentation can be created or edited using a WYSIWYG (What You See Is What You Get) editor, similar to any standard document editor, and added to a “Table of Contents” on a dashboard. The Table of Contents lists all current documents available to view and displays them in a dedicated area. This provides access to any pertinent content directly on a dashboard, rather than forcing users to migrate to an external application, which is the entire point for having native commentary in the first place.

A Third Use-case: Integration

A common concern may be the introduction of yet another channel for communication. For example, many organizations use Slack as a communication tool or Atlassian Confluence for documentation. Rittman Mead does not desire to replace these tools or make them obsolete to your organization. We acknowledge the fact you spend money on these applications, and they may be widely adopted within your organization.


obiee commenting tool

Instead of forcing you to maintain several channels of communication, our commentary tool allows integrations with applications such as JIRA and Confluence. Comments can be submitted as JIRA issues, and documents can be synchronized with Confluence pages. Several other integrations are available by default, while additional implementations are available on a per-customer basis. Now, if users absolutely must leave the application, they can do it on their own terms, with the convenience of a few clicks.

As I have grown during my time here with Rittman Mead, so has our commentary application. While I learned how to cater to user requirements, the tool evolved into an extension of this knowledge and was developed with the intention to meet all customer needs. I am incredibly excited to see this product released soon, and I can’t wait for users to start getting more out of their BI applications.

More information on this tool will be coming very soon, so keep an eye on our blog and website for updates!

The post Implementing OBIEE Commentary appeared first on Rittman Mead Consulting.

The best OBIEE 12c feature that you’re probably not using.

With the release of OBIEE 12c we got a number of interesting new features on the front-end.  We’re all talking about the cleaner look-and-feel, Visual Analyzer, and the ability to create data-mashups, etc.

While all this is incredibly useful, it’s one of the small changes you don’t hear about that’s truly got me excited.  I can’t tell you how thrilled I am that we can finally save a column back to the web catalog as an independent object (to be absolutely fair, this actually first shipped with 11.1.1.9).

For the most part, calculations should be pushed back to the RPD.  This reduces the complexity of the reports on the front-end, simplifies maintenance of these calculations, and ultimately assures that the same logic is used across the board in all dashboards and reports… all the logic should be in the RPD.  I agree with that 110%… at least in theory.  In reality, this isn’t always practical.  When it comes down to it, there’s always some insane deadline or there’s that pushy team (ahem, accounting…) riding you to get their dashboard updated and migrated in time for year end, or whatever.  It’s quite simply just easier sometimes to just code the calculation in the analysis.  So, rather than take the time to modify the RPD, you fat finger the calculation in the column formula.  We’ve all done it.  But, if you spend enough time developing OBIEE reports and dashboards, sooner or later you’ll find that this is gonna come back to bite you.

Six months, a year from now, you’ll have completely forgotten about that calculation.  But there will be a an org change, or a hierarchy was updated… something, to change the logic of that calculation and you’ll need make a change.  Only now, you know longer remember the specifics of the logic you coded, and even worse you don’t remember if you included that same calculation in any of the other analyses you were working on at the time.  Sound familiar?  Now, a change that should have been rather straightforward and could have been completed in an afternoon takes two to three times longer as you dig through all your old reports trying to make sense of things.  (If only you’d documented your development notes somewhere…)

Saving columns to the web catalog is that middle ground that gives us the best of both worlds… the convenience of quickly coding the logic on the front-end but the piece of mind knowing that the logic is all in one place to ensure consistency and ease maintenance.

After you update your column formula, click OK.

From the column dropdown, select the Save Column As option.

Save the column to the web catalog.  Also, be sure to use the description field.  The description is a super convenient place to store a few lines of text that your future self or others can use to understand the purpose of this column.

As an added bonus, this description field is also used when searching the web catalog.  So, if you don’t happen to remember what name you gave a column but included a little blurb about the calculation, all is not lost.

Saved columns can be added from the web catalog.

Add will continue to reference the original saved column, so that changes to made to the saved column will be reflected in your report.  Add Copy will add the column to your report, but future changes to the saved column will not be reflected.

One thing to note, when you add a saved column to a report it can no longer be edited from within the report.  When you click on Edit Formula you will still be able to see the logic, but you will need to open and edit that saved column directly to make any changes to the formula.

Try out the saved columns, you’ll find it’s invaluable and will greatly reduce the time it takes to update reports.  And with all that free time, maybe you’ll finally get to play around with the Visual Analyzer!

The post The best OBIEE 12c feature that you’re probably not using. appeared first on Rittman Mead Consulting.

Bundle Patch: Oracle Business Intelligence Enterprise Edition Suite 11.1.1.9.160119

The following Patch Set Update (PSU) has been released for Oracle Business Intelligence Enterprise Edition (OBIEE) 11.1.1.9.

This PSU download is available from the My Oracle Support | Patches & Updates section.

Oracle Business Intelligence Enterprise Edition (OBIEE) 11g
Bundle Patch 11.1.1.9.160119

Patch 22393988

OBIEE Suite Bundle Patches are cumulative, and include the contents of previous 11.1.1.9.x bundle patches. This latest OBIEE Bundle Patch 11.1.1.9.5 is available as Patch 22393988, and is comprised of the following patches, which are not available separately:

  • Patch 22382217 Oracle BI Publisher (BIP)
  • Patch 22322354 Oracle BI Mobile App Designer (BIMAD)
  • Patch 22475251 Oracle BI Server (BISERVER)
  • Patch 22472013 Oracle BI Presentation Services (BIPS)
  • Patch 22220714 Oracle EPM Components Installed from
    Oracle BI Installer 11.1.1.9.0 (BIFNDNEPM)
  • Patch 21350584 Oracle BI ADF Components (BIADFCOMPS)
  • Patch 22322838 Oracle BI Platform Client Installers and MapViewer
  • Patch 21517672 Oracle BI Third Party

NOTE: The instructions to apply the above patches are identical, and are contained in the readme file for Bundle Patch 22393988.

This release is using the New Bundle Patch Version Numbering. For more information on this change, refer to our previous Blog post:

Patch Numbering for Oracle DB, Enterprise Manager and Middleware

Prior to proceeding with this OBIEE Bundle Patch implementation and related downloads refer to the Readme file for important information. It is important to verify that the requirements and support paths for this patch are met as outlined within the Readme file. Details for moving from 11.1.1.7.x to 11.1.1.9.160119 are also outlined.

The Readme file is available from the Patches & Updates download screen.

For an introduction to OBIEE Suite Bundle Patches, which includes information on the bundle patch lifecycle, availability, and version names, refer to Knowledge Article:

OBIEE Suite Bundle Patches
Doc ID 1591422.1

To locate the latest available Patch information visit the Knowledge Article:

OBIEE 11g: Required and Recommended Bundle Patches and Patch Sets
Doc ID 1488475.1

To share your experience about installing this patch ...

In the MOS | Patches & Updates screen for OBIEE Patch 22393988, click the "Start a Discussion" and submit your review.

Have a question for OBIEE specifically ....

The My Oracle Support Community " OBIEE (MOSC) " is the ideal first stop to seek & find product specific answers:

OBIEE (MOSC)



Fusion MiddleWare Proactive Patches – January 2016

Oracle Product Management have announced the release of Fusion MiddleWare (FMW) Proactive patches. The below listing are the Bundle Patches, Patch Set Updates, and Critical Patch Updates within this release for 19th January, 2016.

Bundle Patches :

Bundle patches are collections of controlled, well tested critical bug fixes for a specific product which may include security contents and occasionally minor enhancements. These are cumulative in nature meaning the latest bundle patch in a particular series includes the contents of the previous bundle patches released.  A suite bundle patch is an aggregation of multiple product  bundle patches that are part of a product suite.

  • Oracle Business Intelligence Enterprise Edition (OBIEE)
    11.1.1.9.160119 and 11.1.1.7.160119 suites.
  • Oracle Data Integrator (ODI) 11.1.1.9.7
  • Oracle Internet Directory(OID) 11.1.1.9.3
  • Oracle GlassFish Server (OGFS) 3.1.2.12 and 3.0.1.12
  • Oracle Identity Management Suite Bundle Patch 11.1.2.3.3 consisting of
    • Oracle Access Manager (OAM) 11.1.2.3.5
    • Oracle Identity Manager (OIM) 11.1.2.3.5
    • Oracle Mobile Security Suite (OMSS) 11.1.2.3.5
    • Oracle Unified Directory (OUD) 11.1.2.3.1
  • Oracle Identity Management Suite Bundle Patch 11.1.2.2.8 consisting of
    • Oracle Access Manager (OAM) 11.1.2.2.8
    • Oracle Identity Manager (OIM) 11.1.2.2.9
    • Oracle Adaptive Access Manager (OAAM) 11.1.2.2.1
    • Oracle Unified Directory (OUD) 11.1.2.2.3
  • Oracle Platform Security for Java (OPSS) 11.1.1.9.160105
  • Oracle SOA Suite (SOA) 12.1.3.0.5 and 11.1.1.9.160119
  • Oracle Service Bus (OSB) 12.1.3.0.1
  • Oracle WebCenter Content (WCC) 11.1.1.8.15 and 11.1.1.9.160119
  • Oracle WebCenter Portal (WCP) 11.1.1.9.160119
  • Oracle Web Services Manager (OWSM) 12.1.3.0.4

Patch Set Updates:

Patch Set Updates (PSU)  are collections of well controlled, well tested critical bug fixes for a specific product  that have been proven in customer environments. PSUs  may include security content but no  enhancements are included. These are cumulative in nature meaning the latest PSU  in a particular series includes the contents of the previous PSUs  released. 

  • Oracle WebLogic Server 12.2.1.0.1, 12.1.3.0.6, 12.1.2.0.8 and 10.3.6.0.13
  • Oracle Exalogic
    • 2.0.6.2.4 Physical Linux x86-64 (for all X2-2, X3-2, X4-2, X5-2)
    • 2.0.6.2.4 Physical Solaris x86-64 (for all X2-2, X3-2, X4-2, X5-2)
    • 2.0.6.2.4 Virtual Oracle VM Server x86-64 (for all X2-2, X3-2, X4-2, X5-2)

Critical Patch Update:

The Critical Patch Update program is Oracle's quarterly release of security fixes.

Additional patches were released as part of Oracle's Critical Patch Update program for the following products and versions

  • Oracle Business Intelligence 12.2.1.0.0
  • Oracle Endeca Server DE 7.6,7.5,7.4 and 7.3.
  • Oracle Identity Federation (OIF) 11.1.1.7.0
  • Oracle Outside In Technology (OIT) 8.5.2, 8.5.1 and 8.5.0.
  • Oracle Tuxedo 12.1.1.0
  • Oracle WebCache 11.1.1.9.0 and 11.1.1.7.0.
  • Oracle WebCenter Sites 11.1.1.8.0  and 7.6.2.
  • Oracle WebLogic Portal 10.3.6.0

For more information :

Critical Patch Update Advisory -  January 2016
Doc ID 1488475.1 - OBIEE 11g: Required & Recommended Bundle Patches & Patch Sets
Doc ID 2070465.1 - OBIEE 12c - Required & Recommended Bundle Patches & Patch Sets
Doc ID 1494151.1 - Master Note on Fusion Middleware Proactive Patching
- Patch Set Updates (PSUs) & Bundle Patches (BPs)
Doc ID 2074802.1 - Patch Set Update & Critical Patch Update January 2016 Availability
Doc ID 2061926.1 - Oracle Database, Enterprise Manager and Middleware
- Change to Patch Numbering from Nov 2015 onwards

Note: Some of the bundles released are using the New Bundle Patch Version Numbering - refer to our previous Blog post "Patch Numbering for Oracle DB, Enterprise Manager and Middleware".