Настройки Microsoft SQL Server
Примеры файлов Docker Compose для Microsoft SQL Server включены в файлы Docker, которые можно загрузить из раздела ThingWorx Platform сайта загрузки ПО PTC.
 |
Для начальной памяти задано значение 2 ГБ, а максимальный объем равен 4 ГБ. Том монтируется согласно файлам docker-compose. Это расположение, в котором сохраняются файлы журналов и конфигурации, чтобы включить постоянное сохранение в контейнерах.
|
Чтобы управлять конфигурацией этого экземпляра, можно добавить в раздел environment сервиса платформы следующие опции:
|
Имена переменных
|
Значения
|
Значения по умолчанию
|
Комментарии
|
||
|---|---|---|---|---|---|
|
DATABASE_HOST
|
Строка
|
mssql
|
Указывает имя хост-компьютера, имя сервиса или IP-адрес хоста базы данных сервера SQL.
|
||
|
DATABASE_PORT
|
Число
|
1433
|
Указывает номер порта для базы данных сервера SQL.
|
||
|
DATABASE_ADMIN_USERNAME
|
Строка
|
SA
|
Определяет имя администратора для базы данных сервера SQL. Для успешного создания контейнера необходимо использовать предоставленное значение по умолчанию.
|
||
|
DATABASE_ADMIN_PASSWORD
|
Строка
|
PASSWORD
|
Определяет пароль администратора для базы данных сервера SQL. Значения для DATABASE_ADMIN_PASSWORD и SA_PASSWORD должны совпадать.
|
||
|
DB_TYPE
|
Строка
|
mssql
|
Указывает наименование поставщика хранилища данных по умолчанию. Примечание. Эта переменная не поддерживается в ThingWorx 9.3.0 и более поздних версий.
|
||
|
SA_PASSWORD
|
Строка
|
PASSWORD
|
Указывает пароль SA. Значения для DATABASE_ADMIN_PASSWORD и SA_PASSWORD должны совпадать.
|
||
|
ENABLE_HTTP
|
true/false
|
true
|
Включает соединитель HTTP на Tomcat для небезопасного трафика в контейнер.
|
||
|
ENABLE_HTTPS
|
true/false
|
false
|
Включает соединитель HTTPS на Tomcat для защищенного трафика в контейнер. Необходимо также указать хранилище ключей и задать SSL_KEYSTORE_PASSWORD.
|
||
|
SSL_KEYSTORE_PASSWORD
|
Строка
|
PASSWORD
|
Указывает пароль для хранилища ключей, используемого для SSL-соединения в Tomcat.
|
||
|
SSL_KEYSTORE_BASE_PATH
|
Строка
|
/ThingworxPlatform
|
Указывает путь к хранилищу ключей SSL. Если вы сохраняете хранилище ключей в расположении в контейнере, отличном от папки по умолчанию, необходимо задать эту переменную.
|
||
|
SSL_KEYSTORE_FILENAME
|
Строка
|
keystore.jks
|
Указывает имя файла для хранилища ключей SSL Tomcat. Если хранилище ключей имеет имя файла, отличное от значения по умолчанию, необходимо задать эту переменную.
|
||
|
TOMCAT_SSL_PROTOCOLS
|
Строка
|
TLSv1.2
|
Определяет протокол SSL для Tomcat. Задайте это значение, если требуется переопределить принятые протоколы SSL в Tomcat.
|
||
|
SERVER_HTTP_PORT
|
Строка
|
8080
|
Указывает порт, который Tomcat отслеживает при связи по протоколу HTTP. Обратите внимание, что при изменении этого порта необходимо изменить предоставленные порты в файле Compose.
|
||
|
SERVER_HTTPS_PORT
|
Строка
|
8443
|
Указывает порт, который Tomcat отслеживает при связи по протоколу HTTPS. Обратите внимание, что при изменении этого порта необходимо изменить предоставленные порты в файле Compose.
|
||
|
DOCKER_DEBUG
|
true/false
|
false
|
Переключает опцию для записи отладочной информации при запуске контейнера. Учтите, что здесь может содержаться конфиденциальная информация.
|
||
|
TWX_DATABASE_USERNAME
|
Строка
|
""
|
Указывает пользователя ThingWorx, который будет создан для базы данных. Перед запуском ThingWorx Platform эту переменную необходимо задать вручную.
|
||
|
TWX_DATABASE_PASSWORD
|
Строка
|
""
|
Указывает пароль пользователя ThingWorx для базы данных. Перед запуском ThingWorx Platform эту переменную необходимо задать вручную.
|
||
|
TWX_DATABASE_SCHEMA
|
Строка
|
""
|
Указывает наименование схемы для экземпляра ThingWorx. Перед запуском ThingWorx Platform эту переменную необходимо задать вручную.
|
||
|
LS_USERNAME
|
Строка
|
""
|
Указывает имя пользователя для входа в систему PTC для получения лицензии ThingWorx.
|
||
|
LS_PASSWORD
|
Строка
|
""
|
Указывает пароль для входа в систему PTC для получения лицензии ThingWorx.
|
||
|
ENABLE_BACKUP
|
true/false
|
false
|
Переключает опцию резервного копирования.
|
||
|
ENABLE_LOGGING
|
true/false
|
true
|
Переключает опцию ведения журнала.
|
||
|
ENCRYPT_CREDENTIALS
|
true/false
|
false
|
Переключает опцию шифрования паролей для баз данных и лицензирования в файле platform-settings.json.
|
||
|
THINGWORX_INITIAL_ADMIN_PASSWORD
|
Строка
|
""
|
Задает начальный пароль администратора в ThingWorx. Перед запуском ThingWorx Platform эту переменную необходимо задать вручную. Этот пароль можно изменить после успешного запуска ThingWorx.
|
||
|
THINGWORX_INITIAL_METRICS_USER_PASSWORD
|
Строка
|
""
|
Задает начальный пароль для MetricsUser в ThingWorx. Это необязательная переменная. Задавайте ее вручную перед запуском ThingWorx Platform. Этот пароль можно изменить после успешного запуска ThingWorx.
|
||
|
EXTPKG_IMPORT_POLICY_ENABLED
|
true/false
|
false
|
Управляет глобальным включением/выключением импорта пакета расширений через загрузчик пакета расширений.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_JARRES
|
true/false
|
false
|
Управляет разрешениями импорта для пакетов расширений, содержащих ресурсы Jar (Java). Если задано false, а расширение содержит jar-файлы, будет возникать сбой импорта.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_JSRES
|
true/false
|
false
|
Управляет разрешениями импорта для пакетов расширений, содержащих ресурсы JavaScript. Если задано false, а расширение содержит файлы javascript, будет возникать сбой импорта.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_CSSRES
|
true/false
|
false
|
Управляет разрешениями импорта для пакетов расширений, содержащих ресурсы CSS. Если задано false, а расширение содержит файлы css, будет возникать сбой импорта.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_JSONRES
|
true/false
|
false
|
Управляет разрешениями импорта для пакетов расширений, содержащих ресурсы JSON. Если задано false, а расширение содержит файлы json, будет возникать сбой импорта.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_WEBAPPRES
|
true/false
|
false
|
Управляет разрешениями импорта для пакетов расширений, содержащих ресурсы веб-приложений. Если задано false, а расширение содержит файлы ресурсов WebApp, будет возникать сбой импорта.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_ENTITIES
|
true/false
|
false
|
Управляет разрешениями импорта для пакетов расширений, которые содержат определения нерасширяемых сущностей. Если задано false, а расширение содержит нерасширяемые определения объектов, отличных от объектов пакета расширений, будет возникать сбой импорта.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_EXTENTITIES
|
true/false
|
false
|
Управляет разрешениями импорта для пакетов расширений, которые содержат определения расширяемых сущностей. Если задано false, а расширение содержит определения расширяемых сущностей, отличных от сущности пакета расширения, будет возникать сбой импорта.
|
||
|
ENABLE_CONSOLE_OUTPUT
|
true/false
|
false
|
Включить ведение журнала консоли.
|
||
|
ENABLE_CLUSTERED_MODE
|
true/false
|
false
|
Задайте значение true, чтобы включить режим кластеризации.
|
||
|
HTTP_PORT
|
Число
|
Null
|
Порт, используемый для HTTP-соединения, должен соответствовать порту SERVER_HTTP_PORT. Используется для обнаружения сервисов.
|
||
|
HTTP_SERVICE_NAME
|
Строка
|
thingworx-http
|
Наименование сервиса HTTP для ThingWorx Platform. Используется для обнаружения сервисов.
|
||
|
HTTPS_PORT
|
Число
|
Null
|
Порт, используемый для HTTPS-соединения, должен соответствовать SERVER_HTTPS_PORT. Используется для обнаружения сервисов.
|
||
|
HTTPS_SERVICE_NAME
|
Строка
|
thingworx-https
|
Наименование сервиса HTTPS для ThingWorx Platform. Используется для обнаружения сервисов.
|
||
|
TOMCAT_SSL_CIPHERS
|
Строка
|
""
|
Необязательный список разделенных запятыми наборов шифров. Ограничивает HTTPS-соединения только этими шифрами. Если ничего не задать, используются шифры JVM по умолчанию.
|
||
|
TOMCAT_COMPRESSION
|
on/off/force
|
off
|
Включает или выключает сжатие Tomcat. Соединители могут использовать сжатие НТТР/1.1 GZIP для экономии полочы пропускания сервера. Приемлемые значения включают off (отключить сжатие), on (разрешить сжатие - сжатие текстовых данных) и force (принудительное сжатие во всех случаях).
|
||
|
TOMCAT_COMPRESSION_MIN_SIZE
|
Число
|
2048
|
Задает минимальный объем данных перед сжатием выходных данных, когда TOMCAT_COMPRESSION имеет значение on.
|
||
|
TOMCAT_USE_SEND_FILE
|
true/false
|
true
|
Включает или выключает возможность sendfile. Использование возможности sendfile отключает любое сжатие, которое в противном случае Tomcat может выполнять в ответе.
|
||
|
COORDINATOR_HOSTS
|
Строка
|
""
|
Разделенный запятыми список конечных точек Zookeeper. Каждая конечная точка имеет вид _host_:_port_.
|
||
|
IGNITE_ZK_CONNECTION
|
Строка
|
""
|
Хост-компьютер и порт Zookeeper, используемые для обнаружения сервисов.
|
||
|
ZK_SSL_ENABLED
|
true/false
|
false
|
Включает SSL для Zookeeper.
|
||
|
ZK_SSL_KEYSTORE_LOCATION
|
Строка
|
/certs/zookeeper.p12
|
Путь к хранилищу ключей Zookeeper.
|
||
|
ZK_SSL_KEYSTORE_PASSWORD
|
Строка
|
""
|
Пароль для хранилища ключей Zookeeper.
|
||
|
ZK_SSL_TRUSTSTORE_LOCATION
|
Строка
|
""
|
Путь для хранилища доверия Zookeeper.
|
||
|
ZK_SSL_TRUSTSTORE_PASSWORD
|
Строка
|
""
|
Пароль для хранилища ключей Zookeeper.
|
||
|
CATALINA_OPTS
|
Строка
|
""
|
Опции Java времени выполнения, переданные в Tomcat.
|
||
|
DATABASE_ADMIN_SCHEMA
|
Строка
|
postgres
|
Наименование схемы по умолчанию на сервере БД.
|
||
|
TWX_KEYSTORE_PASSWORD
|
Строка
|
""
|
Пароль, который используется для задания пароля хранилища ключей ThingWorx. Если не задан, ThingWorx создает случайный пароль при первой загрузке.
Задайте этот пароль, чтобы гарантировать использование определенного пароля для настроек высокой доступности, и для восстановления старых данных/томов.
|
||
|
SECRET_CX_APP_KEY
|
Строка
|
""
|
Ключ приложения, который будет использоваться сервером соединений для соединения с ThingWorx
|
||
|
SECRET_PROVISIONING_APP_KEY
|
Строка
|
""
|
Ключ приложения, используемый для подготовки ThingWorx при первом запуске.
|
||
|
EXTPKG_IMPORT_POLICY_HA_COMPATIBILITY_LEVEL
|
WARN/DENY
|
WARN
|
Конфигурация политики импорта расширения, которая управляет разрешением или запретом расширений, совместимых с HA. Опции: WARN или DENY.
Если задано значение WARN, расширения, несовместимые с высокой доступностью, будут импортироваться с предупреждением, записанным в журнал приложения.
Если задано значение DENY, разрешен импорт только расширений,совместимых с высокой доступностью.
|
||
|
ENABLE_PROPERTY_TRANSFORM
|
true/false
|
false
|
Задайте значение true, чтобы разрешить преобразование свойства.
|
||
|
PROPERTY_TRANSFORM_RABBITMQ_HOST
|
""
|
localhost
|
Хост-компьютер RabbitMQ для использования с преобразованием свойства.
|
||
|
PROPERTY_TRANSFORM_RABBITMQ_PORT
|
Строка
|
5672
|
Порт RabbitMQ для использования с преобразованием свойства.
|
||
|
PROPERTY_TRANSFORM_RABBITMQ_USERNAME
|
Строка
|
admin
|
Имя пользователя RabbitMQ для использования с преобразованием свойства.
|
||
|
PROPERTY_TRANSFORM_RABBITMQ_PASSWORD
|
Строка
|
""
|
Пароль RabbitMQ для использования с преобразованием свойства.
|
||
|
PROPERTY_TRANSFORM_RABBITMQ_VHOST
|
Строка
|
/
|
RabbitMQ Vhost для использования с преобразованием свойства.
|
||
|
IGNITE_SSL_ACTIVE
|
true/false
|
false
|
Включает SSL для Ignite.
|
||
|
IGNITE_KEYSTORE_FILE_PATH
|
Строка
|
/certs/ignite.pfx
|
Путь к хранилищк ключей Ignite.
|
||
|
IGNITE_KEYSTORE_PASSWORD
|
Строка
|
""
|
Пароль для хранилища ключей Ignite.
|
||
|
ZK_SASL_ENABLED
|
true/false
|
false
|
Включить аутентификацию SASL в Zookeeper.
|
||
|
ZK_SASL_SECURITY_AUTH_LOGIN_CONFIG
|
Строка
|
/tmp1/jaas.conf
|
Путь к файлу конфигурации JAAS.
|
||
|
ZK_SASL_SECURITY_KRB5_CONF
|
Строка
|
/tmp1/krb5.conf
|
Путь к файлу конфигурации Kerberos.
|
||
|
AKKA_SSL_ENABLED
|
true/false
|
true
|
Включение/выключение связи Akka tls.
|
||
|
AKKA_KEYSTORE
|
Строка
|
/certs/keystore.jks
|
Хранилище ключей Akka может быть сохранено в томе certs. Например, /certs/keystore.jks.
|
||
|
AKKA_TRUSTSTORE
|
Строка
|
/certs/truststore.jks
|
Хранилище доверия Akka может быть сохранено в томе certs. Например, /certs/truststore.jks.
|
||
|
AKKA_KEYSTORE_PASSWORD
|
Строка
|
Значение по умолчанию не задано.
|
Пароль для AKKA_KEYSTORE.
|
||
|
AKKA_TRUSTSTORE_PASSWORD
|
Строка
|
Значение по умолчанию не задано.
|
Пароль для AKKA_TRUSTSTORE.
|
Можно также изменить путь к тому на расположение, определенное для сайта. Путь к тому использует следующий синтаксис:
"./path_to_local_mount:/path_to_container_mount"
Например:
"/opt/ThingworxPlatform:/ThingworxPlatform"
|
|
При изменении пути к тому изменяйте только локальное монтирование, поскольку точки монтирования внутреннего контейнера никогда не изменяются.
|
Для простоты тестирования предоставляется образ сервера MS SQL Server Docker. Не используйте образ MS SQL Server Docker, предоставленный для производственного использования. Оптимальным методом будет настроить для производства собственную среду MS SQL Server.
Чтобы соединиться с базой данных Microsoft SQL Server, которая существует вне Docker, удалите сервис mssql из файла Compose и добавьте следующие переменные в переменные среды platform:
• DATABASE_ADMIN_USERNAME
• DATABASE_ADMIN_PASSWORD
Это учетные записи администратора в базе данных Microsoft SQL Server, авторизованные для создания пользователя, базы данных или схемы, которые контейнер ThingWorx загружает при первом запуске. См. в разделе Использование внешней базы данных Microsoft SQL Server для ThingWorx Docker пример файла Compose с настройкой платформы для использования внешней базы данных Microsoft SQL Server.
При использовании внешней базы данных можно вручную установить схему ThingWorx и не предоставлять учетные данные администратора для контейнера ThingWorx Docker. Для этого задайте соответствующие переменные DATABASE_HOST, DATABASE_PORT, TWX_DATABASE_USERNAME, TWX_DATABASE_PASSWORD и TWX_DATABASE_SCHEMA.