Difference between revisions of "Build Instructions"

Revision as of 18:05, 25 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

=== <meta charset="utf-8">

Build Local Higgins Development Environment

Base requirements: Java JRE/SDK

1. Download Maven (Required for building)

   Download Link: <a href="http://maven.apache.org/download.html" target="_blank">http://maven.apache.org/download.html</a>
   Follow installation instructions for platform.
   Add "<MAVEN_INSTALL_PATH>/bin" directory to system PATH environment.

2. Download and install OpenAnzo

   Download Link: <a href="http://www.openanzo.org/downloads.html" target="_blank">http://www.openanzo.org/downloads.html</a>
   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: <a href="http://tomcat.apache.org/download-70.cgi" target="_blank">http://tomcat.apache.org/download-70.cgi</a>
   

   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"/>

   <p>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.)
   
   
   

   </li>

5. Download Nginx and setup configuration <p>Download Link: <a href="http://nginx.org/en/download.html" target="_blank">http://nginx.org/en/download.html</a>
   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: <a href="https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2" target="_blank">https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2</a>

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