Thoughts on technology Thoughtology

The open-jbi-components module constitutes various JBI components, such as BPEL SE, used in a JBI environment. In the previous blog, I posted additional tips required for setting up the open-esb development environment on OSX. The Open ESB source tree constitutes the implementation of JBI spec.

Now going ahead on how to set up the dev environment, below steps need to be followed. The generic set of instructions are available at https://open-jbi-components.dev.java.net/public/build_instructions/ojcsetup.html  and we will refer to this URL all through. Below, we mainly capture additional set up requirements or clarifications required for Mac OSX.

1. Check out the src code as listed in Step 1 in the above mentioned URL.
2. Set up Maven and the variables as required in Step 2. In my case, I set up my variables in .cshrc file under my home dir. One variable you would probably require to add and not mentioned in the above URL is, MAVEN_OPTS without which the build / install could throw OutOfMemory Error when processing 'axiondb' module. Over all below are the changes you will need to make to the file.
       setenv JV_GFBASE /Users/me/CAPS/glassfish-v2-ur2-b04-patch-20080729
       setenv JV_SRCROOT /Users/me/src/open-jbi-components
   
       setenv MAVEN_OPTS "-Xmx512m"
   
       alias smvn 'mvn -Dmaven.test.skip=true -Dmaven.repo.local=$JV_SRCROOT/m2/repository'
       alias smvntest 'mvn -Dmaven.test.skip=false -Dmaven.repo.local=$JV_SRCROOT/m2/repository'
   
3. Now to ensure that Maven has all the required repositories, update the settings.xml file under <USER_HOME>\.m2\ directory, to ensure it has all the repositories and mirrors as shown in Step 3 on the above mentioned URL. In my case I reused by settings.xml I had put together for OpenESB environment and have copied the contents of the file at the end.
   
4. If you need to work with some of the components as detailed out in steps 4, 5, 6, please follow as listed in the above URL. In my case I was not keen and so skipped the steps.
5. Before executing the instructions in step 7 from the above URL, you need to fix the OSX JDK difference when compared to other JDK. The JBI build looks for tools.jar under JDK which in case of MAC is called classes.jar. Thanks to Russ Tremain who gave me the below steps. Since it is a one time operation, I just execute the below on my terminal window.
   setenv JAVABASE /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0
      setenv JAVAVERS Home
      setenv JAVA_HOME $JAVABASE/$JAVAVERS
   
      cd $JAVA_HOME
      sudo mkdir jre
      cd jre
      sudo ln -s ../bin
      sudo ln -s ../lib
      cd $JAVA_HOME/..
      sudo ln -s Classes lib
      cd lib
      sudo touch tools.jar
   As you observe the above creates tools.jar as required by the build.
   
   
6. Now go ahead and execute the instructions in step 7 of the above mentioned URL.
   

You are all set to contribute to the JBI source.

As always, thanks to Russ Tremain for all his inputs.

Settings.xml--------------------------------------------------------

Some of the content below may not be required, but for my environment I had all the below.

<!-- maven build properties inside SWAN -->
<settings>
    <proxies>
<!-- You probably may not need this. Per Russ Tremain, the SWAN proxies are only required if you are building from  outside of US Sun office. -->       

         <proxy>
            <active>true</active>
            <!-- id>testcache_http</id -->
            <host>pkg.SFBay.Sun.COM</host>
            <id>swan_http_proxy</id>
        </proxy>
        <proxy>
            <active>true</active>
            <protocol>https</protocol>
            <host>pkg.SFBay.Sun.COM</host>
            <id>swan_https_proxy</id>
        </proxy>
    </proxies>
    <pluginGroups>
        <pluginGroup>open-esb</pluginGroup>
    </pluginGroups>
    <mirrors>
        <mirror>
            <id>lsu.edu</id>
            <url>http://ibiblio.lsu.edu/main/pub/packages/maven2</url>
            <mirrorOf>central</mirrorOf>
            <!-- United States, Louisiana -->
        </mirror>
        <mirror>
            <id>sateh.com</id>
            <url>http://maven.sateh.com/repository</url>
            <mirrorOf>central</mirrorOf>
            <!-- The Netherlands, Amsterdam -->
        </mirror>
        <mirror>
            <id>ggi-project.org</id>
            <url>http://ftp.ggi-project.org/pub/packages/maven2</url>
            <mirrorOf>central</mirrorOf>
            <!-- The Netherlands, Amsterdam -->
        </mirror>
        <mirror>
            <id>planetmirror.com</id>
            <url>http://downloads.planetmirror.com/pub/maven2</url>
            <mirrorOf>central</mirrorOf>
            <!-- Australia, Queensland -->
        </mirror>
        <mirror>
            <id>dotsrc.org</id>
            <url>http://mirrors.dotsrc.org/maven2</url>
            <mirrorOf>central</mirrorOf>
            <!-- Denmark -->
        </mirror>
        <mirror>
            <id>ibiblio.net</id>
            <url>http://www.ibiblio.net/pub/packages/maven2</url>
            <mirrorOf>central</mirrorOf>
            <!-- United States, North Carolina -->
        </mirror>
        <mirror>
            <id>sunsite.dk</id>
            <url>http://mirrors.sunsite.dk/maven2</url>
            <mirrorOf>central</mirrorOf>
            <!-- Denmark -->
        </mirror>
        <mirror>
            <id>real-maven-snapshot</id>
            <url>http://people.apache.org/maven-snapshot-repository</url>
            <mirrorOf>maven-snapshots</mirrorOf>
            <!-- bogus mirror to avoid redirect  -->
        </mirror>
        <mirror>
            <id>repo1</id>
            <url>http://repo1.maven.org/maven2</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
    </mirrors>
    <profiles>
        <profile>
            <id>swan-profile</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <repositories>

<!-- The java.net repositories may not be required. Per Russ, these are now included in common poms. -->
                <repository>
                    <id>sun-private-repository</id>
                    <name>artifacts private to sun projects</name>
                    <url>http://iis.sfbay.sun.com/maven2/</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
                <repository>
                    <id>java-net-legacy-repository</id>
                    <name>java.net Maven 1.x repository</name>
                    <url>http://maven.sfbay/mirrors/java.net</url>
                    <layout>legacy</layout>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
                <repository>
                    <id>java-net-legacy-repository</id>
                    <name>java.net Maven 1.x repository</name>
                    <!--url>http://maven.sfbay/mirrors/java.net</url-->
                    <url>https://maven-repository.dev.java.net/nonav/repository</url>
                    <layout>legacy</layout>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
            </repositories>
        </profile>
    </profiles>
</settings>