Installing UCM (Stellent) On Amazon EC2
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
John Klein Adds Business Value to Core Content Only Blog
Fellow Redstone Content Solutions founder John Klein has setup shop on the internet posting tips, information, etc., about how you can use Oracle ECM and other Oracle Fusion Middleware products to add Business Value to your organization. He is currently running a series that dovetails with his Collaborate 2010 panel session about how to select an implementation partner for your projects and initiatives.
Check it out at businessvalue.corecontentonly.com.
Microsft Releases Visual Studio 2010 Plus Goodies
VS2010 is now officially roaming the streets. Great coverage of what all this means over at the Scott Hanselman Blog.
I generally promote Oracle “stuff” on this blog, but I am a true believer in being aware of the rest of the world at the same time, as much as a single person can be “aware of everything” anyway.
Oracle Validated Setup on OEL 5 Update 4
For those of you that have ever tried to setup an Oracle Database on Linux you know there are a variety of steps to take on your fresh box before you can actually begin the installation process. You will need to install serveral binaries and those will perhaps have several depedencies. After that you will need to create an “oracle” user. And the list goes on. If you have a support subscription with a valid Customer Support Identifeir (CSI) this whole process gets MUCH easier.
My Unbreakable Linux Network support subscription and accompanying CSI allow for the use of the “up2date” command. This will update the binary I ask for as well as deduce, install and/or update any dependencies. Technically, I can accomplish the same tasks without the subscrption. This would require that I look up (and not miss) binary depedencies while also having the time to manually hunt down, download and install the binaries by hand. Or I can just use the up2date command!
Having just installed OEL5.4 and registered the box with the Unbreakable Linux Network I can use the up2date command along with the parameter “oracle-validated”. Running this command will update all the necessary binaries in prepartion for installing Oracle Database. It will resolve and install or update all related dependencies of those binaries. It will aso create the OS user oracle along with the oinstall and dba OS groups. Let’s try it out here:
[bash]
[root@localhost ~] up2date -i oracle-validated
Fetching Obsoletes list for channel: el5_x86_64_latest…
Fetching rpm headers…
*******************************************************
Name Version Rel
———————————————————-
oracle-validated 1.0.0 22.el5
Testing package set / solving RPM inter-dependencies…
There was a package dependency problem. The message was:
Unresolvable chain of dependencies:
glibc-headers 2.5-42.el5_4.3 requires kernel-headers
glibc-headers-2.5-42.el5_4.3 requires kernel-headers >= 2.2.1
oracle-validated 1.0.0-22.el5 requires kernel-headers
[/bash]
Oops. Need to update the kernel headers. When you try to run up2date again telling it to update kernel-headers it will likely not do so. This is because of how up2date is currently configured. We can override the configuration by using the –force command:
[bash]
[root@localhost ~] up2date –force kernel-headers
Fetching Obsoletes list for channel: el5_x86_64_latest…
Name Version Rel
———————————————————-
kernel-headers 2.6.18 164.15.1.0.1.el5
Testing package set / solving RPM inter-dependencies…
kernel-headers-2.6.18-164.1 ***************** Done.
Preparing ***************** [100%]
Installing…
1:kernel-headers ****************** [100%]
[/bash]
Now when you run your up2date command with oracle-validated it should work a lot better.
Updated Folders_g Component Works Better
The new (as of around March 15th) 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 30th 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.
Fast Workflow Debugging
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!
Suppressing Alternate File
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
How I Use Oracle UCM in the Cloud
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 22nd, 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.
jQuery Post With HDA Payload
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.
Good Forum Discussion on Accounts
There has been some good discussion going on over on the Oracle ECM Forums regarding Accounts. It started out as Accounts and Access Control Lists but it has morphed a little into some discussion about how to use Accounts in general and some possible structures people are using to layout their account hierarchies.
Check out these discussions about accounts in the Oracle ECM Forums:
http://forums.oracle.com/forums/thread.jspa?threadID=1001039&tstart=0
Jason Stortz
Jonathan Hult
Anton Bondar
