diff options
Diffstat (limited to 'TAO/CIAO/DAnCE/ComponentPackager/README.html')
-rw-r--r-- | TAO/CIAO/DAnCE/ComponentPackager/README.html | 186 |
1 files changed, 186 insertions, 0 deletions
diff --git a/TAO/CIAO/DAnCE/ComponentPackager/README.html b/TAO/CIAO/DAnCE/ComponentPackager/README.html new file mode 100644 index 00000000000..db235e9ccf0 --- /dev/null +++ b/TAO/CIAO/DAnCE/ComponentPackager/README.html @@ -0,0 +1,186 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <title>Building and Installing ComponentPackager</title> + <!-- $Id$ --> + <link rev="made" href="mailto:schmidt@cs.wustl.edu"> + </head> + <body style="COLOR: rgb(0,0,0); BACKGROUND-COLOR: rgb(255,255,255)" link="#000fff" vlink="#ff0f0f"> + <hr> + <h3>Building and Using ComponentPackager + </h3> + <p><span style="FONT-WEIGHT: bold"></span>To successfully build + CIAO::ComponentPackager, you will need ZipArchive, a free zip compression and + decompression library developed by + artpol-software.(http://www.artpol-software.com/) . This file explains how to + set up the building of ZipArchive under different OS platforms such that the + CIAO::ComponentPackager can be compiled successfully. If this file does not + solve all the problems you might encounter compiling ComponentPackager, please + also check out <a href="http://www.artpol-software.com/zipdoc/pageSyst.html">ZipArchive + Compiling and Integration</a> for more information. If you are still + having problems, please feel free to contact me at <A href="mailto:mxiong@dre.vanderbilt.edu"> + mxiong@dre.vanderbilt.edu</A> . + <br> + </p> + <p>Currently, the ZipArchive version supported by ComponentPackager is 2.4.4. So + unless otherwise specified, please stay with this version. The following + explains how to build ZipArchive under <a href="#Windows">Windows </a>and <a href="#Linux"> + Linux</a>.<br> + </p> + <h3><span style="FONT-WEIGHT: bold">Table of Contents</span></h3> + <ul> + <li> + <a href="#Windows">Building under Windows</a> + <li> + <a href="#Linux">Building under Linux</a> + <li> + <a href="#Using">Creating packages using ComponentPackager</a></li> + </ul> + <br> + <hr> + <h3><a name="Windows">Windows </a> + </h3> + <p><a name="Windows"> To obtain and build ZipArchive under windows, please do:</a></p> + <p><a name="Windows">1. Download the ZipArchive source from </a><a href="http://www.artpol-software.com/cgi-bin/download.cgi?ziparchive.zip"> + here</a> , unzip it to a local direcoty, e.g. E:\ZipArchive<br> + 2. Navigate to ZipArchive\Windows directory, copy all the files into + ZipArchive\<br> + 3. Navigate to ZipArchive\stl directory, copy all the files (except zippie + folder) into ZipArchive\<br> + 4. Open ZipArchive_STL.dsw, click yes to convert it to solution file.<br> + 5. Change the output file property of ZipArchive_STL.dsw to \lib\ziparchd.lib + (originally it's \debug\ZipArchive_STL.lib). + <br> + 6. Build the solution, and you should be able to compile the ziparchive.<br> + 7. Add a environment variable ZIPARCHIVEROOT such that it contains the root + directory of ZipArchive. In this case, it would be E:\ZipArchive<br> + <br> + Now you should be able to build CIAO:Component_Packager.<br> + <br> + </p> + <hr> + <h3><a name="Linux">Linux</a></h3> + <a name="Linux">To obtain and build ZipArchive, do:<br> + 1. Obtains the ZipArchive + <br> + >wget + http://www.artpol-software.com/cgi-bin/download.cgi?ziparchive.zip<br> + <br> + 2. Create a directory for ziparchive and decompressed the + ziparchive.zip<br> + >mkdir ziplib<br> + >unzip ziparchive.zip -d ziplib<br> + <br> + 3. Copy the necessary files for linux OS<br> + >cd ziplib<br> + >cp ./Linux/* .<br> + >cp ./stl/* .<br> + <br> + 4. Edit the Makefile in the ./ziplib directory, do the following:<br> + </a> + <ul> + <a name="Linux"> + <li> + uncomment the first OBJSZLIB variable which points to zlib + library object files, and comment the second OBJSZLIB, this step is very + important if you do not want to build zlib separately<br> + <li> + change prefix to the root directory of ziplib, e.g. + ~/ziplib. You may choose not to proceed this step if you would like to install + ZipArchive to system include and library paths.<br> + </a></LI> + </ul> + <a name="Linux">5. Build ZipArchive by typing + <span style="FONT-STYLE: italic">make</span><br> + 6. Install the ZipArchive by typing + <span style="FONT-STYLE: italic">make +install<span style="FONT-STYLE: italic"></span></span> + </a> + <p><a name="Linux">7. Set up the environment variable + <br> + If you have installed the ziparchive into the system include + and library paths, you may skip this step. Otherwise, you might want to add an + environment variable ZIPARCHIVEROOT that contains the root directory of the + ZipArchive. For instance, in my ./.bash_profile i have the following entry:<br> + </a> + </p> + <p><a name="Linux"> ZIPARCHIVEROOT=~/ziplib<br> + export ZIPARCHIVEROOT<br> + </a> + </p> + <p><a name="Linux">Now you should be able to successfully build the + CIAO::Component_Packager.<br> + </a> + </p> + <hr> + <h3 name="Using"><a name="Using">Create Component Package using ComponentPackager</a></h3> + <P> + <a name="Linux">To create a package, ComponentPackager need the + flattened_deploymentplan to obtain the information about component + implementations. For instance, in the + <A HREF="../../docs/tutorials/Quoter/">Quoter + example</A>, here are the steps to + create a package:<br> + <br> + (assuming windows platform)<br> + 1. cd descriptors<br> + 2. %CIAO_ROOT%/DAnCE/ComponentPackager/Component_Packager.exe -p + flattened_deploymentplan.cdp<br> + (2552|3524) Initializing the Xerces runtime + <br> + ComponentPackager: Adding description ....[Done] + <br> + ComponentPackager: Adding + descriptors\flattened_deploymentplan.cdp ....[Done]<br> + ComponentPackager: Adding implementations\Broker_execd.dll + ....[Done]<br> + ComponentPackager: Adding implementations\Broker_stubd.dll + ....[Done]<br> + ComponentPackager: Adding implementations\Broker_svntd.dll + ....[Done]<br> + ComponentPackager: Adding + implementations\Distributor_execd.dll ....[Done]<br> + ComponentPackager: Adding + implementations\Distributor_stubd.dll ....[Done]<br> + ComponentPackager: Adding + implementations\Distributor_svntd.dll ....[Done]<br> + ComponentPackager: Adding + implementations\Stock_Base_stubd.dll ....[Done]<br> + ComponentPackager: Adding + implementations\Stock_Base_svntd.dll ....[Done]<br> + (2552|3524)[success] The Component Package has been created!<br> + <br> + Now you will be able to find a ComponentPackager.cpk file under ./descriptors + directory.Note that you can change the output package name by + using -o option, e.g.<br> + </a><a name="Linux"> %CIAO_ROOT%/DAnCE/ComponentPackager/Component_Packager.exe + -o Quoter.cpk -p flattened_deploymentplan.cdp</a></P> + <P><Blockquote><hr> + <STRONG>Note: </STRONG>To make sure the package has every implementation + artifact required, including the base library, e.g.Stock_Base_stub, you might + want to check your flattened_deploymentplan to make sure the base libraries are + also included as artifacts in the + implementation descriptions.Please check the Quoter example's + <A HREF="../../docs/tutorials/Quoter/Simple/descriptors/flattened_deploymentplan.cdp"> + flattened_deploymentplan.cdp</A> for details.<hr> + </Blockquote> + If you also want to archive separated descriptors other than + flattened_deploymentplan.cdp (.cid, .cpd, .iad etc ) into your package, you + will need to create a PackageDescriptorsList XML file which specifies what + files to include in your package. There is a sample .pdl file Sample.pdl + in the root directory of ComponentPackager. Please follow the same + pattern to create your own .pdl file. Along with the .pdl file is a standalone + xml schema file package.xsd which you will need to validate Sample.pdl. So make + sure you have this schema file along with the .pdl file you need to use. To + create a package that includes separated descriptors + <P></P> + <P> + 1. cd descriptors<br> + 2. copy %COPY_ROOT%/ComponentPackager/Sample.pdl .\<br> + 3. copy %COPY_ROOT%/ComponentPackager/Package.xsd .\<br> + 4. %CIAO_ROOT%/DAnCE/ComponentPackager/Component_Packager.exe -p + flattened_deploymentplan.cdp -i Sample.pdl<br> + <br> + </P> + </body> +</html> |