ONU 配置文件功能介绍zhangjx

一．概述

在GFA6900的新版本V1R10B116上，新增加了ONU配置文件功能，该功能提供了配置ONU的另一种方式，此方式和以前的ONU配置方式的比较如下：

1、以前的ONU配置是在ONU配置节点下进行的，所作配置只影响一个ONU，配置文件保存在ONU本地。

2、通过配置文件方式配置ONU时，配置文件保存在OLT上，可以通过OLT下发给ONU，并且在ONU每次上线时都重新下发一次配置文件。多个ONU可以共享同一个配置文件，从而实现ONU批量配置功能。可以提前配置ONU所关联的配置文件，从而实现ONU预配置功能。

        配置文件有2种类型：1）共享配置文件，这是指多个ONU共享使用的配置文件；2）私有配置文件，这是只能由单个ONU使用的配置文件。默认情况下ONU使用的是私有类型配置文件，只有当手工给ONU关联配置文件时，ONU才使用共享类型的配置文件。

        使用配置文件方式配置ONU的步骤是：1）首先在OLT上创建一个配置文件；2）将相关的ONU关联到配置文件上，配置文件就会自动下发并应用到这些ONU上。

        需要注意ONU的配置文件保存命令和OLT的配置文件保存命令是关联在一起的，每次修改ONU的配置文件后，都要在Config节点下执行一次Save命令，这个命令会同时将OLT和ONU的配置文件都保存一次。

        有一个特殊的共享配置文件是onuconfdef，这是一个空配置文件，首次注册的ONU如果没有提前指定关联的配置文件，就会默认关联到这个配置文件，实际的执行效果是未对ONU做任何配置操作。

二．应用场景

一）升级OLT的版本，只使用GW类型的ONU，沿用以前的ONU配置方式。

在这种应用方式下，用户操作方式不需要任何改变，仍使用以前的方式，进入ONU节点对ONU进行配置和保存配置操作。

二）升级OLT的版本，只使用CTC类型的ONU（目前只有一种型号GT811C）。

       在这种应用方式下，用户可以使用共享配置文件，也可以使用私有配置文件对

ONU进行配置。 

1、使用共享配置文件时，分2种应用情况：

1）如果共享配置文件还未创建，则需要先创建共享配置文件，再将配置文件关联到ONU上，示例如下：

GFA6900(config)#config onu-profile testshare

onu-profile(testshare)#vlan dot1q_add 100

onu-profile(testshare)#vlan dot1q_port_add 100 1 1

onu-profile(testshare)#ex

              GFA6900(config)#onu-profile associate 10/2 1-2 testshare

GFA6900(config)#show onu-profile pon 10/2 1-2

pon10/2:

onuid       name          share     mac addr          device name

1         testshare        yes      000f.e903.c992      GT811_C

2         testshare        yes      0011.2233.4405      GT811_C

           2） 如果该共享配置文件已经存在了，则只需要对ONU进行配置文件关联操作即可。示例如下：

              GFA6900(config)#onu-profile associate 10/2 1-2 testshare

2、使用私有配置文件配置ONU，用户可以沿用以前的配置方式，进入ONU配置节点进行配置（不需要保存ONU配置的操作），系统会自动创建一个ONU私有配置文件onux/x/x并将修改的配置同步更新到文件onux/x/x中。在退出onu节点时，此处分两种情况：

1）进入onu节点配置前，onu关联的配置文件为默认的onuconfdef文件，在退出onu节点时直接创建并关联私有的onux/x/x配置文件，没有提示信息。示例如下：

GFA6900(epon-onu10/2/2)#show profile name

profile name: onuconfdef

GFA6900(epon-onu10/2/2)#vlan dot1q_add 100

GFA6900(epon-onu10/2/2)#vlan dot1q_port_add 100 1 1

GFA6900(epon-onu10/2/2)#ex

GFA6900(config)#show onu-profile onu 10/2/2

pon10/2:

onuid       name           share     mac addr          device name

2         onu10/2/2        no       0011.2233.4405     GT811_C 

2）进入onu节点配置前，onu关联的配置文件不是onuconfdef而是其他的共享配置文件，则在退出onu节点时会提示是否保存私有配置文件onux/x/x。

   示例如下：

GFA6900(epon-onu10/2/2)#show profile name

profile name: testshare

GFA6900(epon-onu10/2/2)#vlan dot1q_add 200

GFA6900(epon-onu10/2/2)#vlan dot1q_port_add 200 2 1

GFA6900(epon-onu10/2/2)#ex

the onu's configuration has changed, will you agree to save it? [Y/N]y

GFA6900(config)#

GFA6900(config)#show onu-profile onu 10/2/2

pon10/2:

onuid       name           share     mac addr          device name

2         onu10/2/2        no       0011.2233.4405     GT811_C

三）升级OLT的版本，使用GW类型的ONU，改用配置文件方式配置ONU。

       目前只支持对GT811命令行风格的ONU进行配置文件管理。

       使用配置文件方式配置GW类型之前，需要使用下面的命令，将GW类型的ONU的命令行透传功能关闭：

         GFA6900(config)#onu transmission-flag disable

       可以使用下面的命令查看GW ONU命令透传功能的当前设置：

         GFA6900(config)#onu transmission-flag

onu transmission-flag is disable

           和CTC 类型的ONU一样，用户既可以使用私有配置文件，也可以使用共享配置文件对GW ONU进行配置。需要注意的是，由于OLT软件目前还不支持将GW型号ONU的当前配置导出到ONU配置文件中，所以在这种应用方式下，用户需要自己重新生成配置文件，并将配置文件关联到GW ONU上。

当配置文件关联到GW ONU后，GW ONU的当前配置会被清空，重新下发新的配置。

具体的ONU 配置文件步骤和CTC 类型的ONU配置步骤一致（需要首先按上面的描述，将ONU的命令行透传功能关闭）

四） 升级OLT的版本，既使用GW类型的ONU，也使用CTC类型的ONU。

 在这种应用方式下，对CTC类型的ONU的配置过程，和应用场景二中的一致；对GW类型的ONU，可以选择继续按照以前的配置方式操作（默认命令行透传），也可以改用新的配置文件方式操作（需要关闭命令行透传功能，参考应用场景三）。

五）将共享配置文件关联到多个ONU后，修改共享配置文件的内容。

 方法：进入配置文件编辑节点，直接修改配置文件的内容，在退出配置配置文件编辑节点时，系统会提示是否要保存并应用所作的修改，选择是（输入字母Y），配置文件就会被修改，并下发到所有关联的ONU。

注意需要在Config节点下执行一下save操作以保存所作的修改。示例如下：

GFA6900(config)#config onu-profile testshare

onu-profile(testshare)#vlan dot1q_add 200

onu-profile(testshare)#vlan dot1q_port_add 200 2 1

onu-profile(testshare)#ex

the file has been modified, will you agree to save and apply it to all associated ONUs? [Y/N]y

GFA6900(config)#save

六）ONU使用私有配置文件，需要修改私有配置文件的内容。

1、可以进入ONU节点直接修改配置，修改的配置直接同步更新到关联的私有配置文件上。示例如下：

GFA6900(config)#onu 10/2/2

GFA6900(epon-onu10/2/2)#vlan dot1q_add 200

GFA6900(epon-onu10/2/2)#ex

GFA6900(config)#show onu-profile text onu10/2/2

!vlan config

vlan dot1q_add 100

vlan dot1q_port_add 100 1 1

vlan dot1q_add 200

!

2、进入配置文件编辑节点，修改配置文件的内容。在退出文件编辑节点时，系统会提示是否保存所作的修改，选择是（输入字母Y），配置文件被修改，并将修改的配置下发到关联的onu上。示例如下：

   GFA6900(config)#config onu-profile onu10/2/2

onu-profile(onu10/2/2)#vlan dot1q_port_add 200 2 1

onu-profile(onu10/2/2)#ex

the file has been modified, will you agree to save and apply it to all associated ONUs? [Y/N]y

注意需要在Config节点下执行一下save操作以保存所作的修改。

七）多个ONU共享一个配置文件，需要修改某个ONU的配置，其它ONU配置不变。

             方法：可以进入需修改配置的ONU节点，直接修改ONU的配置，在退出编辑节点时，系统会提示配置文件已经改变，是否需要生成一个私有配置文件，选择是（输入字母Y），系统会自动生成一个私有配置文件，并关联到该ONU。详情参考应用场景二中的2情况。

注意需要在Config节点下执行一下save操作以保存所作的修改。

八）ONU原来使用配置文件A，需要改用配置文件B。

            方法：重新执行一次ONU配置文件关联的命令，将ONU关联到配置文件B，

系统会首先将ONU上的配置文件A清除，再下发一次配置文件B。示例如下：

GFA6900(config)#show onu-profile onu 10/2/2

pon10/2:

onuid      name         share    mac addr          device name

2          a            yes      0011.2233.4405    GT811_C

GFA6900(config)#onu-profile associate 10/2 2 b

GFA6900(config)#show onu-profile onu 10/2/2

pon10/2:

onuid      name         share    mac addr          device name

2          b            yes      0011.2233.4405    GT811_C

注意需要在Config节点下执行一下save操作以保存所作的修改。

九）将某个ONU使用的私有配置文件，改为共享配置文件，关联到其它的ONU。

            方法：目前没有专门的命令实现这个功能，只能重新创建一个新的共享配置文件，将私有配置文件中的内容复制到共享配置文件中，再将共享配置文件关联到其他onu上。示例如下：

GFA6900(config)#config onu-profile test

onu-profile(test)#ex

GFA6900(config)#onu-profile copy onu10/2/2 test

          GFA6900(config)#onu-profile associate 10/2 3-5 test

一十）如何查看配置文件相关的内容（配置文件列表、内容、关联关系等）。

       相关命令如下：

1、查看系统中所有配置文件的名称列表：

       GFA6900(config)# show onu-profile list

2、查看系统中配置文件的数目：

               GFA6900(config)#show onu-profile list counter

3、查看某个配置文件的内容：

       GFA6900(config)# show onu-profile text test

4、查看某个配置文件关联的ONU信息：

       GFA6900(config)# show onu-profile name test

5、查看某个onu关联的配置文件信息：

       GFA6900(config)#show onu-profile onu 10/2/2

6、查看某个（所有）PON口下的ONU各自关联的配置文件名称：

       GFA6900(config)#show onu profile list pon 10/4 1-10

       GFA6900(config)#show onu profile list pon 10/4 all

       GFA6900(config)#show onu-profile pon all 1-10

       GFA6900(config)#show onu-profile pon all all

7、查看OLT上已经保存的所有ONU配置文件。

       GFA6900(config)# show onu-profile startup

一十一）通过配置文件方式，实现ONU批量配置功能。

            方法：创建一个共享配置文件，将该配置文件关联到多个ONU。示例如下：

   GFA6900(config)#config onu-profile test

   onu-profile(test)# vlan dot1q_add 100

onu-profile(test)#vlan dot1q_port_add 100 1 1

onu-profile(test)#ex

   GFA6900(config)#onu-profile associate 10/2 1- test

一十二）通过配置文件方式，实现ONU离线配置功能。

            如果某个ONU已经离线，可以修改该ONU对应的ID值所关联的配置文件，这样在ONU下次重新上线时，就会下发新的配置文件，不用等ONU在线时修改。

一十三）通过配置文件方式，实现ONU预配置功能。

            通过配置文件方式，目前可以实现2种方式的预配置：.

1、如果该PON口下未来将要上线的ONU的配置都一样，则可以预先指定目前还未使用的ONU ID值所关联的配置文件，则以后新注册的ONU上线后会下发对应ID所关联的配置文件。

2、如果知道将要上线的ONU对应的MAC地址，则可以通过先手工添加ONU注册信息，给ONU指定一个ID值，再指定对应的ID值关联的配置文件的方式，实现ONU的预配置功能。示例如下：

     GFA6900(config)#pon 10/2

     GFA6900(epon-pon10/3)#add onu 2 0001.0002.0003

     GFA6900(epon-pon10/3)#exit

     GFA6900(config)# onu-profile associate 10/2 2 test

一十四）通过配置文件方式，实现备份与恢复onu配置功能。

      配置文件方式下，可以通过命令实现对onu配置的备份与恢复。

      备份：通过upload ftp [onu-profile] 命令可以将OLT中保存的配置文件及关联关系等信息备份到ftp服务器上。

      恢复：通过download ftp [onu-profile] 命令可以将服务器中的配置文件及关联关系等信息恢复到OLT上。

一十五）正常运行状态下，一个onu从一个pon口转移到另一个pon口下。

        如果一个onu更换注册的pon口，则onu按照新pon口的关联关系关联配置文件。onu转移后，清除onu原来的配置，下发新pon口onu关联的配置文件的配置。

一十六）某个ONU出现故障，需要替换为新的ONU，配置文件需要同时倒换。

1、如果故障ONU关联的是共享配置文件，可以手工将新ONU的注册信息添加到PON口下，并将新ONU的注册ID和故障ONU的配置文件做一下关联，新onu上线后配置正确下发。示例如下：

     GFA6900(config)#show onu-profile onu 10/2/2

pon10/2:

onuid      name           share    mac addr          device name

2          test           yes      0011.2233.4405    GT811_C

     GFA6900(config)#pon 10/2

GFA6900(epon-pon10/2)#add onu 5 000f.e907.704d

GFA6900(epon-pon10/2)#ex

GFA6900(config)#onu-profile associate 10/2 5 test

GFA6900(config)#show onu-profile onu 10/2/5

pon10/2:

onuid        name            share    mac addr          device name

5            test            yes      000f.e907.704d

2、如果故障ONU关联的是私有配置文件，可以手工将新ONU的注册信息添加到PON口下，然后创建一个新的共享配置文件，将私有配置文件的配置信息复制到新建的共享配置文件上，再将新ONU的注册ID和共享配置文件做关联，新onu上线后配置正确下发。示例如下：

     GFA6900(config)#show onu-profile onu 10/2/2

pon10/2:

onuid       name             share    mac addr          device name

2           onu10/2/2        no       0011.2233.4405    GT811_C

GFA6900(config)#pon 10/2

GFA6900(epon-pon10/2)#add onu 5 000f.e907.704d

GFA6900(epon-pon10/2)#ex

GFA6900(config)#config onu-profile test1

onu-profile(test1)#ex

GFA6900(config)#onu-profile copy onu10/2/2 test1

GFA6900(config)#onu-profile associate 10/2 5 test1

GFA6900(config)#show onu-profile onu 10/2/5

pon10/2:

onuid       name             share    mac addr          device name

5           test1            yes      000f.e907.704d

一十七）某个PON口出现故障，需要将ONU迁移到另一个PON口下。

首先使用文件迁移命令将故障pon口的onu注册信息及与配置文件的关联信息转移到新pon口下。

1）如果转移的onu均没有在新pon口下注册过，则按照之前的注册顺序在新pon口注册。onu的关联关系及mac信息也随之转移。如果转移前onu关联的文件为共享配置文件，则转移后onu仍然关联此共享配置文件，如果onu关联的文件为私有配置文件，则新建一个新pon口的onux/x/x文件，并将配置内容复制到新文件上。

示例如下：

GFA6900(config)#show onu-profile pon 10/2 1-4

pon10/2:

onuid      name             share    mac addr          device name

1         test              yes      000f.e903.c992     GT811_A

2         onu10/2/2         no      0011.2233.4405     GT811_C

3         test              yes      000f.e907.704d     GT811_C

4         onuconfdef        yes      ffff.ffff.ffff

GFA6900(config)#show onu-profile pon 10/3 1-4

pon10/3:

onuid       name             share    mac addr          device name

1          onuconfdef        yes     000f.e903.7995

2          onuconfdef        yes     ffff.ffff.ffff

3          onuconfdef        yes     ffff.ffff.ffff

4          onuconfdef        yes     ffff.ffff.ffff

GFA6900(config)#onu-profile switch 10/2 10/3

GFA6900(config)#show onu-profile pon 10/2 1-4

pon10/2:

onuid       name             share    mac addr          device name

1          test              yes      000f.e903.c992     GT811_A

2          onu10/2/2         no      0011.2233.4405     GT811_C

3          test              yes      000f.e907.704d     GT811_C

4          onuconfdef        yes      ffff.ffff.ffff

GFA6900(config)#show onu-profile pon 10/3 1-4

pon10/3:

onuid       name             share    mac addr          device name

1          onuconfdef        yes      000f.e903.7995

2          test              yes      000f.e903.c992

3          onu10/3/3         no       0011.2233.4405

4          test              yes      000f.e907.704d

2）如果转移的onu有的在新pon口下曾经注册过，则注册过的按照之前的注册id注册，没有注册过的按照新的注册id注册。共享及私有文件转移规则同上。示例如下：

GFA6900(config)#show onu-profile pon 10/2 1-3

pon10/2:

onuid      name             share    mac addr          device name

1         test              yes      000f.e903.c992     GT811_A

2         onu10/2/2         no      0011.2233.4405     GT811_C

3         test              yes      000f.e907.704d     GT811_C

GFA6900(config)#show onu-profile pon 10/4 1-3

pon10/4:

onuid       name             share    mac addr          device name

1          onuconfdef        yes     000f.e907.704d      GT811_C

2          onuconfdef        yes     ffff.ffff.ffff

3          onuconfdef        yes     ffff.ffff.ffff

              GFA6900(config)#onu-profile switch 10/2 10/4

GFA6900(config)#show onu-profile pon 10/2 1-3

pon10/2:

onuid      name             share    mac addr          device name

1         test              yes      000f.e903.c992     GT811_A

2         onu10/2/2         no      0011.2233.4405     GT811_C

3         test              yes      000f.e907.704d     GT811_C

GFA6900(config)#show onu-profile pon 10/4 1-3

pon10/4:

onuid       name             share    mac addr          device name

1          test              yes     000f.e907.704d      GT811_C

2          test              yes     000f.e903.c992

3          onu10/4/3         no     0011.2233.4405

然后将故障pon口下的所有onu物理转移到新pon口下，配置正确下发到onu上。

注意，对于pon口迁移功能，建议先设置迁移命令后，再物理转移onu。否则会存在一些问题。

一十八）将2个PON口下的ONU合并到1个PON口下。

利用pon口迁移命令将一个pon口下的onu与配置文件的关联关系迁移到另一个pon口下，目的pon口下原有onu的关联关系保持不变，从源pon口中转移的onu会根据pon口迁移规则分配注册id，之后转移源端口的onu，从而实现两个pon口的合并。本场景与场景十七情况类似，示例请见场景十七。

Pon口迁移规则：

对于曾经在目的pon口下注册过的onu，转移后onu的id号为之前注册的id号。对于未曾在目的pon口下注册过的onu，转移后onu的id号从目的pon口下第一个可用的id号起按照源pon口下注册id顺序分配id号。Onu与配置文件的关联关系和mac信息也随之转移。

对于关联共享配置文件的onu，转移后仍然关联的是此共享文件。对于关联私有配置文件的onu，转移后系统自动创建一个以转移后onuid命名的私有配置文件，并将原有私有配置文件的配置复制到新创建的私有配置文件上。

一十九）应用了PON口保护倒换的情况下。

       PON口保护倒换的原则是：

1.执行两个PON端口为保护端口命令;

2.将当前活动PON口上的关联关系迁移到PON ID较小的PON端口上，不管这个PON端口当前是否是活动的;

3.迁移完成后，这对PON端口上的ONU需要恢复配置时，都从较小的PON ID的端口寻找映射关系;

4.当解除PON口保护时，系统再次发生ONU配置迁移的操作。把映射关系由PON ID较小的PON端口迁移至当前活动的端口上来。

示例如下：

GFA6900(config)#show onu-profile pon 10/2 1-3

pon10/2:

onuid       name             share    mac addr          device name

1           a                yes      000f.e903.c992    GT811_A

2           b                yes      0011.2233.4405    GT811_C

3           onu10/2/3         no       000f.e907.704d    GT811_C

GFA6900(config)#show onu-profile pon 10/3 1-3

pon10/3:

onuid       name             share    mac addr          device name

1           onuconfdef       yes      ffff.ffff.ffff

2           onuconfdef       yes      ffff.ffff.ffff

3           onuconfdef       yes      ffff.ffff.ffff

           GFA6900(config)#

GFA6900(config)#auto-protect pon 10/2 partner 10/3

GFA6900(config)#show onu-profile pon 10/2 1-3

pon10/2:

onuid       name             share    mac addr          device name

1           a                yes      000f.e903.c992    GT811_A

2           b                yes      0011.2233.4405    GT811_C

3           onu10/2/3         no       000f.e907.704d    GT811_C

GFA6900(config)#show onu-profile pon 10/3 1-3

pon10/3:

onuid       name             share    mac addr          device name

1           a                yes      000f.e903.c992

2           b                yes      0011.2233.4405

3           onu10/2/3         no       000f.e907.704d

GFA6900(config)#

2011-11-01,19:01:56 GFA6900 pon10/3 pon auto-protect switch

2011-11-01,19:01:56 GT811_A(10/2/1) onu not present:REPORT_TIMEOUT

2011-11-01,19:01:56 GT811_C(10/2/2) onu not present:REPORT_TIMEOUT

2011-11-01,19:01:56 GT811_C(10/2/3) onu not present:REPORT_TIMEOUT

2011-11-01,19:01:58 GT811_A(10/3/1) onu re-register

2011-11-01,19:02:02 GT811_C(10/3/2) onu re-register

2011-11-01,19:02:02 GT811_C(10/3/3) onu re-register

GFA6900(config)#show onu-profile pon 10/2 1-3

pon10/2:

onuid       name             share    mac addr          device name

1           a                yes      000f.e903.c992    GT811_A

2           b                yes      0011.2233.4405    GT811_C

3           onu10/2/3         no       000f.e907.704d    GT811_C

GFA6900(config)#show onu-profile pon 10/3 1-3

pon10/3:

onuid       name             share    mac addr          device name

1           a                yes      000f.e903.c992    GT811_A

2           b                yes      0011.2233.4405    GT811_C

3           onu10/2/3         no       000f.e907.704d    GT811_C

GFA6900(config)#

GFA6900(config)#undo auto-protect pon 10/2

GFA6900(config)#show onu-profile pon 10/2 1-3

pon10/2:

onuid       name             share    mac addr          device name

1           onuconfdef       yes      000f.e903.c992    GT811_A

2           onuconfdef       yes      0011.2233.4405    GT811_C

3           onuconfdef       yes      000f.e907.704d    GT811_C

GFA6900(config)#show onu-profile pon 10/3 1-3

pon10/3:

onuid       name             share    mac addr          device name

1           a                yes      000f.e903.c992    GT811_A

2           b                yes      0011.2233.4405    GT811_C

3           onu10/2/3         no       000f.e907.704d    GT811_C

二十）应用了跨设备保护倒换的情况下。

请联系测试人员研究具体方案。

三．注意事项

1．以下几种类型的ONU目前不支持配置文件方式：GT813,GT813_B,GT861,GT865

2．目前还不支持将GW类型ONU的本地配置导出到一个配置文件中。