1C:Enterprise 8.3. Administrator Guide. Contents

APPENDIX 1. INSTALLATION DIRECTORY STRUCTURE AND ROLES OF DIRECTORIES AND FILES

When software is installed, the hard drive will contain a specific structure of directories containing executable and configuration files of the software. This section covers the directory structure and roles of some executable and configuration files.

1.1. FOR WINDOWS OS

By default, the software is installed to C:\Program Files\1cv8 (installation root directory from now on). Other directories and configuration files are created in this directory:

„ common – this directory contains common 1C:Enterprise files. These files include launcher 1cestart.exe, dongle driver installer, and management console snap-in for 1C:Enterprise server cluster administration (1CV8 Servers.msc).

„ conf – this directory contains configuration files required for 1C:Enterprise operation.

„ srvinfo – central server working directory. This directory contains server cluster data if 1C:Enterprise server is installed as a Windows service.

„ 8.3.X.YYY – this directory contains the files of the specific 1C:Enterprise version. X and YYY in this name represent the numbers of the specific installed version. Please note that the installer allows for installation of multiple 1C:Enterprise versions on a computer simultaneously. In this case the installation root directory will contain multiple version directories. For example, if versions 8.3.3.657 and 8.3.3.658 are installed (the version numbers are for reference only), two directories will be available named 8.3.3.657 and 8.3.3.658. Every version directory contains all the files (except for 1cestart.exe) specific for this particular version: the executable files themselves, accompanying files, licenses for the used software products, etc. A version directory is structured as follows:

○     bin – contains the executable files of the version (executable files directory).

○ bin\conf – hosts configuration files of the specific version or conf.cfg file containing the path to the shared configuration files directory (by default it is conf directory in the installation root directory). For description of conf.cfg, see page 251.

○ docs – this directory contains accompanying files in Russian and in English. The assortment of such files may vary from one version to another.

○ licenses – contains 1C:Enterprise license agreement in Russian (1CEnterpise_ru.htm) and in English (1CEnterpise_en.htm) as well as license agreements to various used third-party software components (the content of the list may vary from one version to another).

○ readme – this directory contains readme files in the platform localization languages.

Some directories are always stored in a fixed location of the file system during installation, regardless of the directory which was selected:

„ If a client application is installed on a 32-bit OS, the common and conf directories are stored in the %ProgramFiles%\1cv8 directory.

„ If a client application is installed on a 64-bit OS, the common and conf directories are stored in the %ProgramFiles(x86)%\1cv8 directory.

„ If a 32-bit 1C:Enterprise server is installed, the srvinfo directory (in addition to the common and conf directories) is located in the following path:

○     in the %ProgramFiles%\1cv8 directory in a 32-bit OS;

○ in the %ProgramFiles(x86)%\1cv8 directory in a 64-bit OS.

„ If a 64-bit 1C:Enterprise server is installed, the srvinfo directory (in addition to the common and conf directories) is located in the %ProgramFiles%\1cv8 directory.

1.2. FOR LINUX

The system will be installed to the /opt/1C/v8.3/i386 directory in the case of the 32-bit version or in the /opt/1C/v8.3/x86_64 directory in the case of the 64-bit version (hereinafter called the "root installation directory"). Other directories and configuration files are created in this directory, including:

„ conf – this directory includes the configuration files required for the operation of 1C:Enterprise.

„ docs – this directory contains the associated files in Russian and English. Some of these files can be missing depending on the version.

„ licenses – includes the 1C:Enterprise license agreement in English (1CEnterpise_en.htm) and Russian (1CEnterpise_ru.htm), and license agreements for any third party software components used (the list can vary depending on the version).

„ readme – this directory contains readme files in platform localization languages.

„ utils – contains additional utilities for configuring the 1C:Enterprise server.

1.3. ROLES OF DIRECTORIES AND FILES

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

1cestart

1C:Enterprise launcher.

The launcher is intended to launch all types of clients (thick client, thin client, web client) and the designer.

TIP

If the launcher is located in the network directory (see page 41), use this launcher from the newest version to be installed from this network directory.

File location:

„ For Windows: in the common directory of the root installation directory.

„ For Linux: in the root installation directory.

1Cv8s

Interactive 1C:Enterprise launcher for a specific version.

It is intended to launch all types of clients (thick client, thin client, web client) and the designer.

File location:

„ For Windows: in the executable file directory of the given version.

„ For Linux: in the root installation directory.

1Cv8

Executable file of the thick client or the designer.

It cannot launch the thin or web clients.

File location:

„ For Windows: in the executable file directory of the given version.

„ For Linux: in the root installation directory.

1Cv8c

Executable file of the thin client.

File location:

„ For Windows: in the executable file directory of the given version.

„ For Linux: in the root installation directory.

ragent, rmngr, rphost

Executable files of the 1C:Enterprise server (for details, see "1C:Enterprise 8.3.

Client/Server Mode Administrator Guide").

File location:

„ For Windows: in the executable file directory of the given version.

„ For Linux: in the root installation directory.

webinst

The utility for customizing the publishing of a web client to the web server (for details, see page 155).

File location:

„ For Windows: in the executable file directory of the given version.

„ For Linux: in the root installation directory.

       <Version Number>\bin\conf                   For Windows only

Configuration files of the specific 1C:Enterprise version. For details on locating configuration files, see page 227.

       \conf                                          For Linux only

1C:Enterprise configuration files. For details on locating configuration files, see page 227.

chdbfl

The utility to verify file infobase mode database (for details, see page 315).

          v7cnv                                        For Windows only

Infobase converter from older 1C:Enterprise 7.7 to the current version. For details, see "1C:Enterprise 8.3. Developer Guide").

File location:

„ For Windows: in the executable file directory of the given version.

„ For Linux: not available.

          RegMSC.cmd                                   For Windows only

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

File location:

„ For Windows: in the executable file directory of the given version.

„ For Linux: not available.

          1ceunt.dll                                   For Windows only

This is a library containing all the icons which the operating system uses to display different types of 1C:Enterprise system files. The library is shared by all versions of the system and is registered – with the icons being attached according to the file type – during the initial installation of 1C:Enterprise on the computer. Library registration is cancelled (and attachment of icons according to the file type is discontinued) once the last version of 1C:Enterprise has been deleted from the computer.

File location:

„ For Windows in the common directory of the root installation folder.

„ For Linux: not available.

1.4. CONFIGURATION FILES: LOCATION AND SEARCH

The configuration files used during 1C:Enterprise operation (logcfg.xml, nethasp.ini etc.) may be stored in different locations in the file system.

1.4.1. For Windows OS

In Windows OS, the files may be stored in the following locations (listed here in the search order):

„ The bin\conf directory of the specific version (e.g., 8.3.3.657) will appear as follows: C:\Program Files\1cv8\8.3.3.657\bin\conf.

„ The %USERPROFILE%\Local Settings\Application Data\1C\1cv8\ñonf (%LOCALAPPDATA%\1C\1cv8\ñonf for Windows Vista and above) directory of the account under which the system is operating.

„ The directory specified in the conf.cfg file located in the bin\conf directory of the specific version. For details on the format of the conf.cfg file, see page 251.

„ The %ALLUSERSPROFILE%\                 Application           Data\1C\1cv8\ñonf (%ALLUSERSPROFILE%\1C\1cv8\ñonf for Windows Vista and above) data directory for all users of the computer.

NOTE

When the software is installed, the configuration files are located at C:\Program Files\1cv8\conf and the path is recorded in bin\conf\conf.cfg file of the installed version.

This order used to search for configuration files enables:

„ To create unified configuration files for all the versions and components installed on a computer. To make this possible, the configuration files should only be located at C:\Program Files\1cv8\conf.

„ To create configuration files independently for every version installed on a computer. To make this possible, the configuration files should only be located at the bin\conf directory of the specific version.

„ To create independent configuration files for various components (for 1C:Enterprise client application and server running under another user account) of any version running on the computer. To make this possible, the configuration files should only be located in the directories %USERPROFILE%\ Local Settings\Application Data\1C\1cv8\Conf of the respective user accounts.

„ To combine the above arrangements for different configuration files.

1.4.2. For Linux OS

In Linux OS, the files may be stored in the following locations (listed here in the search order):

„ The conf directory of the version installed. For instance, the path to this directory would appear as /opt/1C/v8.3/i386/conf in the 32-bit version of 1C:Enterprise, and as /opt/1C/v8.3/x86_64/conf in the 64-bit version.

„ The ~/.1cv8/1C/1cv8/conf (~ is a home directory of the account under which the 1C:Enterprise server operates) directory.

The directory specified in the conf.cfg file located in the conf directory of the version installed. For details on the format of the conf.cfg file, see page 251.