如何:定制DAL备份配置文件

• 背景
• 步骤1:获取配置备份文件
• 步骤2:提取配置备份文件
• 步骤3:定制选项
  • 更改配置设置
  • 添加自定义脚本
  • 将配置备份应用于其他DAL设备类型
• 步骤4:重新压缩配置备份
• 步骤5:将配置备份上传到DAL设备
• 进一步的阅读

背景

可以通过命令行、本地web界面或Digi Remote Manager三种方式从DAL设备获取配置备份文件。你得到的备份文件是一个扩展名为.bin的压缩后的压缩文件。这个文件可以被提取，结果的内容编辑，并重新压缩回tarball，然后加载到相同的Digi设备，你得到了配置备份或任何其他Digi设备的相同类型/模型(例如配置备份从EX15W可以加载到任何EX15W)。

配置文件的内容，一旦提取，包含设备的/etc/config/目录中的所有内容。这包括:

• 配置设置

  • /etc/config/accns.json

• 自定义脚本

  • /etc/config/scripts/目录

• SSL证书

  • /etc/config/ssl./etc/config/ssl.pem

• 设备已成功连接的APN+SIM组合列表

  • /etc/config/mm.json

• 当前DHCP租期列表(如果network.advanced。在DAL设备的配置中启用了dhcp_persistent_lease)

  • /etc/config/dhcp.leases

一旦提取配置备份，上述任何/所有文件都可以编辑

步骤1:获取配置备份文件

• 选项1:CLI
  • SSH/telnet到DAL设备，输入“a”进入admin命令行，然后执行以下命令:
    • 系统备份/tmp/config_backup.bin
  • 使用SCP或SCP工具(WinSCP, Putty, Filezilla等)将备份的配置文件复制到您的PC上。使用实例SCP命令将备份的配置文件从DAL设备拷贝到下载/目录:
    • scp admin@192.168.210.1:/tmp/config_backup.bin下载/
• 选项2:shell
  • SSH/telnet到DAL设备，输入“s”进入DAL设备的shell控制台，然后运行下面的shell命令:
    • /bin/backup_and_restore -b > /tmp/config_backup.bin
  • 使用SCP或SCP工具(WinSCP, Putty, Filezilla等)将备份的配置文件复制到您的PC上。
• 选项3:Web UI
  • 在PC上打开web浏览器，进入DAL设备的IP地址，访问其web UI
  • 登录后，导航到系统管理→配置维护页面
  • 单击保存按钮，并将生成的。bin文件保存到PC上
• 选项4:数字远程管理器
  • 登录到数码远程管理器。查找DAL设备，单击其id，然后单击控制台选项卡，远程访问设备的Admin命令行
  • 运行以下CLI命令，注意将配置备份存储在DigiRM可以访问的DAL设备文件系统的位置(例如/var/log/)。
    • 系统备份/var/log/config_backup.bin
    • 
  • 单击文件选项卡，然后单击配置备份文件所在的目录。单击配置备份文件，然后单击DigiRM中的下载按钮。
    • 

步骤2:提取配置备份文件

有很多tarball解压工具。我们将介绍两种，但请随意使用您最喜欢的。

• 焦油—Linux/Mac命令。我们建议您将配置备份文件单独放在一个目录中，这样更容易跟踪文件内容
  
  mkdir -p ~/Downloads/DAL_config_backup/
mv ~/Downloads/config_backup.bin ~/Downloads/DAL_config_backup/
cd ~ /下载/ DAL_config_backup /
Tar -xf config_backup.bin

• 7 - zip实用程序(Linux / Mac / Windows)
  • https://www.7-zip.org/
  • 一旦7 - zip程序安装:在你的电脑上打开一个文件浏览器，然后浏览配置备份文件(把它放在一个文件夹里，这样你就可以很容易地跟踪提取的文件内容)
  • 右键单击.bin配置文件并选择7 - zip→这里提取

步骤3:定制选项

下面是一些值得注意的定制选项，您可能希望在提取配置备份文件后对其进行定制。正如在上面的背景信息中提到的，这个配置备份包含来自DAL设备的完整/etc/config/内容，因此除了下面列出的内容之外，您可能还可以找到其他自定义选项。

更改配置设置

的等/ accns.json文件包含您从中提取配置备份的DAL设备上的整个非默认配置设置集。这意味着，用户在设备上所做的任何偏离默认固件配置设置的配置设置都将包含在accns中。json文件。正如文件扩展名所暗示的，这是一个json格式的配置文件。您可以编辑/删除/添加此文件中的任何内容，但应注意:

1. 该文件是json兼容的。您可以使用在线JSON验证器，如https://jsonlint.com/复制/粘贴账号。导入Json文件并验证语法是否正确

2. 内容是有效的配置设置。配置备份中列出的所有值都是正确的，因为它们是从可以解析配置文件的DAL设备中提取的。但是，如果对accns进行任何编辑。Json文件并添加之前没有的设置，确保您有正确的名称和路径来添加配置设置。
   
   要获取可用配置设置的引用，可以运行配置转储从DAL设备的shell控制台。该命令的输出是所有可用配置设置的键值列表。您可以在帐户中配置其中的任何一个。json文件，只需将其格式化为json。例如:如果您想通过将network.interface.modem.modem.apn.0.apn设置为testAPN123来设置APN，那么在accns中看起来像这样。json文件:

{
"网络":{
“接口”:{
“调制解调器”:{
“调制解调器”:{
“导引”:[{
“导引”:“testAPN123”
}),
“apn_lock”:真的
}
}
}
}
}

添加自定义脚本

/etc/config/scripts/目录将包含用户从web UI、CLI或DigiRM加载到DAL设备上的任何Python脚本。您可以添加/编辑/删除这些python脚本，就像您直接与DAL设备交互一样。这些脚本可以使用几个选项在DAL设备上自动或手动运行。有关运行Python脚本的详细信息，请参阅下面的用户指南链接:

//www.phdurl.com/2022世界杯G组resources/documentation/digidocs/90002344/default.htm#containers/applications-cont.htm

将配置备份应用于其他DAL设备类型

正如上面背景部分所提到的，这些配置备份文件只能加载到与文件提取设备相同类型/型号的DAL设备上(例如，来自EX15W的配置备份文件只能加载到其他EX15W设备上，而不能加载到其他DAL设备上，如TX54或IX10)。这是因为每个DAL设备都有它使用的唯一模式验证和设置。也就是说，绝大多数配置设置在DAL设备上是通用的。

如果您相信您的配置设置对所有DAL产品都是通用的，并且希望将配置备份文件加载到其他DAL模型/类型中，那么您可以将目标产品类型添加到tmp /目录中提取的配置备份内容。

最简单的方法是将现有文件复制到tmp /目录并将其重命名，以便在文件名中包含目标产品类型。例如，要允许将配置备份文件加载到IX10单元(即使它是从EX15W下载的)，您需要在tmp /目录中包含IX10，如下所示:

$ ls
Config_backup.bin etc TMP
＄
$ ls tmp/
第吉尔- ex15w 21.5.56.106 - 2021 - 07 - 08年
$ cat tmp/Digi-EX15W-21.5.56.106-2021-07-08
$ cp tmp/Digi-IX10-21.5.56.106-2021-07-08
$ ls tmp/
第吉尔- ex15w 21.5.56.106 - 2021 - 07 - 08年第吉尔- ix10 21.5.56.106 - 2021 - 07 - 08年
＄

步骤4:重新压缩配置备份

• 焦油(Linux / Mac命令)
  • 下面的示例假设您的配置备份文件位于名为
    ~ /下载/ DAL_config_backup /
    • cd ~ /下载/ DAL_config_backup /
    • Tar -zc etc/ tmp/ -f config_backup_new.bin
• 7 - zip工具(Linux / Mac / Windows)
  • 安装7 - zip程序。接下来，在你的PC上打开一个文件浏览器，找到你把提取的配置备份文件的内容放入的目录(把它放在一个文件夹中，这样你就可以很容易地跟踪提取的文件内容)，选择等/和/ tmp目录，右键单击所选项，然后选择7 - zip→压缩
  • 在出现的7-zip窗口中，选择gz文件扩展名/类型，指定要创建的文件的名称，然后单击“创建”