ThingWorx Flow > ThingWorx Flow 설치 및 관리 > ThingWorx Flow 8.4.x 설치
ThingWorx Flow 8.4.x 설치
ThingWorx Flow는 ThingWorx 8.4.1과 함께 릴리즈됩니다.
ThingWorx의 기존 인스턴스에 ThingWorx Flow를 설치하거나 단일 설치 관리자를 사용하여 ThingWorx 및 ThingWorx Flow의 종단 간 설치를 수행할 수 있습니다.
* 
기존 ThingWorx 설치에 ThingWorx Flow를 설치하는 경우 해당 ThingWorx 인스턴스를 버전 8.4.1로 수동으로 업그레이드해야 합니다. ThingWorx 8.4.0에 ThingWorx Flow 8.4.1 자동 설치는 지원되지 않습니다.
서로 다른 데이터베이스 조합을 사용하여 다음 운영 체제에 ThingWorx Flow를 설치할 수 있습니다.
• Windows Server 16(PostgreSQL 9.6 포함)
• Windows Server 16(Microsoft SQL Server 2016 포함)
• Red Hat Enterprise Linux 7.5(PostgreSQL 9.6 포함)
• Red Hat Enterprise Linux 7.5(Microsoft SQL Server 2016 포함)
* 
다음 사항에 유의하십시오.
• ThingWorx Flow 설치 관리자는 이전 설치의 모든 아티팩트가 제거된 경우가 아니면 반복 실행을 지원하지 않습니다. 설치 전 상태로 롤백할 수 있는 가상 컴퓨터 스냅샷에서 ThingWorx Flow를 설치합니다.
• ThingWorx Flow 설치 관리자는 제거를 지원하지 않습니다.
서버 요구 사항
다음 표에서는 ThingWorx 및 ThingWorx Flow 배포에 필요한 최소 시스템 요구사항에 대한 정보를 제공합니다. 그러나 실제 크기는 응용 프로그램 및 사용 시나리오에 따라 달라집니다.
하드웨어 사양
구성 요소
값
참고
메모리
16 GB RAM(최소)
전용 메모리는 Java VM에 할당해야 합니다.
CPU
4
가상화된 환경에는 제공 중인 CPU 및 코어 수를 지정하기 위한 자체 용어가 있을 수 있습니다. 이러한 환경이 최소 요구사항을 충족하는지 확인할 때 이를 고려해야 합니다.
디스크 공간
100GB의 사용 가능한 디스크 공간
이 크기는 기본 ThingWorx Flow 웹 응용 프로그램 및 일부 초기 구성 데이터를 수용할 수 있습니다.
* 
• 이 크기는 운영 체제 또는 기타 필수 소프트웨어에 필요한 공간을 포함하지 않습니다.
• 지정된 응용 프로그램에 필요한 총 디스크 공간은 유지되어야 할 구성 및 런타임 데이터 양에 따라 달라집니다. 고객은 영업 및 현장 지원 센터의 도움을 받아 자신의 응용 프로그램 요구사항에 따라 필요한 공간을 파악해야 합니다.
디스크 속도
10K RPM 이상 속도
데이터를 ThingWorx Platform에 저장하는 경우 속도가 중요합니다. ThingWorx Flow에서는 사용자가 감당할 수 있는 가장 빠른 디스크를 권장하지만 10000 RPM보다 느린 디스크는 사용하지 않아야 합니다.
운영 체제
지원되는 운영 체제(64비트 전용)
생산
Windows Server 2016 또는 최신 버전(관리자 액세스)
예
Red Hat Enterprise Linux(RHEL) 7.5
예
데이터베이스 옵션
데이터베이스
지원되는 버전
PostgreSQL
최소 9.6
Microsoft SQL Server
2016
* 
원격 데이터베이스는 ThingWorx Flow에 대해서만 지원됩니다.
생산 환경에서 ThingWorx를 실행하기 위한 서버 하드웨어 요구사항에 대한 자세한 내용은 PTC 참조 문서 지원 사이트의 ThingWorx System Requirements Guide(ThingWorx 시스템 요구사항 안내서)를 참조하십시오.
설치 필수 구성 요소
ThingWorx Flow를 설치하기 전에 다음을 수행합니다.
1. 물리적 서버, 가상 서버 환경, 공용 또는 사설 클라우드와 같은 구성 요소를 배포하려는 환경을 식별합니다.
2. 배포 환경을 결정하면 ThingWorx Platform 및 ThingWorx Flow 필수조건이 충족되었는지 확인합니다.
ThingWorx 설치 필수조건에 대한 자세한 내용은 ThingWorx 설치 관리자 항목의 필수 구성 요소 단락을 참조하십시오.
* 
thingworx.war 파일과 설치 관리자를 사용한 ThingWorx 설치 필수조건은 다릅니다. ThingWorx Flow를 설치하기 전에 ThingWorx 설치 관리자에 대한 필수조건을 완료했는지 확인합니다.
3. PTC 지원 사이트에서 운영 체제 및 데이터베이스 조합에 따라 적절한 소프트웨어 패키지를 다운로드합니다.
다음 설치 관리자가 소프트웨어 다운로드 > 소프트웨어 업데이트 주문 또는 다운로드 > ThingWorx Platform > Release 8.4에서 제공됩니다.
◦ Windows Server 2016(PostgreSQL 포함)에서의 ThingWorx Flow
◦ Windows Server 2016(Microsoft SQL Server 2016 포함)에서의 ThingWorx Flow
◦ Red Hat Enterprise Linux 7.5(PostgreSQL 포함)에서의 ThingWorx Flow
◦ Red Hat Enterprise Linux 7.5(Microsoft SQL Server 2016 포함)에서의 ThingWorx Flow
◦ Windows Server 2016(PostgreSQL 포함)에서의 ThingWorx 및 ThingWorx Flow
◦ Windows Server 2016(Microsoft SQL Server 2016 포함)에서의 ThingWorx 및 ThingWorx Flow
◦ Red Hat Enterprise Linux 7.5(PostgreSQL 포함)에서의 ThingWorx 및 ThingWorx Flow
◦ Red Hat Enterprise Linux 7.5(Microsoft SQL Server 2016 포함)에서의 ThingWorx 및 ThingWorx Flow
4. ThingWorx의 기존 인스턴스에 ThingWorx Flow를 설치하는 경우 ThingWorx Platform를 설치하고 구성해야 합니다.
ThingWorx 설치 및 구성에 대한 자세한 내용은 ThingWorx 설치 및 업그레이드를 참조하십시오.
5. 설치한 데이터베이스에 따라 다음 값을 사용하고 있는지 확인합니다.
데이터베이스
매개 변수
PostgreSQL
• PostgreSQL IP 주소 또는 호스트 이름
• PostgreSQL 포트
• PostgreSQL 관리자 사용자 이름
• PostgreSQL 관리자 암호
• ThingWorx 데이터베이스 로그인 사용자 이름
• ThingWorx 로그인 암호
• ThingWorx 데이터베이스 이름
Microsoft SQL Server
• SQL Server IP 주소 또는 호스트 이름
• SQL Server 포트
• SQL Server 데이터베이스 인스턴스
• SQL Server 관리자 사용자 이름
• SQL Server 관리자 암호
• ThingWorx 데이터베이스 로그인 사용자 이름
• ThingWorx 로그인 암호
• ThingWorx 데이터베이스 이름
6. (Linux에만 해당) 다음 필수 조건을 설정했는지 확인합니다.
◦ Red Hat 7.5(관리자 액세스 사용)
◦ 다음 명령을 실행하여 소프트웨어 컬렉션을 활성화합니다.
▪ yum-config-manager --enable 'Red Hat Enterprise Linux Server 7 RHSCL (RPMs)'
▪ yum-config-manager --enable 'Red Hat Enterprise Linux Server 7 Extra(RPMs)'
▪ yum-config-manager --enable 'Red Hat Enterprise Linux Server 7 Optional (RPMs)'
▪ yum-config-manager --enable 'Red Hat Enterprise Linux Server 7 RH Common (RPMs)'
▪ yum-config-manager --enable 'Red Hat Enterprise Linux Server 7 Supplementary (RPMs)'
◦ 다음 명령을 실행하여 EPEL 저장소를 활성화합니다.
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
yum localinstall epel-release-latest-7.noarch.rpm
ThingWorx Flow 설치
다음 단계를 완료하여 ThingWorx Flow를 설치합니다.
1. 관리자로 로그인합니다.
2. 적절한 설치 관리자를 실행합니다.
3. 설치 관리자 화면의 지침을 따릅니다.
* 
ThingWorx Flow 속성 창의 ThingWorx Flow의 호스트 이름 필드에 다음 값 중 하나를 입력합니다.
• ThingWorx Flow를 설치 중인 컴퓨터의 호스트 이름
• ThingWorx가 이미 배포된 경우 ThingWorx 인스턴스에 사용된 호스트 이름을 재사용하는 것이 좋습니다.
이 구성을 사용하면 사용자가 책갈피를 변경하거나 새 URL을 알 수 없습니다. 그러나 Tomcat 설치의 server.xml 파일에서 Host 태그의 name 속성 값을 수정해야 합니다.
전체 설치는 호스트 하드웨어 구성에 따라 45~60분 정도 시간이 걸립니다. 설치의 마지막 단계가 수행되는 동안 콘솔 창이 시작됩니다. 콘솔 창을 닫거나 마우스 오른쪽 버튼을 클릭하지 마십시오. 설치가 완료되면 창이 자동으로 닫힙니다.
ThingWorx가 아닌 다른 시스템에 ThingWorx Flow를 설치하는 경우 다음 작업을 완료합니다.
1. ThingWorx Flow를 설치할 호스트에 ThingWorx platform_settings.json 파일을 복사합니다.
2. ThingWorx Flow를 설치합니다.
3. ThingWorx Flow를 설치한 후 업데이트된 platform_settings.json 파일을 ThingWorx 호스트에 복사합니다.
4. ThingWorx를 다시 시작합니다.
5. ThingWorx 호스트에서 PORT를 사용하려면 다음 명령을 실행합니다.
firewall-cmd --zone=public --add-port=8080/tcp --permanent && firewall-cmd --reload
ThingWorx Flow의 설치 후 단계
ThingWorx Flow 사용을 시작하기 전에 다음 설치 후 단계를 완료합니다.
• RHEL에 ThingWorx Flow를 설치한 경우 <사용자>를 twxflow 그룹에 추가하여 pm2를 실행합니다.
• 사용자 정의 커넥터를 구현하려면 Flow SDK를 사용합니다. 자세한 내용은 커넥터 배포를 참조하십시오.
• 타사 SSL 인증서를 생성합니다.
기본적으로 설치 관리자는 호스트에 대한 서명 없는 SSL 인증서를 생성합니다. 설치 후 인증서를 변경하려면 다음 단계를 완료합니다.
1. 다음 경로로 이동합니다.
<ThingWorx Flow 설치 디렉터리>\SSL
2. orchestration.csr 인증서 요청 파일을 사용하여 인증 기관에서 인증서를 구합니다.
3. 인증 기관의 지침을 따릅니다.
4. 기존 orchestration.crt를 인증 기관에서 생성된 인증서로 바꿉니다.
확인
ThingWorx Flow가 제대로 설치되었는지 확인하려면 관리자 권한으로 명령 프롬프트를 시작하고 다음 명령을 실행합니다.
pm2 ls
다음 ThingWorx Flow 구성 요소의 상태는 '온라인'이어야 합니다.
• flow-api
• flow-engine
• flow-exchange
• flow-lookup
• flow-oauth-server
• flow-trigger
간단한 테스트 흐름을 실행하려면 흐름 실행 테스트를 참조하십시오.
ThingWorx Flow에 액세스
ThingWorx Flow에 액세스하려면 다음 단계를 완료합니다.
1. 다음 URL을 Google Chrome에 입력하여 ThingWorx Flow에 액세스합니다.
https://<호스트 이름>/Thingworx/Composer/apps/flow/. 여기서 <호스트 이름>은 ThingWorx Flow를 설치하는 동안 사용자가 ThingWorx Flow의 호스트 이름 필드에 입력한 호스트 이름입니다. 기본적으로 이는 ThingWorx Flow를 설치한 시스템의 호스트 이름입니다.
2. 로그인하려면 ThingWorx Platform 사용자 자격 증명을 입력합니다.
ThingWorx 액세스
다음 URL을 사용하여 ThingWorx Composer에 액세스합니다.
https://<호스트 이름>/Thingworx/Composer/index.html
ThingWorx Flow의 호스트 이름 필드에 입력한 값에 따라 <호스트 이름>은 다음 중 하나입니다.
• ThingWorx Flow를 설치 중인 컴퓨터의 호스트 이름
• 기존 ThingWorx 설치의 호스트 이름
문제 해결
시나리오
해결 방법
ThingWorx Flow 서버 URL에 액세스할 수 없거나 오류 코드 500을 반환하는 경우
1. orchestration-installer 폴더에 있는 settings.json 파일을 엽니다.
2. orchestration 섹션에서 protocol, host 또는 port 매개 변수의 값을 확인합니다.
"orchestration": {
"url": "호스트 이름",
"services": {
"thingworx": {
"protocol": "https",
"host": "localhost",
"port": "8443",
"platform_settings": "C:\\Program Files (x86)\\ThingWorxPostgres-8.4.1-SNAPSHOT\\ThingworxPlatform\\platform-settings.json"
}
}
},
3. 이들 값 중에서 올바르지 않은 값이 있을 경우, 값을 업데이트하고 파일을 저장합니다.
4. orchestration-installer\bin 폴더로 이동하여 운영 체제에 따라 다음 중 하나를 실행합니다.
◦ install.bat
◦ install.sh
5. ThingWorx-Flow 서비스를 다시 시작합니다.
6. ThingWorx Flow 서버 URL에 액세스합니다.
ThingWorx Flow 가상 컴퓨터에서 ThingWorx 호스트에 액세스할 수 없는 경우
1. ThingWorxOrchestration\modules\RabbitMQ\log 폴더 아래의 RabbitMQ 로그 파일로 이동합니다.
2. 로그 파일을 열고 다음 줄을 로그 파일에서 사용할 수 있는지 확인합니다.
user 'flowuser' authenticated and granted access to vhost 'orchestration'
3. 이 줄을 사용할 수 없는 경우 다음을 수행합니다.
◦ ThingWorx 가상 컴퓨터에서 방화벽 연결을 확인합니다.
◦ 두 호스트 모두에서 RabbitMQ 포트에 액세스할 수 있는지 확인합니다.
DNS 이름 또는 호스트 이름을 사용하여 ThingWorx 및 ThingWorx Flow 호스트가 서로 연결할 수 있는지 확인합니다.
로그 파일을 사용하여 설치 문제를 해결할 수 있습니다. 로그 파일은 다음 위치에 저장됩니다.
• Windows
◦ 설치 로그: C:\orchestration-installer\logs\install.log
◦ ThingWorx Flow 로그: C:\ThingWorxOrchestration\.pm2\logs\
• Linux
◦ 설치 로그: /opt/orchestration-installer/logs/install.log
◦ ThingWorx Flow 로그: /opt/ThingWorxOrchestration/.pm2/logs/