Home

If you want to use the Visualiser tool to monitor your own network tests, you can now do so if you have a gmail / GitHub Id. Your id needs to be added to a whitelist to allow creation of sessions in the Visualiser tool.

• Send an email to [email protected] with the gmail/Github id you want white-listed to use the Visualiser tool. Once added you'll be able to create and manage your sessions directly from the client.

Contribution Instructions

• Clone the repository to any preferred location.
• Download and install Mongodb as per your OS.
• Create a folder anywhere on your system to host the database data. Let's refer to this path as <db_path>
• To run mongodb, from the bin folder where you have Mongodb installed run:

Win: mongod.exe --dbpath="<db_path>"

OSX/Linux: ./mongod --dbpath="<db_path>"

• Next up download and install Node with npm
• From the root of the repo run:

npm install

OSX/Linux: You'd need to add sudo to the next command

npm install -g bower

bower install

• We use React-js to render the vault collection in the viewer/timeline pages. So if you wish to modify them, you will also need to install jsx tools via:

npm install -g react-tools

• To run the jsx watcher, from the path <repo root>/frontend/js/reactjs run:

jsx --watch jsx-input jsx-output

• Finally to run the server(from the root of the repo):

node server.js

This should get the server started and print the welcome message. That's it!!

To view the client, you can just open a browser and go to http://localhost:8080.

Usage

• Run cmake on super project with -DVLOGGING=ON. (This enables VLOG reporting)
• To get the vaults to report to localhost instead of the linode, you need to modify Vault.cc L67 switch the ip to "localhost".

Alternatively, you can edit your hosts file as per your OS to have visualiser.maidsafe.net point to 127.0.0.1. Do note doing so will forever get the url to point to your localhost. You will need to undo changes you make to your hosts file to revert this behavior.