This is archived documentation for an older version of Nirvana (v2.0). Please refer to documentation for the latest version if required.

How to add a network interface to a Nirvana Realm server ?


Network Interfaces can be added to a Nirvana Realm using the nAdmin API or by using the Nirvana Realm Manager.

To add an interface using the Realm Manager GUI follow the steps below:

Step 1: Click on the interfaces panel for this Realm. In the example below an interface is being added to the nirvanaPrimary Realm. An interface could also be added however to the Realm which is mounted into this Realm's namespace under /bkup . This ability makes centralised remote administration very easy using Nirvana.

 

Step 2: Click on the Add button in order to bring up the Add Interface dialog box. In the dialog choose the network protocol you would like to use for this interface. The choices are Sockets, HTTP, Secure Sockets and HTTPS.

In this example HTTP is chosen as the protocol and the interface is added to the network adapter node249.my-Channels.com. This will run the network on the IP Address that the hostname node249.my-Channels.com resolves to. You can also specify an IP address directly for any network interface on the machine, or 127.0.0.1 for localhost or 0.0.0.0 for all network interfaces on this machine.

 

Step 3: When a new interface is added it is not started automatically because you will typically want to set security policies up as well as potential adding additional configuration (for example when adding a SSL/HTTPS interface).

After the interface has been added but before it has been started you should see the following in your interfaces panel:

In this example you can see that this Realm now has 3 network interfaces and that the one just added has not been started.

In order to start the interface please click on the line containing the stopped trafficlight. This will populate the tabs at the bottom with details for this interface.

Select the 'Basic' tab and click on the autostart interface checkbox. Then click on apply and the Interface will be started. Clicking on this box means that the interface will be started automatically when the Nirvana Realm server is started. It will also start it now.

 

Alternatively if you do not wish to autostart then double click on the line with the stopped trafficlight. This will bring up a dialog which allows you to stop or start that network interface.

 

If the network interface fails to start then please inspect the Nirvana log file via the messages tab. Please contact support@my-Channels.com if any other issues arise.

There is no limit to the number of network interfaces that can be added to a Realm and each can have its own configuration such SSL chains etc applied. This allows you to isolate customers from each other while still using only one Nirvana Realm server.