프로비저닝 매개 변수 유형

이 섹션에서는 기능에 따라 광범위하게 프로비저닝 매개 변수를 설명합니다.

일반 목적 매개 변수

일반 목적 매개 변수 GPP_*(관리자 로그인 > 고급 > 음성 > 프로비저닝)는 자유 문자열로 사용되고 특정 프로비저닝 서버 솔루션과 상호 작용하기 위해 Cisco IP 전화기를 구성하는 경우에 등록합니다. GPP_* 매개 변수는 기본적으로 비어 있습니다. 다음을 포함한 다양한 값을 포함하도록 구성할 수 있습니다.

  • 암호화 키

  • URL

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

  • 게시 요청 템플릿

  • 매개 변수명 별칭 매핑

  • 최종적으로 부분 문자열 값은 완전한 매개 변수 값으로 결합됩니다.

GPP_* 매개 변수는 다른 프로비저닝 매개 변수 내에서 매크로 확장으로 이용 가능합니다. 이를 위해서는 GPP_A에서 GPP_P까지의 내용을 식별하는 데 한 자의 대문자 매크로 이름이면 충분합니다. 또한 다음 URL 옵션의 인수로 사용되는 특별한 경우 SA에서 SD까지의 두 대문자 매크로 이름으로 GPP_SA에서 GPP_SD까지 식별합니다.

key, uid, pwd

이러한 매개 변수는 프로비저닝과 업그레이드 규칙에 변수로 사용할 수 있습니다. 이는 $GPP_A와 같이 변수 이름 앞에 '$' 문자를 붙여 참조됩니다.

매개 변수 활성화

Provision_Enable 및 Upgrade_Enable 매개 변수는 모든 프로파일 재동기화 및 펌웨어 업그레이드 작업을 제어합니다. 이러한 매개 변수는 재동기화 및 업그레이드를 서로 독립적으로 제어합니다. 또한 이러한 매개 변수는 관리 웹 서버를 통해 전달된 재동기화 및 업그레이드 URL 명령을 제어합니다. 이러한 매개 변수는 기본적으로 Yes로 설정됩니다.

Resync_From_SIP 매개 변수는 재동기화 작업을 위한 요청을 제어합니다. SIP NOTIFY 이벤트가 서비스 제공자 프록시 서버에서 전화기로 전송됩니다. 활성화된 경우 프록시가 재동기화를 요청할 수 있습니다. 이렇게 하기 위해 프록시는 Event: resyn 헤더가 포함된 SIP NOTIFY 메시지를 장치로 전송합니다.

장치는 401 응답(사용된 자격 증명에 대해 권한 부여 거절)으로 해당 요청에 응답합니다. 장치는 인증됨 후속 요청을 기다린 후 프록시의 재동기화 요청을 이행합니다. Event: reboot_now 및 Event: restart_now 헤더는 각각 콜드 재시작 및 웜 재시작을 수행하며, 모두 응답을 받습니다.

나머지 두 개 항목은 Resync_On_Reset 및 Resync_After_Upgrade_Attempt입니다. 이러한 매개 변수는 장치가 전원 켜기 소프트웨어 재부팅 후 및 각 업그레이드 시도 후 재동기화 작업을 수행할지 여부를 결정합니다.

Resync_On_Reset가 활성화되면 부팅 시퀀스 후 재설정이 수행되기 전에 임의의 지연을 추가합니다. 최대 지연 시간은 Resync_Random_Delay에 지정된 값(초)입니다. 전화기의 풀에서 동시에 전화기를 켜는 경우 각 장치의 재동기화 요청 시작 시간을 분산시킵니다. 이 기능은 대규모 거주 지역 구축에서 지역 정전 발생 시 유용합니다.

트리거

전화기는 특정한 시간 또는 특정한 간격으로 재동기화할 수 있습니다.

특정 간격으로 재동기화

전화기는 주기적으로 프로비저닝 서버로 재동기화하도록 설계되었습니다. 재동기화 간격은 Resync_Periodic(초)에서 구성합니다. 이 값이 비어 있으면 장치는 주기적으로 재동기화하지 않습니다.

일반적으로 재동기화는 음성 회선이 유휴 상태인 경우에 수행됩니다. 재동기화 시간이 되었을 때 음성 회선이 활성 상태이면, 전화기는 회선이 유휴 상태가 될 때까지 재동기화 절차를 지연시킵니다. 재동기화로 인해 구성 매개 변수 값이 변경될 수 있습니다.

전화기가 서버에서 프로파일을 검색할 수 없거나, 다운로드한 파일이 손상되었거나, 내부 오류가 발생하면 재동기화 작업이 실패할 수 있습니다. 장치는 Resync_Error_Retry_Delay에 지정된 시간(초)이 지난 후 재동기화를 다시 시도합니다. Resync_Error_Retry_Delay가 0으로 설정된 경우 장치는 재동기화 시도가 실패한 후 재동기화를 다시 시도하지 않습니다.

업그레이드가 실패한 경우 Upgrade_Error_Retry_Delay에 지정된 시간(초)이 지난 후 다시 시도합니다.

재동기화를 조건부로 트리거하는 데 사용할 수 있는 두 가지 구성 가능한 매개 변수 Resync_Trigger_1 및 Resync_Trigger_2가 있습니다. 각 매개 변수는 매크로 확장을 거치는 조건식으로 프로그래밍할 수 있습니다. 재동기화 간격이 만료되었을 때(다음 재동기화 시간이 되었을 대) 설정된 트리거가 있는 경우, 하나 이상의 트리거가 참으로 평가되지 않으면 재동기화를 차단합니다.

다음 예에서 조건은 재동기화를 트리거합니다. 이 예에서 마지막 전화기 업그레이드 시도는 5분(300초) 이상 경과되었고 마지막 재동기화 시도는 10분(600) 이상 경과되었습니다.

$UPGTMR gt 300 and $PRVTMR ge 600

특정 시간에 재동기화

Resync_At 매개 변수를 사용하면 특정 시간에 전화기를 재동기화할 수 있습니다. 이 매개 변수는 24시간 형식(hhmm)으로 시간을 지정합니다.

Resync_At_Random_Delay 매개 변수는 전화기가 지정되지 않은 지연 시간에 재동기화하도록 허용하지 않습니다. 이 매개 변수는 양의 정수 형식으로 시간을 지정합니다.

다수의 전화기를 동시에 재동기화하도록 설정하여 재동기화 요청이 서버로 쇄도하지 않도록 해야 합니다. 이를 위해 전화기는 지정된 시간이 지난 후 최대 10분 후 재동기화를 트리거합니다.

예를 들어 재동기화 시간을 1000(오전 10시)으로 설정한 경우, 전화기는 오전 10:00 ~ 10:10 사이에 재동기화를 트리거합니다.

이 기능은 기본적으로 비활성화됩니다. Resync_At 매개 변수가 프로비저닝된 경우 Resync_Periodic 매개 변수는 무시됩니다.

구성 가능한 일정

다음과 같은 프로비저닝 매개 변수를 사용하여 주기적 재동기화를 예약할 수 있으며, 재동기화 및 업그레이드 실패에 대한 재시도 간격을 지정할 수 있습니다.

  • Resync_Periodic

  • Resync_Error_Retry_Delay

  • Upgrade_Error_Retry_Delay

각 매개 변수는 단일 지연 값(초)을 받습니다. 새 확장 구문에서는 연속된 지연 요소를 쉼표로 구분된 목록으로 사용할 수 있습니다. 시퀀스의 마지막 요소는 암시적으로 무한 반복됩니다.

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

예 1

이 예에서는 전화기는 2시간마다 주기적으로 재동기화합니다. 재동기화가 실패한 경우, 장치는 30분, 1시간, 2시간, 4시간 간격으로 재시도합니다. 장치는 재동기화가 성공할 때까지 4시간 간격으로 계속 시도합니다.

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

예 2

이 예에서는 장치는 매시간(더하기 임의 지연 시간 최대 10분) 주기적으로 재동기화합니다. 재동기화가 실패한 경우, 장치는 30분(더하기 최대 5분), 1시간(더하기 최대 10분), 2시간(더하기 최대 15분) 간격으로 재시도합니다. 장치는 재동기화가 성공할 때까지 2시간(더하기 최대 15분) 간격으로 계속 시도합니다.

 재동기화_주기=3600+600 재동기화_오류_재시도_지연=1800+300,3600+600,7200+900

예 3

이 예에서 원격 업그레이드 시도가 실패한 경우, 장치는 30분 내에 업그레이드를 재시도하고, 1시간 후, 2시간 후 재시도합니다. 여전히 업그레이드가 실패한 경우, 장치는 업그레이드가 성공할 때까지 4-5시간마다 재시도합니다.

Upgrade_Error_Retry_Delay  =  1800,3600,7200,14400+3600

프로필 규칙

전화기기는 여러 원격 구성 프로파일 매개 변수(Profile_Rule*)를 제공합니다. 각 재동기화 작업은 여러 다른 서버에서 관리하는 여러 파일을 검색할 수 있습니다.

가장 간단한 시나리오에서는 장치가 중앙 서버의 단일 프로파일로 주기적으로 재동기화하고 모든 관련된 내부 매개 변수를 업데이트합니다. 프로파일이 여러 다른 파일로 분할되는 경우도 있습니다. 한 파일이 모든 한 구축 내의 모든 전화기에 공통입니다. 각 계정에 대해 별도의 고유한 파일이 제공됩니다. 암호화 키 및 인증서 정보는 별도의 서버에 저장된 다른 프로파일을 통해 제공할 수 있습니다.

재동기화 작업의 일정이 되면 전화기가 네 개의 Profile_Rule* 매개 변수를 순서대로 평가합니다.

  1. Profile_Rule

  2. Profile_Rule_B

  3. Profile_Rule_C

  4. Profile_Rule_D

각 평가의 결과로 원격 프로비저닝 서버에서 프로파일이 검색될 수 있으며 여러 내부 매개 변수 일부가 업데이트될 수 있습니다. 평가가 실패하면 재동기화 시퀀스가 중단되며 Resync_Error_Retry_Delay 매개 변수에 지정된 시간(초)이 지난 후 재시도합니다. 모든 평가가 성공한 경우 장치는 Resync_Periodic 매개 변수에 지정된 시간(초) 동안 대기한 후 다른 재동기화를 수행합니다.

each Profile_Rule* 매개 변수의 내용은 대체 항목의 집합으로 구성될 수 있습니다. 대체 항목은 | (파이프) 문자로 구분합니다. 각 대체 항목은 조건식, 할당식, 프로파일 URL, 연관된 URL 옵션으로 구성됩니다. 이러한 모든 구성 요소는 각 대체 항목 내에서 선택 사항입니다. 다음은 올바른 조합이며, 지정해야 하는 순서입니다(있는 경우).

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

각 Profile_Rule* 매개 변수 내에서 마지막 항목을 제외한 모든 대체 항목은 조건식을 제공해야 합니다. 이 식은 다음과 같은 평가 및 처리됩니다.

  1. 조건은 왼쪽에서 오른쪽으로 참으로 평가되는 항목이 나올 때까지 평가됩니다(또는 조건식이 없는 대체 항목이 나올 때까지).

  2. 함께 지정된 할당식이 있으면 평가됩니다.

  3. 대체 항목의 일부로 지정된 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 | [--게시물] http://p.tel.com/lost-reg?

예 3

이 예에서 장치는 동일한 서버로 재동기화합니다. 장치에 인증서가 설치되지 않은 경우(2.0 이전 레거시 장치) 장치가 추가 정보를 제공합니다.

 ("$CCERT"는 "설치됨"과 동일) https://p.tel.com/config? | https://p.tel.com/config?cisco$MAU

예 4

이 예에서 회선 1은 GPP_A가 첫 번째 URL을 통해 프로비저닝됨으로 설정될 때까지 비활성화됩니다. 그 후에는 두 번째 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가 No로 설정되면 장치가 서버에서 파일을 찾을 수 없음 응답을 받아도 재동기화가 성공한 것으로 간주합니다. Resync_Fails_On_FNF의 기본값은 Yes입니다.

업그레이드 규칙

업그레이드 규칙은 장치에 새로운 로드를 활성화하도록 지시하며 필요한 경우 해당 로드를 얻는 위치를 알려줍니다. 장치에 로드가 이미 있는 경우 로드를 얻으려고 하지 않습니다. 따라서 원하는 로드가 비활성 파티션에 있는 경우 로드 위치의 유효성은 상관이 없습니다.

Upgrade_Rule은 펌웨어 로드를 지정하며, 현재 로드와 다른 경우 지정한 로드를 다운로드하고 조건식에 의해 제한되거나 Upgrade_Enable가 아니요로 설정되지 않은 경우 해당 로드를 적용합니다.

전화기는 하나의 구성 가능한 원격 업그레이드 매개 변수 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. 구성 프로파일 매개 변수

매개 변수명

설명 및 기본값

프로비저닝 활성화

모든 재동기화 작업을 펌웨어 업그레이드 작업과 관계없이 제어합니다. 원격 프로비저닝을 활성화하려면 예로 설정합니다.

기본값은 예입니다.

초기화 시 동기화

매개 변수 업데이트 및 펌웨어 업그레이드에 의한 재부팅을 제외하고 모든 재부팅 후 재동기화를 트리거합니다.

기본값은 예입니다.

임의 지연 재동기화

초기화를 수행하기 전에 부팅 시퀀스 이전의 임의 지연으로 초 단위로 지정됩니다. 동시에 전원이 켜지도록 예약된 IP 전화 통신 장치 풀에서 이 기능은 각 장치가 프로비저닝 서버로 재동기화 요청을 전송하는 시간을 분산시킵니다. 이 기능은 대규모 거주 지역 구축에서 지역 정전 발생 시 유용합니다.

이 필드의 값 범위는 0 - 65535 사이의 정수여야 합니다.

기본값은 2입니다.

(HHmm)에 재동기화

장치가 프로비저닝 서버와 재동기화하는 시간(HHmm)입니다.

이 필드의 값은 HHmm 형식으로 시간을 나타내기 위해 0000 - 2400 사이의 네 자리 숫자여야 합니다. 예를 들어 0959는 09:59를 나타냅니다.

기본값은 비어 있습니다. 값 유효하지 않을 경우 매개 변수가 무시됩니다. 이 매개 변수가 유효한 값으로 설정되면 주기적 재동기화 매개 변수가 무시됩니다.

임의 지연 시 재동기화

많은 수의 장치가 동시에 켜질 경우 프로비저닝 서버의 과부하를 방지합니다.

여러 전화기로부터 재동기화 요청이 서버로 쇄도하는 것을 방지하기 위해, 전화기는 일정한 시간 및 분 범위에 임의의 지연 시간 및 분을 더한 시점에 재동기화합니다(hhmm, 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 메시지를 통해 재동기화가 트리거되도록 활성화합니다.

기본값은 예입니다.

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

업그레이드 수행 이후에 재동기화 작업을 활성화하거나 비활성화합니다. 예를 선택하면 동기화가 트리거됩니다.

기본값은 예입니다.

재동기화 트리거 1, 재동기화 트리거 2

구성 가능한 재동기화 트리거 조건입니다. 이러한 매개 변수의 논리 수식이 TRUE로 평가되면 재동기화가 트리거됩니다.

기본값은 비어 있습니다.

FNF 시 재동기화 실패

요청된 프로파일을 서버에서 가져올 수 없으면 재동기화가 실패한 것으로 간주됩니다. 이 작업은 이 매개변수로 조정될 수 있습니다. 아니요로 설정된 경우 서버로부터 파일을 찾을 수 없음 응답을 받아도 성공적인 재동기화로 간주합니다.

기본값은 예입니다.

프로파일 규칙

프로파일 규칙 B

프로파일 규칙 C

프로파일 규칙 D

각 프로파일 규칙은 전화기에 프로파일을 가져올 소스(구성 파일)를 알려줍니다. 재동기화 작업 시 전화기는 모든 프로파일을 순서대로 적용합니다.

디폴트: /$PSN.xml

구성 파일에 AES-256-CBC 암호화를 적용하는 경우 다음과 같이 --key 키워드를 사용하여 암호화 키를 지정하십시오.

[--key <암호화 키>]

선택적으로 암호화 키를 큰따옴표(")로 묶을 수 있습니다.

사용할 DHCP 옵션

쉼표로 구분되는 DHCP 옵션은 펌웨어 및 프로파일을 검색하는 데 사용됩니다.

기본값은 66,160,159,150,60,43,125입니다.

로그 요청 메시지

이 매개 변수는 재동기화 시도를 시작할 때 syslog 서버로 전송하는 메시지를 포함합니다.

기본값은 $PN $MAC –Requesting % $SCHEME://$SERVIP:$PORT$PATH입니다.

로그 성공 메시지

재동기화 시도가 성공적으로 완료되면 전송되는 syslog 메시지입니다.

기본값은 $PN $MAC –Successful Resync % $SCHEME://$SERVIP:$PORT$PATH -- $ERR입니다.

로그 실패 메시지

실패한 재동기화 시도 이후 전송되는 syslog 메시지입니다.

기본값은 $PN $MAC -- Resync failed: $ERR입니다.

사용자 구성 가능 재동기화

사용자가 IP 전화기 화면에서 전화기 재동기화를 수행하도록 허용합니다.

기본값은 예입니다.

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

다음 테이블에서는 프로비저닝 탭의 펌웨어 업그레이드 섹션에 있는 각 파라미터의 기능과 사용법을 정의합니다.

표 2. 펌웨어 업그레이드 매개 변수

매개 변수명

설명 및 기본값

업그레이드 활성화

재동기화 작업과 관계없이 펌웨어 업그레이드 작업을 활성화합니다.

기본값은 예입니다.

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

  • XML(cfg.xml)이 있는 전화 구성 파일에서 다음 형식으로 문자열을 입력합니다: <Upgrade_Enable ua="na">Yes</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 -- Requesting upgrade $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 -- Successful upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR

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

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

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

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

펌웨어 업그레이드 시도 실패 이후에 발급된 Syslog 메시지입니다.

기본값: $PN $MAC -- Upgrade failed: $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">Yes</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.123:514</Peer_Firmware_Sharing_Log_Server>

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

일반 목적 매개 변수

다음 테이블에서는 프로비저닝 탭의 일반 목적 파라미터 섹션에 있는 각 파라미터의 기능과 사용법을 정의합니다.

표 3. 일반 목적 매개 변수

매개 변수명

설명 및 기본값

GPP A - GPP P

일반 목적 매개 변수 GPP_*는 자유 문자열로 사용되고 특정 프로비저닝 서버 솔루션과 상호 작용하기 위해 전화기를 구성하는 경우에 등록합니다. 다음을 포함한 다양한 값을 포함하도록 구성할 수 있습니다.

  • 암호화 키.

  • URL.

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

  • 게시 요청 템플릿.

  • 매개 변수명 별칭 매핑.

  • 최종적으로 부분 문자열 값은 완전한 매개 변수 값으로 결합됩니다.

기본값은 비어 있습니다.

매크로 확장 변수

다음 프로비저닝 매개 변수 안에서 특정한 매크로 변수가 인식됩니다.

  • Profile_Rule

  • Profile_Rule_*

  • Resync_Trigger_*

  • Upgrade_Rule

  • Log_*

  • GPP_*(특정 조건에 따라)

이러한 매개 변수 안에서는 $NAME 또는 $(NAME)와 같은 구문이 인식 및 확장됩니다.

매크로 변수 하위 문자열은 $(NAME:p) 및 $(NAME: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:0e: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

이전 업그레이드 시도의 결과 메시지(ERR), 예: http_get 실패.

PRVTMR

마지막 재동기화 시도 이후의 초.

UPGTMR

마지막 업그레이드 시도 이후의 초.

REGTMR1

회선 1이 SIP 서버에서 등록이 해제된 이후의 초.

REGTMR2

회선 2가 SIP 서버에서 등록이 해제된 이후의 초.

UPGCOND

레거시 매크로 이름입니다.

SCHEME

재동기화 또는 업그레이드 URL을 구문 분석하여 얻는 파일 액세스 체계입니다(TFTP, HTTP 또는 HTTPS 중 하나).

SERV

재동기화 또는 업그레이드 URL을 구문 분석하여 얻는 요청 대상 서버 호스트 이름입니다.

SERVIP

재동기화 또는 업그레이드 URL을 구문 분석하고 경우에 따라 DNS 조회를 수행한 후 얻는 요청 대상 서버 IP 주소입니다.

PORT(포트)

재동기화 또는 업그레이드 URL을 구문 분석하여 얻는 요청 대상 UDP/TCP 포트입니다.

PATH

재동기화 또는 업그레이드 URL을 구문 분석하여 얻는 요청 대상 파일 경로입니다.

ERR

재동기화 또는 업그레이드 시도의 결과 메시지입니다. 결과 syslog 메시지를 생성하는 데만 유용합니다. 업그레이드 시도의 경우 UPGERR 변수에 값이 유지됩니다.

UIDn

회선 n UserID 설정 매개 변수의 내용.

EMS

내선 이동 상태

MUID

내선 이동 사용자 ID

MPWD

내선 이동 암호

내부 오류 코드

전화기는 특정 오류 상황에서 장치의 작동을 더 세밀하게 제어할 수 있도록 하여 구성을 돕는 몇 가지 내부 오류 코드(X00–X99)를 정의합니다.

표 4. 내부 오류 코드

매개 변수명

설명 및 기본값

X00

SIP 요청을 보낼 때 전송 레이어(또는 ICMP) 오류가 발생했습니다.

X20

응답을 기다리는 동안 SIP 요청이 시간 초과되었습니다.

X40

일반 SIP 프로토콜 오류(예를 들어 200 및 ACK의 SDP에서 허용되지 않는 코덱이거나 ACK를 기다리는 동안 시간 초과)가 발생했습니다.

X60

지정된 다이얼 플랜에 위반되는 잘못된 착신 번호입니다.