Requirements

Installing ezVIS requires to have both mongodb 2.4+ and nodejs 0.10 or 0.12 installed.

Although their installation is simple, it is different from one environment to another.

Below are some suggestions, according to the Operating System you are using.

Linux

MongoDB

Warning: only versions 2.4+ of Mongo were tested, these are not versions avaible by default on Ubuntu 12.04, for example.

NodeJS

Use a 0.10. or a 0.12. version of nodejs.

Tip: use nvm to be able to choose nodejs's version.

Once node is installed, go to the npm step.

Windows

In general, pay attention to the version of Windows you use (32-bit or 64-bit), and download an MSI installer.

To find which version of Windows you are running, enter the following command in the Command Prompt:

wmic os get osarchitecture

MongoDB

See install MongoDB on Windows.

Don't forget to create a \data\db at the root of the partition where you installed Mongo, it will prevent the need to give parameters to the mongod.exe.

Note: if you did not choose C:\, use the Custom install process of mongodb to set the right installation path. Example: D:\mongodb.

Warning: only versions 2.4+ of Mongo were tested.

Running bin\mongod.exe (in the installation directory) may require that you give network authorizations (only the first time).

Once MongoDb is running, you can skip the following steps to install NodeJS.

NodeJS

On nodejs's downloads page, get the Windows MSI Installer, and use it.

Requirements

These requirements maybe already fullfilled on your machine: - Python 2 installed - .NET Framework 2.0 SDK (installed, and in the PATH)

Command Prompt

To launch ezVIS, you'll need to open a new command prompt, then go to the npm step.

MacOS

Install Homebrew, and then use it to install mongodb and node.

npm installation

Once node is installed, you can install the ezvis command itself by:

$ npm install --production ezvis -g

Note: the --production option is not required, it only prevents the installation of development (and test) dependencies. If you don't intend to run these tests, you can safely remove this option.

Note 2: under Windows, you may need to use the --msvs_version=2012 option, see this StackOverflow page.

Usage

Make sure mongodb is running, and then.

$ ezvis /path/to/data/repository

Then, point your browser to http://localhost:3000/

hint

If you don't have a data repository, but already loaded data in mongodb, you can use:

$ ezvis $PWD/data

Before that, you have to configure your mongo connection, by creating a ./data.json file containing something like:

{
  "port": 3000,
  "collectionName" : "insu"
}

Then, point your browser to http://localhost:3000/