diff options
Diffstat (limited to 'TAO/CIAO/DAnCE/ComponentPackager/README.html')
-rw-r--r-- | TAO/CIAO/DAnCE/ComponentPackager/README.html | 182 |
1 files changed, 0 insertions, 182 deletions
diff --git a/TAO/CIAO/DAnCE/ComponentPackager/README.html b/TAO/CIAO/DAnCE/ComponentPackager/README.html deleted file mode 100644 index 6ee538c08a3..00000000000 --- a/TAO/CIAO/DAnCE/ComponentPackager/README.html +++ /dev/null @@ -1,182 +0,0 @@ -<!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. Take DAnCE/examples/Quoter for example, here's 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 - DAnCE/examples/Quoter/descriptors/flattened_deploymentplan.cdp 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> |