Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
<?xml version='1.0'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "JAIN_SLEE_Example_User_Guide.ent">
%BOOK_ENTITIES;
]>

<chapter id="setup">

	<title>Setup</title>

	<section id="preinstall_requirements_and_prerequisites">
		<title>Pre-Install Requirements and Prerequisites</title>
		<para>Ensure that the following requirements have been met before continuing with the install.</para>
		<section id="hardware_requirements">
			<title>Hardware Requirements</title>
			<para>The Example doesn't change the &THIS.PLATFORM; JAIN SLEE Hardware Requirements, refer to &THIS.PLATFORM; JAIN SLEE documentation for more information.</para>
		</section>
		<section id="software_prerequisites">
			<title>Software Prerequisites</title>
			<para>The Example requires &THIS.PLATFORM; JAIN SLEE properly set, with SIP11 Resource Adaptor deployed.</para>
		</section>
	</section>	
	
	<section id="source_code">
		<title>&THIS.PLATFORM; JAIN SLEE &THIS.EXAMPLE; Example Source Code</title>
		<para>This section provides instructions on how to obtain and build the &THIS.EXAMPLE; Example from source code.</para>
		
		<section id="release_source_building">
			<title>Release Source Code Building</title>
			<procedure>
				<step>
				    <title>Downloading the source code</title>
				    <important>
				    	<para>Subversion is used to manage its source code. Instructions for using Subversion, including install, can be found at <ulink url="http://svnbook.red-bean.com" /></para>
				    </important>
				    <para>Use SVN to checkout a specific release source, the base URL is &THIS.RELEASE_SOURCE_CODE_URL;, then add the specific release version, lets consider &THIS.VERSION;.</para>
				    <programlisting>[usr]$ svn co &THIS.RELEASE_SOURCE_CODE_URL;/&THIS.VERSION; slee-example-&THIS.EXAMPLE.DIRNAME;-&THIS.VERSION;</programlisting>				    
  				</step>
				<step>
				    <title>Building the source code</title>
				    <important>
				    	<para>Maven 2.0.9 (or higher) is used to build the release. Instructions for using Maven2, including install, can be found at <ulink url="http://maven.apache.org" /></para>
				    </important>
				     <para>Use Maven to build the deployable unit binary.</para>
				    <programlisting>
				    [usr]$ cd slee-example-&THIS.EXAMPLE.DIRNAME;-&THIS.VERSION;
				    [usr]$ mvn install
				    </programlisting>
				    <para>Once the process finishes you should have the <literal>deployable-unit</literal> jar file in the <filename>target</filename> directory, if &THIS.PLATFORM; JAIN SLEE is installed and environment variable JBOSS_HOME is pointing to its underlying &JEE.PLATFORM; directory, then the deployable unit jar will also be deployed in the container.</para>
  				</step>
			</procedure>      
		</section>	
		
		<section id="trunk_source_building">
			<title>Development Trunk Source Building</title>
			<para>Similar process as for <xref linkend="release_source_building"/>, the only change is the SVN source code URL, which is &THIS.TRUNK_SOURCE_CODE_URL;.</para>
		</section>	
		
	</section>
	
	<section id="install">
		<title>Installing &THIS.PLATFORM; JAIN SLEE &THIS.EXAMPLE; Example</title>
		<para>To install the Example simply execute provided ant script <filename>build.xml</filename> default target:</para>
		<programlisting>
		[usr]$ ant
		</programlisting>
		<para>The script will copy the Example's deployable unit jar to the <literal>default</literal> &THIS.PLATFORM; JAIN SLEE server profile deploy directory, to deploy to another server profile use the argument <literal>-Dnode=</literal>.</para>
		<note>
			<para>Some services may wish to receive <literal>INVITE</literal> request. Call: </para>
			<programlisting>
		[usr]$ ant deploy-all-without-initial-invite
			</programlisting>
			<para>to deploy &THIS.EXAMPLE; configuration which does not react to <literal>INVITE</literal></para>
	   </note>
	</section>
	
	<section id="uninstall">
		<title>Uninstalling &THIS.PLATFORM; JAIN SLEE &THIS.EXAMPLE; Example</title>
		<para>To uninstall the Example simply execute provided ant script <filename>build.xml</filename> <literal>undeploy</literal> target:</para>
		<programlisting>
		[usr]$ ant undeploy
		</programlisting>
		<para>The script will delete the Example's deployable unit jar from the <literal>default</literal> &THIS.PLATFORM; JAIN SLEE server profile deploy directory, to undeploy from another server profile use the argument <literal>-Dnode=</literal>.</para>
		<note>
			<para>Some services may wish to receive <literal>INVITE</literal> request. Call: </para>
			<programlisting>
		[usr]$ ant undeploy-all-without-initial-invite
			</programlisting>
			<para>to undeploy &THIS.EXAMPLE; configuration which does not react to <literal>INVITE</literal></para>
	   </note>
	</section>			
	
</chapter>

New to GrepCode? Check out our FAQ X