System configuration

You can set some crucial functions by system configuration. Configuration also defines security. Therefore, pay attention to it.

Configuration of the web part and Windows service

Both these parts share the same configuration but differ in small details. These aspects will be described in particular chapters.

Configuration for the web part is in file web.config.

Configuration for the Windows service is in file ObjectGearsService.exe.config.

Confuguration of the main parameters can be done during installation by means of Installer. However, you can also modify both files also manually in order to change the system parameters.

Common configurations

Set connection to the database in the element connectionStrings. The configuration is standard for .NET Framework and SQL Server. Hereinafter we show one example from possible settings:

<connectionStrings>
  <add name="ObjectGearsService.Properties.Settings.ConnectionString" connectionString="Data Source=myserver\SQL2014;Integrated Security=SSPI;Initial Catalog=OG" />
</connectionStrings>

Perform the setting of SMTP for sending emails in the element system.net / mailSettings. Configuration is standard for .NET Framework.

<system.net>
  <mailSettings>
    <smtp deliveryMethod="Network" from="info@ocompany.com">
      <network host="og.cz" port="25" userName="user@a.cz" password="mypassword" />
    </smtp>
  </mailSettings>
</system.net>

Web part and Windows service have a set of often common parameters. The table hereinafter describes them also with indication, where the parameter shall be used. 

use: W - web, S - Windows service

It is necessary, that the configuration of the same parameters for web and Windows service is same. Otherwise, unforseen errors may occur.

An exception is parameter PikloDir, that might be different.

Parameters SpecialConfiguration

Parameters can be combined - e.g.

<setting name="SpecialConfiguration" serializeAs="String">
<value>enableimportfromad=true;enableiframesfor=cp-24/cp-1999</value>
</setting>

Specific configurations for the web part

Select the authenication type in attribute mode of the element authentication in web.config. There are two possibilities:

• Windows - for user logon by means of a domain account (single-sign-on)
• Forms - user logon by means of a name and password

Windows logon:

<authentication mode="Windows">
  <forms loginUrl="~/Login.aspx" protection="All" timeout="60" path="/" requireSSL="false"/>
</authentication>

Forms logon:

<authentication mode="Forms">
  <forms loginUrl="~/Login.aspx" protection="All" timeout="60" path="/" requireSSL="false"/>
</authentication>

Setting maximal size for attachments and imported files

You can insert vrious files in the column of type File. The size of these files in limited in the basic ASP.NET configration to cca 4 MB. The same limit applies to imported files. If you need to insert large attachments or import larger files, than perform following settings in three places:

1) configuration parameter MaxFileSize - see the table above

2) parameter maxRequestLength in web.config. Set the value in kilobytes.

<configuration>
  <system.web>
    <!-- in kilobytes -->
    <httpRuntime maxRequestLength="1048576" />
  </system.web>
</configuration>

3) parameter maxAllowedContentLength in web.config. Set the value in bytes.

<configuration>
  <system.webServer>
    <security>
      <requestFiltering>
        <!-- in bytes -->
        <requestLimits maxAllowedContentLength="1073741824" />
      </requestFiltering>
    </security>
  </system.webServer>
</configuration>

Specific configurations for the Windows service

There are none at the moment.

Configuration of the Administrator tool

Administrator tool does not need to be configured. It is only necessary create connection to the database at its start.

Configuration of Piklo

Piklo component does not need to be configured.