Packing an installing package needs a lot of knowledge, especially when the software will install packages which are developing by other contributors. It is very important to read all the documents to pack the installing package.
For example, I am packing an installing package which contains XMLSecurity, XALAN, and things. In my installing package, I put xalan.jar into jre/lib/ext, which will make no effect by doing so. OK, only after lots of works, I found the error that I made. But in the installation document page of XML Security, it says:
Using JDK 1.4.0
After SUN released the Java (TM) 2 Platform Standard Edition v1.4.0 , the xml-security package stopped working. This is a known problem: SUN packaged a beta of Xalan into the JDK 1.4.0, but the xml-security package requires a stable version of Xalan (v2.2.0 or later). To fix the problem, you have to put the xalan.jar into a special directory in your JDK: j2sdk1.4.0/jre/lib/endorsed/xalan.jar . If you installed an out-of-the-box JDK1.4 (e.g. on Windows 2000), the "endorsed" directory does not exist: you'll have to create it by hand.
For more on that, you can also check the
Unofficial JAXP FAQ
.
In which, the warning is marked as RED! If I spent some time reading
all related packages' installation documents, I will never make such a
mistake!
So this story tells me to read all related documents before packing package
.