====== HOW-TO Glance ======

===== Glance 란? =====
  * Glance는 HP-UX 상에서 강력하면서도 쉽게 사용할 수 있는 Systerm performance monitor 툴이다. 
  * Glance는 Systerm 자원과 Active processes에 대한 일반적인 정보와 \\ CPU, 메모리, Disk IO, Network, NFS , System Calls, Swap 또는 System Table 화면을 통해 더욱 특수한 정보를 제공해 주며, \\ Glance를 터미널 환경에서 실행함으로써 HP 9000 시리즈의 Performance problem의 분석을 도울 수 있다. 

===== Option =====
^ Option ^ Description ^
| -j interval | 스크린 refresh 간격을 초 단위로 설정한다. \\ interval의 범위는 2에서 32767 사이이다. |
| -p [dest] | 데이타를 출력할 디바이스를 설정한다. \\ 기본값은 기본 lp device이다. |
| -f dest | 데이타를 출력할 파일을 설정한다. |
| -maxpages numpages | p 명령으로 출력할 최대 페이지 수를 바꾼다. |
| -command | 3절에에서 소개되는 command 를 이용하여 다른 initial screen을 볼 수 있도록 한다. \\ command들 중 일부(첫번째 섹션)만이 이 옵션에 사용될 수 있다. |
| -nice nicevalue | Glance 프로세스에 대한 nice priority를 설정할 수 있게 한다. \\ 기본 값은 -10이다. |
| -nosort | 소트를 하지 않는다. \\ 이에 따라 CPU overhead가 줄어든다. |
| -lock | Glance 가 메모리에 lock시킨다. \\ 이 옵션을 사용함으로써 response time 이 향상 되나 에러가 발생할 수 있다. |
| -adviser_off | Adviser없이 Glance를 실행 시킨다. |
| -adviser_only | Adviser만을 stdout을 통하여 보여준다. \\ stdout을 파일로 redirection 하여 Glance Adviser가 백그라운드로 돌게 할 수 있다. |
| -iterations count | Glance 가 실행되는 최대 횟수를 지정할 수 있다. \\ Glance는 count에 지정된 수 만큼 실행되고 중단된다. \\ count는 2이상이어야 하며, 2 이하일 때는 2번 실행하게 된다. |
| -syntax filename | Adviser에 의해 사용될 Syntax 파일을 지정한다. \\ 파일을 지정하지 않 을 경우 '~/adviser.syntax'파일을 사용하고 \\ 이 파일이 없을 경우 /var/opt/perf/adviser.syntax 파일을 사용하게 된다. |
| -disks n, -kernel path, -nfs n, -pids n | mideavom의 초기값들을 설정하는 데 사용된다. |



===== Command List =====
^ Command ^ Screen Displayed/Description ^
| a | Processor에 할당된 CPU 사용량을 보여 준다. |
| c | CPU의 사용에 대한 종합적인 정보를 보여 준다.  |
| d | Disk 사용에 대한 종합적인 정보를 보여 준다. |
| g | 현재 Process들의 List를 보여 준다. |
| i | File System에 의한 IO상황을 보여준다. |
| l | Network By Interface |
| m | Memory 의 상황을 보여 준다. |
| n | NFS By System |
| t | System Tables Report |
^ u | IO By Disk |
^ v | IO By Logical Volume |
| w | Swap Space |
| A | Application List |
| B | Global Wait States |
| D | DCE Global Activity |
| K | DCE Process List |
| N | NFS Global Activity |
| P | PRM Group List |
| T | Transaction Tracker |
| Y | Global System Calls |
| ? | Command Menu |
| S | Select a NFS system/Disk/Application/Trans |
| s | Select a single process |
| E | Process DCE Activity |
| F | Process Open Files |
| L | Process System Calls |
| M | Process Memory Regions |
| O | Process DCE Operations |
| R | Process Resources |
| W | Process Wait States |
| b | 앞 페이지로 넘긴다. |
| f | 다음 페이지로 넘어간다 |
| h | Online help |
| j | 화면 refresh간격을 조정한다. |
| o | 프로세스 threshold 를 조정한다. |
| p | Print toggle |
| q | 종료 |
| r | 현재 화면을 리프레시 한다. |
| y | 프로세스의 nice-value를 수정한다. |
| z | statistics를 0으로 리셋한다.  |
| > | 다음 화면(logical)을 출력한다. |
| < | 이전 화면(logical)을 출력한다. |
| ! | 쉘을 띄운다. |

  * 위의 command는 Top level screens commands 와 Secondary Screens commands 그리고 misc-ellaneous commands의 세개의 그룹으로 나위어 진다. \\ 이중 Top level screens commands가 command 옵션에서 사용될 수 있다. 


===== Examples =====

==== Base Case 1 ====
  - Shell에서 glance를 실행시키면 초기 화면(figure 1)이 뜨고, 잠시후 Process List 화면이 뜬다.
  - 's'키를 누르고 pid를 입력하면 하나의 프로세스에 대한 상세한 정보를 얻을 수 있다.
  - Application List에서 'S'를 누르면 하나의 어플리케이션에서 돌고 있는 상세한 프로세스들에 대한 정보를 볼 수 있다. \\ 이와 같은 기능은 NFS by System, IO by Disk, Transaction Tracker화면에서 사용할 수 있다.
  - '?'키를 누르면 Command List를 보여주고, 'h'키를 누르면 온라인 도움말이 뜬다.


===== FaQ , QnA =====
  * glance에서 buffer cache의 size가 display되게 하려면? <code>
$ glance -m 
</code

  * motif base의 glance를 display 하려면? <code>
/usr/perf/bin/gpm 을 하면 됩니다.
s800 의 경우에는 DISPLAY=xterm:0.0 ;export DISPLAY 를 setup해야 합니다. 
</code>

  * kill로 죽인 process가 ps -ef 에는 나타나지 않지만 glance로 보면 살아있는 것처럼 나타납니다. <code>
/usr/perf/bin/midaemon 를 다시 restart하십시요.
#ps -ef | grep midaemon 
#kill 
#/usr/perf/bin/midaemon 
</code>

  * glance를 실행하면 UNABLE TO INITIALIZE YOUR TERMINAL이라는 error가 발생합니다. <code>
glance는 terminal이 80x24가 되어야 작동합니다. 
# stty -a를 하시면 다음 정보를 볼수 있습니다.
speed 9600 baud; line = 0; susp = ^Z; dsusp = ^@
rows = 0; columns = 80
intr = ^C; quit = ^\; erase = ^H; kill = ^U; swtch = ^@

위에서 rows와 columns를 보면 rows가 0임을 알수 있습니다. 
rows를 다음과 같이 수정합니다. 
# stty rows 24
다시 glance를 실행하시면 됩니다. 
</code>

  * glance 실행시 아래와 같은 error message가 뜹니다. <code>
== Fatal Nums Error == $Header: db.C,v 1.200 95/05/11 13:45:02 smead Exp $ ==
User: root Date: Tue Sep 12 15:08:52
File: nums.C Line: 414 Product id: Gpm
System: ov-serve B.10.01 9000/819

Midaemon not responding [MI_SHARED:]
== End of Error Msg ============================= 


먼저 midaemon을 명령행에서 실행시킵니다. 
# /opt/perf/bin/midaemon 

여전히 error가 발생하면 /var/opt/perf/datafiles directory가 존재하는지 확인후 만약 없으면 mkdir로 만들어 줍니다. 
# cd /var/opt/perf 
# mkdir datafiles 
# chmod 777 datafiles 
# chown bin:bin datafiles
 
glance를 실행시키면 정상적으로 동작할 것입니다. 
</code>