Mail Archive Home | orchestra-commits List | July 2007 Index
| <-- Date Index --> | <-- Thread Index --> |
Improved the README file and reordered the project POM.
--- branches/Orchestra_4_0/README.txt 2007-07-23 08:29:29 UTC (rev 705)
+++ branches/Orchestra_4_0/README.txt 2007-07-24 08:47:17 UTC (rev 706)
@@ -1,35 +1,40 @@
-/////////////////////////////////////////////////////////////////////////////////////////
-/////////// SOME BASICS INSTRUCTION TO RUN ORCHESTRA LIGHT //////////////
-/////////////////////////////////////////////////////////////////////////////////////////
+////////////////////////////////////////////////////////////////////////////////
+///////// BASIC INSTRUCTIONS TO RUN ORCHESTRA LIGHT ////////////
+////////////////////////////////////////////////////////////////////////////////
////////////////////////////////
-//// TO BUILD THE PROJECT ////
+//// BUILDING THE PROJECT ////
////////////////////////////////
-The project is build with maven2, which allows to build easyly.
-Maven need to download some external package to work. This packages
-will be stored in your local repository.
+The project is built using maven2 for easier build management.
+Maven needs to download all project dependencies before compiling the project.
+These packages are dowloaded only once, and will be stored in your local Maven
+repository.
To compile the project:
- >mvn compile : compile all the sources
- >mvn install : execute the JUnit tests, and create the .jar file from the compiled sources
- >mvn assembly:assembly : create the .zip file fo the binaries file of orchestra. This zip file allows you to
- deploy and run orchestra.
+ >mvn compile : compiles all sources
+ >mvn install : executes the JUnit tests, and creates the .jar file from the
+ compiled sources
+ >mvn assembly:assembly : creates a .zip file containing the Orchestra
+ binaries. This zip file allows you to deploy and run
+ Orchestra.
-You can skip the JUnit tests of "mvn install" and "mvn assembly:assembly" with the "-Dmaven.test.skip=true" option.
+You may skip the unit testing step of "mvn install" and "mvn assembly:assembly"
+with the Maven "-Dmaven.test.skip=true" option.
///////////////////////////////////////
-//// TO DEPLOY ORCHESTRA ON AXIS ////
+//// DEPLOYING ORCHESTRA ON AXIS ////
///////////////////////////////////////
-When you have generated the zip file, you can copy it in the directory where you want to install tomcat.
-The zip file is located in the target directory of the orchestra project.
+After generating the zip file, copy it in the directory where you want to
+install tomcat. The zip file can be found in the target directory of the
+Orchestra project.
Unzip the file:
->unzip Orchestra-4.(*)-bin.zip
+>unzip Orchestra-4.(*)-bin.zip
A new directory will be created with the following structure:
@@ -43,54 +48,56 @@
NOTICE.txt
README.txt
-The bin directory contains an ant file to deploy Orchestra and to start Orchestra.
-The conf directory contains configuration file for the engine, and for axis.
-The lib directory contains all .jar file needed to execute the engine.
-The demos directory contains some demos of processes available, with an ant script to launch them.
-The logs directory contains orchestra logs.
+The bin directory contains an ant file to deploy and start Orchestra.
+The conf directory contains configuration files for the engine and axis.
+The lib directory contains all .jar files needed to execute the engine.
+The demos directory contains a few demos of available processes, with an ant
+script to launch them.
+The logs directory contains Orchestra logs.
-You have to create the environment variable ORCHESTRA_HOME:
->export ORCHESTRA_HOME=you_installation_directory/Orchestra-4.0.1
+Then create the environment variable ORCHESTRA_HOME:
+>export ORCHESTRA_HOME=your_installation_directory/Orchestra-4.0.1
/////////////////////////////////////////
-//// TO START THE PROCESSDEPLOYER ////
+//// STARTING THE PROCESSDEPLOYER ////
/////////////////////////////////////////
-Axis must be instaled with a version of tomcat.
+Axis must be installed with a version of tomcat.
-To deploy the process, you need 4 environment variables:
+To deploy the process, make sure the following environment variables are set:
-ORCHESTRA_HOME
-JAVA_HOME
-CATALINA_BASE
-CATALINA_HOME
+ORCHESTRA_HOME (see above)
+JAVA_HOME (the directory in which the Sun Java JDK is installed)
+CATALINA_HOME (the directory in which the tomcat container is installed)
+CATALINA_BASE (a tomcat instance directory, may also be set to CATALINA_HOME)
-Once this variables are available, you can deploy orchestra:
+Once these variables are set, Orchestra may be deployed:
+
In the $ORCHESTRA_HOME/bin directory:
>ant deploy
To undeploy
>ant undeploy
-Start tomcat with the -security option
-$CATALINA_BASE/bin/startup.sh -security
-(you may be have to modify catalina.policy configuration to allow RMI connections.)
+Start tomcat with the -security option:
+>$CATALINA_BASE/bin/startup.sh -security
+(you may have to modify catalina.policy configuration to allow RMI connections.)
Start the process deployer:
>ant start
-The engine should be start.
-You can now deploy processes.
+The engine should be started.
+You may now deploy processes.
////////////////////////////
/////// DEMOS /////////
////////////////////////////
-To execute this part, the engine must be started (cf previous section).
+To execute this part, the engine must be already started (cf. previous section).
@@ -100,7 +107,7 @@
Deploy the weather2 process.
>ant deployWeather2
-Call the weather2 process in asking the meteo in Grenoble.
+Call the weather2 process and try for instance with the weather in Grenoble.
You must have a network connection.
>ant callWeather2
--- branches/Orchestra_4_0/pom.xml 2007-07-23 08:29:29 UTC (rev 705)
+++ branches/Orchestra_4_0/pom.xml 2007-07-24 08:47:17 UTC (rev 706)
@@ -80,45 +80,112 @@
</dependency>
<dependency>
- <groupId>org.apache.axis</groupId>
- <artifactId>axis-jaxrpc</artifactId>
- <version>1.4</version>
+ <groupId>commons-discovery</groupId>
+ <artifactId>commons-discovery</artifactId>
+ <version>0.2</version>
</dependency>
<dependency>
- <groupId>axis</groupId>
- <artifactId>axis-saaj</artifactId>
- <version>1.3</version>
+ <groupId>jaxen</groupId>
+ <artifactId>jaxen</artifactId>
+ <version>1.1</version>
+ <exclusions>
+ <exclusion>
+ <groupId>dom4j</groupId>
+ <artifactId>dom4j</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>jdom</groupId>
+ <artifactId>jdom</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>xerces</groupId>
+ <artifactId>xmlParserAPIs</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>xerces</groupId>
+ <artifactId>xercesImpl</artifactId>
+ </exclusion>
+ <exclusion>
+ <groupId>xom</groupId>
+ <artifactId>xom</artifactId>
+ </exclusion>
+ </exclusions>
</dependency>
<dependency>
- <groupId>commons-discovery</groupId>
- <artifactId>commons-discovery</artifactId>
- <version>0.2</version>
+ <groupId>junit</groupId>
+ <artifactId>junit</artifactId>
+ <version>4.1</version>
+ <scope>test</scope>
</dependency>
+ <dependency>
+ <groupId>wsdl4j</groupId>
+ <artifactId>wsdl4j</artifactId>
+ <version>1.6.2</version>
+ </dependency>
- <dependency>
- <groupId>org.apache.axis</groupId>
- <artifactId>axis</artifactId>
- <version>1.4</version>
- <exclusions>
- <exclusion>
- <groupId>org.apache.axis</groupId>
- <artifactId>axis-wsdl4j</artifactId>
- </exclusion>
- </exclusions>
+ <dependency>
+ <groupId>xalan</groupId>
+ <artifactId>xalan</artifactId>
+ <version>2.6.0</version>
</dependency>
+ <dependency>
+ <groupId>xerces</groupId>
+ <artifactId>xercesImpl</artifactId>
+ <version>2.8.1</version>
+ </dependency>
+
+ <dependency>
+ <groupId>com.sun.xsom</groupId>
+ <artifactId>xsom</artifactId>
+ <version>20070515</version>
+ <exclusions>
+ <exclusion>
+ <groupId>xerces</groupId>
+ <artifactId>xmlParserAPIs</artifactId>
+ </exclusion>
+ </exclusions>
+ </dependency>
+
+ <!-- Axis dependencies -->
+
<dependency>
<groupId>org.apache.axis</groupId>
<artifactId>axis-ant</artifactId>
<version>1.4</version>
</dependency>
+ <dependency>
+ <groupId>org.apache.axis</groupId>
+ <artifactId>axis</artifactId>
+ <version>1.4</version>
+ <exclusions>
+ <exclusion>
+ <groupId>org.apache.axis</groupId>
+ <artifactId>axis-wsdl4j</artifactId>
+ </exclusion>
+ </exclusions>
+ </dependency>
+
+ <dependency>
+ <groupId>org.apache.axis</groupId>
+ <artifactId>axis-jaxrpc</artifactId>
+ <version>1.4</version>
+ </dependency>
+
+ <dependency>
+ <groupId>axis</groupId>
+ <artifactId>axis-saaj</artifactId>
+ <version>1.3</version>
+ </dependency>
+
+ <!-- End of Axis dependencies -->
+
<!-- LUCAS dependencies -->
-
<dependency>
<groupId>commons-configuration</groupId>
<artifactId>commons-configuration</artifactId>
@@ -137,7 +204,6 @@
</exclusions>
</dependency>
-
<dependency>
<groupId>juddi</groupId>
<artifactId>juddi</artifactId>
@@ -168,30 +234,32 @@
<version>1.3.1</version>
</dependency>
- <!-- End of LUCAS dependencies -->
- <!-- SCT dependencies -->
+ <!-- End of LUCAS dependencies -->
+
+ <!-- SCT dependencies -->
+
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.3.1</version>
- </dependency>
+ </dependency>
+
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-core</artifactId>
<version>0.9.5</version>
- </dependency>
+ </dependency>
+
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>0.9.5</version>
</dependency>
-
<!--
unavailable from public repositories due to licence reasons
it needs to be downloaded from http://java.sun.com/xml/downloads/jaxm.html
-->
-
<dependency>
<groupId>javax.xml</groupId>
<artifactId>jaxm-api</artifactId>
@@ -200,78 +268,8 @@
<!-- End of SCT dependencies -->
- <dependency>
- <groupId>com.sun.xsom</groupId>
- <artifactId>xsom</artifactId>
- <version>20070515</version>
- <exclusions>
- <exclusion>
- <groupId>xerces</groupId>
- <artifactId>xmlParserAPIs</artifactId>
- </exclusion>
-
- </exclusions>
- </dependency>
-
- <dependency>
- <groupId>xalan</groupId>
- <artifactId>xalan</artifactId>
- <version>2.6.0</version>
- </dependency>
-
- <dependency>
- <groupId>xerces</groupId>
- <artifactId>xercesImpl</artifactId>
- <version>2.8.1</version>
- </dependency>
-
- <dependency>
- <groupId>jaxen</groupId>
- <artifactId>jaxen</artifactId>
- <version>1.1</version>
- <exclusions>
- <exclusion>
- <groupId>dom4j</groupId>
- <artifactId>dom4j</artifactId>
- </exclusion>
- <exclusion>
- <groupId>jdom</groupId>
- <artifactId>jdom</artifactId>
- </exclusion>
- <exclusion>
- <groupId>xerces</groupId>
- <artifactId>xmlParserAPIs</artifactId>
- </exclusion>
- <exclusion>
- <groupId>xerces</groupId>
- <artifactId>xercesImpl</artifactId>
- </exclusion>
- <exclusion>
- <groupId>xom</groupId>
- <artifactId>xom</artifactId>
- </exclusion>
- </exclusions>
- </dependency>
-
-
-
-
-
- <dependency>
- <groupId>wsdl4j</groupId>
- <artifactId>wsdl4j</artifactId>
- <version>1.6.2</version>
- </dependency>
-
- <dependency>
- <groupId>junit</groupId>
- <artifactId>junit</artifactId>
- <version>4.1</version>
- <scope>test</scope>
- </dependency>
</dependencies>
-
<build>
<pluginManagement>
<plugins>
| <-- Date Index --> | <-- Thread Index --> |
Powered by MHonArc.
Copyright © 2006-2007, OW2 Consortium | contact | webmaster.