[Cogkit-svn] SF.net SVN: cogkit: [1862] trunk/cyberaide/src/axis2

[<je...@us...>]

Revision: 1862
          http://cogkit.svn.sourceforge.net/cogkit/?rev=1862&view=rev
Author:   jenvor
Date:     2008-01-03 14:44:29 -0800 (Thu, 03 Jan 2008)

Log Message:
-----------
write a install script which can ease installation of the system

Added Paths:
-----------
    trunk/cyberaide/src/axis2/INSTALL
    trunk/cyberaide/src/axis2/scripts/install.sh

Added: trunk/cyberaide/src/axis2/INSTALL
===================================================================
--- trunk/cyberaide/src/axis2/INSTALL	                        (rev 0)
+++ trunk/cyberaide/src/axis2/INSTALL	2008-01-03 22:44:29 UTC (rev 1862)
@@ -0,0 +1,63 @@
+How to install the whole CoGkit Javascript system
+
+Steps:
+(1) You should check out the install.sh which should be executed in bash.
+(2) Then run the script.
+After you run the script, three files should be generated:
+* SimpleHandlerInterface.aar
+* StatusServiceInterface.aar
+* SimpleHandlerInterface-test-client.jar
+
+SimpleHandlerInterface.aar
+   This is the package which provides executor service in our system.
+
+StatusServiceInterface.aar
+   This is the package which provides status service.
+
+SimpleHandlerInterface-test-client.jar
+   This is the package which provides agent service.
+
+Before further going on, you should have following requirements satisfied:
+(1) You should have a servlet/JSP container. 
+   Currently, my system is only tested on Apache Tomcat.
+(2) Axis2 is deployed correctly in the container.
+(3) Apache Xmlrpc is correctly deployed in the container.
+
+Now, you are ready to deploy our system.
+(1) deploy SimpleHandlerInterface.arr into Axis2 at the machine which will
+    host executor service.
+
+	(1.1) You must create and edit the configuration file: executor.properties.
+	This file contains the address of the status service.
+	Typically, the content looks like this:
+		statusserviceendpoint=http://ip:port/axis2/services/StatusServiceInterface
+	(1.2) You must create and edit the configuration file: myproxy.properties.
+	This file contains the address and user account of a MyProxy server.
+	Typically, the content looks like this:
+		host=gf1.ucs.indiana.edu
+		port=7512
+		user=username
+		pwd=password
+
+(2) deploy StatusServiceInterface.aar into Axis2 at the machine which will
+    host status service.
+
+(3) Checkout all files and directories from:
+    http://cogkit.svn.sourceforge.net/svnroot/cogkit/trunk/cyberaide/src/js/securelogin
+	These files provide web-based interface for end users to submit workflows
+	and query status of workflows.
+	These files should be checked out into your Xmlrpc application directory at the 
+	machine which will host the agent service.
+
+	Deploy SimpleHandlerInterface-test-client.jar. You should consult manual of Xmlrpc to see 
+	exactly whether the .jar files should be positioned.
+	Xmlrpc must be configured correctly.
+
+	You must create and edit the configuration file: agent.properties.
+	This file contains address of executor service.
+	The content looks like this:
+		serviceendpoint=http://156.56.104.196:8080/axis2/services/SimpleHandlerInterface
+		agentdb=/tmp/agentdb.txt
+	
+	Now address of the status service is hard-coded in the source code of agent service.
+	This will be modified later.

Added: trunk/cyberaide/src/axis2/scripts/install.sh
===================================================================
--- trunk/cyberaide/src/axis2/scripts/install.sh	                        (rev 0)
+++ trunk/cyberaide/src/axis2/scripts/install.sh	2008-01-03 22:44:29 UTC (rev 1862)
@@ -0,0 +1,158 @@
+#!/bin/sh
+
+############################################################################
+#	This script is used to install the Web-based CoGKit.	
+############################################################################
+#First get the source code from svn repository
+svn checkout http://cogkit.svn.sourceforge.net/svnroot/cogkit/trunk/cyberaide/src/axis2 cyberaide/src/axis2 > /dev/null
+
+basedir='cyberaide/src/axis2'
+cwd=`pwd`
+
+#this dir should contain the agent server related files
+clientsrcdir=${basedir}/axis2ws_client
+#interface file
+agentServicei='SimpleHandlerClientInterface.java'
+#implementation
+agentService='SimpleHandlerClient.java'			 
+
+#this dir should contain executor and state server related files
+serversrcdir=${basedir}/axis2ws_server
+#status service interface
+statusservicei='StatusServiceInterface.java'	 
+#Status service implementation
+statusservice='StatusServiceInterfaceSkeleton.java'
+#executor service interface
+executorservicei='SimpleHandlerInterface.java'	 
+#executor implementation
+executorservice='SimpleHandlerInterfaceSkeleton.java'
+
+#temporary directory where the compilation and building work of status service is done. 
+statusservicedir='statusservice'	
+executorservicedir='executor'
+
+#name of the makefile which will be used to build various service.
+makefile='makefile'	
+#directory which contains bash scripts needed by the makefile
+scriptdir=${cwd}/${basedir}/scripts
+
+#package name of all these files
+packagename='org.cogkit.cyberaide.axis2ws'	 
+packagepath=`echo ${packagename//.//}`
+
+
+if [ ! -d ${serversrcdir} ]; then
+	echo "Directory ${serversrcdir} can not be found"
+	exit 1
+fi
+
+oldpwd1=`pwd`
+
+############################################################
+#
+#	Build state service
+#	
+############################################################
+cd ${serversrcdir}
+#create a new directory which will contain statu service related files
+mkdir ${statusservicedir}
+
+oldpwd2=`pwd`
+#copy files StatusServiceInterface.java and makefile to the new created directory.
+cp ${statusservicei} ${statusservicedir}/
+cp ${scriptdir}/${makefile} ${statusservicedir}/
+
+#build client and server stub 
+cd ${statusservicedir}
+make csfromjava scriptdir=${scriptdir} java=${statusservicei}
+cd ${oldpwd2}
+
+#copy the server side skeleton file "StatusServiceInterfaceSkeleton.java" to the
+#corresponding path
+path=${statusservicedir}/server/src/${packagepath}
+cp ${statusservice} ${path}/
+
+#build final package (a .arr file for server side and a .jar file for client side)
+cd ${statusservicedir}
+make serverbuild scriptdir=${scriptdir}
+cd ${oldpwd2}
+
+aar=`echo ${statusservicei//.java/.aar}`
+cp ${statusservicedir}/${aar} ${oldpwd1}/
+
+############################################################
+#
+#	Build executor service
+#	
+############################################################
+mkdir ${executorservicedir}
+
+cp ${executorservicei} ${executorservicedir}/
+cp ${scriptdir}/${makefile} ${executorservicedir}/
+
+cd ${executorservicedir}
+make csfromjava scriptdir=${scriptdir} java=${executorservicei}
+cd ${oldpwd2}
+
+#copy the server side skeleton file "SimpleHandlerInterfaceSkeleton.java" to the
+#corresponding path
+exeserverpath=${executorservicedir}/server/src/${packagepath}
+cp ${executorservice} ${exeserverpath}/
+
+#copy client side stub file of Status service to server side of executor service
+staclientpath=${statusservicedir}/client/src/${packagepath}
+clientstub=`echo ${statusservicei//.java/Stub.java}`
+clientstub=${staclientpath}/${clientstub}
+cp ${clientstub} ${exeserverpath}/
+
+#build final package (a .arr file for server side and a .jar file for client side)
+cd ${executorservicedir}
+make serverbuild scriptdir=${scriptdir}
+cd ${oldpwd2}
+
+aar=`echo ${executorservicei//.java/.aar}`
+cp ${executorservicedir}/${aar} ${oldpwd1}/
+
+
+############################################################
+#
+#	Build agent server	
+#	
+############################################################
+#copy client side stub file of Status service, interface of agent service and implementation
+#of agent service to client side of executor service
+execlientpath=${executorservicedir}/client/src/${packagepath}
+cp ${clientstub} ${execlientpath}/
+cd ${oldpwd1}
+cp ${clientsrcdir}/${agentService} ${serversrcdir}/${execlientpath}/
+cp ${clientsrcdir}/${agentServicei} ${serversrcdir}/${execlientpath}/
+cd ${oldpwd2}
+
+#build final package (a .jar file for client side)
+cd ${executorservicedir}
+make clientbuild scriptdir=${scriptdir}
+cd ${oldpwd2}
+
+cp ${executorservicedir}/client/build/lib/*.jar ${oldpwd1}/
+
+############################################################
+#
+#	Clear
+#	
+############################################################
+#rm -rf ${statusservicedir}
+#rm -rf ${executorservicedir}
+
+cd ${oldpwd1}
+
+cat<<EOF
+Now, you have successfully built the agent server, executor service and state service.
+(*) The files corresponding to txecutor service and state service are .aar files and you should
+deploy these files to Axis2 which is typically run in Apache Tomcat. The typical path is 
+"${TOMCAT_ROOT}/webapps/axis2/WEB_INF/services".
+(**) The file corresponding to the agent service is a .jar file and you can deploy it in Tomcat
+directly. But, Apache Xmlrpc is used and you should consult the manual of Apache Xmlrpc to
+deploy it correctly. The typical path is "${TOMCAT_ROOT}/webapps/your_service_dir/WEB_INF/classes/".
+EOF
+
+rm -rf cyberaide


Property changes on: trunk/cyberaide/src/axis2/scripts/install.sh
___________________________________________________________________
Name: svn:executable
   + *


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.