transactd 1.0.1-x86-mswin32-100
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/BUILD_UNIX-JA +174 -0
- data/BUILD_WIN-JA +256 -0
- data/CMakeLists.txt +96 -0
- data/COPYING +339 -0
- data/README +406 -0
- data/README-JA +424 -0
- data/bin/1.9/transactd.so +0 -0
- data/bin/2.0/transactd.so +0 -0
- data/bin/common/tdclc_32_1_0.dll +0 -0
- data/bin/common/tdclcpp_vc100_32m_1_1.dll +0 -0
- data/build/common/copyifgreater.cmd +30 -0
- data/build/common/copyifgreater.js +290 -0
- data/build/common/system.cmake +122 -0
- data/build/tdclrb/bldgem/extconf.rb +123 -0
- data/build/tdclrb/gem/INSTALLLOG.win32 +9 -0
- data/build/tdclrb/gem/Makefile.win32-VS +65 -0
- data/build/tdclrb/gem/Makefile.win32-prebuilt +48 -0
- data/build/tdclrb/gem/detect.rb +31 -0
- data/build/tdclrb/gem/helper.rb +113 -0
- data/build/tdclrb/gem/transactd.rb +22 -0
- data/source/bzs/test/tdclrb/bench_tdclcpp.rb +375 -0
- data/source/bzs/test/tdclrb/prepare.rb +226 -0
- data/source/bzs/test/tdclrb/transactd_datetime_spec.rb +172 -0
- data/source/bzs/test/tdclrb/transactd_kanjischema_spec.rb +208 -0
- data/source/bzs/test/tdclrb/transactd_spec.rb +1536 -0
- data/transactd.gemspec +97 -0
- metadata +76 -0
data/README
ADDED
@@ -0,0 +1,406 @@
|
|
1
|
+
Transactd release note
|
2
|
+
===============================================================================
|
3
|
+
Transactd is plugin which adds NoSQL access to MySQL/MariaDB.
|
4
|
+
|
5
|
+
This document consists of the following topics.
|
6
|
+
* Introduction
|
7
|
+
* Preparation of Transactd Plugin binary
|
8
|
+
* Installing Transactd Plugin
|
9
|
+
* Preparation of Transactd clients binaries
|
10
|
+
* Installing Transactd clients
|
11
|
+
* Setting host permission to access Transactd
|
12
|
+
* Execution of test and benchmark program
|
13
|
+
* Development of applications using Transactd clients
|
14
|
+
* Details of the test program
|
15
|
+
* Details of the benchmark program
|
16
|
+
* About the license of Transactd Plugin
|
17
|
+
* About the license of Transactd Client
|
18
|
+
* Bug reporting, requests and questions
|
19
|
+
* Copyright of related products
|
20
|
+
|
21
|
+
|
22
|
+
|
23
|
+
Introduction
|
24
|
+
-------------------------------------------------------------------------------
|
25
|
+
Transactd consists of the server side plugin and the client side modules.
|
26
|
+
The server side plugin is called "Transactd Plugin" and the client side module
|
27
|
+
is called "Transactd clients".
|
28
|
+
|
29
|
+
|
30
|
+
|
31
|
+
Preparation of Transactd Plugin binary
|
32
|
+
-------------------------------------------------------------------------------
|
33
|
+
Check the version of your MySQL/MariaDB and download suitable Transactd Plugin
|
34
|
+
binary. If you don't know what is version, start MySQL Command Line client and
|
35
|
+
run following command:
|
36
|
+
```
|
37
|
+
mysql>show variables like 'version';
|
38
|
+
+---------------+--------+
|
39
|
+
| Variable_name | Value |
|
40
|
+
+---------------+--------+
|
41
|
+
| version | 5.6.14 |
|
42
|
+
+---------------+--------+
|
43
|
+
```
|
44
|
+
The names of file to download are formed under following rules:
|
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
|
+
[platform] is win32 or win64, [mysql-version] is mysql-5.x.x or mariadb-5.5.x.
|
50
|
+
For example, the URL for Linux-x86_64bit mysql-5.6.14 is as follows:
|
51
|
+
|
52
|
+
http://www.bizstation.jp/al/transactd/download/transactd-1.1.0/transactd-linux-x86_64-1.1.0_mysql-5.6.14.tar.gz
|
53
|
+
|
54
|
+
You also can download source code archive and build from it.
|
55
|
+
In this case, the source code of MySQL/MariaDB is also required.
|
56
|
+
|
57
|
+
See BUILD_WIN-{lang}.md or BUILD_UNIX-{lang}.md in the source code archive
|
58
|
+
for how to build.
|
59
|
+
|
60
|
+
|
61
|
+
|
62
|
+
Installing Transactd Plugin
|
63
|
+
-------------------------------------------------------------------------------
|
64
|
+
Transactd Plugin can be installed by copying file, without adding any change to
|
65
|
+
the binary of MySQL/MariaDB.
|
66
|
+
You don't have to stop MySQL/MariaDB to install the plugin. It requires
|
67
|
+
administrator authority.
|
68
|
+
|
69
|
+
### Installing on Windows
|
70
|
+
1. Open the zip file downloaded in Explorer. Check if transactd.dll is exists.
|
71
|
+
|
72
|
+
2. Copy transactd.dll to `[MySQL|MariaDB installed directory]/lib/plugin`.
|
73
|
+
If you don't know where is [MySQL|MariaDB installed directory], start MySQL
|
74
|
+
Command Line client and run following command:
|
75
|
+
```
|
76
|
+
mysql>show variables like 'plugin%';
|
77
|
+
+---------------+----------------------------------------------------+
|
78
|
+
| Variable_name | Value |
|
79
|
+
+---------------+----------------------------------------------------+
|
80
|
+
| plugin_dir | C:\Program Files\MySQL\MySQL Server 5.6\lib\Plugin |
|
81
|
+
+---------------+----------------------------------------------------+
|
82
|
+
```
|
83
|
+
|
84
|
+
3. Start MySQL Command Line client and run following command:
|
85
|
+
```
|
86
|
+
mysql>INSTALL PLUGIN transactd SONAME 'transactd.dll';
|
87
|
+
```
|
88
|
+
Installation of Transactd Plugin is finished now.
|
89
|
+
|
90
|
+
|
91
|
+
### Installing on Linux
|
92
|
+
1. Move to the directory where downloaded tar.gz file is.
|
93
|
+
```
|
94
|
+
shell>cd [TargetFolder]
|
95
|
+
```
|
96
|
+
|
97
|
+
2. Extract the tar.gz file and move into it.
|
98
|
+
```
|
99
|
+
shell>tar zxf transactd-linux-x86_64-1.1.0_mysql-5.6.14.tar.gz
|
100
|
+
shell>cd transactd-linux-x86_64-1.1.0_mysql-5.6.14
|
101
|
+
```
|
102
|
+
|
103
|
+
3. Copy libtransactd.so to `[MySQL|MariaDB installed directory]/lib/plugin`.
|
104
|
+
If you don't know where is [MySQL|MariaDB installed directory], start MySQL
|
105
|
+
Command Line client and run following command:
|
106
|
+
```
|
107
|
+
mysql>show variables like 'plugin%';
|
108
|
+
+---------------+-----------------------------+
|
109
|
+
| Variable_name | Value |
|
110
|
+
+---------------+-----------------------------+
|
111
|
+
| plugin_dir | /usr/local/mysql/lib/plugin |
|
112
|
+
+---------------+-----------------------------+
|
113
|
+
mysql>exit
|
114
|
+
shell>cp libtransactd.so /usr/local/mysql/lib/plugin/
|
115
|
+
```
|
116
|
+
|
117
|
+
4. Start mysql client and run following command:
|
118
|
+
```
|
119
|
+
mysql>INSTALL PLUGIN transactd SONAME 'libtransactd.so';
|
120
|
+
```
|
121
|
+
Installation of Transactd Plugin is finished now.
|
122
|
+
|
123
|
+
|
124
|
+
|
125
|
+
Preparation of Transactd client binaries
|
126
|
+
-------------------------------------------------------------------------------
|
127
|
+
The Transactd clients are required to access data through Transactd Plugin.
|
128
|
+
Download the Transactd client binaries for your platform.
|
129
|
+
The names of file to download are formed under following rules:
|
130
|
+
|
131
|
+
* Windows - transactd-client-[platform]_with_sdk-1.1.0.msi
|
132
|
+
* Linux - transactd-client-linux-x86_64_with_sdk-1.1.0.tar.gz
|
133
|
+
|
134
|
+
[platform] is win32 or win64.
|
135
|
+
For example, the URL for Linux-x86_64bit is as follows:
|
136
|
+
|
137
|
+
http://www.bizstation.jp/al/transactd/download/transactd-client/transactd-client-linux-x86_64_with_sdk-1.1.0.tar.gz
|
138
|
+
|
139
|
+
|
140
|
+
|
141
|
+
Installing Transactd clients
|
142
|
+
-------------------------------------------------------------------------------
|
143
|
+
|
144
|
+
### Installing on Windows
|
145
|
+
1. Double click transactd-client-[platform]_with_sdk-1.1.0.msi will start
|
146
|
+
installation by Windows installer.
|
147
|
+
|
148
|
+
If you want to install the clients for Embarcadero C++Builder XE series, select
|
149
|
+
[custom] on setup type selection window. Installable target compiler is:
|
150
|
+
|
151
|
+
* Microsoft Visual studio 2010 (Include ActiveX(COM) client)
|
152
|
+
* Embarcadero C++Builder XE series
|
153
|
+
|
154
|
+
For Microsoft Visual studio is certainly installed.
|
155
|
+
|
156
|
+
|
157
|
+
### Installing on Linux
|
158
|
+
1. Move to the directory where downloaded tar.gz file is.
|
159
|
+
```
|
160
|
+
shell>cd [TargetFolder]
|
161
|
+
```
|
162
|
+
|
163
|
+
2. Extract the tar.gz file and move into it.
|
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. Run the install script.
|
170
|
+
```
|
171
|
+
shell>./install_client.sh
|
172
|
+
```
|
173
|
+
Installation of Transactd client is finished now.
|
174
|
+
|
175
|
+
|
176
|
+
|
177
|
+
Setting host permission to access Transactd
|
178
|
+
-------------------------------------------------------------------------------
|
179
|
+
To access data through Transactd, register root@[host] to user table of MySQL.
|
180
|
+
|
181
|
+
* `root@127.0.0.1` allows access from a local machine.
|
182
|
+
* `root@192.168.0.3` allows access from host 192.168.0.3.
|
183
|
+
* `root@192.168.0.0/255.255.255.0` allows access from host 192.168.0.x.
|
184
|
+
|
185
|
+
Start MySQL Command Line client and run following commands to register hosts.
|
186
|
+
```
|
187
|
+
mysql>CREATE USER root@'192.168.0.0/255.255.255.0';
|
188
|
+
```
|
189
|
+
This operation allow root user to access database. If the root password is not set,
|
190
|
+
you MUST SET IT.
|
191
|
+
|
192
|
+
### Setup root password on Windows
|
193
|
+
Open command prompt and run following command:
|
194
|
+
```
|
195
|
+
shell>"C:\Program Files\MySQL\MySQL Server 5.6\bin\mysqladmin" -u root password 'xxxxx'
|
196
|
+
```
|
197
|
+
(Replace xxxxx to your password.)
|
198
|
+
|
199
|
+
### Setup root password on Linux
|
200
|
+
```
|
201
|
+
shell>/usr/local/mysql/bin/mysqladmin -u root password 'xxxxx'
|
202
|
+
```
|
203
|
+
(Replace xxxxx to your password.)
|
204
|
+
|
205
|
+
### Using other name than root
|
206
|
+
It is also possible to register another user name than "root".
|
207
|
+
In order to use another user name, please add the following to the [mysqld] section
|
208
|
+
of my.cnf or my.ini.
|
209
|
+
```
|
210
|
+
loose-transactd_hostcheck_username = yourUserName
|
211
|
+
```
|
212
|
+
Replace yourUserName to an actual user name.
|
213
|
+
|
214
|
+
|
215
|
+
|
216
|
+
Execution of test and benchmark program
|
217
|
+
-------------------------------------------------------------------------------
|
218
|
+
See also the detail of the test and the benchmark program topic.
|
219
|
+
|
220
|
+
### Executing on Windows
|
221
|
+
1. Click [Start menu]-[All programs]-[BizStation]-[Transactd Client]-
|
222
|
+
[Test (compiler)(charset)] or [Benchmark local (compiler)].
|
223
|
+
(compiler) is VC100 or BCB. (charset) is Unicode or Multibyte.
|
224
|
+
|
225
|
+
### Executing on Linux
|
226
|
+
1. Move to the client directory.
|
227
|
+
```
|
228
|
+
shell>cd transactd-client-linux-x86_64_with_sdk-1.1.0
|
229
|
+
```
|
230
|
+
|
231
|
+
2. run test:
|
232
|
+
```
|
233
|
+
./exec_test_local.sh
|
234
|
+
```
|
235
|
+
|
236
|
+
|
237
|
+
|
238
|
+
Development of applications using Transactd clients
|
239
|
+
-------------------------------------------------------------------------------
|
240
|
+
Refer to the following SDK documents for development of the applications
|
241
|
+
using Transactd clients.
|
242
|
+
|
243
|
+
http://www.bizstation.jp/ja/transactd/client/sdk/doc/
|
244
|
+
|
245
|
+
|
246
|
+
|
247
|
+
Details of the test program
|
248
|
+
-------------------------------------------------------------------------------
|
249
|
+
The executable file which starts with test_ is a Test program.
|
250
|
+
|
251
|
+
Please be sure to run test with only an instance. It will fail if test runs two or
|
252
|
+
more instances.
|
253
|
+
If others access to test database during test runs, fail to drop database and can't
|
254
|
+
release database.
|
255
|
+
In such a case, reboot a server or run following command in MySQL command line client
|
256
|
+
to drop a database.
|
257
|
+
```
|
258
|
+
mysql>drop database test;
|
259
|
+
```
|
260
|
+
|
261
|
+
If `-- showprogress=yes` is passed, it shows progress like:
|
262
|
+
```
|
263
|
+
0% 10 20 30 40 50 60 70 80 90 100%
|
264
|
+
|----|----|----|----|----|----|----|----|----|----|
|
265
|
+
************
|
266
|
+
```
|
267
|
+
|
268
|
+
Using `-- host=xxxxx` can specify host.
|
269
|
+
The test using Japanese database name, table name and field name.
|
270
|
+
To pass this test, set `character-set-server` as cp932 or utf8 in my.cnf.
|
271
|
+
```
|
272
|
+
[mysqld]
|
273
|
+
character-set-server=utf8
|
274
|
+
```
|
275
|
+
|
276
|
+
|
277
|
+
|
278
|
+
Details of the benchmark program
|
279
|
+
-------------------------------------------------------------------------------
|
280
|
+
By changing processNumber argument, the benchmark program can be ran two or more
|
281
|
+
instances simultaneously, and can measure them. The command line option is:
|
282
|
+
```
|
283
|
+
bench_tdclcpp_xxx.exe databaseUri processNumber functionNumber
|
284
|
+
|
285
|
+
|----------------|--------------------------------------------------------|
|
286
|
+
| option name | description |
|
287
|
+
|----------------|--------------------------------------------------------|
|
288
|
+
| databaseUri | URI of a database. |
|
289
|
+
|----------------|--------------------------------------------------------|
|
290
|
+
| processNumber | Specify different number to run two or more instances. |
|
291
|
+
|----------------|--------------------------------------------------------|
|
292
|
+
| functionNumber | Specify the operation number. |
|
293
|
+
| | The operations: |
|
294
|
+
| | -1: all of following |
|
295
|
+
| | 0: Insert |
|
296
|
+
| | 1: Insert in transaction. 20rec x 1000times |
|
297
|
+
| | 2: Insert by bulkmode. 20rec x 1000times |
|
298
|
+
| | 3: read each record |
|
299
|
+
| | 4: read each record with snapshot |
|
300
|
+
| | 5: read range. 20rec x 1000times |
|
301
|
+
| | 6: read range with snapshot . 20rec x 1000times |
|
302
|
+
| | 7: update |
|
303
|
+
| | 8: update in transaction. 20rec x 1000times |
|
304
|
+
|----------------|--------------------------------------------------------|
|
305
|
+
ex)
|
306
|
+
shell>bench_tdclcpp_c_bcb_64.exe "tdap://localhost/test?dbfile=test.bdf" 0 -1
|
307
|
+
```
|
308
|
+
|
309
|
+
|
310
|
+
|
311
|
+
About the license of Transactd Plugin
|
312
|
+
-------------------------------------------------------------------------------
|
313
|
+
According to the license of MySQL/MariaDB, Transactd Plugin can be used under
|
314
|
+
General Public License (GPLv2). The license information is in COPYING.
|
315
|
+
|
316
|
+
|
317
|
+
|
318
|
+
About the license of Transactd clients
|
319
|
+
-------------------------------------------------------------------------------
|
320
|
+
You can select the license of Transactd clients from General Public License
|
321
|
+
(GPLv2) or commercial license.
|
322
|
+
|
323
|
+
* The license information of GPLv2 is in COPYING file.
|
324
|
+
* You can examine a commercial license which not restricted by GPLv2 if wants.
|
325
|
+
* Please see BizStation website about the details of licenses.
|
326
|
+
[BizStation website](http://www.bizstation.jp/en/transactd/support/)
|
327
|
+
|
328
|
+
See also "Transactd clients OSS Exception" for OSS projects not subject to GPLv2.
|
329
|
+
- [Transactd clients OSS Exception](http://www.bizstation.jp/en/transactd/support/ossex.html)
|
330
|
+
|
331
|
+
|
332
|
+
|
333
|
+
Bug reporting, requests and questions
|
334
|
+
-------------------------------------------------------------------------------
|
335
|
+
* If you find any bugs or if you have any requests, please send it to Issues
|
336
|
+
tracker on github. It requires github account(free).
|
337
|
+
- [Transactd Issues](https://github.com/bizstation/transactd/issues)
|
338
|
+
* If you have any questions, please see our website or send to Issues tracker
|
339
|
+
on github above.
|
340
|
+
- [Transactd Documents](http://www.bizstation.jp/ja/transactd/documents/)
|
341
|
+
- [Transactd License/Support](http://www.bizstation.jp/ja/transactd/support/)
|
342
|
+
|
343
|
+
|
344
|
+
|
345
|
+
********************************************************************************
|
346
|
+
|
347
|
+
The copyrights of products related to Transactd Plugin and clients are below.
|
348
|
+
|
349
|
+
********************************************************************************
|
350
|
+
The following software may be included in Transactd Plugin and Client:
|
351
|
+
Boost Software License - Version 1.0 - August 17th, 2003
|
352
|
+
|
353
|
+
Permission is hereby granted, free of charge, to any person or organization
|
354
|
+
obtaining a copy of the software and accompanying documentation covered by
|
355
|
+
this license (the "Software") to use, reproduce, display, distribute,
|
356
|
+
execute, and transmit the Software, and to prepare derivative works of the
|
357
|
+
Software, and to permit third-parties to whom the Software is furnished to
|
358
|
+
do so, all subject to the following:
|
359
|
+
|
360
|
+
The copyright notices in the Software and this entire statement, including
|
361
|
+
the above license grant, this restriction and the following disclaimer,
|
362
|
+
must be included in all copies of the Software, in whole or in part, and
|
363
|
+
all derivative works of the Software, unless such copies or derivative
|
364
|
+
works are solely in the form of machine-executable object code generated by
|
365
|
+
a source language processor.
|
366
|
+
|
367
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
368
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
369
|
+
FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
|
370
|
+
SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
|
371
|
+
FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
|
372
|
+
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
373
|
+
DEALINGS IN THE SOFTWARE.
|
374
|
+
|
375
|
+
|
376
|
+
********************************************************************************
|
377
|
+
The following software may be included in Transactd Plugin:
|
378
|
+
HandlerSocket plugin for MySQL
|
379
|
+
|
380
|
+
Copyright (c) 2010 DeNA Co.,Ltd.
|
381
|
+
All rights reserved.
|
382
|
+
|
383
|
+
Redistribution and use in source and binary forms, with or without
|
384
|
+
modification, are permitted provided that the following conditions are met:
|
385
|
+
|
386
|
+
* Redistributions of source code must retain the above copyright
|
387
|
+
notice, this list of conditions and the following disclaimer.
|
388
|
+
* Redistributions in binary form must reproduce the above copyright
|
389
|
+
notice, this list of conditions and the following disclaimer in the
|
390
|
+
documentation and/or other materials provided with the distribution.
|
391
|
+
* Neither the name of DeNA Co.,Ltd. nor the names of its contributors
|
392
|
+
may be used to endorse or promote products derived from this software
|
393
|
+
without specific prior written permission.
|
394
|
+
|
395
|
+
THIS SOFTWARE IS PROVIDED BY DeNA Co.,Ltd. "AS IS" AND ANY EXPRESS OR
|
396
|
+
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
397
|
+
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
|
398
|
+
EVENT SHALL DeNA Co.,Ltd. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
399
|
+
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
400
|
+
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
401
|
+
OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
402
|
+
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
403
|
+
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
404
|
+
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
405
|
+
|
406
|
+
********************************************************************************
|