SAGにはインストーラが付属しており、通常のインストールは、このインストーラにより行うことができます。
インストールはroot権限で行います。
インストーラをダウンロードします。
sag-demo# ftp https://raw.githubusercontent.com/ykaw/sag/master/install.sh Trying 185.199.111.133... Requesting https://raw.githubusercontent.com/ykaw/sag/master/install.sh 100% |**************************************************| 4511 00:00 ETA 4511 bytes received in 0.00 seconds (1.17 MB/s) #
ダウンロードが完了したら、インストーラを実行します。
sag-demo# sh ./install.sh
gitとgnuplotがインストールされます。
## Installing dependencies from package quirks-6.121(signed) 2023-06-16T09:53:28Z quirks-6.121: ok git-2.40.0:cvsps-2.1p2: ok 〜略〜 git-2.40.0: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 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 /usr/local/share/doc/pkg-readmes/glib2
sagアカウントが作成されます。
## Creating SAG account: user=sag, group=sag, home=/home/sag
sagがダウンロードされます。
## Retrieving SAG source from the repository Cloning into 'sag'... remote: Enumerating objects: 542, done. remote: Counting objects: 100% (119/119), done. remote: Compressing objects: 100% (65/65), done. Receiving objects: 100% (542/542), 384.74 KiB | 374.00 KiB/s, done. Resolving deltas: 100% (242/242), done. remote: Total 542 (delta 53), reused 89 (delta 42), pack-reused 423K
ディスクパーティションのプロットを指定するファイル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
取得データの保持日数と各測定項目のグラフ表示期間を指定するファイルnetcmd.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/.
以上で終りです。
グラフをウェブで閲覧する場合はhttpd.confの編集など、関連する設定を行って下さい。
## All done. ## ## You need to add the entry on your httpd.conf(8) file. ## sag-demo#