技術的雑談-Berkeley DBの単体テストを実行する
環境
- 使用環境 ： CentOS 5.3 (x86_64) (VMware ESXi 4.0上)
- Berkelery DB ： 4.7.25
目的
- BDBをビルドした後にBDB自体の単体テストを実行する。
- BDBが正しくコンパイルできたか確認する。
手順
configureを--helpで見てみると「--enable-test」というのがある。
※BDBのソースtar.gzを展開したディレクトリ内のbuild_unixディレクトリにて
[root@hogehoge build_unix]# pwd
/usr/local/src/db-4.7.25/build_unix
[root@hogehoge build_unix]# ../dist/configure --help
`configure' configures Berkeley DB 4.7.25 to adapt to many kinds of systems.
Usage: ../dist/configure [OPTION]... [VAR=VALUE]...
To assign environment variables (e.g., CC, CFLAGS...), specify them as
VAR=VALUE. See below for descriptions of some of the useful variables.
Defaults for the options are specified in brackets.
Configuration:
-h, --help display this help and exit
--help=short display options specific to this package
--help=recursive display the short help of all the included packages
-V, --version display version information and exit
-q, --quiet, --silent do not print `checking...' messages
--cache-file=FILE cache test results in FILE [disabled]
-C, --config-cache alias for `--cache-file=config.cache'
-n, --no-create do not create output files
--srcdir=DIR find the sources in DIR [configure dir or `..']
Installation directories:
--prefix=PREFIX install architecture-independent files in PREFIX
[/usr/local/BerkeleyDB.4.7]
--exec-prefix=EPREFIX install architecture-dependent files in EPREFIX
[PREFIX]
By default, `make install' will install all the files in
`/usr/local/BerkeleyDB.4.7/bin', `/usr/local/BerkeleyDB.4.7/lib' etc. You can specify
an installation prefix other than `/usr/local/BerkeleyDB.4.7' using `--prefix',
for instance `--prefix=$HOME'.
For better control, use the options below.
Fine tuning of the installation directories:
--bindir=DIR user executables [EPREFIX/bin]
--sbindir=DIR system admin executables [EPREFIX/sbin]
--libexecdir=DIR program executables [EPREFIX/libexec]
--sysconfdir=DIR read-only single-machine data [PREFIX/etc]
--sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com]
--localstatedir=DIR modifiable single-machine data [PREFIX/var]
--libdir=DIR object code libraries [EPREFIX/lib]
--includedir=DIR C header files [PREFIX/include]
--oldincludedir=DIR C header files for non-gcc [/usr/include]
--datarootdir=DIR read-only arch.-independent data root [PREFIX/share]
--datadir=DIR read-only architecture-independent data [DATAROOTDIR]
--infodir=DIR info documentation [DATAROOTDIR/info]
--localedir=DIR locale-dependent data [DATAROOTDIR/locale]
--mandir=DIR man documentation [DATAROOTDIR/man]
--docdir=DIR documentation root [DATAROOTDIR/doc/db-4.7.25]
--htmldir=DIR html documentation [DOCDIR]
--dvidir=DIR dvi documentation [DOCDIR]
--pdfdir=DIR pdf documentation [DOCDIR]
--psdir=DIR ps documentation [DOCDIR]
Program names:
--program-prefix=PREFIX prepend PREFIX to installed program names
--program-suffix=SUFFIX append SUFFIX to installed program names
--program-transform-name=PROGRAM run sed PROGRAM on installed program names
System types:
--build=BUILD configure for building on BUILD [guessed]
--host=HOST cross-compile to build programs to run on HOST [BUILD]
Optional Features:
--disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no)
--enable-FEATURE[=ARG] include FEATURE [ARG=yes]
--disable-bigfile Obsolete; use --disable-largefile instead.
--disable-cryptography Do not build database cryptography support.
--disable-hash Do not build Hash access method.
--disable-mutexsupport Do not build any mutex support.
--disable-queue Do not build Queue access method.
--disable-replication Do not build database replication support.
--disable-statistics Do not build statistics support.
--disable-verify Do not build database verification support.
--enable-compat185 Build DB 1.85 compatibility API.
--enable-cxx Build C++ API.
--enable-debug Build a debugging version.
--enable-debug_rop Build a version that logs read operations.
--enable-debug_wop Build a version that logs write operations.
--enable-diagnostic Build a version with run-time diagnostics.
--enable-dump185 Build db_dump185(1) to dump 1.85 databases.
--enable-java Build Java API.
--enable-mingw Build Berkeley DB for MinGW.
--enable-o_direct Enable the O_DIRECT flag for direct I/O.
--enable-posixmutexes Force use of POSIX standard mutexes.
--enable-pthread_self Obsolete; use --enable-pthread_api instead.
--enable-pthread_api Configure Berkeley DB for POSIX pthread API.
--enable-rpc Build RPC client/server.
--enable-smallbuild Build small footprint version of the library.
--enable-tcl Build Tcl API.
--enable-test Configure to run the test suite.
--enable-uimutexes Force use of Unix International mutexes.
--enable-umrw Mask harmless uninitialized memory read/writes.
--enable-shared[=PKGS] build shared libraries [default=yes]
--enable-static[=PKGS] build static libraries [default=yes]
--enable-fast-install[=PKGS]
optimize for fast installation [default=yes]
--disable-libtool-lock avoid locking (might break parallel builds)
--disable-largefile omit support for large files
Optional Packages:
--with-PACKAGE[=ARG] use PACKAGE [ARG=yes]
--without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no)
--with-mutex=MUTEX Select non-default mutex implementation.
--with-mutexalign=ALIGNMENT
Obsolete; use DbEnv::mutex_set_align instead.
--with-tcl=DIR Directory location of tclConfig.sh.
--with-uniquename=NAME Build a uniquely named library.
--with-gnu-ld assume the C compiler uses GNU ld [default=no]
--with-pic try to use only PIC/non-PIC objects [default=use
both]
--with-tags[=TAGS] include additional configurations [automatic]
Some influential environment variables:
CC C compiler command
CFLAGS C compiler flags
LDFLAGS linker flags, e.g. -L<lib dir> if you have libraries in a
nonstandard directory <lib dir>
LIBS libraries to pass to the linker, e.g. -l<library>
CPPFLAGS C/C++/Objective C preprocessor flags, e.g. -I<include dir> if
you have headers in a nonstandard directory <include dir>
CXX C++ compiler command
CXXFLAGS C++ compiler flags
CXXCPP C++ preprocessor
CPP C preprocessor
F77 Fortran 77 compiler command
FFLAGS Fortran 77 compiler flags
Use these variables to override the choices made by `configure' or to help
it to find libraries and programs with nonstandard names/locations.
Report bugs to <Oracle Technology Network Berkeley DB forum>.
BDBの単体テストを実行できるようにするためにはconfigureで、
- --enable-testが有効になっている事」
- --with-tclでtclConfig.shのディレクトリを指定してある事
- (tclがインストールされている事)
が必要ならしい。
CentOSの場合、tcl自体はデフォルトで入っているようだが、tcl-develが入っていないとtclConfig.shが無い。
そんなわけでrpmなどでtcl-develパッケージも入れておく事。
configureが成功したらmakeしておく。
単体テストのやり方は、実はOracleのHPに書いてある。
(http://www.oracle.com/technology/documentation/berkeley-db/db/programmer_reference/test.html#test_run)
が、見つけるのが意外と大変だった…。
大雑把に言うと、
- build_unixディレクトリでmakeが終わった後に、そこからtclshを実行する。
- source ../test/test.tclを実行。(HPのパスは間違い！)
- run_stdかrun_allを実行する
でテストスクリプトが走らせられる。
結構時間とメモリ食うので貧弱な本番環境で実行するのはオススメできない。
(ってか、いつの間にBDBはトランザクションとかレプリケーションとかサポートするようになっちゃったの？！)
HPにも「several hoursからdayかかるよ〜」と言われているので、実際とっても時間がかかる。
会社から帰る前にrun_stdしておいて翌朝に見るのが正解？
なお、何のテストをやっているのかは大雑把に表示してくれるが大雑把過ぎて寂しい人は、
tail -f ./ALL.OUT &
しておくと単体テストが行われているのを眺める事ができる。
「FAIL」で始まる行があった場合、何らかしらのテストが失敗している。
履歴
2010/4/19 -- 初版
技術的雑談へ戻る