Перенос вручную в ThingWorx 9.x: Windows

Установка и обновление > Обновление ThingWorx > Обновление вручную > Обновление Windows вручную > Перенос вручную в ThingWorx 9.x: Windows

Чтобы определить путь обновления, см. таблицу обновления. Приведенные ниже шаги предназначены только для переноса. Для обновления на месте см. Руководство по обновлению на месте вручную: Windows.

A. Перед обновлением

1. Перед началом обновления рекомендуется выполнить следующие действия:

◦ Дамп базы данных

◦ Создайте резервную копию всех данных в папках ThingworxStorage и ThingworxPlatform.

◦ Создайте резервную копию папки Tomcat_home. Это включает папки bin, conf, lib, temp, webapps и work.

2. При использовании ThingWorx Apps в дополнение к ThingWorx Platform:

a. Убедитесь, что версия ThingWorx, до которой выполняется обновление, поддерживается версией ThingWorx Apps. См. раздел ThingWorx Apps Upgrade Support Matrix (Матрица поддержки обновления ThingWorx Apps) (на английском языке).

b. Перед обновлением платформы необходимо выполнить следующие шаги. Перед переходом к следующему шагу см. раздел Обновление ThingWorx Apps.

3. Получите последнюю версию ThingWorx на сайте загрузки программного обеспечения PTC.

4. Если уже установлен Navigate, проверьте совместимость в таблице совместимости ThingWorx Navigate.

5. Убедитесь, что выполняются требуемые версии Tomcat и Java. Требования к версии см. в разделе Системные требования.

Если необходимо обновить версию Java, выполните обновление ThingWorx перед обновлением Java.

6. Требования к настройке опций могут измениться в зависимости от версии Tomcat Java. Чтобы проверить правильность настроек, см. раздел Настройки опции Java Apache Tomcat.

7. При обновлении MSSQL, Azure SQL или H2 обновление завершится неудачно, если какое-нибудь значение пользовательского поля индекса отсутствует в таблице данных. Перед началом процесса обновления убедитесь, что все поля пользовательских индексов имеют значения.

Без этого обновление завершится неудачно, и потребуется снова развернуть старую версию (если были сделаны обновления схемы, необходимо откатить и восстановить базу данных) и добавить недостающие значения индекса или удалить пользовательские индексы из таблицы данных и затем выполнить обновление.

8. Добавьте в опции Java Apache Tomcat следующее:

-Dlog4j2.formatMsgNoLookups=true

B. Экспорт данных и сущностей

1. Остановите Tomcat: щелкните Остановить в свойствах Tomcat. Дождитесь остановки выполнения Tomcat.

2. Настоятельно рекомендуется перед продолжением создать резервные копии следующих папок:

◦ Apache Software Foundation\Tomcat x.x\webapps\Thingworx

◦ <расположение установки Tomcat>:\\ThingworxStorage

3. Запустите Tomcat: щелкните Запустить в свойствах Tomcat. Перезапуск Tomcat гарантирует, что база данных будет очищена перед экспортом.

4. Экспортируйте сущности и данные:

a. Щелкните Импорт/экспорт > Экспорт > <опция экспорта> в Composer.

Дополнительные сведения об опциях экспорта см. в разделе Импорт и экспорт данных, сущностей и расширений.

b. При необходимости щелкните Включить данные.

Данные и сущности экспортируются в папку ThingworxStorage\exports.

Ход экспорта данных можно отслеживать в журнале приложений.

5. Скопируйте файлы экспорта данных и сущностей и переместите их в безопасное расположение. Эти файлы будут импортироваться на более позднем шаге.

C. Резервное копирование и конфигурирование

1. Создайте резервную копию и удалите файл validation.properties из каталога /ThingworxStorage/esapi.

Файл validation.properties создается при запуске ThingWorx. Если нужно сохранить все внесенные изменения, сохраните файл вне каталога ThingworxStorage, а затем продолжите удаление каталога esapi. При запуске ThingWorx повторно создаст файл, и можно будет добавить пользовательские регулярные выражения в файл validation.properties, который был создан автоматически.

Дополнительные сведения см. в этом разделе.

2. Найдите файл keystore.jks в папке ThingworxStorage и переместите его в безопасное место. Этот файл будет добавлен в папку ThingworxStorage после переноса.

3. Найдите файл keystore-password в папке ThingworxPlatform и переместите его в безопасное место. Этот файл будет добавлен в папку ThingworxPlatform после переноса.

4. Отметьте все используемые расширения (в папке ThingworxStorage\Extensions). Они будут повторно импортированы на более позднем шаге.

5. Остановите Tomcat.

6. Удалите содержимое папок ThingworxStorage и ThingworxBackupStorage.

7. Удалите файл keystore-password из папки ThingworxPlatform.

8. Перейдите к установке Tomcat в \Apache Software Foundation\Tomcat x.x\webapps и удалите файл Thingworx.war.

9. Удалите папку Thingworx, расположенную в Apache Software Foundation\Tomcat x.x\webapps.

10. Скопируйте файл Thingworx.war для этой версии и поместите его в следующее расположение установки Tomcat: \Apache Software Foundation\Tomcat x.x\webapps.

11. Включите импорт расширений. По умолчанию импорт расширений отключен для всех пользователей. Добавьте в файл platform-settings.json следующие данные. Добавьте или обновите следующие параметры ExtensionPackageImportPolicy, изменив их значения на true, чтобы разрешить импорт расширений.

"ExtensionPackageImportPolicy": {
"importEnabled": <true or false>,
"allowJarResources": <true or false>,
"allowJavascriptResources": <true or false>,
"allowCSSResources": <true or false>,
"allowJSONResources": <true or false>,
"allowWebAppResources": <true or false>,
"allowEntities": <true or false>,
"allowExtensibleEntities": <true or false>
},

12. При использовании H2 в качестве базы данных с ThingWorx необходимо добавить имя пользователя и пароль в файл platform-settings.json.

},
"PersistenceProviderPackageConfigs":{
"H2PersistenceProviderPackage":{
"ConnectionInformation":
{
"password": "<changeme>",
"username": "twadmin"
}
},

13. Запустите Tomcat.

14. При повторном использовании старого файла keystore.jks найдите файлы keystore.jks и keystore-password, которые ранее были перемещены из папок ThingworxStorage и ThingworxPlatform, и вставьте их в соответствующие папки.

15. Чтобы запустить ThingWorx, перейдите в расположение <имя_сервера>\Thingworx в веб-браузере. Используйте следующую информацию для входа в систему:

◦ Имя пользователя: Administrator

◦ Пароль: <Пароль администратора исходного сервера>

D. Обновление до Java 11

Для ThingWorx 9.2.0 и более поздних версий требуется Java 11. Дополнительные сведения см. в разделе Требования к системе.

1. При обновлении до Java 11 необходимо выполнить следующие шаги. Пропустите этот раздел, если версия Java 11 уже установлена.

a. Загрузите OpenJDK или Java 11.

b. Распакуйте загруженный openjdk-11 zip и скопируйте папку jdk-xxxx в папке un-zipped.

c. Вставьте папку jdk-xxxx в следующее расположение: C:\Program Files\Java.

d. Убедитесь, что системная переменная JAVA_HOME сконфигурирована для использования расположения каталога Java 11. Например, C:\Program Files\Java\jdk-11.0.7.

e. Отредактируйте переменную Path и добавьте новое значение: %JAVA_HOME%\bin.

f. Чтобы проверить версию Java, откройте командную строку и выполните следующую команду: java -version.

g. Обновите путь в настройках Tomcat Java.

h. Перезапустите Tomcat.

E. Импорт данных и сущностей

1. Переместите файлы экспорта в папку ThingworxStorage\exports.

2. При необходимости получите и импортируйте последние версии расширений. Необходимо импортировать версии расширений 9.x. Поддерживаемые PTC расширения доступны на странице загрузки ThingWorx Foundation:

3. При обновлении от версии 8.x до 9.x и наличии расширений Java см. раздел Перенос расширений Java с 8.x на 9.x.

4. Импортируйте сущности и данные.

При обновлении до ThingWorx 9.2 или более поздних версий необходимо импортировать файл principals.xml перед импортом entities.xml. В противном случае все разрешения будут потеряны. Дополнительные сведения см. в разделе Импорт сущностей в 9.2 и более поздних версиях.

a. В Composer щелкните Импорт/экспорт > Из файла.

b. Выберите данные и/или сущности для импорта.

Установите флажок Включить подсистемы , если нужно включить настройки подсистемы импортированных сущностей (например, при переходе от среды тестирования к производственной).

Следующая ошибка появляется в журнале приложений для обновлений MSSQL и показывает, существуют ли имена перенесенных сервисов, свойств или событий с настроенными разрешениями времени выполнения, имена которых содержат более 256 символов. Чтобы исправить эту ошибку, ограничьте все имена сервисов, свойств и событий длиной не более 256 символов.

Error occurred while accessing the data provider

5. Просмотрите журналы приложений, чтобы убедиться, что в журналах нет сообщений об отсутствующих участниках. Если имеются, см. раздел Импорт сущностей в 9.2 и более поздних версиях для устранения неисправностей.

F. Обновление дополнительных компонентов

• Если используются соединители интеграции, необходимо получить и установить последнюю версию среды выполнения интеграции. Дополнительные сведения см. в документе Initial Setup of Integration Runtime Service for Integration Connectors (Начальная настройка сервиса интеграции времени выполнения для соединителей интеграции) (на английском языке).

• При использовании ThingWorx Analytics в качестве части решения доступны два установщика для обработки обновлений компонентов:

◦ Analytics Server - устанавливает или обновляет Analytics Server и Analytics Extension.

◦ Platform Analytics - устанавливает или обновляет компоненты Descriptive Analytics и Property Tranforms.

Дополнительные сведения о процедурах обновления см. в разделе Обновление, изменение и восстановление ThingWorx Analytics.

Было ли это полезно?