4.9. Standalone server (ibsrv)


<< Prev   Next >>

You can manage the standalone server using the configuration file and command-line parameters. Command-line parameters have priority over configuration file parameters. It means that if a parameter is specified both in the command line and in the configuration file, the standalone server uses the parameter value from the command line.

To start the standalone server, use the following command line:

ibsrv [--parameter[=value]] [--parameter[=value]]

Where:

  • parameter. Standalone server parameter to be set. You can find the list of available parameters in the table below.
  • value. Parameter value if it is required for the used parameter.

You can specify more than one parameter in the command line. In this case, the parameters are specified one by one as space-separated values.

To get help information on the standalone server startup parameters, you can use the following command line:

ibsrv --help

The command will return a list similar to the table below. The difference is that the table is ordered by parameter name.

Parameter

Description

--config=<path>

-c <path>

Path to the configuration file.

--daemon

Standalone server in Linux daemon mode. Available only on Linux.

--data=<path>

-d <path>

Path to the server data directory.

Default value: %LOCALAPPDATA%/1C/1cv8/standalone-server/.

--database-name=<name>

--db-name=<name>

Database name.

--database-password=<password>

--db-pwd=<password>

DBMS server user password.

--database-path=<path>

--db-path=<path>

Path to 1C:Enterprise file database directory. If you use a relative path, the full path is received relative to the server data directory.

Default value: the db-data directory of the server data directory.

--database-server=<address>

--db-server=<address>

The DBMS server name.

--database-user=<name>

--db-user=<name>

DBMS server username.

--dbms=<kind>

Specifies a type of the DBMS where the infobase is located.

Possible values:

  • MSSQLServer. Microsoft SQL Server.
  • PostgreSQL. PostgreSQL.
  • IBMDB2. IBM Db2.
  • OracleDatabase. Oracle Database.

If the parameter is not specified, the file database is used.

--debug=[none|tcp|http|server]

-D [none|tcp|http|server]

Enable infobase debugging.

Possible values:

  • none. Debugging is disabled.
  • tcp. Debugging over TCP/IP.
  • http. Debugging over HTTP.
  • server. Debugging via an external debug server whose address is specified in the --debug-server-url parameter.

If the --debug parameter value is not specified, debugging is enabled as follows (depending on the enabled standalone server capabilities):

  • tcp. If direct connection to a standalone server is allowed.
  • http. If connection to a standalone server over HTTP is allowed.
  • server. If an external debug server is specified in the settings.
  • none. In other cases.

--debug-address=<address>

IP address served by the server for debugging over HTTP.

Possible values:

  • localhost. Local network interface.
  • any. All available network interfaces.
  • xxx.xxx.xxx.xxx. Network address of the used network interface in IPv4 format.
  • xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx. Network address of the used network interface in IPv6 format.

Default value: localhost.

--debug-password=<password>

Password to access the debug server.

--debug-port=<port>

Network port served by the debug server over HTTP.

Default value: 1550.

--debug-server-password=<password>

Password to access the external debug server.

--debug-server-url=<url>

Address of an external debug server.

--direct-range=<lower:upper>

Range of network ports used to establish a direct connection to the server.

Default value: 1560:1591.

--direct-regport=<number>

Main network port to establish a direct connection to the server.

Default value: 1541.

--direct-seclevel=<0|1|2>

Security level of a direct connection to the server.

Possible values:

  • 0: unsecure connections.
  • 1: secure connections only during user authentication.
  • 2: permanently secure connections.

Default value: 0.

--disable-direct-gate

--disable-direct

Disable direct access to the standalone server.

--disable-extended-designer-features

Disable advanced configuration options.

--disable-http-gate

--disable-http

Disable access to the standalone server over HTTP.

--disable-ssh-gate

--disable-ssh

Disable access to the standalone server over SSH.

--distribute-licenses=<flag>

Manages client license issuance by a standalone server.

Possible values:

  • allow, yes, true. Client license issuance is enabled.
  • deny, no, false. Client license issuance is disabled.

Default value: allow.

--enable-direct-gate

Enable direct access to the standalone server.

--enable-extended-designer-features

Enable advanced configuration options. Designer add-ins must be attached within the platform installation.

--enable-http-gate

Enable access to the standalone server over HTTP.

--enable-ssh-gate

Enable access to the standalone server over SSH.

--ftext2-data=<path>

Path to the full-text search data directory (version 2).

If you use a relative path, the full path is received relative to the server data directory.

Default value: the ftext2-data directory of the server data directory.

--ftext-data=<path>

Path to the full-text search data directory.

If you use a relative path, the full path is received relative to the server data directory.

Default value: the ftext-data directory of the server data directory.

--help

-?

-h

Receive the utility help information.

--http-address=<address>

--address=<address>

-a <address>

Main IP address served by the server.

Possible values:

  • localhost. Local network interface.
  • any. All available network interfaces.
  • xxx.xxx.xxx.xxx. Network address of the used network interface in IPv4 format.
  • xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx. Network address of the used network interface in IPv6 format.

Default value: localhost.

--http-base=<location>

--base=<location>

-b <location>

Base path to publish infobases.

Default value: /.

--http-port=<number>

--port=<number>

-p <number>

Main network port served by the server.

Default value: 8314.

--id=<uuid>

Infobase ID.

Possible values:

  • xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. UUID.
  • auto. Autogenerated UUID.

Default value: auto.

--lock=<path>

Path to the lock file of the standalone server data directory.

By default, the lock.pid file of the server data directory is used.

--log-data=<path>

Path to the event log data directory.

If you use a relative path, the full path is received relative to the server data directory.

Default value: the log-data directory of the server data directory.

--name=<name>

-n <name>

Infobase name.

The default name is a string presentation of the infobase ID.

--openid-data=<path>

Path to the OpenID authentication data directory.

If you use a relative path, the full path is received relative to the server data directory.

Default value: the openid-data directory of the server data directory.

--request-database-password

--request-db-pwd

-W

Password request of the DBMS server user over the standard input stream (stdin).

--schedule-jobs=<flag>

Enables/disables scheduled job planning.

Possible values:

  • allow, yes, true. Scheduled job planning is enabled.
  • deny, no, false. Scheduled job planning is disabled.

Default value: allow.

--service

Standalone server in Windows service mode. Available only on Windows.

--session-data=<path>

Path to the session data directory.

If you use a relative path, the full path is received relative to the server data directory.

Default value: the session-data directory of the server data directory.

--ssh-address=<address>

IP address served by the server for connection over SSH.

Possible values:

  • localhost. Local network interface.
  • any. All available network interfaces.
  • xxx.xxx.xxx.xxx. Network address of the used network interface in IPv4 format.
  • xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx. Network address of the used network interface in IPv6 format.

Default value: localhost.

--ssh-host-key=<path>

Path to the file used as a private key of the host when connecting over SSH.

Default value: %USERPROFILE%/.ssh/id_rsa.

--ssh-port=<number>

TCP port served by the server for connection over SSH.

Default value: 1543.

--stt-data=<path>

Path to the directory of the speech recognition model storage.

If you use a relative path, the full path is received relative to the server data directory.

Default value: the stt-data directory of the server data directory.

--system=<path>

Path to the system configuration file.

--temp=<path>

-t <path>

Path to the directory of temporary infobase files.

If you use a relative path, the full path is received relative to the server data directory.

Default value: the temp directory of the server data directory.

--users-data=<path>

Path to the directory of user configuration data.

Default value: the users-data directory of the server data directory.

--version

-v

Get a utility version.

See also:

  • Standalone server
  • Standalone server configuration file

<< Prev   Next >>

Icon/Social/001 Icon/Social/006 Icon/Social/005 Icon/Social/004 Icon/Social/002