[ICC] 설치하기 - Windows 11 WSL2 및 Linux

터미널에서 ICC 설치 스크립트(icc_run.sh)를 내려받아 sudo bash icc_run.sh -install로 설치하고, http://서버IP:웹포트로 접속하면 됩니다.

ipTIME 통합 관리 시스템 ICC(Integrated Control Center)는 수천 곳 이상에 설치된 ipTIME 공유기를 하나의 플랫폼에서 관리하는 통합 관리 시스템입니다. 공유기와 무선 AP, 연결된 단말까지 실시간으로 모니터링할 수 있고, 이벤트 알람, Traffic History, 펌웨어 일괄 업그레이드 등 대규모 네트워크 운영에 필요한 기능을 제공합니다.

ICC 서버는 ipTIME NAS400, NAS200 외에 베어메탈 환경의 Windows 11 WSL2와 Linux(x86_64, 64-bit)에도 설치할 수 있습니다.

※ ipTIME은 ICC 설치 스크립트만 제공하며, Linux·Windows WSL2·Docker 자체에 대한 기술 지원은 제공하지 않습니다.

STEP 1ICC 서버 설치

Windows 11 WSL2 또는 Linux Ubuntu 24.04.2 환경에서 아래 명령어로 설치합니다.

1. 콘솔 또는 터미널에 접속합니다.

2. cd ~를 입력해 홈 디렉터리로 이동합니다. ICC 서버에 직접 연결된 로컬 디스크(HDD/SSD)에만 설치할 수 있으며 NFS, iSCSI, 가상 디스크는 지원하지 않습니다.

3. sudo wget -q --no-check-certificate -O icc_run.sh https://download.iptime.co.kr/icc/icc_run.sh를 입력해 설치 스크립트를 내려받습니다.

4. 비밀번호 입력 창이 나오면 현재 로그인한 사용자의 비밀번호를 입력합니다.

5. sudo bash icc_run.sh -install을 입력해 설치를 시작합니다.

6. 설치 여부를 묻는 메시지에 y를 입력하고 Enter 키를 누릅니다. 필요한 패키지(whiptail, docker, ipTIME ICC)가 함께 설치됩니다.

7. ICC 인증용 접속 포트를 임의로 정합니다.

8. ICC 웹 접속 포트를 임의로 정합니다.

9. 설치가 끝나면 아래 메시지가 나옵니다. 웹 브라우저에서 서버 IP와 웹 포트로 접속해 ICC를 사용합니다.

10. 예를 들어 서버 IP가 192.168.0.135이고 웹 포트가 8800이면 http://192.168.0.135:8800으로 접속합니다.

※ ICC 사용 방법은 [ipTIME 통합 관리 시스템(ICC) 사용 가이드 – 공유기 등록]을 참고해 주세요.

STEP 2ICC 중단 / 다시 실행

중단

1. sudo pkill -9 -f "icc_watch.sh"를 입력하고 비밀번호를 입력합니다. (ICC 상태 감시 스크립트 종료)

2. sudo docker stop icc_docker를 입력해 ICC 서버 컨테이너를 중단합니다.

다시 실행

sudo bash icc_run.sh를 입력하면 중단된 ICC가 다시 실행됩니다. 처음 설치할 때 정한 웹 포트로 접속합니다. (http://서버IP주소:웹포트번호/)

STEP 3ICC 제거

1. sudo bash icc_run.sh -remove를 입력하면 실행 중인 ICC 서버와 관련 컨테이너를 중단하고 ICC를 제거합니다.

2. sudo bash icc_run.sh -removeforce를 입력하면 ICC DB와 설정 데이터까지 완전히 제거합니다.