SAP SQL Anywhere Tips – Linux版での自動起動 (Ver.17)

はじめに

*今回はリクエストを受け作成した記事となります。こういうのを解説してほしいとかありましたらお気軽にリクエストいただければと思います。

SAP SQL Anywhere Ver.17をLinuxで動作させる際に、OS起動と共にSAP SQL Anywhereデータベースをサービスとして起動させたいという場合があります。意外とマニュアルに記述がありませんでしたので、今回はその方法を解説します。

ちょっと余談：環境設定ファイル

LinuxでSAP SQL Anywhereを動作させる際、いくつか環境変数が必要です。これはSQL Anywhereをインストールしたディレクトリのbin64ディレクトリもしくはbin32ディレクトリに sa_config.sh （とsa_config.csh）　というファイルがあります。このファイルにまとめられています。

*bin32のものを使用するのかbin64のものを使用するのかは32bit版SQL Anywhereを使用するのか64bit版SQL Anywhereを使用するのかの選択に依存します。

ディフォルトではSQL Anywhere 17であれば下記のようなファイルが作られています。

#!/bin/sh
#

# the following lines set the SA location.
SQLANY17="/opt/sqlanywhere17"
export SQLANY17

[ -r "$HOME/.sqlanywhere17/sample_env64.sh" ] && . "$HOME/.sqlanywhere17/sample_env64.sh"
[ -z "${SQLANYSAMP17:-}" ] && SQLANYSAMP17="/opt/sqlanywhere17/samples"
export SQLANYSAMP17

# the following lines add SA binaries to your path.
PATH="$SQLANY17/bin64:$SQLANY17/bin32:${PATH:-}"
export PATH
NODE_PATH="$SQLANY17/node:${NODE_PATH:-}"
export NODE_PATH

# the following lines are required to load the various shared objects of SA
PATH="$SQLANY17/bin64/jre180/bin:${PATH:-}"
LD_LIBRARY_PATH="$SQLANY17/bin64/jre180/lib/amd64/client:$SQLANY17/bin64/jre180/lib/amd64/server:$SQLANY17/bin64/jre180/lib/amd64:$SQLANY17/bin64/jre180/lib/amd64/native_threads:${LD_LIBRARY_PATH:-}"
export PATH
[ -z "${JAVA_HOME:-}" ] && JAVA_HOME="$SQLANY17/bin64/jre180"
export JAVA_HOME
LD_LIBRARY_PATH="$SQLANY17/lib32:${LD_LIBRARY_PATH:-}"
LD_LIBRARY_PATH="$SQLANY17/lib64:${LD_LIBRARY_PATH:-}"
export LD_LIBRARY_PATH

このファイルを読み込むことで必要な環境変数が設定されます。bashなどであれば以下の様な感じですね。

もちろんこのファイルを読み込まず同義の環境変数やパス類を設定しても構いません。SQL Anywhereを起動させるにはこの環境変数類が必要です。管理を行うOSユーザーの.bashrcなどに組み込んでログイン時に読まれるようにしてしまっても良いかもしれません。

SystemdとSysVinit

Linuxでサービスとして起動させる場合、かつてはSysVinit、現在はSystemdを使うことが多くなったように思います。これはお使いのLinuxディストリビューションによって異なりますので調べていただくことが必要です。比較的新しいディストリビューションはsystemdを使用していると思われます。SAP SQL AnywhereのLinux版に付属する”dbsvcユーティリティ”はVer.17ではSystemdで使用するServiceファイルを作成する機能があります。それ以前のバージョンのものはSysVinitに対応します。

Ver.17 – dbsvcユーティリティ

このユーティリティはSystemdで使用するServiceファイルを作成します。

http://dcx.sap.com/index.html#sqla170/ja/html/813df9e16ce21014bf5cdf75390e9c94.html

使用方法としてはまずdbsrv17/dbeng17で起動できるデータベースファイルと起動に使用するコマンドパラメータを用意してください。

この部分をパラメータとして使用します。

そして/etc/init.dに書き込み権限を持ったユーザー、もしくはrootユーザーで先に解説したSQL Anywhere用の環境変数を設定したSSHなどのセッションを用意してください。最近はsudoで行う場合が多いようなので

としてrootユーザーのShellを用意しても良いでしょう。そしてdbsvcコマンドを実行します。基本は以下です。

コマンド出力にあるように/lib/systemd/system/以下にserviceファイルが作成されます。このファイルは以下のようなものです。

[Unit]
Description=SQLAnywhere Network demo service
After=syslog.target network.target local-fs.target

[Service]
Type=forking
Nice=0
User=ubuntu
PIDFile=/run/SA_demo/service.pid
Environment="TMP=/tmp/\x2eSQLAnywhere"
Environment="ODBCINI="
Environment="PIDFILE=/run/SA_demo/service\x2epid"
Environment="SERVICENAME=demo"
Environment="SVC_IFACE=systemd"
Environment="SQLANYDIR=/opt/sqlanywhere17"
Environment="BIN=bin64"
Environment="BITNESS=64"
Environment="DBSVC_TYPE=network"
Environment="SVC_TOOL_CMDLINE='-n' 'demo' '-o' '/home/ubuntu/database/serverlog.txt' '/home/ubuntu/database/demo.db' '-ud' "
ExecStartPre=-/bin/rm -f "/run/SA_demo/service\x2epid"
ExecStopPost=/bin/rm -f "/run/SA_demo/service\x2epid"
ExecStart=/opt/sqlanywhere17/bin64s/dbsvc RUNSERVICECMD start

# INPUTCMD=dbsvc '-a' 'ubuntu' '-t' 'network' '-w' 'demo' '-n' 'demo' '-o' '/home/ubuntu/database/serverlog.txt' '/home/ubuntu/database/demo.db'

このファイルが出来たらこのファイル経由で起動できるか確認してください。以下のようにして確認します。なお、サービスとしての起動方法や確認方法も以下です。

自動起動させるには？

この作成されたServiceを自動起動させるには少々加工が必要です。
そのまま　systemctl enable SA_<サービス名> 　では自動起動は有効にならないことに注意して下さい。

具体的には

[Unit]
Description=SQLAnywhere Network demo service
After=syslog.target network.target local-fs.target

[Service]
Type=forking
Nice=0
User=ubuntu
PIDFile=/run/SA_demo/service.pid
Environment="TMP=/tmp/\x2eSQLAnywhere"
Environment="ODBCINI="
Environment="PIDFILE=/run/SA_demo/service\x2epid"
Environment="SERVICENAME=demo"
Environment="SVC_IFACE=systemd"
Environment="SQLANYDIR=/opt/sqlanywhere17"
Environment="BIN=bin64"
Environment="BITNESS=64"
Environment="DBSVC_TYPE=network"
Environment="SVC_TOOL_CMDLINE='-n' 'demo' '-o' '/home/ubuntu/database/serverlog.txt' '/home/ubuntu/database/demo.db' '-ud' "
ExecStartPre=-/bin/rm -f "/run/SA_demo/service\x2epid"
ExecStopPost=/bin/rm -f "/run/SA_demo/service\x2epid"
ExecStart=/opt/sqlanywhere17/bin64s/dbsvc RUNSERVICECMD start

# INPUTCMD=dbsvc '-a' 'ubuntu' '-t' 'network' '-w' 'demo' '-n' 'demo' '-o' '/home/ubuntu/database/serverlog.txt' '/home/ubuntu/database/demo.db'

[Install]
WantedBy=multi-user.target

上記のようにファイルの一番後ろに[Install]エントリとWantedByエントリを追加します。

※このServiceファイルの内容についてはLinux側のマニュアルや各種解説サイトをご参照の上設定いただければと思います。例えばアプリケーションの起動前にSAP SQL Anywhereが起動していなければならないなどの要件がある場合は必須です。この例では一番一般的な例になるのではないかと思われるものを設定しています。

そしてその後、

で、サービスを有効化します。

OSを再起動させてみましょう。psコマンドでdbsrv17/dbeng17プロセスが起動していれば完了です。

補足

上記の例ではdbsrv17/dbeng17への引数をそのままdbsvcへの引数として使用しましたが、サービス化する場合は設定ファイルを使用することを検討してください。そうしないとデータベースの設定パラメータ変更時にサービスファイルを編集する必要が発生します。設定ファイルを読むように設定すればそちらを読むことになりますのでサービスファイルは無編集で変更を反映させることが出来ます。

まとめ

Linuxでは自動起動させる方法は多数存在します。そのOS（ディストリビューション）によってはもっと簡単な方法があるかもしれませんのでOS側のマニュアルも確認の上どの方法を使用するか検討してください。