
configure
Configure Portable Data eXchange for all the cache(s) in the cluster.
configure pdx
Configures Geode’s Portable Data eXchange for all the cache(s) in the cluster. This command does not effect on the running members in the system. This command persists the pdx configuration in the locator with cluster configuration service.
Note: This command should be issued before starting any data members.
Availability: Online.
Syntax:
configure pdx [--read-serialized=value] [--ignore-unread-fields=value]
[--disk-store=value] [--auto-serializable-classes=value(,value)*]
[--portable-auto-serializable-classes=value(,value)*
Name | Description | Default |
---|---|---|
--read-serialized | Set to true to have PDX deserialization produce a PdxInstance instead of an instance of the domain class. | false |
--ignore-unread-fields | Controls whether PDX ignores fields that were unread during deserialization. The default is to preserve unread fields be including their data during serialization. However, if you configure the cache to ignore unread fields then their data will be lost during serialization.You should only set this attribute to true if you know this member will only be reading cache data. In this use case you do not need to pay the cost of preserving the unread fields since you will never be reserializing PDX data. | false |
--disk-store | Named disk store where the PDX type data will be stored. | none |
--auto-serializable-classes | Configures ReflectionBasedAutoSerializer as the PDX serializer for member classes. The patterns that are matched against domain class names to determine whether they should be auto-serialized. Classes are not checked for portability to non-java languages (equivalent to check-portability=false ). |
none |
--portable-auto-serializable-classes | Configures ReflectionBasedAutoSerializer as the PDX serializer for member classes. The patterns that are matched against domain class names to determine whether they should be serialized. Serialization done by the PDX autoserializer will throw an exception if the object of these classes are not portable to non-Java languages (equivalent to check-portability=true ). |
none |
Table 1. Configure PDX Parameters
Example Commands:
gfsh>configure pdx --read-serialized=true
Sample Output:
gfsh>configure pdx --read-serialized=true
persistent = false
read-serialized = true
ignore-unread-fields = false
gfsh>configure pdx --disk-store=/home/username/server4/DEFAULT.drf
persistent = true
disk-store = /home/username/server4/DEFAULT.drf
read-serialized = false
ignore-unread-fields = false
Error Messages:
"Failed to persist the configuration changes due to this command, Revert the command to maintain consistency.
Please use "status cluster-config-service" to determing whether Cluster configuration service is RUNNING."