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の動作モードを設定します。動作モードは2つあります。
デフォルトは、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を編集するためにテキストエディタが起動されます。
## Edit dfplot.gp - specify disk partitions to plot, if necessary.
編集内容はgnuplotの設定ファイルで、内容は以下のとおりです。これは、実際のパーティション情報をもとに自動生成されているので、このままでよければエディタをそのまま終了して下さい。
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" # # 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 1.0M 476K 69% / # /dev/cd0a 1023M 1023M 0B 100% /sysmedia # /dev/vnd5a 996M 995M 1.4M 100% /fuguita # mfs:12614 1.4G 296M 1.1G 22% /ram
ネットワークインターフェースを指定するファイルnetcmd.shを編集するためにテキストエディタが起動されます。
## Edit netcmd.sh - specify the network interface to plot.
下のように、実際に測定したいネットワークインターフェース名を指定して下さい。当初はデフォルトルートとなるデバイスが指定されています。そのようなデバイスがない場合は、適当なイーサネット、あるいはWiFiデバイスが指定されています。
# 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
取得データの保持日数と各測定項目のグラフ表示期間を指定するファイルshconf.shを編集するためにテキストエディタが起動されます。
## Edit shconf.sh - specify spans to archive logs and plot graphs.
デフォルトでよければ編集を行わずにエディタを終了して下さい。
# 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
続いて、各種設定が自動で行われます。
## 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
グラフの画像ファイルをウェブのドキュメントルート配下にコピーするためのファイルgpostproc.shを編集するためにテキストエディタが起動されます。
## Edit 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/.
以上でインストール作業は終りです。
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の編集など、関連する設定を行って下さい。