Windows 用 ThingWorx Foundation インストーラ
A.) Windows インストーラと Azure PostgreSQL フレキシブルサーバーの必要条件
| ThingWorx インストーラではファイル名にスペースを使用することはお勧めしません。スペース文字が含まれているファイルパスを使用して ThingWorx をインストールしようとすると、ThingWorx インストーラで問題が発生します。スペースを使用する必要がある場合、管理者が Windows の 8dot3 のサポートを有効にする必要があります。 |
• Azure PostgreSQL フレキシブルサーバーで Windows 用 ThingWorx Foundation インストーラを実行するには、以下が必要です。サポートされているバージョンの詳細については、
「システム要件」を参照してください。
◦ Java 11 がインストールされている
| 9.3.0 以降では Java 11 が必要です。 • Java 11 のインストールディレクトリを使用するように Java_Home 変数を設定します。 |
◦ Windows に管理者権限がある。
◦ 接続を許可するように ThingWorx データベースが設定されている。
◦ 以下を付与された ThingWorx データベースの所有者としてデータベースユーザーが設定されている。
▪ ThingWorx データベースでこのユーザーにすべての権限が付与されている。
▪ can login プロパティが yes に設定されている。
インストーラで ThingWorx データベースのユーザー名としてこのデータベースユーザーが入力されます。
次のテーブルに、適用される必要条件を示します。
データベース接続 | 必要条件 |
---|
リモート | • ご使用の PostgreSQL バージョンと互換性のある psql クライアントをインストールします。 • 次の手順に従って、インストールした psql を PATH 環境変数に追加します。 b. pgadmin クライアントをインストールします。 c. PATH 環境変数を更新して、pgadmin クライアントがインストールされているパスに追加します。 |
B.) Windows インストーラと PostgreSQL の必要条件
| ThingWorx インストーラではファイル名にスペースを使用することはお勧めしません。スペース文字が含まれているファイルパスを使用して ThingWorx をインストールしようとすると、ThingWorx インストーラで問題が発生します。スペースを使用する必要がある場合、管理者が Windows の 8dot3 のサポートを有効にする必要があります。 |
• PostgreSQL で Windows 用 ThingWorx Foundation インストーラを実行するには、以下が必要です。サポートされているバージョンについては、
システム要件を参照してください。
◦ Java 11 がインストールされている
◦ Windows に管理者権限がある
◦ 接続可能でエンコーディングが UTF-8 に設定されている ThingWorx データベース
▪ データベースプロパティ Connection_LIMIT が -1 に設定されていなければなりません。これはデフォルト値であり、認証されたすべてのユーザーに対してデータベースへの無制限の接続を許可します。
◦ ThingWorx データベースの所有者として設定されている以下のようなデータベースユーザー。
▪ ThingWorx データベースでこのユーザーにすべての権限が付与されている。
▪ can login プロパティが yes に設定されている。
インストーラで ThingWorx データベースのユーザー名としてこのデータベースユーザーが入力されます。
◦ ローカルまたはリモートのデータベース接続。次のテーブルに、適用される必要条件を示します。
データベース接続 | 必要条件 |
---|
ローカル | • PostgreSQL がインストールされており、PostgreSQL/bin へのパスが PATH 環境変数に存在する。 • Java JDK がインストールされている java/bin が PATH 環境変数に含まれていることを確認します。 • pg_hba.conf ファイルを更新することによって、ThingWorx Foundation のホストから PostgreSQL への接続が許可されている。 たとえば、ThingWorx Foundation が PostgreSQL と同じホストにインストールされている場合、 pg_hba.conf ファイルを更新して、パスワード認証方法を md5、 password、または trust に設定できます。ただし、これを trust に設定することはお勧めしません。 pg_hba conf ファイルとパスワード認証方法の詳細については、 PostgreSQL.org の Web サイトを参照してください。 次に、パスワード認証が 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 環境変数に追加します。次の手順を実行できます。 b. pgadmin クライアントをインストールします。 c. PATH 環境変数を更新して、pgadmin クライアントがインストールされているパスに追加します。 |
C.) Windows インストーラと SQL Server の必要条件
| ThingWorx インストーラではファイル名にスペースを使用することはお勧めしません。スペース文字が含まれているファイルパスを使用して ThingWorx をインストールしようとすると、ThingWorx インストーラで問題が発生します。スペースを使用する必要がある場合、管理者が Windows の 8dot3 のサポートを有効にする必要があります。 |
Microsoft SQL Server で Windows 用 ThingWorx Foundation インストーラを実行するには、以下が必要です。サポートされているバージョンについては、
システム要件を参照してください。
• Java 11 がインストールされている
| 9.3.0 以降では Java 11 が必要です。 • Java 11 のインストールディレクトリを使用するように JAVA_HOME 変数を設定します。 |
• 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 がインストールされている。 java/bin が PATH 環境変数に含まれている。 |
リモート | • sqlcmd がインストールされ、PATH 環境変数に含まれている。 |
D.) インストーラで SSL/TLS を有効にするための必要条件: キーストアの作成
| -Xms および -Xmx の値を、使用可能な OS メモリの 75% (たとえば、16GB RAM システムの場合は 12GB) に設定します。 Xms および Xmx の値は MB 単位でなければなりません。詳細については、 「JVM チューニング」を参照してください。 |
インストーラの「ThingWorx Foundation のプロパティ」画面で、デフォルトでは「セキュア接続に SSL/TLS を使用」チェックボックスがオンになっています。このチェックボックスをオフにすることで、インストーラでの SSL/TLS の使用を無効にできます。デフォルト設定を維持し、SSL/TLS を使用する場合は、インストーラを実行する前に Java キーストア (.jks) ファイルを生成しなければなりません。Java キーストア (.jks) ファイルには、以下のセキュリティアクセス許可が必要です。
• Windows 上のネットワークサービスユーザープロファイルに、キーストアファイルに対する読み取りおよび読み取り/実行のアクセス許可が付与されている必要があります。
キーストアを生成する方法はいくつかあり、その 1 つを以下に示します。
1. Java/bin に移動します。
2. Tomcat キーストアファイル (.jks ファイル) を作成するには、次のコマンドを実行します: keytool -genkey -alias selfsigned -keyalg RSA -keystore keyStore.jks -keysize 2048 -storetype jks
3. キーストアのパスワードを入力します。このパスワードは後でサーバーを設定する際に必要になります。
| パスワードに一重引用符 (')、二重引用符 ('')、または節 (§) が含まれていてはなりません (値を囲むこともできません)。 |
4. 組織単位や組織などのその他の値を入力します。
5. プロンプトが表示された場合、キーストアのパスワードを入力します。
E.) Windows への ThingWorx Foundation のインストール
1. 上記のセクションで説明されている必要条件が満たされていることを確認します。
2. PostgreSQL または
Azure PostgreSQL フレキシブルサーバーの場合、
support.ptc.com の > > > > > から、
ThingWorx-Platform-Foundation-Installer-x-x-x-Windows-postgres をダウンロードします。
または
Microsoft SQL Server の場合、
support.ptc.com の > > > > > から、
ThingWorx-Platform-Foundation-Installer-x-x-x-Windows-mssql をダウンロードします。
3. ビルドを抽出します。
4. PostgreSQL または Azure PostgreSQL フレキシブルサーバーの場合、ThingWorxFoundationPostgres-9.x.x-x64.exe を実行します。
または
Microsoft SQL Server の場合、ThingWorxFoundationMSSQL-9.x.x-x64.exe を実行します。
5. インストーラの画面に従って手順を実行します。
| 「ThingWorx Foundation のプロパティ」画面で、デフォルトでは 「セキュア接続に SSL/TLS を使用」チェックボックスがオンになっています。このチェックボックスをオフにすることで、インストーラでの SSL/TLS の使用を無効にできます。SSL/TLS を使用する場合、 前述の必要条件の手順で生成したキーストアの値を入力します。 |
6. 最後のインストーラ画面では、「Open License Configurator」チェックボックスがデフォルトでオンになっています。このチェックボックスがオンになっている場合、インストーラが完了して閉じた後、ライセンスコンフィギュレータが開きます。「Open License Configurator」チェックボックスをオフにした場合、インストーラが閉じた後でライセンスコンフィギュレータは自動的に開きません。
a. 「Setup : Configure licensing for ThingworxFoundation for Postgres」または「Setup : Configure licensing for ThingworxFoundation for Mssql」画面で「次へ」をクリックします。
b. ライセンスコンフィギュレータを使用して PTC ライセンスサーバーに接続するか、事前にダウンロードしたライセンスを使用するように ThingWorx Foundation を設定します。
c. ライセンスの画面に従って手順を実行します。
7. ThingWorx Foundation のインストールが完了しました。
F.) コンテンツセキュリティポリシーの有効化 (手動の手順)
ThingWorx 5.0.1 以降をインストールする場合、CSP をサポートするように手動で platform-settings.json を更新する必要があります。ThingWorx Foundation インストーラは、CSP 機能の有効化または無効化をサポートしていません。デフォルトでは、CSP は platform-settings.json で有効にするまで無効です。
プラットフォームの設定を手動で更新するには、次のように platform-settings.json の BasicSettings の下に "EnableContentSecurityPolicyFilter": false, を追加します。
{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/ThingworxBackupStorage",
"DatabaseLogRetentionPolicy": 7,
"DatabaseWriteRetryAttempts": 10,
"EnableBackup": true,
"EnableClusteredMode": false,
"EnableContentSecurityPolicyFilter": false,
"EnableSystemLogging": false,
"EnableSSO": false,
"FileRepositoryRoot": "/ThingworxStorage",
"FileTransferLockType" : "LOCAL"
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"InternalAesCryptographicKeyLength": 128,
"MetricsLoggingFrequency": 30,
"MetricsLoggingLevel": "WARN",
"MetricsReportingEnabled": true,
"NonceKeyTimeout": 15,
"SessionUpdateDelay": 60,
"Storage": "/ThingworxStorage",
"ScriptTimeout": 30,
"MaxSearchItems": 100000
},
| 上記のフラグが追加されていないか、明示的に false に設定されている場合、CSP は新しいインストールでは無効になります。フラグを true に設定すると、CSP が有効になります。CSP の詳細については、 コンテンツセキュリティポリシーを参照してください。 |
G.) ThingWorx Foundation サーバーへの接続
1. ThingWorx Foundation の URL にアクセスします。
例: https://<ホスト名>:<ポート>/Thingworx/Composer。
ThingWorx Foundation の URL は、SSL/非 SSL の設定とセットアップ中に使用されるポートによって異なります。SSL はデフォルトで有効になっていますが、SSL/TLS の使用は無効にできます。上記の「インストーラで SSL/TLS を有効にするための必要条件」セクションを参照してください。
2. ユーザーの資格証明を指定します。
ユーザー名は Administrator で、パスワードはセットアップ中に入力したものです。
H.) インストーラのその他の機能とトラブルシューティング
Windows での ThingWorx Foundation サービスの開始/停止
1. Services.msc に移動します。
2. ThingWorx-Foundation サービスを見つけます。
3. 開始または停止します。
インストーラのログファイルの検索
• インストールログ:
◦ ${installdir}\installer\logs\ThingWorxFoundation_install.log
例: C:\Program Files (x86)\ThingWorxFoundation\installer\logs\ThingWorxFoundation_install.log。
• 実行ログ:
◦ ${installdir}\ThingworxStorage\logs\
例: C:\Program Files (x86)\ThingWorxFoundation\ThingworxStorage\logs\。
• 中止または失敗の場合:
◦ ${system_temp_directory}\ThingWorxFoundation_Failed_installs\
例: C:\Users\vagrant\AppData\Local\Temp\ThingWorxFoundation_Failed_installs\。
• アンインストールログ:
◦ ${system_temp_directory}\bitrock_installer_(pid).log
ログファイル名にはプレフィックス bitrock が付きます。例: C:\Users\vagrant\AppData\Local\Temp\bitrock_installer_3008.log。
ThingWorx Foundation インストーラベースのインストールのアンインストール
1. ThingWorx Foundation のインストール場所に移動します。
2. ThingWorxFoundation_uninstall.exe を実行します。
3. プロンプトが表示されたら、「OK」をクリックして、アンインストールを続行することを確認します。
4. アンインストールが完了すると、セットアップは削除されます。
PostgreSQL からの ThingWorx データベースの削除
1. Windows のコマンドラインから、PostgreSQL データベースへの接続を開きます。
たとえば、「psql -U admin -h dbhost」と入力します。
2. デフォルトのデータベース名を使用している場合、コマンド DROP DATABASE thingworx; を実行します。
データベース名をカスタマイズしている場合、コマンド DROP DATABASE <your database name>; を実行します。
Microsoft SQL からの ThingWorx データベースの削除
1. Windows のコマンドラインから、Microsoft SQL データベースへの接続を開きます。
たとえば、「sqlcmd -U admin -s ‘dbhost\dbservicename,port’」と入力します。
2. デフォルトのデータベース名を使用している場合、コマンド DROP DATABASE thingworx; GO; を実行します。
データベース名をカスタマイズしている場合、コマンド DROP DATABASE <your database name>; GO; を実行します。
Windows におけるサービスコンフィギュレーションの変更で問題が発生し、詳細情報を確認する場合、以下を実行して詳細情報を /tomat/current/logs/ ディレクトリの下の commons-daemon.log ファイルに記録します。tomcat9w.exe //ES//ThingWorx-Foundation --LogLevel Debug