configuration.rst 2.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
  1. .. _community_jdbcconfig_config:
  2. JDBCConfig configuration
  3. ========================
  4. The JDBCConfig module is configured in the file ``jdbcconfig/jdbcconfig.properties`` inside the :ref:`datadir`.
  5. The following properties may be set:
  6. - ``enabled``: Use JDBCConfig. Turn off to use the data directory for all configuration instead.
  7. - ``initdb``: Initialize an empty database if this is set on true.
  8. - ``import`` : The import configuration option tells GeoServer whether to import the current catalog from the file system to the database or not. If set to true, it will be imported and the config option will be set the value 'false' for the next start up to avoid trying to re-import the catalog configuration.
  9. - ``repopulate``: The repopulate configuration option tells GeoServer to repopulate the queryable field values in the database. These are the fields of catalog objects jdbcconfig can query via the database, i.e. much faster than via post-filtering in memory. May be necessary after jdbcconfig upgrades or if someone manually adds queryable fields to the database. (In such cases, if the values were not properly repopulated, queries might give incorrect results.)
  10. - ``initScript``: Path to initialisation script .sql file. Only used if initdb = true.
  11. JNDI
  12. ~~~~
  13. Get the database connection from the application server via JNDI lookup.
  14. - ``jndiName``: The JNDI name for the data source. Only set this if you want to use JNDI, the JDBC configuration properties may still be set for in case the JNDI Lookup fails.
  15. Direct JDBC Connection
  16. ~~~~~~~~~~~~~~~~~~~~~~
  17. Provide the connection parameters directly in the configuration file. This includes the password in the clear which is a potential security risk. To avoid this use JNDI instead.
  18. - ``jdbcUrl``: JDBC direct connection parameters.
  19. - ``username``: JDBC connection username.
  20. - ``password``: JDBC connection password.
  21. - ``pool.minIdle``: minimum connections in pool
  22. - ``pool.maxActive``: maximum connections in pool
  23. - ``pool.poolPreparedStatements``: whether to pool prepared statements
  24. - ``pool.maxOpenPreparedStatements``: size of prepared statement cache, only used if ``pool.poolPreparedStatements`` is true
  25. - ``pool.testOnBorrow``: whether to validate connections when obtaining from the pool
  26. - ``pool.validationQuery``: validation query for connections from pool, must be set when ``pool.testOnBorrow`` is true
  27. - ``pool.testWhileIdle``: whether to validate idle connections, used in conjunction with the idle timer below
  28. - ``pool.setTimeBetweenEvictionRunsMillis``: period in millseconds for the idle object evictor, -1 to disable