ConfigurationGenerator (Nuxeo ECM Projects 7.10-SNAPSHOT API)

java.lang.Object
- org.nuxeo.launcher.config.ConfigurationGenerator

```
public class ConfigurationGenerator
extends Object
```
Builder for server configuration and datasource files from templates and properties.

Author:

jcarsique

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ADDRESS_PING_TIMEOUT`
`static String`	`BOUNDARY_BEGIN`
`static String`	`BOUNDARY_END`
`static String[]`	`COMPLIANT_JAVA_VERSIONS` Accurate but not used internally.
`protected static String`	`CONFIGURATION_PROPERTIES`
`static List<String>`	`DB_EXCLUDE_CHECK_LIST`
`static List<String>`	`DB_LIST`
`static String`	`DISTRIBUTION_MP_DIR`
`static String`	`INSTALL_AFTER_RESTART`
`boolean`	`isJBoss`
`boolean`	`isJetty`
`boolean`	`isTomcat`
`static int`	`MAX_PORT`
`static int`	`MIN_PORT`
`static String`	`NUXEO_CONF`
`static String`	`NUXEO_DEFAULT_CONF`
`static String`	`NUXEO_DEV_SYSTEM_PROP` Global dev property, duplicated from runtime framework
`static String`	`NUXEO_HOME` Deprecated. Since 5.6, use `Environment#NUXEO_HOME` instead
`static String`	`OLD_PARAM_TEMPLATES_PARSING_EXTENSIONS`
`static String`	`PARAM_BIND_ADDRESS`
`static String`	`PARAM_CONTEXT_PATH`
`static String`	`PARAM_DB_DRIVER`
`static String`	`PARAM_DB_HOST`
`static String`	`PARAM_DB_JDBC_URL`
`static String`	`PARAM_DB_NAME`
`static String`	`PARAM_DB_PORT`
`static String`	`PARAM_DB_PWD`
`static String`	`PARAM_DB_USER`
`static String`	`PARAM_FAKE_WINDOWS`
`static String`	`PARAM_FORCE_GENERATION`
`static String`	`PARAM_HTTP_PORT`
`protected static String`	`PARAM_INCLUDED_TEMPLATES` Absolute or relative PATH to the included templates (comma separated list)
`static String`	`PARAM_LOOPBACK_URL`
`static String`	`PARAM_MP_DIR`
`static String`	`PARAM_NUXEO_URL`
`static String`	`PARAM_PRODUCT_NAME` Deprecated. Since 7.10. Use `Environment#PRODUCT_NAME`
`static String`	`PARAM_PRODUCT_VERSION` Deprecated. Since 7.10. Use `Environment#PRODUCT_VERSION`
`static String`	`PARAM_STATUS_KEY` Deprecated. Since 7.4. Use `Environment#SERVER_STATUS_KEY` instead
`static String`	`PARAM_TEMPLATE_DBNAME`
`static String`	`PARAM_TEMPLATE_DBTYPE`
`static String`	`PARAM_TEMPLATE_NAME` Deprecated. use `PARAM_TEMPLATES_NAME` instead
`static String`	`PARAM_TEMPLATES_FREEMARKER_EXTENSIONS`
`static String`	`PARAM_TEMPLATES_NAME` Absolute or relative PATH to the user chosen templates (comma separated list)
`static String`	`PARAM_TEMPLATES_NODB` Deprecated. since 5.7
`static String`	`PARAM_TEMPLATES_PARSING_EXTENSIONS`
`static String`	`PARAM_WIZARD_DONE`
`static String`	`PARAM_WIZARD_RESTART_PARAMS`
`protected static Map<String,String>`	`parametersMigration`
`static String`	`SEAM_DEBUG_SYSTEM_PROP` Seam hot reload property, also controlled by `NUXEO_DEV_SYSTEM_PROP`
`static String`	`SEAM_HOT_RELOAD_GLOBAL_CONFIG_FILE` Deprecated. since 5.6
`static String`	`TEMPLATE_SEPARATOR`
`static String`	`TEMPLATES`

Constructor Summary

Constructors
Constructor and Description

ConfigurationGenerator()

ConfigurationGenerator(boolean quiet, boolean debug)

Constructors
Constructor and Description
`ConfigurationGenerator()`
`ConfigurationGenerator(boolean quiet, boolean debug)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addTemplate(String templatesToAdd)` Add template(s) to the `PARAM_TEMPLATES_NAME` list if not already present
`void`	`changeDBTemplate(String dbTemplate)` Change templates using given database template
`String`	`changeTemplates(String newTemplates)`
`void`	`checkAddressesAndPorts()` Will check the configured addresses are reachable and Nuxeo required ports are available on those addresses.
`static void`	`checkAddressReachable(InetAddress address)`
`void`	`checkDatabaseConnection(String databaseTemplate, String dbName, String dbUser, String dbPassword, String dbHost, String dbPort)` Check driver availability and database connection
`protected void`	`checkForDeprecatedParameters(Properties properties)` Check for deprecated parameters
`void`	`checkJavaVersion()` Check that the process is executed with a supported Java version.
`void`	`checkLdapConnection(Hashtable<Object,Object> contextEnv)`
`void`	`checkLdapConnection(String ldapUrl, String ldapBindDn, String ldapBindPwd, boolean authenticate)` Check if the LDAP parameters are correct to bind to a LDAP server.
`static void`	`checkPortAvailable(InetAddress address, int port)` Checks if port is available on given address.
`void`	`cleanupPostWizard()` Ensure the wizard won't be started and nuxeo is ready for use
`protected HashMap<String,String>`	`evalDynamicProperties()` Generate properties which values are based on others
`String`	`extractDatabaseTemplateName()` Extract a database template from the current list of templates.
`protected void`	`generateFiles()`
`InetAddress`	`getBindAddress()`
`Map<String,String>`	`getChangedParameters(Map<String,String> changedParameters)` Filters given parameters including them only if (there was no previous value and new value is not empty/null) or (there was a previous value and it differs from the new value)
`File`	`getConfigDir()`
`Hashtable<Object,Object>`	`getContextEnv(String ldapUrl, String bindDn, String bindPassword, boolean checkAuthentication)` Build a `Hashtable` which contains environment properties to instantiate a `InitialDirContext`
`Crypto`	`getCrypto()`
`File`	`getDataDir()`
`File`	`getDistributionMPDir()`
`File`	`getDumpedConfig()`
`Environment`	`getEnv()`
`List<File>`	`getIncludedTemplates()`
`File`	`getInstallFile()`
`File`	`getLogDir()`
`ArrayList<String>`	`getLogFiles()`
`File`	`getNuxeoConf()`
`File`	`getNuxeoDefaultConf()`
`File`	`getNuxeoHome()`
`File`	`getPidDir()`
`File`	`getRuntimeHome()`
`ServerConfigurator`	`getServerConfigurator()`
`protected Properties`	`getStoredConfig()`
`File`	`getTemplateConf(String template)`
`File`	`getTmpDir()`
`CryptoProperties`	`getUserConfig()`
`String`	`getUserTemplates()`
`protected boolean`	`hasSeamDebugFile()` Deprecated. since 5.6
`void`	`hideDeprecationWarnings(boolean hide)`
`protected void`	`includeTemplates()`
`boolean`	`init()` Initialize configurator, check requirements and load current configuration
`boolean`	`init(boolean forceReload)` Initialize configurator, check requirements and load current configuration
`void`	`initLogs()` Delegate logs initialization to serverConfigurator instance
`boolean`	`isConfigurable()`
`boolean`	`isForceGeneration()`
`boolean`	`isInstallInProgress()`
`boolean`	`isWizardRequired()` Check if wizard must and can be ran
`static Properties`	`loadTrimmedProperties(File propsFile)`
`static void`	`loadTrimmedProperties(Properties props, InputStream propsIS)`
`static void`	`main(String[] args)`
`void`	`prepareWizardStart()` Ensure the server will start only wizard application, not Nuxeo
`String`	`rebuildTemplatesStr(String dbTemplate)` Rebuild a templates string for use in nuxeo.conf
`protected void`	`replaceBackslashes()` Read nuxeo.conf, replace backslashes in paths and write new nuxeo.conf
`void`	`rmTemplate(String templatesToRm)` Remove template(s) from the `PARAM_TEMPLATES_NAME` list
`void`	`run()` Runs the configuration files generation.
`void`	`saveConfiguration(Map<String,String> changedParameters)` Save changed parameters in `nuxeo.conf`.
`void`	`saveConfiguration(Map<String,String> changedParameters, boolean setGenerationOnceToFalse, boolean setGenerationFalseToOnce)` Save changed parameters in `nuxeo.conf` calculating templates if changedParameters contains a value for `PARAM_TEMPLATE_DBNAME`.
`void`	`saveFilteredConfiguration(Map<String,String> changedParameters)` Save changed parameters in `nuxeo.conf`, filtering parameters with `getChangedParameters(Map)`
`void`	`setDirectoryWithProperty(String key)`
`void`	`setForceGeneration(boolean forceGeneration)`
`Map<String,String>`	`setProperties(Map<String,String> newParametersToSave)` Set properties in nuxeo configuration
`Map<String,String>`	`setProperties(String template, Map<String,String> newParametersToSave)` Set properties in the given template, if it exists
`String`	`setProperty(String key, String value)` Set a property in nuxeo configuration
`void`	`verifyInstallation()` Create needed directories.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - TEMPLATE_SEPARATOR
```
public static final String TEMPLATE_SEPARATOR
```
    Since:
    
    6.0
    
    See Also:
    
    Constant Field Values
  - COMPLIANT_JAVA_VERSIONS
```
public static final String[] COMPLIANT_JAVA_VERSIONS
```
    Accurate but not used internally. NXP-18023: Java 8 update 40+ required
    
    Since:
    
    5.7
  - CONFIGURATION_PROPERTIES
```
protected static final String CONFIGURATION_PROPERTIES
```
    Since:
    
    5.6
    
    See Also:
    
    Constant Field Values
  - NUXEO_HOME
```
@Deprecated
public static final String NUXEO_HOME
```
    Deprecated. Since 5.6, use Environment#NUXEO_HOME instead
    
    See Also:
    
    Constant Field Values
  - NUXEO_CONF
```
public static final String NUXEO_CONF
```
    See Also:
    
    Constant Field Values
  - TEMPLATES
```
public static final String TEMPLATES
```
    See Also:
    
    Constant Field Values
  - NUXEO_DEFAULT_CONF
```
public static final String NUXEO_DEFAULT_CONF
```
    See Also:
    
    Constant Field Values
  - PARAM_TEMPLATE_NAME
```
@Deprecated
public static final String PARAM_TEMPLATE_NAME
```
    Deprecated. use PARAM_TEMPLATES_NAME instead
    
    Absolute or relative PATH to the user chosen template
    
    See Also:
    
    Constant Field Values
  - PARAM_TEMPLATES_NAME
```
public static final String PARAM_TEMPLATES_NAME
```
    Absolute or relative PATH to the user chosen templates (comma separated list)
    
    See Also:
    
    Constant Field Values
  - PARAM_TEMPLATE_DBNAME
```
public static final String PARAM_TEMPLATE_DBNAME
```
    See Also:
    
    Constant Field Values
  - PARAM_TEMPLATE_DBTYPE
```
public static final String PARAM_TEMPLATE_DBTYPE
```
    See Also:
    
    Constant Field Values
  - PARAM_TEMPLATES_NODB
```
@Deprecated
public static final String PARAM_TEMPLATES_NODB
```
    Deprecated. since 5.7
    
    See Also:
    
    Constant Field Values
  - OLD_PARAM_TEMPLATES_PARSING_EXTENSIONS
```
public static final String OLD_PARAM_TEMPLATES_PARSING_EXTENSIONS
```
    See Also:
    
    Constant Field Values
  - PARAM_TEMPLATES_PARSING_EXTENSIONS
```
public static final String PARAM_TEMPLATES_PARSING_EXTENSIONS
```
    See Also:
    
    Constant Field Values
  - PARAM_TEMPLATES_FREEMARKER_EXTENSIONS
```
public static final String PARAM_TEMPLATES_FREEMARKER_EXTENSIONS
```
    See Also:
    
    Constant Field Values
  - PARAM_INCLUDED_TEMPLATES
```
protected static final String PARAM_INCLUDED_TEMPLATES
```
    Absolute or relative PATH to the included templates (comma separated list)
    
    See Also:
    
    Constant Field Values
  - PARAM_FORCE_GENERATION
```
public static final String PARAM_FORCE_GENERATION
```
    See Also:
    
    Constant Field Values
  - BOUNDARY_BEGIN
```
public static final String BOUNDARY_BEGIN
```
    See Also:
    
    Constant Field Values
  - BOUNDARY_END
```
public static final String BOUNDARY_END
```
    See Also:
    
    Constant Field Values
  - DB_LIST
```
public static final List<String> DB_LIST
```
  - DB_EXCLUDE_CHECK_LIST
```
public static final List<String> DB_EXCLUDE_CHECK_LIST
```
  - PARAM_WIZARD_DONE
```
public static final String PARAM_WIZARD_DONE
```
    See Also:
    
    Constant Field Values
  - PARAM_WIZARD_RESTART_PARAMS
```
public static final String PARAM_WIZARD_RESTART_PARAMS
```
    See Also:
    
    Constant Field Values
  - PARAM_FAKE_WINDOWS
```
public static final String PARAM_FAKE_WINDOWS
```
    See Also:
    
    Constant Field Values
  - PARAM_LOOPBACK_URL
```
public static final String PARAM_LOOPBACK_URL
```
    See Also:
    
    Constant Field Values
  - MIN_PORT
```
public static final int MIN_PORT
```
    See Also:
    
    Constant Field Values
  - MAX_PORT
```
public static final int MAX_PORT
```
    See Also:
    
    Constant Field Values
  - ADDRESS_PING_TIMEOUT
```
public static final int ADDRESS_PING_TIMEOUT
```
    See Also:
    
    Constant Field Values
  - PARAM_BIND_ADDRESS
```
public static final String PARAM_BIND_ADDRESS
```
    See Also:
    
    Constant Field Values
  - PARAM_HTTP_PORT
```
public static final String PARAM_HTTP_PORT
```
    See Also:
    
    Constant Field Values
  - PARAM_STATUS_KEY
```
@Deprecated
public static final String PARAM_STATUS_KEY
```
    Deprecated. Since 7.4. Use Environment#SERVER_STATUS_KEY instead
    
    See Also:
    
    Constant Field Values
  - PARAM_CONTEXT_PATH
```
public static final String PARAM_CONTEXT_PATH
```
    See Also:
    
    Constant Field Values
  - PARAM_MP_DIR
```
public static final String PARAM_MP_DIR
```
    See Also:
    
    Constant Field Values
  - DISTRIBUTION_MP_DIR
```
public static final String DISTRIBUTION_MP_DIR
```
    See Also:
    
    Constant Field Values
  - INSTALL_AFTER_RESTART
```
public static final String INSTALL_AFTER_RESTART
```
    See Also:
    
    Constant Field Values
  - PARAM_DB_DRIVER
```
public static final String PARAM_DB_DRIVER
```
    See Also:
    
    Constant Field Values
  - PARAM_DB_JDBC_URL
```
public static final String PARAM_DB_JDBC_URL
```
    See Also:
    
    Constant Field Values
  - PARAM_DB_HOST
```
public static final String PARAM_DB_HOST
```
    See Also:
    
    Constant Field Values
  - PARAM_DB_PORT
```
public static final String PARAM_DB_PORT
```
    See Also:
    
    Constant Field Values
  - PARAM_DB_NAME
```
public static final String PARAM_DB_NAME
```
    See Also:
    
    Constant Field Values
  - PARAM_DB_USER
```
public static final String PARAM_DB_USER
```
    See Also:
    
    Constant Field Values
  - PARAM_DB_PWD
```
public static final String PARAM_DB_PWD
```
    See Also:
    
    Constant Field Values
  - PARAM_PRODUCT_NAME
```
@Deprecated
public static final String PARAM_PRODUCT_NAME
```
    Deprecated. Since 7.10. Use Environment#PRODUCT_NAME
    
    See Also:
    
    Constant Field Values
  - PARAM_PRODUCT_VERSION
```
@Deprecated
public static final String PARAM_PRODUCT_VERSION
```
    Deprecated. Since 7.10. Use Environment#PRODUCT_VERSION
    
    See Also:
    
    Constant Field Values
  - PARAM_NUXEO_URL
```
public static final String PARAM_NUXEO_URL
```
    Since:
    
    5.6
    
    See Also:
    
    Constant Field Values
  - NUXEO_DEV_SYSTEM_PROP
```
public static final String NUXEO_DEV_SYSTEM_PROP
```
    Global dev property, duplicated from runtime framework
    
    Since:
    
    5.6
    
    See Also:
    
    Constant Field Values
  - SEAM_DEBUG_SYSTEM_PROP
```
public static final String SEAM_DEBUG_SYSTEM_PROP
```
    Seam hot reload property, also controlled by NUXEO_DEV_SYSTEM_PROP
    
    Since:
    
    5.6
    
    See Also:
    
    Constant Field Values
  - SEAM_HOT_RELOAD_GLOBAL_CONFIG_FILE
```
@Deprecated
public static final String SEAM_HOT_RELOAD_GLOBAL_CONFIG_FILE
```
    Deprecated. since 5.6
    
    Old way of detecting if seam debug should be enabled, by looking for the presence of this file. Setting property SEAM_DEBUG_SYSTEM_PROP in nuxeo.conf is enough now.
    
    Since:
    
    5.6
    
    See Also:
    
    Constant Field Values
  - isJBoss
```
public boolean isJBoss
```
  - isJetty
```
public boolean isJetty
```
  - isTomcat
```
public boolean isTomcat
```
  - parametersMigration
```
protected static final Map<String,String> parametersMigration
```
- Constructor Detail
  - ConfigurationGenerator
```
public ConfigurationGenerator()
```
  - ConfigurationGenerator
```
public ConfigurationGenerator(boolean quiet,
                              boolean debug)
```
    Parameters:
    
    quiet - Suppress info level messages from the console output
    
    debug - Activate debug level logging
    
    Since:
    
    5.6
- Method Detail
  - isConfigurable
```
public boolean isConfigurable()
```
  - getStoredConfig
```
protected Properties getStoredConfig()
```
    Since:
    
    5.7
  - hideDeprecationWarnings
```
public void hideDeprecationWarnings(boolean hide)
```
  - setForceGeneration
```
public void setForceGeneration(boolean forceGeneration)
```
    Parameters:
    
    forceGeneration -
    
    See Also:
    
    PARAM_FORCE_GENERATION
  - isForceGeneration
```
public boolean isForceGeneration()
```
    Returns:
    
    true if configuration will be generated from templates
    
    Since:
    
    5.4.2
    
    See Also:
    
    PARAM_FORCE_GENERATION
  - getUserConfig
```
public CryptoProperties getUserConfig()
```
  - getServerConfigurator
```
public final ServerConfigurator getServerConfigurator()
```
    Since:
    
    5.4.2
  - run
```
public void run()
         throws ConfigurationException
```
    Runs the configuration files generation.
    
    Throws:
    
    ConfigurationException
  - init
```
public boolean init()
```
    Initialize configurator, check requirements and load current configuration
    
    Returns:
    
    returns true if current install is configurable, else returns false
  - init
```
public boolean init(boolean forceReload)
```
    Initialize configurator, check requirements and load current configuration
    
    Parameters:
    
    forceReload - If true, forces configuration reload.
    
    Returns:
    
    returns true if current install is configurable, else returns false
    
    Since:
    
    5.6
  - changeTemplates
```
public String changeTemplates(String newTemplates)
```
    Parameters:
    
    newTemplates -
    
    Returns:
    
    Old templates
  - changeDBTemplate
```
public void changeDBTemplate(String dbTemplate)
```
    Change templates using given database template
    
    Parameters:
    
    dbTemplate - new database template
    
    Since:
    
    5.4.2
  - includeTemplates
```
protected void includeTemplates()
                         throws IOException
```
    Throws:
    
    IOException
    
    Since:
    
    5.7
  - hasSeamDebugFile
```
@Deprecated
protected boolean hasSeamDebugFile()
```
    Deprecated. since 5.6
    
    Old way of detecting if seam debug is set, by checking for the presence of a file.
    On 5.6, using the config generator to get the info from the nuxeo.conf file makes it possible to get the property value this early, so adding an empty file at SEAM_HOT_RELOAD_GLOBAL_CONFIG_FILE is no longer needed.
  - evalDynamicProperties
```
protected HashMap<String,String> evalDynamicProperties()
                                                throws ConfigurationException
```
    Generate properties which values are based on others
    
    Returns:
    
    Map with new parameters to save in nuxeoConf
    
    Throws:
    
    ConfigurationException
    
    Since:
    
    5.5
  - replaceBackslashes
```
protected void replaceBackslashes()
                           throws ConfigurationException
```
    Read nuxeo.conf, replace backslashes in paths and write new nuxeo.conf
    
    Throws:
    
    ConfigurationException - if any error reading or writing nuxeo.conf
    
    Since:
    
    5.4.1
  - setDirectoryWithProperty
```
public void setDirectoryWithProperty(String key)
```
    Parameters:
    
    key - Directory system key
    
    Since:
    
    5.4.2
    
    See Also:
    
    Environment
  - getUserTemplates
```
public String getUserTemplates()
```
  - generateFiles
```
protected void generateFiles()
                      throws ConfigurationException
```
    Throws:
    
    ConfigurationException
  - checkForDeprecatedParameters
```
protected void checkForDeprecatedParameters(Properties properties)
```
    Check for deprecated parameters
    
    Parameters:
    
    properties -
    
    Since:
    
    5.6
  - getNuxeoHome
```
public File getNuxeoHome()
```
  - getNuxeoDefaultConf
```
public File getNuxeoDefaultConf()
```
  - getIncludedTemplates
```
public List<File> getIncludedTemplates()
```
  - main
```
public static void main(String[] args)
                 throws ConfigurationException
```
    Throws:
    
    ConfigurationException
  - saveConfiguration
```
public void saveConfiguration(Map<String,String> changedParameters)
                       throws ConfigurationException
```
    Save changed parameters in nuxeo.conf. This method does not check values in map. Use saveFilteredConfiguration(Map) for parameters filtering.
    
    Parameters:
    
    changedParameters - Map of modified parameters
    
    Throws:
    
    ConfigurationException
    
    See Also:
    
    saveFilteredConfiguration(Map)
  - saveConfiguration
```
public void saveConfiguration(Map<String,String> changedParameters,
                              boolean setGenerationOnceToFalse,
                              boolean setGenerationFalseToOnce)
                       throws ConfigurationException
```
    Save changed parameters in nuxeo.conf calculating templates if changedParameters contains a value for PARAM_TEMPLATE_DBNAME. If a parameter value is empty ("" or null), then the property is unset. PARAM_WIZARD_DONE, PARAM_TEMPLATES_NAME and PARAM_FORCE_GENERATION cannot be unset, but their value can be changed.
    This method does not check values in map: use saveFilteredConfiguration(Map) for parameters filtering.
    
    Parameters:
    
    changedParameters - Map of modified parameters
    
    setGenerationOnceToFalse - If generation was on (true or once), then set it to false or not?
    
    setGenerationFalseToOnce - If generation was off (false), then set it to once?
    
    Throws:
    
    ConfigurationException
    
    Since:
    
    5.5
    
    See Also:
    
    saveFilteredConfiguration(Map)
  - saveFilteredConfiguration
```
public void saveFilteredConfiguration(Map<String,String> changedParameters)
                               throws ConfigurationException
```
    Save changed parameters in nuxeo.conf, filtering parameters with getChangedParameters(Map)
    
    Parameters:
    
    changedParameters - Maps of modified parameters
    
    Throws:
    
    ConfigurationException
    
    Since:
    
    5.4.2
    
    See Also:
    
    saveConfiguration(Map), getChangedParameters(Map)
  - getChangedParameters
```
public Map<String,String> getChangedParameters(Map<String,String> changedParameters)
```
    Filters given parameters including them only if (there was no previous value and new value is not empty/null) or (there was a previous value and it differs from the new value)
    
    Parameters:
    
    changedParameters - parameters to be filtered
    
    Returns:
    
    filtered map
    
    Since:
    
    5.4.2
  - extractDatabaseTemplateName
```
public String extractDatabaseTemplateName()
```
    Extract a database template from the current list of templates. Return the last one if there are multiples.
    
    See Also:
    
    rebuildTemplatesStr(String)
  - getNuxeoConf
```
public File getNuxeoConf()
```
    Returns:
    
    nuxeo.conf file used
  - initLogs
```
public void initLogs()
```
    Delegate logs initialization to serverConfigurator instance
    
    Since:
    
    5.4.2
  - getLogDir
```
public File getLogDir()
```
    Returns:
    
    log directory
    
    Since:
    
    5.4.2
  - getPidDir
```
public File getPidDir()
```
    Returns:
    
    pid directory
    
    Since:
    
    5.4.2
  - getDataDir
```
public File getDataDir()
```
    Returns:
    
    Data directory
    
    Since:
    
    5.4.2
  - verifyInstallation
```
public void verifyInstallation()
                        throws ConfigurationException
```
    Create needed directories. Check existence of old paths. If old paths have been found and they cannot be upgraded automatically, then upgrading message is logged and error thrown.
    
    Throws:
    
    ConfigurationException - If a deprecated directory has been detected.
    
    Since:
    
    5.4.2
    
    See Also:
    
    ServerConfigurator.verifyInstallation()
  - checkJavaVersion
```
public void checkJavaVersion()
                      throws ConfigurationException
```
    Check that the process is executed with a supported Java version. See J2SE SDK/JRE Version String Naming Convention
    
    Throws:
    
    ConfigurationException
    
    Since:
    
    5.6
  - checkAddressesAndPorts
```
public void checkAddressesAndPorts()
                            throws ConfigurationException
```
    Will check the configured addresses are reachable and Nuxeo required ports are available on those addresses. Server specific implementations should override this method in order to check for server specific ports. PARAM_BIND_ADDRESS must be set before.
    
    Throws:
    
    ConfigurationException
    
    Since:
    
    5.5
    
    See Also:
    
    ServerConfigurator.verifyInstallation()
  - getBindAddress
```
public InetAddress getBindAddress()
                           throws ConfigurationException
```
    Throws:
    
    ConfigurationException
  - checkAddressReachable
```
public static void checkAddressReachable(InetAddress address)
                                  throws ConfigurationException
```
    Parameters:
    
    address - address to check for availability
    
    Throws:
    
    ConfigurationException
    
    Since:
    
    5.5
  - checkPortAvailable
```
public static void checkPortAvailable(InetAddress address,
                                      int port)
                               throws ConfigurationException
```
    Checks if port is available on given address.
    
    Parameters:
    
    port - port to check for availability
    
    Throws:
    
    ConfigurationException - Throws an exception if address is unavailable.
    
    Since:
    
    5.5
  - getTmpDir
```
public File getTmpDir()
```
    Returns:
    
    Temporary directory
  - getLogFiles
```
public ArrayList<String> getLogFiles()
```
    Returns:
    
    Log files produced by Log4J configuration without loading this configuration instead of current active one.
    
    Since:
    
    5.4.2
  - isWizardRequired
```
public boolean isWizardRequired()
```
    Check if wizard must and can be ran
    
    Returns:
    
    true if configuration wizard is required before starting Nuxeo
    
    Since:
    
    5.4.2
  - rebuildTemplatesStr
```
public String rebuildTemplatesStr(String dbTemplate)
```
    Rebuild a templates string for use in nuxeo.conf
    
    Parameters:
    
    dbTemplate - database template to use instead of current one
    
    Returns:
    
    new templates string using given dbTemplate
    
    Since:
    
    5.4.2
    
    See Also:
    
    extractDatabaseTemplateName(), changeDBTemplate(String), changeTemplates(String)
  - getConfigDir
```
public File getConfigDir()
```
    Returns:
    
    Nuxeo config directory
    
    Since:
    
    5.4.2
  - prepareWizardStart
```
public void prepareWizardStart()
```
    Ensure the server will start only wizard application, not Nuxeo
    
    Since:
    
    5.4.2
  - cleanupPostWizard
```
public void cleanupPostWizard()
```
    Ensure the wizard won't be started and nuxeo is ready for use
    
    Since:
    
    5.4.2
  - getRuntimeHome
```
public File getRuntimeHome()
```
    Returns:
    
    Nuxeo runtime home
  - isInstallInProgress
```
public boolean isInstallInProgress()
```
    Returns:
    
    true if there's an install in progress
    
    Since:
    
    5.4.2
  - getDistributionMPDir
```
public File getDistributionMPDir()
```
    Returns:
    
    File pointing to the directory containing the marketplace packages included in the distribution
    
    Since:
    
    5.6
  - getInstallFile
```
public File getInstallFile()
```
    Returns:
    
    Install/upgrade file
    
    Since:
    
    5.4.1
  - addTemplate
```
public void addTemplate(String templatesToAdd)
                 throws ConfigurationException
```
    Add template(s) to the PARAM_TEMPLATES_NAME list if not already present
    
    Parameters:
    
    templatesToAdd - Comma separated templates to add
    
    Throws:
    
    ConfigurationException
    
    Since:
    
    5.5
  - rmTemplate
```
public void rmTemplate(String templatesToRm)
                throws ConfigurationException
```
    Remove template(s) from the PARAM_TEMPLATES_NAME list
    
    Parameters:
    
    templatesToRm - Comma separated templates to remove
    
    Throws:
    
    ConfigurationException
    
    Since:
    
    5.5
  - setProperty
```
public String setProperty(String key,
                          String value)
                   throws ConfigurationException
```
    Set a property in nuxeo configuration
    
    Parameters:
    
    key -
    
    value -
    
    Returns:
    
    The old value
    
    Throws:
    
    ConfigurationException
    
    Since:
    
    5.5
  - setProperties
```
public Map<String,String> setProperties(Map<String,String> newParametersToSave)
                                 throws ConfigurationException
```
    Set properties in nuxeo configuration
    
    Parameters:
    
    newParametersToSave -
    
    Returns:
    
    The old values
    
    Throws:
    
    ConfigurationException
    
    Since:
    
    7.4
  - setProperties
```
public Map<String,String> setProperties(String template,
                                        Map<String,String> newParametersToSave)
                                 throws ConfigurationException,
                                        IOException
```
    Set properties in the given template, if it exists
    
    Parameters:
    
    newParametersToSave -
    
    Returns:
    
    The old values
    
    Throws:
    
    ConfigurationException
    
    IOException
    
    Since:
    
    7.4
  - checkDatabaseConnection
```
public void checkDatabaseConnection(String databaseTemplate,
                                    String dbName,
                                    String dbUser,
                                    String dbPassword,
                                    String dbHost,
                                    String dbPort)
                             throws FileNotFoundException,
                                    IOException,
                                    DatabaseDriverException,
                                    SQLException
```
    Check driver availability and database connection
    
    Parameters:
    
    databaseTemplate - Nuxeo database template
    
    dbName - nuxeo.db.name parameter in nuxeo.conf
    
    dbUser - nuxeo.db.user parameter in nuxeo.conf
    
    dbPassword - nuxeo.db.password parameter in nuxeo.conf
    
    dbHost - nuxeo.db.host parameter in nuxeo.conf
    
    dbPort - nuxeo.db.port parameter in nuxeo.conf
    
    Throws:
    
    DatabaseDriverException
    
    IOException
    
    FileNotFoundException
    
    SQLException
    
    Since:
    
    5.6
  - getEnv
```
public Environment getEnv()
```
    Returns:
    
    an Environment initialized with a few basics
    
    Since:
    
    5.6
  - loadTrimmedProperties
```
public static Properties loadTrimmedProperties(File propsFile)
                                        throws IOException
```
    Parameters:
    
    propsFile - Properties file
    
    Returns:
    
    new Properties containing trimmed keys and values read in propsFile
    
    Throws:
    
    IOException
    
    Since:
    
    5.6
  - loadTrimmedProperties
```
public static void loadTrimmedProperties(Properties props,
                                         InputStream propsIS)
                                  throws IOException
```
    Parameters:
    
    props - Properties object to be filled
    
    propsIS - Properties InputStream
    
    Throws:
    
    IOException
    
    Since:
    
    5.6
  - getDumpedConfig
```
public File getDumpedConfig()
```
    Returns:
    
    The generated properties file with dumped configuration.
    
    Since:
    
    5.6
  - getContextEnv
```
public Hashtable<Object,Object> getContextEnv(String ldapUrl,
                                              String bindDn,
                                              String bindPassword,
                                              boolean checkAuthentication)
```
    Build a Hashtable which contains environment properties to instantiate a InitialDirContext
    
    Since:
    
    6.0
  - checkLdapConnection
```
public void checkLdapConnection(String ldapUrl,
                                String ldapBindDn,
                                String ldapBindPwd,
                                boolean authenticate)
                         throws NamingException
```
    Check if the LDAP parameters are correct to bind to a LDAP server. if authenticate argument is true, it will also check if the authentication against the LDAP server succeeds
    
    Parameters:
    
    ldapUrl -
    
    ldapBindDn -
    
    ldapBindPwd -
    
    authenticate - Indicates if authentication against LDAP should be checked.
    
    Throws:
    
    NamingException
    
    Since:
    
    6.0
  - checkLdapConnection
```
public void checkLdapConnection(Hashtable<Object,Object> contextEnv)
                         throws NamingException
```
    Parameters:
    
    contextEnv - Environment properties to build a InitialDirContext
    
    Throws:
    
    NamingException
    
    Since:
    
    6.0
  - getCrypto
```
public Crypto getCrypto()
```
    Returns:
    
    a Crypto instance initialized with the configuration parameters
    
    Since:
    
    7.4
    
    See Also:
    
    Crypto
  - getTemplateConf
```
public File getTemplateConf(String template)
                     throws ConfigurationException
```
    Parameters:
    
    template - path to configuration template directory
    
    Returns:
    
    A nuxeo.defaults file if it exists.
    
    Throws:
    
    ConfigurationException - if the template file is not found.
    
    Since:
    
    7.4

Class ConfigurationGenerator

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

TEMPLATE_SEPARATOR

COMPLIANT_JAVA_VERSIONS

CONFIGURATION_PROPERTIES

NUXEO_HOME

NUXEO_CONF

TEMPLATES

NUXEO_DEFAULT_CONF

PARAM_TEMPLATE_NAME

PARAM_TEMPLATES_NAME

PARAM_TEMPLATE_DBNAME

PARAM_TEMPLATE_DBTYPE

PARAM_TEMPLATES_NODB

OLD_PARAM_TEMPLATES_PARSING_EXTENSIONS

PARAM_TEMPLATES_PARSING_EXTENSIONS

PARAM_TEMPLATES_FREEMARKER_EXTENSIONS

PARAM_INCLUDED_TEMPLATES

PARAM_FORCE_GENERATION

BOUNDARY_BEGIN

BOUNDARY_END

DB_LIST

DB_EXCLUDE_CHECK_LIST

PARAM_WIZARD_DONE

PARAM_WIZARD_RESTART_PARAMS

PARAM_FAKE_WINDOWS

PARAM_LOOPBACK_URL

MIN_PORT

MAX_PORT

ADDRESS_PING_TIMEOUT

PARAM_BIND_ADDRESS

PARAM_HTTP_PORT

PARAM_STATUS_KEY

PARAM_CONTEXT_PATH

PARAM_MP_DIR

DISTRIBUTION_MP_DIR

INSTALL_AFTER_RESTART

PARAM_DB_DRIVER

PARAM_DB_JDBC_URL

PARAM_DB_HOST

PARAM_DB_PORT

PARAM_DB_NAME

PARAM_DB_USER

PARAM_DB_PWD

PARAM_PRODUCT_NAME

PARAM_PRODUCT_VERSION

PARAM_NUXEO_URL

NUXEO_DEV_SYSTEM_PROP

SEAM_DEBUG_SYSTEM_PROP

SEAM_HOT_RELOAD_GLOBAL_CONFIG_FILE

isJBoss

isJetty

isTomcat

parametersMigration

Constructor Detail

ConfigurationGenerator

ConfigurationGenerator

Method Detail

isConfigurable

getStoredConfig

hideDeprecationWarnings

setForceGeneration

isForceGeneration

getUserConfig

getServerConfigurator

run

init

init

changeTemplates

changeDBTemplate

includeTemplates

hasSeamDebugFile

evalDynamicProperties

replaceBackslashes

setDirectoryWithProperty

getUserTemplates