This is archived documentation for an older version of Nirvana (v3.1). 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 Enterprise Manager GUI follow the steps below:

Step 1: Click on the interfaces panel for a Realm. In the example below an interface is being added to the nirvana1 Realm. An interface could also be added however to any other Realm within the enterprise manager. 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 interface on the IP Address that is specified. You can specify 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 if the Auto Start option is not clicked the realm interface will not start automatically when a realm starts, and it will have to be started manually.

After the interface has been added you should see the following in your interfaces panel:

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

If you did not choose to start the interface automatically, then in order to start the interface you need to 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 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.

Similarly, if you wish to stop an interface, simply double-click on the interface you want to stop from the interface table, and click on the 'stop' button. The dialog below shows you what this looks like.

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.