80 likes | 98 Views
Building the Portal. Select your host computer. You will need a real IP address for some COG-based portlets VPN also OK (?) Know general Globus et al firewall issues. I recommend turning firewalls and SELinux off for development. Operating Systems
E N D
Select your host computer. • You will need a real IP address for some COG-based portlets • VPN also OK (?) • Know general Globus et al firewall issues. • I recommend turning firewalls and SELinux off for development. • Operating Systems • We test with Mac OS X and many Linux flavors • Other Unix should be fine (assuming Java works) • We have not had any requests for Windows. • Software Environment • The portal download comes with everything you need EXCEPT Java. You need the JDK, not the JRE. • We test with Java 1.5. Don’t use Java 1.4. • The more memory, the better. Choosing a Host Computer
Downloading and Building the Portal • Download the portal from http://www.collab-ogce.org. • Unpack in $HOME. • You should also download the Maven repository. • This is optional but recommended • Edit ogce-portal-home/pom.xml • Run the command “mvn clean install”. • Use “mvn –o clean install” to build offline. • Build will typically take 5 minutes (new Mac) to 30+ minutes (old Linux PC). You can also check out the latest code from SVN. Check the “Nightly Build” dashboard to verify.
Increase your JVM Memory • export JAVA_OPTS="-server -Xms512m -Xmx1024m -XX:MaxPermSize=256m” • Xmx2048m, 4096m, etc if you can. • Monitor catalina.out for problems • tail –f catalina.out • Make sure that Tomcat shuts down • Kill if necessary • NFS can really slow down building • Use /usr/local/ if you have problems Practical Considerations
Editing pom.xml <properties> <portal.server.ip> 156.56.104.143 </portal.server.ip> <host.base.url> http://${portal.server.ip}:8080/ </host.base.url> <gridftp.host.names> …. </gridftp.host.names> <gram.host.names> …. </gram.host.names> <project.home> ${env.HOME}/ogce-portal-only </project.home> </properties> • You only need to edit the top level ogce-portal-only/pom.xml. • You only need to change <properties> for local settings. • You MUST update the IP address. • You may want to add or remove GRAM and GridFTP hosts. • Update project.home if you are building someplace besides $HOME.
Running “mvn clean install” will completely wipe out the existing installation. • You may not want to do this. • If you want to rebuild individual components, just run the following command from the ogce-portal-only directory. • mvn clean install –f portlets/myportlet/pom.xml • You can do this for all <modules> in ogce-portal-deploy/pom.xml Rebuilding the Portal
We follow standard Maven 2 conventions for project layouts for each component. • moduleName/src/main/webapp • moduleName/src/main/java • Modules are listed on next slide • See ogce-portal-only/pom.xml. • Each module is a separate directory and has its own pom.xml. OGCE Portal Project Layout