FlotsamCache.ini.example 3.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. [AssetCache]
  2. ;;
  3. ;; Options for FlotsamAssetCache
  4. ;;
  5. ; cache directory can be shared by multiple instances
  6. CacheDirectory = ./assetcache
  7. ; Other examples:
  8. ;CacheDirectory = /directory/writable/by/OpenSim/instance
  9. ; Log level
  10. ; 0 - (Error) Errors only
  11. ; 1 - (Info) Hit Rate Stats + Level 0
  12. ; 2 - (Debug) Cache Activity (Reads/Writes) + Level 1
  13. ;
  14. LogLevel = 0
  15. ; How often should hit rates be displayed (given in AssetRequests)
  16. ; 0 to disable
  17. HitRateDisplay = 100
  18. ; Set to false for no memory cache
  19. ; assets can be requested several times in short periods
  20. ; so even a small memory cache is useful
  21. MemoryCacheEnabled = false
  22. ; If a memory cache hit happens, or the asset is still in memory
  23. ; due to other causes, update the timestamp on the disk file anyway.
  24. ; Don't turn this on unless you share your asset cache between simulators
  25. ; AND use an external process, e.g. cron job, to clean it up.
  26. UpdateFileTimeOnCacheHit = false
  27. ; Enabling this will cache negative fetches. If an asset is negative-cached
  28. ; it will not be re-requested from the asset server again for a while.
  29. ; Generally, this is a good thing.
  30. ;
  31. ; Regular expiration settings (non-sliding) mean that the asset will be
  32. ; retried after the time has expired. Sliding expiration means that
  33. ; the time the negative cache will keep the asset is refreshed each
  34. ; time a fetch is attempted. Use sliding expiration if you have rogue
  35. ; scripts hammering the asset server with requests for nonexistent
  36. ; assets.
  37. ;
  38. ; There are two cases where negative caching may cause issues:
  39. ;
  40. ; 1 - If an invalid asset is repeatedly requested by a script and that asset is
  41. ; subsequently created, it will not be seen until fcache clear
  42. ; is used. This is a very theoretical scenario since UUID collisions
  43. ; are deemed to be not occuring in practice.
  44. ; This can only become an issue with sliding expiration time.
  45. ;
  46. ; 2 - If the asset service is clustered, an asset may not have propagated
  47. ; to all cluster members when it is first attempted to fetch it.
  48. ; This may theoretically occur with networked vendor systems and
  49. ; would lead to an asset not found message. However, after the
  50. ; expiration time has elapsed, the asset will then be fetchable.
  51. ;
  52. ; The defaults below are suitable for all small to medium installations
  53. ; including grids.
  54. NegativeCacheEnabled = true
  55. NegativeCacheTimeout = 120
  56. NegativeCacheSliding = false
  57. ; Set to false for no file cache
  58. FileCacheEnabled = true
  59. ; How long {in hours} to keep assets cached in memory, .5 == 30 minutes
  60. ; even a few minutes may mean many assets loaded to memory, if not all.
  61. ; this is good if memory is not a problem.
  62. ; if memory is a problem then a few seconds may actually save same.
  63. ; see hit rates with console comand: fcache status
  64. MemoryCacheTimeout = .016 ; one minute
  65. ; How long {in hours} to keep assets cached on disk, .5 == 30 minutes
  66. ; Specify 0 if you do not want your disk cache to expire
  67. FileCacheTimeout = 48
  68. ; How often {in hours} should the disk be checked for expired files
  69. ; Specify 0 to disable expiration checking
  70. FileCleanupTimer = 0.0 ; disabled
  71. ; If WAIT_ON_INPROGRESS_REQUESTS has been defined then this specifies how
  72. ; long (in miliseconds) to block a request thread while trying to complete
  73. ; an existing write to disk.
  74. ; NOTE: THIS PARAMETER IS NOT CURRENTLY USED BY THE CACHE
  75. ; WaitOnInprogressTimeout = 3000
  76. ; Number of tiers to use for cache directories (current valid
  77. ; range 1 to 3)
  78. ;CacheDirectoryTiers = 1
  79. ; Number of letters per path tier, 1 will create 16 directories
  80. ; per tier, 2 - 256, 3 - 4096 and 4 - 65K
  81. ;CacheDirectoryTierLength = 3
  82. ; Warning level for cache directory size
  83. ;CacheWarnAt = 30000