UniFi - 데비안/우분투에서 APT로 인스톨 & 업데이트 하기

download at 2017-11-02T01:35:22Z origin

 Overview


이 문서는 데비안 / 우분투 시스템에서 APT를 사용하여 UniFi 컨트롤러를 업데이트 하는 방법에 대하여 서술합니다. 소스 파일을 생성해야 하거나, 기존의 sources.list.file을 수정해야 합니다. 가장 일번적인 패키지 업데이트, 인스톨 방식입니다. 리포지토리 구조는 항상 동일해야하며, 변경사항이 발생했다면, 더 이상 리포지토리를 포인팅 할 수 없어 사용할 수 없게됩니다.

Table of Contents


  1. UniFi 컨트롤러 APT 단계
  2. 트러블슈팅
  3. 사용자 노트 & 팁
  4. 관련 문서

UniFi 컨트롤러 APT 단계


맨위로 가기

1. /etc/apt/sources.list.d/100-ubnt.list 를 추가합니다 (또는 다음 /etc/apt/sources.list 파일을 수정합니다).stable, old stable, testing 소스 주소 모두 변경 가능합니다. 이는 해당 값이 언제든 변경될 수 있음을 의미합니다. 변경 내용은 Community 에 공지됩니다.

특정 릴리즈 브랜치를 지속적으로 사용하고 싶다면, 소스 라인에 code name 을 명시해야합니다.

현재 코드 네임을 동시에 unifi3/unifi4/unif5 로 사용중이지만, 곧 하나로 운용할 계획입니다. 다음은 소스 파일의 수정된 샘플입니다. 소스 해당 라인에 suite 이름, 또는 코드 네임을 입력해야 합니다. (본 문서에서는 suite 네임을 권장합니다.)

warning_25x25.png

Warning

아래의 명령어를 실행할 때 브라우저에서 http://www.ubnt.com/downloads/unifi/debian 로 접속하면 403 Forbidden 결과가 출력될 것입니다. 이는 링크로 직접 접근 허가를 허용하지 않기 때문입니다. URL은 CLI 혹은 명령어를 수행했을 때에만 사용합니다.

데비안/우분투에서 원하는 릴리즈 브랜치의 repository를 추가합니다.

deb http://www.ubnt.com/downloads/unifi/debian testing ubiquiti
deb http://www.ubnt.com/downloads/unifi/debian oldstable ubiquiti
deb http://www.ubnt.com/downloads/unifi/debian stable ubiquiti

아래의 테이블은 code name에 해당하는 suite name입니다:

Suite Name Code Name
oldstable unifi-5.4
stable unifi-5.5
testing unifi-5.6
cloudkey-oldstable uck-5.4
cloudkey-stable uck-5.5
cloudkey-testing uck-5.6

info_i_25x25.png

Note

"Testing" 은 다음 릴리즈입니다. 공식적으로는 릴리즈 되지 않은 버전을 의미합니다, "Stable"은 현재 최신 버전 릴리즈입니다. "Old Stable"은 최신 버전의 바로 이전 버전 릴리즈를 의미합니다. 가장 최신 릴리즈는 "Stable" 릴리즈입니다.

2. GPG 키를 추가합니다.

Ubiquiti/Debian 에서:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 06E85760C0A52C50

다음 패키지를 설치합니다:

apt-get install dirmngr

이어서 다음 명령어를 입력합니다:

apt-key adv --keyserver keyserver.ubuntu.com --recv 06E85760C0A52C50

HTTP로 다음을 사용합니다:

hkp://keyserver.ubuntu.com:80

3. Update 명령어를 수행하며 최신 릴리즈 정보를 가져옵니다.

Ubuntu:

sudo apt-get update

Debian:

apt-get update

4. UniFi 컨트롤러를 설치/업데이트 합니다.

Ubuntu:

sudo apt-get install unifi

Debian:

apt-get install unifi

5. (선택사항) 이 작업은 필요하지 않지만 리눅스 배포판에 따라서 필요할 수도 있습니다. 배포판에 MongoDB가 포함되어 있지 않다면, MongoDB 인스톨 가이드를 확인하십시오. 가장 최신 Ubuntu 설치 가이드는 이곳 에서 데비안은 이곳 에서 다운로드 받을 수 있습니다. 최소한 MongoDB 2.6.10 이상을 사용하는 것을 권장합니다. 일부 사용자는 백엔드를 MongoDB 3으로 사용합니다.


트러블 슈팅


맨위로 가기

다음 로그 파일을 확인하십시오:

/usr/lib/unifi/logs/server.log
/usr/lib/unifi/logs/mongod.log

사용자 노트 & 팁


맨위로 가기

  • DNS 서버에서 다음 에러를 확인한다면, 강제로 DNS 서버를 8.8.8.8로 사용하도록 변경하거나 ISP로 변경하도록 하여 문제를 해결합니다.
gpg: keyserver receive failed: Server indicated a failure
  • 재시작 이후 컨트롤러에 접근하는데 너무 오래걸리고, 충분한 엔트로피가 headless VM에서 SSL을 시작할 때 필요하다면, 이 문서가 도움이 될 수 있습니다. *Ubuntu 14.04 x64 Unifi 4.6.6 very slow start up*.
  • 이 문서를 작성하는 시점에서는 Ubiquiti가 arm64 아키텍처를 지원하지 않으므로, 가능한 리포지토리는 존재하지 않습니다. 다운로드와 수동 인스톨이 필요합니다. 5.5 버전대의 snappy-java 패키지에 포함되었으며, 이전 버전에서는 arm64를 지원하지 않습니다. 5.6.1 Unstable 버전에서는 snappy-java 패키지가 업데이트되었습니다. 다음 스크립트를 번들 버전으로 업데이트 하기 위해서 사용합니다:
rm /usr/lib/unifi/lib/snappy-java-1.0.5.jar
wget -O /usr/lib/unifi/lib http://central.maven.org/maven2/org/xerial/snappy/snappy-java/1.1.4-M3/snappy-java-1.1.4-M3.jar
  • 시스템이 계속 snappy-java 관련 이슈가 생긴다면, 새로운 jar 파일의 이름을 변경하거나 기존 jar 파일의 이름을 다른 이름으로 링크를 하여 UniFi 배포판 이름이 붙도록 변경합니다.
cd /usr/lib/unifi/lib
rm snappy-java-1.0.5.jar
wget http://central.maven.org/maven2/org/xerial/snappy/snappy-java/1.1.4-M3/snappy-java-1.1.4-M3.jar
ln -s snappy-java-1.1.4-M3.jar snappy-java-1.0.5.jar

info_i_25x25.png

Note

배포된 jar는 UniFi 버전 업데이트 일정에 따라서 변경되기 때문에, 위의 예제는 가이드로만 사용하길 바랍니다. 예를 들어, 5.5.20 버전이라면 배포 jar의 이름을 snappy-java-1.1.2.6.jar 로 변경합니다. 링킹 작업도 해당 일므에 맞춰서 변경해야합니다.


관련 문서


맨위로 가기

UniFi - 추천하는 최소 시스템 요구사항