Difference between revisions of "Build Instructions"

Revision as of 10:52, 26 April 2011

• search for Higgins bugs
• enter a Higgins bug

Mailing lists:

• higgins-dev, archive - main list
• higgins-announce, archive

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

1. 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.
     
2. 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"
     
3. 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" 
   CHANGED: <Connector port="8088" protocol="HTTP/1.1"

   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)
     

   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"

4. Create maven profile
   • Edit: "<USER_HOME_DIRECTORY>/.m2/settings.xml"
     
   • Make sure the following code exists within the <settings> block:
     

   <profiles>
      <profile>
         <id>local</id>
         <properties>
            <chromium.bin>/opt/google/chrome/chrome</chromium.bin>
            <tomcat.url>http://localhost:8088/manager/text/</tomcat.url>
            <tomcat.username>myUserName</tomcat.username>
            <tomcat.password>myUserPass</tomcat.password>
         </properties>
      </profile>
   </profiles>

   • (NOTE: "myUserName" and "myUserPass" should match to the entries you entered for the line in the tomcat-users.xml file from step 3.)
     
5. 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 / {
   	access_log      off;
   	proxy_pass http://localhost:8044/;
   	proxy_set_header X-Real-IP  $remote_addr;
   	proxy_set_header Host $host;
   	proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   }
   
   location /cometd {
   	access_log      off;
   	proxy_pass http://localhost:8080/cometd/;
   	proxy_set_header X-Real-IP  $remote_addr;
   	proxy_set_header Host $host;
   	proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   }
   
   location /hdsp {
   	access_log      off;
   	proxy_pass http://localhost:8088/hdsp/;
   	proxy_set_header X-Real-IP  $remote_addr;
   	proxy_set_header Host $host;
   	proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   }
   
   location /test-project {
   	access_log      off;
   	proxy_pass http://localhost:8078/test-project;
   	proxy_set_header X-Real-IP  $remote_addr;
   	proxy_set_header Host $host;
   	proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   }

   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"

6. Checkout Higgins R2 project

   SVN Repo: https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2

7. Perform base build of PDS client
   

   From a shell:

   > cd <HIGGINS_INSTALL_PATH>/org.eclipse.higgins.pds.client
   > mvn clean install -P local

Misc:

• Higgins 1.x Developer Page - internal committers page - archived version
• Related Communities