3.15. conf.cfg

<< Prev   Next >>

The conf.cfg file specifies the location of the common configuration file directory and the default application interface language.

File location:

• On Windows:
  • In the bin\conf directory of a specific version directory of 1C:Enterprise of the appropriate bitness.
  • In the %LOCALAPPDATA%\1C\1cv8\conf directory. Used by the platform of any version, bitness, and installation option.
  • Installation "for computer":
    • 32-bit application in the 64-bit OS: %PROGRAMFILES(x86)%\1cv8\conf.
    • Otherwise: %PROGRAMFILES%\1cv8\conf.
  • Installation "for user":
    • 32-bit application in the 32-bit OS: %LOCALAPPDATA%\Programs\1cv8\conf.
    • 32-bit application in the 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x86\conf.
    • 64-bit application in the 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x64\conf.
• On Linux:
  • In the conf directory of a specific 1C:Enterprise version directory with the appropriate bitness.
  • The ~/.1cv8/1C/1cv8/conf directory (~ is the home directory of the user on whose behalf the 1C:Enterprise server operates).
• On macOS:
  • In the conf directory of the installed version. For example, /opt/1cv8/A.B.C.D/conf, where: A.B.C.D is the full number of the used 1C:Enterprise version.
  • The ~/.1cv8/1C/1cv8/conf directory (~ is the home directory of the user on whose behalf the 1C:Enterprise server operates).

The file is a text document encoded in UTF-8.

The file may contain the following parameters:

The parameter specifies the directory the application will search for configuration files (logcfg.xml, nethasp.ini, and so on) if they are not found in the standard search paths. This parameter makes sense if the file is located in the conf directory of a particular version.

By default, the parameter value is equal to:

• On Windows:
  • Installation "for computer":
    • 32-bit application in the 64-bit OS: %PROGRAMFILES(x86)%\1cv8\conf.
    • Otherwise: %PROGRAMFILES%\1cv8\conf.
  • Installation "for user":
    • 32-bit application in the 32-bit OS: %LOCALAPPDATA%\Programs\1cv8\conf.
    • 32-bit application in the 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x86\conf.
    • 64-bit application in the 64-bit OS: %LOCALAPPDATA%\Programs\1cv8_x64\conf.
• On Linux: /opt/1cv8/conf.
• On macOS: /opt/1cv8/A.B.C.D, where A.B.C.D is the full number of the used 1C:Enterprise version.

Example:

ConfLocation=C:\MySettings\v8\conf

This parameter specifies the application interface language. The parameter value can be specified by the interface language codes (see article Selecting default interface language) or the System value. If a language value is specified, this language will be used. If System is specified, the interface language will be determined by the localization of the operating system.

If you specify a language that does not exist, an attempt will be made to use the localization language according to the operating system regional settings. If the user interface is not installed in the specified language, the English interface will be used.

When using a client application running on Windows, consider the following feature: if the conf.cfg file with a specified interface language is located in the conf directory of a certain version, the specified interface language will be used only for this version. If this file is located in the conf directory of the root installation directory, the specified interface language will be used for all versions installed on this computer.

If the SystemLanguage parameter is not specified in the configuration file, the mechanism of defining the interface language using the *.res file will be used. If there is no file with *.res extension, the interface corresponding to the regional operating system settings will be selected at operating system startup. Specifying an unknown or nonexistent interface language code is equivalent to no file specified.

Example:

SystemLanguage=System

Use the interface language according to the regional operating system settings.

SystemLanguage=RU

Use the Russian (RU) language for the interface.

The parameters specify the location of the client application distribution package depending on the operating system and bitness. In terms of their behavior and content, the parameters are similar to the pubdst32, pubdst64, pubdstmac64, pubdstlin32, and pubdstlin64 attributes of the point item of the default.vrd file (see article default.vrd).

This parameter enables shortened verification periods for interactions with the licensing center (see article Protection against misuse of applications). Depending on the parameter value, the following verification periods can be used:

• This parameter is set to true value (shortened verification periods):
  • License verification by server. Every 60 seconds.
  • License verification by clients. Every 30 seconds.
  • License re-verification by clients (if the LC is unavailable or after entering the license client data). 15 seconds.
• This parameter is set to false value (standard verification periods):
  • License verification by server. Every 1 hour.
  • License verification by clients. Every 1 hour.
  • License re-verification by clients (if the LC is unavailable or after entering the license client data). 10 minutes.

Default value: false.

This parameter specifies the format used to create new databases while in the infobase file mode.

Values: 8.2.14 and 8.3.8.

Default value: 8.2.14.

Controls the use of the TLS 1.0 protocol. Depending on the parameter value, the following protocols are used:

• The parameter is set to true. Only version 1.0 of the TLS protocol is used.
• The parameter is set to false(or any value other than true). The protocol used depends on the settings of the web server with which 1C:Enterprise interacts. Any TLS protocol version may be used, up to version 1.2.

Default value: false.

The parameter controls the encoding used for the names of files in zip archives generated by 1C:Enterprise.

If the parameter value is set to UTF8, the names of the files containing the national characters will be displayed incorrectly by the integrated archiving utility in Windows XP/2003/2008/7 and by the ReadingofZipFile object in 1C:Enterprise 8.3.6 and earlier. These file names will be displayed correctly in macOS.

If the parameter value is set to OSEncodingWithUTF8, the file names containing national characters will be displayed incorrectly by the integrated macOS archiving utility, but in other cases there will be no issues.

Values: UTF8, OSEncodingWithUTF8.

Default value: UTF8.

This option allows you to disable protection against unsafe actions for specific infobases. Infobases are defined by a set of templates (regular expressions) separated by the semicolon character ";". If the infobase connection string satisfies any of the regular expressions listed in this parameter, protection against unsafe actions will be disabled for this infobase.

When you edit regular expressions, use POSIX Basic Regular Expressions (https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap09.html#tag_09_03).

This parameter is used by the process that actually performs a potentially dangerous action:

• Importing external data processors/reports or configuration extensions. Server only (rphost process).
• Importing add-ins. Client application or server (rphost process).
• Starting an external application. Client application or server (rphost process).

Example:

DisableUnsafeActionProtection=test_.*;stage_.*;

This parameter specifies the components of Internet service resources used and some details of application behavior.

The parameter can take the following values:

• D. Default value. The application functions as follows:
  • The platform and configuration software licensing system uses servers located in Russia.
  • When you use the menu commands Help – Information on the Internet, Russian resources are accessed.
  • Registration in the collaboration system is supported.
  • Dedicated 1C service for sending PUSH notifications is supported.
• A. Alternative list of service resources. In this case, the application functions as follows:
  • The platform and configuration software licensing system uses servers located in Europe.
  • When you use the menu commands Help – Information on the Internet, European resources are accessed.
  • Registration in the collaboration system is not supported.
  • Dedicated 1C service for sending PUSH notifications is not supported.

Controls detection of circular references during script execution:

• The parameter is set to true. Search for circular references during script execution.
• The parameter is set to false. Do not search for circular references during script execution.

Default value: false.

Specifies which version of the infobase restructuring component will be used if this is not explicitly specified. Used in the configuration file on the computer where Designer runs.

The parameter can take the following values:

• v1. Usual restructuring mechanism. The only restructuring option available in 1C:Enterprise 8.3.10 and later.
• v2. Optimized restructuring mechanism. It is true only for the client/server mode of the infobase if Microsoft SQL Server or PostgreSQL is used as a DBMS. If you plan to use the optimized restructuring mechanism in conjunction with the Microsoft SQL Server database management system, the 1C:Enterprise server must use the TCP/IP network protocol (in terms of the database management system) to connect to the database management system. The work of the optimized restructuring mechanism is not supported if the 1C:Enterprise server is connected to the Microsoft SQL Server DBMS using Shared memory or Named pipes network protocols.

Default value: v1.

Specifies the path to the JAVA installation directory. If this parameter is not specified, the path to the JAVA installation directory is defined in the JAVA_HOME environment variable. It is used in the configuration file on the computer where the 1C:Enterprise server cluster is located.

If the application runs on Windows, the JavaHome parameter is not specified in the conf.cfg file, and the JAVA_HOME environment variable is not specified, then Java uses the system registry to determine Java installation path. Information is written to the system registry when installing JRE.

Defines additional parameters to start a Java Virtual Machine for the optimized restructuring feature operation. The value of this property must not contain quotation marks. It is used in the configuration file on the computer where the 1C:Enterprise server cluster is located.

This property can be used, for example, to set the maximum amount of RAM available for the Java machine.

Example:

#Setting the maximum amount of available memory for a Java process
JavaOpts=-Xmx2048m

Example:

#Starting JAVA processes with debugger support
JavaOpts=-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005

Defines additional parameters to start a Java Virtual Machine for the full-text search version 2 operation. The value of this property must not contain quotation marks. It is used in the configuration file on the computer where the 1C:Enterprise server cluster is located.

This property can be used, for example, to set the maximum amount of RAM available for the Java machine.

Example:

#The minimum heap size. It is specified for the full-text search
#to trigger the garbage collection less often and unload internal caches
FtsJavaOpts=-Xms2G

Example:

#The maximum heap size. It is specified to set
#a new memory consumption boundary
FtsJavaOpts=-Xmx8G

Example:

#Console output mode. It is specified to investigate the error causes
#when starting version 2 of the full-text search server
FtsJavaOpts=-Dconsole=none #Do not output anything to the console (by default)
FtsJavaOpts=-Dconsole=all #Output everything to the console
FtsJavaOpts=-Dconsole=start|stop #Output only the server startup and shutdown string

Controls the behavior of the application when the platform cannot explicitly check the revocation of the certificate:

• The parameter is set to true. Ignore errors related to the server certificate revocation check.
• The parameter is set to false. Do not ignore errors related to the server certificate revocation check.

Default value: true.

This parameter is relevant if the server has provided the certificate, the certificate chain is correct, but revocation of the provided certificate cannot be checked. In this case, the application behaves as follows, depending on the parameter value:

• The parameter is set to true. The connection will be established.
• The parameter is set to false. The connection will not be established, and an exception will be thrown.

Allows you to specify a path (paths) for 1C:Enterprise to search for CryptoPro CSP library on Linux or macOS. If you specify several paths (similar to the PATH environment variable), they must be semicolon-separated.

Controls whether the external session management service must be used. The parameter can take the following values:

• 1. External session management is required. In a service call error occurs, you cannot create a new session.
• 0. External session management is not required. If a service call error occurs, you can create a new session. Default value.

If the configuration file located in the infobase directory does not specify the ExternalSessionManagementRequired and/or ExternalSessionManagementConnectionString parameters, an attempt to use the ConfLocation parameter is made to get the parameters from the conf.cfg file whose location is specified in this parameter. You can use the unified setup file of the external session management service for several infobases by using the ConfLocation parameter.

Parameter description string of the external session management service. The web service parameter string has the following format: Parameter=Value;. The parameter string contains required parameters (wsdl, ns, srvc, and port) and optional parameters (tout and wsver):

• wsdl. URL to get web service description in WSDL format.
• ns. Web service namespace.
• srvc. Name of the external session management web service.
• port. Name of the port used by the web service.
• tout. Maximum time-out for a call to the web service of external session management, in seconds. Default value: 5 seconds.
• wsver. Version number of the used web service of external session management. Possible values are 1, 2, 3, and 4. The default value is 4.

An example of a string with web service description:

wsdl=http://server/sm/ws/manager?wsdl;ns=http://www.sessioncontrol.org;srvc=ExternalSessionControl;port=ExternalSessionControlSoap;tout=10;wsver=4;

<< Prev   Next >>