- Decent Linux/Win/Mac box with 2GHz, 2G RAM and Java 6 or better.
- Apache CouchDB 2.0 or higher (not officially released)
- Code Recommenders Team Server 0.4 or higher
- Download CouchDB developer preview from couchbase.com.
- Install CouchDB.
- Start CouchDB.
- Ensure that CouchDB's welcome page comes up.
- Change os_process_timeout config parameter from '5000' to '10000' or higher. The exact value depends on the power of your machine and the data you process.
Code Recommenders Team Server
- Download Code Recommenders latest team server from here.
- Unzip the server to any directory on your local disc.
- TODO: needless complexity: Start the server using start.sh/.bat/.exe TODO: Change from platform dependent build to start scripts. We don't need a particular mac build...
- TODO: missing! how to create databases and views for non-ui based team server? Should we run a startup script if dbs do not exist?
Update your clients to use the new server instead of Code Recommenders' default server by changing the following urls in Preferences>>Code Recommenders:
- Code Search: http://your-team-server:29750/codesearch
- Extdoc: http://your-team-server-name:5984/extdoc (note: port is CouchDB port for extdoc!)
- UDC: http://your-team-server:29750/udc
TODO: Point to a crowd-sourcing page and explain that data needs to be uploaded by the clients into the team server.
TODO: explain how to set up the cron-job to generate new extdoc and calls models on a nightly basis.
User Friendly URLs
The port crunching is not very user friendly. You may consider to use an Apache HTTPD server as proxy to offer user-friendly urls as shown below. With this configuration code recommender services are available under the same url as before but without the port numbers.
# in /etc/apache2/mods-enabled/proxy.conf add: <IfModule mod_proxy.c> [...] ProxyPass /udc http://localhost:29750/udc ProxyPassReverse /udc http://localhost:29750/udc ProxyPass /extdoc http://localhost:5984/extdoc ProxyPassReverse /extdoc http://localhost:5984/extdoc ProxyPass /codesearch http://localhost:29750/codesearch ProxyPassReverse /codesearch http://localhost:29750/codesearch </IfModule>