Skip to Content

SAP HANA XSA SPS 03: Port to Hostname-based Routing

Hi Experts,

we would like to change our prod system from "Port-based Routing" to "Hostname-based Routing", but we don't have any experiences in this case at all. On the prod system there are some apps running. What would this changes mean for this apps?

If we wouldn't change the route of this apps immediately, would them still reachable under the old port address? Or is the old address not reachable?

And are we able to create and assign the new HTTP route directly after that the routing system changes?

Would we have to bring some more of this routing changes also in the app (e.g. mta.yaml or xs-app), to ensure that the apps are still running?

Could this also affect to the authorization of this apps?

What does it would mean for our dev system? Do we would have to change it too?

Would be nice if someone of you could explain in what kind of issues we could run? And if there is a "How to guide" please let us know!

Thanks a lot!

Add comment
10|10000 characters needed characters exceeded

  • Get RSS Feed

1 Answer

  • Best Answer
    Nov 21, 2018 at 12:34 PM

    >we would like to change our prod system from "Port-based Routing" to "Hostname-based Routing"

    I don't believe that its supported to change a system in place.
    See note 2596466:
    Please note, that the routing mode cannot be changed after installation.

    I'd also suggest reading note 2245631: https://launchpad.support.sap.com/#/notes/2245631

    The recommended approach is to uninstall and reinstall XSA Runtime with the hostname routing option and then re-install applications. This will ensure all routes are re-created and everything is running fine. Of course with this approach the old ports will no longer be assigned as only the hostname based routes will be used when re-deploying the applications. Note even the port of the controller will change when you switch to hostname based routing.

    >And are we able to create and assign the new HTTP route directly after that the routing system changes?

    Yes all applications deployed will automatically use hostname based routing. You can no longer use port based routing once you make this change.

    >Would we have to bring some more of this routing changes also in the app (e.g. mta.yaml or xs-app), to ensure that the apps are still running?

    No you are not required to make any changes to the mta.yaml or xs-app.json. The xs-app.json is never impacted by port or hostname based routing. It does all its communication on the internal ports separate from the external communication. The mta.yaml doesn't have to be adjusted unless you want to optionally control the hostname route generation (just value in the hostname value instead of it generating based upon org-space-app name). Note even if you make these changes they are compatible with port based systems as well. The settings will just be ignored if deployed on a port based system.

    >Could this also affect to the authorization of this apps?

    No.

    >What does it would mean for our dev system? Do we would have to change it too?

    No changes would be required there.

    Add comment
    10|10000 characters needed characters exceeded