Administration & Troubleshooting

Launchpad Cache Invalidation

Launchpad cache invalidation is the set of reports and steps that clear the caches of the SAP Fiori launchpad, mainly the server-side UI2 cache with /UI2/INVALIDATE_GLOBAL_CACHES and browser-side resources with /UI2/INVALIDATE_CLIENT_CACHES. Launchpad cache invalidation is a targeted fix for stale content after transports, upgrades or support packages, not a routine first step.

Quick facts

Type
Administration procedure (ABAP reports and transactions)
Layer
Content, navigation & access
Server-side UI2 cache
Report /UI2/INVALIDATE_GLOBAL_CACHES; transaction /UI2/INVAL_CACHES
Client caches
Program /UI2/INVALIDATE_CLIENT_CACHES, for all users or one user
Prevents stale apps
Scheduled /UI5/APP_INDEX_CALCULATE (cache buster tokens)
Who runs it
Basis and launchpad administrators
Applies to
SAP S/4HANA on-premise and Private Edition (ABAP front-end server)
Layer: Content, navigation & accessWhere it sits ▾
Where it sits: L2 · Content, navigation & accessLayer: Content, navigation & access.L1L2L3L4L5L6BTP

Layer: Content, navigation & access

Open the architecture map →

Which caches does the SAP Fiori launchpad use?

Three caches can hold outdated launchpad content:

  • Server-side UI2 cache on the front-end server, for the launchpad's own services such as page building and personalization. The system invalidates it automatically when a tile or catalog configuration, a PFCG role, LPD_CUST content or a SAPUI5 app changes.
  • Browser cache, for SAPUI5 resources, app code, target mappings and OData metadata. Cache buster tokens in the resource URLs make the browser reload only what changed on the server.
  • SAP Gateway metadata cache, for OData service models, cleared separately with /IWFND/CACHE_CLEANUP and /IWBEP/CACHE_CLEANUP.

Knowing which of the three holds the stale data decides which launchpad cache invalidation step is needed.

When should you clear launchpad caches?

SAP's position is that manual invalidation of the UI2 cache should normally not be required, because changes trigger it automatically. Clearing caches is justified when:

  • a transported catalog or app does not appear although roles and content are correct;
  • a support package, SAPUI5 note or release upgrade has been applied;
  • users see old app behavior after a deployment, and the SAPUI5 application index was not recalculated.

Do not clear caches as a reflex for every missing tile. A missing catalog in the role or a target mapping without the user's device type produces the same symptom, and /UI2/FLIA finds those in minutes. Launchpad cache invalidation fixes stale data, not wrong content.

How do you clear launchpad caches step by step?

After Alder Manufacturing imports a support package on its front-end server:

  1. Run /UI5/APP_INDEX_CALCULATE, or confirm that its scheduled job ran, so cache buster tokens reflect the new app versions.
  2. Run /UI2/INVALIDATE_GLOBAL_CACHES in SE38, or transaction /UI2/INVAL_CACHES, to invalidate all UI2 caches.
  3. If needed, run /UI2/INVALIDATE_CLIENT_CACHES in SE38, for all users or one user. Invalidating other users' caches requires the role SAP_UI2_ADMIN_700.
  4. Run /UI2/DELETE_CACHE_AFTER_IMP after the import if the upgrade guide for your release lists it.
  5. Clean up the SAP Gateway metadata cache if OData services changed.
  6. Ask affected users to reload, or clear the browser cache if symptoms persist.

Each client cache invalidation is logged in the application log (SLG1). Following this order makes launchpad cache invalidation predictable instead of trial and error.

What does /UI2/INVALIDATE_CLIENT_CACHES actually do?

/UI2/INVALIDATE_CLIENT_CACHES renews the global cache buster token. Since SAP introduced application-specific cache busting, SAP Fiori apps in the SAPUI5 repository get their own tokens from the SAPUI5 application index, and the browser reloads an app only when it changed. The global token still covers:

  • data from the launchpad's own OData requests, such as target mappings and personalization;
  • classic SAPUI5 resources that are not components, for example some custom tile implementations;
  • apps missing from an incomplete application index.

SAP therefore describes running /UI2/INVALIDATE_CLIENT_CACHES as necessary only in exceptional cases. A regularly scheduled application index makes /UI2/INVALIDATE_CLIENT_CACHES rarely needed.

UI2 cache vs. client cache vs. Gateway metadata cache: what is the difference?

Server-side UI2 cacheClient (browser) cacheSAP Gateway metadata cache
HoldsLaunchpad service data on the front-end serverSAPUI5 resources, target mappings, OData metadataOData service and annotation models
Cleared with/UI2/INVALIDATE_GLOBAL_CACHES or /UI2/INVAL_CACHES/UI2/INVALIDATE_CLIENT_CACHES; browser reload/IWFND/CACHE_CLEANUP, /IWBEP/CACHE_CLEANUP
Refreshed automatically byChanges to roles, catalogs, LPD_CUST, appsCache buster tokensModel timestamp handshake
Typical trigger to clearTransported content not visibleOld app version after deploymentChanged service model or annotations

Each cache has its own cleanup; clearing the wrong one leaves the stale data in place.

FAQ

Is /UI2/INVALIDATE_GLOBAL_CACHES a transaction or a report?

/UI2/INVALIDATE_GLOBAL_CACHES is an ABAP report, started in SE38. SAP also documents the transaction /UI2/INVAL_CACHES for invalidating all UI2 caches. Running either on the front-end server clears the server-side launchpad caches, not the browser cache.

Does clearing the cache log users out or delete personalization?

No logout is described. Invalidation forces the launchpad to rebuild cached data from the server, so the next start can be slower. The client caches hold launchpad data such as target mappings and personalization data from OData requests, so the launchpad requests that data from the server again.

Why do users still see the old tile after I cleared the caches?

The content itself is probably wrong, not stale. Check that the catalog is in the user's role, that the target mapping supports the device type, and that a customizing layer does not hide new configuration content. /UI2/FLIA shows which content the launchpad actually resolves.

How can I see why the UI2 cache was invalidated?

The Cache Statistics Utility, transaction /UI2/CSU, shows how often data is read from the cache and why the cache was invalidated. It helps when users report slow launchpad starts after frequent invalidations.

Sources

Applies to
SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition
Last reviewed

SAP, SAP Fiori, SAPUI5, SAP S/4HANA, SAP BTP and other SAP products and services mentioned are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. This guide is independent and is not affiliated with, sponsored or endorsed by SAP SE.