Приложения к установке
Установка и конфигурирование PostgreSQL для Windows
Приведенные ниже инструкции предназначены для администратора PostgreSQL (не хост-серверы ДБ). Если в реализацию включен слой высокой доступности, см. раздел ThingWorx высокой доступности этого справочного центра.
Установка PostgreSQL и создание новой роли пользователя
1. Дополнительные сведения о поддерживаемых версиях PostgreSQL см. в разделе Требования к системе ThingWorx.
 |
В шагах этой процедуры используется PostgreSQL x.x, где x.x - поддерживаемая версия.
|
2. Загрузите и установите соответствующую версию PostgreSQL со следующего сайта: http://www.postgresql.org/download/.
3. Откройте PostgreSQL с помощью PgAdmin. Инструмент PgAdmin доступен в загрузке PostgreSQL.
|
|
PgAdmin - это инструмент управления с открытым исходным кодом для баз данных, входящий в загрузку PostgreSQL. Этот инструмент предлагает полную поддержку Юникода, быструю, многопоточную обработку запросов и инструменты редактирования, а также поддержку всех типов объектов PostgreSQL.
|
4. Создание нового пользователя.
a. Щелкните правой кнопкой мыши PostgreSQLx.x (<IP-адрес или наименование хост-компьютера базы данных>:<номер порта PostgreSQL>). Пример: PostgreSQLx.x(localhost:5432)
|
|
Далее в этом процессе этот пользователь именуется thingworxusername.
|
b. Выберите Create - Login/Group Role. На вкладке General в поле Name введите наименование роли пользователя PostgreSQL для администрирования PostgreSQL.
c. На вкладке Privileges выберите Yes для опции Can login?.
d. На вкладке Определение в поле Пароль введите уникальный надежный пароль для PostgreSQL.
5. Нажмите кнопку OK. Запишите наименование роли пользователя и пароль, созданные на этом шаге, для дальнейшего использования.
Конфигурирование базы данных PostgreSQL, расположенной на отдельном сервере, а не на сервере ThingWorx
|
|
Этот раздел является необязательным для среды разработки, но должен быть реализован во всех производственных средах.
|
По умолчанию сервер PostgreSQL устанавливается в заблокированном состоянии. Сервер будет прослушивать соединения только с локального компьютера. Чтобы ThingWorx взаимодействовал с сервером PostgreSQL, необходимо внести некоторые изменения в конфигурацию так, чтобы PostgreSQL знал о прослушивании соединений от других пользователей (пользователь ThingWorx, значение по умолчанию: twadmin) и/или от других компьютеров (ThingWorx, установленный на отдельном сервер).
Для выполнения этих шагов необходимо знать, где находится каталог данных PostgreSQL. Для Windows папка данных по умолчанию: C:\Program Files\PostgreSQL\x.x\data.
Измените файл pg_hba.conf и добавьте в зависимости от нужной конфигурации следующие строки:
|
Если нужно разрешить соединение со всех адресов IPv4:
|
host all all 0.0.0.0/0 md5
|
|
Если нужно разрешить подключение только с определенного адреса IPv4 (замените <ipAddress> IP-адресом компьютера, осуществляющего подключение):
|
host all all <ipAddress>/32 md5
|
|
Если нужно разрешить подключение со всех адресов IPv6:
|
host all all ::0/0 md5
|
|
Если нужно разрешить подключение только с определенного адреса IPv6 (замените <ipv6Address> соответствующим адресом):
|
host all all <ipv6Address>/128 md5
|
Возможна любая другая комбинация, если использовать дополнительные строки разрешений (для отдельных IP-адресов или их диапазонов) или маски подсети, соответствующие компьютерам, которым требуется доступ к базе данных PostgreSQL.
После любого изменения этого файла требуется перезапуск сервиса базы данных.
|
|
Дополнительные сведения о конфигурировании файла pg_hba.conf см. на веб-странице официальной документации PostgreSQL).
|
Конфигурирование и выполнение сценария базы данных PostgreSQL
Чтобы настроить базу данных и область таблицы PostgreSQL, необходимо сконфигурировать и выполнить сценарий thingworxPostgresDBSetup.bat.
|
|
После ThingWorx 9.3.1 создание папки ThingworxPostgresqlStorage или любые шаги, связанные с параметром -l, больше не требуются, и данные ThingWorx будут сохраняться в расположении Postgresql по умолчанию.
|
1. Добавьте папку <папка-установки-postgres>/bin в системную переменную PATH.
2. Получите thingworxPostgresDBSetup.bat из пакета загрузки программного обеспечения ThingWorx и откройте его. Загрузки ThingWorx доступны на веб-странице PTC Software Downloads (Загрузки программного обеспечения PTC). Этот сценарий находится в папке install.
3. Если необходимо, сконфигурируйте сценарий. Используйте опции из приведенной ниже таблицы.
|
Опция
|
Параметр
|
По умолчанию
|
Описание
|
Пример
|
||
|---|---|---|---|---|---|---|
|
t или -T
|
tablespace
|
thingworx
|
Наименование области таблицы
|
-t thingworx
|
||
|
-p или -P
|
port
|
5432
|
Номер порта PostgreSQL
|
-p 5432
|
||
|
-d или -D
|
database
|
thingworx
|
Наименование создаваемой базы данных PostgreSQL
|
-d thingworx
|
||
|
-l или -L
|
tablespace_location
|
/ThingworxPostgresqlStorage
|
Требуется в ThingWorx 9.3.0 и предыдущих версиях. Расположение в файловой системе, где хранятся файлы, представляющие объекты базы данных. Перед выполнением сценария пользователю необходимо создать эту папку вручную с разрешениями, а затем указать путь, например : -l :\ThingworxPostgresqlStorage.
|
-l или -L
|
||
|
-h или -H
|
host
|
localhost
|
Имя хост-компьютера.
|
-h localhost
|
||
|
-a или -A
|
adminusername
|
postgres
|
Имя администратора
|
-a postgres
|
||
|
-u или -U
|
thingworxusername
|
twadmin
|
Имя пользователя, имеющего разрешения на запись в базу данных.
|
-u twadmin
|
4. Выполните сценарий.
Конфигурирование и выполнение сценария схемы поставщика моделей/данных
Чтобы настроить схему поставщика моделей/данных PostgreSQL, необходимо сконфигурировать и выполнить сценарий thingworxPostgresSchemaSetup.bat. Это позволит настроить общедоступную схему в вашей базе данных для экземпляра PostgreSQL, установленного на локальном компьютере localhost.
1. Получите сценарий thingworxPostgresSchemaSetup.bat из пакета загрузки программного обеспечения ThingWorx в папке install. Загрузки ThingWorx доступны на веб-странице PTC Software Downloads (Загрузки программного обеспечения PTC).
2. Если необходимо, сконфигурируйте сценарий. Используйте опции из приведенной ниже таблицы.
|
Опция
|
Параметр
|
По умолчанию
|
Описание
|
Пример
|
||
|---|---|---|---|---|---|---|
|
-h или -H
|
host
|
localhost
|
IP-адрес или наименование хост-компьютера базы данных.
|
-h localhost
|
||
|
-p или -P
|
port
|
5432
|
Номер порта PostgreSQL.
|
-p 5432
|
||
|
-d или -D
|
database
|
thingworx
|
Наименование базы данных, которую необходимо использовать.
|
-d thingworx
|
||
|
-s или -S
|
schema
|
public
|
Наименование схемы, которую необходимо использовать.
|
-s myschema
|
||
|
-u или -U
|
username
|
twadmin
|
Имя пользователя для обновления схемы базы данных
|
-u twadmin
|
||
|
-o или -O
|
опция
|
all
|
Имеются три опции.
• all - настройка схем поставщиков моделей и данных в указанной базе данных.
• model - настройка схемы поставщика моделей в указанной базе данных.
• data - настройка схемы поставщика данных в указанной базе данных.
|
-o data
|
3. Выполните сценарий.
Конфигурирование файла platform-settings.json
1. Откройте файл platform-settings.json, расположенный в папке ThingworxPlatform.
2. Найдите опции конфигурации PostgresPersistenceProviderPackage в разделе Сведения о конфигурации platform-settings.json и добавьте их в файл platform-settings.json.
|
|
Если сервер PostgreSQL не совпадает с сервером ThingWorx, то при возникновении проблем, связанных с установкой ThingWorx, просмотрите журналы Tomcat и файл platform-settings.json. При стандартной установке предполагается, что оба сервера находятся на одном и том же компьютере.
|
(Необязательно) Шифрование пароля PostgreSQL
Зашифруйте пароль, выполнив шаги, описанные в разделе Шифрование паролей.
(Необязательно) Установка пакета клиента PostgreSQL и пользователя PostgreSQL
Чтобы выполнить команды PostgreSQL на компьютере клиента для сервера PostgreSQL, выполняйте их от имени пользователя PostgreSQL. Пакет postgresql-client-x.x можно установить на клиентском компьютере. Инструкции по установке см. в документации по дистрибутиву PostgreSQL. Этот пакет содержит некоторые инструменты администрирования, такие как psql.