Availability of the settings file is checked on starting a BI server or security server. The system searches for this file in the following folders:
For Windows OS: %PROGRAMDATA%\Foresight\Foresight Analytics Platform.
For Linux OS (the file must be named settings.xml)):
On starting BI server at Apache2 web server. It is necessary to check if the HOME variable is determined in user environment variables used for starting Apache2. The user, under whom Apache2 is started, must have access to the directory specified in HOME. If the HOME variable is not specified, presence of the settings.xml file is checked in the /root/.config/Foresight/Foresight Analytics Platform folder. If the HOME variable is specified, file presence is checked in the $HOME/.config/Foresight/Foresight Analytics Platform folder.
NOTE. On setting up the security server the settings file must be located in the security server folder.
Settings stored in the file are identical to those stored in the registry. The file stores these settings as an XML structure, where nodes' names correspond to the names of registry subsections, and attribute values correspond to parameter values.
Example of a settings file: settings_xml.zip.
All settings are specified within separate nodes <Key ...></Key>, which, in turn, are child nodes for the nodes <Configuration><Root>...</Root></Configuration>.
<Configuration>
<Root>
<Key ...>
</Key>
<Key ...>
</Key>
</Root>
</Configuration>
The settings stored in the System registry branch, are stored in the file as child nodes of the <Key Name="System"> node.
<...>
<Key Name="PP">
<BIS>
<Key Name="System">
<Cert Alg="pro" Data="..." Id="SPCERT" Key="6E8E6325-496F-4177-BCEE-8A7859225C99" />
<Session KeyIncr="0" LockSession="-2" RWLockSlim="-2" LockAd="-2" Sampling="On" SamplingStr="IsOn" Cache="1" Statable="Never" StoreBins="3" StoreBinSize="2M" SysLogMb="FPRepository" TimeoutSec="-1" />
<StateServer Host="localhost" Port="-1" Type="MemCached" />
<Pool MaxConnections="1" UserMaxConnections="0" Strategy="LRU" RetryCount = "20" RetryInterval = "2000">
<Key Name="K1" Db="USER:FPRepository@FPServer" UserMaxConnections="1" />
</Pool>
<Mbs>
<Key Name="FPRepository" StatKeys="57637,150" />
</Mbs>
...
</Key>
</BIS>
</Key>
</...>
The section with the Service key contains settings for addressing a remote BI server on building cubes. According to these parameters the cubes address the server to get data. All parameters are specified in child elements of the <Key Name="Service"> element, which in turn is a child of element of the <Root> element.
<...>
<Key Name="Service">
<Epts>
<Key Name="s0" address="http://localhost:9090/axis2/services/PP.SOM.Som"/>
<Key Name="s1" address="http://localhost:9091/axis2/services/PP.SOM.Som"/>
<Key Name="s2" address="http://localhost:9092/axis2/services/PP.SOM.Som"/>
</Epts>
<Mbs>
<Key Name="FPRepository1" endpoint="">
<Cubes>
<Key Name="k1" Keys="5" endpoint="s2" />
<Key Name="k2" Keys="59,13837" endpoint="s0" />
</Cubes>
</Key>
<Key Name="FPRepository2" endpoint="s1">
<Cubes>
<Key Name="k1" Keys="18933,115978" endpoint="s1" />
</Cubes>
</Key>
</Mbs>
...
</Key>
</...>
The settings stored in the InMem registry branch, are stored in the file as child nodes of the <Key Name="InMem"> node. For details about caching types that are implemented and used in Foresight Analytics Platform see the Caching subsection.
<...>
<Key Name="InMem">
<Key Name="UseInMem" Value="true"/>
<Key Name="DataDir" Value="C:\ProgramData\Foresight\Foresight Analytics Platform\inmem_data\"/>
<Key Name="MemLimitMb" Value="6000"/>
</Key>
</...>
<...>
<Key Name="VirtualMemoryThreshold" Value="55"/>
</...>
See settings description in the System Registry Settings section.
See also:
System Settings of Foresight Analytics Platform | System Registry Settings