설치 및 구성 > ThingWorx Foundation 설치 관리자
ThingWorx Foundation 설치 관리자
온프레미스 설치를 위한 최신 ThingWorx Foundation 설치 관리자 파일은 support.ptc.com의 소프트웨어 다운로드 > 소프트웨어 업데이트 주문 또는 다운로드 > ThingWorx Foundation > Release 8.5 > ThingWorx PostgreSQL 및 ThingWorx Mssql에 게시되어 있습니다.
이 설치 관리자는 다음을 수행합니다.
• ThingWorx Foundation 설치
• Tomcat 설치
• ThingWorx Foundation 라이선스를 구성 지원
ThingWorx Foundation 설치 관리자는 아래 운영 체제에서 다음 데이터베이스 조합과 함께 지원됩니다.
• Windows(PostgreSQL 포함)
• Windows(Microsoft SQL Server 포함)
• Red Hat Enterprise Linux(PostgreSQL 포함)
• Red Hat Enterprise Linux(Microsoft SQL Server 포함)
버전 정보는 시스템 요구사항을 참조하십시오.
* 
ThingWorx Flow를 설치하려면 ThingWorx Flow 설치를 참조하십시오.
하드웨어 사양
최소 요구 사항은 다음과 같습니다. 실제 사양은 응용 프로그램과 사용 시나리오에 따라 달라집니다.
구성 요소
값
참고
메모리
16 GB RAM(최소)
전용 메모리는 Java VM에 할당해야 합니다.
CPU
4
가상화된 환경에는 제공 중인 CPU 및 코어 수를 지정하기 위한 자체 용어가 있을 수 있습니다. 이러한 환경이 최소 요구사항을 충족하는지 확인할 때 이를 고려해야 합니다.
디스크 공간
100GB의 사용 가능한 디스크 공간
이 크기는 기본 응용 프로그램 및 일부 초기 구성 데이터를 수용할 수 있습니다.
* 
• 이 크기는 운영 체제 또는 기타 필수 소프트웨어에 필요한 공간을 포함하지 않습니다.
• 지정된 응용 프로그램에 필요한 총 디스크 공간은 유지될 구성 및 런타임 데이터 양에 따라 달라집니다. 고객은 영업 및 현장 지원 센터의 도움을 받아 자신의 응용 프로그램 요구사항에 따라 필요한 공간을 파악해야 합니다.
디스크 속도
10K RPM 이상 속도
데이터를 ThingWorx Platform에 저장하는 경우 속도가 중요합니다.
운영 체제 및 데이터베이스에 따라 ThingWorx Foundation 설치 관리자를 실행하기 전에 다음을 확인해야 합니다.
Windows(PostgreSQL 포함)에 대한 필수조건
다음 사항이 충족되어야 합니다.
• 관리자 액세스 권한이 있는 Windows
• 연결 허용 및 인코딩 UTF-8 설정으로 구성된 ThingWorx 데이터베이스
데이터베이스 속성 Connection_LIMIT가 -1로 설정되어야 합니다. 이 값은 기본값이며 인증된 모든 사용자에게 데이터베이스에 대한 무제한 연결을 허용합니다.
• 다음과 같이 설정된 ThingWorx 데이터베이스의 소유자로 구성된 데이터베이스 사용자:
◦ ThingWorx 데이터베이스에 대한 모든 권한이 이 사용자에게 부여되어야 합니다.
◦ can login 속성이 yes로 설정되어야 합니다.
이 데이터베이스 사용자는 설치 관리자에 ThingWorx 데이터베이스 사용자 이름으로 입력됩니다.
• 로컬 데이터베이스 연결을 사용하려면 다음이 필요합니다.
◦ PostgreSQL이 설치되어 있으며, PostgreSQL/bin 경로가 PATH 환경 변수에 있어야 합니다.
◦ Java JDK 1.8.0_141 이상 설치 필요
java/bin이 PATH 환경 변수에 있는지 확인합니다.
◦ pg_hba.conf 파일을 업데이트하여 ThingWorx Foundation 호스트에서 PostgreSQL에 대해 연결이 허용되어야 합니다.
예를 들어, ThingWorx Foundation이 PostgreSQL과 동일한 호스트에 설치된 경우 pg_hba.conf 파일을 업데이트하여 암호 인증 방법을 md5, password 또는 trust로 설정할 수 있습니다. 그러나 trust로 설정하는 것은 권장되지 않습니다. pg_hba.conf 파일 및 암호 인증 방법에 대한 자세한 내용은 PostgreSQL.org 웹 사이트를 참조하십시오.
다음은 암호 인증이 md5로 설정된 pg_hba.conf 파일의 예입니다.
$ 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
• 원격 데이터베이스 연결을 사용하려면 다음을 수행해야 합니다.
◦ PostgreSQL 버전과 호환되는 psql 클라이언트를 설치합니다.
◦ 설치된 psql을 PATH 환경 변수에 추가합니다. 다음 단계를 수행할 수 있습니다.
1. https://www.postgresql.org/ftp/pgadmin/pgadmin4/v4.1/windows/에서 pgadmin4-4.1-x86.exe를 다운로드합니다.
2. pgadmin 클라이언트를 설치합니다.
3. PATH 환경 변수를 업데이트하여 pgadmin 클라이언트가 설치된 경로에 추가합니다.
Windows(Microsoft SQL Server 포함)에 대한 필수조건
다음 사항이 충족되어야 합니다.
• 관리자 액세스 권한이 있는 Windows
• 다음 설정으로 구성된 ThingWorx 데이터베이스:
◦ Collate 속성을 Latin1_General_100_CS_AS_SC로 설정합니다.
◦ 다음 속성을 ON으로 설정합니다.
▪ READ_COMMITTED_SNAPSHOT
▪ ALLOW_SNAPSHOT_ISOLATION
• SQL Server 인증을 사용하여 Microsoft SQL Server 로그인
이 로그인의 암호는 ThingWorx 데이터베이스 로그인 암호입니다.
◦ 이 로그인의 데이터베이스 사용자는 소유자로 그리고 공용 역할 내에 구성됩니다.
이 사용자에게는 기본 스키마 dbo 및 소유한 스키마 db_owner가 있어야 하며 사용자가 db_owner의 멤버여야 합니다.
• 로컬 데이터베이스 연결을 사용하려면 다음이 필요합니다.
◦ ThingWorx Foundation을 설치할 호스트에서 Microsoft SQL Server에 액세스할 수 있어야 합니다.
◦ 유효한 Microsoft SQL 클라이언트(sqlcmd)가 설치되어 있으며 PATH 환경 변수에서 사용할 수 있습니다.
◦ Java JDK 1.8.0_141 이상 설치 필요
java/bin이 PATH 환경 변수에 있는지 확인합니다.
• 원격 데이터베이스 연결을 사용하려면 sqlcmd를 설치하고 PATH 환경 변수에서 사용할 수 있도록 설정합니다.
Red Hat Enterprise Linux(PostgreSQL 포함)에 대한 필수조건
다음 사항이 충족되어야 합니다.
• 관리자 액세스 권한이 있는 RHEL(Red Hat Enterprise Linux)
RHEL 8.2는 보안이 더 강화되었습니다. 설치 관리자를 사용하여 RHEL 8.2에 ThingWorx Foundation을 설치하는 경우 권한 문제가 발생하지 않도록 /opt 디렉터리를 사용해야 합니다. /opt 디렉터리 아래에서 선택한 디렉터리에 설치하도록 선택할 수 있습니다.
• Java JDK 1.8.0_141 이상 설치 필요
PATH 환경 변수에 java/bin을 추가합니다.
• PostgreSQL 데이터베이스
로컬 데이터베이스 연결을 사용하려면 다음이 필요합니다.
• ThingWorx Foundation을 설치할 호스트에서 PostgreSQL 서버에 액세스할 수 있어야 합니다.
• PostgreSQL이 설치되어 있으며, PostgreSQL/bin 경로가 PATH 환경 변수에 있어야 합니다.
• 연결 허용 및 인코딩 UTF-8 설정으로 구성된 ThingWorx 데이터베이스
데이터베이스 속성 Connection_LIMIT가 -1로 설정되어야 합니다. 이 값은 기본값이며 인증된 모든 사용자에게 데이터베이스에 대한 무제한 연결을 허용합니다.
• 다음과 같이 설정된 ThingWorx 데이터베이스의 소유자로 구성된 데이터베이스 사용자:
◦ ThingWorx 데이터베이스에 대한 모든 권한이 이 사용자에게 부여되어야 합니다.
◦ can login 속성이 yes로 설정되어야 합니다.
이 데이터베이스 사용자는 설치 관리자에 ThingWorx 데이터베이스 사용자 이름으로 입력됩니다.
• pg_hba.conf 파일을 업데이트하여 ThingWorx Foundation 호스트에서 PostgreSQL에 대해 연결이 허용되어야 합니다.
예를 들어, ThingWorx Foundation이 PostgreSQL과 동일한 호스트에 설치된 경우 pg_hba.conf 파일을 업데이트하여 암호 인증 방법을 md5, password 또는 trust로 설정할 수 있습니다. 그러나 trust로 설정하는 것은 권장되지 않습니다. pg_hba.conf 파일 및 암호 인증 방법에 대한 자세한 내용은 PostgreSQL.org 웹 사이트를 참조하십시오.
다음은 암호 인증이 md5로 설정된 pg_hba.conf 파일의 예입니다.
$ 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
원격 데이터베이스 연결을 사용하려면 PostgreSQL 9.6 또는 PostgreSQL 10.8 버전과 호환되는 psql 클라이언트를 설치합니다. 다음 명령을 실행하여 psql 클라이언트를 설치할 수 있습니다.
yum install rh-postgresql96-postgresql-syspaths
Red Hat Enterprise Linux(Microsoft SQL Server 포함)에 대한 필수조건
다음 사항이 충족되어야 합니다.
• 관리자 액세스 권한이 있는 RHEL(Red Hat Enterprise Linux)
RHEL 8.2는 보안이 더 강화되었습니다. 설치 관리자를 사용하여 RHEL 8.2에 ThingWorx Foundation을 설치하는 경우 권한 문제가 발생하지 않도록 /opt 디렉터리를 사용해야 합니다. /opt 디렉터리 아래에서 선택한 디렉터리에 설치하도록 선택할 수 있습니다.
• Java JDK 1.8.0_141 이상 설치 필요
PATH 환경 변수에 java/bin을 추가합니다.
• Microsoft SQL Server 데이터베이스
• 다음 설정으로 구성된 ThingWorx 데이터베이스:
◦ Collate 속성을 Latin1_General_100_CS_AS_SC로 설정합니다.
◦ 다음 속성을 ON으로 설정합니다.
▪ READ_COMMITTED_SNAPSHOT
▪ ALLOW_SNAPSHOT_ISOLATION
• SQL Server 인증을 사용하여 Microsoft SQL Server 로그인
이 로그인의 암호는 ThingWorx 데이터베이스 로그인 암호입니다.
◦ 이 로그인의 데이터베이스 사용자는 소유자로 그리고 공용 역할 내에 구성됩니다.
• ThingWorx Foundation을 설치할 호스트에서 Microsoft SQL Server에 액세스할 수 있어야 합니다.
• 유효한 Microsoft SQL 클라이언트(sqlcmd)가 설치되어 있으며 PATH 환경 변수에서 사용할 수 있습니다.
• 관리자 권한이 있는 Microsoft SQL 사용자
• sqlcmd를 설치합니다.
설치 후 다음을 실행합니다.
ln -s /opt/mssql-tools/bin/sqlcmd /usr/bin/sqlcmd
설치 관리자에서 SSL/TLS 활성화를 위한 사전 요구 사항
설치 관리자의 ThingWorx Foundation 속성 화면에는 보안 연결을 위해 SSL/TLS 사용 확인란이 기본적으로 선택되어 있습니다. 이 확인란을 선택 취소하여 설치 관리자에서 SSL/TLS를 사용하지 않도록 설정할 수 있습니다. 기본 설정을 유지하고 SSL/TLS를 사용하도록 선택한 경우 설치 관리자를 실행하기 전에 Java 키 저장소(.jks) 파일을 생성해야 합니다.
키 저장소를 생성할 수 있는 방법에는 여러 가지가 있습니다. 그 중 한 가지 방법은 다음과 같습니다.
1. Java/bin으로 이동합니다.
2. Tomcat 키 저장소 파일(.jks 파일)을 만들려면 다음 명령을 실행합니다. keytool -genkey -alias selfsigned -keyalg RSA -keystore keyStore.jks -keysize 2048
3. 키 저장소의 암호를 입력합니다. 이 암호는 나중에 서버를 구성하는 데 필요합니다.
4. 메시지가 표시되면 서버의 도메인 이름을 입력합니다. 예: myserver.mycompany.com
5. 조직 단위, 조직 등의 다른 값을 입력합니다.
6. 메시지가 표시되면 키 저장소 암호를 입력합니다.
Windows에 ThingWorx Foundation 설치
1. 위의 단원에서 설명한 필수조건을 충족하는지 확인합니다.
2. ThingWorx 호스트에 관리자로 로그인합니다.
3. PostgreSQL의 경우, support.ptc.com의 소프트웨어 다운로드 > 소프트웨어 업데이트 주문 또는 다운로드 > ThingWorx Foundation > Release 8.5 > ThingWorx PostgreSQL > 최근 제조코드에서 ThingWorx-Platform-Foundation-Installer-8-5-0-Windows-postgres를 다운로드합니다.
또는
Microsoft SQL Server의 경우, support.ptc.com의 소프트웨어 다운로드 > 소프트웨어 업데이트 주문 또는 다운로드 > ThingWorx Foundation > Release 8.5 > ThingWorx Mssql > 최근 제조코드에서 ThingWorx-Platform-Foundation-Installer-8–5-0-Windows-mssql을 다운로드합니다.
4. 빌드의 압축을 풉니다.
5. PostgreSQL의 경우, ThingWorxFoundationPostgres-8.5.0-x64.exe를 실행합니다.
또는
Microsoft SQL Server의 경우, ThingWorxFoundationMSSQL-8.5.0-x64.exe를 실행합니다.
6. 설치 관리자 화면을 따라 단계별로 실행합니다.
* 
ThingWorx Foundation 속성 화면에는 보안 연결을 위해 SSL/TLS 사용 확인란이 기본적으로 선택되어 있습니다. 이 확인란을 선택 취소하여 설치 관리자에서 SSL/TLS를 사용하지 않도록 설정할 수 있습니다. SSL/TLS를 사용하도록 선택한 경우 위에 언급된 필수조건에서 생성된 키 저장소 값을 입력합니다.
7. ThingWorx Foundation이 설치된 후 License Configurator가 표시됩니다.
a. Setup: Configure licensing for ThingworxFoundation for Postgres 또는 Setup: Configure licensing for ThingworxFoundation for Mssql 화면에서 Next를 클릭합니다.
b. License Configurator를 사용하여 PTC 라이선스 서버에 연결하거나 미리 다운로드된 라이선스를 사용하여 ThingWorx Foundation를 구성합니다.
c. 라이선스 화면을 따라 단계별로 실행합니다.
8. ThingWorx Foundation 설치가 완료되었습니다.
* 
설치 후 Tomcat에 필요한 메모리 증가에 대한 자세한 내용은 PTC 지원 문서 CS306401을 참조하십시오.
Windows에서 ThingWorx Foundation 서비스 시작/중지
1. services.msc로 이동합니다.
2. ThingWorx-Foundation 서비스를 찾습니다.
3. 이 서비스를 시작하거나 중지합니다.
Linux에 ThingWorx Foundation 설치
1. 위의 단원에서 설명한 필수조건을 충족하는지 확인합니다.
2. ThingWorx 호스트에 관리자로 로그인합니다.
3. PostgreSQL의 경우, support.ptc.com의 소프트웨어 다운로드 > 소프트웨어 업데이트 주문 또는 다운로드 > ThingWorx Foundation > Release 8.5 > ThingWorx PostgreSQL > 최근 제조코드에서 ThingWorx-Platform-Foundation-Installer-8–5-0-Linux-postgres를 다운로드합니다.
또는
Microsoft SQL Server의 경우, support.ptc.com의 소프트웨어 다운로드 > 소프트웨어 업데이트 주문 또는 다운로드 > ThingWorx Foundation > Release 8.5 > ThingWorx Mssql > 최근 제조코드에서 ThingWorx-Platform-Foundation-Installer-8–5-0-Linux-mssql을 다운로드합니다.
4. 빌드의 압축을 풉니다.
5. PostgreSQL의 경우, ThingWorxFoundationPostgres-8.5.0-x86_64.run을 실행합니다.
또는
Microsoft SQL Server의 경우, ThingWorxFoundationMSSQL-8.5.0-x86_64.run을 실행합니다.
6. 설치 관리자 화면을 따라 단계별로 실행합니다.
* 
ThingWorx Foundation 속성 화면에는 보안 연결을 위해 SSL/TLS 사용 확인란이 기본적으로 선택되어 있습니다. 이 확인란을 선택 취소하여 설치 관리자에서 SSL/TLS를 사용하지 않도록 설정할 수 있습니다. SSL/TLS를 사용하도록 선택한 경우 위에 언급된 필수조건에서 생성된 키 저장소 값을 입력합니다.
7. ThingWorx Foundation이 설치된 후 License Configurator가 표시됩니다.
a. Setup: Configure licensing for ThingworxFoundation for Postgres 또는 Setup: Configure licensing for ThingworxFoundation for Mssql 화면에서 Next를 클릭합니다.
b. License Configurator를 사용하여 PTC 라이선스 서버에 연결하거나 미리 다운로드된 라이선스를 사용하여 ThingWorx Foundation를 구성합니다.
c. 라이선스 화면을 따라 단계별로 실행합니다.
8. ThingWorx Foundation 설치가 완료되었으며 이제 ThingWorx Foundation을 사용할 수 있습니다.
Linux에서 ThingWorx Foundation 서비스 시작/중지
1. 관리 권한이 있는 사용자로 ThingWorx 호스트에 로그인합니다(sudo 실행).
2. 서비스를 시작하려면 sudo systemctl start ThingWorx-Foundation을 입력합니다.
3. 서비스를 중지하려면 sudo systemctl stop ThingWorx-Foundation을 입력합니다.
ThingWorx Foundation 서버에 연결
1. ThingWorx Foundation URL에 액세스합니다.
예: https://<호스트 이름>:<포트>/Thingworx/Composer
ThingWorx Foundation URL은 설치 과정에서 사용한 SSL/비 SSL 및 포트의 구성에 따라 다릅니다. SSL은 기본적으로 활성화되어 있습니다. 그러나 SSL/TLS를 비활성화할 수 있습니다. 위의 설치 관리자에서 SSL/TLS 활성화를 위한 필수조건 단원을 참조하십시오.
2. 사용자 자격 증명을 제공합니다.
사용자 이름은 Administrator이며 암호는 설치 과정에서 입력한 암호입니다.
설치 관리자 로그 파일
설치
Linux
Windows
ThingWorx Foundation
설치 로그:
• ${installdir}/installer/logs/ThingWorxFoundation_install.log
예: /opt/ThingWorxFoundation-8.5.0/installer/logs/ThingWorxFoundation_install.log
실행 중인 로그:
• ${installdir}/ThingworxStorage/logs/
예: /opt/ThingWorxFoundation-8.5.0/ThingworxStorage/logs/
설치 로그:
• ${installdir}\installer\logs\ThingWorxFoundation_install.log
예: C:\Program Files (x86)\ThingWorxFoundation-8.5.0\installer\logs\ThingWorxFoundation_install.log
실행 중인 로그:
• ${installdir}\ThingworxStorage\logs\
예: C:\Program Files (x86)\ThingWorxFoundation-8.5.0\ThingworxStorage\logs\
ThingWorx Foundation 설치 관리자 기반 설치 제거
1. ThingWorx Foundation 설치 위치로 이동합니다.
2. Windows에서 ThingWorxFoundation_uninstall.exe를 실행합니다.
또는
Linux에서 ThingWorxFoundation_uninstall.dat를 실행합니다.
3. 메시지가 표시되면 확인을 클릭하여 제거를 계속할 것인지 확인합니다.
4. 제거가 완료되면 설치가 삭제됩니다. 설치 제거 로그는 설치 위치에 저장됩니다.
PostgreSQL에서 ThingWorx 데이터베이스 삭제
1. Windows 또는 Linux의 명령줄에서 PostgreSQL 데이터베이스에 대한 연결을 엽니다.
예를 들어 psql -U admin -h dbhost를 입력합니다.
2. 기본 데이터베이스 이름을 사용하는 경우 DROP DATABASE thingworx; 명령을 실행합니다.
또는 데이터베이스 이름을 사용자 정의한 경우 DROP DATABASE <your database name>; 명령을 실행합니다.
Microsoft SQL에서 ThingWorx 데이터베이스 삭제
1. Windows 또는 Linux의 명령줄에서 Microsoft SQL 데이터베이스에 대한 연결을 엽니다.
예를 들어 sqlcmd -U admin -s ‘dbhost\dbservicename,port’를 입력합니다.
2. 기본 데이터베이스 이름을 사용하는 경우 DROP DATABASE thingworx; GO; 명령을 실행합니다.
또는 데이터베이스 이름을 사용자 정의한 경우 DROP DATABASE <your database name>; GO; 명령을 실행합니다.