Skip to Content
Previous

Adding a Custom Login Screen to your HXE system

By Craig Cmehil

See how quickly and easily you can customize your HXE Server Only image and add a custom login screen.

How-To Details

The following steps will show you how to customize the login screen of your individual instance. Why might you want to do that? Well for starters if you have multiple systems this would help you distinguish between them or perhaps you simply want to make your system unique and your own.


  1. Either using the web based tools, like this tutorial will show you or using the SAP HANA Studio you will need to create a new application. The following steps will show the web based and assumes you will be able to use your skills with the SAP HANA Studio if you choose to use that. First step will be to open the IDE.

    IDEIDE
  2. Now you will right click on the top level content and choose a new application. In this example the application will be called codejam.mylocation

    Right clicknew app
  3. Now create a new package under the new application called images

    new package
  4. Next if you click on the package images you will get a screen that allows for multiple file uploads.

    uploads
  5. Here you will upload your login screen image or images. I have prepared 2 images both are 1920 wide but the height varies. Both are also JPG format.

    new files
  6. Now open the .xsaccess and modify the authentification line and change it to null

    file changes
    {
    "exposed": true,
    "authentication": null,
    "mime_mapping": [{
        "extension": "jpg",
        "mimetype": "image/jpeg"
    }],
    "force_ssl": false,
    "enable_etags": true,
    "prevent_xsrf": true,
    "anonymous_connection": null,
    "cors": [{
        "enabled": false
    }],
    "cache_control": "no-cache, no-store",
    "default_file": "index.html"
    }
    
  7. The next step will be to jump over to the Catalog editor and open an SQL console window. Execute the following SQL statement.

    statement
    ALTER SYSTEM ALTER CONFIGURATION ('xsengine.ini', 'SYSTEM') SET ('httpserver', 'login_screen_background_image') = '/codejam/mysystem/images/back.jpg';
    
    statement
  8. Now Open the Security editor and create a new user called _USS and assign and save that user the role sap.hana.xs.selfService.user.roles::USSExecutor

    role
  9. Now that the configuration has been set, content has been uploaded and the user has been created you will need to open a new site - change your URL to match http://server:8000/sap/hana/xs/admin/#/package/sap.hana.xs.selfService.user/sqlcc/selfService and then activate it (bottom right)

    activateactivate
  10. Now when you go to log in to your system you should notice a difference right off.

    login
  11. If you modify the configuration again you will notice we have something specifically for today, Halloween.

    halloween

Next Steps

Updated 03/24/2017

Time to Complete

10 Min.

Beginner

Prerequisites

  • Systems used: SAP HANA, express edition

Next Steps

Next
Back to top