Appendix 1.  Structure of the installation directory and assigning directories and files

<< Prev   Next >>

After installation, a directory structure will be organized on the drive, where application executable and configuration files are located. This section describes the directory structure and the purpose of some executable and configuration files.

1.1. On Windows

By default, the application will be installed in the %PROGRAMFILES%\1cv8 directory (we will refer to this directory as the root installation directory). If you are installing the 32-bit version of the 1C:Enterprise application on a 64-bit version of Windows, the root installation directory will have the name %PROGRAMFILES(x86)%\1cv8.

The other directories and configuration files are created in the root installation directory:

  • common ‑ this directory contains the common files of 1C:Enterprise. These include the 1cestart launcher, the security key driver installer, the Management Console snap-in to administer the 1C:Enterprise server cluster (1CV8 Servers.msc), the 1C:Enterprise files icon library for the needs of the operating system.
  • conf ‑ this directory contains the configuration files necessary for the operation of 1C:Enterprise.
  • srvinfo ‑ the working directory of the main server. Contains server cluster data if the 1C:Enterprise server is installed as a Windows service.
  • A.B.C.D ‑ this directory contains files of a specific 1C:Enterprise version. Hereinafter this directory will be called the version directory. In this name, A.B.C.D ‑ is the full number of the particular version installed. Installer allows to install simultaneously several versions of the 1C:Enterprise applications. In this case, multiple version directories will be located in the root installation directory. So, in case of installation of versions 8.3.3.100 and 8.3.3.150 (version numbers ‑ conditional)  there will be two directories with names 8.3.3.100 and 8.3.3.150. Each version directory contains all the files (except the 1cestart file) specific to this version, namely: executable files, accompanying files, software products licenses, etc. The version directory structure:
    • bin ‑ contains the executable files of the version (directory of executable files).
    • bin\conf ‑ contains the configuration files of a specific version or the conf. cfg file, which contains the path to the shared directory of configuration files (by default, the conf directory of the root installation directory).
    • bin\dmf ‑ contains the files necessary for the functioning of the optimized database configuration update mechanism.
    • docs ‑ this directory contains the accompanying files in the Russian and English languages. The components of files may vary from version to version.
    • licenses‑ contains the license agreement for 1C:Enterprise in Russian (1CEnterpise_ru.htm file) and English (1CEnterpise_en.htm file), as well as license agreements for third-party software components used (this list may vary from version to version).
    • readme ‑ this directory contains readme files in the localization languages of the platform.

Some directories in the installation are always in a fixed place of the file system, regardless of which directory is selected during the application installation:

  • If you use a version that matches the operating system bitness, the common and conf directories are located in the %PROGRAMFILES%\1cv8 directory.
  • When using the 32-bit version of the application on the 64-bit OS, the common and conf directories are located in the %PROGRAMFILES(x86)%\1cv8 directory.
  • srvinfo directory (in addition to the common and conf directories) will be located:
    • If the bitness of 1C:Enterprise and operating system match‑ in the%PROGRAMFILES%\1cv8 directory.
    • When using the 32-bit version of the application on the 64-bit OS‑ in the %PROGRAMFILES(x86)%\1cv8 directory.

1.2. On Linux

The application will be installed in the root installation directory. Depending on the bitness of the operating system used, this directory is located:

  • In the 32-bit version of Linux: /opt/1C/v8.3/i386
  • In the 64-bit version of Linux: /opt/1C/v8.3/i386

The other directories and configuration files are created in this directory:

  • conf ‑ this directory contains the configuration files necessary for the operation of 1C:Enterprise.
  • docs ‑ this directory contains the accompanying files in the Russian and English languages. The components of files may vary from version to version.
  • dmf ‑ contains the files necessary for the functioning of the optimized database configuration update mechanism.
  • licenses‑ contains the license agreement for 1C:Enterprise in Russian (1CEnterpise_ru.htm file) and English (1CEnterpise_en.htm file), as well as license agreements for third-party software components used (this list may vary from version to version).
  • readme ‑ this directory contains readme files in the localization languages of the platform.
  • ExtDst ‑ contains additional utilities designed for use in conjunction with the 1C:Enterprise application.

1.3. On macOS

The system will be installed in the /opt/1cv8 directory (hereinafter we will call this directory as the root installation directory). The other directories and configuration files are created in the root installation directory:

  • common ‑ this directory contains the common files of 1C:Enterprise. These include the security key driver installer and the 1cescmn.cfg configuration file.
  • conf ‑ this directory contains the configuration files necessary for the operation of 1C:Enterprise.
  • A.B.C.D ‑ this directory contains files of a specific 1C:Enterprise version. Hereinafter this directory will be called the version directory. In this name, A.B.C.D ‑ is the full number of the particular version installed. Installer allows to install simultaneously several versions of the 1C:Enterprise applications. In this case, multiple version directories will be located in the root installation directory. So, in case of installation of versions 8.3.3.100 and 8.3.3.150 (version numbers ‑ conditional)  there will be two directories with names 8.3.3.100 and 8.3.3.150. Each version directory contains all the files (except the 1cestart file) specific to this version, namely: executable files, accompanying files, software products licenses, etc. The version directory structure:
    • conf ‑ this directory contains the configuration files necessary for the operation of 1C:Enterprise.
    • docs ‑ this directory contains the accompanying files in the Russian and English languages. The components of files may vary from version to version.
    • licenses‑ contains the license agreement for 1C:Enterprise in Russian (1CEnterpise_ru.htm file) and English (1CEnterpise_en.htm file), as well as license agreements for third-party software components used (this list may vary from version to version).
    • readme ‑ this directory contains readme files in the localization languages of the platform.

1.4. Directories and files functions

This section describes some of the directories and files that are part of the 1C:Enterprise application.

1cestart

1C:Enterprise application launcher.

Using the launcher, you can start all types of clients (thick client, thin client, Web client), Designer.

TIP. If the launcher is located in a network directory, it is recommended that you use this program from the latest version, which you plan to install from that network directory.

File location:

  • On Windows OS: in  the common directory of the root installation directory.
  • On Linux: in the root installation directory.
  • On macOS: in the directory with executable files of the specific version.
1cv8s

Interactive launcher of the specific version of 1C:Enterprise application.

The launcher can start all types of clients (thick client, thin client, Web client), Designer.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: in the root installation directory.
  • On macOS: in the directory with executable files of the specific version.
1cv8

Executable file of thick client or Designer.

Cannot start thin client or web client.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: in the root installation directory.
  • On macOS: in the directory with executable files of the specific version.
1cv8c

Executable file of thin client.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: in the root installation directory.
  • On macOS: in the directory with executable files of the specific version.
1cv8a

Administrative console utility.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: in the root installation directory.
  • On macOS: in the directory with executable files of the specific version.
ragent, rmngr, rphost

Executable files of 1C:Enterprise server 1C:Enterprise server structure.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: in the root installation directory.
  • On macOS: none.
dbgs

1C:Enterprise debug server Application debugging.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: in the root installation directory.
  • On macOS: in the directory with executable files of the specific version.
dbda

Data accelerator. Works only as part of the 1-bit: 1C:Enterprise server cluster. Designed to speed up the execution of complex analytical reports.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: in the root installation directory.
  • On macOS: none.
webinst

Web Client Publishing Configuration Utility on Web server.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: in the root installation directory.
  • On macOS: none.
<Version number>\bin\conf             except Linux

Configuration files of the specific 1C:Enterprise application version.

\conf                                        Linux

1C:Enterprise configuration files.

chdbfl

The file mode database testing utility.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: in the root installation directory.
  • On macOS: none.
chvbfl

File mode database conversion utility.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: in the root installation directory.
  • On macOS: in the directory with executable files of the specific version.
v7cnv.exe                                  Windows

Converter of infobases from 1C:Enterprise 7.7 to the current version.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: none.
  • On macOS: none.
RegMSC.cmd                                 Windows

Command file for registration of the administration utility for 1C:Enterprise server cluster of a specific version (located in the directory of executable files of a specific version).

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: none.
  • On macOS: none.
1ceunt.dll                                 Windows

Library of icons used by OS to display 1C:Enterprise file types. This library is common to all versions of the application. Registration of this library (and associating icons with file types) is performed on the first installation of 1C:Enterprise on the computer. Canceling the library registration (and removing icons association with file types) is performed when the latest version of 1C:Enterprise is removed from the computer.

File location:

  • On Windows OS: in the common directory of the root installation directory.
  • On Linux: none.
  • On macOS: none.
ci

Integrity monitoring utility.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: in the root installation directory.
  • On macOS: in the directory with executable files of the specific version.
crserver

Configuration repository server.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: in the root installation directory.
  • On macOS: none.
dumper                                     Windows

Utility to generate crash dumps. This utility is used when specifying the externaldump="true" attribute in the logcfg.xml file.

File location:

  • On Windows OS: in the directory with executable files of the specific version.
  • On Linux: none.
  • On macOS: none.

1.5. Configuration files: location and search

1.5.1. General information

Configuration files used for 1C:Enterprise (logcfg.xml, nethasp.ini, and so on) can be stored at different locations in the file system.

1.5.2. On Windows

In Windows, files can be stored in the following locations (in the search order):

  • bin\conf directory of a specific version. For example, the path for the 8.3.3.100 version will look as follows: C:\Program Files\1cv8\8.3.3.100\bin\conf.
  • %USERPROFILE%\Local Settings\Application Data\1C\1cv8\conf (%LOCALAPPDATA%\1C\1cv8\conf for Windows Vista and later) directory of the user on whose behalf the application runs.
  • The directory specified in the Conf.cfg file that is located in the bin\conf directory of the specific version.
  • %ALLUSERSPROFILE%\Application Data\1C\1cv8\conf (%ALLUSERSPROFILE%\1C\1cv8\conf for Windows Vista and later) data directory for all users of the computer.

NOTE. When the application is being installed, the configuration files are written to the C:\Program Files\1cv8\conf directory, and this path is written to the bin\conf\conf.cfg file of the installed version.

This search order of configuration files allows to:

  • Generate unified configuration files for all versions and components installed on the computer. To do this, the configuration files should be located only in the C:\Program Files\1cv8\conf directory.
  • Generate configuration files separately for each version installed on the computer. To do this, the configuration files should be located only in the bin\conf directory.
  • Generate different configuration files for different components (for the 1C:Enterprise client application and server, operating under another user of the system) of any version running on the computer. For this purpose the configuration files should be located only in the%USERPROFILE%\Local Settings\Application Data\1C\1cv8\conf (%LOCALAPPDATA%\1C\1cv8\conf for Windows Vista and later) directories of the appropriate users.
  • Use combinations of these methods for different configuration files.

1.5.3. On Linux

On Linux, files can be located in the following places (in the search order):

  • conf directory of the version installed. For example, for the 32-bit version of 1C:Enterprise, the path to this directory will be as follows: /opt/1c/v8.3/i386/conf, and for the 64-bit version: /opt/1C/v8.3/x86_64/conf.
  • Directory ~/.1cv8/1C/1cv8/conf (~ ‑ home directory of the user, on behalf of which the 1C:Enterprise server operates).
  • The directory specified in the conf.cfg file that is located in the conf directory of the specific version.

1.5.4. On macOS

On macOS, files can be located in the following places (in the search order):

  • conf directory of the installed version, for example: /opt/1cv8/A.B.C.D/conf, where A.B.C.D ‑ the full version number of the 1C:Enterprise application.
  • conf directory of the root installation directory: /opt/1cv8/conf.
  • Directory ~/.1cv8/1C/1cv8/conf (~ ‑ home directory of the user, on behalf of which the 1C:Enterprise client application operates).
  • The directory specified in the conf.cfg file that is located in the conf directory of the specific version.

<< Prev   Next >>