[Rocky Linux] nmcli 명령어

Intro

Rocky 8 부터는 ifcfg 말고 nmcli 로 네트워크를 관리할 수 있도록 변경됐습니다.

또한, cisco cli 처럼 명령어 단축이 가능합니다. (connection -> con, modify -> mo)

cat /etc/sysconfig/network-scripts/readme-ifcfg-rh.txt 로 확인 가능

 

명령어

nmcli

  • 현재 네트워크 설정 정보 보기(ip a 와 비슷)

nmcli connection edit <NAME>

  • 대화형 연결 프로필 설정 (익숙해지면 편하고 좋습니다.)
    • print [ connection | ipv4 | bridge ] : 현재 설정 정보 보기
    • set <설정>.<속성> <값> : 지정한 속성에 값 넣기
    • remove <설정>.<속성> <값 | 공란> : 지정한 속성에 들어간 값 지우기 or 비우기
    • save : 현재까지 설정한 정보 저장
    • activate : 즉시 반영 (nmcli connection up 와 동일)

nmcli connection

  • 현재 설정된 연결 프로필 목록 보기

nmcli connection up <NAME>

  • 지정한 연결 프로필 활성화 및 설정 반영 (예: ipv4.routes 수정, DNS 수정 후 반영하려면 up 필수)

nmcli connection down <NAME>

  • 지정한 연결 프로필 비활성화

nmcli connection delete [ NAME | UUID ]

  • 연결 프로필 삭제하기. 연결 프로필 이름이나 UUID 값을 넣어서 지울 수 있다.

nmcli connection modify <NAME> <설정>.<속성>

  • 연결 프로필에 설정 값 넣기. 설정 앞에 + 와 - 를 넣어 추가하거나 설정 빼기 가능.
# 현재 ens160 에 192.168.219.103 IP 만 들어가 있는 상테에서
[root@localhost ~]# nmcli con show ens160 | grep ipv4.address
ipv4.addresses:                         192.168.219.103/24

# 그냥 modify 하면
[root@localhost ~]# nmcli con modi ens160 ipv4.address 192.168.219.103/24
[root@localhost ~]# nmcli con show ens160 | grep ipv4.address
ipv4.addresses:                         192.168.219.104/24 <-- 덮어씌어진다.

# + modifiy 하면
[root@localhost ~]# nmcli con modi ens160 +ipv4.address 192.168.219.104/24
[root@localhost ~]# nmcli con show ens160 | grep ipv4.address
ipv4.addresses:                         192.168.219.103/24, 192.168.219.104/24 <-- 추가가 된다.

# - modifiy 하면
[root@localhost ~]# nmcli con modi ens160 -ipv4.address 192.168.219.103/24
[root@localhost ~]# nmcli con show ens160 | grep ipv4.address
ipv4.addresses:                         --       <-- 빠진다.

 

nmcli connection modify <NAME> ipv4.addresses <IP/Prefix>

  • ipv4 IP 주소 넣기. 두개 이상 넣을러면 + 활용

nmcli connection modify <NAME> ipv4.gateway <Gateway IP>

  • ipv4 게이트웨이 주소 넣기

nmcli connection modify <NAME> ipv4.method < manual | auto | none >

  • 네트워크 작동 방식. 예전 BOOTPROTO 와 비슷.
  • manual : 수동 구성, auto : dhcp 모드, none : IP 구성 없음(단순 브릿지용으로 사용 가능)

nmcli connection modify <NAME> connection.id <별칭>

  • nmcli connection 시 보여지는 NAME 지정 입니다. 별칭 지정.
connection.interface-name 은 물리 인터페이스 이름 지정 입니다. id 와 햇갈리면 안됩니다.

 

nmcli connection modify <NAME> connection.autoconnect < yes | no >

  • OS 재시작 시 자동 활성화 여부. onboot 와 비슷

nmcli radio

  • wifi 상태 확인

nmcli radio wifi on

  • wifi 활성화

nmcli device wifi list

  • 주변 wifi 검색하기
[root@localhost ~]# nmcli device wifi list
IN-USE  BSSID              SSID              MODE    CHAN  RATE         SIGNAL  BARS  SECURITY
        00:00:00:00:00:00  --                인프라  40    1170 Mbit/s  97      ▂▄▆█  WPA2
        00:00:00:00:00:00  wifi              인프라  40    1170 Mbit/s  94      ▂▄▆█  WPA2
        00:00:00:00:00:00  wifi2             인프라  36    1170 Mbit/s  92      ▂▄▆█  WPA2

 

nmcli device wifi connect <와이파이이름> password <비밀번호>

  • wifi 연결하기

 

플레이북

라우팅 구성하기

여러 네트워크 인터페이스를 사용 하거나 기존 서버 마이그레이션 시 라우팅 구성 설정이 필요할 수 있다.

메모장에 먼저 라우팅 설정 명령어를 짠 후 일괄적으로 적용 하는 방법이 가장 괜찮았습니다.

 

nmcli connection modify <NAME> +ipv4.routes "<Network IP>/<Prefix> <Gateway ip> <priority>"

  • 해당 연결 프로필에 ipv4 라우팅 설정을 추가하는 설정. 마찬가지로 공란은 덮어 씌우기, +는 설정 추가, -는 설정 빼기 입니다.
  • 예제(추가하기) : nmcli con modify eno4 +ipv4.routes "192.168.0.0/24 192.168.0.1 90"

nmcli connection up <NAME>

  • 모든 라우팅 설정을 완료했다면 반영을 위해 꼭 up 을 해야 설정이 정상 반영됩니다.

 

브릿지 구성하기

(주의) 원격 연결한 네트워크 인터페이스에 대해 브릿지로 변환하는 중 설정이 잘못되면 연결이 끊길 수 있음.

 

bridge 프로필 생성

nmcli connection add type bridge con-name br0 ifname br0

 

bridge 프로필에 ipv4 설정 넣기

nmcli connection modify br0 ipv4.addresses 10.0.0.1/24
nmcli connection modify br0 ipv4.gateway 10.0.0.254
nmcli connection modify br0 ipv4.dns 1.1.1.1
nmcli connection modify br0 ipv4.method manual

 

bridge 프로필에 연결할 네트워크 인터페이스 지정

nmcli connection add type bridge-slave con-name br0-ens15f0 ifname ens15f0 master br0


bridge 올리기 (주의 : 네트워크 끊김 발생)

# bridge 먼저 올리기
nmcli connection up br0

# bridge 에 연결된 연결 프로필 올리기 (기존 연결 프로필은 자동 비활성화)
nmcli connection up br0-ens15f0

 

기존 연결 프로필 비활성화

  • 각 연결 프로필의 connection.autoconnect-priority (값이 클수록 높음) 으로 인해 기존 연결 프로필이 올라오지 않아
    브릿지와 서로 겹칠 가능성은 없지만, 기존 연결 프로필이 자동으로 올라오지 않게 설정하는 것을 추천 드립니다.
nmcli connection modify ens1s0 connection.autoconnect no

 

브릿지 구성하기(한번에)

set_bridgeName="br0"
interfaceName="enp1s0"
oldInterfaceProfieName="enp1s0"
set_ip="10.0.0.1/24"
set_gw="10.0.0.254"
set_dns="1.1.1.1"

# create bridge profile
nmcli connection add type bridge \
	con-name ${set_bridgeName} \
	ifname ${set_bridgeName} \
	ipv4.addresses ${set_ip} \
	ipv4.gateway ${set_gw} \
	ipv4.dns ${set_dns} \
	ipv4.method manual

# create bridge slave profile
nmcli connection add type bridge-slave \
	con-name ${set_bridgeName}-${interfaceName} \
	ifname ${interfaceName} \
	master ${set_bridgeName}

# bridge profile enable
nmcli connection up ${set_bridgeName}
nmcli connection up ${set_bridgeName}-${interfaceName}

# disable old connection profile autoconnect disable
nmcli connection modify ${oldInterfaceProfieName} connection.autoconnect no

 

bond 이중화 구축

2개 이상의 포트를 묶을 때 사용하며 옵션은 다음과 같습니다.

옵션 기본값 내용
mode - active-backup
primary - 메인 인터페이스 지정
(DEVICE 이름으로 넣어야 함)
num_grat_arp 1 장애 발생 시 Gratuitous ARP 전송 횟수
primary_reselect 0 0 : 즉각 복구
1 : 속도나 듀플렉스 보고 복구
2 : 수동 복구. 인터페이스가 복구돼도 Currently Active Slave 가 바뀌진 않음.

 

2개 포트 active-standby 만들기

# 아래 설정 값 수정해서 사용
# bond0
BOND_NAME"bond0"
BOND_IP="192.168.0.1/24"
BOND_GW="192.168.0.254"
BOND_PINT="eth0"
BOND_SINT="eth1"
# P = primary, S = Secondary

nmcli con add type bond con-name ${BOND_NAME} ifname ${BOND_NAME} bond.options "mode=active-backup,miimon=100"

nmcli con mo ${BOND_NAME} connection.autoconnect yes
nmcli con mo ${BOND_NAME} ipv4.address ${BOND_IP}
nmcli con mo ${BOND_NAME} ipv4.gateway ${BOND_GW}
nmcli con mo ${BOND_NAME} ipv4.method manual

nmcli con add type ethernet slave-type bond con-name ${BOND_NAME}-active ifname ${BOND_PINT} master ${BOND_NAME}
nmcli con add type ethernet slave-type bond con-name ${BOND_NAME}-backup ifname ${BOND_SINT} master ${BOND_NAME}

nmcli con up ${BOND_NAME}-active
nmcli con up ${BOND_NAME}-backup
nmcli con up ${BOND_NAME}

 

bond 구성 active-backup 방식

bond0 인터페이스 생성하기

nmcli connection add type bond con-name bond0 ifname bond0 bond.options "mode=active-backup,miimon=100"

 

eth0, eth1 를 bond0-active, bond0-backup 이름으로 bond0 에 추가하기

nmcli connection add type ethernet slave-type bond con-name bond0-active ifname eth0 master bond0
nmcli connection add type ethernet slave-type bond con-name bond0-backup ifname eth1 master bond0

 

bond0 에 대해 IP 설정 진행

nmcli connection modify bond0 connection.autoconnect yes
nmcli connection modify ipv4.address 192.168.0.11/24
nmcli connection modify ipv4.gateway 192.168.0.1
nmcli connection modify ipv4.method manual

 

설정 반영하기

nmcli connection up bond0-active
nmcli connection up bond0-backup
nmcli connection up bond0

 

eth0 이름으로 된 컨넥션은 비활성화되고 bond0-active 로 올라온다. (eth0 device 가 쓰는 컨넥션이 eth0 -> bond0-active 로 바뀜)
bond0-active 컨넥션이 지워진다면 비활성화 된 eth0 컨넥션이 다시 올라온다. (/etc/NetworkManager/system-connections 확인)

 

messages 로그

test01 kernel: bond0: (slave enp1s0): link status definitely up, 0 Mbps full duplex
test01 kernel: bond0: (slave enp1s0): making interface the new active one
test01 kernel: bond0: (slave enp7s0): link status definitely down, disabling slave

 

트러블슈팅

(Rocky8) nmcli connection up 시 No suitable device found for this connection

에러내용

'eth1'(UUID) 연결 활성화 실패: No suitable device found for this connection (device eth0 not available because profile is not compatible with device (mismatching interface name)).

 

원인 및 해결

eth1 에 물리적인 연결이 없을 경우 eth1 connection up 이 되지 않습니다.

물리적인 연결 후 재시도