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. إعداد معلمات التكوين
الصورة التالية هي صفحة إعداد التهيئة، وتصف جميع المعلمات المتعلقة بالتهيئة.
| اسم المعلمة | الوصف | القيمة الافتراضية |
| تمكين التهيئة | تمكين أو تعطيل وظائف التهيئة. |
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:
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:
② 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:
⑦ 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.
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 من
عمود نوع التحديث، ثم اضغط على
Click the key to select the cacert.pem directory
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:
Click the key to select the cacert.pem directory
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:
ملاحظة: إذا كان هناك
الطلب، يرجى ملء 'أي شيء'.
⑨ سجّل الدخول إلى صفحة الويب للمنتج، ثم انتقل إلى عمود ‘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 في الصورة التالية)
③ افتح CMD، أدخل "tftp Server IP get Configfile.cfg"، تشير النتيجة "Transfer Successful" إلىتم إنشاء خادم tftp بنجاح.
(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. |
4.3.2. Internal provisioning with DHCP and TFTP
إشعار:
♦ Users must change the DBID_DBASE_VERSION value after each modification, or the product
لن يتم إعادة المزامنة. أبسط طريقة هي إضافة واحد إلى المعامل.
♦ يجب على المستخدمين ملاحظة حالة الخيار 66، بغض النظر عن طريقة تنفيذ التهيئة، بما في ذلك
HTTP, HTTPS 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
With 66 and IP server address. The IP address is the address from which the TFTP server will request the configuration file.
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 واملأ قاعدة الملف الشخصي واسم ملف التكوين. على سبيل المثال:
③ 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
إشعار:
♦ 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، الأمر هو:
عند استخدام هذا الشكل من التشفير لتشفير ملف تعريف التكوين، يجب إبلاغ المنتج
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
على سبيل المثال:
إذا أدخلت كلمة مرور خاطئة، لن يحصل 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 |
![]() |
| 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. |

