PTC 소프트웨어 다운로드 페이지를 사용하여 DPM 업그레이드

• 로컬리제이션 테이블은 업그레이드 시 덮어쓰여집니다. 로컬리제이션 테이블의 토큰을 사용자 정의한 경우 업그레이드를 수행하기 전에 사용자 정의된 로컬리제이션 테이블을 내보냅니다. 업그레이드가 완료된 후에 수정 내용을 유지하려면 내보낸 로컬리제이션 테이블을 가져올 수 있습니다.

ThingWorx 업그레이드

다음 단계를 완료하십시오.

1. ThingWorx 설치를 업그레이드합니다. 자세한 내용은 ThingWorx 도움말 센터의 ThingWorx 업그레이드를 참조하십시오.

DPM 1.2와 호환되는 ThingWorx 릴리스는 DPM 시스템 요구 사항을 참조하십시오.

2. ThingWorx 서버를 재시작합니다.

DPM 업그레이드 전

DPM을 업그레이드하기 전에 다음 정보를 검토하고 필요한 작업을 수행합니다.

• 업그레이드 프로세스 중에는 DPM을 사용할 수 없습니다. 즉, 이 시간 동안에는 생산 데이터를 입력할 수 없습니다. 생산 시스템을 업그레이드하기 전에 먼저 테스트 시스템에서 업그레이드하는 것이 좋습니다. 이렇게 하면 생산 시스템을 사용할 수 없는 기간을 쉽게 결정할 수 있습니다.

• 업그레이드를 수행하기 전에 스크립트 시간 초과 설정을 늘립니다. 이 설정은 업그레이드가 완료된 후 이전 값으로 되돌릴 수 있습니다. 스크립트 시간 초과 설정을 업데이트하려면 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.]

자세한 내용은 ThingWorx 도움말 센터의 platform-settings.json 구성 세부 정보를 참조하십시오.

DPM 업그레이드

1. PTC 소프트웨어 다운로드 페이지에서 새 DPM 버전을 다운로드합니다. 다음 단계를 완료하십시오.

a. https://support.ptc.com/appserver/auth/it/esd/index.jsp URL에서 PTC 소프트웨어 다운로드 페이지로 이동합니다.

b. ThingWorx Foundation을 선택합니다.

c. ThingWorx Foundation > Release 9.3 > ThingWorx Digital Performance Management (DPM) 1.2 > 최근 제조코드 폴더를 확장합니다.

d. DPM-1-2 확장 패키지 ZIP 파일을 다운로드합니다.

2. DPM 솔루션을 가져옵니다. DPM 솔루션을 가져오려면 ThingWorx 관리자가 다음 단계를 완료해야 합니다.

a. ThingWorx Composer에 라이선스가 설치되어 있는지 확인합니다. 자세한 내용은 PTC 기술 자료의 기술 지원 문서를 참조하십시오.

b. ThingWorx Composer에서 가져오기/내보내기 > 가져오기로 이동합니다.

c. 가져오기 창의 가져오기 옵션 목록에서 확장을 선택합니다.

d. 파일 이름에서 찾아보기를 클릭합니다. 이전 섹션에서 다운로드한 확장 패키지 ZIP 파일로 이동하여 선택합니다.

e. 가져오기를 클릭합니다. 가져오기가 완료되면 닫기를 클릭합니다.

f. 가져오기가 완료된 후 관리 > 설치된 확장으로 이동하여 DPM 솔루션 확장을 확인합니다.

3. ThingWorx 서버를 재시작합니다.

4. UpgradeSolution 서비스에 대한 구성 매개 변수를 가져옵니다.

a. ThingWorx Composer에서 PTC.Base.Manager 사물로 이동합니다.

b. 서비스에서 GetSolutionUpgradeConfigurationParameters 서비스를 찾아 실행합니다. 서비스 출력은 존재하는 빌딩 블록 세트에 동적으로 기반하여 UpgradeSolution 서비스에 필요한 구성 매개변수를 포함하는 JSON입니다. 서비스 출력 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 - DPM 데이터베이스에 대한 JDBC 연결 문자열입니다.

▪ 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
}

5. 3.d단계에서 편집한 JSON을 서비스에 대한 config 입력 매개 변수로 사용하여 UpgradeSolution 서비스를 실행합니다.

서비스가 완료되면 출력에 업그레이드, 배포 및 마이그레이션된 빌딩 블록(MigrateSolution 서비스가 자동으로 실행되는 경우) 및 해당 구성 상태(Not Processed, Error 또는 Successful)가 나열된 인포테이블이 표시됩니다. 서비스에서 빌딩 블록을 처리하는 동안 오류가 발생하면 서비스가 중지됩니다. 해당 빌딩 블록의 상태는 Error로 표시되고 나머지 빌딩 블록에는 Not Processed 상태가 표시됩니다.

빌딩 블록에 Error 또는 Not Processed 상태가 있는 경우 다음 문제 해결 단계를 완료하십시오.

a. UpgradeSolution 서비스를 실행하기 전에 JSON에 지정된 데이터베이스 자격 증명이 유효한지 확인합니다.

b. 서비스 출력에 여전히 Error 또는 Not Processed 상태가 있는 빌딩 블록이 있는 경우 ThingWorx 응용 프로그램 및 스크립트 오류 로그를 검토하고 발견된 모든 오류를 처리합니다. 그런 다음 UpgradeSolution 서비스를 실행합니다.

c. 서비스 출력에 여전히 Error 또는 Not Processed 상태가 있는 빌딩 블록이 있는 경우

"overrideComponentDeploymentState": true

를 포함하도록 JSON을 업데이트하고 UpgradeSolution 서비스를 실행합니다.

6. MigrateSolution 서비스가 UpgradeSolution 서비스에서 자동으로 실행되지 않은 경우 MigrateSolution 서비스를 실행합니다. 이 서비스에는 필수 입력 매개 변수가 없습니다.

MigrateSolution 서비스에 대한 서비스 출력, 상태 및 문제 해결 단계는 4단계에서 표시되는 UpgradeSolution 서비스에 대한 서비스 출력, 상태 및 문제 해결 단계와 동일합니다. 모든 빌딩 블록이 Successful 상태가 될 때까지 문제 해결 단계를 반복합니다.

MigrateSolution 서비스가 성공적으로 실행될 때까지 업그레이드가 완료되지 않습니다. DPM 1.2는 데이터가 마이그레이션될 때까지 사용할 수 없습니다.

7. DPM을 사용자 정의한 경우 업그레이드로 인해 사용자 정의에 미치는 영향을 해결하려면 사용자 정의 및 업그레이드를 참조하십시오.

8. DPM을 업그레이드하기 전에 스크립트 시간 초과 설정을 늘린 경우 이전 설정으로 되돌립니다.

9. 초기 관리 활동을 검토하고 새 기능에 필요한 모든 활동을 수행합니다. 자세한 내용은 초기 DPM 관리 활동를 참조하십시오.

업그레이드 이후 활동

DPM이 성공적으로 업그레이드된 후 사용자가 업데이트된 시스템을 사용할 수 있도록 하기 전에 다음 단계를 완료하십시오.

1. 데이터베이스의 이벤트를 집계합니다. 다음 단계를 완료하십시오.

a. ThingWorx Composer에서 PTC.OperationKPIImpl.EventsAggregationScheduler로 이동합니다.

b. 서비스에서 AggregateEvents 서비스를 실행합니다.

2. DPM을 사용자 정의한 경우 업그레이드로 인해 사용자 정의에 미치는 영향을 해결하려면 사용자 정의 및 업그레이드를 참조하십시오.

3. ThingWorx를 업그레이드하기 전에 ThingWorx Composer에서 내보낸 사용자 정의 로컬리제이션 테이블을 가져옵니다.

4. DPM을 업그레이드하기 전에 스크립트 시간 초과 설정을 늘린 경우 이전 설정으로 되돌립니다.

5. 초기 관리 활동을 검토하고 새 기능에 필요한 모든 활동을 수행합니다. 자세한 내용은 초기 DPM 관리 활동를 참조하십시오.

6. 필요에 따라 재료 이름 및 재료 이름이 속한 사이트를 업데이트합니다.

DPM 1.1에서 개별 재료는 하나의 사이트에만 속할 수 있으며 재료 이름은 각 사이트 내에서 고유해야 합니다. 즉, 각각 서로 다른 사이트에 속하는 동일한 이름을 가진 여러 재료가 있을 수 있습니다. 이제 DPM 1.2에서 재료는 하나의 사이트, 여러 사이트 또는 모든 사이트에 속할 수 있으며 재료 이름은 엔터프라이즈 전체에서 고유해야 합니다. 데이터 마이그레이션 서비스는 이름이 중복된 재료를 다음과 같이 처리합니다.

◦ 특정 이름을 가진 첫 번째 재료는 있는 그대로 마이그레이션됩니다.

◦ 동일한 이름을 가진 이후 재료에는 마이그레이션 중에 재료가 속한 사이트가 재료이름_사이트이름 형식으로 이름에 추가됩니다.

마이그레이션이 완료되면 재료 테이블을 정렬하거나 필터링하여 마이그레이션된 중복된 재료를 쉽게 찾을 수 있습니다. 필요에 따라 재료를 편집하여 이름을 변경하고 추가 사이트에 추가할 수 있습니다. 사용하지 않으려는 중복된 재료는 사용 안 함으로 설정할 수 있습니다.

예를 들어, DPM 1.1에는 각각 Boston, London 및 Berlin 사이트에 속한 Material1이라는 재료 3개가 있습니다. 아래 표에는 DPM 1.1에서 각각에 대한 재료 이름과 사이트, DPM 1.2로 마이그레이션한 후 각각에 대한 재료 이름과 사이트가 표시됩니다. 이 예에서 데이터 마이그레이션 서비스는 먼저 Boston 사이트에 속한 Material1을 처리하게 됩니다.

DPM 1.1의 재료 이름 및 사이트	DPM 1.2로 마이그레이션한 후 재료 이름 및 사이트
Material1, Boston	Material1, Boston
Material1, London	Material1_London, London
Material1, Berlin	Material1_Berlin, Berlin

재료 테이블에서 "Material1"을 필터링하여 이러한 재료의 모든 인스턴스를 찾을 수 있습니다. 세 사이트에 모두 속한 Material1이라는 단일 재료를 사용하려면 Material1을 편집하여 London 및 Berlin 사이트를 추가하고 Material1_London 및 Material1_Berlin을 비활성화할 수 있습니다.

7. 사용자는 클라이언트 컴퓨터에서 브라우저 캐시를 지우는 것이 좋습니다.

도움이 되셨나요?