Skip to Content

If you’re updating your SAP BusinessObjects BI Platform to Lumira 2.x then you’ll have a few questions about the various server Add-ons. This blog provides a high-level view of the steps you need to follow to update your Design Studio 1.x and Lumira 1.x Add-ons to Lumira 2.x.


Lumira and Design Studio have converged into a single product and a single document type. Whilst there two client-side end user interfaces, one for the Designers (SAP Lumira, Designer) and one for Discovering (SAP Lumira, Discovery) there is a single server Add-on.

How do you update to Lumira 2.x?

If you already have deployed Lumira, or Design Studio or both, then you’ll need to know how to update. This diagram is probably the best way to explain:

Workflow A: No existing Lumira 1.x or Design Studio 1.x Add-on

You need to install the ‘full’ Lumira 2.x BI Platform Add-on.

Perhaps very obvious but I thought I’d mention it!

Workflow B: Existing Lumira 1.x

You need to install the ‘patch’ Lumira 2.x BI Platform Add-on.

Since you already have Lumira installed, albeit version 1.x, you need to ‘patch’ from Lumira 1 to Lumira 2.

Workflow C: Existing Design Studio 1.x Add-on

You need to install the ‘full’ Lumira 2.x BI Platform Add-on.

Since you don’t have Lumira installed, you’ll need the ‘full’ install package.

Once you’ve installed the ‘full’ add-on, your old ‘Analysis Application’ BI Platform server service will be redundant. It simply won’t be used any more. So, you should delete it, from within the Central Management Console, to regain some resources from your servers.

I’ve captured a step-by-step workflow, shown below, taking you from start to finish.

Workflow D: Existing Lumira 1.x and Design Studio 1.x Add-on

You need to install the ‘patch’ Lumira 2.x BI Platform Add-on.

Because you have the Lumira Add-on already installed, you’ll need to ‘Patch’ to Lumira 2, even though you’ve also got Design Studio Add-on installed.

Once you’ve installed the ‘patch’ add-on, your old ‘Analysis Application’ BI Platform server service will be redundant. It simply won’t be used any more. So, you should delete it, from within the Central Management Console, so to gain some resources on your servers.


Step-by-Step Workflow C: Existing Design Studio 1.x Add-on Update to Lumira 2.x


Before I apply the ‘full’ Lumira 2.x BI Platform Add-on you can see my existing Design Studio service defined in the Central Management Console. I have a dedicated Adaptive Processing Server with two services: ‘Analysis Application’ (the Design Studio processing server) and ‘DSL Bridge’ (for processing my Universe queries from within my Design Studio applications).

I built a very simple Design Studio Application in Design Studio 1.6. I built it off my Auditing Universe!

On starting the ‘full’ Lumira 2.x BI Platform Add-on installer you see the usual license agreement:

Here you select the services. I always install all the services and I recommend you do the same. Whilst you may not intend to run all of these services on the same machine, doing so provides consistency and the flexibility should you change your mind without having to come back to install them.

Enter the CMS and Administrator password details:

The install then starts:

The install is then finished:

My old Design Studio Application can now be stopped and deleted, since it’s never going to be used again. Instead a new Lumira Server Service will do all the work of what the old ‘Analysis Applications’ service did.

The new Lumira Server Service will also process what the old Lumira Server Service processed too of course. There is one single processing service for both tasks, since it’s completely integrated at the back-end.

With my old ‘Analysis Applications’ Server Service deleted, I can still open my old Design Studio Application. It will be processed by the new Lumira Server Service.

Other workflows

We are not recommending to uninstall the old ‘Design Studio 1.x’ Add-on or uninstalling the old ‘Lumira 1.x’ Add-on.  We strongly recommend you just update without uninstalling any previous Add-on.


Related articles


Feel free is post a comment and I’ll do my best to reply

For those on Twitter you can ask me a question @MattShaw_on_BI

Enjoy Lumira 2!




To report this post you need to login first.


You must be Logged on to comment or reply to a post.

  1. Manikandan Elumalai

    Thanks for Sharing this at the right time Matt. Just wanted to check with you on below as it is bit contradicting. Which one to use – Lumira Patch or Lumira full installer?

  2. Francisco Almeida

    Great post! It may be relevant to note that for cases where “workflow C” applies (i.e. no previous Lumira add-on and Design Studio 1.x upgrade to Lumira 2.0) the upgraded system will probably require a change: the Lumira server has always required its own host/virtual machine, so it can be assumed this will be the case in 2.x.

    This is relevant because the Design Studio Add-on did not have that requirement, so Architects could always scale their systems vertically. As Lumira and Design Studio have been merged into a single add-on, one can assume this will also require a dedicated host (scale horizontally).


    1. Matthew Shaw Post author

      You’ve raise a great question.

      So the requirement is the same. However the ‘old’ requirement (for a dedicated Lumira server) wasn’t really a requirement at all, but just a recommendation. It was documented as though it was a requirement.

      There’s nothing technically to stop you from running the Lumira Server on all your machines in the cluster.

      Lumira 1.x was almost solely used for data acquisition and thus it was an in-memory database which required a lot of (mostly memory) resources (but also plenty of CPU too!). So it was a recommendation to have a dedicated machine for that reason. But you could well run the old Lumira 1.x server on a node that was running other services, including Web Intelligence and Design Studio etc. – as long as that machine was powerful enough.

      So with Lumira 2.x it can have its old role, and it can have the Design Studio role:

      • it can still be an in-memory database for those acquired data enabling super quick slice and dice and visualisations – the general use-case for Lumira 1.x
      • Or as a powerful ‘scripted’ presentation layer when connecting to Live data sources – the general use-case for Design Studio 1.x (though Lumira 1.x also had a HANA live connection)

      Lumira 2.x can do both in a single integrated back-end. So the hardware resources depend upon the use-case you’re using it for.

      If you don’t change your use-case, that is you’re not going to acquire data and not use the powerful Velocity Engine, then you’ll be basically the same as you where before with regard to hardware requirements. If you decide you want to acquire some data, perhaps to enable off-line or scheduling capabilities, then you’ll need more hardware resources.

      So you can, and actually have always been able to, scale both vertically and horizontally.

      I’m not sure if this has helped or not?

      Regards, Matthew



      1. Francisco Almeida

        Of course it has – helpful as always. Is it fair to conclude that if the use case requires the benefits of the Velocity engine for fast data acquisition, the recommendation is still to have a separate host for this service to avoid resource starvation for other APS services?


  3. Jawahar Konduru

    Thanks Matthew for sharing this information. Just want to clarify couple of things, not related to Install. Mine applies to Workflow D. I did apply Lumira 2.0 and patch1. Below issue I am seeing. Looks like we need to rebuild the Lumira documents since there is no migration steps. it will be difficult for us, to rebuild the lot of content which is already there in production. Do you know when we can get the migration tool for Lumira?

    1. Previously built Lumira documents will not work in Lumira 2.0- Is there any migration process is in place?



  4. Matthew Shaw Post author


    With Lumira 2.0 Early Adopter Care you have access to Lumira 2.0 SP0 and SP1. (when you mention Patch 1, I presume you mean Lumira 2.0 SP1). There’s also the Open Beta Program which is Lumira 2.0 SP2 Beta.

    The General Availability Release is planned to be Lumira 2.0 SP2 but without the ‘Beta’. It is not until this release you’ll be able to open your old Lumira 1.x documents in Lumira 2.x. So you’ll need to wait until the General Availability Release Lumira 2.0 SP2 until you can open Lumira 1.x documents. This is mentioned in the release restrictions.

    There’s massive architecture changes between Lumira 1 and Lumira 2, and given the product doesn’t support this function yet, the reality of any Lumira 1 to Lumira 2 ‘migration’, is not fully known, at least not by myself. The plan is, at least, for you to do no migration steps.

    Documents created with Lumira 2.0 SP2 Beta will be supported in Lumira 2.0 SP2 (GA), that is you won’t need to rebuild those for sure.

    I hope this helps, Matthew

  5. Mark Richardson

    Matt –

    We are setting-up a brand new MUDBOX for taking part in the SAP LUMIRA 2.0 EAC program.

    The three new SAP LUMIRA 2.0 (SP01) packages were released to the EAC community last week – DESIGNER desktop, DISCOVERY desktop – and the ADD-ON FOR BI PLATFORM.

    This is a net-new GREENFIELD build of the BI PLATFORM – and we are aware that we can’t go to SAP BO-BI 4.2 (SP04) as our platform baseline for EAC testing, as it is not supported at that level yet.

    However, in looking at the PAMs, etc – it isn’t 100% clear which is the BEST patch-level to deploy on the Platform for the 4.2 (SP03) versions that will support the SAP LUMIRA 2.0 (SP01) EAC  ADD-ON FOR BI PLATFORM…?

    The PAM for EAC appears to say that we need the BI servers to be at BI 4.2 SP03-Patch 07…if we want to use Translation Manager or Promotion Manager with LUMIRA 2.0 content.

    If we are not using those components – should we be on the most recent available patch-level for the platform (SBOP BI Platform Servers 4.2 [SP03] – Patch 6 – Updated 20.04.2017) before we apply the SAP LUMIRA 2.0 (SP01) EAC  ADD-ON FOR BI PLATFORM…?

    Any clarity you can provide would be appreciated.





    1. Matthew Shaw Post author

      HI Mark

      should we be on the most recent available patch-level for the platform (SBOP BI Platform Servers 4.2 [SP03] – Patch 6 – Updated 20.04.2017) before we apply the SAP LUMIRA 2.0 (SP01) EAC  ADD-ON FOR BI PLATFORM…?

      No. You don’t need to be on the patch level before you apply the add-on.

      If you’re not using Promotion Management, Version Management or Translation Manager, then you’ll be just fine. You may get a support engineer commenting that you’re not on a support platform, since they have a process and the process say you need to be on whatever the PAM says!

      Regards, Matthew



  6. Thomas Nielsen

    Hi Matt

    Thanks for your, as always, excellent articles.

    I am still a bit confused, on what would be the best practice for upgrade a clustered and multi-tier environment. Well, the cluster not so much, since you had that covered, but what should be the steps for an upgrade when you have multiple dedicated web-tier (and mobile-tier) on a clustered environment. Do you run the installer on the web-tier as well, or is that done by a WDeploy?

    Looking forward to hear you best practices on this (or link to the information I might have missed) 😉




    1. Matthew Shaw Post author

      Hi Thomas

      You need to apply the add-on on the places you need it – and that may not be so obvious. So a great question/

      For your web tier you need to install it there. You won’t be able to install the non-web tier components on your web tier machines assuming you’ve not already installed the BI Platform there.

      Whilst, on your web-tier you’ll probably only going to install the web-tier option for this add-on, strongly advice installing all the add-on options everywhere as this provides: consistency (always a good thing)  and flexibility. Today, you may only intend to run the Lumira services on 2 of your 4 machines, but why not just install all the add-on options everywhere allowing you to change your mind later. You then have the flexibility to have say 3 or all 4 servers running Lumira.

      Also, the ‘web applications’ component I believe needs to be installed on the machines in your cluster that have the ‘Web Application Container Services’ service running. Since the logon from the Lumira Desktop will use for some workflows.  I’m not 100% on this, but I think we could get that clarified and I can update this comment once I know.

      Hops this helps?  (for everyone – please press the like button, its handy feedback!)

      Regards Matthew



    Hi Matt,

    Thanks for putting this up as this is very imformative.

    I have also installed/upgraded my Lumira 1.31 to Lumira 2.0 SP1 with BI on 4.2 SP3 Patch and Design Studio on 1.6 SP4.


    However when i try to log in to Lumira Designer. i get below error (attached).

    Also after the upgrade we fail to see the “Design Studio Runtime” application under CMC–> Application.

    Can you please suggest as currently its impacting our beta testing programme.




    1. Matthew Shaw Post author

      Can you try the Lumira Designer on a machine that doesn’t have the BI Platform installed on it? I wonder if this is expected or not. Mmmm. Or perhaps there’s a security settings that needs to be looked at. I’m not sure about this aspect.


      The old design studio application will have been removed during the update. This sounds right to me. It will now be the Lumira Designer you should see in the CMC applications.

  8. Kiran Gangaraju

    Hi Matt,

    What is the possibility having Lumira 2.0 SP2 (GA) supported on SBOP BI Platform Servers 4.2 SP04? We have upgraded our Sandbox system to 4.2 SP04 from 4.1 SP07. We are in process of testing. We are hoping to install Lumira 2.0 SP2 when is available. But if we know for sure, it won’t be supported on SP04, then we will upgrade to SP03.

    Can you please suggest?



  9. Kiran Gangaraju

    Looks like it will be supported from below note.

    2467541 – Supported BI Platform Add-On versions information for the SAP BusinessObjects BI 4.2 SP04 release

    Timelines for availability of Compatible Add-on versions Compatible with BI Platform version BI 4.2 SP04

    Lumira 2.0  2.0 SP02  Refer SAP Note 2465894



  10. Nitin Gupta

    Hi Matthew,


    Great article, But i want to clarify one point, our case is not covered in workflow described by you.

    We have a  Node A with BO platform + Lumira add on 1.31

    and  Node B with BO platform + design studio 1.6.

    We will want to keep Lumira 2.0 on the box already running 1.31, so in this case,  we can simple remove design studio 1.6 on node B as its not relevant any more ? or any other precaution need to  be taken care.

    And the dashboards already created in design studio will run with lumira 2.0 on node A  without any additional steps?


    Thanks and Regards,

    Nitin Gupta

    1. Matthew Shaw Post author


      Thank you for you comments.

      so in this case,  we can simple remove design studio 1.6 on node B as its not relevant any more ? or any other precaution need to  be taken care.

      We are not recommending uninstalling at all. (I do know we did a test of the uninstall of Design Studio and a fresh Lumira 2 install and it was ok, but even still our recommendation is don’t)

      Perhaps you could consider installing the add-on on both Node A and Node B, but just not run any Lumira 2 services on Node B. This way you get consistency and flexibility should you find later that you wish to run some Lumira 2 service on Node B. For example, whilst you may not want to run the Lumira 2 Adaptive Processing Service on Node B, you might want to run the WACS service on Node B. Since Lumira 2 requires the WACS service to be updated, you must apply the add-on to the server(s) where you need to run WACS.

      A second best option, would be to just leave the Design Studio 1.6 installation on Node B and leave it untouched, it ain’t broke so lets not fix it.

      Hope this helps (use the like button!), Regards, Matthew

  11. Singh Arun

    Hello Matthew,

    Thank you for the blog,

    One qq, is Lumira 2.o is released for all the users? I am not able to see link to dowload Lumira 2.o  under download software –>Installation and Upgrades –> L –> SAP Lumira, only SAP Lumira 1.o is available.



    Navneet Kaur

    1. Matthew Shaw Post author

      is Lumira 2.o is released for all the users?

      No. Lumira 2.0 SP2 (GA) has not yet been released for general availability.

      Lumira 2.0 SP1 is available for EAC customers (Early Adopter Care)

      Lumira 2.0 SP2 (beta) is available for OpenBeta customers.

      Lumira 2.0 SP2 (beta) is very similar in terms of features/functions as Lumira 2.0 SP1.

      Lumira 2.0 SP2 (beta) isn’t anything greater than Lumira 2.0 SP1

  12. Sameer Ahmed Ahmed

    Hey Matt

    I have the same Question as Arun, we are on BOBJ 4.1 sp 5 & Lumira 1.29, when I look in the SAP store at the location under download software –>Installation and Upgrades –> L –> SAP Lumira, only SAP Lumira 1.o is available.

    Is this not rolled out to all customers yet ?





  13. Nitin Kumar

    HI Mark,

    Thank you for brilliant post. One question about SDK and extensions, does extension built based on DS 1.x SDK will be portable on Lumira 2 Discovery. I guess it will surely will work for Lumira 2 Designer but need clarification for Lumira 2 Discovery. I think it should work as part of inter-portability !?



    1. Matthew Shaw Post author

      Hello Nitin,

      My understanding is that any old extensions you’ve build for Design Studio 1.x will continue to work when those Design Studio 1.x applications are run with a Lumira 2.x BI Platform back-end server add-on component and you’ve not yet converted the application to a Lumira 2.x application. The only restrictions I’m aware of is with that legacy HANA JDBC connections need adaptations, and their bookmarks will become invalid. Please refer to SAP note 2475223 for details.


      There are different types of extensions, from data source extensions, components and visualisations.

      Like with Lumira 1.x and Design Studio 1.x visualisation extensions can be written so it works in both, but they can also be written so it only works in one of them! For Lumira 2.x applications and their extensions the charting engine needs to use the main ‘m’ type and not the original CVOM library. Both charting types are available in Design Studio 1.x.

      For data source extensions, I don’t know if the same applies.

      For custom components, I’m sure these are only applicable for Design Studio and Lumira Designer.

      Does this help?

      Regards Matthew

      1. Nitin Kumar

        Thank you Matthew for response, I understand discovery object working in designer is the best we can get…Ideally would have expected it to work both way thereby utilizing innovations across.

        This led me to why two tools and why not one ? anyway that’s longer talk and out of context question…


Leave a Reply