Skip to Content

Looking inside the Web Intelligence Servers with Webi Admin Tool

It’s not supported, but that shouldn’t stop every BI4 Administrator from benefiting from the wonderful insight it can provide. Too often customers feel they don’t understand what the Web Intelligence server is doing; some see it as a bit of a black box. No more. The webiadmintool is a sophisticated bit of kit and worth spending a good few hours to understand how it can help you.

Here’s a summary:

  1. The Profiling Dashboard will break down a single action, such as ‘opening a document’, into a large number of methods and for each its duration. Around 15 methods are shown for opening a document. This can help you identify which individual method is problematic: CMS communication, document cache, or generation of charts etc.
  2. The Service LifeCycle Information shows which ‘objects’ have been left in memory and yet to be cleaned up, potentially highlighting a memory issue.
  3. The Adaptive Processing Server Relationship shows, by user and document, which Web Intelligence server is using which other dependent service, like the Visualisation engine (for charts) or DSL Bridge (for the new Dimensional Semantic Layer). This means you can see inside the cluster to which user is consuming which bits of your cluster. This could be helpful to resolving a performance issue.
  4. The plugins perspective allows you to “Remove a session” or “Remove all sessions using a particular document” or “Remove all session used a particular user id” should you wish to eliminate processing that is consuming too many resources.
  5. The Profiling Perspective and Analysis enables you to compare two workflows with each other at a very detailed level. For example, you can compare the workflow of one user opening and interacting with a document, with the workflow for a different user. This might be helpful to isolate a performance issue, when one user ID performs slower than another.
  6. The monitoring perspective enables you to visually see load (sessions, users, documents, memory usage) over time in a graph. This is ideal to validate a load test; or help you identity characteristics on the usage of your server.
  7. The scheduling perspective shows you the internal tasks performed by the server, for self-maintenance and clean-up.
  8. The Failover/Recovery status will help you identify the server name, user id, or document name that is frequently failing and causing a recovery to occur. Thus allowing you to take remedial steps

I’ve written a detailed wiki on the tool which I hope provides enough information for how to use the tool and the benefits for using it.

Please visit and bookmark the wiki:

Your feedback is, as always, most welcome. Please comment here or contact me on Twitter.

Matthew Shaw

(Twitter: @MattShaw_on_BI)

You must be Logged on to comment or reply to a post.
  • Thanks for your comments.

    Providing an overview of the tool is one thing but really I think customers want to see task centric instructions. Am I right?  Well, if so you may like what I've written here. Here I explain how to use the tool when there is a problem opening documents to isolate the cause: Using WebiAdminTool to identify problematic method for opening documents - Business Intelligence (BusinessObjects) - SCN…

    Feedback welcome!

  • This sounds great. We are about to migrate to 4.1 and look forward to exploring the above tool. A quick question : Does this tool need enabling tracing at DEBUG level (Highest level) ?

    • You do not need to specifically enable tracing to use the tool. You can use the tool without any form of tracing enabled. Regards, Matthew

  • Hi Matt,

    in your wiki blog you mentioned to run the application locally. I'd like to know which of the .jar files I need to use. As customers running BI on non-Windows, they would also profit from this.



    • Thank you Sascha.

      I suggest you copy them all from the folder "C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java\apps\WebiAdminTool". You'll need to make sure this folder is in your CLASSPATH. (take a note of the ReleaseNotes.txt in the folder too)

      If those are not enough then throw in all the jars from the "C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java\lib" folder

      Let us all know how you get on.

      Many thanks for trying and exploring the Webi Admin tool.

      Regards Matthew

      • Thanks Matthew,

        I had to put in all of the jar files from the ...\lib  (really not sure which jar file was missing, had no time to debug). After doint this, the application runs fine in local mode.


  • Hi,

    Thanks for the presentation of this tool.

    The Memory Analysis perspective screenshot in your post shows empty values for all sessions, and I was never able to have anything but "0" for my Webi sessions memory values either.

    Is there anything specific that must be done on the tool to retrieve the proper memory values ?

    Thanks !

    • Hello Julien.

      I wonder which value you're referring to exactly? There's a lot of parameters shown on the screen. Either way, I believe most if not all of them will require a pretty heavy load for them to register much. Regards, Matthew


      • Hey Matthew,

        I wanted to pick up from Julien's question.  I have the same issue. I'm clicking on the 'Connect/Admin server instance' for my WPS, and then choosing the 'Memory Analysis Perspective'.  These values are always 0 but I know that there is memory being consumed because I see the WebiReportServer.exe is continuing to grow.  I think that I'm having a memory leak.

        Is there anything that needs to be done to see the numbers?  We have a heavy daily load.  I can restart the WPS and it will grow to 15GB in a single day if I push it hard enough.



        • Hello Terance

          Seems the tool isn't picking up those values.  Could you try and pick up the same counters using the Monitoring solution that comes as part of the BI Platform please? You should see most, if not all, of these counters available. Certainly all the possible counters that can be exposed are exposed to the monitoring.

          Let us know how you get on. Regards, Matthew


          • Hi Matthew,

            Thanks for your feedback !

            Following up on this issue, the Monitoring feature available in the CMC allows us to use, for the WebIntelligenceProcessingServer servers, the metrics that are already available under Services > Right click on the WIPS > Metrics.

            There's indeed a "Virtual memory size" value but it doesn't provide anything more that what we can see in the Windows Task Manager. On the other hand, the Memory Analysis perspective lists multiple Memory-related metrics per sessions (including a Memory leak one). I believe that this is what Terrance and I are looking for.

            Do you think that this issue can be fixed in the Webi Admin Tool or are we talking about different Monitoring features ?

          • Hello Julien

            It appears there's not a defect with the WebiAdminTool per say. Rather the Web Intelligence Processing Server simply isn't exposing the metrics you need. I know the Monitoring exposes all that is possible. Sadly this won't be considered a defect, as its probably never showed this value. So it means its a enhancement request. Please do submit the idea through

            Sorry I don't have a solution. Regards, Matthew

          • This is good information, I've been digging around trying to monitor/watch and identify memory leak in WIPS. I've been finding same limitation as Julien and Terance.


  • Looking at the Server Metrics Overview (2nd tab from the top on the left), the Virtual Memory Size graph is always blank.  Is that because I have "Enable Memory Analysis" turned off on the Webi Processing Servers?