Skip to main content

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.

Jump to: navigation, search

Difference between revisions of "Build Instructions"

(→‎Get the Code)
Line 6: Line 6:
 
'''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]  
  
−
<h3>Build Local Higgins Development Environment</h3>
+
=== Build Local Higgins Development Environment ===
  
−
<p><strong>Base requirements:</strong> Java JRE/SDK</p>
+
'''Base requirements:''' Java JRE/SDK
  
−
<ol class="instruct">
+
#'''Download Maven (Required for building)'''
−
<li><strong>Download Maven (Required for building)</strong>
+
Download Link: [http://maven.apache.org/download.html http://maven.apache.org/download.html]
−
<p>Download Link: [http://maven.apache.org/download.html http://maven.apache.org/download.html]</p>
+
−
*Follow installation instructions for platform.<br/>
+
−
*Add &quot;&lt;MAVEN_INSTALL_PATH&gt;/bin&quot; directory to system PATH environment.<br/>
+
−
</li>
+
−
<li><strong>Download and install OpenAnzo</strong>
+
−
<p>Download Link: [http://www.openanzo.org/downloads.html http://www.openanzo.org/downloads.html]</p>
+
−
*Extract and copy to appropriate path.<br/>
+
−
*Startup OpenAnzo server: &quot;&lt;OPENANZO_INSTALL_PATH&gt;/startAnzo.bat&quot;<br/>
+
−
</li>
+
−
<li><strong>Download and install latest Apache Tomcat, setup configuration</strong>
+
  
−
<p>Download Link: [http://tomcat.apache.org/download-70.cgi http://tomcat.apache.org/download-70.cgi]</p>
+
#*Follow installation instructions for platform.<br>  
 +
#*Add "&lt;MAVEN_INSTALL_PATH&gt;/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]
  
−
<strong>Change local http port to 8088</strong><br/>
+
#*Extract and copy to appropriate path.<br>  
−
*Extract Tomcat archive and copy to appropriate path.<br/>
+
#*Startup OpenAnzo server: "&lt;OPENANZO_INSTALL_PATH&gt;/startAnzo.bat"<br>
−
*Edit: &quot;&lt;TOMCAT_INSTALL_PATH&gt;/conf/server.xml&quot;<br/>
+
#'''Download and install latest Apache Tomcat, setup configuration'''
−
*Update: Line #70
+
Download Link: [http://tomcat.apache.org/download-70.cgi http://tomcat.apache.org/download-70.cgi]
−
<pre class="code">
+
−
ORIGINAL: &lt;Connector port=&quot;8080&quot; protocol=&quot;HTTP/1.1&quot;
+
−
CHANGED: &lt;Connector port=&quot;8088&quot; protocol=&quot;HTTP/1.1&quot;</pre>
+
  
−
<strong>Add local server user account</strong><br/>
+
'''Change local http port to 8088'''<br>  
−
*Edit: &quot;&lt;TOMCAT_INSTALL_PATH&gt;/conf/tomcat-users.xml&quot;<br/>
+
−
*Add entry inside of &lt;tomcat-users&gt; block<br/>
+
−
*<i>(NOTE: Change &quot;<u>myUserName</u>&quot; and &quot;<u>myUserPass</u>&quot; to whatever you want them to be)</i><br/>
+
  
−
<p>Example:</p>
+
#*Extract Tomcat archive and copy to appropriate path.<br>  
 +
#*Edit: "&lt;TOMCAT_INSTALL_PATH&gt;/conf/server.xml"<br>
 +
#*Update: Line #70 <pre class="code">ORIGINAL: &lt;Connector port="8080" protocol="HTTP/1.1"
 +
CHANGED: &lt;Connector port="8088" protocol="HTTP/1.1"</pre>
 +
'''Add local server user account'''<br>  
  
−
<pre class="code">&lt;user username=&quot;myUserName&quot;
+
#*Edit: "&lt;TOMCAT_INSTALL_PATH&gt;/conf/tomcat-users.xml"<br>
−
       password=&quot;myUserPass&quot;
+
#*Add entry inside of &lt;tomcat-users&gt; block<br>
−
       roles=&quot;manager-gui,manager-script,admin,admin-gui,manager,tomcat,admin-script&quot;/&gt;</pre>
+
#*''(NOTE: Change "<u>myUserName</u>" and "<u>myUserPass</u>" to whatever you want them to be)''<br>
 +
Example:
 +
<pre class="code">&lt;user username="myUserName"
 +
       password="myUserPass"
 +
       roles="manager-gui,manager-script,admin,admin-gui,manager,tomcat,admin-script"/&gt;</pre>  
 +
Start Apache Tomcat server via: "&lt;TOMCAT_INSTALL_PATH&gt;/bin/startup.bat"
  
−
<p>Start Apache Tomcat server via: &quot;&lt;TOMCAT_INSTALL_PATH&gt;/bin/startup.bat&quot;</p>
+
#'''Create maven profile'''
−
 
+
#*Edit: "&lt;USER_HOME_DIRECTORY&gt;/.m2/settings.xml"<br>  
−
</li>
+
#*Make sure the following code exists within the &lt;settings&gt; block:<br> <pre class="code">&lt;profiles&gt;
−
<li><strong>Create maven profile</strong>
+
−
*Edit: &quot;&lt;USER_HOME_DIRECTORY&gt;/.m2/settings.xml&quot;<br/>
+
−
*Make sure the following code exists within the &lt;settings&gt; block:<br/>
+
−
<pre class="code">
+
−
&lt;servers&gt;
+
−
  &lt;server&gt;
+
−
      &lt;id&gt;azigo-dev&lt;/id&gt;
+
−
      &lt;username&gt;azigo-dev&lt;/username&gt;
+
−
      &lt;password&gt;AzigoDevPws&lt;/password&gt;
+
−
  &lt;/server&gt;
+
−
&lt;/servers&gt;
+
−
&lt;profiles&gt;
+
 
   &lt;profile&gt;
 
   &lt;profile&gt;
 
       &lt;id&gt;local&lt;/id&gt;
 
       &lt;id&gt;local&lt;/id&gt;
Line 68: Line 52:
 
       &lt;/properties&gt;
 
       &lt;/properties&gt;
 
   &lt;/profile&gt;
 
   &lt;/profile&gt;
−
&lt;/profiles&gt;</pre>
+
&lt;/profiles&gt;</pre>  
−
*<i>(NOTE: &quot;myUserName&quot; and &quot;myUserPass&quot; should match to the entries you entered for the line in the tomcat-users.xml file from step 3.)</i><br/>
+
#*''(NOTE: "myUserName" and "myUserPass" should match to the entries you entered for the line in the tomcat-users.xml file from step 3.)''<br>
−
</li>
+
#'''Download Nginx and setup configuration'''
−
<li><strong>Download Nginx and setup configuration</strong>
+
Download Link: [http://nginx.org/en/download.htm http://nginx.org/en/download.html]<br> Extract Nginx archive and copy to appropriate path.
−
<p>Download Link: [http://nginx.org/en/download.htm http://nginx.org/en/download.html]<br/>
+
−
Extract Nginx archive and copy to appropriate path.</p>
+
−
+
−
<strong>Configure nginx.conf file</strong><br/>
+
−
*Edit: &quot;&lt;NGINX_INSTALL_PATH&gt;/conf/nginx.conf&quot;<br/>
+
−
*Inside of &quot;server&quot; section, replace the entire &quot;location /&quot; block with the following entries:<br/>
+
  
−
<pre class="code">
+
'''Configure nginx.conf file'''<br>
−
location / {
+
 
 +
#*Edit: "&lt;NGINX_INSTALL_PATH&gt;/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 90:
 
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:  
−
Inside of "server" section, just after "listen" and "server_name" properties, add:
+
<pre class="code">client_max_body_size 40M;
−
<pre class="code">
+
client_body_buffer_size 128k;</pre>  
−
client_max_body_size 40M;
+
Start nginx via "&lt;NGINX_INSTALL_PATH&gt;/nginx.exe"
−
client_body_buffer_size 128k;</pre>
+
−
 
+
−
<p>Start nginx via &quot;&lt;NGINX_INSTALL_PATH&gt;/nginx.exe&quot;</p>
+
  
−
</li>
+
#'''Checkout Higgins R2 project'''
−
<li><strong>Checkout Higgins R2 project</strong>
+
SVN Repo: [https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2 https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2]
−
<p>SVN Repo: [https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2 https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2]</p>
+
−
</li>
+
−
<li><strong>Perform base build of PDS client</strong><br/>
+
−
<p>From a shell:</p>
+
−
<pre class="code">
+
−
> cd &lt;HIGGINS_INSTALL_PATH&gt;/org.eclipse.higgins.pds.client
+
−
> mvn clean install -P local</pre>
+
−
</li>
+
−
</ol>
+
  
−
<h3>Setting up a new Project using Higgins Dependancies</h3>
+
#'''Perform base build of PDS client'''<br>  
 +
From a shell:
 +
<pre class="code">&gt; cd &lt;HIGGINS_INSTALL_PATH&gt;/org.eclipse.higgins.pds.client
 +
&gt; mvn clean install -P local</pre>
  
−
<p>When creating a new project to utilize Higgins, please have the pom.xml file contain the following entries:</p>
+
=== Setting up a new Project using Higgins Dependancies ===
  
−
<pre class="code">
+
When creating a new project to utilize Higgins, please have the pom.xml file contain the following entries:
−
&lt;project&gt;
+
<pre class="code">&lt;project&gt;
 
  ...
 
  ...
 
   &lt;repositories&gt;
 
   &lt;repositories&gt;

Revision as of 07:12, 3 May 2011

{{#eclipseproject:technology.higgins|eclipse_custom_style.css}}
Higgins logo 76Wx100H.jpg


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

  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.)
  2. 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"

  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

Setting up a new Project using Higgins Dependancies

When creating a new project to utilize Higgins, please have the pom.xml file contain the following entries: 

<project>
 ...
   <repositories>

      <repository>
         <id>higgins-snapshots</id>
         <name>Higgins 2.0 Snapshots</name>
         <url>http://my.azigo.net/repo/content/repositories/higgins-snapshots/</url>
         <snapshots>
            <enabled>true</enabled>
         </snapshots>
      </repository>

   </repositories>
 ...
</project>

Bugzilla

Mailing lists

Misc

Retrieved from "https://wiki.eclipse.org/index.php?title=Build_Instructions&oldid=249032"

Back to the top