Server

From Bondix Wiki
Revision as of 13:50, 10 November 2023 by Sylvia (talk | contribs) (→‎Preparations)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Start > Marketing Material > Manuals > S.A.NE Server v01

Preparations

To install the Bondix S.A.NE Server, you will need a few minutes of stable Internet, a web browser, and possibly some coffee or tea.

Supported Browsers

The following browsers have been tested to function properly with Bondix S.A.NE:

  • Google Chrome
  • MS Edge
  • Mozilla Firefox

Updating the S.A.NE Server

If you want to update your Bondix S.A.NE server version, first delete the old installation scripts on your Linux VM by using the following command: 

rm install-bondix-server.sh*

After that, just repeat the installation process as described above.

⚠️ This will NOT delete your server configuration! It will only delete the installation scripts and a recommended measure before updating your server. ⚠️

Installing the Linux VM (Ubuntu 20.4)

⚠️ For the installation, you will need root rights. ⚠️

Set your firewalls to the following settings: 

S.A.NE server port shares 
- TCP: 443, 80 
- UDP: 44343 
SSH (Optional): 22

Make sure your server has a public static IP and is reachable from the Internet.

Execute the following script in the terminal window of your server to download the latest version of the S.A.NE server: 

wget https://releases.bondix.dev/endpoint/install-bondix-server.sh
  • 1-linux-install.png

To start the installation, enter the following commands: 

chmod a+x install-bondix-server.sh 
sudo ./install-bondix-server.sh

Confirm all the following prompts with the Enter key for a standard installation.

  • 2-linux-install.png

After completing the installation, you can reach S.A.NE server web interface at the IP address shown. Log in with the username “admin” and the password previously generated during installation.

  • 3-login.png

Bondix S.A.NE Server

Licensing

If your server is not already licensed, you first need to activate the S.A.NE Server Tunnel license under the menu item “Licensing”.

  • 4-nolicense.png
  • 5-activate-license.png

  Enter the S.A.NE license key here, as well as a valid email address to which the license key is bound. You can also enter a name for the server instance here. Then press “Submit”.

  • 6-license-key.png

After the successful activation, the Licensing overview will display the number of licensed tunnels as well as the expiry date of your active tunnel subscriptions with the respective expiry date and the maximum number of active server instances possible under this license number.

  • 7-successful-activation.png

You can add further additional tunnels/server instances at any time under the item “Activate License”.  

Administration

Overview

This is the web interface of a licensed S.ANE server.

  • 8-overview.png

 

Bondix S.A.NE Tunnels

To connect a S.A.NE-compatible router to a S.A.NE server, you first need to create a tunnel for this respective router. Only then does the server know that there will be a new router to receive data from and send data to.

Create a new S.A.NE tunnel

Navigate to the menu item “Tunnel”. Select the tunnel environment for which you want to create the tunnel by clicking the corresponding tab; the default is set to “env0”. Then, assign a unique tunnel name and press “Create”.

⚠️ The tunnel name must not contain any spaces. ⚠️

  • 9-add-tunnel.png
  • 10-add-tunnel-detail.png

You will then automatically be navigated to the settings window of the newly created tunnel. There, set a password for establishing the connection, make sure that “Enabled” is ticked, and then press “Save”.

  • 11-tunnel-added.png

Your tunnel is now displayed under the menu item “Overview”. You can access settings for each tunnel simply by clicking on the tunnel name.

  • 12-tunnel-overview.png

 

Connect a compatible router to a S.A.NE server.

Make sure that the latest Bondix S.A.NE client is installed on your router. Go to the settings menu of your router’s S.A.NE client and enter the server’s IP address and the tunnel name and password you created in chapter 3.2.2 in the corresponding fields. Save your entry and then restart the service (Restart Service).

  • 13-tunnel-credentials.png

  The tunnel is now listed in the S.A.NE server’s menu “Overview” including the number of its active connections. Click on the tunnel name to access the tunnel settings and options.

  • 12-tunnel-overview.png
Tunnel details and settings
Functions
  • 14-functions.png
Function Effect
1 Enabled Activates (ticked) or deactivates (unticked) the tunnel.
2 Revert Undoes any changes that have not yet been saved.
3 Save Saves changes.
4 Channel Provides an overview of channels currently connected.

  Function “Override Client Settings” If you activate this on server side, local tunnel presets and WAN priority settings of the connected router are overwritten or reset by the server’s S.A.NE. You will need to restart the tunnel.

  • 15-override-client-settings.png
Actions
  • 16-actions.png
Function Effect
1 Restart tunnel Allows the tunnel connection to be disconnected briefly and then reconnected. This is needed for some changes to take effect.
2 Open Monitor Displays a graphical overview of the connections of the router.
3 Expert Settings Opens the server-side Bondix S.A.NE web monitor for diagnostic purposes.
4 Delete Tunnel Deletes a tunnel permanently without the possibility to restore it.
Tunnel Environments

In Bondix S.A.NE, a tunnel environment is a pool of resources used by a group of tunnels. This includes packet cache, CPU core, a UDP listener, and a virtual network interface.

Add Environments

During the S.A.NE server installation, the software automatically creates a default environment with the name “env0”. You can create and add further environments via the menu item “Add Environment”.

  • 17-tunnel-environments.png
UDP Listener settings

For common scenarios, select “0.0.0.0 (Any Interface)” for the UDP Listener IP.

⚠️ Each environment must be assigned its own unique UDP Listener Port. This port must not be used elsewhere in the system, and it must not be blocked by a firewall. ⚠️

Virtual Interface settings

Leave the Virtual Interface Name blank to automatically generate a name for it.

⚠️ The Virtual Interface Name and the Virtual Network (CIDR) assigned to the Tunnel Environment must also be unique, not to be used in any other environment. ⚠️

Outgoing settings

The Outgoing Interface describes where you want to route your data traffic. Optionally, you can enter a specific Outgoing IP address.

Activate Tunnel-to-Tunnel Communication

The option “Disable traffic among routers” is activated by default due to Bondix S.A.NE providing multi-tenancy support. This feature prevents routers assigned to a Tunnel Environment from communicating with each other. If you deactivate “Disable traffic among routers”, routers in the same environment can interact. You can adjust this setting separately for each environment.

Troubleshooting

Sometimes, your Bondix S.A.NE server will not work as expected. If that happens, you may find possible solutions in this section.

Problem Solution
? Re-install Server (Update)
? Remove Server
? Start Bondix Service
? Stop Bondix Service
? Server update notification in Web interface update via console

Bondix Server Log

This is an exemplary overview of a server’s current log messages:

  • 18-server-log.png

Download

Download this manual as a PDF file from here: bondix_server_manual_v1_202202.pdf

Retrieved from "https://wiki.bondix.dev/index.php?title=Server&oldid=628"