Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Build Instructions"
Line 1: | Line 1: | ||
− | {{#eclipseproject:technology.higgins|eclipse_custom_style.css}} [[Image:Higgins logo 76Wx100H.jpg|right]] | + | {{#eclipseproject:technology.higgins|eclipse_custom_style.css}} [[Image:Higgins logo 76Wx100H.jpg|right]] |
− | + | == Get the Code == | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
'''SVN Repo:''' [https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2 https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2] | '''SVN Repo:''' [https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2 https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2] | ||
− | + | == Build Local Higgins Development Environment == | |
− | + | '''Base requirements:''' Java JRE/SDK | |
− | + | #'''Download Maven (Required for building)''' | |
− | + | Download Link: [http://maven.apache.org/download.html http://maven.apache.org/download.html] | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | < | + | #*Follow installation instructions for platform.<br> |
+ | #*Add "<MAVEN_INSTALL_PATH>/bin" directory to system PATH environment.<br> | ||
+ | #'''Download and install OpenAnzo''' | ||
+ | Download Link: [http://www.openanzo.org/downloads.html http://www.openanzo.org/downloads.html] | ||
− | + | #*Extract and copy to appropriate path.<br> | |
− | *Extract | + | #*Startup OpenAnzo server: "<OPENANZO_INSTALL_PATH>/startAnzo.bat"<br> |
− | * | + | #'''Download and install latest Apache Tomcat, setup configuration''' |
− | + | Download Link: [http://tomcat.apache.org/download-70.cgi http://tomcat.apache.org/download-70.cgi] | |
− | + | ||
− | + | ||
− | + | ||
− | + | '''Change local http port to 8088'''<br> | |
− | + | ||
− | + | ||
− | + | ||
− | < | + | #*Extract Tomcat archive and copy to appropriate path.<br> |
+ | #*Edit: "<TOMCAT_INSTALL_PATH>/conf/server.xml"<br> | ||
+ | #*Update: Line #70 <pre class="code">ORIGINAL: <Connector port="8080" protocol="HTTP/1.1" | ||
+ | CHANGED: <Connector port="8088" protocol="HTTP/1.1"</pre> | ||
+ | '''Add local server user account'''<br> | ||
− | <pre class="code"><user username= | + | #*Edit: "<TOMCAT_INSTALL_PATH>/conf/tomcat-users.xml"<br> |
− | password= | + | #*Add entry inside of <tomcat-users> block<br> |
− | roles= | + | #*''(NOTE: Change "<u>myUserName</u>" and "<u>myUserPass</u>" to whatever you want them to be)''<br> |
+ | Example: | ||
+ | <pre class="code"><user username="myUserName" | ||
+ | password="myUserPass" | ||
+ | roles="manager-gui,manager-script,admin,admin-gui,manager,tomcat,admin-script"/></pre> | ||
+ | Start Apache Tomcat server via: "<TOMCAT_INSTALL_PATH>/bin/startup.bat" | ||
− | + | #'''Create maven profile''' | |
− | + | #*Edit: "<USER_HOME_DIRECTORY>/.m2/settings.xml"<br> | |
− | + | #*Make sure the following code exists within the <settings> block:<br> <pre class="code"><profiles> | |
− | + | ||
− | *Edit: | + | |
− | *Make sure the following code exists within the <settings> block:<br | + | |
− | <pre class="code"> | + | |
− | <profiles> | + | |
<profile> | <profile> | ||
<id>local</id> | <id>local</id> | ||
Line 68: | Line 51: | ||
</properties> | </properties> | ||
</profile> | </profile> | ||
− | </profiles></pre> | + | </profiles></pre> |
− | * | + | #*''(NOTE: "myUserName" and "myUserPass" should match to the entries you entered for the line in the tomcat-users.xml file from step 3.)''<br> |
− | + | #'''Download Nginx and setup configuration''' | |
− | + | Download Link: [http://nginx.org/en/download.htm http://nginx.org/en/download.html]<br> Extract Nginx archive and copy to appropriate path. | |
− | + | ||
− | Extract Nginx archive and copy to appropriate path. | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | <pre class="code"> | + | '''Configure nginx.conf file'''<br> |
− | location / { | + | |
+ | #*Edit: "<NGINX_INSTALL_PATH>/conf/nginx.conf"<br> | ||
+ | #*Inside of "server" section, replace the entire "location /" block with the following entries:<br> <pre class="code">location / { | ||
access_log off; | access_log off; | ||
proxy_pass http://localhost:8044/; | proxy_pass http://localhost:8044/; | ||
Line 110: | Line 89: | ||
proxy_set_header Host $host; | proxy_set_header Host $host; | ||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; | proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; | ||
− | }</pre> | + | }</pre> |
+ | Inside of "server" section, just after "listen" and "server_name" properties, add: | ||
+ | <pre class="code">client_max_body_size 40M; | ||
+ | client_body_buffer_size 128k;</pre> | ||
+ | Start nginx via "<NGINX_INSTALL_PATH>/nginx.exe" | ||
− | + | #'''Checkout Higgins R2 project''' | |
− | + | SVN Repo: [https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2 https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2] | |
− | + | ||
− | + | ||
− | + | #'''Perform base build of PDS client'''<br> | |
+ | From a shell: | ||
+ | <pre class="code">> cd <HIGGINS_INSTALL_PATH>/org.eclipse.higgins.pds.client | ||
+ | > mvn clean install -P local</pre> | ||
− | + | == Bugzilla == | |
− | + | ||
− | + | *[https://bugs.eclipse.org/bugs/query.cgi?product=Higgins search for Higgins bugs] | |
− | + | *[https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Higgins enter a Higgins bug] | |
− | + | ||
− | + | == Mailing lists == | |
− | + | ||
− | + | *[https://dev.eclipse.org/mailman/listinfo/higgins-dev higgins-dev], [http://dev.eclipse.org/mhonarc/lists/higgins-dev/maillist.html archive] - main list | |
− | + | *[https://dev.eclipse.org/mailman/listinfo/higgins-announce higgins-announce], [http://dev.eclipse.org/mhonarc/lists/higgins-announce/maillist.html archive] | |
− | + | ||
− | + | ||
− | == Misc | + | == Misc == |
− | * [[Higgins 1.x Developer Page]] - internal committers page - archived version | + | *[[Higgins 1.x Developer Page]] - internal committers page - archived version |
− | * [[Related Communities]] | + | *[[Related Communities]] |
[[Category:Higgins_-_About]] | [[Category:Higgins_-_About]] |
Revision as of 09:06, 27 April 2011
{{#eclipseproject:technology.higgins|eclipse_custom_style.css}}Contents
Get the Code
SVN Repo: https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2
Build Local Higgins Development Environment
Base requirements: Java JRE/SDK
- Download Maven (Required for building)
Download Link: http://maven.apache.org/download.html
- Follow installation instructions for platform.
- Add "<MAVEN_INSTALL_PATH>/bin" directory to system PATH environment.
- Follow installation instructions for platform.
- Download and install OpenAnzo
Download Link: http://www.openanzo.org/downloads.html
- Extract and copy to appropriate path.
- Startup OpenAnzo server: "<OPENANZO_INSTALL_PATH>/startAnzo.bat"
- Extract and copy to appropriate path.
- Download and install latest Apache Tomcat, setup configuration
Download Link: http://tomcat.apache.org/download-70.cgi
Change local http port to 8088
- Extract Tomcat archive and copy to appropriate path.
- Edit: "<TOMCAT_INSTALL_PATH>/conf/server.xml"
- Update: Line #70
ORIGINAL: <Connector port="8080" protocol="HTTP/1.1"
- Extract Tomcat archive and copy to appropriate path.
Add local server user account
- Edit: "<TOMCAT_INSTALL_PATH>/conf/tomcat-users.xml"
- Add entry inside of <tomcat-users> block
- (NOTE: Change "myUserName" and "myUserPass" to whatever you want them to be)
- Edit: "<TOMCAT_INSTALL_PATH>/conf/tomcat-users.xml"
Example:
<user username="myUserName" password="myUserPass" roles="manager-gui,manager-script,admin,admin-gui,manager,tomcat,admin-script"/>
Start Apache Tomcat server via: "<TOMCAT_INSTALL_PATH>/bin/startup.bat"
- Create maven profile
- Edit: "<USER_HOME_DIRECTORY>/.m2/settings.xml"
- Make sure the following code exists within the <settings> block:
<profiles>
- Edit: "<USER_HOME_DIRECTORY>/.m2/settings.xml"
- (NOTE: "myUserName" and "myUserPass" should match to the entries you entered for the line in the tomcat-users.xml file from step 3.)
- (NOTE: "myUserName" and "myUserPass" should match to the entries you entered for the line in the tomcat-users.xml file from step 3.)
- Download Nginx and setup configuration
Download Link: http://nginx.org/en/download.html
Extract Nginx archive and copy to appropriate path.
Configure nginx.conf file
- Edit: "<NGINX_INSTALL_PATH>/conf/nginx.conf"
- Inside of "server" section, replace the entire "location /" block with the following entries:
location / {
- Edit: "<NGINX_INSTALL_PATH>/conf/nginx.conf"
Inside of "server" section, just after "listen" and "server_name" properties, add:
client_max_body_size 40M; client_body_buffer_size 128k;
Start nginx via "<NGINX_INSTALL_PATH>/nginx.exe"
- Checkout Higgins R2 project
SVN Repo: https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2
- Perform base build of PDS client
From a shell:
> cd <HIGGINS_INSTALL_PATH>/org.eclipse.higgins.pds.client > mvn clean install -P local
Bugzilla
Mailing lists
- higgins-dev, archive - main list
- higgins-announce, archive
Misc
- Higgins 1.x Developer Page - internal committers page - archived version
- Related Communities