概要
本功能是,将外部存储(USB存储器,microSD存储卡)连接至路由器本体,路由器和外部存储间进行各种数据的操作。可使用的外部存储因进行而异。
本功能可以进行以下的运行。
- 由外部存储按钮和download按妞的操作进行运行
- 外部存储按钮和download按妞同时按下3秒以上,可以从外部存储中复制设置文件和固件
- 由输入命令操作
- 输出SYSLOG信息至外部存储
- 复制设置文件至外部存储
- 从外部存储中复制设置文件
- 从外部存储中复制固件文件
- 输出统计信息至外部存储
关于外部存储的基本使用方法,按钮操作,LED和蜂鸣器声音的规格,SYSLOG信息等,请参考外部存储的利用的资料。
支持的机型和固件版本
雅马哈路由器的以下机型和固件版本支持外部存储功能。
机型 | 固件 |
---|---|
RTX5000 | Rev.14.00.15以后 |
RTX820 | Rev.11.03.16以后 |
RTX1200 | Rev.10.01.20以后 |
RTX800 | Rev.10.01.20以后 |
使用方法
外部存储按钮和Download按钮的操作
外部存储按钮和download按妞同时按下3秒以上,可以将保存在外部存储中的固件文件和设置文件复制到路由器的内置Flash ROM中。复制按照设置文件,固件文件的顺序进行,成功后蜂鸣器鸣响,自动重启。
外部存储启动功能某些机型,在启动时连接了外部存储的话,可以用外部存储中的固件文件和设置文件进行启动。启动时,在POWER灯闪烁时拔出外部存储的话,将不识别外部存储,用内置flash ROM中的固件文件和设置文件启动。POWER灯闪烁大约10秒左右仍未识别出外部存储时,在拔出外部存储前没有必要按下外部存储按钮。
或者,可以通过external-memory boot permit off命令来设置不通过外部存储进行启动。
通过外部存储的文件进行启动时固件的升级和设置内容的保存目标都将变为外部存储的文件。
没有外部存储启动功能的机型,使用内置Flash ROM中的固件文件和设置文件启动。
这个操作中复制的各文件,可以通过external-memory config filename 命令和external-memory exec filename 命令来指定。
出厂状态下,外部存储中的'config.txt'和'机型名.bin'文件分别作为设置文件和固件文件复制到内置Flash ROM中。例如RTX1200的情况下,固件文件为'rtx1200.bin'。
- 例1:指定按钮操作中,复制的设置文件为'rt_config.txt'
- 例2:指定按钮操作中,复制的固件文件为'rt_firmware.bin'
即使将设置文件和固件文件保存在根目录以外的目录中,也能通过自动检索发现。详细请参考外部存储的使用的资料。
- 例1:在microSD存储卡中,进行指定的文件(rt_config.txt)的检索,取得复制对象文件
- 例2:在根目录中的指定文件(rt_config.txt)为复制对象文件
指定的设置文件和固件文件都不存在,进行按钮操作时,不会进行复制动作,蜂鸣器鸣响。
由输入命令操作
将SYSLOG信息写入外部存储
external-memory syslog filename 命令,可以设置写入外部存储的SYSLOG文件名。不设置本命令的话,将不进行SYSLOG信息的写入。
- 例:设置将SYSLOG写入USB存储中
- 例:设置将SYSLOG写入microSD存储卡中
- 例:设置SYSLOG文件的大小,最大为100Mbyte,保存的备份文件数为30个 (Rev.11.03 系以后可以使用)
另外,将文件写入外部存储中时,如有必要,会生成备份文件。关于备份文件,请参考「备份文件的方法」。
在路由器和外部存储之间复制设置文件
copy config 命令,可以将设置文件从路由器的内置Flash ROM中写入外部存储,也可以进行反向操作。
- 例1:将USB存储中的'rt_config1.txt'的设置文件复制到路由器的内置Flash ROM中
- 例2:将路由器的内置Flash ROM中的设置文件,以'rt_config2.txt'为文件名,复制到microSD存储卡中
从外部存储中复制固件文件
copy exec 命令,可以将外部存储中的固件文件复制到路由器的内置Flash ROM中。
- 例:将USB存储中的'rt_firmware.bin'的固件文件复制到路由器的内置Flash ROM中
另外,通过copy config 和copy exec 命令复制到内置Flash ROM中的内容,不会就此反映实际的动作。为了反映复制的内容,需要在命令执行后重启路由器。
输出统计信息至外部存储
用statistics命令选择想要取得的统计信息,设置为on,再通过external-memory statistics filename prefix命令来设置输出至外部存储的文件名。不设置这些命令的话,不会输出统计信息。
详细请参考命令手册。
详细
将SYSLOG信息写入外部存
备份文件的方法
在此说明SYSLOG的备份文件的保存方式。另外,由于机型,固件的不同,若干动作可能存在不同,请注意。
Rev.11.03 系以后时
在将SYSLOG信息保存至外部存储中时,一系列的处理中使用2种类型的文件。external-memory syslog filename 命令指定的写入SYSLOG信息的新建文件 (以下简称main文件),和main文件的大小到达了本命令指定的上限值,或者通过自动计算得到的上限值时,成为回滚目标的文件(以下简称backup文件)。
新增加的SYSLOG信息通常会写入main文件中(下图1)。这时,如果main文件的大小到达了external-memory syslog filename 命令指定的上限值,或者由剩余空间的自动计算得到的上限值时,main文件会暂时关闭,main文件将变更为backup文件进行回滚(下图2)。然后以main文件名新建文件,再开始写入(下图3)。main文件的大小再次到达上限值的话,同样回滚到backup文件中。这时如果到达了external-memory syslog filename 命令指定的backup文件数的上限值,或者外部存储的剩余容量不足时,将删除backup文件名中附加的时间数据(以"_yyyymmdd_hhmmss"形式显示的字符串)中最旧的backup文件(下图4)。
这时生成的backup文件名是在main文件名的后面加上表示进行回滚动作的时间 "_yyyymmdd_hhmmss"的形式的字符串。
以下表示"_yyyymmdd_hhmmss"的字符串的意义。
- yyyy ... 公历 (4 个数)
- mm ... 月 (2 个数)
- dd ... 日 (2 个数)
- hh ... 时 (2 个数)
- mm ... 分 (2 个数)
- ss ... 秒 (2 个数)
例如,main文件名为 "syslog.txt",2011年1月1日 12时34分56秒生成了backup文件,backup文件名为"syslog_20110101_123456.txt"。
外部存储有足够的可用空间时,可以用external-memory syslog filename 命令来指定main文件大小的上限,保存指定数量的该大小的backup文件。但是,没有足够的可用空间时,保存的backup文件和本命令指定的文件大小或backup文件数会存在差异,请注意。
另外,根据需要,可以使用rotate external-memory syslog 命令,无关文件大小也能进行回滚。这时,如果存在同名的backup文件的话,回滚不会进行。
另外,关于main文件的上限大小的自动计算,请参考「SYSLOG文件大小的自动计算」。
Rev.10.01 系的情况
在将SYSLOG信息保存至外部存储中时,一系列的处理中使用2种类型的文件。external-memory syslog filename 命令指定的写入SYSLOG信息的新建文件(以下简称main文件),和main文件的大小到达了本命令指定的上限值,或者通过自动计算得到的上限值时,成为回滚目标的文件(以下简称backup文件)。
新增加的SYSLOG信息通常会写入main文件中(下图1)。这时,如果main文件的大小到达了自动计算得到的上限值时,main文件会暂时关闭,main文件将变更为backup文件进行回滚(下图2)。然后以main文件名新建文件,再开始写入(下图3)。
这时生成的backup文件名遵循以下的规则。
- main文件名存在扩展名时,将扩展名改为'.bak'
- main文件名没有扩展名时,main文件名加上'.bak'
另外,为了防止重名,指定main文件名时不能使用'.bak'的扩展名。
进行回滚运行时,已经存在backup文件时,将会删除既存的backup文件的内容,请注意。另外,关于main文件的上限大小的自动计算,请参考「SYSLOG文件大小的自动计算」。
SYSLOG文件大小的自动计算
在外部存储中输出SYSLOG信息时,路由器会使用尽可能多的外部存储的可用空间进行信息的写入。具体是指,在开始写入SYSLOG信息前,先检查外部存储的可用空间,该空间根据各用途如下进行分配。这时,在main文件用和backup文件用的分配的范围内写入SYSLOG信息。
main文件或者backup文件已经存在时,这些文件的空间也被当作可用空间计算。
上图中,将外部存储的可用空间记作En、config保存用的空间记作Cn、main文件用的空间记作Mn、和backup文件用的空间Bn,各空间的大小如下计算得出。
另外在写入途中,外部存储内的可用空间发生变化,main文件不能进行上限大小的写入时,这时,main文件将回滚为backup文件,再用上述方式计算各空间的大小。
运行状态的确认
本功能的运行状态的确认使用show status external-memory 命令。命令输入时的显示例如下所示。
外部存储的运行状态的显示
- Host controller是否正常的运行
- SYSLOG的写入设置信息(写入的文件名、backup文件名、写入文件的上限大小)
※(Rev.11.03 系以后时)
回滚的文件名以"usb1:rt_syslog_YYYYMMDD_HHMMSS.txt"显示 - 供电状态(ON或者OFF。检测出过电流,强制供电OFF时,会显示该情况)
- 连接中的外部存储的设备信息(设备名、制造商名、最大传输速度、记忆容量)
※没有连接外部存储时不显示
(注) 没有统计信息功能的机型,不显示本行。
关于SYSLOG保存的注意事项
- external-memory syslog filename 命令指定的SYSLOG记录用文件在插入的外部存储中已经存在时,到达上限大小为止,会追加在文件的末尾。
- 在识别到外部存储后才开始SYSLOG的记录。所以路由器启动时输出的SYSLOG不会记录在外部存储中,所以路由器本体显示的SYSLOG和外部存储中记录的内容未必一致。
- 相同内容的SYSLOG连续输出时,将省略写入外部存储中,只记录"same message repeated N times"这样的重复次数。
命令格式
Rev.11.03 系以后
指定保存在外部存储中的SYSLOG文件名
[格式]
[设置值]
- NAME ... SYSLOG文件名
(FILENAME在加密且不指定扩展名时,半角78字符以内,除此以外的情况,半角83字符以内)- usb1:FILENAME ... USB1存储中的文件
- usb2:FILENAME ... USB2存储中的文件
- sd1:FILENAME ... microSD存储卡中的文件
- CRYPTO ... SYSLOG加密保存时的加密算法的选择
- aes128 ... 用AES128加密
- aes256 ... 用AES256加密
- PASSWORD ... 用ASCII字符串表示的密码(半角8字符以上,32字符以内)
- SIZE ... SYSLOG 文件的上限大小 ( 1 - 1024 单位:MB ) 默认值:10
- NUM ... backup文件的上限数 ( 1 - 100 ) 默认值:10
[说明]
设置保存在外部存储中的SYSLOG 文件名。
FILENAME中不能指定含有 .bak 扩展名的文件名。另外,不加密时,FILENAME中不能指定含有 .rtfg 扩展名的文件名。
指定了CRYPTO 和 PASSWORD时,SYSLOG会加密后写入外部存储中。加密时,指定的FILENAME中必须含有 .rtfg 扩展名,或者省略扩展名。省略扩展名时,会自动的加上 .rtfg 扩展名。
SYSLOG 文件到达上限大小的话,会进行SYSLOG 文件的备份。backup文件名会在FILENAME指定的文件名的后面加上表示进行备份时间的_yyyymmdd_hhmmss 形式的字符串。
- yyyy ... 公历 (4 个数)
- mm ... 月 (2 个数)
- dd ... 日 (2 个数)
- hh ... 时 (2 个数)
- mm ... 分 (2 个数)
- ss ... 秒 (2 个数)
backup文件数到达了 NUM指定的上限数时,或者外部存储的可用空间不足时,将删除最旧的backup文件,生成新的backup文件。
不设置本命令时,不会将 SYSLOG 写入外部存储中。
[Note]
进行以下变更时,必须更改FILENAME。
- SYSLOG由不加密保存变更为加密保存时
- SYSLOG由加密保存变更为不加密保存时
- 变更了加密算法或密码时
[默认值]
无设置
[适用机型]
RTX5000 | RTX820 |
在外部存储中保存 SYSLOG 文件的rotate(backup)
[格式]
[说明]
进行外部存储中保存SYSLOG 文件的rotate(backup)。
将当前写入中的 SYSLOG 文件回滚为backup文件,生成新的写入用的 SYSLOG 文件。已经存在同名的backup文件时不能运行。
另外,当生成backup文件时,backup文件数超过了 external-memory syslog filename 命令设置的上限数时,或者外部存储的可用空间不足时,将删除最旧的backup文件,生成新的backup文件。
关于backup文件名的格式,请参考external-memory syslog filename 命令。
另外,本命令只有在external-memory syslog filename 命令设置了SYSLOG 文件名,并且在指定的外部存储接口上连接了外部存储时才能运行。
[Note]
通过schedule at命令定期执行本命令的话,可以按照每日,每周,或者每月自动生成SYSLOG的backup文件。
[设置例]
[适用机型]
RTX5000 | RTX820 |
删除保存在外部存储中SYSLOG和backup文件
[格式]
[说明]
进行保存在外部存储中的当前写入中的SYSLOG文件内的log的清除和删除所有的SYSLOG的backup文件。
削除的对象的SYSLOG的backup文件是用external-memory syslog filename 命令指定的路径中的文件。
另外,本命令只有设置了external-memory syslog filename 命令的SYSLOG 文件名、且指定的外部存储接口上连接了外部存储时才运行。
[适用机型]
RTX5000 | RTX820 |
Rev.10.01 系时
指定保存在外部存储中的SYSLOG文件名
[格式]
[设置值]
- NAME ... SYSLOG文件名
(FILENAME为64字符以内。但是不能指定含有.bak的扩展名)- usb1:FILENAME ... USB1存储内的文件
- usb2:FILENAME ... USB2存储内的文件
- sd1:FILENAME ... microSD存储卡内的文件
- CRYPTO ... SYSLOG加密保存时的加密算法的选择
- aes128 ... 用AES128加密
- aes256 ... 用AES256加密
- PASSWORD ... 用ASCII字符串表示的密码(半角8字符以上、32字符以内)
[说明]
指定保存在外部存储中的SYSLOG文件名。
为了避免和backup文件重名,不能指定含有.bak扩展名的FILENAME文件名。
指定了CRYPTO和PASSWORD时,会加密SYSLOG后写入外部存储。加密时,必须指定含有.rtfg扩展名或者不含有扩展名的FILENAME文件名。省略扩展名时,会自动加上.rtfg扩展名。
文件的可写入大小的上限,会用开始写入外部存储时的剩余空间自动计算,SYSLOG 文件到达上限大小时,进行SYSLOG 文件的backup。这时生成的文件名遵从以下的规则。
- FILENAME有扩展名时.......... 将扩展名改为.bak
- FILENAME没有扩展名时........ 变为FILENAME.bak
不进行本命令的设置的话,不会在外部存储中写入SYSLOG。
[Note]
进行以下变更时,必须变更FILENAME。
- SYSLOG由不加密保存变更为加密保存时
- SYSLOG由加密保存变更为不加密保存时
- 变更了加密算法或密码时
[默认值]
无设置
[适用机型]
RTX1200 | RTX800 |
同时按下外部存储按钮和DOWNLOAD按钮时,是否允许文件复制的设置
[格式]
[设置值]
- SWITCH
- on ... 允许
- off ... 不允许
[说明]
设置是否允许通过按钮的操作来进行外部存储的文件复制。
读取的设置文件和固件文件的名称,各自需要通过external-memory config filename 命令和external-memory exec filename 命令来设置。
[默认值]
on
[适用机型]
RTX1200 | RTX820 | RTX800 |
启动时,或者同时按下外部存储按钮和DOWNLOAD按钮时读取的设置文件名的指定
[格式]
[设置值]
- FROM ... 指定外部存储内的设置文件名 (FILENAME为64字符以内)
- usb1:FILENAME ... USB1存储内的设置文件
- usb2:FILENAME ... USB2存储内的设置文件
- sd1:FILENAME ... microSD卡内的设置文件
- *:FILENAME ... USB存储和microSD卡内的设置文件
- TO ... 复制目标文件名
- NUM ... 内置式Flash ROM的设置文件编号(省略时为0)
- PASSWORD ... 还原密码(ASCII字符串,8字符以上、32字符以内)
[说明]
指定插入外部存储启动时,或者同时按下外部存储按钮和DOWNLOAD按钮时,读取的外部存储上的设置文件名。
另外,也可以指定同时按下外部存储按钮和DOWNLOAD按钮时,将设置文件复制到内置式Flash ROM的设置文件编号。
指定外部存储时,只进行该外部存储的读取。
指定外部存储为"*"时,先在microSD存储卡中检索指定的文件,没有找到的话,再检索USB存储。通过按钮操作时,只检索该按钮对应的外部存储。
FILENAME可以用绝对路径指定,或者只指定文件名。只指定文件名时,会从指定的外部存储内进行检索。
存在多个同名文件时,会选择在目录结构上最接近根目录的那个文件。
指定为off时,不进行设置文件的检索。
设置文件需要解密才能读取时,需要在PASSWORD中设置加密时的密码。
[Note]
RTX1200/RTX800 Rev.10.01.33 以后、和Rev.11.03 系以后,FILENAME为99字符以内。
[设置例]
在misroSD卡中检索"config.txt",作为设置文件读取
在misroSD卡中的目录"dir1"中检索"config.txt",作为设置文件读取
[默认值]
*:config.rtfg,*:config.txt 0 (RTX1200, RTX820, RTX800)
sd1:config.rtfg,sd1:config.txt 0 (RTX5000)
[适用机型]
RTX5000 | RTX1200 | RTX820 | RTX800 |
启动时,或者同时按下外部存储按钮和DOWNLOAD按钮时读取的固件文件名的指定
[格式]
[设置值]
- FROM ... 指定外部存储内的固件文件名 (FILENAME为64字符以内)
- usb1:FILENAME ... USB1存储内的固件文件名
- usb2:FILENAME ... USB2存储内的固件文件名
- sd1:FILENAME ... microSD卡内的固件文件
- *:FILENAME ... USB存储和microSD卡内的固件文件
- TO ... 复制目标文件名
- NUM ... 内置式Flash ROM的运行模式固件文件编号(省略时为0)
- off ... 不进行固件文件的检索和读取。
[说明]
指定插入外部存储启动时,或者同时按下外部存储按钮和DOWNLOAD按钮时,读取的外部存储上的固件文件名。
另外,也可以指定同时按下外部存储按钮和DOWNLOAD按钮时,将设置文件复制到内置式Flash ROM的固件文件编号。
指定外部存储时,只进行该外部存储的读取。
指定外部存储为"*"时,先在microSD存储卡中检索指定的文件,没有找到的话,再检索USB存储。通过按钮操作时,只检索该按钮对应的外部存储。
FILENAME可以用绝对路径指定,或者只指定文件名。只指定文件名时,会从指定的外部存储内进行检索。
存在多个同名文件时,会选择在目录结构上最接近根目录的那个文件。
指定为off时,不进行设置文件的检索。
[Note]
RTX1200/RTX800 Rev.10.01.33 以后、和 Rev.11.03 系以后,FILENAME为99字符以内。
[设置例]
在misroSD卡中检索"rtx1200.bin"、作为固件文件读取
在misroSD卡中的目录"dir1"中检索"rtx1200.bin",作为固件文件读取
[默认值]
*:机型名.bin 0 (RTX1200, RTX820, RTX800)
sd1:机型名.bin 0 (RTX5000)
[适用机型]
RTX5000 | RTX1200 | RTX820 | RTX800 |
共通
设置文件的复制
[格式]
[设置值]
- FROM ... 复制源文件名 (FILENAME为64字符以内)
- NUM ... 内置式Flash ROM的设置文件编号(0..4.2)
- usb1:FILENAME ... USB1存储内的设置文件名
- usb2:FILENAME ... USB2存储内的设置文件名
- sd1:FILENAME ... microSD卡内的设置文件名
- TO ... 复制目标文件名 (FILENAME为64字符以内)
- NUM ... 内置式Flash ROM的设置文件编号(0..4)
- usb1:FILENAME ... USB1存储内的设置文件名
- usb2:FILENAME ... USB2存储内的设置文件名
- sd1:FILENAME ... microSD卡内的设置文件名
- CRYPTO ... 加密算法的选择
- aes128 ... 用AES128加密
- aes256 ... 用AES256加密
- PASSWORD ... 加密/解密的密码(ASCII字符串,半角8字符以上、32字符以内)
[说明]
复制保存中的设置文件。
不能在复制源,复制目标中同时指定为外部存储的文件。
cold start后,因为不存在设置文件所以不能从内置式Flash ROM,复制设置文件到外部存储上。这时,必须执行一次 save 命令来保存设置。
复制到内置式Flash ROM中的内容,不会就此反映实际的动作。为了反映复制的内容,需要在命令执行后重启路由器。
指定复制源为外部存储时,FILENAME可以使用绝对路径指定或者只指定文件名。FILENAME只指定文件名时,会在外部存储内自动检索。
存在多个同名文件时,会选择在目录结构上最接近根目录,字母顺序优先的目录中的文件。
指定复制目标为外部存储时,FILENAME使用绝对路径指定文件。
以外部存储为对象,可以使用加密功能。
指定了CRYPTO时,设置文件会在加密后复制到外部存储中。加密复制时,文件名需要指定为包含.rtfg 扩展名,或者省略扩展名。省略扩展名时,会自动的加上.rtfg扩展名。
省略密码也可以进行加密。
[Note]
外部存储上加密过的设置文件不解密的话是不能复制到内置式Flash ROM中的。
第2格式只有在将内置式Flash ROM中的设置文件加密复制到外部存储中时才能使用。
第3格式只有在将外部存储内的加密的设置文件解密后复制到内置式Flash ROM时才能使用。解密时会自动判别加密算法,所以没必要指定加密算法。
只有拥有外部存储接口的机型可以指定外部存储内的文件。
内置式Flash ROM的设置文件号作为复制目标文件时,原来的复制目标文件在执行本命令后变为回滚文件。
根据外部存储的目录结构和文件数,可能需要花时间进行文件的检索。
为了缩短检索时间,避免生成层次较深的目录,在离根目录较近的文件保存文件,使用绝对路径直接指定等。自动检索的超时时间可以用 external-memory auto-search time 命令设置。
RTX1200/RTX800 Rev.10.01.33 以后、和、Rev.11.03 系以后,FILENAME为99字符内。
[适用机型]
RTX5000 | RTX1200 | RTX820 | RTX800 |
固件文件复制到内置式Flash ROM中
[格式]
[设置值]
- FROM ... 复制源文件名 (FILENAME为64字符以内)
- NUM ... 内置式FlashROM的固件文件号(0)
- usb1:FILENAME ... USB1存储内的固件文件名
- usb2:FILENAME ... USB2存储内的固件文件名
- sd1:FILENAME ... microSD卡内的固件文件名
- TO ... 复制目标文件名
- NUM ... 内置式FlashROM的固件文件号(0..1)
[说明]
将固件文件复制到内置式Flash ROM中。
为了将复制到内置式Flash ROM的内容反映到实际运行中,执行本命令后需要重启路由器。
复制源指定外部存储时,FILENAME可以使用绝对路径或只用文件名指定。FILENAME只指定文件名时,会在外部存储内自动检索。
存在多个同名文件时,会选择在目录结构上最接近根目录,字母顺序优先的目录中的文件。
[Note]
只有拥有外部存储接口的机型可以指定外部存储内的文件。
只有拥有多个固件功能的机型可以指定0以外复制目标固件文件号。
根据外部存储的目录结构和文件数,可能需要花时间进行文件的检索。
为了缩短检索时间,避免生成层次较深的目录,在离根目录较近的文件保存文件,使用绝对路径直接指定等。
自动检索的超时时间可以用 external-memory auto-search time命令设置。
RTX1200/RTX800 Rev.10.01.33 以后、和、Rev.11.03 系以后,FILENAME为99字符以内。
[适用机型]
RTX5000 | RTX1200 | RTX820 | RTX800 |