Wednesday Feb 20, 2013

Brokering in Three Dimensions: Oracle Communications Service Broker Successors

Now that the successors of Oracle Communications Service Broker have been released, we’d like to provide some information about the documentation for these products. This information was provided by Osnat Rabi, Service Delivery Platform (SDP) InfoDev Team Lead. Osnat has been working in the Telecommunications industry for over 17 years at various companies as a software engineer, project manager, system engineer, and product manager. Her passion for writing and organization have kept her close to product documentation throughout her career and she is now leading the documentation and curriculum effort for the SDP team.

The successors to Oracle Communications Service Broker are:

  • Oracle Communications Converged Application Server, Service Controller 6.1
  • Oracle Communications Online Mediation Controller 6.1
  • Oracle Communications Policy Controller 6.1

In the previous release, these three products belonged to the same product line, Oracle Communications Service Broker. In release 6.1, each of the Oracle Communications Service Broker products is marketed as a separate product and has separate documentation. Some of the content is generic across the three products (for example, the Concepts and Installation Guide) and some of the content is product-specific.

In addition to documenting all of the new features for this release, we made the following improvements (the links below, from Oracle Technology Network, where the doc is common across the three products, are for the Oracle Communications Converged Application Server, Service Controller version):

  • Oracle Communications Converged Application Server, Service Controller documentation now has an Implementation Guide that describes the various product use cases and how to set them up.
  • All of the information about service orchestration is now consolidated in one book, the Orchestration User's Guide. In that book you can read about the concepts of orchestration, how to configure the Orchestration Engine, and how to use the Orchestration Studio to create service orchestration logic. 
  • We created three new Protocol Implementation Conformance Statement (PICS) documents. You can consult the PICS documents to understand the standard protocols that are supported by the products and determine what standard requirements are met by the product's protocol implementation. There is one for each product: 
  • The Processing Domain Configuration Guide and Signaling Domain Configuration Guide have been renamed to Modules Configuration Guide and Signaling Server Units Configuration Guide. They cover configuration of Interworking Modules (IMs) and Signaling Server Units (SSUs).
  • The five Service Broker Java API References are now consolidated into the Configuration and Runtime MBean Java API Reference, which covers all of the configuration MBeans and runtime MBeans of the three products.
  • The configuration documentation describes how to configure modules and SSUs using the Administration Console, and no longer provide a reference of the Configuration MBeans. The Configuration MBeans are described in the Configuration and Runtime MBean Java API Reference.

The documentation for these three products are available for download on Oracle Software Delivery Cloud and on the Oracle Technology Network. Documentation is available in PDF and HTML format, as well as ePub and Mobi formats for mobile devices.

We value your feedback! You can either respond to this blog or contact Oracle Communications Information Development using our email alias: cgbu_docfeedback_us_grp@oracle.com.

Friday Feb 15, 2013

Operational Support Systems (OSS) Documentation ROCKS: More Content, More Searches, More Downloads

I’d like to introduce Jodie Wilford, Oracle Communications OSS InfoDev Director. She’s responsible for managing all of the documentation and curriculum for the Oracle Communications Operational Support Systems (OSS) products. As part of the MetaSolv Software, Inc. acquisition, she joined Oracle in February 2007. She has extensive experience in documentation, curriculum development, and training delivery.

Jodie’s team did a lot of great work in this release that she outlines in this post. Thank you Jodie and OSS team for all your great work.

Cheers,
Cheryl Lander, Oracle Communications InfoDev Senior Director


Thank you, Cheryl. I would like to tell you about the latest release of OSS suite of applications that Oracle’s Communications released in January 2013. This is the second release in nine months which is a consistent, coordinated release of a suite of integrated OSS applications including the following products:

  • Oracle Communications ASAP
  • Oracle Communications Design Studio
  • Oracle Communications IP Service Activator (IPSA)
  • Oracle Communications Network Integrity
  • Oracle Communications Network Intelligence
  • Oracle Communications Order and Service Management (OSM)
  • Oracle Communications Unified Inventory Management (UIM)

First, and what we believe you’ll be excited to hear about, is searchable documentation for Network Integrity, Network Intelligence, OSM, and UIM that are now available on Oracle Technology Network.

Second, the documentation for Network Integrity, Network Intelligence, OSM, and UIM are now accessible, that is, the HTML-based documentation is in compliance with Oracle Global HTML Accessibility Guidelines (OGHAG), guidelines driven by Section 508 of the Federal Rehabilitation Act and Web content Accessibility Guidelines (WCAG) 1.0/2.0 'AA'.

Third, the documentation for Network Integrity, Network Intelligence, OSM, and UIM are now available in ePub and Mobi format so you can download them to your favorite mobile device.

In response to requests from customers, we added a lot of new content and updated existing content. Here are some of the key accomplishments by product:

Design Studio (these are available on the Oracle Software Delivery Cloud)

  • Developed a new Concepts guide, including a Glossary
  • Developed a new Developer’s Guide
  • Created separate Installation and System Administrator’s Guides

Network Integrity

Network Intelligence

OSM

  • Created a Quick Start Guide for installing OSM on a Windows system, for demo purposes; this document is posted on My Oracle Support and the Oracle Partner Network
  • Improved the XML Import/Export Tool content in the System Administrator’s Guide
  • Improved the XQuery content in the Concepts guide
  • Updated the hardware sizing information in the Installation Guide

UIM

  • Developed a new Security Guide
  • Added information on cooperation framework and sample cartridges to the Developer’s Guide (available on the Oracle Software Delivery Cloud)
  • Added information on concurrent resource allocation to the Developer’s Guide (available on the Oracle Software Delivery Cloud)
  • Added hardware sizing information to the Installation Guide

You, too, can suggest content additions or changes. Send email to cgbu_docfeedback_us_grp@oracle.com.

You will find all our documentation on the Oracle Software Delivery Cloud or check us out on Oracle Technology Network today!

Thank you,
Jodie Wilford, Oracle Communications OSS InfoDev Director

Wednesday Feb 06, 2013

Free Knowledge! Learn Oracle Communications Online Mediation Controller (and more) NOW!

Extra Extra - Read All About It!

I'd like to introduce Leif Lourie, a Curriculum Developer for the Oracle Communications Service Delivery Platform (SDP) products. For the last 8 years, Leif has worked as a Curriculum Developer for many of the telecom-oriented products that Oracle offers. He's been in the telecom industry for about 25 years and has worked also as a software developer, project manager, and architect. He currently creates courses for some of the products within Oracle Communications, namely the Oracle Communications Converged Application Server, Oracle Communications Services Gatekeeper, Oracle Communications Service Controller, Oracle Communications Policy Controller, and Oracle Communications Online Mediation Controller. Leif will share his perspective on developing courses for a product and share what he's done recently for the Oracle Communications Online Mediation Controller. Take it away, Leif!

Developing and supporting software products is challenging in many ways. Every part of our organization can probably name a number of challenges. I have friends in various positions, like engineering, QA, support, and pre-sales, and I have a pretty good idea about some of their challenges. Today, I will tell you about one of the challenges that I have and how I use one of the excellent resources we have at Oracle to address this challenge.

The products I work with are full of features and functions, and it is almost impossible to have full knowledge of even one of these products, let alone create courses that cover all aspects of one product. Well, that is a common challenge for most Curriculum Developers. We just have to divide the information in chunks that will be packaged in basic courses and advanced or specialization courses. But now, we are starting to scratch the surface of the big challenge in my job. What types of courses to create – and when. You see, creating courses is a tough job and we don’t want to waste energy creating courses that no one is interested in. So, how do we know which courses to create? If you ask the people in the field, they want all courses to be available now! Unfortunately, this is not something we can support. So we need more information.

The first real demand for courseware usually comes from the pre-sales people. When they answer a Request For Information (RFI) or a Request For Proposal (RFP) from a customer, one of the standard questions is: What types of courses are available for the products you are offering? But this is still not a good enough source of information. We still do not know if the customer will need this course. Maybe they will only have one or two people working on the administration of the product and they will get enough information for their job from the product documentation.

Another approach would be to talk to our partners. They will be the ones building many of the solutions that will be used by customers. They probably need training to be able to describe, offer, and develop the right solution for the customers. But, many of our partners are already way beyond the basic information we would give them in our courseware, so we might not get enough or the right information from them either.

So, what to do, what to do…???

What if we make basic courseware for some of the SDP products available for free, to gauge the interest of the courseware? Well… we have the Oracle Learning Library, maybe we can use this? Said and done! We now have the first SDP course on Oracle Learning Library – The Oracle Communications Online Mediation Controller - Basic Administration Course.

You may now ask: What is the Oracle Learning Library? The Oracle Learning Library (OLL) allows you to search for free online learning content. The content ranges from videos, tutorials, articles, demos, and step-by-step instructions to accomplish a specific task to in-depth, self-paced, interactive learning modules.

To find the Online Mediation Course on OLL:

  1. Use your favorite browser and go to http://www.oracle.com/oll.
  2. In the middle of the screen, in the search field, enter Mediation and press Enter.
  3. In the list of course modules that is shown, select Oracle Communications Online Mediation Controller - Basic Administration Course, and you will see a description of the course content and you are given the opportunity to download the lessons and labs.

Now, it is possible for you to browse and view many of the course modules without having an account. But to be able to use all the features of OLL it is recommended that you create an Oracle Technology Network (OTN) account. This will give you access to all features of OLL as well as to all other parts of OTN. You can create your account here: https://myprofile.oracle.com/EndUser/faces/profile/createUser.jspx

After this you may browse all of the OLL resources. What are you waiting for? Learn more!

There is enough knowledge at OLL to keep you busy – learning – for a loooong time.

About

This is a blog from the Oracle Communications Information Development team, led by Cheryl Lander, Sr. Director. She and members of her team from various functions (writers, curriculum developers, and architects) and product lines will share their approach to documentation and curriculum, all with the goal of getting feedback to improve their deliverables. We'd like to thank Joe Sciallo, UCS Tech Writer (former Sun) for pushing us into the social media world. The primary team driving this blog is called "Joe and the Blogettes"; other members include Brenda Roldan (BSS Tech Writer), Jodie Wilford (OSS InfoDev Director), Leif Lourie (SDP Curriculum Developer), and Scott T. Miller (Documentation Architect).

Search

Categories
Archives
« February 2013 »
SunMonTueWedThuFriSat
     
1
2
3
4
5
7
8
9
10
11
12
13
14
16
17
18
19
21
22
23
24
25
26
27
28
  
       
Today