Configuration

BDBDatastore has a number of ‘knobs’ you can tune for your specific environment. These are stored in the file “datastore.properties”, in the datastore directory you provide on the command line. Entries are one per line, in a straightforward “key = value” format. Lines starting with # or ! are treated as comments. Currently, the following settings are available:

• datastore.sequence.cache_size – int – the number of sequence IDs to cache for each type and parent. Larger numbers require less frequent disk activity, but waste more of the permissible range of the sequence. Default: 20.
• datastore.max_index_entries – int – the maximum number of composite index entries a single entity can create. An entity that would create more than this will end up only partially indexed. Default: 1000.
• datastore.max_pb_size – int – maximum size, in bytes, of a datastore RPC request. Requests over this size will be ignored. Default: 1MB (1048576).
• datastore.port – int – TCP port to listen for requests on. Default: 9123.

In addition, BDBDatastore’s logging can be configured with a custom logging.properties file in the classpath (see the Java logging API documentation for more details), and certain settings of the underling BDB datastore can be configured with a je.properties file in the individual app’s datastore directory (see here for more details).