Настройки PostgreSQL
PostgreSQL
Образцы файлов Docker Compose для PostgreSQL включены в файлы Docker, которые можно загрузить из раздела ThingWorx Platform на сайте загрузки ПО PTC.
 |
Для начальной памяти задано значение 2 ГБ, а максимальный объем равен 4 ГБ. Том монтируется согласно файлам docker-compose. Это расположение, в котором сохраняются файлы журналов и конфигурации, чтобы включить постоянное сохранение в контейнерах.
|
Чтобы управлять конфигурацией этого экземпляра, можно добавить в раздел environment сервиса платформы следующие опции:
|
Имена переменных
|
Значения
|
Значения по умолчанию
|
Комментарии
|
||
|---|---|---|---|---|---|
|
DATABASE_HOST
|
Строка
|
postgresql
|
Указывает имя хост-компьютера, имя сервиса или IP-адрес хоста базы данных PostgreSQL.
|
||
|
DATABASE_PORT
|
Число
|
5432
|
Указывает номер порта для базы данных PostgreSQL.
|
||
|
DATABASE_ADMIN_USERNAME
|
Строка
|
postgres
|
Указывает имя администратора для базы данных PostgreSQL.
|
||
|
DATABASE_ADMIN_PASSWORD
|
Строка
|
PASSWORD
|
Указывает пароль администратора для базы данных PostgreSQL.
|
||
|
DB_TYPE
|
Строка
|
postgres
|
Указывает наименование поставщика хранилища данных по умолчанию. Примечание. Эта переменная не поддерживается в ThingWorx 9.3.0 и более поздних версий.
|
||
|
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 эту переменную необходимо задать вручную. Обратите внимание, что для PostgreSQL TWX_DATABASE_USERNAME:
• Должно соответствовать TWX_DATABASE_SCHEMA из-за ограничений существующей реализации
• Не должно быть postgres
|
||
|
TWX_DATABASE_PASSWORD
|
Строка
|
""
|
Указывает пароль пользователя ThingWorx для базы данных. Перед запуском ThingWorx Platform эту переменную необходимо задать вручную.
|
||
|
TWX_DATABASE_SCHEMA
|
Строка
|
""
|
Указывает наименование схемы для экземпляра ThingWorx. Перед запуском ThingWorx Platform эту переменную необходимо задать вручную. Обратите внимание, что для PostgreSQL TWX_DATABASE_USERNAME должно соответствовать TWX_DATABASE_SCHEMA из-за ограничений существующей реализации.
|
||
|
TABLESPACE_LOCATION
|
Строка
|
/ThingworxPostgresqlStorage
|
Указывает расположение табличного пространства на сервере базы данных.
|
||
|
IS_RDS
|
yes/no
|
no
|
Переключает опцию для соединения с базой данных RDS PostgreSQL.
|
||
|
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 для использования с преобразованием свойства.
|
||
|
POSTGRES_USER
|
Строка
|
""
|
Указывает имя администратора для базы данных PostgreSQL.
|
||
|
POSTGRES_PASSWORD
|
Строка
|
""
|
Указывает пароль администратора для базы данных PostgreSQL.
|
||
|
POSTGRES_DB
|
Строка
|
""
|
Указывает имя базы данных PostgreSQL.
Дополнительные переменные для PostgreSQL и подробные сведения о них можно найти в документе Docker Hub (Концентратор Docker) (на английском языке).
|
||
|
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"
|
|
При изменении пути к тому изменяйте только локальное монтирование, поскольку точки монтирования внутреннего контейнера никогда не изменяются.
|
Для простоты тестирования предоставляется образ PostgreSQL Docker. Не используйте образ PostgreSQL Docker, предоставленный для использования в производстве. Оптимальным будет настроить для производства собственную среду PostgreSQL.
Чтобы соединиться с базой данных PostgreSQL, содержащейся вне Docker, удалите сервис postgresql из файла Compose и добавьте следующие переменные в переменные среды platform:
• DATABASE_ADMIN_USERNAME
• DATABASE_ADMIN_PASSWORD
Это учетные записи администратора в базе данных PostgreSQL, авторизованные для создания пользователя, базы данных или схемы, которые контейнер ThingWorx загружает при первом запуске. См. в разделе Использование внешней базы данных PostgreSQL для ThingWorx Docker пример файла Compose с настройкой платформы для использования внешней базы данных.
При использовании внешней базы данных можно вручную установить схему ThingWorx как обычно и не предоставлять учетные данные администратора для контейнера ThingWorx Docker. Для этого задайте соответствующие переменные DATABASE_HOST, DATABASE_PORT, TWX_DATABASE_USERNAME, TWX_DATABASE_PASSWORD и TWX_DATABASE_SCHEMA.