Команды конфигурации устанавливают параметры, используемые при запуске экземпляра сервера 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. Используется в средах разработки и тестирования, чтобы определить, какие изменения требуется сделать для обеспечения работы системы.
Disableполностью отключает CAS.
Дополнительные сведения об обеспечении безопасности интерфейсов 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 в запросах |
Разрешает любому запросу, записанному с подсказкой
|
hint,Text,2 |
-hint=< 0, 2> |
Включить операторы LTRIM во все операторы SELECT, чтобы удалить начальный пробел из столбцов, выравниваемых по правому краю |
Добавляет операторы
|
ignoredatasourceindex,Text,< 0,1> |
-ignoredatasourceindex=< 0, 1> |
Создать предложения ORDER BY из предложений WHERE |
Установите значение 1, чтобы заменить порядок, определяемый
индексом в источнике данных, используя порядок столбцов, заданный в
предложении
|
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 |
Трассировка всех проводок, в которых используются операторы
|
||
traceeventsenabled,Text,202 |
-TraceEventsEnabled=202 |
Операторы SQL |
Трассировка всех операторов SQL, которые вызываются на сервере. |
||
traceeventsenabled,Text,203 |
-TraceEventsEnabled=203 |
Переменные связывания |
Трассировка всех столбцов, которые используются как входные переменные связывания.
|
||
traceeventsenabled,Text,204 |
-TraceEventsEnabled=204 |
Выборка строки |
Трассировка всех строк, которые выбираются с использованием сервера SQL.
|
||
traceeventsenabled,Text,205 |
-TraceEventsEnabled=205 |
Сводка выборок строки (счетчик и время) |
Счетчик всех строк, которые выбираются, и регистрация времени, затраченного на выборку.
|
||
tracexppmethodcalldepth,Text,< number> |
-TraceXppMethodCallDepth=< number> |
Число вложенных вызовов: |
Задает максимальную глубину вызова, на которую будет осуществляться трассировка для методов X++.
Значение по умолчанию — 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 |
Устаревший параметр |