이 문서에서
dropdown icon
프로비저닝 매개변수 유형들
    범용 파라미터
    파라미터 활성화
    트리거
    구성 가능한 스케줄
    프로필 규칙
    업그레이드 규칙
dropdown icon
프로비저닝 파라미터
    구성 프로파일 파라미터
    펌웨어 업그레이드 매개변수들
    범용 파라미터
    매크로 확장 변수
    내부 오류 코드

9800 시리즈, 8875 폰 프로비저닝 파라미터 (브로드웍스)

list-menu이 문서에서
list-menu피드백이 있습니까?

이 도움말 문서는 시스코 브로드웍스에 등록된 시스코 데스크 폰 9800 시리즈와 시스코 비디오 폰 8875에 관한 거예요.이 페이지의 정보에는 공급 매개변수와 해당 구문이 포함돼요.

프로비저닝 매개변수 유형들

이 섹션에서는 기능별로 광범위하게 구성된 프로비저닝 파라미터에 대해 설명해요.

범용 파라미터

범용 매개변수 GPP_* (관리자 로그인 > 고급 > 음성 > 프로비저닝) 는 전화기가 특정 프로비저닝 서버 솔루션과 상호 작용하도록 구성할 때 사용 가능한 문자열 레지스터로 사용돼요. GPP_* 매개변수는 기본적으로 비어 있어요. 다음을 포함하여 다양한 값을 포함하도록 구성할 수 있어요.

  • 암호화 키

  • URL들

  • 다단계 프로비저닝 상태 정보.

  • 게시 요청 템플릿

  • 파라미터 이름 앨리어스 맵

  • 부분 문자열 값, 결국 완전한 매개변수 값으로 합쳐져요.

GPP_* 매개변수는 다른 공급 매개변수 내에서 매크로 확장에 사용할 수 있어요. 이런 목적으로는 한 글자 대문자 매크로 이름 (A~P) 이면 GPP_A~GPP_P의 내용을 식별할 수 있어요. 또한 두 글자 대문자 매크로 이름 SA~SD는 다음 URL 옵션의 인수로 사용될 때 GPP_SA와 GPP_SD를 특수한 경우로 식별해요.

키, 아이디, 패드

이 매개변수들을 프로비저닝하고 업그레이드 규칙의 변수로 사용할 수 있어요. 변수 이름 앞에 $GPP_A와 같은 '$' 문자를 붙여서 참조해요.

파라미터 활성화

프로비전_활성화 및 업그레이드_활성화 매개변수가 모든 프로필 재동기화 및 펌웨어 업그레이드 작업을 제어해요. 이 매개변수들은 서로 독립적으로 재동기화와 업그레이드를 제어해요. 이 매개변수들은 관리 웹 서버를 통해 실행되는 재동기화 및 업그레이드 URL 명령도 제어해요. 이 두 매개변수 모두 기본적으로 Yes로 설정되어 있어요.

Resync_From_SIP 매개변수가 재동기화 작업 요청을 제어해요. 서비스 제공자 프록시 서버에서 전화로 SIP NOTIFY 이벤트가 전송돼요. 활성화되면 프록시에서 재동기화 요청할 수 있어요. 그러려면 프록시가 Event: resync 헤더가 포함된 SIP NOTIFY 메시지를 장치로 보내요.

장치가 401 응답으로 요청에 이의를 제기해요 (사용된 자격 증명에 대한 승인 거부). 기기가 프록시의 재동기화 요청을 처리하기 전에 인증된 후속 요청을 기대해요. 이벤트: reboot_now와 이벤트: restart_now 헤더는 각각 콜드 재시작과 웜 재시작을 수행하는데, 이것도 문제가 있어요.

나머지 두 개는 재동기_온_리셋하고 재동기_애프터_업그레이드_시도예요. 이 매개변수들은 전원이 켜진 소프트웨어 재부팅 후와 업그레이드를 시도할 때마다 장치가 재동기화 작업을 수행할지 여부를 결정합니다.

Resync_On_Reset이 활성화되면, 기기에서 무작위 지연이 발생하고 부팅 순서를 따라 재설정이 수행되죠. 지연은 Resync_Random_Delay가 지정하는 값 (초) 까지 임의의 시간이에요. 전원이 동시에 켜지는 전화기 풀에서 이 지연으로 인해 각 장치의 재동기화 요청 시작 시간이 분산돼요. 이 기능은 지역 정전 시 대규모 주거 시설 설치에 유용할 수 있어요.

트리거

전화기로 특정 간격 또는 특정 시간에 재동기화할 수 있어요.

특정 간격으로 재동기화돼요

전화는 프로비저닝 서버와 주기적으로 재동기화되도록 설계돼요. 재동기화 간격은 Resync_Periodic (초) 로 구성되어 있어요. 이 값을 비워 두면 장치가 주기적으로 재동기화되지 않아요.

재동기화는 보통 음성 회선이 유휴 상태일 때 일어나요. 재동기화 기한에 음성 회선이 활성화되면 전화기는 회선이 다시 유휴 상태가 될 때까지 재동기화 절차를 연기해요. 재동기화를 하면 구성 매개변수 값이 바뀔 수 있어요.

휴대폰이 서버에서 프로필을 검색하지 못하거나, 다운로드한 파일이 손상되었거나, 내부 오류가 발생해서 재동기화 작업이 실패할 수 있어요. 재동기화_오류_재시도_지연에 지정된 시간 (초) 후에 기기가 다시 재동기화를 시도해요. Resync_Error_Retry_Delay가 0으로 설정된 경우, 재동기화 실패 후 장치가 다시 재동기화를 시도하지 않아요.

업그레이드가 실패하면 Upgrade_Error_재시도_지연초 후에 재시도가 수행돼요.

재동기화를 조건부로 트리거하는 데 구성 가능한 매개변수 두 개를 사용할 수 있어요: 재동기_트리거_1과 재동기_트리거_2. 매크로 확장을 거치는 조건식으로 각 매개변수를 프로그래밍할 수 있어요. 재동기화 간격이 만료되면 (다음 재동기화 시간) 트리거는 설정된 경우 하나 이상의 트리거가 true로 평가되지 않는 한 재동기화를 방지해요.

다음 예제 조건은 재동기화를 트리거해요. 이 예에서는 마지막 전화 업그레이드 시도가 5분 (300초) 이상 경과했고 마지막 재동기화 시도 이후 최소 10분 (600초) 경과했어요.

$UPGTMR gt 300 and $PRVTMR ge 600

특정 시간에 재동기화 해요

Resync_At 파라미터를 사용하면 전화가 특정 시간에 재동기화될 수 있어요. 이 매개변수는 시간을 지정하는 데 24시간 형식 (hhmm) 을 사용해요.

Resync_At_Random_Delay 파라미터를 사용하면 전화가 지정된 시간 제한 없이 재동기화될 수 있어요. 이 매개변수는 양의 정수 형식을 사용하여 시간을 지정해요.

동시에 재동기화되도록 설정된 여러 대의 전화기에서 재동기화 요청으로 서버가 넘쳐나는 건 피해야 돼요. 그러려면 전화가 지정된 시간 후에 최대 10분 후에 재동기화를 트리거해요.

예를 들어 재동기화 시간을 1000 (오전 10시) 으로 설정하면 전화기가 오전 10시에서 오전 10시 10분 사이 언제든지 재동기화 트리거돼요.

기본적으로 이 기능은 비활성화돼요. Resync_At 파라미터가 제공되면, Resync_Periodic 파라미터는 무시돼요.

구성 가능한 스케줄

주기적인 재동기화 일정을 구성할 수 있고, 다음 공급 매개변수를 사용하여 재동기화 및 업그레이드 실패의 재시도 간격을 지정할 수 있어요.

  • 재동기화_주기적

  • 재동기화_오류_재시도_지연

  • 업그레이드_오류_재시도_지연

각 매개변수는 단일 지연 값 (초) 을 받아들여요. 새 확장 구문으로 연속 지연 요소를 쉼표로 구분한 목록을 사용할 수 있어요. 시퀀스의 마지막 요소는 암시적으로 영원히 반복돼요.

선택적으로 더하기 기호를 사용하여 임의의 추가 지연을 추가하는 다른 숫자 값을 지정할 수 있어요.

예제 1

이 예시에서는 전화가 2시간마다 주기적으로 재동기화돼요. 재동기화 실패가 발생하면 장치가 30분, 1시간, 2시간, 4시간 간격으로 재시도해요. 장치가 성공적으로 재동기화될 때까지 4시간 간격으로 계속 시도해요.


Resync_Periodic=7200
Resync_Error_Retry_Delay=1800,3600,7200,14400

예제 2

이 예시에서는 기기가 1시간마다 주기적으로 재동기화돼요 (추가로 최대 10분까지 랜덤 지연). 재동기화 실패 시 장치는 30분 (최대 5분) 간격으로 재시도해요. 1시간 (플러스 최대 10분), 2시간 (플러스 최대 15분). 성공적으로 재동기화될 때까지 장치가 2시간 간격 (최대 15분) 으로 계속 시도해요.


Resync_Periodic=3600+600
Resync_Error_Retry_Delay=1800+300,3600+600,7200+900

예제 3

이 예시에서 원격 업그레이드 시도가 실패하면 장치가 30분 후에 업그레이드를 재시도하고 한 시간 후, 그리고 두 시간 후에 다시 업그레이드를 시도해요. 그래도 업그레이드가 실패하면 장치는 업그레이드가 성공할 때까지 4~5시간마다 재시도해요.


Upgrade_Error_Retry_Delay  =  1800,3600,7200,14400+3600

프로필 규칙

전화기가 여러 원격 구성 프로파일 파라미터 (Profile_Rule*) 를 제공해요. 따라서 재동기화 작업을 할 때마다 다른 서버가 관리하는 여러 파일을 검색할 수 있어요.

가장 간단한 시나리오로는 장치가 중앙 서버의 단일 프로필에 주기적으로 재동기화되어 관련 내부 매개변수가 모두 업데이트돼요. 다른 방법으로는 프로필을 여러 파일로 나눌 수 있어요. 한 파일은 배포에 있는 모든 전화기에 공통이에요. 계정마다 별도의 고유 파일이 제공돼요. 암호화 키와 인증서 정보는 별도의 서버에 저장된 또 다른 프로필에서 제공할 수 있어요.

재동기화 작업이 마감될 때마다 전화기는 네 개의 Profile_Rule* 매개변수를 순서대로 평가해요.

  1. 프로필_규칙

  2. 프로필_룰_B

  3. 프로필_룰_C

  4. 프로필_룰_D

평가할 때마다 원격 프로비저닝 서버에서 프로필을 검색하고 내부 매개 변수를 몇 개 업데이트할 수 있어요. 평가가 실패하면 재동기화 시퀀스가 중단되고 Resync_Error_Retry_Delay 매개변수로 지정된 처음부터 다시 시도돼요 (초). 모든 평가가 성공하면 기기는 Resync_Periodic 매개변수로 지정된 1초까지 기다렸다가 다시 재동기화를 해요.

각 Profile_Rule* 매개변수의 내용은 대체 매개변수로 구성되어 있어요. 얼터너티브는 | (파이프) 문자로 구분돼요. 각 대안은 조건부 표현식, 할당 표현식, 프로필 URL, 모든 관련 URL 옵션으로 구성되어 있어요. 이 모든 구성 요소는 각 대안 내에서 선택 사항이에요. 다음은 유효한 조합과 존재할 경우 나타나는 순서예요.


[ conditional-expr ] [ assignment-expr ] [[ options ] URL ]

각 Profile_Rule* 파라미터 내에서 마지막 파라미터를 제외한 모든 대안은 조건식을 제공해야 해요. 이 표현식은 다음과 같이 평가되고 처리돼요.

  1. 조건은 왼쪽에서 오른쪽으로, 참으로 평가되는 조건을 찾을 때까지 (또는 조건부 표현식이 없는 대안 하나를 찾을 때까지) 평가돼요.

  2. 첨부된 과제 표현식이 있으면 평가돼요.

  3. 대체 URL의 일부로 URL이 지정된 경우, 지정된 URL에 있는 프로필을 다운로드하려고 시도하는 거예요. 시스템이 그에 따라 내부 매개변수를 업데이트하려고 시도해요.

모든 대안에 조건식이 있고 참으로 평가되는 것이 없는 경우 (또는 전체 프로필 규칙이 비어 있는 경우), Profile_Rule* 매개변수 전체를 건너뛰게 돼요. 시퀀스의 다음 프로필 규칙 파라미터가 평가돼요.

예제 1

이 예제는 지정된 URL의 프로필에 무조건 재동기화하고 원격 프로비저닝 서버에 HTTP GET 요청을 수행해요.


http://remote.server.com/cisco/$MA.cfg

예제 2

이 예시에서는 1행의 등록 상태에 따라 기기가 서로 다른 두 URL로 재동기화돼요. 등록을 분실하면 장치가 CGI 스크립트에 HTTP POST를 실행해요. 기기가 매크로 확장 GPP_A의 내용을 보내는데, 이는 기기 상태에 대한 추가 정보를 제공할 수도 있어요.


($PRVTMR ge 600)? http://p.tel.com/has-reg.cfg
| [--post a] http://p.tel.com/lost-reg?

예제 3

이 예시에서는 기기가 같은 서버에 재동기화돼요. 장치에 인증서가 설치되지 않은 경우 장치가 추가 정보를 제공해요 (레거시 2.0 이전 장치의 경우).


(“$CCERT” eq “Installed”)? https://p.tel.com/config?
| https://p.tel.com/config?cisco$MAU

예제 4

이 예시에서는 GPP_A가 첫 번째 URL을 통해 프로비전됨으로 설정되기 전까지는 1행이 비활성화돼요. 그 후 두 번째 URL로 재동기화돼요.


(“$A” ne “Provisioned”)? (Line_Enable_1_ = “No”;)! https://p.tel.com/init-prov
| https://p.tel.com/configs

예제 5

이 예시에서는 서버가 반환하는 프로필에 XML 요소 태그가 포함된 것으로 가정해요. GPP_B에 저장된 앨리어스 맵을 통해 이러한 태그를 적절한 매개변수 이름으로 다시 매핑해야 해요.


[--alias b] https://p.tel.com/account/$PN$MA.xml

요청된 프로필을 서버에서 받지 못하면 재동기화는 보통 실패한 것으로 간주돼요. resync_fails_on_FNF 매개변수가 이 기본 동작을 무시할 수 있어요. resync_fails_on_FNF가 아니요로 설정된 경우, 장치는 서버로부터 파일을 찾을 수 없다는 응답을 성공적인 재동기화로 받아들여요. resync_fails_on_FNF의 기본값은 예예요.

업그레이드 규칙

업그레이드 규칙은 장치에 새 부하로 활성화하고 필요한 경우 어디서 부하를 받을지 지시하는 거예요. 기기에 이미 부하가 걸리면 로드를 시도하지 않아요. 따라서 원하는 로드가 비활성 파티션에 있을 때는 로드 위치의 유효성이 중요하지 않아요.

Upgrade_Rule은 펌웨어 로드를 지정합니다. 현재 로드와 다를 경우 조건부 표현식으로 제한하거나 Upgrade_Enable이 No로 설정된 경우를 제외하고 다운로드되어 적용돼요.

전화기는 구성 가능한 원격 업그레이드 파라미터인 Upgrade_Rule을 제공해요. 이 매개변수는 프로필 규칙 매개변수와 비슷한 구문을 수용해요. URL 옵션은 업그레이드시 지원되지 않지만 조건부 표현식과 할당 표현식은 사용할 수 있어요. 조건부 표현식을 사용하면 파라미터에 | 문자로 구분하여 여러 대체 표현식을 채울 수 있어요. 각 대안의 구문은 다음과 같아요.


[ conditional-expr ] [ assignment-expr ] URL

Profile_Rule* 매개변수의 경우처럼, Upgrade_Rule 매개변수는 조건부 표현식이 충족되거나 대안에 조건부 표현식이 없을 때까지 각 대안을 평가해요. 첨부된 과제 표현식이 지정되면 평가돼요. 그런 다음 지정된 URL로 업그레이드가 시도돼요.

Upgrade_Rule에 조건식 없는 URL이 있으면 장치가 URL에 지정된 펌웨어 이미지로 업그레이드돼요. 매크로 확장 및 규칙 평가 후, 규칙이 수정되거나 구성표+서버+포트+ 파일 경로의 효과적인 조합이 변경될 때까지 장치는 업그레이드를 다시 시도하지 않아요.

펌웨어 업그레이드를 시도하려면, 장치가 절차 시작 시 오디오를 비활성화하고 절차 종료시 재부팅해요. 장치는 모든 음성 회선이 현재 비활성 상태인 경우에만 Upgrade_Rule의 내용에 의해 구동되는 업그레이드를 자동으로 시작해요.

예를 들자면,


https://10.73.10.223/firmware/PHONEOS-8875.1-0-1-0001-1.loads

이 예시에서 Upgrade_Rule은 펌웨어를 표시된 URL에 저장된 이미지로 업그레이드해요.

여기 또 다른 예가 있어요:


(“$F” ne “beta-customer”)? http://p.tel.com/firmware/PHONEOS-8875.1-0-1-0001-1.loads
| http://p.tel.com/firmware/PHONEOS-8875.1-0-1-0001-1.loads

이 예제는 범용 파라미터 GPP_F의 내용을 기반으로 두 이미지 중 하나를 로드하도록 장치에 지시해요.

프로비저닝 파라미터

프로비전 파라미터는 전화 웹 페이지의 프로비전 탭에서 찾을 수 있어요.

구성 프로파일 파라미터

다음 표는 프로비전 탭 아래 구성 프로파일 매개변수 섹션에 있는 각 매개변수의 기능과 용도를 정의해요.

테이블 1이에요.구성 프로파일 파라미터

파라미터 이름

설명과 기본값

프로비전 활성화

펌웨어 업그레이드 작업과는 별개로 모든 재동기화 작업을 제어해요. 원격 프로비저닝을 활성화하려면 Yes로 설정했어요.

기본값은 Yes예요.

초기화 시 재동기화돼요

파라미터 업데이트와 펌웨어 업그레이드로 인한 재부팅을 제외하고 재부팅할 때마다 재동기화를 트리거해요.

기본값은 Yes예요.

랜덤 리싱크 딜레이

부팅 순서에 따라 초기화 하기 전 임의 지연, 초 단위로 지정돼요. 동시에 전원이 켜지도록 예약된 IP 텔레포니 장치 풀에서 이로 인해 각 장치가 프로비저닝 서버에 재동기화 요청을 보내는 시간이 분산돼요. 이 기능은 지역 정전 시 대규모 주거 시설 설치에 유용할 수 있어요.

이 필드 값은 0에서 65535 사이의 정수여야 해요.

기본값은 2예요.

재동기화해요 (흠)

장치가 프로비저닝 서버와 재동기화되는 시간 (흠) 이에요.

시간을 HHmm 형식으로 나타내려면 이 필드의 값은 0000에서 2400 사이의 4자리 숫자여야 해요. 예를 들어, 0959는 09:59 를 가리킵니다.

기본값은 비어 있어요. 값이 유효하지 않으면 매개변수가 무시돼요. 이 매개변수가 유효한 값으로 설정되면 주기적 재동기화 매개변수는 무시돼요.

랜덤 지연 시 재동기화돼요

많은 장치가 동시에 켜질 때 프로비저닝 서버의 과부하를 방지해요.

여러 대의 전화기에서 서버로 재동기화 요청이 쇄도하지 않도록 전화가 시간과 분, 시간과 분에 임의 지연 (흠, hhmm+random_delay) 사이의 범위에서 재동기화돼요. 예를 들어 임의 지연이 (임의 지연 시 재동기화 + 30) /60분이면, 초 단위의 입력값이 분으로 변환되어 다음 분으로 반올림하여 최종 random_delay 간격을 계산해요.

유효한 값의 범위는 600에서 65535 사이예요.

값이 600보다 작으면 내부 랜덤 지연은 0에서 600 사이예요.

기본값은 600초 (10분) 예요.

재동기화 주기적

프로비저닝 서버와 주기적으로 재동기화되기까지 걸리는 시간 간격이에요. 관련 재동기화 타이머는 서버와 처음으로 동기화에 성공한 후에만 활성화돼요.

유효한 형식은 다음과 같아요.

  • 정수예요

    예: 입력이 3000이면 다음 재동기화가 3000초 후에 일어난다는 뜻이에요.

  • 정수가 여러 개예요

    예: 입력된 600,1200,300은 첫 번째 재동기화는 600초 후, 두 번째 재동기화는 첫 번째 재동기화 후 1200초 후, 세 번째 재동기화는 두 번째 재동기화 후 300초 후에 일어난다는 뜻이에요.

  • 시간 범위

    예를 들어, 입력이 2400+30이면 재동기화 성공 후 다음 재동기화가 2400초에서 2430초 사이에 일어난다는 뜻이에요.

주기적인 재동기화를 비활성화하려면 이 매개변수를 0으로 설정하세요.

기본값은 3600초예요.

재동기화 오류 재시도 지연

IP 텔레포니 장치가 서버에서 프로필을 검색하지 못했거나, 다운로드한 파일이 손상되었거나, 내부 오류가 발생해서 재동기화 작업이 실패하면, 장치는 지정된 시간 (초) 후에 재동기화를 다시 시도해요.

유효한 형식은 다음과 같아요.

  • 정수예요

    예: 입력값이 300이면 다음 재동기화 재시도가 300초 후에 일어난다는 뜻이에요.

  • 정수가 여러 개예요

    예: 입력이 600,1200,300이면 첫 번째 재시도는 실패 후 600초 후에 발생하고, 두 번째 재시도는 첫 번째 재시도 실패 후 1200초 후에 발생하고, 세 번째 재시도는 두 번째 재시도 실패 후 300초 후에 일어난다는 뜻이에요.

  • 시간 범위

    예를 들어, 입력이 2400+30이면 재동기화 실패 후 2400초에서 2430초 사이에 다음 재시도가 일어난다는 뜻이에요.

지연이 0으로 설정된 경우, 재동기화 실패 후 장치가 다시 재동기화를 시도하지 않아요.

강제 재동기화 지연이에요

재동기화 하기 전에 전화가 대기하는 최대 지연 시간 (초) 이에요.

전화선 중 하나가 활성화되어 있는 동안에는 기기가 재동기화되지 않아요. 재동기화에는 몇 초가 걸릴 수 있기 때문에 기기가 오랫동안 유휴 상태가 될 때까지 기다렸다가 재동기화하는 게 좋겠어요. 이렇게 하면 사용자가 중단 없이 연속으로 전화를 걸 수 있어요.

기기에 모든 라인이 유휴 상태가 되면 카운트다운을 시작하는 타이머가 있어요. 이 매개변수는 카운터의 초기값이에요. 재동기화 이벤트는 이 카운터 감소가 0으로 줄어들 때까지 지연돼요.

유효한 값의 범위는 0에서 65535 사이예요.

기본값은 14,400초예요.

SIP에서 재동기화해요

SIP NOTIFY 메시지를 통해 재동기화 트리거할 수 있게 해요.

기본값은 Yes예요.

업그레이드 시도 후 재동기화해요

업그레이드 후 재동기화 작업을 활성화 또는 비활성화해요. 예 선택하면 동기화가 시작돼요.

기본값은 Yes예요.

리싱크 트리거 1, 리싱크 트리거 2

재동기화 트리거 조건 설정 가능해요. 이 매개변수의 논리 방정식이 TRUE로 평가되면 재동기화가 트리거돼요.

기본값은 (비어 있음) 이에요.

FNF에서 재동기화 실패해요

요청된 프로필을 서버에서 받지 못하면 재동기화는 실패한 것으로 간주돼요. 이 매개변수로 이걸 무시할 수 있어요. 아니오로 설정하면 장치가 서버로부터 파일을 찾을 수 없다는 응답을 성공적인 재동기화로 받아들여요.

기본값은 Yes예요.

프로필 규칙

프로필 규칙 B


프로필 규칙 C


프로필 규칙 D

각 프로필 규칙은 프로필 (구성 파일) 을 얻을 소스를 전화기에 알려줘요. 매번 재동기화 작업 중에 전화가 모든 프로필을 순서대로 적용해요.

기본값: /$PSN.xml

구성 파일에 AES-256-CBC 암호화를 적용하는 경우 다음과 같이 --key 키워드로 암호화 키를 지정하세요.

[--키] <encryption key>

선택적으로 암호화 키를 큰따옴표 (“) 로 묶을 수 있어요.

사용할 DHCP 옵션이에요

펌웨어하고 프로필을 검색하는 데 사용되는 DHCP 옵션, 쉼표로 구분돼요.

기본값은 66,160,159,150,60,43,125예요.

로그 요청 메시지

이 매개변수에는 재동기화 시도 시작 시 syslog 서버로 보내는 메시지가 들어 있어요.

기본값은 $PN $MAC —요청% $SCHEME: //$SERVIP: $PORT$PATH예요.

로그 성공 메시지

재동기화 시도가 성공적으로 완료될 때 발행되는 syslog 메시지예요.

기본값은 $PN $MAC —재동기화 성공% $SCHEME: //$SERVIP: $PORT$PATH -- $ERR.

로그 실패 메시지

재동기화 실패 후 발행된 syslog 메시지예요.

기본값은 $PN $MAC이에요. 재동기화 실패: $ERR.

사용자 구성 가능 재동기화

사용자가 IP 전화 화면에서 전화를 재동기화할 수 있게 해줘.

기본값은 Yes예요.

펌웨어 업그레이드 매개변수들

다음 표는 프로비저닝 탭의 펌웨어 업그레이드 섹션에 있는 각 매개변수의 기능과 사용을 정의해요.

테이블 2예요.펌웨어 업그레이드 파라미터

파라미터 이름

설명과 기본값

업그레이드 활성화

재동기화 작업과는 독립적으로 펌웨어 업그레이드 작업을 가능하게 해요.

기본값은 Yes예요.

다음 방법 중 하나로 이 매개변수를 구성하세요.

  • XML (cfg.xml) 을 사용하여 전화 구성 파일에 문자열을 다음 형식으로 입력하세요. <Upgrade_Enable ua="na">예</Upgrade_Enable>

  • 전화 관리 웹 페이지에서 이 필드를 예 또는 아니오로 설정하세요.

업그레이드 오류 재시도 지연

업그레이드 실패 시 적용되는 업그레이드 재시도 간격 (초) 이에요. 장치에 펌웨어 업그레이드 실패 후 활성화되는 펌웨어 업그레이드 오류 타이머가 있어요. 타이머는 이 매개변수의 값으로 초기화돼요. 이 타이머가 0으로 카운트다운되면 다음 펌웨어 업그레이드가 시도돼요.

기본값은 3600초예요.

다음 방법 중 하나로 이 매개변수를 구성하세요.

  • XML (cfg.xml) 을 사용하여 전화 구성 파일에 문자열을 다음 형식으로 입력하세요: <Upgrade_Error_Retry_Delay ua="na">3600</Upgrade_Error_Retry_Delay>

  • 전화 관리 웹 페이지에서 값을 설정하세요.

업그레이드 규칙

업그레이드 조건과 관련 펌웨어 URL을 정의하는 펌웨어 업그레이드 스크립트예요. 프로필 규칙하고 같은 구문을 사용해요.

업그레이드 규칙을 입력하려면 다음 형식을 사용하세요.

<tftp|http|https>://<ip address><:port>/<path>/<load name>

예를 들자면:

tftp://192.168.1.5/firmware/PHONEOS-8875.1-0-1-0001-1.loads
http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads

프로토콜이 지정되지 않으면 TFTP로 간주돼요. 서버 이름이 지정되지 않은 경우 URL을 요청하는 호스트가 서버 이름으로 사용돼요. 포트를 지정하지 않으면 기본 포트가 사용돼요 (TFTP의 경우 69, HTTP의 경우 80, HTTPS의 경우 443).

기본값은 공백이에요.

다음 방법 중 하나로 이 매개변수를 구성하세요.

  • XML (cfg.xml) 을 사용하여 전화 구성 파일에 다음 형식으로 문자열을 <Upgrade_Rule ua="na">입력하세요. http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • 전화 관리 웹 페이지에서 로드 파일이 저장되는 경로를 입력하세요.

로그 업그레이드 요청 메시지

펌웨어 업그레이드 시도 시작 시 Syslog 메시지가 나왔어요.

기본값: $PN $MAC -- 업그레이드 요청 $SCHEME: //$SERVIP: $PORT$PATH

다음 방법 중 하나로 이 매개변수를 구성하세요.

  • XML이 포함된 전화 구성 파일 (cfg.xml) 에서 다음 형식으로 문자열을 입력하세요. <Log_Upgrade_Request_Msg ua="na">$PN $MAC -- 업그레이드 요청 $SCHEME: //$SERVIP: $PORT$PATH</Log_Upgrade_Request_Msg>

  • 전화 관리 웹 페이지에서 필요에 따라 매개 변수를 사용자 정의하세요.

로그 업그레이드 성공 메시지

펌웨어 업그레이드 시도가 성공적으로 완료된 후에 Syslog 메시지가 나왔어요.

기본값은 $PN $MAC -- 성공적인 업그레이드 $SCHEME: //$SERVIP: $PORT$PATH -- $오류

다음 방법 중 하나로 이 매개변수를 구성하세요.

  • XML이 포함된 전화 구성 파일 (cfg.xml) 에서 다음 형식으로 문자열을 입력하세요. <Log_Upgrade_Success_Msg ua="na">$PN $MAC -- 성공적인 업그레이드 $SCHEME: //$SERVIP: $PORT$PATH -- $ERR</Log_Upgrade_Success_Msg>

  • 전화 관리 웹 페이지에서 필요에 따라 매개 변수를 사용자 정의하세요.

로그 업그레이드 실패 메시지

펌웨어 업그레이드 실패 후 Syslog 메시지가 발생했어요.

기본값은 $PN $MAC -- 업그레이드 실패: $ERR

다음 방법 중 하나로 이 매개변수를 구성하세요.

  • 전화 구성 파일에 XML (cfg.xml) 을 사용하여 다음 형식으로 문자열을 입력하세요. <Log_Upgrade_Failure_Msg ua="na">$PN $MAC -- 업그레이드 실패: $ERR</Log_Upgrade_Failure_Msg>

  • 전화 관리 웹 페이지에서 필요에 따라 매개 변수를 사용자 정의하세요.

피어 펌웨어 공유

피어 펌웨어 공유 (PFS) 기능을 활성화 또는 비활성화해요. 기능을 활성화하거나 비활성화하려면 예 또는 아니오를 선택하세요.

기본값: 네

다음 방법 중 하나로 이 매개변수를 구성하세요.

  • XML (cfg.xml) 을 사용하여 전화 구성 파일에 문자열을 다음 형식으로 입력하세요. <Peer_Firmware_Sharing ua="na">예</Peer_Firmware_Sharing>

  • 전화 관리 웹 페이지에서 이 필드를 예 또는 아니오로 설정하세요.

피어 펌웨어 공유 로그 서버

UDP 메시지가 전송되는 IP 주소와 포트를 나타냅니다.

예: 10.98.76. 123:514 여기서 10.98.76.123은 IP 주소이고 514는 포트 번호예요.

다음 방법 중 하나로 이 매개변수를 구성하세요.

  • XML (cfg.xml) 을 사용하여 전화 구성 파일에 문자열을 다음 형식으로 입력하세요: <Peer_Firmware_Sharing_Log_Server ua="na">10.98.76</Peer_Firmware_Sharing_Log_Server>. 123:514

  • 전화 관리 웹 페이지에서 로그 서버 주소를 입력하세요.

범용 파라미터

다음 표는 프로비전 탭의 범용 매개변수 섹션에 있는 각 매개변수의 기능과 용도를 정의해요.

테이블 3이에요.범용 파라미터

파라미터 이름

설명과 기본값

GPP A - GPP P

범용 파라미터 GPP_*는 전화기가 특정 프로비저닝 서버 솔루션과 상호작용하도록 구성할 때 사용 가능한 문자열 레지스터로 사용돼요. 다음을 포함하여 다양한 값을 포함하도록 구성할 수 있어요.

  • 암호화 키예요.

  • URL이에요.

  • 다단계 프로비저닝 상태 정보.

  • 요청 템플릿 게시.

  • 파라미터 이름 앨리어스 맵.

  • 부분 문자열 값, 결국 완전한 매개변수 값으로 합쳐져요.

기본값은 공백이에요.

매크로 확장 변수

특정 매크로 변수는 다음 프로비전 파라미터 내에서 인식돼요.

  • 프로필_규칙

  • 프로필_규칙_*

  • 리싱크_트리거_*

  • 업그레이드_규칙

  • 로그_*

  • GPP_* (특정 조건 하에서)

이 매개변수 내에서 $NAME이나 $ (NAME) 같은 구문 유형이 인식되고 확장돼요.

매크로 변수 부분 문자열은 $ (이름:P) 와 $ (이름: P:Q) 표기법으로 지정할 수 있어요. 여기서 p와 q는 음이 아닌 정수예요 (버전 2.0.11 이상에서 사용 가능). 매크로 확장은 문자 오프셋 p에서 시작하고 길이가 q인 하위 문자열이에요 (또는 q가 지정되지 않은 경우 문자열 끝까지). 예를 들어 GPP_A에 ABCDEF가 포함되면 $ (A:2) 는 CDEF로 확장되고 $ (A: 2:3) 은 CDE로 확장돼요.

인식할 수 없는 이름은 번역되지 않아요. 그리고 $NAME 또는 $ (NAME) 형식은 확장 후에도 매개변수 값에 변경되지 않아요.

매개변수 이름

설명 및 기본값

$

$$ 형식은 단일 $ 문자로 확장돼요.

A부터 P까지

범용 매개변수 GPP_A~GPP_P의 내용으로 대체됐어요.

SA부터 SD까지

GPP_SA에서 GPP_SD까지의 특수 목적 매개변수로 대체됐어요. 이 매개변수에는 프로비저닝에 사용되는 키나 암호가 들어 있어요.

$SA~$SD는 선택적 재동기화 URL 한정자 --key에 대한 인수로 인식돼요.

MA

소문자 16진수를 사용하는 MAC 주소, 예를 들면 000e08aabbcc예요.

MAU

대문자 16진수를 사용하는 MAC 주소, 예를 들면 000E08AABBCC.

MAC

소문자 16진수를 사용하고 콜론을 사용하여 16진수 쌍을 구분하는 MAC 주소예요. 예를 들어 00:0 e:08:aa:bb:cc.

PN

제품 이름이에요. 예를 들어, CP-8875, DP-9851, DP-9871.

PSN

제품 시리즈 번호. 예를 들자면, V03.

SN

일련번호 문자열이에요. 예를 들면 88012BA01234.

CCERT

SSL 클라이언트 인증서 상태: 설치됨 또는 설치되지 않음.

IP

로컬 서브넷 내 전화의 IP 주소. 예를 들어 192.168.1.100이에요.

EXTIP

인터넷에서 본 것처럼 전화의 외부 IP예요. 예를 들어 66.43.16.52예요.

SWVER

소프트웨어 버전 문자열. 예를 들자면,

PHONEOS.3-1-1-0104-37

HWVER

하드웨어 버전 문자열. 예를 들면, 2.0.1

PRVST

프로비전 상태 (숫자 문자열):

-1 = 명시적 재동기화 요청

0 = 파워업 리싱크

1 = 주기적 재동기화

2 = 재동기화 실패, 재시도

UPGST

업그레이드 상태 (숫자 문자열):

1 = 첫 업그레이드 시도

2 = 업그레이드 실패, 재시도

UPGERR

이전 업그레이드 시도의 결과 메시지 (오류), 예를 들어 http_get 실패.

PRVTMR

마지막 재동기화 시도 이후 몇 초 후예요.

UPGTMR

마지막 업그레이드 시도 이후 초 됐어요.

REGTMR1

1호선 SIP 서버 등록이 끊긴 지 몇 초 됐어요.

REGTMR2

2호선 SIP 서버 등록이 끊긴 지 몇 초 됐어요.

UPGCOND

레거시 매크로 이름이에요.

SCHEME

재동기화 또는 업그레이드 URL을 파싱한 후 얻은 파일 액세스 체계, TFTP, HTTP, HTTPS 중 하나예요.

SERV

재동기화 또는 업그레이드 URL을 파싱한 후 얻은 대상 서버 호스트 이름을 요청하세요.

SERVIP

DNS 조회 후 재동기화 또는 업그레이드 URL을 파싱한 후 얻은 대상 서버 IP 주소를 요청하세요.

PORT

재동기화 또는 업그레이드 URL을 파싱한 후 얻은 대상 UDP/TCP 포트를 요청하세요.

PATH

재동기화 또는 업그레이드 URL을 파싱한 후 얻은 대상 파일 경로를 요청하세요.

ERR

재동기화 또는 업그레이드 시도 결과 메시지예요. 결과 syslog 메시지 생성에만 유용해요. 업그레이드 시도 시 UPGERR 변수에 값이 보존돼요.

우딘

라인 n 사용자 ID 구성 매개변수의 내용이에요.

EMS

Extension Mobility상태

MUID

Extension Mobility사용자 ID

MPWD

Extension Mobility비밀번호예요

내부 오류 코드

전화기가 내부 오류 코드 (X00~X99) 를 여러 개 정의해서 특정 오류 상황에서 장치의 동작을 더 세밀하게 제어할 수 있도록 구성을 용이하게 해요.

테이블 4예요.내부 오류 코드

파라미터 이름

설명과 기본값

X00

SIP 요청을 보낼 때 전송 레이어 (또는 ICMP) 오류가 났어요.

X20

응답 기다리는 동안 SIP 요청 시간이 초과됐어요.

X40

일반 SIP 프로토콜 오류 (예: 200개의 SDP 코덱과 ACK 메시지의 허용되지 않는 코덱, ACK 대기 중 타임아웃).

X60

다이얼 플랜에 따라 다이얼한 번호가 잘못됐어요.

이 문서가 도움이 되었습니까?
이 문서가 도움이 되었습니까?