Skip to content

Add "Session attribute serialization" section to the "Distributed session caching" doc #8507

Description

@tngiang73

We would like to add a new section to the Distributed session caching doc (https://openliberty.io/docs/latest/distributed-session-caching.html) to cover the following:

Session attribute serialization

When you use distributed session caching, all objects stored as HTTP session attributes must implement java.io.Serializable, including all objects in their class hierarchy. Liberty can only persist serializable attributes to the distributed cache. Non-serializable attributes are stored only in Liberty's local in-memory cache and are lost if the server stops or fails.

Liberty logs the following warning when a non-serializable attribute is detected:
BackedSession putValueGuts Attribute with name <attributeName> is not Serializable. This may cause a problem on a failover.

If you see this warning, ensure that the class for the named attribute and all classes it references implement java.io.Serializable.

Activity

  1. ramkumar-k-9286 commented on Aug 27, 2026

    @ramkumar-k-9286
    Contributor

    Hi @tngiang73

    Suggested change has been made to the Distributed session caching page.

    Draft Link: https://docs-draft-openlibertyio.mqj6zf7jocq.us-south.codeengine.appdomain.cloud/docs/latest/distributed-session-caching.html

    Please review the same and add the Developer Reviewed label, if you are satisfied with the changes.

    Regards,
    Ramkumar

  2. ramkumar-k-9286 commented on Sep 11, 2026

    @ramkumar-k-9286
    Contributor

    Published [26.0.0.9 release].

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions