transactd 1.0.1-x86-mswin32-100

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/README-JA ADDED
@@ -0,0 +1,424 @@
1
+ Transactd リリースノート
2
+ ===============================================================================
3
+ Transactd PluginはMySQL/MariaDBにNoSQLアクセスを追加するプラグインです。
4
+
5
+ このドキュメントは以下のトピックスから構成されています。
6
+ * はじめに
7
+ * Transactd Pluginバイナリの準備
8
+ * Transactd Pluginのインストール
9
+ * Transactdクライアントバイナリの準備
10
+ * Transactdクライアントのインストール
11
+ * Transactdへのアクセス可能ホストの設定
12
+ * テストとベンチマークの起動
13
+ * アプリケーションの開発
14
+ * Testプログラム
15
+ * ベンチマークプログラム
16
+ * Transactd Pluginのライセンス
17
+ * Transactdクライアントのライセンス
18
+ * バグ報告・要望・質問など
19
+ * 関連著作権の表示
20
+
21
+
22
+
23
+ はじめに
24
+ -------------------------------------------------------------------------------
25
+ Transactdはプラグインとして動作するサーバー側モジュールとクライアント側で動作す
26
+ るクライアント側モジュールから構成されます。
27
+ 以降はこれらを区別して、サーバー側をTransactd Plugin、クライアント側をTransactd
28
+ クライアントと呼びます。
29
+
30
+
31
+
32
+ Transactd Pluginバイナリの準備
33
+ -------------------------------------------------------------------------------
34
+ MySQL/MariaDBのバージョンを確認し、それに合ったビルド済Transactdをダウンロードし
35
+ ます。バージョンの確認はMySQLクライントを起動し以下のコマンドを入力します。
36
+ ```
37
+ show variables like 'version';
38
+ +---------------+--------+
39
+ | Variable_name | Value |
40
+ +---------------+--------+
41
+ | version | 5.6.14 |
42
+ +---------------+--------+
43
+ ```
44
+ ダウンロードするファイルは
45
+
46
+ * Windowsの場合 transactd-[platform]-1.1.0_[mysql-version].zip
47
+ * Linuxの場合 transactd-linux-x86_64-1.1.0_[mysql-version].tar.gz
48
+
49
+ といった形式です。
50
+ [platform]はwin32またはwin64、[mysql-version]はmysql-5.x.xまたはmariadb-5.5.xです。
51
+ たとえば、Linux-x86_64bit mysql-5.6.14用の完全なURLは以下の通りです。
52
+
53
+ http://www.bizstation.jp/al/transactd/download/transactd-1.1.0/transactd-linux-x86_64-1.1.0_mysql-5.6.14.tar.gz
54
+
55
+ また、ソースをダウンロードしてビルドすることもできます。その場合は、
56
+ MySQL/MariaDBのソースコードも必要です。ビルド方法はソースコード内の
57
+ BUILD_WIN-{lang}.mdまたはBUILD_UNIX-{lang}.mdをご覧ください。
58
+
59
+
60
+
61
+ Transactd Pluginのインストール
62
+ -------------------------------------------------------------------------------
63
+ MySQL/MariaDBのバイナリに変更を加えることなく、所定の位置にプラグインのファイル
64
+ をコピーするだけでインストールできます。MySQL/MariaDBサーバーは動作している状態
65
+ で作業を進めます。また、作業は管理者権限で進めます。
66
+
67
+ ### Windowsでのインストール
68
+ 1. ダウンロードしたzipファイルをエクスプローラで開きます。中にtransactd.dllがある
69
+ ことを確認します。
70
+
71
+ 2. [MySQL|MariaDBインストールフォルダ]/lib/pluginに、transactd.dllをコピーします。
72
+ MySQL|MariaDBインストールフォルダが不明な場合は、MySQL Command Line clientを
73
+ 起動し以下のコマンドでplugin_dirを確認してください。
74
+ ```
75
+ mysql>show variables like 'Plugin%';
76
+ +---------------+----------------------------------------------------+
77
+ | Variable_name | Value |
78
+ +---------------+----------------------------------------------------+
79
+ | plugin_dir | C:\Program Files\MySQL\MySQL Server 5.6\lib\plugin |
80
+ +---------------+----------------------------------------------------+
81
+ ```
82
+
83
+ 3. MySQL Command Line clientを起動し、以下のコマンドを実行します。
84
+ ```
85
+ mysql>INSTALL PLUGIN transactd SONAME 'transactd.dll';
86
+ ```
87
+ これでPluginのインストールは終了です。
88
+
89
+
90
+ ### Linuxでのインストール
91
+ 1. ダウンロードしたtar.gzのあるフォルダに移動します。
92
+ ```
93
+ shell>cd [TargetFolder]
94
+ ```
95
+
96
+ 2. ダウンロードしたtar.gzを解凍し、解凍したフォルダに移動します。
97
+ ```
98
+ shell>tar zxf transactd-linux-x86_64-1.1.0_mysql-5.6.14.tar.gz
99
+ shell>cd transactd-linux-x86_64-1.1.0_mysql-5.6.14
100
+ ```
101
+
102
+ 3. [MySQL|MariaDBインストールフォルダ]/lib/pluginに、libtransactd.soをコピー
103
+ します。MySQL|MariaDBインストールが不明な場合は、mysqlを起動し以下の
104
+ コマンドでplugin_dirを確認してください。
105
+ ```
106
+ mysql>show variables like 'plugin%';
107
+ +---------------+-----------------------------+
108
+ | Variable_name | Value |
109
+ +---------------+-----------------------------+
110
+ | plugin_dir | /usr/local/mysql/lib/plugin |
111
+ +---------------+-----------------------------+
112
+ mysql>exit
113
+ shell>cp libtransactd.so /usr/local/mysql/lib/plugin/
114
+ ```
115
+
116
+ 4. mysqlを起動し、以下のコマンドを実行します。
117
+ ```
118
+ mysql>INSTALL PLUGIN transactd SONAME 'libtransactd.so';
119
+ ```
120
+ これでPluginのインストールは終了です。
121
+
122
+
123
+
124
+ Transactdクライアントバイナリの準備
125
+ -------------------------------------------------------------------------------
126
+ Transactd Pluginを介してデータにアクセスするにはTransactdクライアントが必要です。
127
+ プラットフォームに合ったビルド済Transactdクライアントをダウンロードします。
128
+ ダウンロードするファイルは
129
+
130
+ * Windowsの場合 transactd-client-[platform]_with_sdk-1.1.0.msi
131
+ * Linuxの場合 transactd-client-linux-x86_64_with_sdk-1.1.0.tar.gz
132
+
133
+ といった形式です。[platform]はwin32またはwin64です。
134
+ たとえば、LINUXの完全なURLは以下の通りです。
135
+
136
+ http://www.bizstation.jp/al/transactd/download/transactd-client/transactd-client-linux-x86_64_with_sdk-1.1.0.tar.gz
137
+
138
+
139
+
140
+ Transactdクライアントのインストール
141
+ -------------------------------------------------------------------------------
142
+
143
+ ### Windowsでのインストール
144
+ 1. transactd-client-[platform]_with_sdk-1.1.0.msiをダブルクリックするとWindows
145
+ インストーラによるインストールが始まります。あとは画面に従ってインストールし
146
+ ます。
147
+
148
+ セットアップタイプの選択画面で[カスタム]を選択するとEmbarcadero C++Builder XE
149
+ シリーズ用のクライアントも選択できます。インストールできるコンパイラターゲットは
150
+
151
+ * Microsoft Visual studio 2010用 (ActiveX(COM)クライアントを含みます)
152
+ * Embarcadero C++Builder XEシリーズ用
153
+
154
+ の2種類です。Microsoft Visual studio 2010版については必ずインストールされます。
155
+
156
+
157
+ ### Linuxでのインストール
158
+ 1. ダウンロードしたtar.gzのあるフォルダに移動します。
159
+ ```
160
+ shell>cd [TargetFolder]
161
+ ```
162
+
163
+ 2. ダウンロードしたtar.gzを解凍し、解凍したフォルダに移動します。
164
+ ```
165
+ shell>tar zxf transactd-client-linux-x86_64_with_sdk-1.1.0.tar.gz
166
+ shell>cd transactd-client-linux-x86_64_with_sdk-1.1.0
167
+ ```
168
+
169
+ 3. インストールスクリプトを実行します。
170
+ ```
171
+ shell>./install_client.sh
172
+ ```
173
+ これでクライアントのインストールは終了です。
174
+
175
+
176
+
177
+ Transactdへのアクセス可能ホストの設定
178
+ -------------------------------------------------------------------------------
179
+ Transactdへアクセスするには、事前にMySQLのuserテーブルにroot@[host]レコードを
180
+ 登録しておく必要があります。
181
+
182
+ * ローカルからのアクセスであれば`root@127.0.0.1`を登録します。
183
+ * その他のホスト(たとえば192.168.0.3)であれば`root@192.168.0.3`を登録します。
184
+ * 192.168.0.xすべてであれば`root@192.168.0.0/255.255.255.0`とすることもできます。
185
+
186
+ 登録はMySQL Command Line clientを起動し以下のように入力します。
187
+ ```
188
+ mysql>CREATE USER root@'192.168.0.0/255.255.255.0';
189
+ ```
190
+ この操作はrootでのアクセスを可能にしますので、rootのパスワードが未設定の場合は、
191
+ 必ず設定してください。
192
+
193
+
194
+ ### Windowsでのrootパスワードの設定
195
+ コマンドプロンプトを開きます。
196
+ ```
197
+ shell>"C:\Program Files\MySQL\MySQL Server 5.6\bin\mysqladmin" -u root password 'xxxxx'
198
+ ```
199
+ (xxxxxは実際のパスワードに置き換えてください)
200
+
201
+
202
+ ### Linuxでのrootパスワードの設定
203
+ ```
204
+ shell>/usr/local/mysql/bin/mysqladmin -u root password 'xxxxx'
205
+ ```
206
+ (xxxxxは実際のパスワードに置き換えてください)
207
+
208
+
209
+ ### root以外のユーザー名を使用する
210
+ また、rootでのホスト設定ではなく別のユーザー名での登録も可能です。
211
+ 別のユーザー名にするには、my.cnfまたはmy.iniの[mysqld]セクションに、
212
+ ```
213
+ loose-transactd_hostcheck_username = yourUserName
214
+ ```
215
+ を加えてください。yourUserNameは任意のユーザー名にできます。
216
+
217
+
218
+
219
+ テストとベンチマークの起動
220
+ -------------------------------------------------------------------------------
221
+ Transactd Pluginとクライアントのインストールが済んだら、テストとベンチマーク
222
+ を実行できます。MySQL/MariaDBサーバーは動作している状態で作業を進めます。
223
+
224
+ テストとベンチマークの詳しい内容は、このトピックス以降にあるそれぞれのトピックス
225
+ を参照してください。
226
+
227
+ ### Windowsでの起動
228
+ 1. スタートメニューから[すべてのプログラム]-[BizStation]-[Transactd Client]-
229
+ [Test (compiler)(charset)]または[Benchmark local (compiler)]
230
+ をクリックします。
231
+ (compiler)はVC100またはBCBです。(charset)はUnicodeまたはMultibyteです。
232
+
233
+
234
+ ### Linuxでの起動
235
+ 1. クライアントのインストールで解凍したフォルダに移動します
236
+ ```
237
+ shell>cd transactd-client-linux-x86_64_with_sdk-1.1.0
238
+ ```
239
+
240
+ 2. テストの起動
241
+ ```
242
+ ./exec_test_local.sh
243
+ ```
244
+
245
+
246
+
247
+ アプリケーションの開発
248
+ -------------------------------------------------------------------------------
249
+ Transactdクライアントによるアプリケーションの開発は以下のSDKドキュメントを
250
+ 参照してください。
251
+
252
+ http://www.bizstation.jp/ja/transactd/client/sdk/doc/
253
+
254
+
255
+
256
+ Testプログラム
257
+ -------------------------------------------------------------------------------
258
+ test_で始まる実行ファイルはTestプログラムです。
259
+
260
+ 実行は必ず1つのプログラムのインスタンスで行ってください。複数のインスタンスで
261
+ 同時にtestを行うと失敗します。また、現在のバージョンではdrop databaseの際に他の
262
+ クライアントが動作しているとロックされたまま解放できない場合があります。そのよう
263
+ な場合はサーバーを再起動するか、MySQLコマンドラインクライアントにて
264
+ ```
265
+ mysql>drop database test;
266
+ ```
267
+ を実行しデータベースを事前に削除してください。
268
+
269
+ コマンドライン引数に `--showprogress=yes` を追加すると下記のように実行状況をプロ
270
+ グレス表示します。
271
+ ```
272
+ 0% 10 20 30 40 50 60 70 80 90 100%
273
+ |----|----|----|----|----|----|----|----|----|----|
274
+ ************
275
+ ```
276
+
277
+ また、`--host=xxxxx` とするとテストを実行するサーバーを指定できます。
278
+
279
+ テストの中に、データベース名、テーブル名、フィールド名に日本語を使ったテストがあ
280
+ ります。これらが成功するには、my.cnfにてcharacter-set-serverがcp932またはutf8に
281
+ 設定されている必要があります。
282
+ ```
283
+ [mysqld]
284
+ character-set-server=utf8
285
+ ```
286
+
287
+
288
+
289
+ ベンチマークプログラム
290
+ -------------------------------------------------------------------------------
291
+ ベンチマークプログラムは、コマンドライン引数のprocessNumberを変えることで複数の
292
+ インスタンスを同時に実行して計測することができます。
293
+ ベンチマークプログラムのコマンドラインオプションは以下の通りです。
294
+
295
+ ```
296
+ bench_tdclcpp_xxx.exe databaseUri processNumber functionNumber
297
+
298
+ |----------------|--------------------------------------------------------|
299
+ | パラメータ | 内容 |
300
+ |----------------|--------------------------------------------------------|
301
+ | databaseUri | データベースURIを指定します。 |
302
+ |----------------|--------------------------------------------------------|
303
+ | processNumber | 追加するデータの範囲を0からnで指定します。 |
304
+ | | 複数インスタンスによる同時実行の際に異なる番号を指定 |
305
+ | | することで、処理するレコードが競合しないようにします。 |
306
+ |----------------|--------------------------------------------------------|
307
+ | functionNumber | テストする処理を番号で指定します。 |
308
+ | | 処理は以下の通りです。 |
309
+ | | -1: all function |
310
+ | | 0: Insert |
311
+ | | 1: Insert in transaction. 20rec x 1000times |
312
+ | | 2: Insert by bulkmode. 20rec x 1000times |
313
+ | | 3: read each record |
314
+ | | 4: read each record with snapshot |
315
+ | | 5: read range. 20rec x 1000times |
316
+ | | 6: read range with snapshot . 20rec x 1000times |
317
+ | | 7: update |
318
+ | | 8: update in transaction. 20rec x 1000times |
319
+ |----------------|--------------------------------------------------------|
320
+ ex)
321
+ shell>bench_tdclcpp_c_bcb_64.exe "tdap://localhost/test?dbfile=test.bdf" 0 -1
322
+ ```
323
+
324
+
325
+
326
+ Transactd Pluginのライセンス
327
+ -------------------------------------------------------------------------------
328
+ MySQL/MariaDBのGPLv2ライセンスにより、Transactd PluginはGeneral Public License
329
+ (GPLv2)のもとで利用可能です。ライセンス情報はCOPYINGをご覧ください。
330
+
331
+
332
+
333
+ Transactdクライアントのライセンス
334
+ -------------------------------------------------------------------------------
335
+ TransactdクライアントのライセンスはGeneral Public License (GPLv2)と商用ライセ
336
+ ンスのいずれから選ぶことができます。
337
+
338
+ * GPLv2のライセンス情報はCOPYINGファイルをご覧ください。
339
+ * Transactdクライアントを利用して作成したアプリケーションについて、GPLv2の
340
+ 制限を受けたくない場合は、商用ライセンスをご検討ください。
341
+ * 商用ライセンスの購入については、[BizStationホームページ](
342
+ http://www.bizstation.jp/ja/transactd/support/)をご覧ください。
343
+
344
+ GPLv2以外のオープンソースプロジェクト向けの、TransactdクライアントOSS例外規定
345
+ も参照してください。
346
+ - [TransactdクライアントOSS例外規定](http://www.bizstation.jp/ja/transactd/support/ossex.html)
347
+
348
+
349
+
350
+ バグ報告・要望・質問など
351
+ -------------------------------------------------------------------------------
352
+ * バグ報告・要望は、github上のIssueトラッカーにお寄せください。Issueトラッカー
353
+ の利用にはgithubアカウント(無料)が必要です。
354
+ - [Transactd Issues](https://github.com/bizstation/transactd/issues)
355
+ * 質問については、ウェブサイトを参照するか、上記のIssueトラッカーにお寄せくだ
356
+ さい。
357
+ - [Transactd Documents](http://www.bizstation.jp/ja/transactd/documents/)
358
+ - [Transactd License/Support](http://www.bizstation.jp/ja/transactd/support/)
359
+
360
+
361
+
362
+ ********************************************************************************
363
+
364
+ 以下では、Transactd Plugin とTransactdクライアントに関係するBizStation以外
365
+ の著作権について表示します。
366
+
367
+ ********************************************************************************
368
+ The following software may be included in Transactd Plugin and Client:
369
+ Boost Software License - Version 1.0 - August 17th, 2003
370
+
371
+ Permission is hereby granted, free of charge, to any person or organization
372
+ obtaining a copy of the software and accompanying documentation covered by
373
+ this license (the "Software") to use, reproduce, display, distribute,
374
+ execute, and transmit the Software, and to prepare derivative works of the
375
+ Software, and to permit third-parties to whom the Software is furnished to
376
+ do so, all subject to the following:
377
+
378
+ The copyright notices in the Software and this entire statement, including
379
+ the above license grant, this restriction and the following disclaimer,
380
+ must be included in all copies of the Software, in whole or in part, and
381
+ all derivative works of the Software, unless such copies or derivative
382
+ works are solely in the form of machine-executable object code generated by
383
+ a source language processor.
384
+
385
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
386
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
387
+ FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
388
+ SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
389
+ FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
390
+ ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
391
+ DEALINGS IN THE SOFTWARE.
392
+
393
+
394
+ ********************************************************************************
395
+ The following software may be included in Transactd Plugin:
396
+ HandlerSocket plugin for MySQL
397
+
398
+ Copyright (c) 2010 DeNA Co.,Ltd.
399
+ All rights reserved.
400
+
401
+ Redistribution and use in source and binary forms, with or without
402
+ modification, are permitted provided that the following conditions are met:
403
+
404
+ * Redistributions of source code must retain the above copyright
405
+ notice, this list of conditions and the following disclaimer.
406
+ * Redistributions in binary form must reproduce the above copyright
407
+ notice, this list of conditions and the following disclaimer in the
408
+ documentation and/or other materials provided with the distribution.
409
+ * Neither the name of DeNA Co.,Ltd. nor the names of its contributors
410
+ may be used to endorse or promote products derived from this software
411
+ without specific prior written permission.
412
+
413
+ THIS SOFTWARE IS PROVIDED BY DeNA Co.,Ltd. "AS IS" AND ANY EXPRESS OR
414
+ IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
415
+ MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
416
+ EVENT SHALL DeNA Co.,Ltd. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
417
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
418
+ PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
419
+ OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
420
+ WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
421
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
422
+ ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
423
+
424
+ ********************************************************************************
Binary file
Binary file
Binary file
@@ -0,0 +1,30 @@
1
+ @echo off
2
+ @REM ===============================================================
3
+ @REM Copyright (C) 2013 BizStation Corp All rights reserved.
4
+ @REM
5
+ @REM This program is free software; you can redistribute it and/or
6
+ @REM modify it under the terms of the GNU General Public License
7
+ @REM as published by the Free Software Foundation; either version 2
8
+ @REM of the License, or (at your option) any later version.
9
+ @REM
10
+ @REM This program is distributed in the hope that it will be useful,
11
+ @REM but WITHOUT ANY WARRANTY; without even the implied warranty of
12
+ @REM MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13
+ @REM GNU General Public License for more details.
14
+ @REM
15
+ @REM You should have received a copy of the GNU General Public License
16
+ @REM along with this program; if not, write to the Free Software
17
+ @REM Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
18
+ @REM 02111-1307, USA.
19
+ @REM ===============================================================
20
+
21
+ @REM ***** CALL 64bit cmd.exe if exists! *****
22
+
23
+ :: SysNative alias is avalable if this is 32bit-cmd.exe on 64bit system.
24
+ :: %WinDir%\SysNative\cmd.exe is 64bit cmd.exe.
25
+ if exist %WinDir%\SysNative\cmd.exe (
26
+ %WinDir%\SysNative\cmd.exe /c cscript //nologo "%~dp0copyifgreater.js" %*
27
+ ) else (
28
+ cmd /c cscript //nologo "%~dp0copyifgreater.js" %*
29
+ )
30
+ exit /b %ERRORLEVEL%