![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
NestDAQをインストールするには、以下のGitHubのインストールのページを参考にすれば良いが、比較的玄人向け、もしくは開発者向けのインストール方法の説明になっている。
そのため、ここでは簡略化されたインストール方法を記述する。ライブラリのバージョンを切り替えて NestDAQ の動作検証などを行いたい場合は、公式のインストールのページを参照する。また、ネット上には NestDAQ のインストール方法に関するドキュメントがいくつかある。J-PARC MARQ spectrometer T103 実験 (白鳥 et al.) のサーバーマシンのインストール方法のメモとしては、e50server01 のインストールログがある。
また、以下の NestDAQ 利用者のページも参考にできる。
インストールを行う環境は2024年9月30日時点で最新の AlmaLinux 9.4 を想定する。AlmaLinux 9.X であれば、ほぼ同じインストール手順になるはずである。AlmaLinux 9.4 の環境としては、サーバー環境として Graphical User Interface (GUI) がなくてもインストールできるがずであるが、GUIがあると便利であるため、GUI 環境のインストールを仮定する。さらに、言語は英語 (US) を仮定する。また、NestDAQ に必要なパッケージは以下である。
さらに、nestdaq-user-impl では、以下のパッケージが必要になるため、これもインストールしておく。これらがないと、コンパイル時にエラーとなる。
パッケージをインストールするには、sudo dnf install zstd libzstd-devel bzip2-devel などとする。現在インストールされているパッケージを確認する場合は、dnf list といったコマンドがある。このあたりのコマンドは、Google で調べれば出てくるはず。
SELinux は大抵問題を引き起こすので、切っておきたい。以下のコマンドで確認可能。
$ getenforce Disabled
さらに、一般に DAQ の開発段階では firewall は切っておくとデバッグが捗り、労力削減になる。そのため、LAN 環境などでは、最初は firewall を切って動作検証することを推奨とする。
NestDAQ のインストールでは管理者権限 (いわゆる root 権限) は必要なく、どのディレクトリにインストールしても構わない。ただ、本マニュアルでは、Linux 初心者向けに推奨のディレクトリ構造を紹介する。いくつかのスクリプトでは、ディレクトリのパスをベタ書きしているところがあるため、他のディレクトリにインストールを行うと、修正項目が増える場合がある。2024年9月30日以前のインストール先は実験毎に変わっている場合があったが、本マニュアルでは spadi アカウントを作成し、ホームディレクトリ以下にインストールを行うことを推奨とする。
/home/spadi/
ちなみに、2024年9月30日以前は nestdaq アカウントを作成し、/home/nestdaq ホームディレクトリ以下にインストールする場合が多かったが、SPADI Alliance のさまざまな活動により nestdaq に限らず、他のソフトウェアを利用することが増えてたため /home/nestdaq ディレクトリではなく、spadi アカウントをデフォルトとし、これを推奨とする。また、公式の NestDAQ のスクリプトも順次 /home/spadi に対応させていくと良いと考えられる。
さらに、SPADI-A DAQ パッケージ関連の Git リポジトリやソースコードは
/home/spadi/repos
というディレクトリにクローンもしくはダウンロードし、ここでビルドすることを本マニュアルのデフォルトとする。また、インストール先は
/home/spadi/local/
|-- bin
|-- share
|-- lib
`-- etc
をデフォルトとする。Linux に慣れている人であれば、このディレクトリでなくても運用できるであろう。
NestDAQ 本体のビルドに必要な以下のライブラリをまずインストールする。
さらに、以下の redisinsight をインストールしてもよい。
このプログラムは Redis データベースの中身を便利に見るためのソフトウェアである。ただ、Redis デフォルトの CUI コマンド redis-cli でも Redis データベースの中身を見ることができるので、必ずしも redisinsight をインストールする必要はない。
その後、NestDAQ 本体のインストールを行う。ちなみに、Boost のビルドの前に、zstd, libzstd-devel, bzip2-devel パッケージをパッケージマネージャでインストールしておく必要がある。これらパッケージをインストールしていなくても Boost 自体のコンパイルはできてしまうが、nestdaq-user-impl のコンパイル時にエラーとなる。
git でソースをダウンロードしてコンパイル
$ mkdir -p $HOME/repos $ cd $HOME/repos $ git clone https://github.com/redis/redis.git $ cd redis $ git checkout -b 6.0.16 6.0.16 $ make -j10 PREFIX=$HOME/local $ make PREFIX=$HOME/local install
make の所要時間は 20 - 30秒程度。設定ファイルを $HOME/local/etc にコピー
$ mkdir $HOME/local/etc $ cp $HOME/repos/redis/redis.conf $HOME/local/etc/
daemon mode をオンにする。
$ emacs -nw $HOME/local/etc/redis.conf #daemonize no daemonize yes
さらに、コンピュータ外からのアクセスを有効にするために、以下の行を有効にする。
# bind 127.0.0.1 bind 0.0.0.0
また、プロテクトモードを無効にする。これをしないと、redis-cli などで外部コンピュータからアクセスはできるがデータベースの中身を見られない(たしか)。
protected-mode yes
|||
VVV
protected-mode no
$ cd $HOME/repos $ git clone --recursive https://github.com/RedisTimeSeries/RedisTimeSeries.git $ cd RedisTimeSeries $ git checkout -b v1.4.9 v1.4.9 $ make ... $ mkdir $HOME/local/lib $ cp $HOME/repos/RedisTimeSeries/bin/linux-x64-release/redistimeseries.so $HOME/local/lib/
make の所要時間は数秒程度。make 時に make -j2 とすると、以下のようなエラーとなるので、-jオプションは使わないようにすべし。
$ make -j2 make[1]: warning: -j0 forced in submake: resetting jobserver mode. Submodule path 'deps/RedisModulesSDK': checked out 'c0740b8209abae38775adc6f3fefe05a520be55b' Submodule path 'deps/readies': checked out '32e37e68f6ffa66f5a6e41cb37794147e84c38cb' ../deps/readies/mk/main:67: /home/spadi/repos/RedisTimeSeries/deps/readies/mk/cfg: No such file or directory make[1]: *** No rule to make target '/home/spadi/repos/RedisTimeSeries/deps/readies/mk/cfg'. Stop. make: *** [Makefile:31: build] Error 2
Boost をダウンロードしてきて make する。
$ cd $HOME/repos $ git clone https://github.com/boostorg/boost.git $ cd boost $ git checkout -b boost-1.80.0 boost-1.80.0 $ git submodule update --init --recursive $ ./bootstrap.sh $ ./b2 install \ link=static,shared \ threading=single,multi \ cxxstd=17 \ variant=release,debug \ --layout=tagged \ -j10 \ --prefix=$HOME/local ... ...updated 20451 targets...
早いコンピュータであれば、./b2 install の所要時間は 10 分程度。
ZeroMQ を持ってきてコンパイル
$ cd $HOME/repos $ git clone https://github.com/zeromq/libzmq.git $ cd libzmq $ mkdir build $ cmake \ -DCMAKE_INSTALL_PREFIX=$HOME/local \ -DCMAKE_CXX_STANDARD=17 \ -B ./build \ -S . $ cd build $ make -j10 $ make install
make -j10 の所要時間は20秒程度。
$ cd $HOME/repos $ git clone https://github.com/FairRootGroup/FairLogger.git $ cd FairLogger $ mkdir build $ cmake \ -DCMAKE_INSTALL_PREFIX=$HOME/local \ -DCMAKE_CXX_STANDARD=17 \ -DUSE_EXTERNAL_FMT=OFF \ -B build \ -S . $ cd build $ make -j10 $ make install
make -j10 の所要時間は20秒程度。
$ cd $HOME/repos $ git clone https://github.com/FairRootGroup/FairMQ.git $ cd FairMQ $ git checkout -b v1.4.55 v1.4.55 $ mkdir build $ cmake \ -DCMAKE_INSTALL_PREFIX=$HOME/local \ -DCMAKE_CXX_STANDARD=17 \ -DCMAKE_PREFIX_PATH="$HOME/local" \ -B build \ -S . $ cd build $ make -j10 $ make install
make -j10 の所要時間は2分程度。
$ cd $HOME/repos $ git clone https://github.com/redis/hiredis.git $ cd hiredis $ make PREFIX=$HOME/local install
make の所要時間は数秒程度。
$ cd $HOME/repos $ git clone https://github.com/sewenew/redis-plus-plus.git $ cd redis-plus-plus $ mkdir build $ cmake \ -DCMAKE_INSTALL_PREFIX=$HOME/local \ -DCMAKE_BUILD_TYPE=Release \ -DCMAKE_PREFIX_PATH=$HOME/local \ -DREDIS_PLUS_PLUS_CXX_STANDARD=17 \ -DREDIS_PLUS_PLUS_BUILD_TEST=OFF \ -B ./build \ -S . $ cd build $ make -j10 install
make の所要時間は数秒程度。
$ cd $HOME/repos $ git clone https://github.com/spadi-alliance/nestdaq.git $ cd nestdaq $ mkdir build $ cmake \ -DCMAKE_INSTALL_PREFIX=$HOME/local \ -DCMAKE_PREFIX_PATH=$HOME/local \ -B ./build \ -S . $ cd build $ make -j10 install
make の所用時間は 20-30 秒程度。
redisinsight をもし使いたい場合はインストールする。以前は wget コマンドでコンパイル済のバイナリを配布していたが、最近は web でアカウント登録してからバイナリをダウンロードする方式に変わったようだ？バイナリをダウンロードして、
$ mv <ダウンロードしたディレクトリ>redisinsight-linux64 $HOME/local/bin $ cd $HOME/local/bin $ chmod +x redisinsight-linux64 $ ./redisinsight-linux64 <なにも表示されなければOK。Ctrl-Cで殺す。殺したときはいろいろメッセージが出る。> $
NestDAQを使う場合、いくつかのライブラリが必要であるが、そのバージョンを切り替えて試したい時がある。そのような場合、ライブラリのバージョンに応じてインストール先を変えて用意しておき、ライブラリのリンクを変えることで、異なるライブラリを用いた動作確認を行う。ただ、Linuxにおけるリンク方法の知識が必要であるため、本マニュアルでは、慣れない人向けにより簡単なインストール方法を説明をしている。その代わり、異なるライブラリを試したい場合は、いちいちバージョンの異なるライブラリをインストールする必要があるだろう。