File-Based Configuration

File-based configuration should be used if Iotellect Server fails to start and other configuration methods are not available. The default configuration file is server.xml. An alternative filename can be specified using the  -f <filename> command line option.

It is important to note that Iotellect Server not only loads configuration file at startup, but also saves its settings during shutdown. Manual changes made in the file while Iotellect Server is running will be overwritten.

Only a few Iotellect Server global configuration properties are stored in the configuration file. These are mostly the properties used before database connection is established.

Documentation of global properties stored in the configuration file explicitly mentions that. Values of all other global properties are stored in the server database.

The configuration file is an XML (eXtensible Markup Language) format. Here is an excerpt:

<config>
<firstLaunch>false</firstLaunch>
<previousVersion>31001</previousVersion>
<locale>ru</locale>
<usersSelfRegistration>true</usersSelfRegistration>
<configGuiMode>auto</configGuiMode>
<netAdminPort>6440</netAdminPort>
<netAdminEnabled>true</netAdminEnabled>
<databaseDriver>org.apache.derby.jdbc.EmbeddedDriver</databaseDriver>
<databaseUrl>jdbc:derby:database;create=true</databaseUrl>
...
</config>

The file is generated automatically by Iotellect Server, and there's no need to manually add options to it.  When troubleshooting, you might have to change the value of some settings.

You can find a detailed description of available settings under Global configuration.

Was this page helpful?