Updating SAP BusinessObjects BI Platform to Lumira 2.x
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.
Convergence
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.
Workflow E: Updating Lumira 2.x to another Lumira 2.x
Always apply the ‘patch’ Lumira 2.x BI Platform Add-on to update Lumira 2.x to another Lumira 2.x
Once you have updated your BI Platform to Lumira 2.x then all subsequent updates to Lumira 2.x require the patch update, regardless of what you had installed beforehand.
Do NOT uninstall any existing Lumira 2.x software, to then perform a ‘full’ install. All you need is a ‘patch’ update.
There is NO need go via any particular Lumira 2.x version (with the only exception if you where on the Lumira Early Adopter Care Program there are known update issues. KBA 2521113) This means you can update directly from say Lumira 2.0 SP2 to Lumira 2.1 SP1, by just applying the ‘patch’.
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.
All BI Platform Services?
As I mentioned in this blog I strongly recommend installing all the Lumira components. I not only recommend you install all the Lumira components, but also to install all these Lumira components on all the machines in your cluster. Why? Because it provides consistency and flexibility. It means your configuration is no longer tied to a decision you make at install time, you might want to run some components on other machines later. Additionally, some components, like the WACS requires an update for Lumira, so you might as well install all components everywhere, otherwise you won’t be able to run WACS anywhere.
However, I also strongly recommend you install all the BI Platform services everywhere too. For exactly the same reasons: it provides consistency and flexibility. So before you update to Lumira 2, go to the BI Platform install and modify it, and select all the other components that aren’t already installed. There are sometimes software defects because not all components are installed and doing this before installing Lumira 2 will help avoid those kind of issues. This is especially true when Lumira 1 was run on a ‘dedicated’ machine.
Lumira 1 to Lumira 2 document conversion
With your servers now updated to Lumira 2, you will not be able to view any Lumira documents, until you have converted them via the desktop into the new format.
Please follow SAP Note 2509882 for more details on the steps required.
Promoting Design Studio 1.x content or Lumira 1.x into a new cluster with Lumira 2
There are some very special requirements which I have described in this blog
Old Design Studio 1.6 applications [updated 12/Dec/2017]
As this blog showed here, old Design Studio 1.6.x applications will continue to work even though the server has been updated. However any applications using the legacy HANA JDBC connections need adaptations, and their bookmarks will become invalid. Please refer to SAP note 2475223 for details.
Old Design Studio 1.6 applications that use the ‘InfoChart‘ component do run a little slower when running in compatibility mode. SAP development is aware of this issue.
There is one other very small gotcha to watch out for though. It’s so small its almost not worth explaining, its unsupported too, but lets just share the info anyway! :
Only Design Studio 1.6 Support Pack 6 (or greater) client will work once the server has been updated to Lumira 2.0.
If you wanted to use a non-recommended configuration of using Design Studio 1.6 client with a server with an Lumira 2 server add-on installed, it means you need to update the client to Design Studio 1.6 Support Pack 6 or greater. (if you don’t you’ll get an error when you try to login “You are not authorized to execute application”) We strongly recommend to use the Lumira Designer 2.x client with the same version of the Lumira 2 server add-on.
There is no need to go via Design Studio 1.6 SP6, nor is there any need to update the application (This blog previously mentioned you did – not the case!)
With Lumira Designer 2.x client you can run it in ‘compatibility’ mode which means you can continue to create new applications and edit and publish existing applications of the old format. The compatibility mode will be of version ‘1.6 Support Pack 6’. Using the Lumira Designer 2.x client in ‘compatibility’ mode saves you the need to convert them to the Lumira 2.x format until you are ready to take advantage the new version provides.
Design Studio 1.6 clients and Lumira 1.x clients with a Lumira 2.x server
Lumira 1.x clients can not store any new content into the Repository once Lumira 2.x has been installed.
Further, only Lumira 1.31.8 can access and download the old .lums (Lumira v1.x) documents held in the Repository.
Design Studio 1,6 clients will receive a “version mismatch warning” since the client version is not the same as the server version and this means the client isn’t supported in this configuration. Just like any update, both the server and the clients needs to be updated to the same version. There’s only a few exceptions like: Lumira 1.31.8 that can read a Repository that has had Lumira 2 installed, and the latest version Desktop Intelligence XI 3 that can also access a BI 4.x repository.
Uninstall of the Lumira 2.x Server Add-on
Like all BI Platform Support Packs and Server add-ons, the uninstall of the software is supported, but this will only uninstall the software from the disk and NOT from the repository.
This means that once the Lumira 2.x server add-on has been installed (like any BI Platform Support Pack or Server add-on) its installed and can’t be uninstalled from the repository.
You can’t uninstall it and expect the old Design Studio add-on to work – it will not. The same applies to Design Studio 1.x clients, they will still receive a version mismatch warning as the repository is on a newer version, albeit with the server software uninstalled, the repository has still been updated.The same applies for Lumira 1.x clients, they too will not be able to store old .lums (Lumira 1.x documents) into a repository that’s been updated once Lumira 2 has been installed – regardless if Lumira 2 has been uninstalled. The ‘uninstall’ is for the software on the disk, not to uninstall from the repository.
Instead, you need to rollback the CMS repository (and the FRS) to complete the uninstall process.
Related articles
- For more details about updating please refer to SAP Note 2462804
- If you participated in the Lumira Early Adopter Care Program there are known update issues. KBA 2521113
- For General BI Platform Updating and also a number of very important points around BI 4.2 SP4 please see https://blogs.sap.com/2017/05/12/a-simple-guide-to-updating-upgrading-your-sap-businessobjects-bi-platform-the-rules/
- More Blogs on Lumira https://blogs.sap.com/2017/04/18/whats-new-with-sap-businessobjects-lumira-2.0-launch-blog-series/
- Release dates for Lumira 2.x SAP Note 2465894
- Lumira update issue “Cannot find sap.viz.modules.rootContainer in category module” KBA 2553083
- Design Studio application 1.6 to 2.0 conversion SAP Note 2538142
- Pattern Book for updating to Lumira 2 for both Lumira and Design Studio: blog introduction and the Pattern Book
- Lumira Designer Troubleshooting wiki
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!
Hello Matthew,
Based on the recommendation to delete DS Analysis services once Lumira is updated to 2.x, shall we modify Max Heap Size for Lumira APS or it doesn't matter?, since currently we have two Analysis APS containing Analysis Application Service both with 16Gb of Max Heap Size.
We were wondering if we have to reassign the Max Heap Size(16Gb per Service) of Analysis services to the upgraded Lumira APS Service?
Please let us know your feedback on this or what would you consider the optimal approach.
Regards!, Roy Garcia
Hello Roy Garcia,
Yes, absolutely. You'll need to edit the XMX setting. Assuming you'll use Design Studio applications with Lumira 2 Designer in the same way then you can use the same setting as you had before. (re-assigning the Max Heap). However once you start to use Lumira Discovery then you'll need to adjust this settings by increasing it.
Regards Matthew
Perfect, we'll consider this in our upgarde path, thanks.
Now, one last thing, we have 3 servers(CMS service will be available on three of them) with Lumira component installed, one with Lumira Processing services and the other two with Lumira Web Applications, is it possible to launch the update Installer in parallel or do we need to perform it one at a time?
I have looked for information on updating within a distributed environment but haven't found any helpful information.
Appreciate your feedback on this.
Thanks, Roy
FYI, support has told me not to change the Lumira APS heap size on the BI Platform and leave as DEFAULT.
Hello Rodringo
Sorry for my late reply.
The update of an add-on is not supported in a parallel manner.
Regards Matthew
Lots of new information. Thanks for sharing
Thanks Matt, exactly what i was looking for!
Sarah
Hello Matthew
Thanks a lot for the information.
I like to update to Lumira Designer 2.2
Which Server Component I have to install?
51053315 SP00 for SAP LUMIRA SERVER 2.2 WINDOWS
51053019 SBOP LUMIRA SERVER FOR BI PLATFORM 2.0 SP03 PATCH2 WIN
Thanks
Beat
Hello Bear
You need SP00 for SAP LUMIRA SERVER 2.2 UPDATE to update your existing Lumira (v1 or v2) server component to Lumira 2.2 SP0, and you'll need SP00 for SAP LUMIRA DESIGNER 2.2 for the Lumira Design desktop
Regards, Matthew
Hi Matthew
Nice meeting you the other day at SUG . I have question on Lumira integration with BO.
My client has BO servers on a AIX OS. They want to install Lumira server to that environment. I understand there are some constraints on using Lumira server on AIX OS. We were planning to use a windows box for the Lumira server and cluster it with the BO cluster which is on AIX. However this mismash of AIX (for BO server) and Windows (for Lumira server) in a clustered environmnet concerns me a bit. Is this a good practice? or is it better to stick to a clean BO and Lumira cluster on a Windows OS.
Is there any known issues to have AIX OS for BO and Lumira server on Windows in a clustered environment.
Regards
Sanjit
Hello Sanjit
Sorry for my delayed reply.
In general, mixing AIX and Windows nodes in a cluster is most certainly supported, there's a few rules you need to stick to, like the CMS must run on the same OS nodes. i.e. you mustn't run a CMS on the AIX node at the same time as on the Windows node.
You're right that there are restrictions for AIX, namely that 'Designer' documents are only supported, not Discovery documents. This means, that the processing aspects need to be hosted on Windows, whilst other parts could reside on AIX. The challenge though, would be to deploy the web applications on AIX. I would think the 'web tier' deployment would not exist for Lumira on AIX, so you'd need to grab the files from Windows and throw them onto AIX. In theory I can't see why this wouldn't work, but you never know there might be an issue somewhere. It would be worth a thorough test before doing it in production. You will probably need to run the WACS on Windows only too.
You're right that a Windows only install is cleaner, but I'm not convinced absolutely necessary.
Let us know how you get on.
Regards, Matthew
Hallo Mathew,
How can I update Lumira patch to version 2.8 SP01.
Could you please guide me.
Thanks and Regard's
Praksah