14명령어 레퍼런스Command Line Reference

VSX 구성에 문제가 의심되면, 원인을 찾기 위한 진단 절차가 정해져 있습니다. 아래 절차는 모두 이 장의 명령을 활용합니다.

VSX Gateway / VSX Cluster Member에서 SIC 신뢰를 맺을 수 없을 때

VSX Gateway나 VSX Cluster Member를 만들 때 SIC 신뢰가 맺어지지 않고, SmartConsole에 Certificate cannot be pushed. Connection error with wait agent. 오류가 뜨는 경우입니다.

새 Virtual Device의 SIC 신뢰 문제

새 Virtual System·Virtual Router·Virtual Switch를 만들 때 SIC 신뢰가 맺어지지 않는 경우입니다.

VSX 생성 마법사에서 정책 설치 오류

VSX 생성 마법사 완료 후 Error: Default policy installation failed on VSX. Install policy manually using SmartConsole. 메시지가 나오는 경우입니다.

내부 호스트가 Virtual System을 ping할 수 없을 때

내부 VLAN 인터페이스를 가진 Virtual System을 정의한 뒤, 그 VLAN의 내부 호스트가 VS의 내부/외부 IP를 ping하지 못하는 경우입니다.

Virtual Device의 SIC 신뢰 재수립

특정 Virtual Device(Virtual System 또는 Virtual Router)의 SIC 신뢰가 끊겨 연결 문제가 생긴 경우, 수동으로 다시 맺을 수 있습니다(sk34098 참고).

     vsx sic reset <VSID>
     

     mdsenv <Domain Management Server의 IP 또는 이름>
     

     cpca_client lscert -stat valid -kind SIC | grep -i -A 2 <Virtual Device 객체 이름>
     

     cpca_client revoke_cert -n <CN=...,O=...,>
     

이 가이드(와 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>.

cpconfig — Check Point 구성 도구 실행

설치된 Check Point 제품의 세부 설정을 메뉴로 다루는 Check Point Configuration Tool 을 띄웁니다.

cpconfig

메뉴 항목은 구성·설치된 제품에 따라 달라집니다.

단일 Security Gateway에서는 메뉴가 보통 다음처럼 나옵니다(번호는 환경에 따라 다름).

[Expert@MySingleGW:0]# cpconfig
Configuration Options:
----------------------
(1) Licenses and contracts
(2) SNMP Extension
(3) PKCS#11 Token
(4) Random Pool
(5) Secure Internal Communication
(6) Enable cluster membership for this gateway
(7) Check Point CoreXL
(8) Automatic start of Check Point Products
(9) Exit
Enter your choice (1-9) :

Cluster Member에서는 Per Virtual System State·ClusterXL for Bridge 항목이 추가로 나타납니다.

[Expert@MyClusterMember:0]# cpconfig
Configuration Options:
----------------------
(1) Licenses and contracts
(2) SNMP Extension
(3) PKCS#11 Token
(4) Random Pool
(5) Secure Internal Communication
(6) Disable cluster membership for this gateway
(7) Enable Check Point Per Virtual System State
(8) Enable Check Point ClusterXL for Bridge Active/Standby
(9) Check Point CoreXL
(10) Automatic start of Check Point Products
(11) Exit
Enter your choice (1-11) :

cpview — 실시간 시스템·블레이드 통계

CPView 는 Check Point 컴퓨터에 내장된 텍스트 유틸리티로, CPU·메모리·디스크 같은 일반 시스템 정보와 Software Blade 통계를 보기 좋은 뷰에서 계속 갱신해 보여 줍니다(Software Blade 정보는 Security Gateway / ClusterXL / Security Group에서만). 자세한 내용은 sk101878을 참고합니다.

cpview --help

화면은 세 부분으로 나뉩니다.

탐색 키:

인터페이스 옵션 키:

저장·도움말·갱신 키:

VSX에서는 VS0 컨텍스트에서 CPView를 실행한 뒤 Advanced > VSX > VSs > Physical-Resources 로 들어가면 VS별 자원 소비를 봅니다.

vsenv — 셸 컨텍스트 전환

가장 자주 쓰는 명령입니다. 셸의 현재 컨텍스트를 지정한 Virtual Device로 바꿉니다. 인자 없이 실행하면 기본 장치 VS0으로 갑니다.

vsenv [{<VSID> | <Name of Virtual Device>}]

[Expert@MyVsxGW:0]# vsenv
Context is set to Virtual Device VSX2_192.168.3.242 (ID 0).

[Expert@MyVsxGW:0]# vsenv 2
Context is set to Virtual Device VS2 (ID 2).
[Expert@MyVsxGW:2]#

전환하면 프롬프트 끝(:0, :2 등)이 현재 컨텍스트를 보여 줘서, 이후 실행하는 fw·ifconfig·route 같은 명령이 그 VS 관점으로 동작합니다.

vsx — VSX 구성 조회·가져오기·메모리 자원 제어

vsx는 VSX 구성을 보여 주고, 가져오고(fetch), 메모리 자원 제어(Memory Resource Control)를 설정하는 명령으로 여러 하위 명령을 가집니다.

      fetch <options>
      fetch_all_cluster_policies
      fetchvs <options>
      get
      mstat <options>
      resctrl
      showncs <options>
      sicreset
      stat <options>
      unloadall
      vspurge

vsx fetch — VSX Gateway 구성 가져오기

Security Management Server나 Main Domain Management Server에서 가장 최신 구성 파일을 가져와 VSX Gateway에 적용합니다.

vsx fetch [-v] [-q] [-s] local
vsx fetch [-v | -q | -s] [-f <Configuration File>]
vsx fetch [-v | -q] -C "NCS Command"
vsx fetch [-v | -q | -c | -n | -s] [<Management Server>]

반환값: 0은 성공, 그 외는 오류.

[Expert@MyVsxGW:0]# vsx fetch
Fetching VSX Configuration From: 192.168.30.40
Local VSX Configuration is Up-To-Date.
...
Virtual Systems configuration file installed successfully

vsx fetch_all_cluster_policies — 모든 정책 가져오기

클러스터 피어로부터 모든 VS·VR의 Security Policy를 가져옵니다.

vsx fetch_all_cluster_policies [-v]

vsx fetchvs — 특정 VS 구성 가져오기

VSX Gateway에 로컬로 저장된 정보를 기준으로 지정한 Virtual Device의 구성 파일을 가져옵니다.

vsx fetchvs [-v | -q] [{<VSID> | <Name of Virtual Device>}]

vsx get — 현재 컨텍스트 정보

현재 VSX 컨텍스트 정보를 보여 줍니다.

vsx get

[Expert@MyVsxGW:0]# vsx get
Current context is VSX Gateway MyVsxGW (ID 2).

vsx mstat — 메모리 자원 제어

Memory Resource Control을 보여 주고 설정합니다. 출력에는 다음 전역 메모리 자원이 나옵니다.

vsx mstat help
vsx mstat
    [-vs <VSID>] [unit <Unit>] [sort {<Number> | all}]
      debug
      disable
      enable
      status
      swap <Minutes>

[Expert@MyVsxGW:0]# vsx mstat unit M sort all
VSX Memory Status
=================
Memory Total: 7753.95 MB
Memory Free: 7168.71 MB
Swap Total: 3992.71 MB
Swap Free: 3992.71 MB
Swap-in rate: 8796093022208.00 MB
VSID | Memory Consumption
======+====================
0 | 260.79 MB
1 | 0.00 MB

vsx showncs — Virtual Device의 NCS 보기

지정한 Virtual Device의 Check Point Network Configuration Script(NCS)를 보여 줍니다.

vsx showncs {<VSID> | <Name of Virtual Device>}

vsx sicreset — Virtual Device의 SIC 리셋

현재 VSX 컨텍스트의 Virtual System·Virtual Router의 SIC를 리셋합니다.

vsenv {<VSID> | <Name of Virtual Device>}
vsx sicreset {<VSID> | <Name of Virtual Device>}

vsx stat — VSX Gateway 상태 보기

VSX Gateway의 상태 정보를 보여 줍니다. 진단의 1순위 명령입니다.

vsx stat [-l] [-v] [<VSID>]

요약 표(-v)에서는 정책·SIC 상태·라이선스가 허용하는 VS 수·활성/구성된 VS 수 등을 한 번에 봅니다.

[Expert@MyVsxGW:2]# vsx stat -v
VSX Gateway Status
==================
Name: VSX1_192.168.3.241
Access Control Policy: VSX_Cluster_VSX
SIC Status: Trust
Number of Virtual Systems allowed by license: 25
Virtual Systems [active / configured]: 2 / 2
...
Type: S - Virtual System, B - Virtual System in Bridge mode,
R - Virtual Router, W - Virtual Switch.

-l은 VSID·VRID·Type·Name·Security Policy·SIC Status·연결 수/피크/한계를 장치별로 펼쳐 보여 주고, <VSID>를 주면 그 장치만 같은 형식으로 보여 줍니다.

vsx unloadall — 모든 정책 내리기

모든 Virtual System·Virtual Router의 Security Policy를 내립니다(sk33065 참고).

vsx unloadall

vsx vspurge — 사용하지 않는 항목 정리

관리 DB에는 더 이상 정의되지 않지만, VSX Gateway가 다운·단절되어 제거되지 못한 Virtual Device를 정리합니다. NCS local.vskeep의 미사용 항목을 모두 지우고 VSX 구성 파일을 다시 가져옵니다.

vsx vspurge [-q | -v] [-f <purge_file>]

vsx_util은 관리 서버(Security Management Server 또는 MDS의 Main Domain Management Server)의 Expert mode에서 실행하는, 다양한 VSX 유지보수 작업 명령 모음입니다.

vsx_util -h
vsx_util <Command> [-s <Mgmt Server>] [-u <UserName>] [-c <Name of VSX Object>] [-m <Name of VSX Cluster Member>]

이 명령은 IP/호스트명·관리자 계정·암호·대상 VSX 객체를 입력받으며, 대부분의 하위 명령은 대화형이라 추가 입력을 요구합니다. 메뉴를 빠져나가려면 CTRL C를 누르되, 이미 변경 작업이 시작된 뒤에는 누르지 마세요(로그 파일이 저장되지 않습니다).

vsx_util 하위 명령:

vsx_util add_member — 클러스터 멤버 추가

VSX Cluster에 새 Cluster Member를 추가하고 VSX Cluster 구성을 push합니다.

vsx_util add_member

필요한 입력: 해당 VSX Cluster 객체, 새 멤버 이름, 관리 인터페이스 IP, 동기화 인터페이스 IP, 일회용 Activation Key(SIC 키).

명령이 멤버를 관리 DB에 추가한 뒤 새 멤버를 reconfigure할지 묻습니다. y를 누르면 새 멤버에서 vsx_util reconfigure가 자동 시작됩니다(reconfigure 후 새 멤버를 반드시 재부팅). n을 누르면 나중에 수동으로 vsx_util reconfigure를 실행해야 합니다.

vsx_util change_interfaces — 인터페이스 일괄 교체

지정한 기존 인터페이스를 새 인터페이스로, 그것이 연결된 모든 Virtual Device에서 자동 교체합니다. Link Aggregation(본드) 전환처럼 VLAN이 여러 Virtual Device에 연결될 때 특히 유용합니다.

vsx_util change_interfaces

필요한 입력: 해당 VSX Gateway / Cluster 객체, 변경 적용 범위(관리 서버만 / 관리 서버+Gateway·Member), 교체될 인터페이스 이름, 새 인터페이스 이름.

이 명령은 resume(재개) 기능을 지원하며, Management Only 모드로 Open Server에서 Check Point 어플라이언스로 VSX 배포를 이전할 때도 쓸 수 있습니다. 절차는 다음과 같습니다.

vsx_util change_mgmt_ip — 관리 IP 변경(같은 서브넷)

VSX Gateway / Cluster Member의 VSX 관리 IP를 같은 서브넷 안에서 변경합니다(sk92425).

vsx_util change_mgmt_ip

필요한 입력: 해당 VSX Cluster 객체, 해당 VSX Cluster Member 객체, 새 관리 IP.

vsx_util change_mgmt_subnet — 관리 IP 변경(다른 서브넷)

VSX 관리 IP를 현재 서브넷에서 다른 서브넷으로 변경합니다(sk92425).

vsx_util change_mgmt_subnet

필요한 입력: 해당 VSX Gateway / Cluster 객체, 새 관리 IPv4 주소·넷마스크, 새 관리 IPv6 주소·prefix, 새 IPv4·IPv6 기본 게이트웨이.

vsx_util change_private_net — 클러스터 사설망 변경

VSX Cluster의 내부 통신 네트워크(클러스터 사설망) IP를 변경합니다.

vsx_util change_private_net

필요한 입력: 해당 VSX Cluster 객체, 새 IPv4 주소·넷마스크, 새 IPv6 주소·prefix.

vsx_util convert_cluster — 클러스터 모드 변환

VSX Cluster 모드를 High Availability(기본)와 Virtual System Load Sharing 사이에서 변환합니다.

vsx_util convert_cluster

필요한 입력: 해당 VSX Cluster 객체, ClusterXL 모드(대소문자 구분).

VSLS에서 HA로 변환하면 기본적으로 모든 VS가 같은 멤버에서 Active이고, 피어 VS는 다른 멤버에서 Standby가 됩니다.

vsx_util downgrade — 버전 다운그레이드

관리 DB에서 VSX Gateway / Cluster의 버전을 다운그레이드합니다.

vsx_util downgrade

필요한 입력: 해당 VSX Gateway / Cluster 객체, 해당 Check Point 버전.

vsx_util reconfigure — VSX 구성 복원

VSX Gateway / Cluster Member의 VSX 구성을 복원합니다(예: 시스템 장애 후 clean install을 한 경우). 정책 push 실패 시 1순위 처방입니다.

vsx_util reconfigure

필요한 입력: 해당 VSX Gateway / Cluster 객체, 일회용 Activation Key(SIC 키).

새 Gateway / Member는 ① 새 설치여야 하고(이전 VSX 구성이 있으면 안 됨), ② 원본과 하드웨어 사양이 같아야 하며(특히 인터페이스 수가 최소한 같아야 함), ③ 같은 Gaia OS 구성(특히 같은 VSX 관리 IP)을 가져야 합니다.

reconfigure가 복원하지 않아 직접 챙겨야 하는 주요 파일(알파벳 순, 일부는 기본으로 존재하지 않거나 VS별로 구성됨):

$FWDIR/boot/modules/fwkern.conf
$FWDIR/conf/cpha_bond_ls_config.conf
$FWDIR/conf/cpha_specific_vlan_data.conf      (sk92784)
$FWDIR/conf/discntd.if
$FWDIR/conf/fw_fast_accel_export_configuration.conf  (sk156672)
$FWDIR/conf/fwaffinity.conf
$FWDIR/conf/fwauthd.conf
$FWDIR/conf/hsm_configuration.C
$FWDIR/conf/identity_broker.C
$FWDIR/conf/ipassignment.conf
$FWDIR/conf/local.arp                          (sk30197)
$FWDIR/conf/malware_config
$FWDIR/conf/prioq.conf                         (sk105762)
$FWDIR/conf/rad_conf.C
$FWDIR/conf/synatk.conf
$FWDIR/conf/te.conf
$FWDIR/conf/thresholds.conf
$FWDIR/conf/trac_client_1.ttm
$FWDIR/conf/vsaffinity_exception.conf
$PPKDIR/conf/simkern.conf
/var/ace/sdconf.rec
/var/ace/sdopts.rec
/var/ace/sdstatus.12
/var/ace/securid

reconfigure는 단계별 진행률(Certificate Revocation → Replacement → Connectivity Check → Fetching/Verifying Configuration → Installing policy → Converting Gateway to VSX → Generating Activation Keys → Reconfiguring → Pushing Configuration)을 보여 주고 끝나면 SUMMARY를 출력합니다.

vsx_util remove_member — 클러스터 멤버 제거

VSX Cluster에서 Cluster Member를 제거합니다.

vsx_util remove_member

필요한 입력: 해당 VSX Cluster 객체, 해당 VSX Cluster Member 객체.

vsx_util show_interfaces — 인터페이스 구성 보기

선택한 인터페이스의 구성(유형·Virtual Device 연결·IP)을 보여 주고, 현재 작업 디렉터리의 interfacesconfig.csv 파일로도 저장합니다.

vsx_util show_interfaces

필요한 입력: 해당 VSX Gateway / Cluster 객체, 표시할 인터페이스 선택.

출력의 Type 범례: M(Management)·S(Synchronization)·V(VLAN)·W(Warp)·U(Used)·A(Available)·X(Unknown)·E(Error in Interface Properties).

vsx_util upgrade — 버전 업그레이드

관리 DB에서 VSX Gateway / Cluster의 버전을 업그레이드합니다.

vsx_util upgrade

필요한 입력: 해당 VSX Gateway / Cluster 객체, 해당 Check Point 버전.

vsx_util view_vs_conf — 구성 비교

모든 Virtual Device에 대해 관리 서버의 구성과 실제 VSX Gateway / Member의 구성을 비교합니다.

vsx_util view_vs_conf

필요한 입력: 해당 VSX Gateway / Cluster 객체, 해당 Virtual Device 객체.

출력은 인터페이스 표와 라우팅 표를 보여 줍니다. 범례:

vsx_util vsls — VSLS 구성 메뉴

Virtual System Load Sharing의 구성 메뉴(상태·재분배·내보내기·가져오기)를 보여 줍니다.

vsx_util vsls

필요한 입력: 해당 VSX Cluster 객체, 해당 재분배 옵션. 출력이 Operation not allowed. Object is not a Virtual System Load Sharing cluster.이면 먼저 vsx_util convert_cluster를 실행합니다.

VSLS 메뉴:

VS Load Sharing - Menu
________________________________
1. Display current VS Load sharing configuration
2. Distribute all Virtual Systems so that each cluster member is equally loaded
3. Set all VSes active on one member
4. Manually set priority and weight
5. Toggle VSLS mode between Active Up and Primary Up
6. Import configuration from a file
7. Export configuration to a file
8. Exit
Enter redistribution option (1-8) [1]:

vsx_provisioning_tool은 Security Management Server / Domain Management Server의 명령줄에서 Virtual Device(VS·VR·VSW)·인터페이스·라우트를 추가·제거하는 도구로, VSX 프로비저닝 작업을 자동화합니다.

vsx_provisioning_tool -h
vsx_provisioning_tool [-s <Mgmt Server>] {-u <Username> | -c <Certificate>} -p <Password>
      -o <Commands> [-a] -L
      -f <Input File> [-l <Line>] [-a] -L

종료 코드:

# 예제 1 - Security Management Server에서 파일 실행
vsx_provisioning_tool -s localhost -u admin -p mypassword -f /var/log/vsx.txt

# 예제 2 - MDS의 MyDomain 컨텍스트에서 VS1 생성 + eth4.100 VLAN 추가
mdsenv MyDomain
vsx_provisioning_tool -s localhost -u admin -p mypassword -o add vd name VS1 vsx VSXCluster1, add interface name eth4.100 ip 1.1.1.1/24

트랜잭션

작동 단위는 트랜잭션 입니다. 알아 둘 규칙은 다음과 같습니다.

모든 vsx_provisioning_tool 명령은 키 값 쌍의 나열입니다. 각 명령의 처음 두 단어는 정해진 순서로 와야 하고, 나머지 쌍은 순서가 자유롭습니다.

명시적 트랜잭션 명령:

add vsx (type gateway) — VSX Gateway 생성

새 VSX Gateway 객체를 추가합니다. 이 트랜잭션에는 set physical_interface 명령만 추가할 수 있습니다.

add vsx type gateway name <Name of VSX Gateway Object> version <Version> main_ip <Main IPv4 Address> [main_ip6 <Main IPv6 Address>] sic_otp <Activation Key> [rule_snmp {enable | disable}] [rule_ssh {enable | disable}] [rule_ping {enable | disable}] [rule_ping6 {enable | disable}] [rule_https {enable | disable}] [rule_drop {enable | disable}]

vsx_provisioning_tool -s localhost -u admin -p mypassword -o add vsx name VSX_GW1 type gateway main_ip 192.168.20.1 version R82 sic_otp ABCDEFG rule_ssh enable rule_ping enable

add vsx (type cluster) — VSX Cluster 생성

새 VSX Cluster 객체를 추가합니다.

add vsx type cluster name <Name of VSX Cluster Object> version <Version> main_ip <Main Virtual IPv4 Address> main_ip6 <Main Virtual IPv6 Address> cluster_type {vsls | ha | crbm} sync_if_name <Name of Sync Interface> sync_netmask <Sync Interface Netmask> [rule_snmp {enable | disable}] [rule_ssh {enable | disable}] [rule_ping {enable | disable}] [rule_ping6 {enable | disable}] [rule_https {enable | disable}] [rule_drop {enable | disable}]

vsx_provisioning_tool -s localhost -u admin -p mypassword -o add vsx name VSX1 type cluster cluster_type vsls main_ip 192.168.1.1 version R82 sync_if_name eth3 sync_netmask 255.255.255.0 rule_ssh enable rule_ping enable

add vd — Virtual Device 생성

새 Virtual Device 객체(VS·Bridge 모드 VS·Virtual Switch·Virtual Router)를 추가합니다.

add vd name <Name of Virtual Device Object> vsx <Name of VSX Gateway or VSX Cluster Object> [type {vs | vsbm | vsw | vr}] [vs_mtu <MTU>] [instances <Number of IPv4 CoreXL Firewall instances>] [instances6 <Number of IPv6 CoreXL Firewall instances>] [main_ip <Main IPv4 Address>] [main_ip6 <Main IPv6 Address>] [calc_topo_auto {true | false}]

vsx_provisioning_tool -s localhost -u admin -p mypassword -o add vd name VirtSwitch1 vsx VSX_GW1 type vsw

remove vd — Virtual Device 삭제

Virtual Device 객체를 삭제합니다. 정책 규칙·다른 객체에서 참조되거나 MDS 환경에서 전역 사용으로 켜진 장치는 삭제할 수 없습니다.

remove vd name <Name of Virtual Device Object>

vsx_provisioning_tool -s localhost -u admin -p mypassword -o remove vd name VirtSwitch1

set vd — Virtual Device 설정 변경

기존 Virtual Device 객체의 설정을 바꿉니다.

set vd name <Name of Virtual Device Object> [vs_mtu <MTU>] [instances <Number of IPv4 CoreXL Firewall instances>] [instances6 <Number of IPv6 CoreXL Firewall instances>] [main_ip <Main IPv4 Address>] [main_ip6 <Main IPv6 Address>] [calc_topo_auto {true | false}]

vsx_provisioning_tool -s localhost -u admin -p mypassword -o set vd name VS1 instances 8 main_ip 192.0.2.6 calc_topo_auto false

add interface — 물리·VLAN 인터페이스 추가

기존 Virtual Device 객체에 인터페이스를 추가합니다.

add interface vd <Name of Virtual Device Object> {name <Name of Interface> | leads_to <Name of VSW or VR Object>} ip <IPv4 Address>{/<IPv4 Prefix Length> | netmask <IPv4 Netmask> | prefix <IPv4 Prefix>} ip6 <IPv6 Address>{/<IPv6 Prefix Length> | netmask6 <IPv6 Netmask> | prefix6 <IPv6 Prefix>} [propagate {true | false}] [propagate6 {true | false}] [topology {external | internal_undefined | internal_this_network | internal_specific [specific_group <Name of Network Group Object>]}] [mtu <MTU>]

vsx_provisioning_tool -s localhost -u admin -p mypassword -o add interface vd VirtSystem1 name eth4.100 ip 1.1.1.1/24

attach bridge — Virtual System에 Bridge 인터페이스 추가

IP 주소를 가진 일반 VS에 Bridge 인터페이스를 추가해, 그 브리지를 지나는 트래픽에 대해 Threat Emulation·Identity Awareness 등 Bridge 모드 VS가 지원하지 못하는 블레이드를 쓸 수 있게 합니다.

attach bridge vd <Name of Virtual System Object> ifs1 <Name of First Subordinate Interface> ifs2 <Name of Second Subordinate Interface>

# 단일 브리지: eth2·eth3을 VS1의 하위 인터페이스로
vsx_provisioning_tool -s localhost -u admin -p mypassword -o attach bridge vd VS1 ifs1 eth2 ifs2 eth3

# Multi Bridge: 두 VLAN 쌍 (eth2·eth3을 VLAN Trunk로 미리 구성해야 함)
vsx_provisioning_tool -s localhost -u admin -p mypassword -o attach bridge vd VS1 ifs1 eth2.403 ifs2 eth3.403, attach bridge ifs1 eth2.504 ifs2 eth3.504

add interface (vpn_tunnel) — VPN 터널 인터페이스 추가

Route-Based VPN 터널을 맺는 가상 인터페이스(VTI)를 기존 Virtual System 객체에 추가합니다. VTI를 만들기 전에 VPN 커뮤니티와 그 멤버 Gateway를 먼저 정의해야 합니다.

add interface vd <Name of Virtual System Object> vpn_tunnel numbered peer <Name of VPN Peer Object> local <Tunnel Local IP> remote <Tunnel Remote IP> [tunnel_id <Tunnel ID>]

vsx_provisioning_tool -o add interface vd vs1 vpn_tunnel numbered peer AWS_Peer local 169.254.46.238 remote 169.254.46.237 tunnel_id 10

remove interface — 인터페이스 제거

기존 Virtual Device 객체에서 인터페이스를 제거합니다.

remove interface vd <Name of Virtual Device Object> {name <Name of Interface> | leads_to <Name of VSW or VR Object>}

# VLAN 인터페이스 제거
vsx_provisioning_tool -s localhost -u admin -p mypassword -o remove interface vd VS1 name eth4.100

# 브리지 하위 인터페이스 eth2·eth3 모두 제거
vsx_provisioning_tool -s localhost -u admin -p mypassword -o remove interface vd VS1 name eth2, remove interface vd VS1 name eth3

set interface — 인터페이스 설정 변경

기존 Virtual Device 객체에 속한 인터페이스의 설정을 바꿉니다.

set interface vd <Name of Virtual Device Object> {name <Name of Interface> [new_name <Name of New Interface>] | leads_to <Name of VSW or VR Object> [new_leads_to <Name of New VSW or VR Object>]} [propagate {true | false}] [propagate6 {true | false}] [topology {external | internal_undefined | internal_this_network | internal_specific [specific_group <Network Group Object Name>]}] [mtu <MTU>]

vsx_provisioning_tool -s localhost -u admin -p mypassword -o set interface vd VS1 name eth4.100 new_name eth5 propagate true topology internal_specific specific_group NYGWs

set physical_interface — 물리 인터페이스를 VLAN Trunk로

물리 인터페이스를 VLAN Trunk로 구성합니다. 그 인터페이스에 VLAN 인터페이스를 구성하려면 필요합니다.

set physical_interface vd <Name of VSX Gateway or VSX Cluster Object> name <Name of Interface> vlan_trunk {true | false}

vsx_provisioning_tool -s localhost -u admin -p mypassword -o set physical_interface vd VSX1 name eth2 vlan_trunk true

add route — 라우트 추가

기존 Virtual System·Virtual Router 객체에 IPv4·IPv6 라우트를 추가합니다(IPv4·IPv6 자동 감지).

add route vd <Name of VS or VR Object> destination {<IP Address> [/<IP Prefix>] | default | default6} [{netmask <IP Netmask> | prefix <IP Prefix>}] {next_hop <Next Hop IP Address> | leads_to <Name of VS or VR Object>} [propagate {true | false}]

vsx_provisioning_tool -s localhost -u admin -p mypassword -o add route vd VS1 destination default leads_to VR3

remove route — 라우트 제거

기존 Virtual System·Virtual Router 객체에서 IPv4·IPv6 라우트를 제거합니다(자동 감지).

remove route vd <Name of VS or VR Object> destination {<IP Address>[/<IP Prefix>] | default | default6} [{netmask <IP Netmask> | prefix <IP Prefix>}]

vsx_provisioning_tool -s localhost -u admin -p mypassword -o remove route vd VS1 destination default6

show vd — Virtual Device 정보 보기

기존 Virtual Device 객체의 정보를 보여 줍니다.

show vd name <Name of Virtual Device Object>

스크립트 예제

여러 명령을 하나의 스크립트로 묶으면 동일한 구성을 반복·대규모 배포할 때 큰 도움이 됩니다(줄 번호는 읽기 편하라고 붙인 것). 구체적 활용은 구성 예제 장에서 더 볼 수 있습니다.

예제 1 — Virtual System을 Virtual Router에 연결하고, VS에 기본 라우트(→VR)를, VR에 적절한 라우트(→VS)를 추가합니다.

transaction begin
add vd name VR1 vsx VSX1 type vr
add interface name eth3.100 ip 10.0.0.1/24
transaction end
transaction begin
add vd name VR2 vsx VSX2 type vr
add interface name eth3.200 ip 20.0.0.1/24
transaction end
transaction begin
add vd name VS1 vsx VSX1
add interface leads_to VR1 ip 192.168.1.1/32
add interface name eth4.20 ip 192.168.20.1/24 propagate true
add route destination default leads_to VR1
add route destination 192.168.40.0/25 next_hop 192.168.20.254
transaction end

예제 2 — Virtual System을 Virtual Switch에 연결하고 토폴로지를 수동 설정합니다.

transaction begin
add vd name VSW1 vsx VSX1 type vsw vs_mtu 1400
add interface name eth3.100
transaction end
transaction begin
add vd name VS1 vsx VSX1 calc_topo_auto false
add interface leads_to VSW1 ip 10.0.0.1/24 ip6 2001::1/64 topology external
add interface name eth4.20 ip 192.168.20.1/25 ip6 2020::1/64 topology internal_this_network
add route destination default next_hop 10.0.0.254
add route destination default6 next_hop 2001::254
transaction end

예제 3 — 위 VS에 CoreXL 인스턴스를 더하고, 토폴로지 자동 계산을 켜며, 내부 인터페이스 이름과 MTU를 바꿉니다.

transaction begin
set vd name VS1 instances 4 instances6 2 calc_topo_auto true
set interface name eth4.20 new_name eth4.21 mtu 1400
transaction end