1. نظرة عامة

This document provides a brief introduction to the automatic configuration details for Flying Voice products, which support three methods: HTTP, HTTPS with client certificates, and TFTP with option 66. All Flying Voice products support configuration, and this document is based on the IP542N and G502N example.
With option 66, the new product will automatically resynchronize (short for resync) to a special configuration file using a TFTP server. The product will request a resync configuration file after obtaining an IP address from a DHCP server, and the Flying Voice product that first reaches the LAN will resync to the local TFTP server and configure the parameters as set.
Furthermore, Flying Voice products support remote deployment, the user only needs to set the configuration file base value and resynchronization parameters, and the products will automatically resynchronize to the remote. HTTP/HTTPS/TFTP server.

2. تكوين معلمات الملف الشخصي

2.1. إعداد معلمات التكوين

الصورة التالية هي صفحة إعداد التهيئة، وتصف جميع المعلمات المتعلقة بالتهيئة.
20130228084918677.jpg
اسم المعلمة الوصف القيمة الافتراضية
تمكين التهيئة تمكين أو تعطيل وظائف التهيئة. Enable
إعادة المزامنة
On
إعادة ضبط
يؤدي إلى إعادة مزامنة بعد كل إعادة تشغيل باستثناء إعادة التشغيل الناجمة عن المعامل
تحديثات
وتحديثات البرنامج الثابت.
Enable


إعادة المزامنة
عشوائي
تأخير
The maximum value for the random waiting period before the device
creates
the initial connection to the auto‑configuration server. This delay is only effective on
the initial
attempt to configure after the device is powered on or reset. The delay is
a semi‑random number between zero and this value.
This parameter is in units of 1 second; the default value 40 represents 40
seconds. This feature is disabled when this parameter is set to zero.
This feature can be used to prevent overloading the auto‑configuration server
when
a large number of devices are started at the same time.
40 ثانية
إعادة المزامنة
دوري
الفاصل الزمني بين عمليات المزامنة الدورية مع خادم التهيئة.
اضبط هذه المعلمة على الصفر لتعطيل المزامنة الدورية.
3600 ثانية
Resync error
Retry Delay
If the last sync fails, the IP542N will retry syncing after “Resync Error Retry”.
Delay” time
3600 ثانية
قسرية
إعادة المزامنة
تأخير
Maximum delay (in seconds) that a VOIP ATA or IP phone waits before executing
Resynchronization.
The device does not resynchronize while any of its lines are active. Because resynchronization
may take several seconds, it is recommended to wait until the device has been inactive for
a prolonged period before resynchronizing. This allows the user to make consecutive calls
without interruption.
The device has a timer that starts counting down when all of its lines become inactive.
This parameter is the initial value of the counter. Resynchronization events are delayed until
this counter reaches zero.
14,400 ثانية
إعادة المزامنة بعد
ترقية
Resynchronization is triggered after each firmware upgrade attempt. Enable
الخيار 66 If DHCP 66 option is enabled to override the server. If enabled, the parameter 'Profile
The rule has no effect.
نعم
إعداد
ملف
الاسم
يُستخدم اسم ملف التكوين لوضع التهيئة الداخلية فقط. عند استخدام TFTP
مع خيار 66 لتحقيق التهيئة، يجب على المستخدم إدخال اسم ملف التكوين الصحيح
في صفحة الويب الخاصة بـ IP542N. عند تعطيل Option 66، لا يؤثر هذا المعامل.
مختلف
المنتجات لديها
مختلف
القيمة الافتراضية،
على سبيل المثال:I
P542N.conf


ملف تعريف
قاعدة
هذا المعامل هو برنامج نصي للملف الشخصي يُقيم إلى أمر إعادة مزامنة التهيئة.
الأمر هو عملية TCP/IP وعنوان URL مرتبط. عملية TCP/IP
يمكن أن تكون TFTP أو HTTP أو HTTPS ، إذا أراد المستخدم استخدام هذه الطريقة لتحقيق التهيئة التلقائية،
يجب على المستخدم تعطيل الخيار 66.
يمكن لاسم الملف أن يحتوي على ماكرو، مثل $MA، الذي يتوسع إلى عنوان MAC للجهاز
العنوان.
مثل: 192.168.20.17
فارغ
ترقية
Enable
Firmware upgrades can be performed independently of resynchronization procedures. Enable

Upgrade error
Retry Delay
Upgrade retry interval (in seconds) is applied in case of upgrade failure.
The device temporarily errors on firmware upgrade that activates after firmware failure
retry attempt. The timer is initialized with the value in this parameter. Next
Firmware upgrade occurs when this timer counts down to zero.
3600 ثانية.

قاعدة التحديث
This parameter is a firmware upgrade program with the same profile file structure
It specifies upgrade conditions and firmware (Firmware) URLs.
Example: 192.168.20.17
فارغ

2.2. قاعدة الملف الشخصي وملف التحديث

صيغة قاعدة الملف الشخصي وقاعدة التحديث كما يلي: [scheme://][IP الخادم أو النطاق[:port]]/مسار الملف ♦بينما المخطط هو أحد القيم التالية: http https tftp مسار الملف: هذا دليل افتراضي إلى الخادم. ♦ ينطبق توسيع الماكرو مع عناوين URL. ♦الأمثلة التالية هي مثالان لعناوين URL صالحة: tftp://prov.call.com/cpe/CW$MA.conf neptune.speak.net

3. توسيع ماكرو

The IP542N supports macro expansion. The available variables for macro replacement are MA, MAU, MAC, PN, SN, IP, SWVER, and HWVER. Macro variables are invoked with a '$' prefix (e.g., $MAC). Replacement works even inside a string surrounded by quotes, without needing additional escaping. If a variable name is immediately followed by an alphanumeric character, enclose the variable name with . Parentheses (e.g., ‘$(MAC).conf’). The following table is the description diagram for macro expansion.
اسم الماكرو توسيع الماكرو
$ Model $$ expands to one letter $ .
Model $$MAU expands to $0021F2011B19.
Model $MAU expands to 0021F2011B19.
MA MAC address using lowercase hexadecimal digits, e.g., 0021f2011b19.
MAU عنوان MAC باستخدام أرقام سداسية عشرية بحروف كبيرة، مثال 0021F2011B19.
MAC عنوان MAC باستخدام أرقام سداسية عشرية صغيرة، والنقطتين لفصل أزواج الأرقام السداسية، لـ
مثال 00:21:f2:01:1b:19.
PN Product name, e.g., G502 or VOIP ATA.
SN رقم السيريال، على سبيل المثال E3C08109000051
IP WAN IP address, e.g., 201.45.12.89
SWVER إصدار البرنامج، مثال v3.3.8
HWVER إصدار العتاد، مثال v1.0.1
منتجات Flying Voice يمكنها دعم 4 طرق لتحقيق التوسيع الكلي:
♦ When expanding a macro, expressions of the form $NAME and $(NAME) are replaced with their contents from the named variables. For example, IP542N with MAC address 0021F2011B19,$(MAU)config.cfg expands to 0021F2011B19config.cfg; ♦ If a macro name is not recognized, it remains unexpanded. For example, the name STRANGE is not recognized as a valid macro name, while MAU is recognized as a valid macro name; so $STRANGE$MAU.cfg expands macro‑wise to $STRANGE0021F2011B19.cfg;
♦ Macro expansion is not applied repeatedly. For example, $$MAU expands to $MAU (the $$ expanded), not 0021F2011B19, for the device with the mentioned MAC address.
♦ Also, a macro expression can qualify for expansion so that only part of the macro variable is used instead of its full value, such as part of a MAC address. The syntax for expanding a sub‑macro is $(NAME:p) and $(NAME:p:q), where p and q are non‑negative integers. The resulting sub‑macro variable expands starting at character offset p, with length q (or to the end of the string if q is not specified).
For example, for a device titled MAC that is calculated repeatedly, the expression $(MAU:4) expands the macro to the string F2011B19, while the expression $(MAU:8:2) expands the macro to the string 1B. The following image is one example of macro expansion deployment:
20130228084757382.jpg

4. Configuration using HTTP/HTTPS/TFTP

4.1. Configuration via HTTP

① Install an HTTP server, we use Apache, set up httpd-2.2.15-win32.msi by default, then you can see the Apache icon in the login item as follows:
20130228085512834.jpg ② Open C:/Program Files/Apache Software Foundation/Apache2.2/conf/httpd.conf, then make the following changes: ♦DocumentRoot "C:/Program Files/Apache Software Foundation/Apache2.2/htdocs" to DocumentRoot "D:/conf/" ♦ <Directory “C:/Program Files/Apache Software Foundation/Apache2.2/htdocs”> to <Directory "D:/conf/">
③ Create a conf folder on drive D. Place the configuration file in D:/conf/. (When using macro expansion, we can set the file name based on each product's MAC address, e.g., fv0021f2011b19.conf).
④ Restart Apache. ⑤ التحقق من تثبيت الخادم افتح المتصفح وأدخل عنوان URL: xn--mgb9azbbi IP لخادم HTTP أو النطاق. If you successfully create an HTTP server, you can link the URL well and the user can see all files in دليل D:/conf/
⑥ Log in to the product's web page, then go to the 'provision' column, and fill in the URL in the file base, such as flyingvoice.com and disable option 66 because the default value is 'enable', click Save to submit changes and restart the product. With the new transaction settings, the The device will sync with the configuration file specified by the URL. For example:
20130228090612973.jpg
⑦ If you want to perform a firmware upgrade using configuration, place the upgrade file in D:/conf/, and fill leave the update URL empty, then save the changes and reboot IP542N.
20130228090719788.jpg IP542N will complete the firmware upgrade automatically. إشعار: ♦ يجب على المستخدم تغيير قيمة DBID_DBASE_VERSION بعد كل تعديل، أو المنتج لن يتم إعادة المزامنة. أبسط طريقة هي إضافة واحد إلى المعامل. ♦ يجب على المستخدم ملاحظة حالة الخيار 66.

4.2. التهيئة عبر HTTPS

① تثبيت خادم HTTP، نستخدم Apache، تثبيت httpd-2.2.15-win32.msi بشكل افتراضي، ثم يمكنك رؤية أيقونة Apache في عناصر تسجيل الدخول كما هو موضح أدناه:
② نسخ الملفات الثلاثة cacert.pem、sslservercert.pem وsslserverkey.pem إلى C:/Program Files/Apache Software Foundation/Apache2.2/conf/؛
③ افتح C:/Program Files/Apache Software Foundation/Apache2.2/conf/httpd.conf ثم قم بالتغييرات التالية:
u DocumentRoot "C:/Program Files/Apache Software Foundation/Apache2.2/htdocs" to DocumentRoot "D:/conf/" u <Directory “C:/Program Files/Apache Software Foundation/Apache2.2/htdocs”> to <Directory "D:/conf/">
④ Open C:/Program Files/Apache Software Foundation/Apache2.2/conf/extra/httpd-ssl.conf, and make the following changes:
◆DocumentRoot "C:/Program Files/Apache Software Foundation/Apache2.2/htdocs" to DocumentRoot "D:/conf/" ◆Search for #SSLCACertificateFile and set it as follows: SSLCACertificateFile "C:/Program Files/Apache Software Foundation/Apache2.2 /conf/cacert.pem" (remember to delete the '#' character) ◆ Search for SSLCertificateFile and set it as follows: SSLCertificateFile "C:/Program Files/Apache Software Foundation/Apache2.2/conf/ sslservercert.pem"
◆ Find SSLCertificateKeyFile and set it as follows:SSLCertificateKeyFile "C:/Program Files/Apache Software Foundation/Apache2.2/ conf/sslserverkey.pem"
⑤ Create a folder ‘conf’ on drive D. Place the configuration file in D:/conf/. (When using macro expansion, we can set the file name based on the MAC address of each product, e.g., fv0021f2011b19.conf).
⑥ Restart Apache.
⑦ Verify server installationOpen the browser and enter the URL: ip address or HTTPS server domain. If you have created http The server is successfully connected, the URL can be linked properly, and the user can see all files in the D:/conf/ directory⑧ Download certificate files
افتح صفحة الإدارة/الأمان لمنتجك، واختر Provision CA Certification من عمود نوع التحديث، ثم اضغط على 20130228093437151.jpgClick the key to select the cacert.pem directory 20130228093457769.jpg To start the download. Use the same methods to update the configuration client certificate (sslclientcert.pem) and the configuration private key (sslclientkey.pem). Once the download is complete, the web page will change to the following:
20130228093611609.jpg ملاحظة: إذا كان هناك 20130228093628631.jpg الطلب، يرجى ملء 'أي شيء'.
⑨ سجّل الدخول إلى صفحة الويب للمنتج، ثم انتقل إلى عمود ‘provision’، املأ URL في قاعدة الملف، مثل flyingvoice.com عطل الخيار 66 وانقر حفظ لتقديم التغييرات وإعادة تشغيل المنتج. مع إعدادات المعاملات الجديدة، سيعيد الجهاز مزامنة ملف التكوين المحدد بواسطة URL. إشعار: ♦ يجب على المستخدم تغيير قيمة DBID_DBASE_VERSION بعد كل تعديل، أو المنتج لن يتم إعادة المزامنة. أبسط طريقة هي إضافة واحد إلى المعامل. ♦ يجب على المستخدم ملاحظة حالة الخيار 66. ♦ لا يمكن للمستخدم تنفيذ التحديث عبر HTTPS، يرجى الرجوع إلى HTTP أو TFTP لتنفيذه.

4.3. Configuration using DHCP and TFTP

4.3.1. Install TFTP server and DHCP server

(1) Install TFTP server ① ضع ملف التكوين (مثال: Configfile.cfg) و tftpd32.exe في نفس الدليل؛ ② افتح tftpd32.exe، واضغط للتحقق مما إذا كان هناك Configfile.cfg ورؤية عنوان خادم tftp (العنوان هو 192.168.20.151 في الصورة التالية)
20130228094005826.jpg
③ افتح CMD، أدخل "tftp Server IP get Configfile.cfg"، تشير النتيجة "Transfer Successful" إلىتم إنشاء خادم tftp بنجاح.
20130228094020129.jpg (2) Install DHCP server

الصورة 4.3.1
♦ IP address pool start: the IP address that will be distributed to
DHCP client.
♦ Pool size: the number of IP addresses you want to distribute.
♦ WINS/DNS server: the IP address of the DHCP server, usually we use the computer's IP
address.
♦ Default gateway: the default gateway for the DHCP server, usually we use the computer's IP.
address.
♦ Subnet mask: usually 255.255.255.0
♦ Additional option: option 66 and the server IP address.
في كل مرة تنتهي فيها من إعداد خادم DHCP، اضغط زر حفظ لتقديم التغييرات.
4.3.2. Internal provisioning with DHCP and TFTP
عند نشر عدد كبير من هواتف IP على الشبكة، من الأفضل استخدام DHCP 'option 66' لتوجيه الهاتف تلقائيًا إلى عنوان URL التهيئة وغيرها من المعلمات.
① ضمن بيئة LAN، قم بتوصيل حاسوب و IP542N إلى موزع أو محول أو راوتر صغير. ② On the computer, install and enable the TFTP server as described in section 4.3.1. ③ On the TFTP server, set up the DHCP server as referenced in 4.3.1, and fill in the blanks in 20130228094222248.jpg With 66 and IP server address. The IP address is the address from which the TFTP server will request the configuration file.
④ Ensure the configuration file is placed in the directory. For example, in image 4.3.1, the directory is D:\tftp.
⑤ Ensure that the configuration file name is the same as the default file name on the WEB. In the case of device IP542N, the default configuration file name for Option 66 is IP542N.conf, and the configuration file in the directory must also be IP542N.conf. ⑥ Reboot the device, then log into the web interface to verify that the parameters have been changed correctly. After the IP542N has finished rebooting, it obtains the configuration file from the TFTP server and reboots automatically again to configure new settings. Note: The user must enter the correct configuration file name on the IP542N web page, otherwise the IP542N will not be able to complete the configuration.
4.3.3. Remote configuration using TFTP
إذا كنت بحاجة إلى حل لا يتطلب خيار DHCP "Option 66"، يمكنك أيضًا إدخال عنوان URL للتهيئة يدويًا في كل هاتف عبر صفحة الويب الخاصة به.
① ضمن بيئة LAN، قم بتوصيل حاسوب و IP542N إلى موزع أو محول أو راوتر صغير. ② افتح صفحة IP542N على الويب، عطل الخيار 66 واملأ قاعدة الملف الشخصي واسم ملف التكوين. على سبيل المثال: 20130228095822439.png
③ Press the save button and reboot IP542N; once IP542N receives the configuration file, it will configure automatically. If you want to use TFTP over the Internet, it’s the same. Disable option 66 and fill in the appropriate configuration file name and base, such as tftp://www.flyingvoice.com/fv$(MAU).conf.
إشعار:
♦ The user must ensure that the TFTP server is reachable over the Internet when using TFTP with the Internet. ♦ Option 66 and the Profile Rule have somewhat the same function, which is to configure the device to download the configuration file. However, Option 66 cannot work at the same time as the Profile Rule. In other words, only one works at a time. On the other hand, Option 66 has higher priority than the Profile Rule. Therefore, if the Profile Rule is preferred, Option 66 should be set to "disable" or set DBID_PRV_OPTION66_ENABLED=0 in the configuration file.
According to the upgrade, it is the same. When you finish setting up the TFTP server, place the upgrade file in The same directory where TFTP32.exe is stored, such as tftp://192.168.1.1/IP542N.bin. Save changes and reboot the device. The update will start automatically 20130228100048939.png إشعار: ♦ Users must change the DBID_DBASE_VERSION value after each modification, or the product لن يتم إعادة المزامنة. أبسط طريقة هي إضافة واحد إلى المعامل. ♦ يجب على المستخدمين ملاحظة حالة الخيار 66، بغض النظر عن طريقة تنفيذ التهيئة، بما في ذلك HTTP, HTTPS and TFTP.

4.4. تشفير ملف الإعدادات

استخدام ملف encrypt لتشفير param.conf في Linux بالأمر:[./encrypt_file] [key] [source file name] [destination file name]مثال:# المفتاح = 123456، ملف المصدر هو config.cfg، ملف الوجهة هو config-enc.cfg، الأمر هو:
20130228100137315.png عند استخدام هذا الشكل من التشفير لتشفير ملف تعريف التكوين، يجب إبلاغ المنتج The secret key value to decrypt the file. This value is specified as a parameter in the URL of the appropriate profile using [--key ‘key’]. The syntax is as follows, using an explicit URL: [--key 123456]tftp://server IP or domain/path/param-enc.conf على سبيل المثال: 20130228100217117.png
إذا أدخلت كلمة مرور خاطئة، لن يحصل IP542N على ملف التكوين عند إعادة المزامنة مع الخادم. احفظ كلمة مرورك بعناية. وإذا أدخلت عنوان IP خاطئ، لن يعيد IP542N المزامنة مع خادم HTTP/TFTP/HTTPS. أي معلومات خاطئة قد تؤثر على النتيجة. لذا، انتبه إلى قاعدة الملف الشخصي وغيرها من المعلومات التي تحتاج إلى إدخالها.

5. مقدمة ملف التكوين

The contents of the param.conf configuration file are as follows

ملاحظة: ① كل مرة بعد تعديل param.conf، يجب تغيير قيمة DBID_DBASE_VERSION،

أسهل طريقة هي إضافة واحد إلى المعامل بعد كل تعديل. ② ‘0’ يعني ‘تعطيل’، ‘1’ يعني ‘تمكين’. ③ غيّر القيمة خلف “=” لتغيير الإعدادات
DBID_DBASE_VERSION=2207 / Each time, the user tests the TFTP/HTTP/HTTPS server, you must
change the value (add 1 each time)/
DBID_IPMODE=0 20130228100348781.png
DBID_FIXED_IP_ADDR=192.168.10.207 /static IP address/
DBID_SUBNET_MASK=255.255.255.0 /قناع الشبكة الفرعية/
DBID_DFLT_GW_IP_ADDR=192.168.10.1 /Default Gateway/
DBID_SIP_ENABLE=1 0 0 0 /"1" enable SIP, "0" disable. Four consecutive digits
Represent line1, line2, line3, line4. Use tabs to separate.
DBID_WEB_SIP_SERVER=192.168.10.200 /قيمة عنوان IP لخادم SIP/
DBID_WEB_SIP_SERVER_PORT=5060 /SIP server port value/
DBID_WEB_SIP_OUTBOUND=192.168.10.201 /قيمة عنوان IP للوكيل الخارجي الاحتياطي/
DBID_WEB_SIP_OUTBOUND_PORT=5060 قيمة منفذ BACKUP OUTBOUND PROXY
DBID_WEB_SIP_OUTBOUND_BACKUP=192.168.10.202 /قيمة عنوان IP للوكيل الصادر/
DBID_WEB_SIP_OUTBOUND_BACKUP_PORT=5060 /OUTBOUND PROXY port value /
DBID_SIP_DIS_NAME=23103_name /اسم حساب sip
DBID_SIP_PHONE_NUM=23103 /قيمة رقم الهاتف.
DBID_SIP_ACCOUNT=23103 /تعيين قيمة الحساب لكل خط./
DBID_SIP_PASSWORD=23103 تعيين قيمة كلمة المرور لكل سطر
DBID_PRV_OPTION66_ENABLED=0 = 0, disable DHCP option66, the URL will be in profile_rule
user;
=1, enable DHCP 66, the URL will be in profile_rule
deleted.