vNET : Documentations : Basic Usage

This document is not the complete documentation, which will come later, when the development phase will be achieved, it a basic tutorial to help you having a running vnet, and let you explore the functionnnality.

Architecture Presentation

The architecture of the vNET system is the following :

a probe (vnetprobe) that will realize operation for you, and build some knowledge about the world
a client (vnetclient), the graphical part, which will help you connect to the probe(s), control them and visaluize the world

So you will a have to configure, the client and the probe, they can be on the same computer or on differents host (even differents network). This architecture lets you, for example, put some probe in various network and connect to all of them to view all your network in a unified interface. OK ? let's go !

Configuring the client

You will need to configure the client, using the vnetclient.conf file (probably located in /etc/vnet), the file is totaly commented, and should work directly
The first time you launch vNET, it will probably show you a configuration window for the Ogre 3d engine, so that you tune your configuration for your computer
And it's done.

Configuring the probe

You will need to configure the probe, using the vnetprobe.conf file (probably located in /etc/vnet), the file is totaly commented, and should work directly (you can setup the SSL tunnel by activating the SSLListener and running the generateCertificate.sh in /etc/vnet).
You can now run the probe (need root if you use particular operations (ping sweep, sniffer ..)).

Huhu, it's also done.

Using the system

Run vnetClient, click the Connect buttom at top left, specify the probe address using the following format tcp://address:port or ssl://address:port according to your probe configuraiton. A new world should have appeared (with one host, your probe). You can now switch between the two modes using the F1 key :

FreeLook : travel through you network, select host, moving the mouse or by middle-clicking on a host or network
GUI : operational mode, use the different action left-clicking on a host, a network or anywhere. The menu is contextual, so if you click on a host, it will display the operations that can be applied to the host and so ...

There's also two box :

Properties : display the properties of the current selection
AlertBox : let you manage the differents alerts fetch by your client

You can quit using the Exit button or by pressing the Escape touch.
That's all folks for this time !