Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Recommenders/Attic/TeamServer"
m (→User Friendly URLs) |
m (→Installation) |
||
Line 19: | Line 19: | ||
* 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: 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? | * 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? | ||
+ | |||
+ | = Server Configuration = | ||
+ | |||
+ | In $SERVER_HOME/configuration/config.ini, the code search server url has to be modified to point to your actual service that offers the source code files. | ||
+ | |||
+ | <pre> | ||
+ | org.eclipse.recommenders.server.codesearch.baseUrl=http\://recommenders1.st.informatik.tu-darmstadt.de/codesearch | ||
+ | </pre> | ||
+ | |||
+ | TODO: this should be simplified. Every installation needs to adapt this ATM. | ||
= Client Configuration = | = Client Configuration = |
Revision as of 07:42, 29 October 2011
Contents
Prerequisites
- 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
Installation
Apache CouchDB
- 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?
Server Configuration
In $SERVER_HOME/configuration/config.ini, the code search server url has to be modified to point to your actual service that offers the source code files.
org.eclipse.recommenders.server.codesearch.baseUrl=http\://recommenders1.st.informatik.tu-darmstadt.de/codesearch
TODO: this should be simplified. Every installation needs to adapt this ATM.
Client Configuration
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
See Recommenders/TeamServer#User Friendly URLs to see how to get rid of the port numbers.
Building Models
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.
Optional Configuration
User Friendly URLs
Code Recommenders server is per default started on port 29750. You may override this by editing $SERVER_HOME/configuration/configuration.ini or by using an existing Apache HTTPD server as proxy. How to use an existing Apache HTTPD as proxy is shown below:
# 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>
Then enable required modules ans restart the server:
> a2enmod proxy > a2enmod proxy_http > service apache2 restart