Build Instructions

{{#eclipseproject:technology.higgins|eclipse_custom_style.css}}

Bugzilla

• 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: http://maven.apache.org/download.html
Follow installation instructions for platform.
Add "<MAVEN_INSTALL_PATH>/bin" directory to system PATH environment.

1. 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"

1. Download and install latest Apache Tomcat, setup configuration

Download Link: http://tomcat.apache.org/download-70.cgi

1. 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"

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"

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

1. Download Nginx and setup configuration

Download Link: http://nginx.org/en/download.html
Extract Nginx archive and copy to appropriate path.

1. 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; }

1. 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"

1. Checkout Higgins R2 project

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

1. Perform base build of PDS client

   From a shell:

   > cd <HIGGINS_INSTALL_PATH>/org.eclipse.higgins.pds.client

> mvn clean install -P local

</meta> ===

Misc:

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