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“.
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.
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:
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:
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.