Microsoft SQL Server 설정
Microsoft SQL Server용 샘플 Docker Compose 파일은 PTC 소프트웨어 다운로드 사이트의 ThingWorx Platform 부분에서 다운로드할 수 있는 Dockerfile에 포함되어 있습니다.
 |
초기 메모리는 2GB로 설정되어 있고 최대 메모리는 4GB로 설정되어 있습니다. 볼륨 마운트는 docker-compose 파일에 상대적입니다. 이 위치는 컨테이너에서 지속성을 지원하기 위해 로그 및 구성 파일이 저장되는 곳입니다.
|
플랫폼 서비스의 environment 섹션에 다음 옵션을 추가하여 이 인스턴스의 구성을 제어할 수 있습니다.
|
변수 이름
|
값
|
기본값
|
설명
|
||
|---|---|---|---|---|---|
|
DATABASE_HOST
|
문자열
|
mssql
|
SQL Server 데이터베이스 호스트의 호스트 이름, 서비스 이름 또는 IP 주소를 지정합니다.
|
||
|
DATABASE_PORT
|
숫자
|
1433
|
SQL Server 데이터베이스의 포트 번호를 지정합니다.
|
||
|
DATABASE_ADMIN_USERNAME
|
문자열
|
SA
|
SQL Server 데이터베이스의 관리자 사용자 이름을 지정합니다. 컨테이너를 성공적으로 생성하려면 제공된 기본값을 사용해야 합니다.
|
||
|
DATABASE_ADMIN_PASSWORD
|
문자열
|
PASSWORD
|
SQL Server 데이터베이스의 관리자 암호를 지정합니다. DATABASE_ADMIN_PASSWORD의 값과 SA_PASSWORD의 값이 동일해야 합니다.
|
||
|
DB_TYPE
|
문자열
|
mssql
|
기본 지속성 공급자의 이름을 지정합니다. 참고: 이 변수는 ThingWorx 9.3.0 이상 버전에서 지원되지 않습니다.
|
||
|
SA_PASSWORD
|
문자열
|
PASSWORD
|
SA 암호를 지정합니다. DATABASE_ADMIN_PASSWORD의 값과 SA_PASSWORD의 값이 동일해야 합니다.
|
||
|
ENABLE_HTTP
|
true/false
|
true
|
컨테이너에 대한 비보안 트래픽을 위해 Tomcat에서 HTTP 커넥터를 활성화합니다.
|
||
|
ENABLE_HTTPS
|
true/false
|
false
|
컨테이너에 대한 보안 트래픽을 위해 Tomcat에서 HTTPS 커넥터를 활성화합니다. 또한 키 저장소를 제공하고 SSL_KEYSTORE_PASSWORD를 설정해야 합니다.
|
||
|
SSL_KEYSTORE_PASSWORD
|
문자열
|
PASSWORD
|
Tomcat에서 SSL 통신에 사용되는 키 저장소의 암호를 지정합니다.
|
||
|
SSL_KEYSTORE_BASE_PATH
|
문자열
|
/ThingworxPlatform
|
Tomcat SSL 키 저장소의 경로를 지정합니다. 기본 폴더가 아닌 컨테이너의 위치에 키 저장소를 저장한 경우 이 변수를 설정해야 합니다.
|
||
|
SSL_KEYSTORE_FILENAME
|
문자열
|
keystore.jks
|
Tomcat SSL 키 저장소에 대한 파일 이름을 지정합니다. 키 저장소의 파일 이름이 기본 이름이 아닌 경우 이 변수를 설정해야 합니다.
|
||
|
TOMCAT_SSL_PROTOCOLS
|
문자열
|
TLSv1.2
|
Tomcat SSL 프로토콜을 지정합니다. Tomcat에서 허용된 SSL 프로토콜을 재정의하려면 이 변수를 설정합니다.
|
||
|
SERVER_HTTP_PORT
|
문자열
|
8080
|
Tomcat이 HTTP 통신을 모니터링하는 포트를 지정합니다. 이 포트가 변경되면 Compose 파일에 제공된 포트를 변경해야 합니다.
|
||
|
SERVER_HTTPS_PORT
|
문자열
|
8443
|
Tomcat이 HTTPS 통신을 모니터링하는 포트를 지정합니다. 이 포트가 변경되면 Compose 파일에 제공된 포트를 변경해야 합니다.
|
||
|
DOCKER_DEBUG
|
true/false
|
false
|
컨테이너가 시작될 때 디버깅 정보를 기록하는 옵션을 전환합니다. 여기에는 중요한 정보가 포함될 수 있습니다.
|
||
|
TWX_DATABASE_USERNAME
|
문자열
|
""
|
데이터베이스에 대해 작성될 ThingWorx 사용자를 지정합니다. 이 변수는 ThingWorx Platform을 시작하기 전에 수동으로 설정해야 합니다.
|
||
|
TWX_DATABASE_PASSWORD
|
문자열
|
""
|
데이터베이스에 대한 ThingWorx 사용자의 암호를 지정합니다. 이 변수는 ThingWorx Platform을 시작하기 전에 수동으로 설정해야 합니다.
|
||
|
TWX_DATABASE_SCHEMA
|
문자열
|
""
|
ThingWorx 인스턴스의 스키마 이름을 지정합니다. 이 변수는 ThingWorx Platform을 시작하기 전에 수동으로 설정해야 합니다.
|
||
|
LS_USERNAME
|
문자열
|
""
|
ThingWorx 라이선스를 받을 PTC 로그인 사용자 이름을 지정합니다.
|
||
|
LS_PASSWORD
|
문자열
|
""
|
ThingWorx 라이선스를 받을 PTC 로그인 암호를 지정합니다.
|
||
|
ENABLE_BACKUP
|
true/false
|
false
|
백업 옵션을 전환합니다.
|
||
|
ENABLE_LOGGING
|
true/false
|
true
|
로깅 옵션을 전환합니다.
|
||
|
ENCRYPT_CREDENTIALS
|
true/false
|
false
|
platform-settings.json 파일에서 데이터베이스 및 라이선스의 암호를 암호화하는 옵션을 전환합니다.
|
||
|
THINGWORX_INITIAL_ADMIN_PASSWORD
|
문자열
|
""
|
ThingWorx의 관리자 사용자에 대한 초기 암호를 설정합니다. 이 변수는 ThingWorx Platform을 시작하기 전에 수동으로 설정해야 합니다. ThingWorx가 성공적으로 시작된 후 이 암호를 변경할 수 있습니다.
|
||
|
THINGWORX_INITIAL_METRICS_USER_PASSWORD
|
문자열
|
""
|
ThingWorx의 MetricsUser에 대한 초기 암호를 설정합니다. 이는 선택적 변수입니다. ThingWorx Platform을 시작하기 전에 수동으로 설정합니다. ThingWorx가 성공적으로 시작된 후 이 암호를 변경할 수 있습니다.
|
||
|
EXTPKG_IMPORT_POLICY_ENABLED
|
true/false
|
false
|
확장 패키지 업로더를 통한 확장 패키지 가져오기의 전역 활성화/비활성화를 제어합니다.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_JARRES
|
true/false
|
false
|
Jar(Java) 리소스가 포함된 확장 패키지에 대한 가져오기 권한을 제어합니다. false로 설정되어 있고 확장에 jar 파일이 포함되어 있으면 가져오기가 실패합니다.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_JSRES
|
true/false
|
false
|
Javascript 리소스가 포함된 확장 패키지에 대한 가져오기 권한을 제어합니다. false로 설정되어 있고 확장에 Javascript 파일이 포함되어 있으면 가져오기가 실패합니다.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_CSSRES
|
true/false
|
false
|
CSS 리소스가 포함된 확장 패키지에 대한 가져오기 권한을 제어합니다. false로 설정되어 있고 확장에 css 파일이 포함되어 있으면 가져오기가 실패합니다.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_JSONRES
|
true/false
|
false
|
JSON 리소스가 포함된 확장 패키지에 대한 가져오기 권한을 제어합니다. false로 설정되어 있고 확장에 json 파일이 포함되어 있으면 가져오기가 실패합니다.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_WEBAPPRES
|
true/false
|
false
|
WebApps 리소스가 포함된 확장 패키지에 대한 가져오기 권한을 제어합니다. false로 설정되어 있고 확장에 WebApp 리소스 파일이 포함되어 있으면 가져오기가 실패합니다.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_ENTITIES
|
true/false
|
false
|
확장할 수 없는 엔티티 정의가 포함된 확장 패키지에 대한 가져오기 권한을 제어합니다. false로 설정되어 있고 확장에 확장 패키지 엔티티 외의 확장할 수 없는 엔티티 정의가 포함되어 있으면 가져오기가 실패합니다.
|
||
|
EXTPKG_IMPORT_POLICY_ALLOW_EXTENTITIES
|
true/false
|
false
|
확장할 수 있는 엔티티 정의가 포함된 확장 패키지에 대한 가져오기 권한을 제어합니다. false로 설정되어 있고 확장에 확장 패키지 엔티티 외의 확장할 수 있는 엔티티 정의가 포함되어 있으면 가져오기가 실패합니다.
|
||
|
ENABLE_CONSOLE_OUTPUT
|
true/false
|
false
|
콘솔 로깅을 활성화합니다.
|
||
|
ENABLE_CLUSTERED_MODE
|
true/false
|
false
|
클러스터 모드를 활성화하려면 true로 설정합니다.
|
||
|
HTTP_PORT
|
숫자
|
Null
|
HTTP 통신에 사용되는 포트가 SERVER_HTTP_PORT와 일치해야 합니다. 서비스 검색에 사용됩니다.
|
||
|
HTTP_SERVICE_NAME
|
문자열
|
thingworx-http
|
ThingWorx Platform에 대한 HTTP 서비스 이름입니다. 서비스 검색에 사용됩니다.
|
||
|
HTTPS_PORT
|
숫자
|
Null
|
HTTPS 통신에 사용되는 포트가 SERVER_HTTPS_PORT와 일치해야 합니다. 서비스 검색에 사용됩니다.
|
||
|
HTTPS_SERVICE_NAME
|
문자열
|
thingworx-https
|
ThingWorx Platform에 대한 HTTPS 서비스 이름입니다. 서비스 검색에 사용됩니다.
|
||
|
TOMCAT_SSL_CIPHERS
|
문자열
|
“”
|
쉼표로 구분된 암호화 제품군의 선택적 목록입니다. HTTPS 연결을 나열된 암호화로만 제한합니다. 설정하지 않으면 기본 JVM 암호가 사용됩니다.
|
||
|
TOMCAT_COMPRESSION
|
on/off/force
|
off
|
Tomcat 압축을 활성화하거나 비활성화합니다. 커넥터는 서버 대역폭을 절약하기 위해 HTTP/1.1 GZIP 압축을 사용할 수 있습니다. 허용되는 값에는 off(압축 비활성화), on(압축 허용, 텍스트 데이터가 압축될 수 있음) 및 force(모든 경우에 압축 적용)가 포함됩니다.
|
||
|
TOMCAT_COMPRESSION_MIN_SIZE
|
숫자
|
2048
|
TOMCAT_COMPRESSION이 on으로 설정되면 출력 압축을 시작하기 전까지의 최소 데이터 양을 지정합니다.
|
||
|
TOMCAT_USE_SEND_FILE
|
true/false
|
true
|
sendfile 기능을 활성화하거나 비활성화합니다. sendfile을 사용하면 Tomcat이 응답에 대해 수행했을 수 있는 모든 압축이 비활성화됩니다.
|
||
|
COORDINATOR_HOSTS
|
문자열
|
“”
|
Zookeeper 끝점의 쉼표로 구분된 목록입니다. 각 끝점은 _host_:_port_입니다.
|
||
|
IGNITE_ZK_CONNECTION
|
문자열
|
“”
|
서비스 검색에 사용되는 Zookeeper 호스트 및 포트
|
||
|
ZK_SSL_ENABLED
|
true/false
|
false
|
Zookeeper에 SSL을 사용합니다.
|
||
|
ZK_SSL_KEYSTORE_LOCATION
|
문자열
|
/certs/zookeeper.p12
|
Zookeeper 키 저장소의 경로입니다.
|
||
|
ZK_SSL_KEYSTORE_PASSWORD
|
문자열
|
“”
|
Zookeeper 키 저장소에 대한 암호입니다.
|
||
|
ZK_SSL_TRUSTSTORE_LOCATION
|
문자열
|
“”
|
Zookeeper 신뢰 저장소의 경로입니다.
|
||
|
ZK_SSL_TRUSTSTORE_PASSWORD
|
문자열
|
“”
|
Zookeeper 키 저장소에 대한 암호입니다.
|
||
|
CATALINA_OPTS
|
문자열
|
“”
|
Tomcat에 전달되는 Java 런타임 옵션입니다.
|
||
|
DATABASE_ADMIN_SCHEMA
|
문자열
|
postgres
|
DB 서버의 기본 스키마 이름입니다.
|
||
|
TWX_KEYSTORE_PASSWORD
|
문자열
|
“”
|
ThingWorx 키 저장소 암호를 설정하는 데 사용할 암호입니다. 설정하지 않으면 처음 부팅할 때 ThingWorx에서 임의로 암호를 만듭니다.
HA 설정과 이전 데이터/볼륨 복원에 특정 암호를 사용하려면 이 암호를 설정하십시오.
|
||
|
SECRET_CX_APP_KEY
|
문자열
|
“”
|
Connection Server에서 ThingWorx에 연결하는 데 사용할 응용 프로그램 키입니다.
|
||
|
SECRET_PROVISIONING_APP_KEY
|
문자열
|
“”
|
처음 시작할 때 ThingWorx 프로비저닝에 사용되는 응용 프로그램 키입니다.
|
||
|
EXTPKG_IMPORT_POLICY_HA_COMPATIBILITY_LEVEL
|
WARN/DENY
|
WARN
|
HA와 호환되는 확장을 허용할지 거부할지 여부를 제어하는 확장 가져오기 정책 구성입니다. 옵션은 WARN 또는 DENY입니다.
WARN으로 설정한 경우 HA 호환이 아닌 확장을 응용 프로그램 로그에 기록된 경고와 함께 가져옵니다.
DENY로 설정한 경우 HA 호환인 확장만 가져올 수 있습니다.
|
||
|
ENABLE_PROPERTY_TRANSFORM
|
true/false
|
false
|
Property Transform을 활성화하려면 true로 설정합니다.
|
||
|
PROPERTY_TRANSFORM_RABBITMQ_HOST
|
“”
|
localhost
|
Property Transform에 사용할 RabbitMQ 호스트입니다.
|
||
|
PROPERTY_TRANSFORM_RABBITMQ_PORT
|
문자열
|
5672
|
Property Transform에 사용할 RabbitMQ 포트입니다.
|
||
|
PROPERTY_TRANSFORM_RABBITMQ_USERNAME
|
문자열
|
admin
|
Property Transform에 사용할 RabbitMQ 사용자 이름입니다.
|
||
|
PROPERTY_TRANSFORM_RABBITMQ_PASSWORD
|
문자열
|
“”
|
Property Transform에 사용할 RabbitMQ 암호입니다.
|
||
|
PROPERTY_TRANSFORM_RABBITMQ_VHOST
|
문자열
|
/
|
Property Transform에 사용할 RabbitMQ Vhost입니다.
|
||
|
IGNITE_SSL_ACTIVE
|
true/false
|
false
|
Ignite에 SSL을 사용합니다.
|
||
|
IGNITE_KEYSTORE_FILE_PATH
|
문자열
|
/certs/ignite.pfx
|
Ignite 키 저장소의 경로입니다.
|
||
|
IGNITE_KEYSTORE_PASSWORD
|
문자열
|
“”
|
Ignite 키 저장소에 대한 암호입니다.
|
||
|
ZK_SASL_ENABLED
|
true/false
|
false
|
Zookeeper에서 SASL 인증을 사용합니다.
|
||
|
ZK_SASL_SECURITY_AUTH_LOGIN_CONFIG
|
문자열
|
/tmp1/jaas.conf
|
JAAS 구성 파일의 경로입니다.
|
||
|
ZK_SASL_SECURITY_KRB5_CONF
|
문자열
|
/tmp1/krb5.conf
|
Kerberos 구성 파일의 경로입니다.
|
||
|
AKKA_SSL_ENABLED
|
true/false
|
true
|
tls Akka 통신을 켜거나 끕니다.
|
||
|
AKKA_KEYSTORE
|
문자열
|
/certs/keystore.jks
|
Akka 키 저장소의 경로를 인증서 볼륨에 저장할 수 있습니다. 예를 들어, /certs/keystore.jks입니다.
|
||
|
AKKA_TRUSTSTORE
|
문자열
|
/certs/truststore.jks
|
Akka 신뢰 저장소의 경로를 인증서 볼륨에 저장할 수 있습니다. 예를 들어, /certs/truststore.jks입니다.
|
||
|
AKKA_KEYSTORE_PASSWORD
|
문자열
|
기본값은 설정되어 있지 않습니다.
|
AKKA_KEYSTORE의 암호입니다.
|
||
|
AKKA_TRUSTSTORE_PASSWORD
|
문자열
|
기본값은 설정되어 있지 않습니다.
|
AKKA_TRUSTSTORE의 암호입니다.
|
볼륨 경로를 사이트에 특정한 위치로 변경할 수도 있습니다. 볼륨 경로에는 다음 구문이 사용됩니다.
"./path_to_local_mount:/path_to_container_mount"
예를 들면, 다음과 같습니다.
"/opt/ThingworxPlatform:/ThingworxPlatform"
|
|
볼륨 경로를 업데이트할 때 마운트 지점으로서의 로컬 마운트만 변경하십시오. 내부 컨테이너는 변경하지 않아야 합니다.
|
MS SQL Server Docker 이미지는 테스트 용이성을 위해 제공됩니다. 제공된 MS SQL Server Docker 이미지를 생산 용도로는 사용하지 마십시오. 생산에 적합한 고유한 MS SQL Server 환경을 설정하는 것이 가장 좋습니다.
Docker 외부에 있는 Microsoft SQL Server 데이터베이스에 연결하려면 Compose 파일에서 mssql 서비스를 제거하고 다음 변수를 platform 환경 변수에 추가합니다.
• DATABASE_ADMIN_USERNAME
• DATABASE_ADMIN_PASSWORD
다음은 최초 시작 시 ThingWorx 컨테이너가 로드하는 사용자, 데이터베이스 또는 스키마를 만들 권한이 있는 Microsoft SQL Server 데이터베이스에 대한 관리자 계정입니다. 외부 Microsoft SQL Server 데이터베이스를 사용하기 위한 플랫폼 설정이 포함된 예제 Compose 파일은 ThingWorx Docker에 외부 Microsoft SQL Server 데이터베이스 사용 항목을 참조하십시오.
외부 데이터베이스를 사용하는 경우 ThingWorx Docker 컨테이너에 대한 관리자 자격 증명을 제공하지 않고 수동으로 ThingWorx 스키마를 설치할 수 있습니다. 이렇게 하려면 DATABASE_HOST, DATABASE_PORT, TWX_DATABASE_USERNAME, TWX_DATABASE_PASSWORD 및 TWX_DATABASE_SCHEMA 변수를 적절히 설정합니다.