I版本记录Versions
|
Version |
Date |
Comment |
Edited by |
|---|---|---|---|---|
|
1.0 |
July 20, 2019 |
First Edition |
Zheng Li |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Table : Versions
1功能描述
mapp Backup可以快速轻松地完成对目标系统的软件更新，还可以定期自动或手动对目标系统进行备份。例如，不需借助任何软件，只要将存储有更新文件的U盘插到PLC USB接口上，便可完成程序的更新；或者每周自动将系统备份到USB存储设备上。
图 mapp Backup功能
2软件配置信息
2.1系统需求
下表列出了使用mapp Backup功能所需要的软件版本信息。
表 mapp Backup使用版本需求
|
|
|
mapp Services |
Automation Studio |
Automation Runtime |
V5.3 and later |
4.3.3 or later |
F4.34 and later |
注意事项：
▪mapp服务不支持控制器冗余
▪如果mapp Services和 motion version ACP10/ARNC0 一起使用，注意主版本号要保证一致，例如mapp Services版本5.4.x,则ACP10/ARNC0版本也应是5.4. x以保证兼容性。
2.2授权信息
mapp Backup属于mapp Services组件中的功能，mapp Services组件在ARsim中使用不受任何限制，在实际系统中使用应具备1TGMPSRV.00-01授权。
3功能分析
3.1项目安装包
mapp Backup功能块备份项目所生成的项目安装包，或更新项目时所使用的项目安装包的结构如图1所示。项目安装包中包括标识文件(.xml)、配置文件(.xml) 、传输模块文件（.br）。
图 项目安装包结构
▪标识文件中规定了在哪个目标系统上安装备份文件；
▪配置文件中指定如何安装项目；
▪传输模块文件中包含与在目标系统上安装项目所需的所有文件，包括当前项目中的日志文件、User区的所有文件等。
mapp Backup功能块创建的项目安装包，与之前我们采用U盘更新系统时使用Generate project installation package创建的项目安装包的数据是相同的，它们区别只是文件大小不同，这是由于两种操作采用的压缩方式不同所致，但彼此通用。
3.2MpBackupCore功能块
MpBackupCore功能块用于备份或更新系统。
图 MpBackupCore功能块
DeviceName和name用于设置存储项目安装包文件的设备名称和文件名称。
例如:在SG4系统中，存储位置如果是CF卡的User区，默认路径为“F:\”，则可赋值DeviceName为ADR(‘CF’); 存储位置如果选择U盘，以X20CP1586为例，在两个USB口第一个被插入的U盘路径默认被指定为‘/bd0’, 第二个插入的U盘路径则默认被指定为‘/bd16’,则赋值DeviceName为ADR(‘USB’)。
需要注意不同设备、不同系统USB设备的盘符不尽相同，应采用AsUSB库来进行识别,并通过DevLink()来获得设备句柄，请参考陈辉编写的自动备份logger至U盘的Demo； USB存储设备应为FAT32格式。
图 设置文件存储设备
name指定备份/更新文件的名称，名称中也可以包含数据存储文件夹路径，例如:"FolderName/Filename"。
RequestInfo 命令用于执行查看项目安装包的配置信息和当前系统项目的配置信息等操作。
Create命令执行将当前系统以name指定的名称备份到DeviceName路径下。
Install 命令执行用DeviceName路径下名称为name指定的备份文件来更新系统。
3.3MpBackupCoreConfig功能块
MpBackupCoreConfig功能块提供了用于配置和读取自动备份、更新项目安装包的相关参数，可在线对配置进行更改。（部分配置更改需要MpBackupCore功能块重新使能后生效，使用时需注意。）
图 MpBackupCoreConfig功能块
4基本功能测试
4.1准备工作
为方便对mapp Backup功能进行测试，需要先对系统进行进行一些基本配置。
1.分配300M空间作为User区用于存储备份文件。
图 User区配置
2.指定文件存储设备的名称及路径。
图 文件存储设备配置
3.配置FTP Server，以便通过FTP访问和操作CF卡User区及U盘中的备份文件。
图 FAT Server配置
4.2备份功能
mapp Backup备份功能执行将当前系统备份到指定存储路径下。
4.2.1手动执行备份功能
1.添加MpBackupCore配置
指定MpLink,其他参数保持默认设置。
图 MpBackupCore配置
2.添加MpBackupCore
连接MpLink、DeviceName和Name等变量。
图 MpBackupCore功能块
3.下装测试
下装程序后执行Create命令，此时CommandBusy状态变为TRUE,表示备份指定正在被执行，当备份完毕后，CommandBusy状态变为FALSE,同时CommandDone状态变为TURE。
图 手动备份功能测试
由于备份操作是异步执行，所以其操作用时与文件的大小和当前系统负荷有很大关系，一般一次备份执行时间都在几分钟到十几分钟不等。
采用X20CP3586进行测试，同样大小文件，当CPU负荷在15%时，备份时间在6分钟左右，当CPU负荷在90%时，备份时间大概需要25分钟。
图 CPU低负荷下备份功能测试
图 CPU高负荷下备份功能测试
4.查看备份文件
通过FTP访问CF卡User区，查看生成的备份文件。
图 查看备份文件
4.2.2自动执行备份功能
1. 更改配置
可通过配置实现mapp Backup自动生成备份功能。下图配置中规定了生成的备份文件名称、存储路径、自动执行的时间、路径下存储的最大备份文件数量及是否覆盖旧文件等。
图 配置自动备份功能
其中生成备份文件的文件名为Name prefix中设置的名称加时间后缀。
例如：myBackupPrefix_2019_07_22_15_16_40
配置执行时间的格式为秒，例如如果设置每天早上6点自动执行备份功能，则mode设置成Dailt，Time则设置成21600.
2.下装测试
配置完毕后，当到达配置中规定的时间，系统会自动执行备份功能。
图 自动备份功能执行
4.3更新功能
mapp Backup更新功能执行检测系统安装文件并执行更新系统功能。
4.3.1手动执行更新功能
1.生成项目安装文件
程序修改后使用Generate project installation package创建项目安装包。项目安装包的名称需要与MpBackupCore功能块中name指定的名称一致，以便能够被找到。
图 创建项目安装包
为区别安装程序的版本信息，便于程序版本管理，每次生成新的项目安装包都应该规定版本信息。
图 项目安装包版本信息设置
2.手动更新项目
将上面生成的项目安装包拷贝到U盘中或通过FTP拷贝到User去，这取决于更新时选择的项目安装包存放路径。
执行Install 命令，此时CommandBusy状态变为TRUE,表示更新指定正在被执行，当更新完毕后，CommandBusy状态变为FALSE,同时CommandDone状态变为TURE。
有些情况下更新程序后系统会重启，例如生成项目安装包时勾选了重启选项、修改了硬件配置以及程序变动较大等。
图 手动更新功能测试
3.检查版本信息
程序更新后通过查看当前系统版本信息可以判断是否更新成功。
图 手动更新功能测试
4.3.2自动执行更新功能
mapp Backup提供了按照指定周期时间，自动搜索项目更新文件,或条件触发来搜索项目更新文件，
并将检测到的新版本信息提示给操作人员，由操作人员确认是否执行安装。
下面对条件触发来搜索项目更新文件的情况进行介绍。
1.更改配置
图 配置自动备份功能
2.生成项目安装文件
生成项目安装包的方法与上述方法一致，由于自动更新功能检测是否有新版本项目安装文件存在，是通过项目安装包的版本信息决定的，所以新版本信息应设置的高于当前系统版本信息，这样当系统重启或者重新使能MpBackupCore功能块后，系统会检测到由新版本项目安装包存在，并显示具体版本信息。
图 修改项目版本信息
在生成项目安装包的“pipconfig.xml”文件中也可以看到相关的配置信息，系统就是通过检测该文件来判断新版本的存在。
图 pipconfig.xml文件
2.下装测试
重启系统后，如果系统检测到了新版本项目安装包存在，IsAvailable变量会变为TRUE,同时新文件的文件名称、版本信息等也会显示出来。此时执行Install 命令，系统会自动完成更新。
新版本项目安装文件的名字可以与MpBackupCore功能块中规定的name不同，自动更新功能系统会以版本号最高的安装文件作为更新文件使用。
图 自动更新功能执行
5典型应用
5.1通过U盘更新系统
很多情况下我们需要对用户现场的PLC程序进行修改更新，而现场维护人员并不具备任何AS软件使用基础，甚至没有安装任何的AS相关软件，无法通过在线下装或者烧卡来实现程序更新。针对这种情况，mapp Backup提供了一个简单快速的解决方案，我们将更新包发给用户，用户只需将更新包拷贝到U盘并将U盘插入到PLC相应的USB接口，便能完成程序的更新。
图 6.1 通过U盘更新系统参考画面
实现步骤：
1.按照5.3.2 自动执行更新功能配置mapp Backup；
2.将更新文件拷贝到U盘；
3.通过AsUSB库检测USB存储设备状态；
4.当系统检测到USB存储设备状态正常时，触发执行搜索更新功能；
5.检测到有更新文件后，如果有操作屏可增加一步人为确认，如果没有操作屏可直接执行更新。
6. HMI可参考下图：
图 自动搜索并提示更新功能
5.2通FTP更新系统
与通过U盘更新系统相似，有些情况下现场维护人员不方便到达设备现场，如风机塔顶，这种情况下可将项目安装文件通过FTP方式拷贝到PLC的User区，再通过自动执行更新功能完成程序更新。
实现步骤：
1.按照5.3.2 自动执行更新功能配置mapp Backup，此处将设备名称改为“CF”,以便系统去CF卡User区去查找更新文件。
2.通过提前配置好的FTP Server 登录用户访问CF卡，将更新文件拷贝到User区。
3.通过HMI或重启来触发执行搜索更新功能；
4.设置检测到更新后自动更新或由现场维护人员确认更新。
5.3创建备份到U盘
在很多应用现场，出于安全考虑，用户会定期的将当前程序以及用户数据进行备份，采用mapp Backup提供的备份功能会让操作变的十分简单。同时产生的备份文件中包括了当前系统程序、记录文件、用户文件等，将该备份文件打包发给系统维护人员，也便于系统维护人员查找问题。
实现步骤：
1.按照5.2.2 自动执行备份功能配置mapp Backup；
2.指定USB设备用于存储备份，并设置自动覆盖旧版本功能，限定最大存储备份文件个数；
3.通过AsUSB库检测USB存储设备状态；
4.将U盘格式化成FAT32并插到PLC的任一USB口;
5.系统会根据配置的自动执行时间来触发备份功能。
6使用建议
mapp Backup功能在使用过程中应注意以下几点：
1.如果选择USB设备作为存储设备，其格式应设置成FAT32；
2.不同设备、不同系统USB设备的盘符不尽相同，建议采用AsUSB库中的功能块进行识别,可参考陈辉编写的自动备份logger的Demo；
3.使用自动备份功能不建议将存储设备选成User区，因为每次执行备份功能系统也会将User区的内容进行备份；
4.不同系统的文件大小不同、CPU的负荷不同，这些因素会导致备份功能执行时间存在较大差异，每次执行要确保生成的备份文件是完整的。
5.使用自动更新功能建议条件允许的情况下尽量增加人为确认操作，以提高系统的安全性；
6.自动更新功能中搜索新版本项目安装文件是基于版本信息的大小进行的判断，所以如果采用该功能，在生成项目安装文件时不要忘记修改版本信息；
7.通过手动方式还原系统时，备份文件名称必须改成与MpBackupCore功能块name变量指定的名称一致，否则会查找失败；
8.使用值避免自动备份和更新功能同时执行。