The SocialSite project is delivering social networking functionality by adding social networking platform support based on the OpenSocial standard to any community site. Any social application written for the OpenSocial based social network can be seamlessly and easily hosted on a transformed community site that is powered by the SocialSite project.
Also check out this video.
]]>The download contains an integration of both roller (blogging) and slynkr (content rating) social applications, along with a common administrative interface, common user management, dynamic discovery along with single sign-on (including support for Sun's Access Manager).
The download is just a few clicks away! If you already have GlassFish 9.1 or 9.1 UR1 installed, then all you need to do is start the updatetool through $GF_HOME/bin/updatetool and choose the Social software offering! Enjoy!
]]>
Take a look at my earlier blogs on creating and testing UC addon modules for starters...
For addon modules, you need to look at the Configurator and Installer APIs.... Here's the package tree.
There were several recent additions to Update Center including Apache Roller. If you ever wanted to know how we did that, here is the code for roller.Hope this will get you excited enough and started on your own module! Send me your comments.
]]>
The bits are available through the Glassfish update center. To get to them, launch $GLASSFISH_HOME/updatecenter/bin/updatetool.
Once the update tool is up and running choose Social Software category components and click install. The instance of GlassFish will now be weblog enabled!
]]>
Before you "host" your module on a server for others to download, it would be wise to test it out yourself.
This blog describes how you can test your update center module locally on your GlassFish container through the updatetool client. Hopefully you already know how to create and package your update center module.
Here's what you do to "host" the module on your local running instance of GlassFish. Updatetool is available from GlassFish v2 onwards.
The module jars are downloaded under GF_v2_HOME/updatecenter/registry/glassfish/package.name/module. The updatetool is expected to extract and install the module for you.
Trivia: Did you know that a Netbeans module or .nbm extension is just a fancy name for a .jar?
Important contact information: If you are interested in hosting your application on GlassFish Update Center repository, do touch base with the GlassFish Update Center team at: dev@updatecenter.dev.java.net and they'll be happy to work with you.
]]>But what's an addon and how do you create one?
An addon is a companion product or runtime component installed on top of Sun Java System Application Server.
Right, but how do you create such a module?
To start with, you need to implement an com.sun.appserv.addons.Installer interface. You may also need a com.sun.appserv.addons.Configurator interface implementation.
What's the difference between and installer and a configurator plugin?
If addon requires installation of shared files which are not specific to a particular application server domain, installation and initial configuration of such files must be handled by installer plugin. The installer plugin has read-write access to installation root directory (INSTALL_ROOT) of the appserver.
Installer plugin is invoked either at the end of appserver installation or when the CLI command asadmin install-addon addon_name_installer.jar is executed.
The configurator plugin should assume read-only access to INSTALL_ROOT and read-write access to root directory of the domain (DOMAIN_DIR). The configurator will be invoked once, prior to starting application server domain. The configurator will access application server configuration files like DOMAIN_DIR/config/domain.xml, DOMAIN_DIR/config/server.policy etc. and make necessary changes.
Where can I get the installer plugin API?
From MavenHow do I package the installer plugin?
addon_name_installer.jar
|- META-INF/services/com.sun.appserv.addons.Installer
|- InstallerImpl.class (implements Installer)
|- InstallerUtil.class
|- InstallerMore.class
|- addon_name_configurator_01_01_00.jar
|- META-INF/services/com.sun.appserv.addons.Configurator
|- ConfiguratorImpl.class (implements Configurator)
|- Another.class
|- More.class
|- Util.class
How do I invoke and test the installer plugin?
Installer plugin is invoked either at the end of appserver installation or when the CLI command
asadmin install-addon addon_name_installer.jar
Now for the final packaging.
File system layout for downloadable module file (equivalent of NetBeans NBM file) will be jar archive file with following structure:
module_xx.jar
|
+- info
| |
| +- info.xml
|
+- module
|
|
+- locale (optional, for localized packages)
|
|
+-installer_xx.jar or installer_xx.zip
installer_xx.jar can be addon component installer or configurator jar file as specified in Addon installer and configurator plug-in imported interfaces.
The DTD for info.xml is here.
]]>
In case you missed going to the GlassFish PoD during this year's JavaOne, and have some questions left unanswered, Nazrul has written an excellent blog answering the most popular questions asked.
What do I need to install Roller 3.0.1 on Tomcat?
Here is a link to the installation guide for your reference.
Stay tuned for my follow up blog on installation on my favorite application server glassFish.
Set the ROLLER environment variable to the location of the roller webapps directory.
For example, for Windows (if you installed Roller in c:), you would set
set %ROLLER% = c:\apache-roller-3.1/webapp/roller
If you're curious why, these are not shipped in Roller due to licensing restrictions. You need-
You'll need to copy the following files from Hibernate into the Roller WEB-INF/lib directory:
hibernate3.jar, asm-attrs.jar, asm.jar, cglib-2.1.3.jar, dom4j.1.6.1.jar , ehcache-1.1.jar, jdbc2_0-stdext.jar, jta.jar
Download the J/Connector JDBC driver from mysql.com and place it in the Tomcat common/lib directory.
Copy activation.jar and mail.jar to Tomcat common/lib.
In this step you use an SQL script to create a new database within your MySQL installation, create a user with all privileges within that database and the tables required to run Roller.
Execute the script in %ROLLER%/WEB-INF/dbscripts/mysql
C> cd %ROLLER%\WEB-INF\dbscripts\mysql C> mysql -u root -p password: ***** mysql> create database roller; mysql> grant all on roller.* to scott@'%' identified by 'tiger'; mysql> grant all on roller.* to scott@'localhost' identified by 'tiger'; mysql> use roller; mysql> source createdb.sql mysql> quit
To deploy Roller you will need to inform Tomcat where to find the Roller installation directory, how to configure the Roller database data-source under the JNDI name jdbc/rollerdb, and how to configure the Roller email session under the JNDI name mail/Session.
For Tomcat you can do this by creating a context configuration file named roller.xml and placing that file in the %CATALINA_HOME%/conf/Catalina/localhost directory.This is what roller.xml looks like. Edit the values for docBase and Resource attributes to point to the ones you're using.
<Context path="/roller" docBase="c:/apache-roller-3.1/webapp/roller" debug="0"> <Resource name="jdbc/rollerdb" auth="Container" type="javax.sql.DataSource" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost:3306/roller?autoReconnect=true& useUnicode=true&characterEncoding=utf-8&mysqlEncoding=utf8" username="scott" password="tiger" maxActive="20" maxIdle="3" removeAbandoned="true" maxWait="3000" /> <!-- If you want e-mail features, un-comment the section below --> <Resource name="mail/Session" auth="Container" type="javax.mail.Session" mail.smtp.host="mailhost.example.com" /> </Context>
Configure your application server and your web server to use UTF-8 encoding because Roller's does I18N by using UTF-8 encoding for everything. Also Check your application server's URI encoding setting!
Make sure that your web application server uses UTF-8 to encode URI's. In Tomcat the URI encoding is specified in the connectors that are configured in the Tomcat configuration file conf/server.xml. Here's a connector with the URI encoding attribute set properly:
<Connector port="8080" maxThreads="150" minSpareThreads="25" ..... URIEncoding="UTF-8" />
Roller stores file uploads, search index files, cache files and log files on disk. Make sure the following directories that Roller expects exist and are writable by the Tomcat process.
Review the WEB-INF/classes/roller.properties file To override the properties, define a roller-custom.properties file and place it in $CATALINA_HOME/common/classes/roller-custom.properties
uploads.dir=/app/roller/roller_data/uploads search.index.dir=/app/roller/roller_data/search-index passwds.encryption.enabled=true # other values you may want to override
Edit %ROLLER%/WEB-INF/security.xml file
For the beans with ids "anonymousAuthenticationProvider" and "anonymousProcessingFilter" change the value field of the property with name="key" to any string value of your choosing. Use the same key
value in these two beans; they must match.
For the beans with ids "rememberMeServices" and "rememberMeAuthenticationProvider" change the
value field of the property with name="key" to be different from the default value of "rollerlovesacegi". You can use any string value of your choosing. It should be a secret specific to your
site. Use the same key value in these two beans. Again, they must match.
Start your Servlet Container, open your web browser, browse to the Roller start page and start using Roller.
C> cd %CATALINA_HOME/%bin
C> startup
Point your browser to the URL: http://localhost:8080/roller. You're all set!
]]>You're back from JavaOne, with buzz words of cool new technologies you heard about still ringing in your ears. Here you are sitting at your desk, thinking about all the cool stuff you wish you could learn.
Well, there is HOPE.
Did you know that Sun Microsystems Inc. offers comprehensive training and certification for several Java technology components and the Java Platform, Enterprise Edition (Java EE)?
What?
To add to the list of courses being offered in the Web Services learning path , is an offering on XML and Web Services security (DWS-4120-EE5) being offered in the Java EE track.
When?
Estimated to be on the training schedule mid June. Stay tuned!
Where?
Watch this space.
What will I learn?
As part of the course, you will learn to :
The students perform the course lab exercises using the NetBeans 5.5 Enterprise Pack Integrated Development Environment (IDE) and using AppServer 9.0 U1.
Cool stuff! Is there anything else you would want to learn?
]]>Well I've been trying to get started with using jMaki in my own space too. I thought I'd write some of my experiences in blogs as I go along.
First we need to setup the environment. We need an IDE, a jMaki plugin, and an application server.
Here are my preferences-
Now using the update center, I installed jMaki plugin in my NetBeans IDE. There is also a screencast that you can watch.
Now we're all set to start writing applications using jMaki.
Let's do something more fruitful. Let's say we want to have a menu bar which will bring up different pages based on the option you select.
We create a new Web application. Enable jMaki support from the wizard.
Choose a standard single view and drag and drop the jMaki.Menu under the first div or the main area.
Drag and drop a jMaki.dcontainer on the second div. The reason we are having the dContainer is because all the actions with the Menu will result in changes in the dContainer. The glue code for the two to work together already exists, so we won't have to do anything else, which makes things simpler. Finally we create new jsp's for the associated actions in the same project. They should be at the same level as the main index.jsp. It's easy to do with NetBeans. Just click on the project in the project tree and create New->jsp.
This is what the final code will look like:
<div class="outerBorder">
<div class="header">
<div class="banner">Doing something fruitful</div>
<br>
<div class="subheader">
<div>
<a:ajax name="jmaki.menu"
value="{columns: [
{label: 'Strawberry',
menuItems: [
{label:'ripe', url:'ripe.jsp'},
{label:'unripe', url:'unripe.jsp'}
]},
{label: 'Apples',
menuItems: [
{label:'Red', url:'red.jsp'},
{label:'Green', url:'green.jsp'}
]}
]}" />
</div>
</div> <!-- subheader -->
</div> <!-- header -->
<div class="main">
<a:ajax name="jmaki.dcontainer"/>
</div> <!-- content -->
</div> <!-- main -->
</div> <!-- outerborder -->
Feel free to try and point to some other useful tips as well!
]]>
A little Background:
WSIT, is a short name for Web Services Interoperability Technology, an integrated part of GlassFish v2 M4.It's an open source implementation of key WS-* technologies and provide first class interoperability between Sun's Web services stack and Microsoft Windows Communication Foundation, an integrated part of .NET 3.0 framework.
WS-Trust specifies a framework for broker trust across different security domains.
For introduction about using Netbeans, and introductory samples on creating and testing webservices using Netbeans and the WSIT, I encourage you to see these screencasts.
Your comments are welcome.
]]>