Updating readme
This commit is contained in:
parent
55dd69721d
commit
21ba447970
29
README.md
29
README.md
@ -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).
|
||||||
|
Loading…
Reference in New Issue
Block a user