Начало работы с DPM > Обновление DPM > Обновление DPM в системе или облаке, принадлежащем заказчику > Обновление DPM с помощью Solution Central
Обновление DPM с помощью Solution Central
Чтобы обновить с DPM 1.1 до DPM 1.2 с помощью Solution Central, выполните шаги, указанные в следующих разделах:
* 
PTC рекомендует сначала обновить тестовую систему, а затем перейти к производству.
Solution Central - это рекомендуемый инструмент для перемещения развертывания и настроек между средами ThingWorx, например, из тестовой среды в производственную среду. Для получения дополнительной информации см. ThingWorx Solution Central Help Center.
Перед началом процесса обновления
Перед началом обновления ознакомьтесь со следующей информацией.
• ThingWorx 9.3, системные требования в справочном центре ThingWorx.
• Обновление ThingWorx в справочном центре ThingWorx.
• На настройки DPM повлиял процесс обновления. Дополнительные сведения см. в разделе Настройка и обновление.
Перед обновлением ThingWorx
Перед обновлением ThingWorx выполните следующие шаги.
• При пользовательской настройке компоновочных блоков необходимо сделать резервную копию настроек.
• Таблицы локализации перезаписываются во время обновления. Если у вас есть токены локализации с пользовательскими настройками, необходимо экспортировать их до обновления. После завершения обновления можно импортировать сохраненные таблицы локализации. Таким образом изменения сохранятся.
Обновление ThingWorx
Выполните следующие шаги:
1. Обновите установку ThingWorx. Для получения дополнительной информации см. Обновление ThingWorx в справочном центре ThingWorx.
Информацию о выпусках ThingWorx, совместимых с DPM 1.2, см. в Системные требования DPM.
2. Перезапустите сервер ThingWorx.
Перед обновлением DPM
Перед обновлением DPM ознакомьтесь со следующей информацией и выполните необходимые действия.
• В процессе обновления DPM будет недоступен. Это означает, что в это время невозможно будет ввести производственные данные. PTC рекомендует сначала обновить тестовую систему, а затем обновить производственную систему. Таким образом можно будет определить время, в течение которого будет недоступна производственная система.
• Повысьте длительность настройки времени ожидания сценария перед выполнением обновления. Настройки можно будет вернуть к изначальным значениям после завершения обновления. Чтобы обновить настройку времени ожидания сценария, администратору ThingWorx необходимо выполнить следующие шаги.
1. На сервере ThingWorx перейдите к папке ThingWorxPlatform.
2. Откройте файл platform-settings.json в текстовом редакторе.
3. Найдите и измените значение настройки ScriptTimeout на 12000.
4. Сохраните и закройте файл platform-settings.json.
5. Перезапустите сервер ThingWorx.
* 
Если в журнале сценариев появится сообщение, подобное приведенному ниже, повторите описанные выше действия для дальнейшего увеличения значения настройки ScriptTimeout:
[message: Execution of Script terminated after : 12000 seconds. Timeout configured for 12000 seconds.]
Для получения дополнительной информации см. раздел Сведения о конфигурации platform-settings.json в Центре справки ThingWorx.
Обновление DPM
Чтобы обновить DPM, выполните следующие шаги.
1. Разверните новую версию DPM, используя Solution Central.
* 
При развертывании DPM в системе ThingWorx HA рекомендуется взять кластер для одного экземпляра, установить расширения, а затем масштабировать резервную копию кластера. Это обеспечить повышение производительности и предотвратит проблемы с окончательной согласованностью, поскольку новые расширения будут загружаться при запуске каждого сервера. Дополнительные сведения см. в Управление расширениями ThingWorx в ThingWorx HA в Центре справки ThingWorx.
Чтобы развернуть решение DPM в экземпляре ThingWorx с помощью Solution Central, администратору ThingWorx необходимо выполнить следующие шаги.
a. Убедитесь, что Лицензия DPM установлена в ThingWorx Composer. Дополнительные сведения см. в статье технической поддержки в базе знаний PTC.
b. Установка Solution Central. Дополнительные сведения см. в разделе Getting Started with Using Solution Central в Solution Central Help Center.
c. Зарегистрируйте экземпляр ThingWorx в Solution Central. Дополнительные сведения см. в разделе Registering Your ThingWorx Instance в Solution Central Help Center.
d. В ThingWorx Composer перейдите в Управление > Solution Central > Решения PTC.
e. Установите флажок рядом с пунктом Digital Performance Management и нажмите Развернуть одним щелчком. В окне отображается список всех расширений, которые необходимо развернуть в составе решения DPM.
f. Нажмите на Развернуть все.
Расширения загружаются и устанавливаются. Это может занять несколько минут. Вы получите уведомление о завершении процесса.
Для получения дополнительной информации см. ThingWorx Solution Central Help Center.
2. Перезапустите сервер ThingWorx.
3. Получите параметры конфигурации для службы UpgradeSolution.
a. В ThingWorx Composer перейдите к вещи PTC.Base.Manager.
b. В разделе Сервисы найдите и выполните службу GetSolutionUpgradeConfigurationParameters. Выходные данные службы записываются в формате JSON, содержащем параметры конфигурации для службы UpgradeSolution, изменяющейся динамически в зависимости от набора компоновочных блоков. JSON с выходными данными службы аналогичен следующему:
{
"databaseUser": {
"types": [
"STRING"
],
"description": "Name of the database user used for DPM database Thing",
"optional": false
},
"automatedMigration": {
"types": [
"Boolean"
],
"description": "When TRUE, the MigrateSolution service is automatically called by the UpgradeSolution service after the upgrade action completes. When FALSE, the MigrateSolution service must be manually executed.",
"optional": false
},
"overrideComponentDeploymentState": {
"types": [
"BOOLEAN"
],
"description": "If true, the current component deployment state is ignored and the DeployComponent service will be rerun.",
"optional": true
},
"databasePassword": {
"types": [
"STRING"
],
"description": "Password of the database user used for DPM database Thing",
"optional": false
},
"databaseJDBCString": {
"types": [
"STRING"
],
"description": "JDBC Connection String for the DPM database Thing",
"optional": false
},
"databaseThing": {
"types": [
"STRING"
],
"description": "The default database thing (PTC.DBConnection.SQLThingDatabase)",
"optional": true
}
}
c. Скопируйте данные JSON, возвращенные в выходные данные сервиса, и вставьте их в текстовый редактор.
d. Отредактируйте данные JSON, заменяя содержимое в фигурных скобках для каждого параметра конфигурации со значением, определенным для предприятия.
▪ databaseUser: имя для входа пользователя базы данных с правами системного администратора.
▪ databasePassword: пароль для входа пользователя базы данных с правами системного администратора.
▪ databaseJDBCString: строка подключения JDBC для базы данных DPM.
▪ databaseThing: вещь базы данных по умолчанию (PTC.DBConnection.SQLThingDatabase).
▪ overrideComponentDeploymentState: это значение должно быть false.
▪ automatedMigration: если это значение true, то происходит автоматическое выполнение службы MigrateSolution, переносящей все данные решения в обновленную схему базы данных. Перенос может длиться долго, в зависимости от количества переносимых данных. Если это значение false, то автоматическое выполнение службы MigrateSolution не происходит, и ее нужно будет обновить вручную позже.
Ниже приведен пример входных данных JSON:
{
"databaseUser": "DPMadmin",
"databasePassword": "945DaTaBase!39525",
"databaseJDBCString": "jdbc:sqlserver://localhost:1433;databaseName=dpmdb",
"databaseThing": "PTC.DBConnection.SQLThingDatabase",
"overrideComponentDeploymentState": false,
“automatedMigration”: true
}
4. Запустите службу UpgradeSolution, используя отредактированный файл JSON из шага 3.d в качестве входного параметра для службы config.
Когда служба завершается, на выходе отображается таблица данных со списком обновленных развернутых и перенесенных компоновочных блоков (при автоматическом выполнении службы MigrateSolution), а также статус их конфигурации: Successful, Not Processed или Error. Если при обработке компоновочного блока происходит ошибка, то служба останавливается. Статус такого компоновочного блока отображается как Error, а статус остальных компоновочных блоков как Not Processed.
Если у какого-либо компоновочного блока статус Error или Not Processed, выполните следующие шаги для диагностики неисправности.
a. Убедитесь, что учетные данные, указанные в файле JSON, действительны, а затем выполните службу UpgradeSolution.
b. Для всех компоновочных блоков, у которых сохраняется статус выходных данных службы как Error или Not Processed, необходимо проверить журналы ошибок сценария и приложения ThingWorx, и устранить обнаруженные ошибки. Затем выполните службу UpgradeSolution.
c. Если у какого-либо компоновочного блока сохраняется статус выходных данных службы как Error или Not Processed, обновите JSON для включения следующих данных и выполните службу UpgradeSolution:
"overrideComponentDeploymentState": true
5. Если служба MigrateSolution не выполнена автоматически службой UpgradeSolution, то запустите выполнение службы MigrateSolution. Для этой службы отсутствуют требования к параметрам ввода.
Выходные данные службы, статусы и шаги по устранению неисправностей для службы MigrateSolution такие же, как для службы UpgradeSolution на шаге 4. Повторяйте шаги по устранению неисправностей до тех пор, пока статус компоновочного блока не станет Successful.
* 
Обновление не завершено до тех пор, пока не выполнена служба MigrateSolution. DPM 1.2 невозможно использовать до переноса данных.
Действия после обновления
После успешного обновления DPM и до того, как обновленная система будет доступна пользователям, выполните следующие шаги.
1. Объединить события в базе данных. Выполните следующие шаги:
a. В ThingWorx Composer перейдите в PTC.OperationKPIImpl.EventsAggregationScheduler.
b. В разделе Сервисы запустите службу AggregateEvents. Для выполнения этой службы может потребоваться некоторое время.
Эта служба успешно выполнена, если на панели вывода отображается сообщение Нет результатов.
Если служба обнаруживает ошибку, установите причину ошибки, а затем снова выполните службу.
2. Если DPM настроен, обратитесь Настройка и обновление, чтобы устранить последствия обновления для настроек.
3. Импортируйте любые таблицы локализации с пользовательской настройкой, экспортированные перед обновлением ThingWorx Composer.
4. Если перед обновлением DPM увеличена настройка времени ожидания сценария, то ее необходимо вернуть к прежнему значению.
5. Просмотрите первоначальные действия по администрированию и выполните все действия, необходимые для новой функциональности. Дополнительные сведения см. в разделе Начальные задачи администрирования DPM.
6. Обновите названия материала и предприятия, к которым он принадлежит, при необходимости.
В DPM 1.1 отдельные материалы могут принадлежать только одному предприятию, и наименования материалов должны быть уникальными для каждого предприятия. Это означает, что может быть несколько материалов с одинаковым названием, принадлежащих к разным предприятиям. В DPM 1.2 материалы могут принадлежать к одному, нескольким или ко всем предприятиям, и их названия должны быть уникальными в организации. Сервисы переноса данных обрабатывают материалы с одинаковыми названиями следующим образом:
◦ Первый материал с определенным названием переносится в изначальном виде.
◦ Для последующих материалов с совпадающим названием во время переноса добавляется предприятие, к которому они принадлежат в формате ИмяМатериала_ИмяПредприятия.
По завершении переноса такие перенесенные дубликаты материалов можно будет просто найти, выполнив сортировку или фильтрацию в таблице Материалы. Можно править материалы, чтобы изменить их названия и добавить в дополнительные предприятия при необходимости. Все дублированные материалы. которые не нужно использовать, можно отключить.
Например, в DPM 1.1 есть три материала с названием Material1, которые принадлежат к предприятиям в Бостоне, Лондоне и Берлине соответственно. В таблице ниже показано название материала и предприятие для каждого из них в DPM 1.1 и название материала и предприятие для каждого материала после переноса в DPM 1.2. В этом примере сервис миграции данных определил, что Material1 сначала относится к предприятию в Бостоне.
Название материала и предприятия в DPM 1.1
Название материала и предприятия после переноса в DPM 1.2
Material1, Boston
Material1, Boston
Material1, London
Material1_London, London
Material1, Berlin
Material1_Berlin, Berlin
В таблице Материалы можно отфильтровать "Material1", чтобы найти все его экземпляры. При необходимости использовать один материал с названием Material1, принадлежащий ко всем трем предприятиям, можно редактировать Material1 для добавления предприятий в Лондоне и Берлине, а также отключить Material1_London и Material1_Berlin.
7. Рекомендуем пользователям очищать кеш браузера на любых клиентских компьютерах.
Было ли это полезно?