<p>No explicit indications are given in terms of networking besides that servers need access to the Internet for downloading dependencies, binaries, and packages while building and deploying the TeraFlowSDN components.</p>
<p>No explicit indications are given in terms of networking besides that servers need access to the Internet for downloading dependencies, binaries, and packages while building and deploying the TeraFlowSDN components.</p>
<p>Besides that, the network requirements are essentially the same than that required for running a classical Kubernetes environment. To facilitate the deployment, we extensively use <ahref="https://microk8s.io/">MicroK8s</a>, thus the network requirements are, essentially, the same demanded by MicroK8s, especially, if you consider creating a Kubernetes cluster.</p>
<p>Besides that, the network requirements are essentially the same than that required for running a classical Kubernetes environment. To facilitate the deployment, we extensively use <ahref="https://microk8s.io/">MicroK8s</a>, thus the network requirements are, essentially, the same demanded by MicroK8s, especially, if you consider creating a Kubernetes cluster.</p>
<p>As a reference, the other deployment solutions based on VMs assume the VM is connected to a virtual network configured with the IP range <code>10.0.2.0/24</code> and have the gateway at IP <code>10.0.2.1</code>. The VMs have the IP address <code>10.0.2.10</code>.</p>
<p>As a reference, the other deployment solutions based on VMs assume the VM is connected to a virtual network configured with the IP range <code>10.0.2.0/24</code> and have the gateway at IP <code>10.0.2.1</code>. The VMs have the IP address <code>10.0.2.10</code>.</p>
<p>The minimum required ports to be accessible are:
<p>The minimum required ports to be accessible are:</p>
- 22/SSH : for management purposes
<ul>
- 80/HTTP : for the TeraFlowSDN WebUI and Grafana dashboard
<li>22/SSH : for management purposes</li>
- 8081/HTTPS : for the CockroachDB WebUI</p>
<li>80/HTTP : for the TeraFlowSDN WebUI and Grafana dashboard</li>
<li>8081/HTTPS : for the CockroachDB WebUI</li>
</ul>
<p>Other ports might be required if you consider to deploy addons such as Kubernetes observability, etc. The details on these ports are left appart given they might vary depending on the Kubernetes environment you use.</p>
<p>Other ports might be required if you consider to deploy addons such as Kubernetes observability, etc. The details on these ports are left appart given they might vary depending on the Kubernetes environment you use.</p>
<h3><u>Operating System</u></h3>
<h3><u>Operating System</u></h3>
<p>The recommended Operating System for deploying TeraFlowSDN is <ahref="https://releases.ubuntu.com/jammy/">Ubuntu Server 22.04 LTS</a> or <ahref="https://releases.ubuntu.com/focal/">Ubuntu Server 20.04 LTS</a>. Other version might work, but we have not tested them. We strongly recommend using Long Term Support (LTS) versions as they provide better stability.</p>
<p>The recommended Operating System for deploying TeraFlowSDN is <ahref="https://releases.ubuntu.com/jammy/">Ubuntu Server 22.04 LTS</a> or <ahref="https://releases.ubuntu.com/focal/">Ubuntu Server 20.04 LTS</a>. Other version might work, but we have not tested them. We strongly recommend using Long Term Support (LTS) versions as they provide better stability.</p>
<p>Below we provide some installation guidelines:
<p>Below we provide some installation guidelines:</p>
- Installation Language: English
<ul>
- Autodetect your keyboard
<li>Installation Language: English</li>
- If asked, select "Ubuntu Server" (do not select "Ubuntu Server (minimized)").
<li>Autodetect your keyboard</li>
- Configure static network specifications (adapt them based on your particular setup):</p>
<li>If asked, select "Ubuntu Server" (do not select "Ubuntu Server (minimized)").</li>
<li>Configure static network specifications (adapt them based on your particular setup):</li>
</ul>
<table>
<table>
<thead>
<thead>
<tr>
<tr>
...
@@ -646,20 +650,30 @@ controller.</p>
...
@@ -646,20 +650,30 @@ controller.</p>
<ul>
<ul>
<li>Leave proxy and mirror addresses as they are</li>
<li>Leave proxy and mirror addresses as they are</li>
<li>Let the installer self-upgrade (if asked).</li>
<li>Let the installer self-upgrade (if asked).</li>
<li>Use an entire disk for the installation</li>
<li>Use an entire disk for the installation<ul>
<li>Disable setup of the disk as LVM group</li>
<li>Disable setup of the disk as LVM group</li>
<li>Double check that NO swap space is allocated in the partition table. Kubernetes does not work properly with SWAP.</li>
<li>Double check that NO swap space is allocated in the partition table. Kubernetes does not work properly with SWAP.</li>
<li>Configure your user and system names:</li>
</ul>
</li>
<li>Configure your user and system names:<ul>
<li>User name: <code>TeraFlowSDN</code></li>
<li>User name: <code>TeraFlowSDN</code></li>
<li>Server's name: <code>tfs-vm</code></li>
<li>Server's name: <code>tfs-vm</code></li>
<li>Username: <code>tfs</code></li>
<li>Username: <code>tfs</code></li>
<li>Password: <code>tfs123</code></li>
<li>Password: <code>tfs123</code></li>
<li>Install Open SSH Server</li>
</ul>
</li>
<li>Install Open SSH Server<ul>
<li>Import SSH keys, if any.</li>
<li>Import SSH keys, if any.</li>
<li>Featured Server Snaps</li>
</ul>
</li>
<li>Featured Server Snaps<ul>
<li>Do not install featured server snaps. It will be done manually later to illustrate how to uninstall and reinstall them in case of trouble with.</li>
<li>Do not install featured server snaps. It will be done manually later to illustrate how to uninstall and reinstall them in case of trouble with.</li>
<li>Let the system install and upgrade the packages.</li>
</ul>
</li>
<li>Let the system install and upgrade the packages.<ul>
<li>This operation might take some minutes depending on how old is the Optical Drive ISO image you use and your Internet connection speed.</li>
<li>This operation might take some minutes depending on how old is the Optical Drive ISO image you use and your Internet connection speed.</li>
</ul>
</li>
<li>Restart the VM when the installation is completed.</li>
<li>Restart the VM when the installation is completed.</li>
