![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
SAGにはインストーラが付属しており、通常のインストールは、このインストーラにより行うことができます。
インストールはroot権限で行います。
インストーラをダウンロードします。
sag-demo# ftp https://fuguita.org/sag/install.sh Trying 133.242.176.115... Requesting https://fuguita.org/sag/install.sh 100% |**************************************************| 4511 00:00 ETA 4511 bytes received in 0.00 seconds (1.17 MB/s) #
ダウンロードが完了したら、インストーラを実行します。
sag-demo# sh ./install.sh
最初に、SAGの動作モードを設定します。動作モードは２つあります。
デフォルトは、standaloneモードです。
Select installation type: 1: cron 2: [standalone] ->2
gnuplotがインストールされます。
## Installing dependencies from package quirks-6.121(signed) 2023-06-16T09:53:28Z quirks-6.121: ok gnuplot-5.2.7p1:bzip2-1.0.8p0: ok 〜略〜 gnuplot-5.2.7p1:pcre2-10.37p1: ok gnuplot-5.2.7p1: ok Running tags: ok
sagアカウントが作成されます。
## Creating SAG account: user=sag, group=sag, home=/home/sag
sagがダウンロードされます。
## Downloading SAG tarball sag.tar.gz 100% |*************************************| 18574 00:00 ETA
これ以降は、各種設定を行います。
まず最初は、設定ファイルdfplot.gpの内容が表示され、このファイルを編集するかどうか訊かれます。
==== Here is generated dfplot.gp
plot \
"sumtmp-0100df" using 1:3 title "/", \
"sumtmp-0100df" using 1:4 title "/sysmedia", \
"sumtmp-0100df" using 1:5 title "/fuguita", \
"sumtmp-0100df" using 1:6 title "/ram", \
"sumtmp-0100df" using 1:7 title "/ram/home/kaw/sag"
#
# Edit the gnuplot configuration above to match the actual file system
# layout shown below.
#
# You can rearrange or delete the configuration lines as you wish.
#
# Filesystem Size Used Avail Capacity Mounted on
# /dev/rd0a 1.5M 1005K 547K 65% /
# /dev/sd0a 1.1G 1.1G 8.1M 100% /sysmedia
# /dev/vnd5a 1.1G 1.1G 4.1M 100% /fuguita
# mfs:25873 4.3G 204M 3.9G 5% /ram
# /dev/sd0e 439M 214K 417M 1% /ram/home/kaw/sag
==== Edit this file? [y/N] ->
これは、実際のパーティション情報をもとに自動生成された、gnuplotの描画指示です。
この内容のままでよければ n と応えて次に進みます。yと応えるとテキストエディタが立ち上がりますので、描画指示を修正し、エディタを終了します。
次に、ネットワークインターフェースを指定するファイルnetcmd.shを編集するかどうかを訊かれます。
==== Here is generated 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/t0001
#
# $Id: netcmd.sh,v 1.4 2023/06/15 08:45:27 kaw Exp $
netcmd='set $(netstat -I vio0 -b -n -i); echo $7 ${11} ${12}'
# ~~~~\
# rewrite this to your actual
# network interface
==== Edit this file? [y/N] ->
これも同様にy又はnで応えます。
このファイルでは、測定するネットワークインターフェースが指定されます。当初はデフォルトルートとなるデバイスが指定されています。これとは異なるネットワークインターフェースを指定したい場合は、yと応え、設定内容を変更して下さい。
次は、shconf.shの編集です。このファイルでは取得データの保持日数と各測定項目のグラフ表示期間が指定されます。
==== Here is shconf.sh
# shconf.sh - shell variable configuration for SAG
#
# $Id: shconf.sh,v 1.4 2023/07/28 02:01:07 kaw Exp $
# categories to process data
#
targets='0001la 0001procs 0005mem 0100df 0001net 0005timeofs 0100time'
# days to store data
#
rotate_max=32
# days to display graph
#
span_la=8
span_procs=8
span_mem=8
span_df=32
span_net=8
span_timeofs=8
span_time=32
==== Edit this file? [y/N] -> y
測定項目、測定データ保存期間、各測定項目のグラフ表示期間などを変更したい場合は、yと応えてこのファイルを編集して下さい。
続いて、各種設定が自動で行われます。
## Preparing stuffs to aggregate and plot data ## Setting up root's crontab ## Setting up the startup file ## Setting up sag's crontab ## Setting up web-related stuffs
最後に、グラフ生成後の処理を記述するファイルpostgproc.shを編集するかどうか訊かれます。
==== Here is postgproc.sh, a script to copy graphs to Web. if not needed, leave this untouched. #!/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/. ==== Edit this file? [y/N] -> y
yでエディタを立ち上げ、"exit 0"の行をコメントアウトし、"# sleep 60"とその後の行を非コメント化することで、毎時生成されたグラフは、ディレクトリ/var/www/htdocs/sagにコピーされるようになります。
以上でインストール作業は終りです。
standaloneモードを選択した場合は、今からSAGを起動するかどうか訊かれます。Nと答えた場合は、次回のOS起動後からSAGが動作します。
==== Edit this file? [y/N] -> y ==== You need to add the entry on your httpd.conf(8) file. ==== ==== start SAG now? [y/N] -> y sag_ticker.sh is running, PID is 16476
cronモードの場合は、SAGはすでに動作しています。
## All done. ## ## You need to add the entry on your httpd.conf(8) file. ## sag-demo#
グラフをウェブで閲覧する場合はhttpd.confの編集など、関連する設定も行って下さい。
