Skip to content

Commit

Permalink
Adding TS persistence content (#1105)
Browse files Browse the repository at this point in the history
also fixing a formatting issue in the Shutting Down a Hazelcast Cluster content.
  • Loading branch information
Serdaro authored May 17, 2024
1 parent 8c15a44 commit 8a0ccd1
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 3 deletions.
2 changes: 1 addition & 1 deletion docs/modules/maintain-cluster/pages/shutdown.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ bin/hz-cluster-admin -a <address> -c <cluster-name> -o shutdown
REST API::
+
--
include::clients:partial$rest-deprecation.adoc[]
CAUTION: The REST API has been deprecated and will be removed as of Hazelcast version 7.0. An improved version of this feature is under development.
NOTE: To use the REST API to shut down a cluster, you must first xref:clients:rest.adoc[enable it].
Expand Down
8 changes: 6 additions & 2 deletions docs/modules/tiered-storage/pages/overview.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,12 @@ This means that, if an entry is on the disk, it is relocated to the memory insid
As more and more entries are relocated to the in-memory region of the HybridLog, the memory space occupied by the unreachable entries on disk is reclaimed.
This reclamation is done by a compactor running synchronously with IMap operations on the same partition.

After a cluster restart, Tiered Storage ensures seamless restoration of data within
the configured maps from files stored on the designated device.
This data restoration requires graceful shutdowns using the `HazelcastInstance.shutdown()` method, while the cluster is in the `PASSIVE` state;
see xref:maintain-cluster:shutdown.adoc#graceful-shutdown[Graceful Shutdown] and xref:maintain-cluster:cluster-member-states.adoc#cluster-states[Cluster States].
Failure to do so may lead to restart failures. The maps backed by Tiered Storage maintain consistent state synchronization, seamlessly restoring data from files upon restart.

== Supported Devices

Hazelcast supports only non-volatile memory express (NVMe) local SSD devices for Tiered Storage.
Expand All @@ -47,8 +53,6 @@ While HDDs and some network storage options work with the same file abstraction

- Tiered Storage currently only supports Hazelcast IMap data structure.

- Data recovery from persisted data is not supported. When a Hazelcast member has Tiered Storage enabled and it fails or shuts down, you cannot use the local Tiered Storage device files for data recovery.

- Time-to-live (TTL) expiration is not supported by maps backed by Tiered Storage.
This means that methods, such as `IMap.put`, throw `UnsupportedOperationException` if a TTL value is provided.
If the default TTL setting is present in the map configuration, `InvalidConfigurationException` is thrown during the member startup.
Expand Down

0 comments on commit 8a0ccd1

Please sign in to comment.