Override Cabling (JSON)
Situations when you might want to edit the cabling map include:
- to use existing network cabling instead of recabling to the Apstra-prescribed cabling
- to change interface names or IP addresses in the existing network cabling map
- to specify a different port from the one that the Apstra cabling algorithm selected
- to avoid the use of a defective interface
To change the cabling map with a JSON file, you'll export the JSON file, edit the file, then import it back into Apstra.
CAUTION:
Overriding Apstra-generated cabling can be disruptive to the network. Use with extreme caution. For assistance with production networks, please contact Juniper Support.
- From the blueporint, navigate to Staged > Physical > Links and click the Export cabling map button to see the dialog for exporting a cabling map.
- Select JSON and click Save As File to download the file.
- Change interface names (if_name) and/or IP addresses (ipv4_addr or ipv6_addr) in the file, as applicable. Do not change any other fields. If you do, the changes will be ignored or they will result in an error message.
- From the cabling map (Staged > Physical > Links) click the Import cabling map button to see the dialog for importing a cabling map.
- Either click Choose File and navigate to the revised file on your computer, or drag and drop the file onto the dialog window.
- Click Import.
- Click Uncommitted to see the diffs between Staged and Active.
- Click the Commit button to save the changes to the Active Blueprint, or click the Revert button to discard changes and return to the previous cabling map.