Notes below are based on my personal experiences while beginning to with setting up development environment on Windows 2008 Server 64 bit R2 with 16 GB RAM using Sites JSK, Eclipse Helios & developer tools aka CSDT plugin. Developer Tools comes in 2 flavours - eclipse based IDE plugin and command line plugin.
Technically for Oracle Webcenter Sites, 11gr1 maps to v18.104.22.168.0
Artefacts - their source
Together these can be together from Oracle e-devlivery Portal (https://edelivery.oracle.com). This is a password protected portal and successful login requires an account with Oracle - just another routine form filling to get access. I did not mind this registration as during the journey oracle provided option to sign up for (hopefully) some great e-journals.
As of June 01, 2012 I found following Webcenter Sites files on Oracle e-delivery portal. It would not be ethical for me to provide download links to these archives from a public shared site, hence please do the needful as recommended by Oracle Corp.
Installing JSK, Eclipse and Developer Tools plugin
- Install JDK - I installed JDK 1.6 update 23. Kindly note the 32 bit and 64 bit installer depending on your OS.2.
- Do the standard - Set JAVA_HOME, PATH, CLASSPATH, etc.
- Install Oracle Webcenter Sites JSK from executable jar. I selected all defaults on every install window - default locations for all sub packages, default port bundled Tomcat Server, default context root, etc.
- Oracle recommends integrating v22.214.171.124.0 of Sites with Eclipse JEE Helios SR2 (v3.6). Once again please note 64 bit version of eclipse installer against 32 bit to avoid unnecessary pains.
- Do the standard (my preference) - create a desktop shortcut, fire eclipse to make sure installation was proper, check jdk and jre mappings within eclipse are correct, bump up default heap size and make heap visible in eclipse taskbar, etc.
- Unzip eclipse plugin for CSDT (Content Server Developer Tools) from csdt.zip - Oracle documentation mentions version 1.0.0 but that's incorrect. Downloaded archives come with v1.2 of CSDT eclipse plugin - this is right version for Oracle Webcenter Sites 11gr1. With v1.0.0 of csdt plugin, I was still getting "Fatwire Content Server" perspective instead of "Oracle Webcenter Sites" perspective as mentioned in same Oracle Documentation.
- Drop this csdt v1.2 archive in plugins directory of eclipse installation.
Configure Developer Tools (Integrate Sites instance with Eclipse IDE)
- Hit "Windows" - "Open Perspective" - "Other".
- Select "Oracle Webcenter Sites" and hit "ok".
- Popup window appears requesting more details.
- Configure Sites Installation Directory - This refers to the Content Server directory that has "futuretense.ini" file. An example of how the path could look like is "D:\Oracle\WebCenter\Sites\11gR1\ContentServer\126.96.36.199.0".
- Default Username - "fwadmin"
- Default password - "xceladmin"
- Project name - This refers to the eclipse project. So a valid project name should do.
- Log location will be automatically selected as a result of populating this information.
Oracle Webcenter Sites (Eclipse Perspective)
- Oracle Webcenter Sites toolbar.
- Oracle Webcenter Sites Panel (with few tabs).
Sites toolbar has following shortcuts
- Sites configuration Screen.
- Create new Template.
- Create new CSElement.
- Create new Site Entry.
- Create new Site Catalog.
- Create new Element Catalog.
Sites Tabbed Panel has the following
- Sites Log - log tail extracted from sites installation.
- Sites Preview Browser - to preview development.
- Sites UI.
- Sites Logging Configuration.
- Sites Developer Reference - with nested tabs: TagReference & JavaDocs.
Configuration of TagReference and Javadocs tabs is another thing that was a bit different to what's mentioned in Oracle Webcenter Sites developer tools documentation.
- Create a directory named "developerdocs" within Content Server installation "D:\Oracle\WebCenter\Sites\11gR1\ContentServer\188.8.131.52.0".
- Create "TagReference" directory within "D:\Oracle\WebCenter\Sites\11gR1\ContentServer\184.108.40.206.0\developerdocs".
- create "javadoc" directory within "D:\Oracle\WebCenter\Sites\11gR1\ContentServer\220.127.116.11.0\developerdocs".
For Tag Reference", following stes were needed
- Unzip "tag_reference.zip" and copy its contents to "TagReference" directory.
- Unzip "analytics_tag_reference" and copy just "Analytics" folder to "TagReference" directory.
- Edit "Intro.html" within "TagReference" directory (within Notepad++ or Textpad) and add following code block after "Java API" section. <td> </td> <td valign="top"><strong>Analytics API</strong><BR> <A HREF="./Analytics/TOC_alpha.html">Expanded TOC</A><BR> <A HREF="./Analytics/TOC_annotated.html">Annotated TOC</A><BR> </td>
- Hit "Home" button to refresh view within "Tag Reference" bottom panel tab.
For "Java Docs", following steps are needed
- Unzip "webcentersites_javadoc" and copy its content to "javadoc" directory.
- Hit "Home" button to refresh view within "JavaDoc" bottom panel tab.
This should be IT to get started with doing some initial Oracle Webcenter Sites development tutorials.