platform: document default installation files

Document bisdn/meta-bisdn-linux/pull/203 functionality to provide default installation of l2 functionality. Signed-off-by: Rubens Figueiredo <[email protected]> Co-authored-by: ideaship <[email protected]> Co-authored-by: Jonas Gorski <[email protected]> Update platform_configuration/default_installer.md Co-authored-by: Jonas Gorski <[email protected]>
bisdn · Jul 4, 2024 · 276d1d9 · 276d1d9
1 parent 52587d4
commit 276d1d9
Showing 1 changed file with 17 additions and 0 deletions.
diff --git a/getting_started/install_bisdn_linux.md b/getting_started/install_bisdn_linux.md
@@ -65,6 +65,23 @@ onie-nos-install http://repo.bisdn.de/pub/onie/agema-ag7648/onie-bisdn-agema-ag7
 
 More information about the ONIE CLI command can be found [here](https://opencomputeproject.github.io/onie/cli/index.html#onie-nos-install).
 
+### Default Installer Files
+
+**WARNING** Setting a default configuration will reset the file system to the initial state. Only use this if you are prepared to lose all modifications of your current BISDN Linux installation.
+
+BISDN Linux by default provides no network configuration for the switch ports. To allow a more switch like default configuration, it is possible to use the environment variable `BISDN_DEFAULT_CONFIG` while installing BISDN Linux to provide a default network configuration.
+
+```
+BISDN_DEFAULT_CONFIG="simple-l2-bridge" onie-nos-install http://repo.bisdn.de/pub/onie/generic-x86-64/onie-bisdn-generic-x86-64-v5.1.X.bin
+```
+
+The following table shows the supported configuration for `BISDN_DEFAULT_CONFIG` and the expected outcome.
+
+|`BISDN_DEFAULT_CONFIG` Value|Outcome|Default|
+|(Empty)|Use previous installation configuration|Y|
+|none|Removes existing configuration and resets the switch to no default state||
+|simple-l2-bridge|Removes existing configuration and initializes the switch to behave as an unmanaged switch||
+
 ### Get the image via DHCP option 60
 
 Connect the management port to a DHCP server of your choice. The DHCP server uses “Vendor Class Identifier – Option 60” to tell the switch the URL of the image.