- בית
- /
- מאמר
הגדר הגדרות פרופיל עבור טלפונים מסדרת 9800 ו- 8875 (BroadWorks)
מאמר עזרה זה מיועד לסדרת הטלפון השולחני של סיסקו 9800 ולטלפון וידאו 8875 של סיסקו הרשומים בסיסקו ברודוורקס. המידע בדף זה כולל סנכרון מחדש של פרופיל, החלת פרופיל באופן ידני ותחביר תצורה.
הגדר את הטלפון שלך לסנכרון מחדש של פרופיל
סנכרן מחדש את פרופיל הטלפון באמצעות TFTP
הטלפון תומך בפרוטוקולי רשת מרובים לאחזור פרופילי תצורה. פרוטוקול העברת הפרופיל הבסיסי ביותר הוא TFTP (RFC1350). TFTP נמצא בשימוש נרחב להקצאת התקני רשת בתוך רשתות LAN פרטיות. למרות שאינו מומלץ לפריסה של נקודות קצה מרוחקות ברחבי האינטרנט, TFTP יכול להיות נוח לפריסה בתוך ארגונים קטנים, להקצאה מראש פנימית ולפיתוח ובדיקה. בהליך הבא, פרופיל משתנה לאחר הורדת קובץ משרת TFTP.
| 1 |
בסביבת LAN, חבר את המחשב והטלפון לרכזת, מתג או נתב קטן. |
| 2 |
במחשב, התקן והפעל שרת TFTP. |
| 3 |
השתמש בעורך טקסט כדי ליצור פרופיל תצורה. כדי לוודא שהפרופיל הוענק לטלפון שלך מאוחר יותר, באפשרותך להגדיר חלק מהערכים כסימנים. לדוגמה, הגדר את הערך עבור GPP_A ל- 12345678 כפי שמוצג בדוגמה הבאה:
|
| 4 |
שמור את קובץ התצורה של XML בספריית השורש של שרת TFTP. באפשרותך לוודא ששרת TFTP מוגדר כהלכה: בקש את קובץ פרופיל התצורה באמצעות לקוח TFTP שאינו הטלפון. רצוי להשתמש בלקוח TFTP הפועל במארח נפרד משרת ההקצאה. |
| 5 |
בדפדפן האינטרנט במחשב שלך, פתח את דף האינטרנט של הניהול. לדוגמה, נניח שכתובת ה- IP של הטלפון היא 192.168.1.100, פתח את כתובת האתר הבאה בדפדפן האינטרנט שלך:
|
| 6 |
בחר בכרטי ובדוק את הערכים של הפרמטרים למטרות כלליות GPP_A עד GPP_P. אלה צריכים להיות ריקים. |
| 7 |
סנכרן מחדש את טלפון הבדיקה לפרופיל התצורה שיצרת על-ידי פתיחת כתובת ה-URL לסנכרון מחדש בדפדפן אינטרנט. דוגמה: אם כתובת ה- IP של שרת TFTP היא 192.168.1.200, הפקודה צריכה להיות דומה לדוגמא הבאה:
כאשר הטלפון מקבל פקודה זו, ההתקן בכתובת 192.168.1.100 מבקש את קובץ פרופיל התצורה |
| 8 |
ודא שהפרמטר עודכן כהלכה. רענן את דף האינטרנט של הניהול ועבור אל הפרמטר GPP_A אמור להכיל כעת את הערך 12345678. |
הקצאת פרופיל ספציפי לטלפון בשרת TFTP
| 1 |
השג את כתובת ה- MAC של הטלפון מתווית המוצר שלו. (כתובת ה- MAC היא המספר, תוך שימוש במספרים ובספרות משושה באותיות קטנות, לדוגמה, 000e08aabbcc. |
| 2 |
שנה את שם קובץ התצורה שלך ל- דוגמה:
|
| 3 |
העבר את הקובץ החדש לספריית השורש הווירטואלית של שרת TFTP. |
| 4 |
גש לדף האינטרנט של ניהול הטלפון. |
| 5 |
בחר |
| 6 |
הזן את הנתיב של קובץ הפרו פיל בשדה כלל פרופיל. דוגמה: נ ניח שכתובת ה- IP של שרת TFTP היא 192.168.1.200 ושם קובץ הפרופיל הוא
|
| 7 |
לחץ על שלח את כל השינויים. זה גורם לאתחול מחדש ולסינכרון מחדש מיידי. כאשר הסינכרון הבא מתרחש, הטלפון מאחזר את הקובץ החדש על ידי הרחבת ביטוי המאקרו $MA לכתובת ה- MAC שלו. |
סנכרן מחדש את פרופיל הטלפון עם HTTP GET
| 1 |
התקן שרת HTTP במחשב המקומי או במארח נגיש אחר. ניתן להוריד את שרת Apache בקוד פתוח מהאינטרנט. |
| 2 |
העלה את קובץ פרופיל התצורה לספריית השורש הווירטואלית של השרת המותקן. |
| 3 |
כדי לאמת התקנת שרת נכונה וגישה לקובץ הפרופיל, פתח את הפרופיל באמצעות דפדפן אינטרנט. |
| 4 |
שנה את הפרופיל_Rule של טלפון הבדיקה כדי להצביע על שרת HTTP במקום שרת TFTP, כדי להוריד את הפרופיל שלו מעת לעת. לדוגמה, בהנחה ששרת HTTP נמצא ב- 192.168.1.300 ושם הקובץ של הפרופיל הוא basic.txt, הזן את הערך הבא:
|
| 5 |
לחץ על שלח את כל השינויים. זה גורם לאתחול מחדש ולסינכרון מחדש מיידי. |
| 6 |
שימו לב להודעות ה- syslog שהטלפון שולח. הסנכרון המחודש התקופתי אמור כעת להשיג את הפרופיל משרת HTTP. |
| 7 |
ביומני שרת HTTP, בדוק כיצד מידע המזהה את טלפון הבדיקה מופיע ביומן של סוכני המשתמש. מידע זה צריך לכלול את היצרן, שם המוצר, גרסת הקושחה הנוכחית והמספר הסידורי. |
סנכרן מחדש את פרופיל הטלפון באופן אוטומטי
התקן יכול לסנכרן מחדש מעת לעת לשרת ההקצאה כדי להבטיח שכל שינויי הפרופיל שבוצעו בשרת יופצו להתקן נקודת הקצה (בניגוד לשליחת בקשת סנכרון מחדש מפורשת לנקודת הקצה).
כדי לגרום לסנכרן מחדש של הטלפון לשרת מעת לעת, כתובת אתר של פרופיל תצורה מוגדרת באמצעות הפרמטר Profile_Rule, ותקופת סנכרון מחדש מוגדרת באמצעות הפרמטר Resync_Periodic.
| 1 |
גש לדף האינטרנט של ניהול הטלפון. |
| 2 |
בחר |
| 3 |
הגדר את הפרמטר פרופיל_כלל. דוגמה זו מניחה כתובת IP של שרת TFTP של 192.168.1.200. |
| 4 |
בשדה סינכרון תקופתי מחדש, הזן ערך קטן לבדיקה, כגון 30 שניות. |
| 5 |
לחץ על שלח את כל השינויים. עם הגדרות הפרמטר החדשות, הטלפון מסנכרן מחדש פעמיים בדקה לקובץ התצורה שכתובת האתר מציינת. |
| 6 |
צפה בהודעות שהתקבלו במעקב syslog. |
| 7 |
ודא שהשדה Resync On Reset מו גדר כYes.
|
| 8 |
הפעל את הטלפון כדי לאלץ אותו לסנכרן מחדש לשרת ההקצאה. אם פעולת הסנכרון מחדש נכשלת מסיבה כלשהי, כגון אם השרת אינו מגיב, היחידה ממתינה (למספר השניות שהוגדר ב- Resync Error Retry Delay) לפני שתנסה לסנכרן מחדש. אם עיכוב ניסיון חוזר של שגיאת סנכרון מחדש הוא אפס, הטלפון לא ינסה לסנכרן מחדש לאחר ניסיון סינכרון מחדש נכשל. |
| 9 |
(אופציונלי) הגדר את הערך של השדה Resync Error Retry Delay למספר קטן, כגון 30.
|
| 10 |
השבת את שרת TFTP וצפה בתוצאות בפלט syslog. |
פרמטרים לסנכרון מחדש של פרופיל
הטבלה הבאה מגדירה את הפונקציה והשימוש בפרמטרים לסנכרון מחדש של פרופיל במקטע פרופיל תצורה תחת הכרטיסייה בדף האינטרנט של הטלפון. זה גם מגדיר את התחביר של המחרוזת שנוספה בקובץ תצורת הטלפון (cfg.xml) עם קוד XML כדי להגדיר פרמטר.
|
פרמטר |
תיאור |
|---|---|
|
הפעלת הפרשה |
מאפשר או דוחה פעולות סינכרון מחדש של פרופיל תצורה.
ברירת מחדל: כן |
|
סינכרון מחדש באיפוס |
מציין אם הטלפון יסנכרן מחדש תצורות עם שרת הקצאה לאחר ההפעלה ולאחר כל ניסיון שדרוג.
ברירת מחדל: כן |
|
עיכוב אקראי לסנכרון מחדש |
מונע עומס יתר של שרת ההקצאה כאשר מספר גדול של התקנים מופעלים בו זמנית ומנסים להגדיר התצורה הראשונית. עיכוב זה יעיל רק בניסיון התצורה הראשוני, לאחר הפעלה או איפוס התקן. הפרמטר הוא מרווח הזמן המרבי שההתקן ממתין לפני יצירת קשר עם שרת ההקצאה. העיכוב בפועל הוא מספר פסאודו-אקראי בין 0 לערך זה. פרמטר זה הוא ביחידות של 20 שניות. הערך התקף נע בין 0 ל- 65535.
ערך ברירת המחדל הוא 2 (40 שניות). |
|
סינכרון מחדש ב (HHmm) |
הזמן (HHmm) שהטלפון מסנכרן מחדש עם שרת ההקצאה. הערך עבור שדה זה חייב להיות מספר בן ארבע ספרות הנע בין 0000 ל 2400 כדי לציין את השעה בפורמט HHmm. לדוגמה, 0959 מציין 09:59.
ערך ברירת המחדל ריק. אם הערך אינו חוקי, הפרמטר מתעלם. אם פרמטר זה מוגדר עם ערך חוקי, מתעלמים מהפרמטר Resync Perio dic. |
|
סינכרון מחדש בעיכוב אקראי |
מונע עומס יתר של שרת ההקצאה כאשר מספר גדול של התקנים מופעל בו זמנית. כדי למנוע הצפת בקשות לסנכרון מחדש לשרת ממספר טלפונים, הטלפון מסנכרן מחדש בטווח שבין השעות והדקות, והשעות והדקות בתוספת העיכוב האקראי (hhmm, hhmm+random_delay). לדוגמה, אם העיכוב האקראי = (סינכרון מחדש בעיכוב אקראי + 30) /60 דקות, ערך הקלט בשניות מומר לדקות, ומעוגל לדקה הבאה כדי לחשב את מרווח ההשהיה הסופי של random_delay.
הערך התקף נע בין 600 ל 65535. אם הערך נמוך מ- 600, העיכוב האקראי הפנימי הוא בין 0 ל 600. ערך ברירת המחדל הוא 600 שניות (10 דקות). |
|
סינכרון מחדש תקופתי |
מרווח הזמן בין סינכרון מחדש תקופתי עם שרת הקצאה. טיימר הסנכרון מחדש המשויך פעיל רק לאחר הסנכרון המוצלח הראשון עם השרת. הפורמטים התקפים הם כדלקמן:
הגדר פרמטר זה לאפס כדי להשבית סינכרון מחדש תקופתי. ערך ברירת המחדל הוא 3600 שניות. |
|
שגיאת סינכרון מחדש עיכוב ניסיון חוזר |
אם פעולת סנכרון מחדש נכשלת מכיוון שהטלפון לא הצליח לאחזר פרופיל מהשרת, או שהקובץ שהורד פגום, או שמתרחשת שגיאה פנימית, הטלפון ינסה לסנכרן מחדש לאחר זמן שצוין בשניות. הפורמטים התקפים הם כדלקמן:
אם העיכוב מוגדר ל- 0, ההתקן לא ינסה לסנכרן מחדש לאחר ניסיון סינכרון מחדש שנכשל.
ברירת מחדל: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400 |
|
עיכוב סינכרון מחדש כפוי |
עיכוב מרבי (בשניות) הטלפון ממתין לפני ביצוע סינכרון מחדש. המכשיר אינו מסנכרן מחדש בזמן שאחד מקווי הטלפון שלו פעיל. מכיוון שסנכרון מחדש יכול להימשך מספר שניות, רצוי להמתין עד שהמכשיר יהיה במצב לא פעיל לתקופה ממושכת לפני סינכרון מחדש. זה מאפשר למשתמש לבצע שיחות ברצף ללא הפרעה. למכשיר יש טיימר שמתחיל לספור לאחור כאשר כל הקווים שלו הופכים לסרק. פרמטר זה הוא הערך ההתחלתי של הדלפק. אירועי סינכרון מחדש מתעכבים עד שהנגד הזה יורד לאפס. הערך התקף נע בין 0 ל- 65535.
ערך ברירת המחדל הוא 14,400 שניות. |
|
סינכרון מחדש מ- SIP |
שולט בבקשות לפעולות סינכרון מחדש באמצעות אירוע SIP NOTIFY שנשלח משרת ה- proxy של ספק השירות לטלפון. אם אפשרות זו מופעלת, ה- proxy יכול לבקש סנכרון מחדש על-ידי שליחת הודעת SIP NOTIFY המכילה את הכותרת Event: resync להתקן.
ברירת מחדל: כן |
|
סינכרון מחדש לאחר ניסיון שדרוג |
מאפשר או מבטל את פעולת הסנכרון מחדש לאחר שדרוג כלשהו מתרחש. אם נבחר כן, הסנכרון מופעל לאחר שדרוג קושחה.
ברירת מחדל: כן |
|
טריגר סינכרון מחדש 1 סנכרון מחדש טריגר 2 |
אם המשוואה הלוגית בפרמטרים אלה מוערכת ל- FALSE, סנכרון מחדש אינו מופעל גם כאשר Resync On Reset מוגדר כ- TRUE. רק סינכרון מחדש באמצעות כתובת אתר פעולה ישירה והודעת SIP מתעלם ממפעילי סנכרון מחדש אלה. ניתן לתכנת את הפרמטרים עם ביטוי מותנה שעובר הרחבת מאקרו. לקבלת הרחבות המאקרו החוקיות, ראה משתני הרחבת מאקרו תחת פרמט רי הק צאה.
ברירת מחדל: ריק |
|
סינכרון מחדש הניתן להגדרה של המשתמש |
מאפשר למשתמש לסנכרן מחדש את הטלפון מתפריט מסך הטלפון. כאשר מוגדר כ Yes, משתמש יכול לסנכרן מחדש את תצורת הטלפון על ידי הזנת כלל הפרופיל מהטלפון. כאשר מוגדר כ - No, הפרמטר של כלל פרופיל אינו מוצג בתפריט מסך הטלפון.
ברירת מחדל: כן |
|
סינכרון מחדש נכשל ב- FNF |
סינכרון מחדש נחשב בדרך כלל כלא מוצלח אם פרופיל מבוקש אינו מתקבל מהשרת. פרמטר זה עוקף התנהגות זו. כאשר מוגדר כ - No, ההתקן מקבל תגובת
ברירת מחדל: כן |
|
סוג אימות פרופיל |
מציין את האישורים שישמשו לאימות חשבון פרופיל. האפשרויות הזמינות הן:
ברירת מחדל: אימות HTTP בסיסי לקבלת מידע נוסף, ראה ציון סוג אימות הפרופיל תחת ציון הטלפון לסנכרון מחדש של פרופיל. |
|
כלל פרופיל כלל פרופיל B כלל פרופיל ג כלל פרופיל ד |
כל כלל פרופיל מודיע לטלפון על מקור שממנו ניתן להשיג פרופיל (קובץ תצורה). במהלך כל פעולת סנכרון מחדש, הטלפון מיישם את כל הפרופילים ברצף.
ניתן לצרף את מפתח ההצפנה במרכאות כפולות (") באופן אופציונלי.
ברירת מחדל: |
|
אפשרות DHCP לשימוש |
אפשרויות DHCP, מופרדות בפסיקים, המשמשות לאחזור קושחה ופרופילים. ברירת מחדל: 66,160,159,150,60,43,125 |
|
DHCPv6 אפשרות לשימוש |
אפשרויות DHCP, מופרדות בפסיקים, המשמשות לאחזור קושחה ופרופילים. ברירת מחדל: 17,160,159 |
הקצאה באמצעות XML של סיסקו
ניתן לספק טלפונים באמצעות פונקציות XML של סיסקו.
באפשרותך לשלוח אובייקט XML לטלפון באמצעות חבילת הודעת SIP או פוסט HTTP לממשק CGI של הטלפון: http://PhoneIPAddress/CGI/Execute.
ה- CP-xxxx-3PCC מרחיב את תכונת XML של סיסקו כדי לתמוך בהקצאה באמצעות אובייקט XML:
<CP-xxxx-3PCCExecute>
<ExecuteItem URL=Resync:[profile-rule]/>
</CP-xxxx-3PCCExecute>
לאחר שהטלפון מקבל את אובייקט ה- XML, הוא מוריד את קובץ ההקצאה מ- [כללי פרופיל]. כלל זה משתמש בפקודות מאקרו כדי לפשט את הפיתוח של יישום שירותי XML.
רזולוציית כתובת אתר עם הרחבת מאקרו
ספריות משנה עם פרופילים מרובים בשרת מספקות שיטה נוחה לניהול מספר רב של התקנים פרוסים. כתובת האתר של הפרופיל יכולה להכיל:
-
שם שרת הקצאה או כתובת IP מפורשת. אם הפרופיל מזהה את שרת ההקצאה לפי שם, הטלפון מבצע בדיקת DNS כדי לפתור את השם.
-
יציאת שרת לא סטנדרטית שצוינה בכתובת האתר באמצעות תחביר:port הסטנדרטי אחרי שם השרת
. -
ספריית המשנה של ספריית השורש הווירטואלית של השרת שבה מאוחסן הפרופיל, שצוינה באמצעות סימון כתובת URL סטנדרטית ומנוהלת על ידי הרחבת מאקרו.
לדוגמה, הפרופיל_Rule הבא מבקש את קובץ הפרופיל ($PN.cfg), בספריית המשנה של השרת /cisco/config, משרת TFTP הפועל ב- host prov.telco .com מאזן לחיבור ביציאה 6900:
<Profile_Rule>
tftp://prov.telco.com:6900/cisco/config/$PN.cfg
</Profile_Rule>
ניתן לזהות פרופיל עבור כל טלפון בפרמטר למטרות כלליות, כאשר הערך שלו מופנה במסגרת כלל פרופיל משותף באמצעות הרחבת מאקרו.
לדוגמה, נניח ש- GPP_B מוגדר כ- Dj6Lmp23Q.
לכלל הפרופיל יש את הערך:
tftp://prov.telco.com/cisco/$B/$MA.cfg
כאשר המכשיר מסנכרן מחדש והמאקרו מורחבים, הטלפון עם כתובת MAC של 000e08012345 מבקש את הפרופיל עם השם המכיל את כתובת ה- MAC של המכשיר בכתובת האתר הבאה:
tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
ציין את סוג אימות הפרופיל
אימות פרופיל מאפשר למשתמשי הטלפון לסנכרן מחדש את פרופיל ההקצאה לטלפון. פרטי אימות נדרשים בזמן שהטלפון מנסה לסנכרן מחדש ולהוריד קובץ תצורה בפעם הראשונה ומקבל שגיאת אימות HTTP או HTTPS 401. כאשר אתה מפעיל תכונה זו, מסך הגדרת חשבון פרופיל מוצג בטלפון עבור המצבים הבאים:
-
כאשר שגיאת האימות HTTP או HTTPs 401 מתרחשת במהלך הקצאה בפעם הראשונה לאחר אתחול הטלפון
-
כאשר שם המשתמש והסיסמה של חשבון הפרופיל ריקים
-
כאשר אין שם משתמש וסיסמה בחוק הפרופיל
אם מסך הגדרת חשבון פרופיל חסר או מתעלם ממנו, המשתמש יכול לגשת למסך ההגדרה גם דרך תפריט מסך הטלפון, או מקש ה הגדרה, המוצג רק כאשר אין קו בטלפון רשום.
כאשר אתה משבית את התכונה, מסך הגדרת חשבון פרופיל אינו מוצג בטלפון.
שם המשתמש והסיסמה בשדה כלל פרופיל הם בעלי עדיפות גבוהה יותר מאשר חשבון הפרופיל.
-
כאשר אתה מספק כתובת URL נכונה בשדה כלל פרופיל ללא שם משתמש וסיסמה, הטלפון דורש אימות או עיכול כדי לסנכרן מחדש את הפרופיל. עם חשבון הפרופיל הנכון, האימות עובר. עם חשבון פרופיל שגוי, האימות נכשל.
-
כאשר אתה מספק כתובת URL נכונה בשדה כלל פרופיל עם שם משתמש וסיסמה נכונים, הטלפון דורש אימות או עיכול כדי לסנכרן מחדש את הפרופיל. חשבון הפרופיל אינו משמש לסנכרון מחדש של הטלפון. הכניסה מוצלחת.
-
כאשר אתה מספק כתובת URL נכונה בשדה כלל פרופיל עם שם משתמש וסיסמה שגויים, הטלפון דורש אימות או עיכול כדי לסנכרן מחדש את הפרופיל. חשבון הפרופיל אינו משמש לסנכרון מחדש של הטלפון. הכניסה תמיד נכשלת.
-
כאשר אתה מספק כתובת URL שגויה בשדה כלל פרופיל, הכניסה תמיד נכשלת.
ניתן גם להגדיר את הפרמטרים בקובץ תצורת הטלפון באמצעות קוד XML (cfg.xml).
באפשרותך לציין את סוג אימות הפרופיל מדף האינטרנט של ניהול הטלפון.
| 1 |
גש לדף האינטרנט של ניהול הטלפון. |
| 2 |
בחר |
| 3 |
במקטע פרופיל תצ ורה, הגדר את הפרמטר סוג אימות פרופיל כדי לציין את האישורים שישמשו לאימות חשבון פרופיל. באפשרותך להגדיר פרמטר זה בקובץ XML של תצורת הטלפון (cfg.xml) על ידי הז נת מחרוזת בפורמט זה:
אפשרויות:
ברירת מחדל: אימות HTTP בסיסי |
| 4 |
לחץ על שלח את כל השינויים. |
החלת פרופיל באופן ידני על הטלפון
הורד את קובץ התצורה לטלפון משרת TFTP
בצע שלבים אלה כדי להוריד את קובץ התצורה ליישום שרת TFTP במחשב האישי שלך.
| 1 |
חבר את המחשב ליציאת ה- LAN של הטלפון. |
| 2 |
הפעל יישום שרת TFTP במחשב וודא שקובץ התצורה זמין בספריית השורש של TFTP. |
| 3 |
בדפדפן אינטרנט, הזן את כתובת ה- IP של הטלפון LAN, את כתובת ה- IP של המחשב, את שם הקובץ ואת אישורי הכניסה. השתמש בפורמט זה:
דוגמה:
|
הורד את קובץ התצורה לטלפון עם cURL
השלם שלבים אלה כדי להוריד את התצורה לטלפון באמצעות cURL. כלי שורת פקודה זה משמש להעברת נתונים עם תחביר כתובת URL. כדי להוריד את cURL, בקר בכתובת:
https://curl.haxx.se/download.html
אנו ממליצים שלא להשתמש ב- cURL כדי לפרסם את התצורה לטלפון מכיוון ששם המשתמש והסיסמה עשויים להיתפס בזמן השימוש ב- cURL.
| 1 |
חבר את המחשב ליציאת ה- LAN של הטלפון. |
| 2 |
הורד את קובץ התצורה לטלפון על ידי הזנת הפקודה cURL הבאה:
|
הפניות לתצורת פרופיל
הטלפון מקבל תצורות בפורמט XML.
הדוגמאות בסעיף זה משתמשות בפרופילי תצורה עם תחביר XML.
פורמטים של פרופיל תצורה
פרופיל התצורה מגדיר את ערכי הפרמטר עבור הטלפון.
תבנית XML של פרופיל התצורה משתמשת בכלי עריכה סטנדרטיים של XML כדי להרכיב את הפרמטרים והערכים.
לכל טלפון יש ערכת תכונות שונה ולכן קבוצה שונה של פרמטרים.
פתח פורמט פרופיל
פרופיל הפורמט הפתוח הוא קובץ טקסט עם תחביר דמוי XML בהיררכיה של אלמנטים, עם תכונות וערכים של אלמנטים. תבנית זו מאפשרת לך להשתמש בכלים סטנדרטיים ליצירת קובץ התצורה. ניתן לשלוח קובץ תצורת XML משרת ההקצאה לטלפון במהלך פעולת סנכרון מחדש, ללא קומפילציה כאובייקט בינארי.
הטלפון יכול לקבל פורמטים של תצורה שכלים סטנדרטיים מייצרים. תכונה זו מקלה על פיתוח תוכנת שרת הקצאה אחורית המייצרת פרופילי תצורה ממסדי נתונים קיימים.
כדי להגן על מידע סודי בפרופיל התצורה, שרת הקצאה מספק את קובץ התצורה של XML לטלפון דרך ערוץ המאובטח באמצעות TLS. לחלופין, ניתן לדחוס את הקובץ באמצעות אלגוריתם gzip deflate (RFC1951).
ניתן להצפין את הקובץ באחת משיטות ההצפנה הבאות:
-
הצפנת AES-256-CBC
-
הצפנת תוכן HTTP מבוססת RFC-8188 עם הצפנת AES-128-GCM
קובץ תצורה יכול לכלול רכיבים אלה:
-
תגי אלמנט
-
תכונות
-
פרמטרים
-
תכונות עיצוב
-
הערות XML
דוגמה: פתח את תבנית הפרופיל
<flat-profile>
<Resync_On_Reset> Yes </Resync_On_Reset>
<Resync_Periodic> 7200 </Resync_Periodic>
<Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule>
</flat-profile>
<flat-profile>תג האלמנט מקיף את כל רכיבי הפרמטר שהטלפון מזהה.
מאפייני תג אלמנט
זכור את הכללים הבאים בעת יצירת או עדכון קובץ התצורה.
-
תבנית הקצאת XML וממשק המשתמש של האינטרנט מאפשרים תצורה של אותן הגדרות. שמות תגי XML ושמות השדות בממשק המשתמש של האינטרנט דומים אך משתנים בשל מגבלות שמות רכיבי XML. לדוגמה, קו תחתון (_) בקובץ תצורת XML במקום רווחים בממשק המשתמש של האינטרנט.
-
<flat-profile>הטלפון מזהה אלמנטים עם שמות פרמטרים מתאימים המצוידים באלמנט המיוחד
. -
שמות האלמנטים סגורים בסוגריים זוויתיים.
-
רוב שמות האלמנטים דומים לשמות השדות בממשק המשתמש של האינטרנט של הטלפון, עם השינויים הבאים:
-
שמות הרכיבים אינם יכולים לכלול רווחים או תווים מיוחדים. כדי לגזור את שם האלמנט משמה שדה האינטרנט, החלף קו תחתון עבור כל רווח או את התווים המיו
חדים [,],(,)או/.דוגמה: ה <Resync_On_Reset>רכיב מייצג את השדה Resync On Reset.
-
כל שם אלמנט חייב להיות ייחודי. בממשק המשתמש של הטלפון, אותם שדות יכולים להופיע בדפי אינטרנט מרובים, כגון דפי קו, משתמש והרחבה. הוסף
[n] לשם האלמנט כדי לציין את המספר שמוצג בכרטיסייה עמוד.דוגמה: ה
<Dial_Plan_1_>רכיב מייצג את תוכנית החיוג עבור קו 1.
-
-
לכל תג אלמנט פתיחה חייב להיות תג רכיב סגירה תואם. לדוגמה:
<flat-profile> <Resync_On_Reset> Yes </Resync_On_Reset> <Resync_Periodic> 7200 </Resync_Periodic> <Profile_Rule>tftp://prov.telco.com: 6900/cisco/config/CP_xxxx_MPP.cfg </Profile_Rule> </flat-profile> -
תגי הרכיבים רגישים לאותיות רישיות.
-
תגי אלמנט ריקים מותרים ויתפרשו כהגדרת הערך לריק. הזן את תג רכיב הפתיחה ללא תג רכיב מתאים, והוסף רווח וקו נטוי קדימה לפני סוגר זווית הסגירה (>). בדוגמה זו, כלל פרופיל B ריק:
<Profile_Rule_B /> -
ניתן להשתמש בתג אלמנט ריק כדי למנוע החלפה של כל ערכים שסופקו על ידי המשתמש במהלך פעולת סנכרון מחדש. בדוגמה הבאה, הגדרות החיוג המהיר של המשתמש אינן משתנות:
<flat-profile> <Speed_Dial_2_Name ua="rw"/> <Speed_Dial_2_Number ua="rw"/> <Speed_Dial_3_Name ua="rw"/> <Speed_Dial_3_Number ua="rw"/> <Speed_Dial_4_Name ua="rw"/> <Speed_Dial_4_Number ua="rw"/> <Speed_Dial_5_Name ua="rw"/> <Speed_Dial_5_Number ua="rw"/> <Speed_Dial_6_Name ua="rw"/> <Speed_Dial_6_Number ua="rw"/> <Speed_Dial_7_Name ua="rw"/> <Speed_Dial_7_Number ua="rw"/> <Speed_Dial_8_Name ua="rw"/> <Speed_Dial_8_Number ua="rw"/> <Speed_Dial_9_Name ua="rw"/> <Speed_Dial_9_Number ua="rw"/> </flat-profile> -
השתמש בערך ריק כדי להגדיר את הפרמטר המתאים למחרוזת ריקה. הזן אלמנט פתיחה וסגירה ללא ערך ביניהם. בדוגמה הבאה, הפרמטר GPP_A מוגדר למחרוזת ריקה.
<flat-profile> <GPP_A> </GPP_A> </flat-profile> -
מתעלמים משמות אלמנטים לא מזוהים.
מאפייני פרמטר
מאפיינים אלה חלים על הפרמטרים:
כל הפרמטרים שלא צוינו על ידי פרופיל נותרים ללא שינוי בטלפון.
מתעלמים מפרמטרים לא מזוהים.
אם פרופיל הפורמט הפתוח מכיל מופעים מרובים של אותו תג פרמטר, המופע האחרון כזה יעקוף את המופעים הקודמים. כדי למנוע עקיפה בשוגג של ערכי תצורה עבור פרמטר, מומלץ שכל פרופיל יציין לכל היותר מופע אחד של פרמטר.
הפרופיל האחרון שעובד מקבל עדיפות. אם פרופילים מרובים מציינים את אותו פרמטר תצורה, הערך של הפרופיל האחרון מקבל עדיפות.
פורמטים של מחרוזות
מאפיינים אלה חלים על עיצוב המחרוזות:
הערות מותרות באמצעות תחביר XML רגיל.
<!-- My comment is typed here -->רווח לבן מוביל ואחורי מותר לקריאה אך מוסר מערך הפרמטר.
שורות חדשות בתוך ערך מומרות לרווחי רווחים.
כותרת XML של הטופס
<? ?> מותר, אך הטלפון מתעלם ממנו.להזנת תווים מיוחדים, השתמש בסיסי בריחה של תווי XML, כפי שמוצג בטבלה הבאה.
דמות מיוחדת
רצף בריחה של XML
& (אמפרסנד)
&
< (פחות מ)
<
> (גדול מ)
>
'(אפוסטרוף)
'
" (ציטוט כפול)
"
בדוגמה הבאה, מבטחים של תווים מוזנים כדי לייצג את הסמלים הגדולים מ- ופחות מ הנדרשים בכלל תוכנית חיוג. דוגמה זו מגדירה תוכנית חיוג למוקד מידע המגדירה את הפר <Dial_Plan_1_>מטר (כניסת שווה ל- (S0 <:18005551212>).
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>בריחות תווים מספריים, תוך שימוש בערכים עשרוניים והקסדצימליים (s.a.
(ו.), מתורגמים.קושחת הטלפון תומכת רק בתווי ASCII.
דחיסת פרופיל פתוח
שיטת הדחיסה הנתמכת היא אלגוריתם ה- gzip deflate (RFC1951). כלי השירות gzip וספריית הדחיסה המיישמת את אותו אלגוריתם (zlib) זמינים מאתרי אינטרנט.
כדי לזהות דחיסה, הטלפון מצפה שהקובץ הדחוס יכיל כותרת תואמת gzip. קריאה של כלי השירות gzip בפרופיל הפתוח המקורי יוצרת את הכותרת. הטלפון בודק את כותרת הקובץ שהורדת כדי לקבוע את פורמט הקובץ.
לדוגמה, אם profile.xml הוא פרופיל חוקי, קובץ profil.xml.gz מתק בל גם כן. אחת מהפקודות הבאות יכולה ליצור סוג פרופיל זה:
-
>gzip profile.xmlמחליף קובץ מקורי בקובץ דחוס.
-
>חתול profile.xml | gzip > פרופיל.xml.gzמשאיר את הקובץ המקורי במקום ומייצר קובץ דחוס חדש.
הצפנת פרופיל פתוח
ניתן להשתמש בהצפנת מפתח סימטרי להצפנת פרופיל תצורה פתוח, בין אם הקובץ דחוס ובין אם לאו. דחיסה, אם מיושמת, חייבת להיות מיושמת לפני ההצפנה.
שרת ההקצאה משתמש ב- HTTPS כדי לטפל בהקצאה ראשונית של הטלפון לאחר הפריסה. הצפנה מראש של פרופילי תצורה במצב לא מקוון מאפשרת שימוש ב- HTTP לסנכרון מחדש של פרופילים לאחר מכן. פעולה זו מפחיתה את העומס על שרת HTTPS בפריסות בקנה מידה גדול.
הטלפון תומך בשתי שיטות הצפנה עבור קבצי תצורה:
-
הצפנת AES-256-CBC
-
הצפנת תוכן HTTP מבוססת RFC 8188 עם הצפנת AES-128-GCM
יש להכניס מראש את המפתח או את חומר מפתחות הקלט (IKM) ליחידה במועד מוקדם יותר. ניתן לבצע אתחול של המפתח הסודי בצורה מאובטחת באמצעות HTTPS.
שם קובץ התצורה אינו דורש תבנית ספציפית, אך שם קובץ המסתיים בסיומת .cfg מציין בדרך כלל פרופיל תצורה.
הצפנת AES-256-CBC
הטלפון תומך בהצפנת AES-256-CBC עבור קבצי תצורה.
כלי ההצפנה OpenSSL, הזמין להורדה מאתרי אינטרנט שונים, יכול לבצע את ההצפנה. תמיכה בהצפנת AES 256 סיביות עשויה לדרוש איסוף מחדש של הכלי כדי לאפשר את קוד ה- AES. הקושחה נבדקה כנגד גרסת openssl-1.1.1d.
עבור קובץ מוצפן, הפרופיל מצפה שהקובץ יהיה בפורמט זהה לזה שנוצר על ידי הפקודה הבאה:
# example encryption key = SecretPhrase1234
openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg
# analogous invocation for a compressed xml file
openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg
אותיות קטנות -k קודמות למפתח הסודי, שיכול להיות כל ביטוי טקסט רגיל, ואשר משמש ליצירת מלח 64 סיביות אקראי. עם הסוד שצוין על ידי הטיעון -k, כלי ההצפנה שואב וקטור ראשוני אקראי של 128 סיביות ומפתח ההצפנה בפועל של 256 סיביות.
כאשר נעשה שימוש בצורת הצפנה זו בפרופיל תצורה, יש ליידע את הטלפון על ערך המפתח הסודי כדי לפענח את הקובץ. ערך זה מצוין כמתאם בכתובת האתר של הפרופיל. התחביר הוא כדלקמן, באמצעות כתובת URL מפורשת:
[--key “SecretPhrase1234”] http://prov.telco.com/path/profile.cfg
ערך זה מתוכנת באמצעות אחד מהפרמטרים של Profile_Rule.
מספר פרמטרי הקצאה עוברים הרחבת מאקרו באופן פנימי לפני הערכתם. שלב הערכה מוקדמת זה מספק גמישות רבה יותר בשליטה בפעילויות הסנכרון והשדרוג מחדש של הטלפון.
קבוצות פרמטרים אלה עוברות הרחבת מאקרו לפני ההערכה:
-
סנכרן מחדש _טריגר_*
-
כללי פרופיל*
-
יוג_XXX_הודעה
-
שדרוג_כלל
בתנאים מסוימים, כמה פרמטרים למטרות כלליות (GPP_*) עוברים גם הרחבת מאקרו, כפי שצוין במפורש בסעיף ארגומנטים לסנכרון מחדש אופציונלי להלן.
במהלך הרחבת מאקרו, התוכן של המשתנים הנזכרים מחליף ביטויים של הטופס $NAME ו- $ (NAME). משתנים אלה כוללים פרמטרים למטרות כלליות, מספר מזהי מוצר, טיימרים מסוימים לאירועים וערכי מצב הקצאה. לקבלת רשימה מלאה, ראה משתני הרחבת מאקרו תחת פרמטרי הקצאה.
בדוגמה הבאה, הביטוי $ (MAU) משמש להוספת כתובת MAC 000E08012345.
מנהל המערכת מזן: $ (MAU) config.cfg
הרחבת המאקרו המתקבלת עבור התקן עם כתובת MAC 000E08012345 היא: 000E08012345config.cfg
אם שם מאקרו אינו מזוהה, הוא נשאר ללא הרחבה. לדוגמה, השם STRANGE אינו מזוהה כשם מאקרו חוקי, בעוד MAU מזוהה כשם מאקרו חוקי.
מנהל המערכת מזן: $Strange$MAU.cfg
הרחבת המאקרו המתקבלת עבור מכשיר עם כתובת MAC 000E08012345 היא: $ Strange000E08012345.cfg
הרחבת מאקרו אינה מיושמת באופן רקורסיבי. לדוגמה, $$MAU" מתרחב ל- $MAU" ($$ מורחב) ואינו גורם לכתובת MAC.
התוכן של הפרמטרים המיוחדים, GPP_SA דרך GPP_SD, ממופים לביטויי המאקרו $ SA עד $ SD. פרמטרים אלה מורחבים רק מאקרו כארגומנט של האפשרויות --key, -- uid ו- -- pwd בכתובת URL לסנכרון מחדש.
ביטויים מותנים יכולים להפעיל אירועי סינכרון מחדש ולבחור מתוך כתובות אתרים חלופיות לפעולות סינכרון ושדרוג מחדש.
ביטויים מותנים מורכבים מרשימת השוואות, המופרדות על ידי המפעיל and. כל ההשוואות חייבות להתקיים כדי שהתנאי יהיה נכון.
כל השוואה יכולה להתייחס לאחד משלושת סוגי המילולים הבאים:
-
ערכים שלמים
-
מספרי גרסאות תוכנה או חומרה
-
מחרוזות מצוטטות כפולות
מספרי גרסאות
גרסת התוכנה עבור טלפון וידאו של סיסקו 8875 משתמשת בפורמט זה (כאשר BN הוא מספר הבנייה):
פונאוס י א. 1-0-1-0001 - בנ
כאשר yyyy מציין את דגם הטלפון או סדרת הטלפון; 1 היא הגרסה העיקרית; 0 היא הגרסה המשנית; 1-0001 היא גרסת המיקרו; ו- BN הוא מספר הבנייה.
מחרוזת ההשוואה חייבת להשתמש באותו פורמט. אחרת, תוצאת שגיאת ניתוח פורמט.
כאשר משווים את גרסת התוכנה, הגרסה העיקרית, הגרסה המינורית וגרסת המיקרו מושווים ברצף, והספרות השמאליות ביותר מקבלות עדיפות על אלה האחרונות. כאשר מספרי הגרסאות זהים, משווים את מספר הבנייה.
דוגמאות למספר גרסה תקף
PHONEOS-8875.1-0-1-0001-19
השוואה
ניתן להשוות מחרוזות מצוטטות לשוויון או אי שוויון. ניתן להשוות מספרים שלמים ומספרי גרסאות גם באופן אריתמטי. מפעילי ההשוואה יכולים לבוא לידי ביטוי כסמלים או כראשי תיבות. ראשי תיבות נוחים לביטוי המצב בפרופיל בפורמט פתוח.
|
מפעיל |
תחביר חלופי |
תיאור |
חל על אופרנדים שלמים וגרסאות |
חל על אופרנדים מחרוזת מצוטטים |
|---|---|---|---|---|
|
= |
eq |
שווה ל |
הן |
הן |
|
!= |
לא |
לא שווה ל |
הן |
הן |
|
< |
זה |
פחות מ |
הן |
לא |
|
<= |
לה |
פחות או שווה ל |
הן |
לא |
|
> |
gt |
גדול מ |
הן |
לא |
|
>= |
ge |
גדול או שווה ל |
הן |
לא |
|
AND |
|
ו |
הן |
הן |
חשוב לסגור משתני מאקרו במרכאות כפולות כאשר צפויה מחרוזת מילולית. אל תעשה זאת במקום בו צפוי מספר או מספר גרסה.
כאשר משתמשים בהם בהקשר של הפרמטרים Profile_Rule* ו- Upgrade_Rule, ביטויים מותנים חייבים להיות סגורים בתחביר "(expr)?" כמו בדוגמה זו של כלל השדרוג. זכור להחליף את BN במספר הבנייה של עומס הקושחה שלך כדי לשדרג אליו.
($SWVER ne PHONEOS-8875.1-0-1-0001-19)? http://ps.tell.com/sw/PHONEOS-8875.1-0-1-0001-BN.loads
אל תשתמש בתחביר הקודם עם סוגריים כדי להגדיר את הפרמטרים Resync_Trigger_*.
השתמש בתחביר כתובת URL סטנדרטית כדי לציין כיצד לאחזר קבצי תצורה ועומסי קושחה בפרמטרים Profile_Rule* ו- Upgrade_Rule, בהתאמה. התחביר הוא כדלקמן:
[סכימה://] [שרת [:יציאה]] נתיב קובץ
כאשר התוכנית היא אחד הערכים הבאים:
-
tftp
-
הויטפ
-
HTTPS
אם התוכנית מו שמטת, ההנחה היא tftp. השרת יכול להיות שם מארח מוכר ב- DNS או כתובת IP מספרית. היציאה היא מספר יציאת UDP או TCP היעד. נתיב הקובץ חייב להתחיל בספריית השורש (/); זה חייב להיות נתיב מוחלט.
אם השרת חסר, נעשה שימוש בשרת tftp שצוין באמצעות DHCP (אפשרות 66).
עבור כללי שדרוג, יש לציין את השרת.
אם היציאה חסרה, נעשה שימוש ביציאה הסטנדרטית עבור התוכנית שצוינה. Tftp משתמש ביציאת UDP 69, http משתמש ביציאת TCP 80, https משתמש ביציאת TCP 443.
נתיב קובץ חייב להיות נוכח. זה לא בהכרח צריך להתייחס לקובץ סטטי, אבל יכול להצביע על תוכן דינמי המתקבל באמצעות CGI.
הרחבת מאקרו חלה בתוך כתובות אתרים. להלן דוגמאות לכתובות URL חוקיות:
/$MA.cfg
/cisco/cfg.xml
192.168.1.130/profiles/init.cfg
tftp://prov.call.com/cpe/cisco$MA.cfg
http://neptune.speak.net:8080/prov/$D/$E.cfg
https://secure.me.com/profile?Linksys
בעת שימוש באפשרות DHCP 66, התחביר הריק אינו נתמך על ידי כללי השדרוג. זה חל רק על כלל פרופיל*.
הצפנת תוכן HTTP מבוססת RFC 8188
הטלפון תומך בהצפנת תוכן HTTP מבוססת RFC 8188 עם הצפנת AES-128-GCM עבור קבצי תצורה. בשיטת הצפנה זו, כל ישות יכולה לקרוא את כותרות ההודעות HTTP. עם זאת, רק הישויות שמכירות את חומר מפתחות הקלט (IKM) יכולות לקרוא את המטען. כאשר הטלפון מסופק עם ה- IKM, הטלפון ושרת ההקצאה יכולים להחליף קבצי תצורה בצורה מאובטחת, תוך מתן אפשרות לרכיבי רשת של צד שלישי להשתמש בכותרות ההודעות למטרות ניתוח וניטור.
פרמטר תצורת XML IKM_HTTP_EncryptContent מחזיק את ה- IKM בטלפון. מטעמי אבטחה, פרמטר זה אינו נגיש בדף האינטרנט של ניהול הטלפון. זה גם לא גלוי בקובץ התצורה של הטלפון, אליו ניתן לגשת מכתובת ה- IP של הטלפון או מדוחות התצורה של הטלפון שנשלחו לשרת ההקצאה.
אם ברצונך להשתמש בהצפנה מבוססת RFC 8188, ודא את הפעולות הבאות:
-
ספק את הטלפון עם ה- IKM על ידי ציון ה- IKM עם פרמטר XML
IKM_HTTP_EncryptContent בקובץ התצורה שנשלח משרת הקצאה לטלפון. -
אם הצפנה זו מוחלת על קבצי התצורה שנשלחו משרת ההקצאה לטלפון, ודא שכותרת HTTP לקי דוד תוכן בקובץ התצורה כוללת aes128gcm.
בהיעדר כותרת זו, שיטת AES-256-CBC מקבלת עדיפות. הטלפון מיישם פענוח AES-256-CBC אם מפתח AES-256-CBC קיים בכלל פרופיל, ללא קשר ל- IKM.
-
אם ברצונך שהטלפון יחיל הצפנה זו על דוחות התצורה שהוא שולח לשרת ההקצאה, ודא שאין מפתח AES-256-CBC שצוין בכלל הדוח.
ארגומנטים אופציונליים לסנכרון מחדש
ארגומנטים אופציונליים, מפתח, uid ו- pwd, יכולים להקדים את כתובות האתרים שהוזנו בפרמטרים Profile_Rule*, המוקפים יחד בסוגריים מרובעים.
האפשרות
המפתח עצמו מוגדר כמחרוזת בעקבות המונח --key אומרת לטלפון שקובץ התצורה שהוא מקבל משרת ההקצאה מוצפן בהצפנת AES-256-CBC, אלא אם כותרת קידוד התוכן בקובץ מציינת הצפנת aes128 gcm.--key. ניתן לסגור את המפתח במרכאות כפולות (") באופן אופציונלי. הטלפון משתמש במפתח כדי לפענח את קובץ התצורה.
דוגמאות לשימוש
[--key VerySecretValue]
[--key “my secret phrase”]
[--key a37d2fb9055c1d04883a0745eb0917a4]
הארגומנטים האופציונליים בסוגריים מורחבים מאקרו. פרמטרים ייעודיים, GPP_SA דרך GPP_SD, מורחבים מאקרו למשתני מאקרו, $ SA עד $ SD, רק כאשר הם משמשים כארגומנטים של אפשרות מפתח. ראה דוגמאות אלה:
[--key $SC]
[--key “$SD”]
בפרופילים בפורמט פתוח, הארגומנט ל - --key חייב להיות זהה לארגומנט לאפשרות -k הני תנת ל- openssl.
ניתן להשתמש באפשרויות ה- uid ו- pwd כדי לציין את מזהה המשתמש והסיסמה שיישלחו בתגובה לאתגרי אימות HTTP Basic ו- Digest כאשר תתבקש כתובת האתר שצוינה. הארגומנטים האופציונליים בסוגריים מורחבים מאקרו. פרמטרים ייעודיים, GPP_SA דרך GPP_SD, מורחבים מאקרו למשתני מאקרו, $ SA עד $ SD, רק כאשר הם משמשים כארגומנטים של אפשרות מפתח. ראה דוגמאות אלה:
GPP_SA = MyUserID
GPP_SB = MySecretPassword
[--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml
לאחר מכן יתרחב ל:
[--uid מזהה משתמש שלי --pwdMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml
סוגי נתונים
סוגי נתונים אלה משמשים עם פרמטרים של פרופיל תצורה:
-
{א, ב, ג,...} -בחירה בין א, ב, ג,...
-
בול — ערך בוליאני של "כן" או "לא".
-
CADscript - תמליל מיני המציין את פרמטרי הקצב של אות. עד 127 תווים.
תחביר: S 1 [; S 2], שם:
-
S i =D i (ב- i,1/off i,1 [, ב- i, 2/off i,2 [, על i, 3/OFF i, 3 [, על i,4/off i, 4 [, על i, 5/OFF i,5 [, על i ,6 /off i ,6]]]) והוא ידוע כקטע.
-
ב - i, j ו- off i, j הם משך ההפעלה/כיבוי בשניות של קט ע. i = 1 או 2, ו- j = 1 עד 6.
-
D i הוא משך הזמן הכולל של הקטע בשניות.
לכל משך הזמן יכול להיות עד שלושה מקומות עשרוניים כדי לספק רזולוציה של 1 ms. התו הכללי "*" מייצג משך זמן אינסופי. הקטעים בתוך קטע מושמעים לפי הסדר וחוזרים על עצמם עד להפעלת משך הזמן הכולל.
דוגמה 1:
60(2/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60 s Number of Segments = 1 Segment 1: On=2s, Off=4s Total Ring Length = 60sדוגמה 2 - טבעת ייחודית (קצרה, קצרה, קצרה, ארוכה):
60(.2/.2,.2/.2,.2/.2,1/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60s Number of Segments = 4 Segment 1: On=0.2s, Off=0.2s Segment 2: On=0.2s, Off=0.2s Segment 3: On=0.2s, Off=0.2s Segment 4: On=1.0s, Off=4.0s Total Ring Length = 60s -
-
DialPlanScript — תחביר סקריפטים המשמש לציון תוכניות חיוג של קו 1 ושורה 2.
-
Float <n>— ערך נקודה צפה עם עד n מקומות עשרוניים.
-
FQDN — שם דומיין מוסמך לחלוטין. זה יכול להכיל עד 63 תווים. דוגמאות לכך הן כדלקמן:
סיפ.Cisco.com:5060 או 109.12.14. 12:12345
סיפ.Cisco.com או 109.12.14.12
-
FreqScript - תמליל מיני המפרט את פרמטרי התדר והרמה של צליל. מכיל עד 127 תווים.
תחביר: F 1 @L 1 [, F 2 @L 2 [, F 3 @L 3 [, F 4 @L 4 [, F 5 @L 5 [, F 6 @L 6]]]], איפה:
-
F 1 —F 6 הם תדרים ב- Hz (מספרים שלמים לא חתומים בלבד).
-
L 1 —L 6 הן רמות מקבילות ב- dBm (עם עד מקום עשרוני אחד).
רווחים לבנים לפני ואחרי הפסיק מותרים אך אינם מומלצים.
דוגמה 1 - צליל המתנה לשיחה:
440@-10 Number of Frequencies = 1 Frequency 1 = 440 Hz at –10 dBmדוגמה 2 - צליל חיוג:
350@-19,440@-19 Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm -
-
IP- כתובת IPv4 חוקית בצורת x.x.x.x, כאשר x הוא בין 0 ל 255. דוגמה: 10.1.2.100.
-
מזהה משתמש — מזהה משתמש כפי שהוא מופיע בכתובת URL; עד 63 תווים.
-
טלפון — מחרוזת מספר טלפון, כגון 14081234567, *69, *72, 345678; או כתובת אתר כללית, כגון 1234 @10 .10.10. 100:5068 או jsmith@Cisco.com. המחרוזת יכולה להכיל עד 39 תווים.
-
PHTMPLT - תבנית מספר טלפון. כל תבנית עשויה להכיל דפוס אחד או יותר המופרדים בפסיק (,). מתעלמים מרווח לבן בתחילת כל תבנית. "?" ו- "*" מייצגים תווים כלליים. כדי לייצג פשוטו כמשמעו, השתמש ב%xx. לדוגמה, %2a מייצג*. התבנית יכולה להכיל עד 39 תווים. דוגמאות: "1408*, 1510*", "1408123???? , 555? 1.".
-
יציאה — מספר יציאת TCP/UDP (0-65535). ניתן לציין אותו בפורמט עשרוני או hex.
-
ProvisioningRuleSyntax — תחביר סקריפטים המשמש להגדרת כללי סינכרון מחדש של תצורה ושדרוג קושחה.
-
PWRLevel — רמת הספק המתבטאת ב-dBm עם מקום עשרוני אחד, כגון —13.5 או 1.5 (dBm).
-
RSCTMPLT — תבנית של קוד מצב תגובת SIP, כגון "404, 5*", "61?" , "407, 408, 487, 481". זה יכול להכיל עד 39 תווים.
-
Sig <n>- ערך n-bit חתום. ניתן לציין אותו בפורמט עשרוני או hex. סימן "-" חייב להקדים ערכים שליליים. סימן + לפני ערכים חיוביים הוא אופציונלי.
-
קודי כוכב - קוד הפעלה לשירות משלים, כגון *69. הקוד יכול להכיל עד 7 תווים.
-
Str <n>—מחרוזת כללית עם עד n תווים לא שמורים.
-
זמן <n>- משך הזמן בשניות, עם עד n מקומות עשרוניים. מתעלמים ממקומות עשרוניים נוספים שצוינו.
-
ToneScript — תמליל מיני המציין את פרמטרי התדר, הרמה והקצב של צליל התקדמות שיחה. התסריט עשוי להכיל עד 127 תווים.
תחביר: סקריפט תדר; ז 1 [; ז 2].
החלק Z 1 דומה לקטע S 1 ב- CADScript, פרט לכך שכל קטע הפעלה/כיבוי ואחריו פרמטר של רכיבי תדר: Z 1 = D 1 (ב- i,1/off i,1 /f i, 1 [, ב- i, 2/off i, 2/f i, 2 [, ב- i, 3/off i, 3 /f i, 3 [, ב- i, 4/off i, 4 /f i, 4 [, ב- i, 5/כבוי i, 5/f i, 5 [, ב- i 6/כבוי i, 6/f i,6]]]]) איפה:
-
f i, j = נ 1 [+נ 2] +נ 3 [+נ 4 [+נ 5 [+נ 6]]]].
-
1 < n k < 6 מציין את רכיבי התדר ב- FreqScript המשמשים באותו קטע.
אם נעשה שימוש ביותר מרכיב תדר אחד בקטע, הרכיבים מסוכמים יחד.
דוגמה 1 - צליל חיוג:
350@-19,440@-19;10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 1 Cadence Section 1: Section Length = 10 s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 10sדוגמה 2 - צליל גמגום:
350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 2 Cadence Section 1: Section Length = 2s Number of Segments = 1 Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2 Cadence Section 2: Section Length = 10s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 12s -
-
Uns <n>- ערך n-bit לא חתום, כאשר n = 8, 16 או 32. ניתן לציין אותו בפורמט עשרוני או hex, כגון 12 או 0x18, כל עוד הערך יכול להתאים ל- n סיביות.
שמור את אלה בחשבון:
- <Par Name>מייצג שם פרמטר תצורה. בפרופיל, התג המתאים נוצר על ידי החלפת הרווח בקו תחתון "_", כגון Par _Name.
- שדה ערך ברירת מחדל ריק מרמז על מחרוזת ריקה < "" >.
- הטלפון ממשיך להשתמש בערכים שהוגדרו האחרונים עבור תגים שאינם קיימים בפרופיל נתון.
- תבניות מושוות לפי הסדר שניתן. ההתאמה הראשונה, לא הקרובה ביותר, נבחרה. שם הפרמטר חייב להתאים בדיוק.
- אם ניתנת יותר מהגדרה אחת לפרמטר בפרופיל, ההגדרה האחרונה בקובץ היא זו שנכנסת לתוקף בטלפון.
- מפרט פרמטר עם ערך פרמטר ריק מאלץ את הפרמטר בחזרה לערך ברירת המחדל שלו. כדי לציין מחרוזת ריקה במקום זאת, השתמש במחרוזת הריקה "" כערך הפרמטר.