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/