Publishing to web servers

Publishing an infobase is placing its publication file to a web server directory.

To publish an infobase, on the Administration menu, click Publishing to web server.

This opens a window where you can specify the publishing settings and then publish the infobase on the local computer.

Main publishing settings

The Main tab contains data required for publishing.

If the infobase was never published before, the fields are filled with default values (and the name matches the infobase name). You can edit these values.
If the infobase was published earlier, the tab contains the settings specified at that time.
If a publication with settings different from those specified in this window is found, the platform prompts you to update the settings.
If no publication matching the settings is found, a warning is displayed.

Select a web server and specify the directory for the publication file.
The list of web servers is created automatically based on the installed web servers.

The publication name must meet the URL format standard (RFC 1738). 
If you select an Apache 2.2 web server, use US ASCII characters in the directory name.

Note. If you use Apache web server, both its versions are available for selection in this dialog box. Since the publishing settings for Apache 2.2 and Apache 2.4 are incompatible with each other, ensure that you select the correct web server version.

Specify whether you want to publish thin client and web client, web services, and HTTP services.

If you select the Publish standard OData interface check box, the ODATA service is published. It is intended for reading and editing infobase data using HTTP requests.

Publishing web services

On the Web services tab, select the Publish web services check box. Then, in the table, select the check boxes next to the web services that you want published.

If you select the Publish web services by default check box, the selected web services are published automatically. Otherwise they are skipped during the publishing.

If you select the Publish extension web services by default, web services added by extensions are automatically published during the republishing.

Publishing HTTP services

On the HTTP services tab, in the table, select the check boxes next to the HTTP services that you want published.

If you select the Publish HTTP services by default check box, the selected HTTP services are published automatically. Otherwise they are skipped during the publishing.

If you select the Publish extension HTTP services by default check box, HTTP services added by extensions are automatically published during the republishing.

To provide the option install the client application in the scenario where the client and server versions do not match, select the Publish distribution kit check box and then, in the Published distribution kit location field, specify the full path to the .zip archive that will be used as a distribution kit.

If users will access the client application using operating system authentication, select the Use operating system authentication check box. The check box is only available if you select an Internet Information Services web server.

To open a web page after exiting the web client, specify the page address in the URL to open after exiting the web client field.


Additional settings

The Additional tab displays data stored in the .vrd file, except the values that are located on the Main tab.

Temporary files directory. Matches the temp field.

Connection pool settings

Size. Matches the pool.size field.

Connection lifetime (sec). Matches the pool.maxAge field.

1C:Enterprise server connection settings

Attempts. Matches the pool.attempts field.

Timeout (ms). Matches the pool.attemptstimeout field.

Timeout between attempts (ms). Matches the pool.waitTimeout field.

Ping timeout (ms). Matches the pool.serverPingTimeout field.

Ping period (ms). Matches the pool.serverPingPeriod field. If at least one response is received during this period, the connection is considered available.

Debug settings

Debugging. Matches the debug.enable field. Select the protocol for debugging:

Debug over HTTP. Matches the "http" value of the debug.protocol field.

Debug server HTTP address. Matches the debug.url field. If the address is not specified, the current debug server address is used.

Debug over TCP/IP. Matches the "tcp/ip" value of the debug.protocol field.

Debugger address. Matches the debug.url field.

OpenID authentication settings

Use OpenID authentication. Specifies whether OpenID is used.

OpenID provider address. Matches the OpenID.rely.url field.

Use as OpenID provider. Specifies whether the infobase is the OpenID provider.

Authentication lifetime (sec). Matches the OpenID.provider.lifetime field.

Data separation settings

Publish data areas table. Matches the zones field and stores all configuration separators. It contains the following columns:

Store separator settings in the publication. This check box specifies whether the separator is used in the publication. Zones of .vrd files do not have names, so they are connected to separators according to the specified order. Check boxes can be selected only starting from the first separator.

Name. Separator name.

Use separator value. Specifies whether the separator value is used.

Value. Separator value (can be empty), matches the zones.value field.

Specified. Matches the zones.specify field.

Secure. Matches the field.

Background jobs in file mode. Matches the pointEnableCommon attribute of the ws element. It can have the following values:

On. Matches the default attribute value.

Off. Matches the off value.

Forced. Matches the force value.

To publish the infobase, click Publish.

To remove the publication file, click Remove. You will be prompted to remove the directory.

To load settings from a .vrd file, click Load and select the file.

To save the settings to a .vrd file, click Save and specify the path to the file.

Using the webinst utility

You can also use the webinst utility for publishing on a remote computer. Start the utility from the directory that contains the binary files of the platform (it requires dynamic libraries included in the platform).


webinst  [-publish] websrv -wsdir VirtualDir -dir Dir -connstr connStr [-confPath confPath] [-osauth]

Removing a publication:

webinst  -delete websrv -wsdir VirtualDir [-dir Dir] [-connstr connStr] [-confPath confPath]

-publish. Publish (default option).

-delete. Remove publication.

websrv. Web server type. The following values are possible:

  • iis. Publishing a web client for IIS.
  • apache2. Publishing a web client for Apache 2.0.
  • apache22. Publishing a web client for Apache 2.2.

-wsdir VirtualDir. Virtual directory.

-dir Dir. Physical directory for displaying the virtual directory.

-connstr connStr. Infobase connection string.

-confPath confPath. Full path to Apache configuration file (only for Apache).

-osauth. Use Windows authorization (only for IIS).

-descriptor <path to .vrd file>. New publication descriptor file. The existing .vrd file is replaced by the specified file during the publishing. If -wsdir and/or -connstr options are used, their values replace the values of the base and ib fields in the .vrd file, respectively. If the -delete option is used, the -descriptor option is used for obtaining the publication name (the base field in the .vrd file) and for checking the connection string (whether the specified infobase is published at this address). It must be the actual publication descriptor file.

When a publication is created or updated, a prompt to restart the web server is displayed in the following situations:

  • 1C:Enterprise version was changed.
  • 1C:Enterprise installation directory was changed.
  • New Apache publication was created.

If no Apache installation directory is found, a dialog box is displayed prompting you to specify the installation directory.

When you publish a file-based infobase on a web server using anonymous authentication, the right to access the database directory is checked for the anonymous user. If the user has insufficient rights, a message stating that they cannot access the infobase using a web server is displayed. We recommend that you either grant the rights or select the Use operating system authentication check box.

If you publish from Designer or using the webinst utility to an IIS 7 web server, the platform additionally checks that the publishing directory is not %SystemDrive%\Inetpub\wwwroot. If it is, an error message is displayed.

If you initially publish an infobase from Designer to a web server and a publication with the specified name already exists, a warning is displayed: A publication with name XXXX, which might be created using other tools, is found. Do you want to replace it? Yes/No.

1C:Enterprise Developer's Community