Команды конфигурации устанавливают параметры, используемые при запуске экземпляра сервера Application Object Server (AOS). Команды конфигурации могут выполняться непосредственно из следующих местоположений:

  • В файле конфигурации.

  • В поле Команда конфигурации для выполнения при запуске ядрав служебной программе настройки сервера.

  • Из командной строки при запуске экземпляра сервера AOS.

Необходимо использовать различный синтаксис команд конфигурации при их установке в файле конфигурации, исполнении в поле Команда конфигурации для выполнения при запуске ядраили из командной строки. В следующих разделах приводятся варианты синтаксиса.

Подробные сведения об исполнении команд конфигурации см. в разделе Выполнение команд конфигурации при запуске.

Общие параметры

В этой таблице описываются общие параметры, которые могут использоваться при работе с конфигурациями и файлами.

Команда в файле конфигурации

Команда из командной строки

Параметр служебной программы настройки

Описание

Эта команда не может быть установлена в файле.

- regConfig=< configname>

Конфигурация

Задает имя текущей группы параметров для экземпляра AOS.

Параметры Application Object Server

В этой таблице описываются параметры, которые могут использоваться для управления работой функций AOS.

Команда в файле конфигурации

Команда из командной строки

Параметр служебной программы настройки

Описание

application,Text,< applicationname>

- application=< applicationname>

Экземпляр приложения

Задает экземпляр приложения, к которому подключен экземпляр AOS.

bindir,Text,< path>

- bindir=< path>

Альтернативный каталог bin

Указывает местоположение каталога, содержащего альтернативный файл данных системных сообщений (один из файлов меток Microsoft Dynamics AX).

compressiondisabled,Int,1

- compressiondisabled

Параметр, недоступный в служебной программе

Это двоичная команда, которая не устанавливается по умолчанию. Когда это значение отсутствует, производится сжатие данных, передаваемых между сервером AOS и его клиентами, чтобы увеличить скорость связи клиент-сервер.

Если указано значение, сжатие пакетов отключается. Чтобы активировать сжатие пакетов, удалите значение из файла конфигурации.

Рекомендуется не отключать сжатие. Отключение сжатия может отрицательно сказаться на производительности и безопасности системы.

compressionminsize,Text,< number>

- compressionminsize=< number>

Минимальный размер сжимаемых пакетов

Задает минимальный полезный размер сжимаемого пакета. Чем больше выбирается размер пакета, тем меньше получается выигрыш в скорости.

directory,Text,< path>

- directory=< spath>

Местоположение файла приложения

Задает местоположение файлов приложения, к которым будет подключаться и в которые будет осуществлять запись экземпляр AOS.

exposeserverprinters,Int,1

- exposeserverprinters

Разрешить клиентам подключаться к принтерам на этом сервере

Эта двоичная команда, которая не устанавливается по умолчанию. Когда указано это значение, разрешается подключение клиентов в принтерам, которые связаны с компьютером AOS.

port,Text,< portnumber>

- port=< portnumber>

Порт TCP/IP

Порт TCP/IP, который должен использоваться экземпляром AOS для подключения к клиентам. Значение по умолчанию — 2712.

xppdebug,Text,< 0,1>

- xppdebug=< 0,1>

Включает точки останова для отладки кода X++, выполняемого на этом сервере

Позволяет клиентам выполнять трассировку своих взаимодействий с экземпляром AOS. Значение по умолчанию — "Отключено" (0).

caslevel,Text,< enable/disable/trace>

- caslevel= < enable/disable/trace>

Параметр, недоступный в служебной программе

CAS (Code Access Security) представляет собой механизм Microsoft Dynamics AX, который используется для защиты конкретных интерфейсов API. Список этих интерфейсов API см. в разделе Secured APIs.

Enable, параметр по умолчанию, активирует CAS для всех защищенных с помощью CAS интерфейсов API. Если защищенный CAS интерфейс API вызывается без использования шагов соответствующей процедуры, генерируется ошибка.

Traceиспользуется для моделирования включения CAS. В случае неправильного вызова интерфейса, защищенного с помощью CAS, генерации ошибки не происходит. Вместо этого отладочная информация записывается в Infolog. Используется в средах разработки и тестирования, чтобы определить, какие изменения требуется сделать для обеспечения работы системы.

Важно Важно

Не устанавливайте для caslevelзначение Traceв производственных средах.


Disableполностью отключает CAS.

Важно Важно

Не устанавливайте для caslevelзначение Disableв производственных средах.


Дополнительные сведения об обеспечении безопасности интерфейсов API см. в разделе Securing an API that Executes on the Server Tier.

MaxConcurrentUISessions,Text,< value>

- MaxConcurrentUISessions= < value>

Задает максимальное количество одновременных сеансов Microsoft Dynamics AX.

Минимальное значение равно 0, а максимальное значение (и значение по умолчанию) равно 65535.

Сведения об использовании этого параметра для настройки производительности AOS см. в разделе Настройка производительности Application Object Server.

MaxConcurrentGuestSessions,Text,< value>

- MaxConcurrentGuestSessions=< value>

Задает максимальное количество одновременных сеансов для пользователя "Гость" (анонимного пользователя).

Минимальное значение равняется 0, а максимальное значение (и значение по умолчанию) равняется 65535.

Сведения об использовании этого параметра для настройки производительности AOS см. в разделе Настройка производительности Application Object Server.

MaxConcurrentWebSessions,Text,< value>

- MaxConcurrentWebSessions= < value>

Задает максимальное количество одновременных сеансов для корпоративного портала, включая сеансы для пользователя "Гость".

Минимальное значение равняется 0, а максимальное значение (и значение по умолчанию) равняется 65535.

Сведения об использовании этого параметра для настройки производительности AOS см. в разделе Настройка производительности Application Object Server.

Сведения об использовании этого параметра для обеспечения безопасности системы см. в разделе Вопросы безопасности и рекомендации.

MaxConcurrentBCSessions,Text,< value>

- MaxConcurrentBCSessions= < value>

Задает максимальное количество одновременных сеансов для Business Connector, включая все веб-сеансы (все веб-сеансы осуществляются через Business Connector).

Значение по умолчанию — 65535.

Сведения об использовании этого параметра для настройки производительности AOS см. в разделе Настройка производительности Application Object Server.

MaxMemLoad,Text,< value>

- MaxMemLoad= < value>

Задает максимальный объем использования памяти (максимальный процент физической памяти, используемой на данном компьютере).

Значение по умолчанию — 0.

Сведения об использовании этого параметра для настройки производительности AOS см. в разделе Настройка производительности Application Object Server.

Сведения об использовании этого параметра для обеспечения безопасности системы см. в разделе Вопросы безопасности и рекомендации.

MaxConcurrentSessions,Int,< value>

- MaxConcurrentSessions=< value>

Максимальное число клиентских сеансов

Установите максимальное число клиентских сеансов, которое будет принимать этот экземпляр AOS.

Минимальное значение равняется 0, а максимальное значение (и значение по умолчанию) равняется 65535.

Loadbalance,Int,<0,1>

- LoadBalance=<0,1>

Сделать этот экземпляр AOS частью кластера для балансировки нагрузки

Установите этот экземпляр AOS, чтобы загрузить запросы связи клиента на балансировку с другими экземплярами AOS, у которых также активирована балансировка нагрузки.

startupcmd,Text,< command>

- startupCmd=< command>

Команда для выполнения запуска приложения

Введите метод SysStartupCmd, чтобы выполнить его при запуске клиентского приложения. Подробности см. в разделе Executing commands on startup.

extracmd,Text,< command>

- extracmd=< command>

Команда конфигурации для выполнения запуска ядра

Введите любую команду конфигурации для ее выполнения при запуске ядра.

Параметры подключения базы данных

В этой таблице описываются параметры, используемые для подключения базы данных.

Команда в файле конфигурации

Команда из командной строки

Параметр служебной программы настройки

Описание

createdsn,Text, < microsoftsqlserver, oracle>

createdsn=< microsoftsqlserver, oracle>

Параметр, недоступный в служебной программе

Создает источник данных в диспетчере ODBC.

dsn,text,< portnumber>

-dsn=< portnumber>

Параметр, недоступный в служебной программе

Указатель на конкретный источник данных.

database,Text,< databasename>

-database=< databasename>

База данных, к которой осуществляется подключение

Задает базу данных, к которой осуществляется подключение.

dbcli,Text,< ODBC, OCI>

- dbcli=< ODBC, OCI>

Параметр, недоступный в служебной программе

Запускает Microsoft Dynamics AX либо в режиме ODBC, либо в режиме OCI (Oracle). Режим ODBC используется по умолчанию.

dbserver,Text,< servername>

-dbserver=< servername>

Параметр, недоступный в служебной программе

Имя сервера SQL Server.

Параметры настройки базы данных

В этой таблице описываются параметры, которые могут использоваться для настройки производительности базы данных.

Команда в файле конфигурации

Команда из командной строки

Параметр служебной программы настройки

Описание

connectionidletimeout,Text,< 0,1>

-connectionidletimeout=< 0,1>

Оставить это подключение включенным во время простоя

Сохраняет подключение к базе данных, когда не происходит выполнения проводок.

connectionidletimeout,Text,< time>

-connectionidletimeout=< time>

Максимальное время простоя перед закрытием

Задает величину времени, в течение которого в случае простоя сохраняется подключение к базе данных, после которого осуществляется его закрытие.

fetchahead,Text,< number>

-fetchahead=< number>

Будущий выбор массива

Задает максимальное количество записей, которое система сможет выбирать одновременно. Начальное значение этого параметра для локального компьютера равняется 100.

hint,Text,1

-hint=< 0, 1>

Разрешить подсказки INDEX в запросах

Разрешает любому запросу, записанному с подсказкой INDEX, перезаписывать индекс, выбранный системой управления базой данных.

hint,Text,2

-hint=< 0, 2>

Включить операторы LTRIM во все операторы SELECT, чтобы удалить начальный пробел из столбцов, выравниваемых по правому краю

Добавляет операторы LTRIMво все запросы, создаваемые Microsoft Dynamics AX. Использование LTRIMувеличивает возможности базы данных по выполнению сканирования таблицы, работа с которой может замедлить получение результатов запроса. Значение 2 включает данную функцию, а 0 — отключает ее.

ignoredatasourceindex,Text,< 0,1>

-ignoredatasourceindex=< 0, 1>

Создать предложения ORDER BY из предложений WHERE

Установите значение 1, чтобы заменить порядок, определяемый индексом в источнике данных, используя порядок столбцов, заданный в предложении WHERE. Благодаря этому может повыситься быстродействие запроса.

newconnectionretrycount,Text,< number>

-newconnectionretrycount=< number>

Количество попыток подключения

Задает количество попыток подключения к базе данных, после выполнения которых будет генерироваться ошибка.

newconnectionretrydelayms,Text,< time>

-newconnectionretrydelayms=< time>

Интервал повторения попытки подключения

Задает интервал (в миллисекундах) между попытками подключения к базе данных.

opencursors,Text,< number>

-opencursors=< number>

Максимальное количество открытых курсоров

Задает максимальное количество курсоров базы данных, которые могут оставаться открытыми для повторного использования в подключении. Начальное значение этого параметра для локального компьютера равняется 90.

retry,Text,< time>

-retry=< time>

Интервал повторения проводок (в секундах)

Задает задержку перед повторным выполнением проводки после взаимоблокировки. Значение по умолчанию составляет 5 секунд.

sqlbuffer,Text,< number>

-sqlbuffer=< number>

Максимальный размер буфера

Задает максимальный размер буфера, используемого для получения данных. Чем больше этот буфер, тем большее количество записей может одновременно перемещаться. Начальное значение этого параметра для локального компьютера равняется 24.

sqlcomplexliterals,Text,< 0,1>

-sqlcomplexliterals=< 0,1>

Использовать литералы в сложных запросах join из X++

Определяет, что в Microsoft Dynamics AX используются литералы вместо параметров в сложных запросах join с целью оптимизации производительности системы.

sqlformliterals,Text, < 0,1>

-sqlformliterals=< 0, 1>

Использовать литералы в запросах join из форм и отчетов

Определяет, что в Microsoft Dynamics AX используются литералы вместо параметров в выполняемых продолжительное время запросах с целью оптимизации производительности системы.

Параметры трассировки

В этой таблице описываются параметры, которые могут использоваться для трассировки запросов между AOS, базой данных и клиентами.

Примечание Примечание

Каталог logdir, в котором хранятся файлы трассировки, не может быть изменен. Этим каталогом является каталог установки сервера directory\log.


Команда в файле конфигурации

Команда из командной строки

Параметр служебной программы настройки

Описание

TraceStart,Int,1

-TraceStart=

Запуск трассировки

Остановка трассировки

Определяет, должна ли быть запущена или остановлена трассировка:

0 — остановить трассировку

1 — запустить трассировку

Значение по умолчанию — 0.

traceeventsenabled,Text, < 1; 100; 101; 200; 201; 202; 203; 204; 205>

-TraceEventsEnabled=< 1; 100; 101; 200; 201; 202; 203; 204; 205>

См. ниже

Определяет типы событий, которые должны быть включены. Пользователь может включить несколько типов событий, используя точку с запятой (;) в качестве разделителя. Подробные описания см. ниже. Значение по умолчанию — 1.

traceeventsenabled,Text,1

-TraceEventsEnabled=1

Циклы передачи RPC на сервер

Трассировка всех циклов передачи удаленного вызова процедур (RPC) от клиента на сервер.

traceeventsenabled,Text,100

-TraceEventsEnabled=100

Вызовы методов X++

Трассировка всех методов X++, которые вызываются на сервере.

traceeventsenabled,Text,101

-TraceEventsEnabled=101

Вызовы функций

Трассировка всех вызовов функций, которые вызываются на сервере.

traceeventsenabled,Text,200

-TraceEventsEnabled=200

Подключение и отключение

Трассировка всех подключений и отключений AOS от базы данных.

traceeventsenabled,Text,201

-TraceEventsEnabled=201

Проводки: TTSBegin, TTSCommit, TTSAbort

Трассировка всех проводок, в которых используются операторы TTSBegin, TTSCommitи TTSAbort.

traceeventsenabled,Text,202

-TraceEventsEnabled=202

Операторы SQL

Трассировка всех операторов SQL, которые вызываются на сервере.

traceeventsenabled,Text,203

-TraceEventsEnabled=203

Переменные связывания

Трассировка всех столбцов, которые используются как входные переменные связывания.

Примечание Примечание

Чтобы включить этот параметр, необходимо включить операторы SQL (202)


traceeventsenabled,Text,204

-TraceEventsEnabled=204

Выборка строки

Трассировка всех строк, которые выбираются с использованием сервера SQL.

Примечание Примечание

Чтобы включить этот параметр, необходимо включить операторы SQL (202)


traceeventsenabled,Text,205

-TraceEventsEnabled=205

Сводка выборок строки (счетчик и время)

Счетчик всех строк, которые выбираются, и регистрация времени, затраченного на выборку.

Примечание Примечание

Чтобы включить этот параметр, необходимо включить операторы SQL (202)


tracexppmethodcalldepth,Text,< number>

-TraceXppMethodCallDepth=< number>

Число вложенных вызовов:

Задает максимальную глубину вызова, на которую будет осуществляться трассировка для методов X++.

Примечание Примечание

TraceEventsEnabledнеобходимо также установить на 100, чтобы использовать эту команду.


Значение по умолчанию — 3.

tracemaxfilesize,Text,< number>

-TraceMaxFileSize= < number>

Параметр, недоступный в служебной программе

Определяет максимальный размер каждого файла трассировки в мегабайтах (МБ).

Значение по умолчанию — 10 МБ.

tracebuffersize,Text,< number>

-TraceBufferSize= < 0:64>

Параметр, недоступный в служебной программе

Определяет размер буфера трассировки событий для Windows в килобайтах (КБ). Максимальный размер — 64 КБ.

Значение по умолчанию — 20 КБ.

traceallowclient,Int,1

-TraceAllowClient

Разрешить трассировку клиента на экземпляре Application Object Server

Это двоичная команда, которая не устанавливается по умолчанию. Определяет, разрешена ли трассировка клиента на этом экземпляре AOS.

Неизвестные параметры конфигурации

В файлах конфигурации, созданных системой Microsoft Dynamics AX, можно увидеть неизвестные параметры. Некоторые из них — это устаревшие параметры (параметры конфигурации из предыдущих версий), которые не используются. Другие параметры конфигурации остаются как в файле конфигурации клиента, так и сервера, хотя они применяются только для клиента или сервера, так как в предыдущих версиях продукта служебные программы были объединенными. Рекомендуется не изменять значения этих параметров — это может привести к непредсказуемым результатам.

Значение в файле конфигурации

Применимо к

company,Text,

Клиент

client,Text,thin

Устаревший параметр

application,Text,standard

Клиент

broadcast,Text,

Устаревший параметр

aol,Text,sys

Клиент

aolcode,Text,

Клиент

native,Int,0

Устаревший параметр

sqluser,Text,

Устаревший параметр

hassqlpwd,Int,0

Устаревший параметр

sqlpwd,Text,

Устаревший параметр

startupmsg,Text,

Клиент

localappldoc,Int,0

Устаревший параметр

localsysdoc,Int,0

Устаревший параметр

applshare,Int,0

Устаревший параметр

applexclusive,Int,1

Устаревший параметр

startupcmd,Text,test

Клиент

hascompwd,Int,0

Устаревший параметр

compwd,Text,

Устаревший параметр

allowunauth,Int,0

Устаревший параметр

windowsauth,Text,1

Устаревший параметр

aosencryption,Text,0

Клиент

xppdebug,Text,1

Устаревший параметр

ociuser,Text,

Устаревший параметр

hasocipwd,Int,0

Устаревший параметр

ocipwd,Text,

Устаревший параметр

dbunicodeenabled,Text,1

Устаревший параметр

См. также