12명령줄 참조Command Line Reference

자세한 내용은 항상 두 자료를 함께 참고하라고 원문이 권합니다 — R82 QoS Administration Guide 와 sk41585("How to control and debug QoS / FloodGate-1") 입니다.

Check Point 문서는 가능하면 명령·파라미터·옵션을 알파벳 순 으로 싣고, 구문을 일정한 기호 약속으로 표기합니다. 이 약속을 알아야 아래 명령 설명을 정확히 읽을 수 있습니다.

들여쓰기(TAB) 표기가 가장 헷갈리는데, 원문은 다음 예로 설명합니다.

    config
        -a <options>
        -d <options>
        -p
        -r
    del <options>

이렇게 쓰여 있으면 실제로는 아래 중 하나의 명령 을 실행하라는 뜻입니다 — cpwd_admin config -a <options>, cpwd_admin config -d <options>, cpwd_admin config -p, cpwd_admin config -r, 또는 cpwd_admin del <options>. 즉 위 명령에서 아래로 한 갈래씩 골라 한 줄로 펴는 것입니다.

etmstart 는 게이트웨이에서 QoS Software Blade를 시작 합니다. 구체적으로는 QoS 데몬 fgd50을 띄우고, 게이트웨이의 $FWDIR/conf/masters 파일에 설정된 Management Server에서 QoS 정책을 가져(fetch) 옵니다. 구문은 옵션 없이 단순합니다.

etmstart

실행하면 데몬을 띄우고 masters에서 정책을 받아 인터페이스별(inbound·outbound)로 내려받는 과정이 그대로 출력됩니다.

[Expert@MyGW:0]# etmstart
QoS: Starting fgd50
QoS: Fetching QoS Policy from masters
Fetching QoS Software Blade Policy:
Received Policy. Downloading...
eth0(inbound), eth0(outbound).
Download OK.
Done.
QoS started
[Expert@MyGW:0]#

etmstop 은 반대로 QoS Software Blade를 멈춥 니다. 먼저 데몬 fgd50을 죽이고, 그다음 QoS 정책을 내려(unload) 놓습니다. 구문 역시 옵션이 없습니다.

etmstop

[Expert@CXL1_192.168.3.52:0]# etmstop
Unloading QoS Policy:
Target(s): CXL1_192.168.3.52
CXL1_192.168.3.52: QoS policy unloaded successfully.
Done.
QoS stopped
[Expert@CXL1_192.168.3.52:0]#

fgate 는 실행하는 위치(Management Server인지 Security Gateway인지)에 따라 쓸 수 있는 하위 명령이 달라 집니다. 그래서 아래에서 두 경우를 나눠 설명합니다. 두 경우 모두 -d 옵션을 앞에 붙일 수 있습니다.

Management Server에서의 fgate

Management Server에서 fgate 는 관리하는 Security Gateway에 QoS 정책을 설치·제거하고 상태를 보는 용도입니다. 구문은 다음과 같습니다.

fgate [-d]
      load <Name of QoS Policy>.F <GW1> <GW2> ... <GWN>
      stat
            -h
            <GW1> <GW2> ... <GWN>
      unload <GW1> <GW2> ... <GWN>
      ver

load 에는 두 가지 규칙이 있습니다 — <Name of QoS Policy> 문자열의 최대 길이는 32자 이고, Security Gateway는 SmartConsole에 설정된 객체의 메인 IP 주소나 객체 이름 으로 지정합니다(한 명령에 여러 게이트웨이·클러스터 멤버를 함께 적을 수 있습니다). stat·unload 의 게이트웨이 지정 방법도 이와 똑같습니다.

다음은 사용 예제들입니다.

예제 1 — IP 주소로 지정한 게이트웨이 한 대에 정책 설치

[Expert@MGMT:0]# fgate load MyPolicy.F 192.168.3.52
QoS rules verified OK!
Downloading QoS Policy: MyPolicy.F...
Target(s): MyGW
MyGW: QoS policy transferred to module: MyGW.
MyGW: QoS policy installed succesfully.
Done.
[Expert@MGMT:0]#

예제 2 — 객체 이름으로 지정한 클러스터 멤버 두 대에 정책 설치

[Expert@MGMT:0]# fgate load MyPolicy.F MyClusterMember1 MyClusterMember2
QoS rules verified OK!
Downloading QoS Policy: MyPolicy.F...
MyClusterMember1: QoS policy transferred to module: MyClusterMember1.
MyClusterMember1: QoS policy installed succesfully.
MyClusterMember2: QoS policy transferred to module: MyClusterMember2.
MyClusterMember2: QoS policy installed succesfully.
Done.
[Expert@MGMT:0]#

예제 3 — 객체 이름으로 지정한 게이트웨이 한 대의 QoS 상태 보기

[Expert@MGMT:0]# fgate stat MyGW
Module name: MyGW
=======================
Product: QoS Software Blade
Version: R82
Kernel Build: 456
Policy Name: MyPolicy
Install time: Wed Dec 4 19:53:48 2019
Interfaces Num: 1
Interface table
----------------------------------------------------------------
|Name|Dir|Limit (Bps)|Avg Rate (Bps)|Conns|Pend pkts|Pend bytes|
----------------------------------------------------------------
|eth0|in | 1250000000| 0| 0| 0| 0|
|eth0|out| 1250000000| 0| 0| 0| 0|
----------------------------------------------------------------
[Expert@MGMT:0]#

예제 4 — QoS Software Blade 버전 보기

[Expert@MGMT:0]# fgate ver
This is Check Point QoS Software Blade R82 - Build 123
[Expert@MGMT:0]#

Security Gateway에서의 fgate

Security Gateway에서 fgate 는 정책 설치·제거·상태 보기에 더해 정책 가져오기(fetch)와 디버그 제어 까지 다룹니다. 구문이 더 풍부합니다.

fgate [-d]
      ctl
            -h
            <QoS Module> {on | off}
      debug
            on
            off
      fetch
            -f
            <Management Server>
      kill [-t <Signal Number>] <Name of QoS Process>
      load
      log
            on
            off
            stat
      stat [-h]
      ver [-k]
      unload

각 파라미터의 뜻은 다음과 같습니다.

debug 는 추가 디버깅 정보를 fgd50 데몬의 로그 파일 $FGDIR/log/fgd.elg 로 보냅니다(자세한 내용은 sk41585 참고).

log off 의 쓸모도 알아 두면 좋습니다 — 정책을 다시 설치하지 않고도 QoS 로깅을 꺼서 리소스를 아낄 수 있습니다.

kill 명령에는 몇 가지 규칙이 있습니다.

다음은 사용 예제들입니다.

예제 1 — masters 파일에 따라 QoS 정책 가져오기

[Expert@MyGW]# fgate fetch -f
Fetching QoS Software Blade Policy:
Received Policy. Downloading...
eth0(inbound), eth0(outbound).
Download OK.
Done.
[Expert@MyGW]#

예제 2 — IP 주소로 지정한 Management Server에서 QoS 정책 가져오기

[Expert@MyGW]# fgate fetch 192.168.3.240
Fetching QoS Software Blade Policy:
Received Policy. Downloading...
eth0(inbound), eth0(outbound).
Download OK.
Done.
[Expert@MyGW]#

예제 3 — QoS 상태 보기

[Expert@MyGW]# fgate stat
Product:        QoS Software Blade
Version:        R82
Kernel Build:   456
Policy Name:    MyPolicy
Install time:   Wed Dec 4 19:53:48 2019
Interfaces Num: 1
Interface table
----------------------------------------------------------------
|Name|Dir|Limit (Bps)|Avg Rate (Bps)|Conns|Pend pkts|Pend bytes|
----------------------------------------------------------------
|eth0|in | 1250000000| 0| 0| 0| 0|
|eth0|out| 1250000000| 0| 0| 0| 0|
----------------------------------------------------------------
[Expert@MyGW]#

예제 4 — QoS Software Blade 버전 보기(-k 포함)

[Expert@MyGW:0]# fgate ver
This is Check Point QoS Software Blade R82 - Build 123
[Expert@MyGW:0]#
[Expert@MyGW:0]# fgate ver -k
This is Check Point QoS Software Blade R82 - Build 123
kernel: R82 - Build 456
[Expert@MyGW:0]#