Skip to Content

How to display custom message in BI Launchpad Login page

In a recent BO upgrade project, I did face a requirement of displaying custom message in BI Launchpad login page. The upgrade happened from BOXI3.1 to BO 4.0. Earlier, they used to edit the logon.jsp file inside InfoViewApp web service folder to display their custom messages. But the same trick did not work in BO 4.0.

In this blog, let me describe how I managed to display a custom message in BI Launchpad login page for SAP BusinessObjects Business Intelligence Platform 4.0 SP6.


Let the requirement be as below:

  1. To show a pop-up message when the user enters the URL for BI Launchpad.
  2. In the log-in screen we need to show some custom message.


Let’s assume that SAP BO BI Platform 4.0 has been installed and configured with default Tomcat web application server.


Here are the steps to achieve the requirement:

  1. Stop Tomcat in the BO server.
  2. Delete the folder <Tomcat Installation directory>\work\Catalina\localhost\BOE. This is a temporary folder and will be re-created when tomcat will be started.
  3. Go to the folder <Tomcat Installation directory>\webapps\BOE\WEB-INF\eclipse\plugins\webpath.InfoView\web.
  4. Take a backup of the file custom.jsp and keep it in a safe location.
  5. Create a copy of the file logon.jsp in the same folder and rename it as custom.jsp.
  6. Open newly created custom.jsp file in notepad for editing.
  7. To create a pop-up message, append the following line just before the <title> tag:<scriptlanguage=JavaScript> alert(‘Custom Pop-Up Message’);</script>


    <script language=JavaScript>

    alert(‘Information: \n Any Report / UserID not used in last 2 months will be cleaned up as part of Regular System maintenance.’);


  8. Add the custom message you want to display in the login screen just after the line :




    <font color=“Mediumblue”>For logon credentials, kindly contact

    <a><font color=“red”><span style=“text-decoration:underline;”>Arijit Das</span></font></a>


  9. Save and close the file.
  10. Go to folder <Tomcat Installation directory>\webapps\BOE\WEB-INF\internal.
  11. Take a backup of the file and keep it in a safe location.
  12. Open existing file in notepad for editing.
  13. Change the line




  14. Save and close the file.
  15. Start Tomcat from Central Configuration Manager. It will take some time to re-generate the BOE temporary folder which we deleted in step 2.
  16. Clear browser cache and java temporary files.
  17. Now open the BI Launchpad URL: http://boserver:port/BOE/BI in the browser.
  18. First the pop-up message will appear as we configured in step 7.

  19. Once you click OK, the logon screen will appear with custom message that we configured in step 8.

How to do it for BO 4.1

The process is similar for BO 4.1 also but with some minor differences :


Steps 1-7 are same as we did for BO 4.0.


Step 8: Add the custom message to be displayed just before the tag <h:form>.

Steps 9-12 are again same as before.

Step 13: Change the line





Steps 14-19 are again the same as before.


Changing files directly in tomcat folder should not be considered permanent. Once BOE web service is re-deployed from the original war file, the changes will be gone. So, better is to make changes in the following files and then run wdeploy tool to redeploy BOE web service.

  • <BO Installation Dir>\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\internal\
  • <BO Installation Dir>\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\eclipse\plugins\com.businessobjects.webpath.InfoView.jar

How to do it for BO 4.2 Fiorified Launchpad

Please follow the blog:


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

    I have one problem, I did same  example your , my initial page is ok. But when I loggin and after logout  I dont see the same page, I am seeing  old pagei

    • Hi Alberto,

      Do you want to get the login page back when logged out ?

      If yes, follow the steps below:

      1. Stop Tomcat

      2. Copy the file from <Tomcat Installation Dir>\webapps\BOE\WEB-INF\config\default to <Tomcat Installation Dir>\webapps\BOE\WEB-INF\config\custom

      3. Configure the exit URL in the new properties file. There is a parameter url.exit in the properties file. Configure it as url.exit=http://server:port/BOE/BI

      4. Start Tomcat


        • Hello Arijit,

          First of all thank you so much for sharing useful information for customization.

          I am using BO 4.1.As mentioned by you, I added some text on login page of BI Launchpad and it's working fine.

          After that I followed the steps mentioned by you to Alberto but when I logoff the BI Launchpad screen just show a white window (kind of hang up). The error message says "Invalid argument :".

          The bottom line is I am not able to get back to login page with csutomizations done after logging off though I can see customizations when opening BI Launchpad.

          Please advise.



  • Hi Arijit,

    I followed your blog and added a custom message in BI launch pad login page.

    Thanks for the same.

    I would like to know whether we can add such customizations (other than changing colors,logos etc) like we can do for Login page by altering  logon.jsp file.

    eg: adding hyperlinks, custom messages in BI launch pad HOME page.

    Do we have access to jsp files for these pages as well?



    • Do you want to customize the home page after login ?

      It is recommended to use the OEM customization tool in that case, which allows us to control colors, fonts, logo etc by using our own css and custom images. Adding additional elements is not possible with this tool though.

      • Are you referring to the CUSTOMIZE.CSS file included in the infoviewbranding.jar?

        I have already modified the background and border colors, logos etc by altering CUSTOMIZE.CSS file .

  • Hi Arijit,

    Is it possible to change login form style, like increase the height and width of username and password fields?

    Just for testing I have removed <h:form.. </h:form> and tested then I don't see logon fields on screen, so what does this form and from where this form is coming.

    Please let me know your thoughts on this.



  • Thanks a lot for sharing this Arjit.

    I need to know how can i dispaly an image in the logon.jsp file. We are using Tomcat with Vintella SSO, while SSO is happening the browser is struck on logon.faces for few seconds and a blank screen shows utill it logs in completely. I want to eliminate this by showing some image on the browser screen while SSO is happening.

    I am sure there are lot of others who would be interested in such solution, any inputs on this would be of great help.



    • Thanks JRK  rather I think there should be such such functionality available by default. In most of the enterprise web applications you will see some loading or welcome message while its authenticating instead of just a blank screen. I think we should submit this as an idea.

    • It is recommended to use OEM Customization tool for any customization in the BI Launchpad UI after login. But I doubt if showing a custom message there is possible.

  • And i presume it's athe same place i can add a link to do a reset password (like on my BOBJ system - who's connect to a ECC system) - i've did the same thing for Dataservices, its connected to ECC and i want to add a link to do a reset password

    Thanks for the help, really appreciated (see attach)bi_launchpad.JPG

  • Hi Arijit,

    Thanks for sharing!!!

    we have a BO 4.1 and the users access their reports through an Enterprise Portal so, there is SSO between the two servers, but every time the user click the menu for a BO report there is a blank page for about 4 seconds which as I can see is the time that takes openDocment .faces to load, I think this is the logon part (am I wrong), the question: is there any way to reduce this 4 seconds? if not, is there any way to display another page, not a blank one, for example a page with an image of a clock (o something like that).



  • I've been trying to get this working for the past few days; nothing I do seems to work.  I've tried all of the steps above with no success.  We use Active Directory and are automatically logged into Launch Pad when we hit our url, e.g., https://servername:port/BOE/BI/.  We do not receive a warning message, nor do I see any changes to the logon screen when I click the logout button from Launchpad.  Any ideas?

  • A great idea and very useful. I may investigate further to see if I can integrate this with the data warehouse load to create a popup message warning about a load failure.

    • Hi Mark

      I have a very similar requirement. If a new report has been published client wants a Pop up on login screen. Please let me know if you have done anything on the load failure. I can probably do the same thing . Unfortunately i have very limited knowledge of Java to do any changes like this. Also Since the changes are not static it will be difficult to redeploy the BO Portal (by stopping tomcat) so frequently.



      • I've not tried it yet, real world projects have got in the way. I would be trying it on 3.1 if I do get the chance but there's nothing to stop you using php or similar to check the warehouse.

  • Hello Arijit,

    We are on BI 4.1 and I tried the steps (1 -19) you provided and restarted tomcat and I do not see the popup message. What am I doing wrong?

    Thx Rupa

  • Hi Arijit,

    Also in your step # 12 (Open existing file in notepad for editing which is under <Tomcat Installation directory>\webapps\BOE\WEB-INF\internal),

    I see in this dir there is a readme file that says: DO NOT MODIFY FILES IN THIS FOLDER! These files are part of the internal configuration of the BOE web app and may NOT be modified by the end user admin.)

    Is it okay to modify this file here?


    • Actually this method of customization is not supported by SAP. This is just a workaround. For me, it did cause no issue. If you do so, always keep a backup.

  • Hi Arijit,

    Thanks for sharing this. I tried the same steps and seems like this is not working for me. Is this because we have a SSO enabled, anyone who go to the URL is directly taken to the launch pad.

    My question :

    1. Is there any way we can display this custom message in the launch pad landing page.

    2. or a pop up once the user is logged in.


    Pradeep Prakash

  • Hello Arjit,

    Very useful post..!!! Excellent..

    I am also having kind of same requirement, where I want to modify default error msg.

    My scenario is as follows:

    1. In my dashboard I have used Tab control having 3 tabs.

    2. Each tab contain URL button which navigates to other dashboard.

    3. Few users having one access to 1st tab. i.e. only one dashboard.

    From CMC I explicitly removed view access to  that dashboard.

    4. Now when user click on URL button it navigates to error page showing error as:

    "An error occurred: Could not find the document."

    5. I want to modify this error.

    Can u plz ut some light on this.



  • Hi Arijit,

    Thank you for sharing this info. Did you ever tried adding a customized text for Inforamtion Steward logon page? Could yo please help me.

    Kind Regards,


  • Hi Arijit Das,

    I have implemented this successfully, however after logging out from BILaunchpad it again loads the same alert. Is there a way to stop getting this alert message after logging out from BILaunchpad? Its BI4.2 SP02 version.

    Thanks in advance.


    • create a page without alert message and configure url.exit parameter in to display the page without alert on logoff.

  • Hi Arijit,

    Thanks for sharing this post, I have successfully implemented this in tomcat but how to update the BOE war file which we have to deploy on weblogic.

    when I go to below location, I don't see custom.jsp or logon.jsp files

    <BO Installation Dir>\SAP BusinessObjects Enterprise XI 4.1\warfiles\webapps\BOE\WEB-INF\eclipse\plugins\com.businessobjects.webpath.InfoView.jar

    Could you please help me.

    Thank you


  • Hi Arjit,

    This is useful article, thank you, with SSO this alert message is not poping up , can you help me  who to custom alert with SSO.



  • Hi Arjit,

    Thanks for this article, very useful. I have implemented your workaround in BI Launchpad 4.2 version and it works fine.

    Now the problem is i have to do the same custom message on Opendocument login page, when i tried the same steps it doesn't work. can you please advise the steps to update the custom message on Opendocument login page, this is quiet urgent request will appreciate your prompt response.


    • I never tried to customize the opendocument entry point. Will try it and update if I am successful.
      However, are you aware of the issue with login using OpenDocument entry point ? If not, check this:

  • Hello,

    I want to be able to change the text on the Logon Page

    "Enter your user information, and click "Log On".
    If you are unsure of your account information, contact your system administrator."

    This used to be possible with BOE XI 3.1 using the within the PlatformServices_en.jar file located at E:\Tomcat7\webapps\PlatformServices\WEB-INF\lib

    Any thoughts for BI 4.2?

    Also, I'm reading through the Guide. It's not clear to me if the Customization described has to be done BEFORE the installation only?

  • Thanks for the post. This helps a lot.


    Is it possible to customize the error message user get during logon? For example if I enter a wrong password it shows

    Account information not recognized: Enterprise authentication could not log you on. Please make sure your logon information is correct. (FWB 00008)
    We want to change that to show a phone number and email address where users can reach out. Any idea?