System Activity Grapher - インストール手順(通常)

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つあります。

cronモード
SAGの動作はcronによりスケジューリングされ、動作します。
standaloneモード
cronを使わずに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を編集するためにテキストエディタが起動されます。

## 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の編集など、関連する設定を行って下さい。



Front page   New Page list Search Recent changes   Help   RSS of recent changes