SAP Lumira Server Prerequisites and required BI Platform components
This blog is applicable for the SAP Lumira Server 2.x versions, and I have used the SAP Lumira Server v2.2 for taking the screenshots, which is scheduled to be released soon, please refer the SAP Note 2465894 for the planned release schedule.
This blog is intended to explain how the installer for SAP Lumira Server add-on of BI Platform, performs the prerequisite check in different steps. Before going into the details, let me brief about those different steps in the context of add-on product installation, there will be mainly two steps, first one is to check the core prerequisites and the second one is to check the required base product components.
- Prerequisites – These are the set of some critical and optional requirements of the installer to proceed further, and installer will not proceed further until all the critical requirements are met. This set includes mainly checks for Operating System version & architecture, any third party required software installed or not, base SAP Product installed or not (this check happens for add-on installers), user privileges and registry etc. And this step happens in the very beginning of the installer launch. Most of the prerequisite checks will be displayed in the following install screen named “Check Prerequisites“.
Note:
Prerequisite screen in case of SAP Lumira Server installer, unlike the BI Platform installer, will not appear unless there is any critical requirement failed. And it will only show the failed prerequisites.
Base product version check in case of SAP Lumira Server will not happen as part of the prerequisites check, it will only check the required base product is installed or not, you need to ensure the compatible base product version is installed by referring the Product Availability Matrix.
- Required base product components – These are the set of checks for the required base product components, based on the list of features of the product being installed are dependent on the base product components.
for Example: In case of SAP Lumira Server add-on Installation, the feature “Lumira Server” is dependent on the BI Platform feature “Platform Processing Services”.
Now let me explain the different scenarios related to the above two steps.
Note: Following scenarios are prepared based on the SAP Lumira Server 2.2 on an fresh Windows machine where there is no base (BI Platform) and another windows machine with SAP BusinessObjects BI Platform 4.2 SP02 as base(I have considered the BI 4.2 SP02 as base to showcase that SAP Lumira Server Installer will not check the base platform version compatibility as stated above).
Here are the few critical prerequisite failure scenarios of the SAP Lumira Server installer.
Reboot required:
When the installer detects any pending reboot, then the prerequisite screen appears with the following error message along with the corresponding information:
System reboot is required prior to installation.
Information: Restart your system before proceeding with the installation. Refer to SAP Note(1592070) for more details. INS00289
No base product installed:
As explained earlier, SAP Lumira Server is the add-on on top of BI Platform, hence it checks whether the BI Platform is installed or not prior to the installation. If it is detected as not installed, then the prerequisite screen appears with the following error message along with the corresponding information:
BI Platform should be installed in your system prior to this installation.
Information: SAP BusinessObjects Lumira Server for BI Platform can be installed on the same machine as BI platform server.
Following is the screenshot taken on another machine where both the above mentioned two prerequisites failed:
Non-Administrator User:
If non administrator user launches the SAP Lumira Server installer just by double clicking the setup.exe, then the installer throws the following error:
“Fatal Error : At least one port in the range 4520-4539 must be open for the installation to proceed. Please ensure that no application or firewall is blocking this range.”
This error occurs much before any action is called hence it will be not part of the prerequisite screen.
Note: This error is occurring because the OS user launching the setup engine is not having admin rights, but the error message does not convey the same. This is the change in behavior in SAP Lumira Server 2.2. But for the same scenario with SAP Lumira Server 2.1 the error is captured properly and will be shown as part of the prerequisite screen as shown in the following screenshot.
Administrative rights are required.
Information: The account does not have administrative privileges. INS00287
Coming to the features dependency on base product components, following are the list of features of SAP Lumira Server add-on and their dependencies:
SAP Lumira Server Feature |
SAP BusinessObjects BI Platform feature(on which the Lumira feature is dependent on, along with the Install feature tree location) |
Lumira Server | Platform Processing Services under Servers\Platform Services |
Web Applications | Java Web Applications under WebTier |
Restful Web Services | REST Web Service under Servers\Platform Services |
Scheduler Service | Platform Scheduling Services under Servers\Platform Services |
Mobile Web Applications | Mobile Services under WebTier |
To explain the features dependency on BI Platform components, I have used another windows machine where the BI Platform is installed but with limited features only selecting the CMS, FRS and Connectivity Services through custom option as following as shown int the following four screenshots:
On that above said machine, when you launch the SAP Lumira Server installer, and if none of the prerequisites failed, then you can come to the “Select Features” screen, but all the features will be in disabled state as the required BI Platform components are not present in the base product, and the “Next” button will be in disabled state and you cannot proceed further, as shown below:
At this stage you need to exit the installation program and either add the corresponding features in the base BI Platform to bring the depending components of the BI Platform into the base product or perform the installation on a machine where the required dependent components of the BI Platform are already present.
To show the each dependency, I have used the same above mentioned base machine where the BI Platform is already installed and started adding back the required components one by one.
First I have added back the “Platform Processing Services” feature of the BI Platform to clear the dependency for the “Lumira Server” feature.
Once adding back the “Platform Processing Services“, then again launched the SAP Lumira Server installer to check the status of its features, and now the “Lumira Server” feature got enabled as its dependent component is available now in the system, as shown in the following screenshot:
As you can see only the “Lumira Server” feature got enabled and still the other features are still in disabled state, and the “Next” button is enabled now, because these features are not inter dependent and either can be installed one after another through the Modify option or can be installed in different machines as a distributed setup.
Similarly the following screenshots explains how the SAP Lumira Server features under the Install feature tree gets enabled as the corresponding dependent components gets added to the BI Platform product.
Added the “Java Web Applications” feature through the Modify install option, to the base BI Platform
Then the “Web Applications” feature of the Lumira Server also got enabled:
Added the “Mobile Services” feature through the Modify install option, to the base BI Platform
Then the “Mobile Web Applications” feature of the Lumira Server also got enabled:
Note:
This is just to clarify regarding the web applications features of the SAP Lumira Server installer, as you can see the features “Web Applications” and “Mobile Web Applications” got enabled, based on the availability of the depending features of the BI Platform, if you select these features and proceed and install, that means these features will be adding the content to the respective base web applications of the BI Platform. Basically these features brings the SAP Lumira server specific content and adds to the relevant web applications content source folder of the BI Platform, i.e. for ex: C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps.
And this content along with the base web applications content gets deployed based on the status of whether the default bundled tomcat is installed or not on that machine, or this content also gets deployed when the base web applications get deployed on any other existing support Application server, as these are now became part of the base web applications of the BI Platform.
Added the “RESTful Web Service” feature through the Modify install option, to the base BI Platform
Then the “Restful Web Service” feature of the Lumira Server also got enabled:
Added the “Platform Scheduling Services” feature through the Modify install option, to the base BI Platform
Then the “Scheduler Service” feature of the Lumira Server also got enabled:
Before concluding, I would like to reiterate the following points:
- SAP Lumira Server prerequisite screen will not appear unless there is any critical prerequisite failure.
- SAP Lumira Server prerequisite check related the base BI Platform, will not check the supported compatible BI Platform version, rather just checks the BI Platform exists or not, you need to ensure that you are installing the SAP Lumira Server on the right version of the BI Platform by referring the Product Availability Matrix.
- SAP Lumira Server install features are independent of each other and will be enabled for selection based on the availability of the dependent BI Platform components availability.
Thank you.
Useful blog.
Why do we require CMS and FRS services if we have BIP on seperate node.I believe we can use that
Yes Siddhesh, you are correct, we can use the CMS and FRS running on the other node, in my screenshots, I have used a single node landscape, hence the CMS and FRS features are in selected state.
If see, I have clearly mentioned the actual dependency of each feature of the Lumira Server with the actual feature of the BI Platform in the table already:
SAP Lumira Server Feature
SAP BusinessObjects BI Platform feature
(on which the Lumira feature is dependent on, along with the Install feature tree location)
Hi Venkateshwar..
I installed SAP Busines Objects Edge Edition Trial version 4.2 SP5 on my virtual machine...But I am unable to find Lumira in mny appplications list...I read that we have to install SP Lumira Server ad-on component...can u help me with the download link to download the SAP Lumira server...
Rgds,
N.Srikanth
Hi Srikanth,
As your platform version is BI 4.2 SP5, hence as per the Lumira PAM
Lumira 2.2 is the supported add-on version.
Here are the steps to download the Lumira Server 2.2:
Launch the following url https://launchpad.support.sap.com/#/softwarecenter by login using s-user account
Under “INSTALLATIONS & UPGRADES”
Expand “By Category”
and click on “Analytics solutions” and then navigate in the followng path
Regards, Venkat.
Hi,
When i launch SAP Lumira Server 2.2 on my server which already has BI 4.2 SP6 FULL installation, I see the below screen.
This tells me all the required components already exists on the Server. Shouldn’t i only be installing “Lumira Server” and rest should be Unchecked? I do not want to change any of the Web Application (Tomcat) configuration as part of the setup.
Regards,
Farha
if you uncheck, they will be removed.
If you're installing - you want all to be checked.
If you're modifying - you only uncheck those items you do not want.
Thank you Denis for the response. I ended up running the installer with all options selected. Couple of observations:
Would unchecking “Web Applications” be the way to avoid these issues?
Regards,
Farha
those are not issues. those are normal behaviour.
Hi Farha Tarannum ,
The above screen of Lumira add-on is showing the list of features it is going to install, and by default all those features will be selected to be installed, if you do not want any of those features, you can un-select them and proceed for the installation.
But one thing, there can be chance that, any of these features will appear in greyed out mode and unselectable when the underlying BI Platform feature is not installed in that machine, if all these features are appearing as enabled and selectable means all the required components of BI Platform is already installed and you can install on top of those BI platform components the stuff related to Lumira.
As per the above screen, it is evident that in your machine all the required features of BI platform are installed, that is the reason all these features of Lumira add-on is coming as enabled and selectable.
For example: In case though the Mobile Services of BI platform is installed but if you are not using any mobile scenarios and you do not want to add any extra stuff from Lumira on top of that Mobile services, then you can unselect the feature "Mobile Web Applications" from the above mentioned screen and proceed for the installation.
The same is what I was trying to explain in the blog, the relation/dependency between Lumira features and Platform features in sequence.
Hope this clarifies.
Regards, Venkat.
Hi Venkateswar,
Last week we have installed SAP BO 4.2 SP08 Patch3 in cluster node. Now we are installing SAP Lumira 2.2 server update in the same cluster node on top BO installation. While trying to trigger the installation we are getting below error in prerequisites page. Could you please help?
Error Information:
This update is for #product.teamserveraddon_shortnamed, which has not been detached on the system. Install it first in order to continue with this installation.
you have to install "lumira server full" package first
in 2nd step the patch package
Is it possible to install in that way Lumira Server with SAP BI Edge (BI Edge do not support clustered environments) or how do it?