1

Updating readme

This commit is contained in:
Alex Yatskov 2015-03-22 18:02:11 +09:00
parent 55dd69721d
commit 21ba447970

View File

@ -1,40 +1,41 @@
# Reactive Search Prototype # Reactive Search
This work-in-progress represents a prototype semantic search application that I'm developing as part of my master's
thesis at [Keio University](http://www.sfc.keio.ac.jp/). You can get a better understanding of the goals of this system
by referring to the [overview](overview/) presentation. The prototype is open-source and those who are interested are
encouraged to [clone the project](https://github.com/FooSoft/search) and tinker with it. You may also access a [live
snapshot](http://foosoft.net:3000/) of the prototype on my server.
## Introduction This installation guide is designed with [Ubuntu](http://www.ubuntu.com/)-based distributions in mind (I'm using [Linux
Mint](http://www.linuxmint.com/) for development), but I expect it to be trivial to get this application running on
This installation guide is designed for Linux distributions based on Ubuntu. It should be trivial to get this other flavors of Linux. If you run into any problems, let me know.
application running on other Linux flavors, but you may have to install different packages to satisfy the dependencies.
## System Dependencies ## System Dependencies
Execute the command `apt-get install package_name` to install these packages (must be root). Execute the command `apt-get install package_name` to install the packages listed below (must be root).
* `mysql-server` * `mysql-server`
* `nodejs` * `nodejs`
* `nodejs-legacy` * `nodejs-legacy`
* `npm` * `npm`
## Global Node.js Dependencies ## Global Node.js Dependencies
Execute the command `npm install -g package_name` to install these packages (must be root). Execute the command `npm install -g package_name` to install the packages listed below (must be root).
* `gulp` * `gulp`
* `bower` * `bower`
## Database Initialization ## Database Initialization
1. Execute `./db/init.sh` to create the required database and associated user. You will be prompted for the mysql root 1. Execute `./db/init.sh` to create the required database and associated user. You will be prompted for the mysql root
password; if you do not have one configured you may continue by inputting an empty string. password; if you do not have one configured you may proceed by inputting an empty string.
2. Load the initial data tables by running `./db/load.sh`. You may perform this step again at a later time if you wish 2. Load the initial data tables by running `./db/load.sh`. You may perform this step again at a later time if you wish
to reset the contents of the database to their original state. to reset the contents of the database to their original state.
## Client and Server Initialization ## Client and Server Initialization
1. From the application base directory execute the command `npm install`. 1. From the application base directory execute the command `npm install`.
2. While in the same directory execute the command `gulp install`. 2. Still in the same directory, execute the command `gulp install`.
3. Execute the command `gulp` to start the application HTTP server on port 3000. 3. Execute the command `gulp` to start the application HTTP server (default port is 3000).
4. You should now be able to access the web application at [localhost:3000](http://localhost:3000).