#author("2023-06-19T00:45:58+09:00","default:kaw","kaw")
#author("2024-07-31T10:55:46+09:00","default:kaw","kaw")
#navi(SAG)
*System Activity Grapher - インストール手順(手動) [#eb67032d]
前章で説明したように、SAGにはインストーラが付属しており、これを使ってSAGをインストールすることができます。

この章では、インストーラを使わずにSAGを手動でインストールする方法について説明します。
----
#contents
*動作モードの決定 [#heb5e631]
最初に、SAGの動作モードを決定します。動作モードは2つあります。
:cronモード|SAGの動作はcronによりスケジューリングされ、動作します。OSが稼動している間は、連続して稼動します。
:standaloneモード|cronを使わずにSAG単体で動作します。OSの起動時に自動的に稼動しますが、手動で停止、再開することができます。

この2つのモードは、動作としては同じです。特に理由がなければ、standaloneモードを推奨します。

*rootでの作業 [#ec23c073]
最初に、ルート権限でSAGの実行に必要なソフトのインストールとアカウントの作成を行います。
**gitのインストール [#m4f51c2e]
gitは、SAGをGitHubから取得するために必要です。
 # pkg_add git
 quirks-6.121 signed 2023-06-01 07:54:26
 quirks-6.121: ok
   :
   :
 git-2.40.0: ok
 The following new rcscripts were installed: /etc/rc.d/gitdaemon
 See rcctl(8) for details.
 New and changed readme(s):
 	/usr/local/share/doc/pkg-readmes/git
 #        
**gnuplotのインストール [#e3d77dd1]
SAGは、グラフの描画をgnuplotを使って行っているため、gnuplotをインストールします。~
インストールを開始すると、どのパッケージを使うか訊かれるので「1: gnuplot-5.2.7p1」を選択します。~
gnuplot-5.2.7p1-no_x11は、PNGなどの画像ファイルを生成する機能を持っていません。
 # pkg_add gnuplot
 quirks-6.121 signed 2023-06-01 07:54:26
 Ambiguous: choose package for gnuplot
 a	0: <None>
 	1: gnuplot-5.2.7p1
 	2: gnuplot-5.2.7p1-no_x11
 Your choice: 1
 gnuplot-5.2.7p1:readline-7.0p0: ok
    :
    :
 gnuplot-5.2.7p1: ok
 Running tags: ok
 New and changed readme(s):
 	/usr/local/share/doc/pkg-readmes/glib2
 #
**sagユーザの作成 [#jb9b1131]
SAGを実行するユーザ「sag」を作成します。
 # adduser -silent
 Enter username []: sag
 Enter full name []: System Activity Grapher
 Enter shell csh git-shell ksh nologin sh [ksh]:
 Uid [1000]:
 Login group sag [sag]:
 Login group is ``sag''. Invite sag into other groups: guest no
 [no]:
 Login class authpf bgpd daemon default pbuild staff unbound vmd xenodm
 [default]:
 Enter password []:
 Enter password again []:
 
 Name:	     sag
 Password:    ****
 Fullname:    System Activity Grapher
 Uid:	     1000
 Gid:	     1000 (sag)
 Groups:	     sag
 Login Class: default
 HOME:	     /home/sag
 Shell:	     /bin/ksh
 OK? (y/n) [y]: y
 Added user ``sag''
 Copy files from /etc/skel to /home/sag
 Add another user? (y/n) [y]: n
 Goodbye!
 #
*sagユーザでの作業 [#xe5ac3b1]
以降の作業はsuコマンドを実行し、一時的にsagユーザになって行います。
 # su - sag
 $
**SAGの取得と配置
GitHubから最新バージョンのSAGを取得します。
 $ git clone https://github.com/ykaw/sag
 Cloning into 'sag'...
 remote: Enumerating objects: 515, done.
 remote: Counting objects: 100% (92/92), done.
 remote: Compressing objects: 100% (48/48), done.
 remote: Total 515:(delta(40),5reused 66 (delta 33), pack-reused 423
 Receiving objects: 100% (515/515), 368.37 KiB | 784.00 KiB/s, done.
 Resolving deltas: 100% (229/229), done.
 $
取得したファイル群はsagというディレクトリに格納されているので、それをsagユーザのホームディレクトリに移動します。
 $ mv sag/.git sag/* ~
 $ rmdir sag
 $ ls -l ~
 total 22
 -rw-r--r--  1 sag  sag  3304 Jun  3 01:39 README.en
 -rw-r--r--  1 sag  sag  2687 Jun  3 01:39 README.eucjp
 drwxr-xr-x  2 sag  sag   512 Jun  3 02:35 bin
 drwxr-xr-x  3 sag  sag   512 Jun  3 01:41 conf
 drwxr-xr-x  3 sag  sag   512 Jun  3 02:35 plot
 drwxr-xr-x  2 sag  sag  1024 Jun  3 04:10 var
 $ 
**gnuplotへのシンボリックリンクを作成 [#fce33700]
PATH環境変数の設定に関係なく実行できるよう、binディレクトリにgnuplotのシンボリックリンクを作成します。
 $ ln -s /usr/local/bin/gnuplot ~/bin
 $ ls -l ~/bin
 total 24
 -rwxr-xr-x  1 sag  sag   298 Jun  3 01:39 addgap
 -rwxr-xr-x  1 sag  sag   721 Jun  3 01:39 fnrot
 -rwxr-xr-x  1 sag  sag   860 Jun  3 01:39 gengraph
 lrwxr-xr-x  1 sag  sag    22 Jun  3 01:40 gnuplot -> /usr/local/bin/gnuplot
 -rwxr-xr-x  1 sag  sag   785 Jun  3 01:39 mkoldsum
 -rwxr-xr-x  1 sag  sag   947 Jun  3 01:39 rotate
 -rwxr-xr-x  1 sag  sag  1030 Jun  3 01:39 split_byday
 -rw-r--r--  1 sag  sag   258 Jun  3 02:20 t0001
 -rw-r--r--  1 sag  sag   255 Jun  3 01:39 t0005
 -rw-r--r--  1 sag  sag   236 Jun  3 01:39 t0100
 -rw-r--r--  1 sag  sag   104 Jun  3 01:39 t2400
 -rwxr-xr-x  1 sag  sag   437 Jun  3 01:39 tick
 $ 
**設定ファイルの編集 [#vadf7e23]
***サンプルファイルをコピー [#z08f841c]
confディレクトリのexamplesディレクトリからファイルをコピーし、編集します。
 $ cd ~/conf
 $ ls -l
 total 10
 drwxr-xr-x  2 sag  sag  512 Jun  3 01:43 examples
 $ cp examples/dfplot.gp examples/netcmd.sh examples/postgproc.sh examples/shconf.sh .
 $ ls -l
 total 10
 -rw-r--r--  1 sag  sag  398 Jun  3 01:41 dfplot.gp
 drwxr-xr-x  2 sag  sag  512 Jun  3 01:43 examples
 -rw-r--r--  1 sag  sag  245 Jun  3 01:41 netcmd.sh
 -rwxr-xr-x  1 sag  sag  326 Jun  3 01:44 postgproc.sh
 -rw-r--r--  1 sag  sag  384 Jun  3 02:12 shconf.sh

***dfplot.gpの編集 [#e9dc7936]
dfplot.gpは、ディスク使用率の表示を行う際に必要なシステムのパーティション構成を設定するファイルです。~
dfコマンドの出力に合わせ、内容を編集します。

サンプルファイルは、河豚板をモード0で起動した場合のファイルシステムに合わせてあります。
 $ df
 Filesystem  512-blocks      Used     Avail Capacity  Mounted on
 /dev/rd0a         3039      2088       951    69%    /
 /dev/cd0a      2094988   2094988         0   100%    /sysmedia
 /dev/vnd5a     2040700   2037920      2780   100%    /fuguita
 mfs:69062      1494238    581876    837652    41%    /ram
 $ vi dfplot.gp
編集内容
 # definitions of disk partitions
 #
 # $Id: dfplot.gp,v 1.2 2017/01/07 06:10:54 kaw Exp $
 #
 # This file will included from $SAGHOME/plot/gen0100df.gp
 # Reconfigure following to fit to the disk layout.
 
 plot "sumtmp-0100df" using 1:3 title "RDROOT", \      <--+  この部分をdfコマンドの
      "sumtmp-0100df" using 1:4 title "LIVEMEDIA", \      |  出力に合わせて編集
      "sumtmp-0100df" using 1:5 title "SYSTEM", \         | (1:3が一番最初に表示される
      "sumtmp-0100df" using 1:6 title "WRITABLE"       <--+  パーティション)

***netcmd.shの編集 [#x6061040]
測定対象としたいネットワークデバイスを指定します。
 $ vi netcmd.sh
編集内容
 # a command line to get i/f name, send/receive bytes
 # then print them out
 #
 # this command will eval-ed by $SAGHOME/bin/t00
 #
 # $Id: netcmd.sh,v 1.3 2021/10/05 02:29:26 kaw Exp $
 
 netcmd='set $(netstat -I bce0 -b -n -i); echo $7 ${11} ${12}'
                          ~~~~ここを実際のインターフェース名に変更
***shconf.shの編集 [#hb77edaa]
shconf.shでは、測定項目、ファイルに保存する日数、測定項目それぞれのグラフへの描画日数を指定します。~
サンプルファイルの内容でよければ、編集する必要はありません。
 $ vi shconf.sh
編集内容
 #  shconf.sh  -  shell variable configuration for SAG
 #
 #  $Id: shconf.sh,v 1.3 2021/10/04 15:22:35 kaw Exp $
 
 # categories to process data
 #
 targets='0001la 0001net 0005mem 0100df 0100time 0005timeofs'
 
 # days to store data
 #
 rotate_max=64  <--ファイルに保存する日数
 
 # days to display graph  <--グラフに描画する日数
 #
      span_la=8
     span_net=8
     span_mem=8
      span_df=32
    span_time=32
 span_timeofs=8

**グラフ描画関連のセットアップ [#g86ec0df]
plotディレクトリでは、データの集計とグラフの描画指示を行っています。~
デフォルト設定から変えなければ、examplesディレクトリから必要ファイルをコピーするだけでOKです。
 $ cd ~/plot
 $ cp examples/common.gp examples/gen* .
 $ ls -l
 total 40
 -rw-r--r--  1 sag  sag  1207 Jun  3 01:42 common.gp
 drwxr-xr-x  2 sag  sag   512 Jun  3 01:39 examples
 -rw-r--r--  1 sag  sag   259 Jun  3 01:42 gen0001la.gp
 -rwxr-xr-x  1 sag  sag   882 Jun  3 01:42 gen0001la.pl
 -rw-r--r--  1 sag  sag   356 Jun  3 01:42 gen0001net.gp
 -rwxr-xr-x  1 sag  sag  1502 Jun  3 01:42 gen0001net.pl
 -rw-r--r--  1 sag  sag   418 Jun  3 01:42 gen0005mem.gp
 -rwxr-xr-x  1 sag  sag  1046 Jun  3 01:42 gen0005mem.pl
 -rw-r--r--  1 sag  sag   422 Jun  3 01:42 gen0005timeofs.gp
 -rwxr-xr-x  1 sag  sag  1536 Jun  3 01:42 gen0005timeofs.pl
 -rw-r--r--  1 sag  sag   160 Jun  3 01:42 gen0100df.gp
 -rwxr-xr-x  1 sag  sag   553 Jun  3 01:42 gen0100df.pl
 -rw-r--r--  1 sag  sag   198 Jun  3 01:42 gen0100time.gp
 -rwxr-xr-x  1 sag  sag   338 Jun  3 01:42 gen0100time.pl
gen*.plファイルは生ログから目的とする測定項目を集計し、出力するPerlスクリプトです。
gen*.gpファイルは、集計結果からgnuplotでグラフの画像ファイルを生成するための描画指示です。~
common.gpは、全ての測定項目で共通なgnuplotのグラフの描画設定が定義されています。

**ファイル置場の作成 [#j7fbed6f]
測定結果の生ログやその集計ファイル、最終的な生成物であるグラフの画像ファイルを置くディレクトリを作成します。
 $ mkdir ~/var
*rootでの作業 [#n20828a3]
以降は、sagユーザから抜けて再度root権限で作業します。
 $ exit
 #
**システムファイルの設定 [#g3b4d723]
***rootのcrontabにSAG関連のエントリを追加します。 [#jd30a5da]
 # cd ~sag/conf/examples/
 # crontab -l > crontab.orig
 # cat crontab.orig crontab-root | crontab -

***/etc/rc.localの編集 [#u6732f29]
***/etc/rc.localのセットアップ [#u6732f29]
''cronモードの場合''~
システムが起動した時のSAG関連の処理を/etc/rc.localに追加し、その一部を編集します。
 # cat rc.local >> /etc/rc.local
 # vi /etc /rc.local
編集内容
 # for System Activity Grapher
 # Add this to /etc/rc.local
 #
 # $Id: rc.local,v 1.2 2017/01/07 06:10:54 kaw Exp $
 
 su -l sag -c 'PATH-TO-CMD/bin/addgap' # Rewrite to the real location.
               ~~~~~~~~~~~実際のパス(/home/sag)に書換え
 # setups for ntp monitoring
 #
 touch /tmp/ntpctl.out
 chown sag:sag /tmp/ntpctl.out
 chmod 0640 /tmp/ntpctl.out
***sagユーザのcrontabを有効化します。 [#y93bd727]
これ以降、SAGの測定が開始されます。

''standaloneモードの場合''~
以下の容の/etc/rc.localファイルを作成します。
 # setups for ntp monitoring
 #
 touch /tmp/ntpctl.out
 chown sag:sag /tmp/ntpctl.out
 chmod 0640 /tmp/ntpctl.out
 
 # starting up SAG
 su -l sag -c '/home/sag/bin/sag_rc.sh start'

***SAGの有効化 [#y93bd727]
''cronモードの場合''~
ユーザsagのcronエントリを有効化します。これ以降、SAGの測定が開始されます。
 # crontab -u sag ~sag/conf/examples/crontab

''standaloneモードの場合''~
以下のコマンドを投します。
 # chmod u+x /home/sag/bin/t????
 # su -l sag -c '/home/sag/bin/sag_rc.sh start'

**ウェブサーバ関連の設定 [#i8d73277]
以下は、SAGが生成したグラフをウェブブラウザで閲覧するための設定です。~
グラフの画像ファイルを画像ビューアで直接見るなどの場合は必要ありません。

***postgproc.shの編集 [#x2c6c365]
postgproc.shは、グラフ画像ファイルが生成された後の処理を行い、サンプルファイルでは画像ファイルがウェブのコンテンツディレクトリへコピーされる処理がコメントアウトされています。~
ウェブ経由で画像を閲覧する場合は、postgroc.shを編集し、処理を有効化します。

編集はsagユーザ権限で行います。
 # su - sag
 $ vi ~/conf/postgproc.sh
編集内容
 #!/bin/sh
 
 # processes after generating graphs
 # This script will be called by $SAGHOME/bin/t0100
 #
 # $Id: postgproc.sh,v 1.3 2021/10/04 15:26:38 kaw Exp $
 
 # To enable this,
 
 # # Make next line commented.
 # exit 0                       <--この行をコメント化する
 
 # and follwing lines uncommented
 #
 # sample of post process
 sleep 60                       <--この行以降をアンコメントする
 cp $SAGHOME/var/*.png /var/www/htdocs/sag/.

 $ exit
 #

**ウェブ関連の設定 [#x85a1906]
ウェブサーバ関連の設定です。
 # mkdir /var/www/htdocs/sag
 # cp index.html /var/www/htdocs/sag                                        
 # chown -R sag:sag /var/www/htdocs/sag
httpd.confの編集
 # vi /etc/httpd.conf
編集内容
 server "example.com" {
     listen on * port 80
 }
これはウェブサーバを稼働させるための最低限の設定です。ユーザ認証による閲覧制限やTLSによる通信を行いたい場合は[[httpd.conf(5)>man:httpd.conf]]などを参照して下さい。

ウェブサーバを起動します。
 # rcctl enable httpd
 # rcctl start httpd
*その他 [#y6ed7acc]
**あとかたづけ [#w67c0801]
SAGのインストール後に、gitを使う用事がなければ、gitとその依存パッケージをアンインストールできます。
 # pkg_delete git
 git-2.40.0: ok
 Read shared items: ok
 --- -git-2.40.0 -------------------
 You should also run /usr/sbin/userdel _gitdaemon
 You should also run /usr/sbin/groupdel _gitdaemon
 # pkg_delete -a  
 ngtcp2-0.13.1:curl-8.1.1: ok
 ngtcp2-0.13.1: ok
 p5-Error-0.17029: ok
 cvsps-2.1p2: ok
 p5-Mail-Tools-2.21p0: ok
 p5-Time-TimeDate-2.33: ok
 nghttp3-0.9.0: ok
 nghttp2-1.52.0: ok
 Read shared items: ok
 # 
**動作の確認 [#a2a57382]
-sagのcrontabエントリを有効化した後、varディレクトリに測定結果の生ログrl0001, rl0005, rl0100が生成されていることを確認します。

-毎時50分にグラフの生成が行われるので、その後にグラフの画像ファイルが生成されていることを確認します。また、ウェブでの閲覧を設定した場合は、ウェブブラウザでも閲覧できることを確認します。

#navi(SAG)

Front page   Edit Diff History Attach Copy Rename Reload   New Page list Search Recent changes   Help   RSS of recent changes