Core Content Only

After you install UCM 11gR1 you may occassionally (or often) start your UCM managed server from the command line.  When you do this, you will get prompted for your weblogic username and password.  If you get tired of this you can create a text file named boot.properties.  In this file, put the following:

username=<your user name here, example: weblogic>
password=<your password here, example weblogic1>

Save the file and place it here:

C:\Oracle\Middleware\user_projects\domains\ecm_domain\servers\UCM_server1\security

You may need to create the security directory.

The next time you start your manage server you will not need to supply the user name or password.  The values for these will be pulled from the boot.properties file.  Additionally the values in your file will be encrypted and written back to the file.  After you have booted the manage server open the properties file to view the encrypted values.

The Content Basket component uses the ZIP Rendition Management to package the contents of the basket for download as a ZIP file. By default there are two limitations imposed on your download. It must be a count of five hundred (500) pieces of content or less and it must be a total of five hundred (500) megabytes or less. The two settings that control this are actually part of ZIP Rendition Management and not Content Basket.

MaxRenditionBundleInMegabytes
This variable represents the max size in megabytes (default is 500 megabytes). From the internal notes: Note, it is unlikely that a browser + web server will successfully download a file over 2 gigabytes over 2 gigabytes and you need 8 byte integers in the Content-Length HTTP header) in all scenarios so the effective maximum cap on this value is 2000 megabytes.

MaxRenditionFileEntries
This is the max number of items available to package in the bundle.

You can use UCM built-in Java methods to Encode and Decode your HTML/XML. This is handy when operating within the WCM realm as well as when working with UCM UI customizations. I’ve uploaded a sample component showing some of this in action on the downloads page.

This component adds a simple service handler you can execute throught the custom service (ENCODE_DECODE_SAMPLE_SERVICE). The handler takes the content you enter into a textarea an encodes and decodes it then provides those variables for out template to write back to the page as well as dumping some information out to the server output.

Get it on the downloads page.

I am very happy to introduce the Alphabetize Menus MARK III (in honor of my love of the Ironman movies).  This version introduces compatibility with Safari and Chrome.  Thanks to Shane D. for pointing this issue out and finally getting me to get this long overdue bug resolved as well as some of the testing.

I conducted a presentation at Collaborate 2010 today showing some tips and tricks for installing Oracle Universal Content Management, formerly known as Stellent, on an EC2 instance.

Here are a few references:

http://aws.amazon.com/ec2/#pricing
http://aws.amazon.com/ec2/purchasing-options/
http://calculator.s3.amazonaws.com/calc5.html
http://aws.amazon.com/solutions/global-solution-providers/oracle/

One of the participants asked about license ramifications and this might help understand that arena a little:
http://www.oracle.com/corporate/pricing/cloud-licensing.pdf

The new (as of around March 15^th) Core Update Bundle (build 55) includes an updated Folders_g component.  If you have tried to install the Folders_g component that came with the update bundle released on or around December 30^th of last year you may have ran into issues with the install not working.

The issue revolved around new installations of the folders component not creating tables, etc. in the database.  If you had previously installed folders and you simply upgraded you may have been fine.  This only seemed to affect new installs.

Either way, grab the newest update bundle and hopefully we can put these issues behind us.  So far, from what I’ve tried, it has worked much better.

When you are developing and testing workflows in UCM the Update Event of a step in a workflow can be your worst enemy.  The update event is fired off roughly every sixty minutes in a standard configuration of UCM.  Any IdocScript you create in your Update event of your step then might have to wait as much as sixty minutes to execute.  This makes testing these scripts difficult.  Sure, in some cases you can use the built in test harness.  However, this little configuration will be a big boost:

DoDebugFastScheduledEvents=true

Adding this configuration variable to you <install>/config/config.cfg or through the Admin Server under General Configuration and restarting your content server will give you a big development/test boost.  This reduced the period from sixty minutes to five minutes.

Happy workflow debugging!

If you want to hide the alternate file on the check-in page you can add the following configuration to your <install>/config/config.cfg file.  You can also add this to the General Configuration Variables in the Admin Server.  Both of these methods will require a restart.  This will hide alternate file globally.  And what is the setting?  It looks like this:

suppressAlternateFile=1

What if you would like to do this for a certain profile, but not globally?  No problem.  Simply select one of your rules for your profile.  Enable the activation conditions and add this setting as a side effect:

<$suppressAlternateFile=1$>

No Alternate File

I wanted to talk a little about how we take advantage of Amazon Web Services, especially the Elastic Compute Cloud, here at Redstone Content Solutions.  This is not marketing drivel.  The goal is to describe how you can benefit from the cloud for your Oracle endeavors by describing how we actually do just that ourselves.  Sometimes it helps to just hear about how others are using something. 

We use the Amazon Elastic Compute Cloud, sometimes referred to as Amazon EC2, for a variety of purposes.  The topics for this post will be the use of EC2 for Development and Training.  I will release a post in the future with additional thoughts about using EC2 to host your Production environment.

For those who are attending COLLABORATE10 at Las Vegas’ Mandalay Bay Hotel & Convention Center April 18-22, I will be giving a presentation on this subject.  The session, entitled Build your own UCM Stellent Instance in Amazon EC2, will be held on Thursday, April 22^nd, 2010 at 8:30 a.m. in Room 2.  The session ID is 128.  Session dates and times are subject to change, so stay tuned! 

We actually do use EC2 to host development and training environments.  I interact with EC2 environments on a daily basis.  The primary thing you need to take advantage of EC2 for these purposes is a reliable internet connection.  Note:  I will be discussing mostly Oracle Content Management – based environments but we also use them for Web Center Framework and SOA Suite. 

Originally when we started using EC2, machines had to be kept running.  If you restarted an instance you lost your “state” if you did not re-bundle the instance and persist it as an Amazon Machine Instance (AMI).  There were a few tricks we could use to avoid this to a certain extent that revolved around attached storage.  Additionally, images we created ourselves had an image size cap.  This proved to make things difficult as we tried to construct base images within the 10 gigabyte range. 

With some recent announcements in December by Amazon the above restrictions are now a thing of the past.  We can launch instances, change data, shut down and launch again with no loss of state or data.  It actually acts like a real piece of hardware now.  With this new functionality, we can boot images directly off of Elastic Block Storage (also known as EBS).  This means when we shut our instance down, the resources required to run the instance are not reclaimed.  The resources (namely disk) are kept in our EBS volumes and their data persists across shutdowns.  Now when we launch our instances the resources are already allotted and immediately available.  Hence, our boot times for launching instances are much faster.  If you’ve ever tried to launch an EC2 instance you know why I am excited about this. 

EC2 also works with Amazon Simple Storage Service (S3) which is different from EBS.  Think of EBS as blocks of space you can attach as volumes to machines.  Amazon S3 acts like your corporate SAN where you can store all kinds of information.  Whenever you transfer something from your own machine or elsewhere in the world to an EC2 instance or S3 Amazon will charge you.  However, Amazon does not charge to move data from S3 to any of your EC2 instances.  So, we store installers, patch sets, etc., in S3 and then we copy those to our EC2 instances.  You just have to get your content into the Amazon cloud and then you can move it around within the cloud for free. 

You can work with a variety of operating systems in EC2.  You can use Windows Server 2003 or 2008 and many flavors of Linux.  There is even a process you can go through to convert VMWare Workstation files to an Amazon Machine Instance that you can upload and run in the cloud.   Since we work exclusively with Oracle products, we use Oracle Enterprise Linux (OEL) extensively.  There are several AMI instances available, pre-built, from Oracle for Oracle Enterprise Linux and Oracle Database 11g that might serve as a good starting point.  Or, you can really get into it and start using a Just Enough Operating System (JeOS) version of OEL. 

We can setup an instance of OEL, Oracle Database 11g R2, Oracle UCM 10gR3 and get everything configured just right.  Then we can spawn as many “instances” of this as we want for training, testing or demonstration purposes.  We can choose to accept a single processor box with 2 gigabytes of RAM, or we can throw the “big iron” on and fire up with 8 processors and 16 gigabytes of RAM or pretty much anything in between. 

Think about this scenario.  You want to try out Digital Asset Management on Content Server.  Specifically Video Manager.  You can acquire an EC2 instance with all the power you need to run Flip Factory within minutes.  Flip Factory is a neat piece of software but the processing requirements to really use it are pretty steep.  Most development groups I know do not have that kind of horse power just lying around waiting to be used.  With EC2, you can have it running by lunch time.  We use this kind of quick hardware acquisition to provision testing environments or “component labs” frequently. 

Finally, the nice thing about all this is accessibility.  We can quickly and easily open this up for a client or prospect to view a test instance.  We can even spawn a separate instance of the original for the client to “play around on”.  But what if they do something we hadn’t accounted for?  Drop that instance and re-spawn a new one and they’re back in action fifteen-twenty minutes later. 

In the future, I am going to try to cover more specific details about the actual setup, the problems we encounter and how to solve them.  I will also detail a handy array of tools we use to work with Amazon Web Services (AWS).  Some of this will be on display if you see my presentation in Vegas! 

Just food for thought.  Think about it some.  The opportunities are endless.

In a previous post I covered some examples of using jQuery with Content Server as well as a component to help facilitate testing out some of this functionality. Dan Kozlowski asked in the comments and over here on the Oracle ECM Forums about how he might use jQuery when the INPUT has HDA ResultSet data. He gives the following example:


Properties LocalData
IdcService=EDIT_USER
dName=jsmith
dFullName=Jennifer Smith
dUserAuthType=Local
dPassword=password
dEmail=jsmith@stellent.com
dUserType=MKT
dUserLocale=English-US
@end
@ResultSet UserAttribInfo
2
dUserName
AttributeInfo
jsmith
role,admin,15,role,contributor,15
@end


There are two magical parts to get this to work. First, you need to set the REQUEST (not response) content type. Second, your payload has to be in a certain format. Let’s look at each of these in turn.

First, here’s a sneak peek of the jQuery AJAX request:


$.ajax(
{
   type: "POST"
   , contentType: "text/hda; charset=utf-8"
   , url: ""
   , data: jQuery("#txtData").html()
   , success: function(msg)
   {
      alert(msg);
   }
   , error: function(msg)
   {
      alert("Error: " + msg);
   }
});


Notice the contentType setting!

Now, the payload, specified by the variable named data, has to be in a certain format. This format should start with IsJava=1 and be followed by the encoding and finally the first ResultSet known as LocalData. LocalData will contain the IdcService to be called, and a variety of over key/value pairs. At the end of that set we can include additional necessary ResultSets.

I have added an Edit User Sample HCSP zip to the Downloads page. Check this HCSP into your content server, go to Doc Info and click the web viewable link. The page will load with a text area and a button. Adjust the data in the text area and click submit!

Play around with it some and you should see how this all works together!

Dan, thanks for what turned out to be a fun puzzle.