ThingWorx 用 MSSQL データベースのセットアップ: Windows
MSSQL Server では、ユーザーを作成する前にログインを作成しなければなりません。ログインはデータベースの外に作成されます。この後で、データベースが作成されます。データベース内にユーザーが作成され、作成したログインが割り当てられます。次に、データベース内にスキーマが作成されます。最後に、前の手順で作成されたユーザーがスキーマの所有者になります。ThingWorx に関しては、SSMS を使用して twadmin ログインを手動で作成します。残りの手順は、bat スクリプトを実行することによって行います。
 |
Windows を使用していない場合、ThingWorx 用 MSSQL データベースのセットアップ: Linuxのセクションに進みます。
|
twadmin ログインの作成
|
|
以下の手順を実行する前に、Windows マシンへの SQL Server Management Studio (データベース管理クライアント) のインストールの各セクションの手順を実行していることを確認してください。
|
GUI またはコマンドラインを使用してログインを作成できます。
|
|
GUI での手順を以下に示します。SSMS でクエリーエディタを使用している場合、以下の Transact-SQL コマンドを入力します。
CREATE LOGIN twadmin WITH PASSWORD = '<password>';
|
1. SQL Server Management Studio (SSMS) で、オブジェクトエクスプローラを開き、新規ログインを作成するサーバーインスタンスのフォルダを展開します。
2. Security フォルダを右クリックして「新規」をポイントし、「ログイン」をクリックします。
3. 「全般」ページで、「ログイン名」ボックスに新規ログインの名前を入力します。
4. 「SQL Server 認証」を選択します。
5. ログインのパスワードを入力します。
6. 「OK」をクリックします。
データベースセットアップスクリプトの設定および実行
1. ThingWorx ソフトウェアダウンロードからデータベースセットアップスクリプト (thingworxMssqlDBSetup.bat) を取得します。
2. コマンドプロンプトを開き、ディレクトリをスクリプトフォルダに変更します。
3. 以下のコマンドを入力します。
thingworxMssqlDBSetup.bat -h <server> -i <server-instance> -p <port> -a <database-admin-user-name> -r <password> -l <login-name> -d <thingworx-database-name> -u <thingworx-user-name> -s <schema-name>
4. 実行時に、database-admin-user のパスワードが尋ねられます。パスワードを入力し、Enter キーを押します。
5. 照合を設定します。SQL Server Management Studio を使用して照合を設定するには、「データベース」 > 「プロパティ」 > 「オプション」の順に選択し、ドロップダウンメニューから「Latin1_General_100_CS_AS_SC」を選択します。
6. 以下のプロパティを ON に設定します。
◦ READ_COMMITTED_SNAPSHOT
◦ ALLOW_SNAPSHOT_ISOLATION
スクリプトが実行されると、データベースが作成され、データベース内にユーザーが作成されて、ユーザーにログインが関連付けられます。このユーザーに、作成されたデータベース上の db_owner ロールが割り当てられます。コマンドラインで指定した場合、スキーマも作成されます。作成されたユーザーに、このスキーマの認証が与えられます。
|
オプション
|
パラメータ
|
デフォルト
|
説明
|
例
|
||
|---|---|---|---|---|---|---|
|
-h
|
server
|
localhost
|
データベースサーバーの FQDN または IP
|
-h 10.0.0.221
|
||
|
-i
|
server-instance
|
<空白>
|
データベースのインストール時に指定したインスタンス名。
|
-i SQLEXPRESS
|
||
|
-p
|
port
|
1433
|
SQL Server のポート
|
-p 1433
|
||
|
-a
|
database-admin-user-name
|
sa
|
適切な権限を持つ管理者ユーザーの名前。
|
-a sa
|
||
|
-l
|
login-name
|
twadmin
|
上記で手動で作成したログインの名前。
|
-l twadmin
|
||
|
-d
|
thingworx-database-name
|
thingworx
|
データベースの名前。
|
-d thingworx
|
||
|
-u
|
thingworx-user-name
|
<ログイン名と同じ>
|
データベース内に作成されるユーザーの名前。
|
-u twadmin
|
||
|
-s
|
schema-name
|
twschema
|
ThingWorx データベース内に作成されるスキーマの名前。
|
-s twschema
|
||
|
-r
|
password
|
Password@123
|
データベース管理者ユーザーのパスワード
|
"Password@123"
|
モデル/データプロバイダスキーマスクリプトの設定および実行
1. コマンドプロンプトで、bat ファイル (thingworxMssqlSchemaSetup.bat) に (以下の表に一覧されている) 適切なパラメータを指定して実行します。
thingworxMssqlSchemaSetup.bat -h <server> -i <server-instance> -p <port> -l <login-name> -r <password> -d <thingworx-database-name> -o <option (all,model,data,property,modelwithproperty)>
bat ファイルを実行すると、スクリプトごとに、(上の手順で手動で作成した) ログインのパスワードが尋ねられます。毎回パスワードを入力し、Enter キーを押します。
|
|
このスクリプトを実行すると、次のような警告が表示されます: Warning! The maximum key length for a clustered index is 900 bytes. The index 'data_table_indexes_pkey' has maximum length of 902 bytes. For some combination of large values, the insert/update operation will fail.
|
これらのスクリプトを実行すると、ThingWorx Platform のセットアップに必要なすべてのテーブル、インデックス、プロシージャなどが、デフォルトスキーマ twschema を使用した thingworx データベース内に作成されます。
|
オプション
|
パラメータ
|
デフォルト
|
説明
|
例
|
||
|---|---|---|---|---|---|---|
|
-h
|
server
|
localhost
|
データベースサーバーの FQDN または IP
|
-h 10.0.0.221
|
||
|
-i
|
server-instance
|
<空白>
|
データベースのインストール時に指定したインスタンス名
|
-i SQLEXPRESS
|
||
|
-p
|
port
|
1433
|
SQL Server のポート
|
-p 1433
|
||
|
-l
|
login-name
|
twadmin
|
上記で手動で作成したログインの名前。
|
-l twadmin
|
||
|
-d
|
thingworx-database-name
|
thingworx
|
データベースの名前。
|
-d thingworx
|
||
|
-o
|
option
|
all
|
すべてのスクリプト/モデル/データ/プロパティ/モデル+プロパティを実行します。
|
-o all
|
||
|
-r
|
password
|
Password@123
|
login-name のパスワード
|
"Password@123"
|
データベースクリーンアップスクリプトの設定および実行
便宜上および開発/テスト用に、データベースクリーンアップ bat スクリプト (thingworxMssqlDBCleanup.bat) が提供されています。このセクションの各手順は、データベースのすべてのオブジェクトとデータを消去して、再び新たに開始できるようにする場合にだけ実行する必要があります。
1. コマンドプロンプトで、bat ファイルに (以下の表に一覧されている) 適切なパラメータを指定して実行します。
thingworxMssqlDBCleanup.bat -h <server> -i <server-instance> -p <port> -a <database-admin-user-name> -r <password> -d <thingworx-database-name>
|
オプション
|
パラメータ
|
デフォルト
|
説明
|
例
|
||
|---|---|---|---|---|---|---|
|
-h
|
server
|
localhost
|
データベースサーバーの FQDN または IP
|
-h 10.0.0.221
|
||
|
-i
|
server-instance
|
<空白>
|
データベースのインストール時に指定したインスタンス名
|
-i SQLEXPRESS
|
||
|
-p
|
port
|
1433
|
SQL Server のポート
|
-p 1433
|
||
|
-a
|
database-admin-user-name
|
sa
|
適切な権限を持つ管理者ユーザーの名前。
|
-a sa
|
||
|
-d
|
thingworx-database-name
|
thingworx
|
データベースの名前。
|
-d thingworx
|
||
|
-r
|
password
|
Password@123
|
データベース管理者ユーザーのパスワード
|
"Password@123"
|