This is an old revision of the document!


Storage System

Storage system configuration (except online backup) is managed in a special configuration file. This file is not created automatically while installing or starting Wialon, so default parameters are taken. If any corrections of storage system parameters are required, it is recommended to redefine only those variables which should be altered.

The path to the file: custom/storage.cfg

Here is an example of a configuration file with default parameters and their description:

########### storage service

##### one-time initialization variables

# number of initialization threads
service.initthreads = 4

##### life-time updateable variables

# number of days to keep objects in trash
service.trash.period = 30

########### props/objects db

##### one-time initialization variables

# cache size in MB, must be power of two
props.cache.size = 16
# number of cache chunks
props.cache.chunks = 1
# max number of locks and locks objects allowed
props.cache.maxlocks = 10000
# log buffer size, in MB
props.cache.logbsize = 2

##### life-time updateable variables

# maximum number of logs to force checkpoint/backup
props.checkpoint.maxlogs = 20
# checkpoint interval in minutes
props.checkpoint.interval = 60

# minimum number of total pages to start properties environment trickle
props.trickle.mintotalpages = 100
# minimum number of dirty pages to start properties environment  trickle
props.trickle.mindirtypages = 12500
# minimum rate of clean pages (percentage) to start properties environment  trickle
props.trickle.mincleanrate = 70
# default interval in minutes between properties environment  trickle
props.trickle.interval = 10
# percentage of pages to trickle during properties environment trickle, should be between mincleanrate and 100
props.trickle.rate = 100

########### messages db

##### one-time initialization variables

# cache size in MB, must be power of two
msgs.cache.size = 64
# number of cache chunks
msgs.cache.chunks = 1
# max number of locks and locks objects allowed, min 15000
msgs.cache.maxlocks = 20000
# max number of lockers
msgs.cache.maxlockers = 2000
# log buffer size, in MB
msgs.cache.logbsize = 2

##### life-time updateable variables

# defragmentation interval, in days
msgs.defrag.interval = 1
# defragmentation hour, -1 if not important
msgs.defrag.hour = -1
# force messages defragmentation immediatelly
msgs.defrag.force = 0

# maximum number of messages in one part (v1), in millions
msgs.part.maxmsgs = 20
# minimum number of messages in one part (v1), in millions
msgs.part.minmsgs = 1
# max fragmentation level of part to skip its defragmentation
msgs.part.maxfragrate = 20
# maximum number of messages in one part (v2), in millions
msgs.part.maxmsgs2 = 20

# maximum number of logs to force checkpoint/backup
msgs.checkpoint.maxlogs = 30
# checkpoint interval in minutes
msgs.checkpoint.interval = 10
# do we need to sync environment after checkpoint: 0 - none, 1 - trickle, 2 - full-sync
msgs.checkpoint.sync = 0
# if msgs.checkpoint.sync = 1, then this defines trickle percentage
msgs.checkpoint.tricklerate = 100

# do we need to sync environment during application termination: 0 - none, 1 - trickle, 2 - full-sync
msgs.terminate.sync = 1

# minimum number of total pages to start messages environment trickle
msgs.trickle.mintotalpages = 100
# minimum number of dirty pages to start messages environment  trickle
msgs.trickle.mindirtypages = 1500
# minimum rate of clean pages (percentage) to start messages environment  trickle
msgs.trickle.mincleanrate = 70
# default interval in minutes between messages environment  trickle
msgs.trickle.interval = 10
# percentage of pages to trickle during messages environment trickle, should be between mincleanrate and 100
msgs.trickle.rate = 100

# sync server URI, in format: IP:PORT
msgs.sync.uri = 

It is strongly recommended to keep default values of these parameters.

Values in sections “life-time updateable variables” can be changed while Wialon is working. The configuration file will be reloaded automatically and new values will be applied.

Was this helpful?
Thank you!