Wednesday Feb 27, 2013

Unified Communications Suite: Creating Custom Applications Using ENS

Choosing the Correct Event Notification Service Documentation

Recently we received an inquiry through the software forums about creating custom applications for Messaging Server dealing with message notifications. This started a conversation about the ENS documentation that I would like to clarify.

Sidebar: Event Notification Services, ENS, is the underlying publish-and-subscribe service available in Messaging Server. ENS provides a server and APIs for publishers and subscribers. A publisher makes an event available to the notification service. A subscriber tells the notification service that it wants to receive notifications of a specific event.

Going forward with Messaging Server 7 Update 4, you should be using the ENS C API as the simplest and most stable way to interact with events provided by Messaging Server. The ENS C API is documented in the Current Event Notification Service C API Reference page.

And so we come to a source of confusion. The documentation for the older style API is still available on the Communications Suite wiki, and so if you search for say, "ENS API," you are likely to find it. I would link to it, but I really don't want to send anyone there. Indeed, that page will be removed shortly so as to not cause confusion anymore. Just to reiterate, use the ENS C API as documented in Current Event Notification Service C API Reference.

I hope this helps move beyond the "clear as mud" situation that we sometimes find ourselves in.

Wednesday Feb 20, 2013

Unified Communications Suite: Tuning in to the Sound of a Well Performing Deployment

Getting Started with Unified Communications Suite Performance Tuning

Making sure that your Communications Suite deployment is performing at its best is an ongoing mission. Fortunately, we have a solid starting point: Communications Suite Tuning and Best Practices

In this document, you'll find "...various tuning hints, tips, and current best practices for Communications Suite in an effort to simplify the process of improving Communications Suite performance and to avoid known issues."

There are three basic sections to this content:

  • General, for high-level monitoring concerns
  • Operating Systems, for specific items to check by platform
  • Component Products, with tips for each component of the Communications Suite stack               Source

Furthermore, some components have more detailed information that is collected on component-specific pages. And finally, still more performance tuning content on other topics is also gathered on the wiki. See the wiki's tuning label page for a look at all the performance tuning information that is available.

Friday Jan 25, 2013

Unified Communications Suite: Wiki Documentation Changes

As longtime UCS-ers know, we have been providing wiki docs for many years now. One of the benefits of wiki docs is that writers can and do update content more frequently than with a static documentation environment. While this means that documentation issues get addressed more readily, it could also present a small problem in knowing when a doc (aka wiki page) has been updated. In addition, you might want to know not only that the page changed but how can you easily spot that change? Was the change cosmetic or substantive? And so on.

In the interest of making this knowledge a bit easier to come by, and to highlight the continuing work that the UCS InfoDev team is putting into our documentation, here are a few ways in which you can determine when a doc has been updated:

    • Look at the page history.
      On any page, from the Tools menu, select Page History. You then see a list of versions, dates, who made the change, and (hopefully) a comment on what was changed. For example, here is the page history for the Calendar Server 7 Administration Guide.
    • Once you are on the Page History page, you can compare versions. Click the check boxes beside the versions you want to compare then click the Compare selected versions button.
    • A quick and easy way to see what pages have changed recently is to choose Pages from the Browse menu, then select Recently Updated. You see a list of recently changed pages for the entire wiki space. This list is convenient in that you also get a view change link that takes you to a Page Comparison page, showing the changes.
    • If you have a standard Oracle ID, you can "watch" a page and be automatically notified by email when a change occurs.
      To watch a page:
      1. Log in to
      2. Go to the page that you want to watch.
      3. Click the Tools drop down menu and select Watch.
        When we make a change to the page, sends you an email.
    So there you have it. You now have all the info you need to stay up-to-date on our CommSuite wiki changes.

      Friday Jan 18, 2013

      Communications Suite Documentation: Wiki Structure

      From time to time, I get questions on how to find a particular piece of documentation on the Unified Communications Suite documentation wiki. So I thought it would be useful to give an explanation of our wiki structure and how to approach, at least on one basic level, looking for a particular document.

      In a nutshell, we have structured the Communications Suite documentation into two information buckets: "release-specific" content (Release Notes, New Features (formerly What's New), Installation Guides, and Upgrade Guides); and "non-release specific" content (Administration Guides, Developer Guides, Customization Guides, Tuning Guides, and the like). Release-specific content is always located on its own wiki space (in effect, its own web site), whereas the non-release specific content is always on the same "home" wiki space. In terms of URLs, what you have is this:

      Non-release Specific Content
      Release Specific Content
      and so on...

      Thus, for each new Communications Suite release, such as Communications Suite 7 Update 2, we publish the aforementioned release-specific content on its own wiki space. The thought here is that customers appreciate having everything they need to install or upgrade a particular release in one location, and don't have to click around to get what they need. Nor do they want to be encumbered by other extraneous content that only gets in the way of the installation or upgrade process.

      Notice that the release specific content URLs follow the naming convention CommSuite<v>U<n>, where <v> is the major version and <n> is the update. So knowing that, if, for example, you wanted the release specific documentation for Communications Suite 6 Update 2, you now understand that you would use the following URL: Simple, eh?

      On the other hand, when dealing with say, administration information, we made the decision to not publish a release-specific Administration Guide for each new Communications Suite version. This is different from other typical publishing environments, where you would expect a new Administration Guide to be published for each new release, even if little to nothing changed. Instead, in the Communications Suite world, you always go to the same guide (you don't have to look around for version x update y of the guide), whose URL remains the same. For example, the Calendar Server Administration Guide is located at

      So, how do you know if a change was made to a product feature and in what release, you ask? We use a versioning panel to indicate the introduction of a new feature, or a change to an existing feature. Here is an example from the Calendar Server Administration Guide:

      So, to summarize:

      • If you want release notes, and installation and upgrade information, go to the release-specific wiki for the release that you need.
      • For all other content, including administration, customization, developer, and tuning information, go to the "home" (non-release specific) wiki.
      One more note: The home Comms wiki space always has links to the current release specific documentation in the right-hand "Guides" panel. So that's another place to start looking for release notes, installation, and upgrade information.

      Thursday Nov 08, 2012

      UCS Documentation: Home1 or Home2? You Decide.

      How you go about finding information can be a very personal affair. We each have our own style of locating content, we each have our particular bent. But when it comes to getting started finding technical information, sometimes the simplest ways are best, especially if you are relatively new to a product or technology, and you just need to get going quickly with that Installation Guide or those Release Notes.

      With that in mind, I recently created an alternative home page for the Unified Communications Suite documentation. You can now have your Home2, in addition to the original, more wiki-fied Home1. I would recommend Home2 for those who are used to, and are more comfortable with, the spreadsheet-like view of manuals: here you'll find those familiar titles and the option to either view on the wiki or download the equivalent PDF file. Once you get familiar with what guides are available for the UCS component products, then move on to the Home1 layout, and start using some of the more advanced techniques for finding content in a wiki.

      Either way, you should be able to locate the "thing" you are looking for.

      Friday Oct 19, 2012

      Oracle Communications Calendar Server: Upgrading to Version 7 Update 3

      It's been some time since I have posted an entry. Now, with the release of Oracle Communications Calendar Server 7 Update 3, it seems high time to jump start this blog again.

      To begin with, check out what's new in this release:

      The upgrade is a bit more complicated than normal, as you must first apply some new schema elements to your Directory Server(s). To do so, you need to get the comm_dssetup 6.4 patch, patch the comm_dssetup script, and then run the patched comm_dssetup against your Directory Server(s) instances. In addition, if you are using the nsUniqueId attribute as your deployment's unique identifier, you'll want to change that to the new davUniqueId attribute. Consult the Upgrade Procedure for details, as well as DaBrain's blog, before forging ahead with this upgrade.

      Additional quick links:

      Friday Oct 14, 2011

      Oracle Communications Unified Communications Suite 7 Update 2 Ships

      In case you hadn't heard, Oracle Communications Unified Communications Suite has released its latest version, 7 Update 2, and it's available for download from the Oracle Software Delivery Cloud.

      Highlights for this release include the following:

      • Oracle Communications Calendar Server
        • Support for Oracle DB 11g release 2.
        • Outlook connectivity offered via Outlook Connector has been enhanced to support Calendar Server 7 Update 2 (through the WCAPbis protocol).
        • Support for both Apple iCal and Microsoft Exchange Style Delegation models enables users to share their calendars and delegate calendar management to others.
        • Support for certificate based authentication for use in secure environments, as well as support for virus scanning of attachments included with events and appointments.
      • Oracle Communications Instant Messaging Server
        • Support for external IM networks, including real time Instant Messaging and Presence connectivity, for Yahoo, AOL, MSN, Google, and Facebook.
        • Federation with SIP/SIMPLE based IM networks.
      • Indexing and Search Service for Unified Communications Suite has been enhanced to deliver a more highly available and reliable service.

      Here's a set of links to get you started:

      Monday Jan 24, 2011

      Oracle Communications Unified Communications Suite Legacy Documentation Gets a New Home

      Still looking to  for Communications Suite legacy documentation and information? As of last week, this documentation has been migrated to the Oracle Documentation site. But of course, information on the Comms Wiki is still in place and continues to be the site for new documentation.

      Unfortunately, you currently need to know the direct link to find this legacy documentation. We are in the process of correcting this situation. In the meantime, use the following table to get the direct link to the legacy documentation that you are looking for. Update, 2/1/11: Added links to Japanese translations at the end of this table.

      Library Name

      New Url

      Calendar Server

      iPlanet Calendar Server 2.0

      iPlanet Calendar Server 2.1

      iPlanet Calendar Server 5.0

      iPlanet Calendar Server 5.1

      Messaging Server

      Oracle Communications Unified Communications Suite Version 7 Update 1

      SJS Instant Messaging 7 2006Q1

      Sun Calendar Server 1.0

      Sun Java Communications Suite

      Sun Java Communications Suite 5

      Sun Java Communications Suite 6

      Sun Java Communications Suite 7

      Sun Java Enterprise System 2003Q4

      Sun Java Enterprise System 2004Q2

      Sun Java Enterprise System 2005Q1

      Sun Java Enterprise System 2005Q4

      Sun Java Enterprise System 5

      Sun Java Enterprise System 6

      Sun Java Enterprise System 7

      Sun Java System Calendar Server 6 2004Q2

      Sun Java System Calendar Server 6 2005Q1

      Sun Java System Calendar Server 6 2005Q4

      Sun Java System Calendar Server 6.0

      Sun Java System Calendar Server 6.3

      Sun Java System Communications Express 6.3

      Sun Java System Instant Messaging 6 2004Q2

      Sun Java System Instant Messaging 6.1

      Sun Java System Instant Messaging 7 2005Q1

      Sun Java System Instant Messaging 7.0.1 2005Q4

      Sun Java System Instant Messaging 7.2

      Sun Java System Messaging Server 6 2004Q2

      Sun Java System Messaging Server 6 2005Q1

      Sun Java System Messaging Server 6 2005Q4

      Sun Java System Messaging Server 6.0

      Sun Java System Messaging Server 6.3

      Sun ONE Calendar Server 5.1.1

      Sun ONE Instant Messaging 6.0.1

      Sun ONE Messaging Server 5.2

      iPlanet Delegated Administrator 4.5

      iPlanet Messaging Server 5.0

      iPlanet Messaging Server 5.1

      Netscape Collabra Server

      Netscape Messaging Server 3.0

      Netscape Messaging Server 3.5

      Sun Internet Mail Server 3.5

      Sun Internet Mail Server 4.0

      Sun Java System Connector for Microsoft Outlook 6.0

      Sun ONE Synchronization 1.1

      Japanese Translations

      iPlanet Messaging Server 5.2 Admin Guide JA

      iPlanet Messaging Server 5.2 Admin Reference JA

      Sun Java System Messaging Server 6.3 Admin Guide JA

      Wednesday Jul 07, 2010

      Communications Suite: Long Time No Blog

      Not much to say of  late, except that we're hard at work on the next Communications Suite release. At last here is something worth blogging: Our support engineers have pulled together a great page of tuning tips and tricks to help you prevent a lot of problems with your Communications Suite deployment. Have a look:

      Communications Suite Tuning and Best Practices

      Tuesday Mar 16, 2010

      Searching the Communications Suite Information, or You Can't Always Get What You Want

      I still hear all too often that while the Communications Suite wiki is chock full of information, it is sometimes hard to find things.

      My initial reaction is, have you read Finding What You Are Looking For? You just might get what you need.

      Wednesday Feb 03, 2010

      Communications Suite: Messaging Server Administration Guide Now All In on WSC

      In the midst of all the recent news about Oracle and Sun, I'd like to mention that the Messaging Server Administration Guide is now completely converted and ported to We've created three ways to access this information:

      1. Alphabetically, by page name.
      2. Traditional book view, with the same chapter ordering that you are used to from
      3. Printable version, enabling you to generate a PDF version. (See below for instructions on generating a PDF version.)

      Going forward, please use this wiki version. The original document on will no longer be updated. Note that these wiki versions also contain new product information since the introduction of Messaging Server 7, which the version does not contain.

       To print a wiki guide in PDF format:

      1. Log in to the Communications Suite wiki and navigate to Printable Docs.
        If you have never logged in before, see How to Contribute to the Communications Suite Wiki.
      2. Select one of the printable guides in the list.
      3. Click Tools in the upper right corner of the page.
      4. Click Export to PDF.
      5. Choose to display or save the file.

      Friday Jan 08, 2010

      Dealing with Communications Suite 7 & 32-bit Anti-Spam and Virus Plug-ins

      Read about your options in dealing with 32-bit AS/AV plug-ins and Communications Suite 7, which is now a native 64-bit application:

      Communications Suite 7 32-bit Anti-Spam and Virus Plug-ins

      Wednesday Dec 16, 2009

      Communications Suite Documentation: You Can Still Have Your Books and Read Them Too

      Recently, as I've been converting the Messaging Server Administration Guide from the version to the version, I found that it was easy to put together a "traditional" book view of the information, with a minimum of extra work. Basically,  enables you to link to "pages" of information in any number of ways. So creating--or in this case, recreating--the view of the information by "chapter" just entailed creating a new wiki page and links to the converted information.

      So, for those of you who are used to the way we ordered the information in the Messaging Server 6.3 Administration Guide, you'll probably find this view of the information on  very helpful.

       Note: I am still converting a few remaining chapters, which is why you'll see the small warning image next to a few chapter names.

      Reminder: Going forward, we are updating just the wikis version, so it's a good idea to start referencing it more and more often.

      Wednesday Dec 02, 2009

      Communications Suite: Just the Faqs, Ma'am

      Reminder: If all you want are the Technical FAQs for Communications Suite, we've collected them here. And are continuously adding to them, so you might want to check back from time to time for new content.

      Indeed, since these FAQs are on our documentation wiki, you can add to this collection yourself, to help out the community. Many of you already have.

      Thursday Nov 19, 2009

      Install the Stack: Communications Suite 7 Single Host Deployment Example

      We've updated the Single Host Deployment Example for Communications Suite 7. This example describes how to install the entire Sun Java Communications Suite 7 software "stack" on one computer for a functioning deployment. This document is intended for any evaluator, system administrator, or installation technician who wants to install and evaluate the services delivered by these components.

      This example describes how to install and configure the following components:

      • Sun Java System Messaging Server 7 Update 3
      • Sun Java System Calendar Server 6.3
      • Sun Java System Calendar Server 7
      • Sun Java System Instant Messaging 8 Update 2
      • Sun Java System Directory Server 6.3.1
      • GlassFish Enterprise Server 2.1 Patch 2 with HADB support
      • Delegated Administrator 7
      • Sun Convergence 1 Update 3
      • Sun Java Indexing and Search Service 1
      Give the example a whirl.

      Reporting about Unified Communications Suite Documentation, including news, Comms 101, documentation updates, and tips and tricks.


      « July 2016