A. Предварительные требования для установщика Windows с PostgreSQL
| Не рекомендуется использовать пробелы в именах файлов установщика ThingWorx. Установщик ThingWorx может столкнуться с проблемами при попытке установить ThingWorx, если путь к файлу содержит пробелы. Если необходимо использовать пробелы, администраторы должны включить в Windows поддержку формата 8dot3. |
• Для выполнения установщика ThingWorx Foundation для Windows с PostgreSQL необходимы следующие условия. Дополнительные сведения о поддерживаемых версиях см. в разделе
Требования к системе.
◦ Установлена версия Java 11
| Java 11 требуется для вкрсий 9.2.0 и более поздних. • Задайте переменную JAVA_HOME для использования каталога установки Java 11. |
◦ Windows с административным доступом
◦ База данных ThingWorx, сконфигурированная с разрешенными соединениями и заданной кодировкой UTF-8
▪ Для свойства базы данных Connection_LIMIT должно быть задано значение -1, которое является значением по умолчанию и разрешает неограниченные соединения с базой данных для всех аутентифицированных пользователей.
◦ Пользователь базы данных, настроенный как владелец базы данных ThingWorx следующим образом:
▪ Этому пользователю предоставлены все права в базе данных ThingWorx.
▪ Для свойства can loginзадано значение yes.
Этот пользователь базы данных будет введен в установщик как пользователь базы данных ThingWorx.
◦ Локальное или удаленное соединение с базой данных. В следующей таблице перечислены применимые предварительные условия.
Соединение с базой данных | Предварительные требования |
---|
Локальный | • База данных PostgreSQL должна быть установлена, а путь к PostgreSQL/bin должен быть указан в переменной среды PATH. • Необходимо установить Java JDK Убедитесь, что папка java/bin указана в переменной среды PATH. • Необходимо разрешить соединения хост-компьютера ThingWorx Foundation с PostgreSQL, обновив файл pg_hba.conf. Например, если приложение ThingWorx Foundation установлено на том же хост-компьютере, что и PostgreSQL, можно обновить файл pg_hba.conf, чтобы задать для метода аутентификации с паролем значение md5, password или trust. Однако не рекомендуется задавать для него значение trust. Дополнительные сведения о файле pg_hba.conf и методах аутентификации с паролем см. на веб-сайте PostgreSQL.org. Ниже приведен пример файла pg_hba.conf с настройкой аутентификацией с паролем md5: $ Edit pg_hba.conf for following: ... # "local" is for Unix domain socket connections only local all all md5 # IPv4 local connections: host all all 127.0.0.1/32 md5 # IPv6 local connections: host all all ::1/128 md5 |
Удаленный | • Установите клиент psql, совместимый с вашей версией PostgreSQL. • Добавьте установленный клиент psql в переменную PATH среды. Можно выполнить следующие шаги. b. Установите клиент pgadmin. c. Обновите переменную PATH среды, чтобы добавить путь к расположению, в котором установлен клиент pgadmin. |
B. Предварительные требования для установщика Windows с SQL Server
| Не рекомендуется использовать пробелы в именах файлов установщика ThingWorx. Установщик ThingWorx может столкнуться с проблемами при попытке установить ThingWorx, если путь к файлу содержит пробелы. Если необходимо использовать пробелы, администраторы должны включить в Windows поддержку формата 8dot3. |
Для выполнения установщика ThingWorx Foundation для Windows с Microsoft SQL Server необходимы следующие условия. Дополнительные сведения о поддерживаемых версиях см. в разделе
Требования к системе.
• Установлена версия Java 11
| Java 11 требуется для вкрсий 9.2.0 и более поздних. • Задайте переменную JAVA_HOME для использования каталога установки Java 11. |
• Windows с административным доступом
• База данных ThingWorx сконфигурирована со следующими настройками:
◦ Задайте для свойства Collate значение Latin1_General_100_CS_AS_SC.
◦ Задайте для следующих свойств значение ON:
▪ READ_COMMITTED_SNAPSHOT
▪ ALLOW_SNAPSHOT_ISOLATION
• Имя пользователя для Microsoft SQL Server с аутентификацией SQL Server.
Пароль для этого имени является паролем для входа в базу данных.
◦ Пользователь базы данных с этим именем, настроенный как владелец и в общей роли.
Этот пользователь должен иметь схему по умолчанию dbo, схему владения db_owner и быть участником схемы db_owner.
• Локальное или удаленное соединение с базой данных. В следующей таблице перечислены применимые предварительные условия.
Соединение с базой данных | Предварительные требования |
---|
Локальный | • Хост-компьютер, на котором устанавливается ThingWorx Foundation, должен иметь доступ к Microsoft SQL Server. • Допустимый клиент Microsoft SQL (sqlcmd) должен быть установлен и доступен в переменной PATH среды. • Необходимо установить Java JDK. Путь к java/bin указан в переменной среды PATH. |
Удаленный | • Приложение sqlcmd установлено и указано в переменной среды PATH. |
C. Предварительные требования для включения SSL/TLS в программе установки: создание хранилища ключей
На экране Свойства ThingWorx Foundation в установщике флажок Использовать SSL/TLS для безопасного соединения установлен по умолчанию. Чтобы отключить использование SSL/TLS в установщике, снимите этот флажок. Если выбрано сохранение настройки по умолчанию и использование SSL/TLS, необходимо сгенерировать файл хранилища ключей Java (.jks) перед запуском установщика. Для файла хранилища ключей Java (.jks) необходимо наличие следующих разрешений безопасности.
• Для файла хранилища ключей необходимо наличие разрешений Read и Read & Execute, предоставленных профилю пользователя Network Service для Windows.
Существует несколько способов создания хранилища ключей; один из них следующий:
1. Перейдите в папку Java/bin.
2. Чтобы создать файл хранилища ключей Tomcat (файл .jks), выполните следующую команду: keytool -genkey -alias selfsigned -keyalg RSA -keystore keyStore.jks -keysize 2048 -storetype jks.
3. Введите пароль для хранилища ключей. Этот пароль потребуется позже для конфигурирования сервера.
| Пароль не может содержать одинарные (') и двойные кавычки (") либо быть заключен в них или знаки параграфа (§). |
4. По запросу введите доменное имя для сервера. Например, myserver.mycompany.com.
5. Введите другие значения, такие как подразделение и организация.
6. По запросу введите пароль хранилища ключей.
D. Установка ThingWorx Foundation в Windows
1. Убедитесь, что соблюдены предварительные требования, описанные в приведенных выше разделах.
2. Для PostgreSQL на сайте
support.ptc.com в разделе > > > > > загрузите файл
ThingWorx-Platform-Foundation-Installer-x–x-x-Windows-postgres.
ИЛИ
Для Microsoft SQL Server на сайте
support.ptc.com в разделе > > > > > загрузите файл
ThingWorx-Platform-Foundation-Installer-x–x-x-Windows-mssql.
3. Извлеките сборку.
4. Для PostgreSQL выполните ThingWorxFoundationPostgres-9.x.x-x64.exe.
ИЛИ
Для Microsoft SQL Server выполните ThingWorxFoundationMSSQL-9-x64.exe.
5. Выполните инструкции, приведенные на пошаговых экранах установщика.
| На экране Свойства ThingWorx Foundation флажок Использовать SSL/TLS для безопасного соединения установлен по умолчанию. Чтобы отключить использование SSL/TLS в установщике, снимите этот флажок. Если выбрано использование SSL/TLS, введите значения хранилища ключей, такие как созданные в приведенных выше предварительных условиях. |
6. На последнем экране программы установки флажок Open License Configurator установлен по умолчанию. Если этот флажок установлен, после завершения и закрытия программы установки откроется конфигуратор лицензий. Если флажок Open License Configurator снят, конфигуратор лицензий не откроется автоматически после закрытия установщика.
a. Щелкните Next на экране Setup : Configure licensing for ThingworxFoundation for Postgres или Setup : Configure licensing for ThingworxFoundation for Mssql.
b. Используйте конфигуратор лицензий для соединения с сервером лицензий PTC или сконфигурируйте ThingWorx Foundation для использования предварительно загруженной лицензии.
c. Выполните инструкции, приведенные на пошаговых экранах лицензирования.
7. Установка ThingWorx Foundation завершена.
E. Соединение с сервером ThingWorx Foundation
1. Перейдите по URL-адресу ThingWorx Foundation.
Например: https://<имя_хоста>:<порт>/Thingworx/Composer.
URL-адрес ThingWorx Foundation может отличаться в зависимости от вашей конфигурации SSL или не-SSL и портов, используемых во время настройки. Протокол SSL включен по умолчанию; однако вы можете отключить использование SSL/TLS. См. выше раздел Предварительные условия для включения SSL/TLS в установщике.
2. Укажите учетные данные пользователя.
Укажите имя пользователя: Administrator и укажите пароль, введенный во время настройки.
F. Дополнительные функции программы установки и устранение неисправностей
Запуск/остановка сервисов ThingWorx Foundation в Windows
1. Перейдите к файлу Services.msc.
2. Найдите сервис ThingWorx-Foundation.
3. Запустите или остановите его.
Обнаружение файлов журнала программы установки
• Журналы установки:
◦ ${installdir}\installer\logs\ThingWorxFoundation_install.log
Пример: C:\Program Files (x86)\ThingWorxFoundation\installer\logs\ThingWorxFoundation_install.log.
• Журналы выполнения:
◦ ${installdir}\ThingworxStorage\logs\
Пример: C:\Program Files (x86)\ThingWorxFoundation\ThingworxStorage\logs\.
• В случае прерывания или сбоя:
◦ ${system_temp_directory}\ThingWorxFoundation_Failed_installs\
Пример: C:\Users\vagrant\AppData\Local\Temp\ThingWorxFoundation_Failed_installs\.
• Журналы деинсталляции:
◦ ${system_temp_directory}\bitrock_installer_(pid).log
Имя файла журнала имеет префикс bitrock. Пример: C:\Users\vagrant\AppData\Local\Temp\bitrock_installer_3008.log.
Удаление установки ThingWorx Foundation на основе установщика
1. Перейдите в расположение установки ThingWorx Foundation.
2. Выполните ThingWorxFoundation_uninstall.exe.
3. В ответ на запрос нажмите кнопку OK, чтобы подтвердить решение продолжить удаление установки.
4. По завершении удаления установка будет удалена.
Удаление базы данных ThingWorx из PostgreSQL
1. Из командной строки в Windows откройте соединение с базой данных PostgreSQL.
Например, введите:psql -U admin -h dbhost
2. Если используется имя базы данных по умолчанию, выполните команду DROP DATABASE thingworx;.
Или, при наличии настроенного имени базы данных, выполните команду DROP DATABASE <your database name>;.
Удаление базы данных ThingWorx из SQL Microsoft
1. Из командной строки в Windows откройте соединение с базой данных Microsoft SQL.
Например, введите:sqlcmd -U admin -s ‘dbhost\dbservicename,port’
2. Если используется имя базы данных по умолчанию, выполните команду DROP DATABASE thingworx; GO;.
Или, при наличии настроенного имени базы данных, выполните команду DROP DATABASE <your database name>; GO;.
Обновление до Java 11 для ThingWorx 9.0 и 9.1
Если программа установки использовалась для установки или обновления ThingWorx 9.0.x или 9.1.x с Java 8, а вы хотите использовать Java 11.0.8, выполните следующие шаги:
1. Установите Java 11.
2. Задайте каталог /bin в переменной среды PATH.
3. Задайте переменную JAVA_HOME для использования каталога установки Java 11.
4. Убедитесь, что файл jvm.dll находится в каталоге установки Java 11. Например: C:\Program Files\Java\jdk-11.0.8\bin\server\jvm.dll.
| В Java 11 нет папки JRE. Поэтому файл jvm.dll не будет находиться в папке JRE, как в случае Java 8. |
5. Остановите сервис ThingWorx-Foundation.
6. Выполните команду CMD как администратор.
7. Перейдите в каталог Tomcat /bin в каталоге установки ThingWorx Foundation. Например: cd C:\Program Files (x86)\ThingWorxFoundation\tomcat\apache-tomcat-9.0.37\bin.
8. Чтобы отредактировать конфигурацию сервиса ThingWorx-Foundation, выполните следующие действия: tomcat9w.exe //ES//ThingWorx-Foundation.
Откроется приложение GUI.
9. Перейдите на вкладку Java для приложения и выполните следующие действия.
a. Для виртуальной машины Java наведите указатель на файл jvm.dll установки Java 11. Например: C:\Program Files\Java\jdk-11.0.8\bin\server\jvm.dll.
b. Удалите из раздела Java Options следующие строки.
-XX:+UseG1GC
-XX:+PrintGCTimeStamps
-XX:+PrintGCDetails
-Xloggc:${CATALINA_HOME}/logs/tomcat-twx-gc.log
${CATALINA_HOME} ссылается на каталог Tomcat.
c. Скопируйте путь к каталогу установки для ThingWorx Foundation. Пример: C:\Program Files (x86)\ThingWorxFoundation.
d. Добавьте в раздел Java Options следующие строки:
-Xlog:gc:file=C:\Program Files
(x86)\ThingWorxFoundation/tomcat/current/logs/gc.log:time,level,tags
10. Выберите Применить.
11. Нажмите кнопку OK.
Приложение закроется.
12. Обновите параметры обслуживания с помощью tomcat9.exe, выполнив следующие действия.
a. Выполните команду CMD как администратор.
b. Выполните следующие действия.
tomcat9.exe //US//ThingWorx-Foundation --JavaHome=%JAVA_HOME%
tomcat9.exe //US//ThingWorx-Foundation --Environment="JRE_HOME='%JAVA_HOME%';THINGWORX_PLATFORM_SETTINGS='%THINGWORX_PLATFORM_SETTINGS%';PATH='%PATH%'"
13. Запустите сервис ThingWorx-Foundation.
14. Открыв файл Application.log, убедитесь, что установлена версия Java 11:
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ThingWorx System Environment Settings
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS: Windows Server 2019
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS arch: amd64
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS version: 10.0
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] Total Processors: 2
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] Default encoding: UTF-8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA vendor: Oracle Corporation
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA version: 11.0.8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA install location: C:\Program Files\Java\jdk-11.0.8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JVM Max Memory: 750 (MB)
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
Если возникли проблемы с изменением конфигурации сервиса в Windows и требуется просмотреть дополнительные сведения, выполните следующие действия, чтобы записать дополнительные сведения в файл журнала commons-daemon.log в каталоге /tomat/current/logs/: tomcat9w.exe //ES//ThingWorx-Foundation --LogLevel Debug.