Customizing the IDM4.0 RBPM: Establishing a separate WAR file for customizations.
Rounding up all the steps required to customize an external theme.war file for the RBPM took a while, and because of that I thought it useful to pass on. The nice thing about this is that other than to copy your IDMProv.WAR file (or whatever you named it) out to a working directory, you never have to alter that main WAR file. You will make changes in another, custom file, and deploy it. If it doesn't work, delete the custom war file (which lives harmoniously, side by side with the "main" war file) and you're back at square one, functional one hopes, ready to try again.
What you will be doing:
It SHOULD go without saying, but it doesn't: You are going to be replacing some files during the course of your work. Please, backup the file before you play with it, so that you can at least return the original to production (or, hopefully, the test environment where you are first experimenting with this!)
Let us begin:
CUSTOM --You may keep as many custom themes in your custom .WAR file as you like. This example has 2.
MyBlueGloss---(and contents below it)
MyNeptune --- (and contents below it)
You may ultimately do more of the things you find on this documentation page, but as far as simply getting a custom theme to work, let's keep moving.
After getting all of the files modified and corralled in your "custom" folder structure, you're ready to "jar" them up into a custom theme "war" file.
/opt/novell/jdk1.6.0_20/bin/jar cvf MyCustomThemes.war *
This basically says, "Roll up everything in the "custom" directory and pack it into a war file called "MyCustomThemes.war" (name it as you like.) (There are spaces between "jar" and "cvf", and before the asterisk (*) ).
After issuing the command, you will see a new file appear alongside your WEB-INF and resource folders: "MyCustomThemes.war" You will deploy that in the last step, to the same directory where your "main" war lives.
<property>NOTE: The <value> is the NAME of your WAR file, without the extension. It is NOT the name of any of your custom themes that might be embedded in said .war file. (except by coincidence, perhaps)
From your custom folder: cp MyCustomThemes.war /opt/novell/idm/jboss/server/<your deploy context>/deploy/