Patch Files

A patch file is a compact way to represent differences between plan files. These differences or patches can be applied to other plan files or deployed to the network.

In WAE Design, patch files use a.plp format. You can create, view, and apply patches using the Tools->Patches menus.

A common WAE Design use case would be to create a plan file for deployment. One potential workflow for doing this is the following.

1.blank.gif Open a plan file from a WAE Automation server. (File->Open from->WAE Automation Server)

2.blank.gif Duplicate the plan file by saving it as a different name.

3.blank.gif Make LSP modifications as needed in the duplicated plan file.

4.blank.gif Open both plan files, and create a patch file. (Tools->Patches->Create)

5.blank.gif Deploy this patch file to the network. (File->Save to->WAE Automation Server)

Create Patch Files

The patch created identifies how to get from the plan file identified in the From Plan field to the plan file identified in the To Plan field. These patch files only include differences in new, modified, and deleted LSPs, LSP paths, named paths, named path hops, segment lists, and segment list hops.

408325.jpg

Examples:

  • If From Plan Edge-AK contains 33 LSPs and To Plan Edge-EP contains 23 LSPs, the patch file would identify which 10 LSPs to delete from plan Edge-AK to create plan Edge-EP.
  • If From Plan Edge-AK contains 10 LSPs and To Plan Edge-EP contains 15 LSPs, the patch file would identify which 5 LSPs to add to plan Edge-AK to create plan Edge-EP.
  • If both plan files contain the same LSP, but in From Plan Edge-AK the LSP has a PCEP property of T (true), whereas in the To Plan Edge-EP it does not, the patch file would identify the need to modify the PCEP property of this LSP in plan Edge-AK so that it matches plan Edge-EP.

Step 1blank.gif Open the two plan files that you are using for the patch file creation.

Step 2blank.gif From the plan file used as the To Plan, which is the plan file you want to achieve using the patch file, select the Tools->Patches->Create menu. The Create Patch dialog box appears.

Step 3blank.gif In the From Plan field, select the plan file from which you are determining required changes to achieve the plan file identified in the To Plan field.

Step 4blank.gif The default patch file name combines the From and To plan file names. If needed, change the file name. It must have a.plp extension. Unless you want the patch file to be overwritten, the patch file name must be unique to its location.

Step 5blank.gif Enter or browse to the location where you want the resulting patch file to reside.

Step 6blank.gif Click OK.


 

Apply Patch Files

You can apply patch files to plan files. These patch files can contain differences in LSPs, L3 ports, L3 port circuits, and L1 circuits.

To verify a patch file’s contents prior to applying it, click View Patch.


Step 1blank.gif Open the plan file to which you want to apply the patch.

Step 2blank.gif Select the Tools->Patches->Apply menu. The Apply Patch dialog box appears.

Step 3blank.gif Enter or browse to the location where the patch file resides.

Step 4blank.gif Enter a unique name for the plan file you want to create as a result of this applied patch.

Step 5blank.gif Click OK.


 

View Patch Files

Viewing patch files enables you to ensure they meet your needs before applying or deploying them.


Step 1blank.gif Select the Tools->Patches->View menu.

Step 2blank.gif Browse to and select the patch file, and then click Open.


 

Related Topics

  • WAE Network Visualization Guide (For deploying patch files)