<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
]>
<chapter id="admin">
  <title>Administration</title>   
       
       <section>
       		<title>Overview</title>

       		<para> 
       		This section describes the administration capabilities associated with RiftSaw.
       		</para>
       		
       </section>
       
       <section>
       		<title>BPM Console</title>

	       <section>
	       		<title>Overview</title>
	       		<para> 
	       		This section provides an overview of the BPEL Console.
	       		The console provides the ability to view:
	       		</para>
	       		
	       		<itemizedlist>
	       			<listitem>
	       			The process definitions deployed to the BPEL engine
	       			</listitem>
	       			<listitem>
	       			The process instances executing in the BPEL engine
	       			</listitem>
	       		</itemizedlist>
	       		
	       </section>
	       
	       <section>
	       		<title>Logging in</title>
	       		
	 			<para>
	 			The BPEL console can be located using the URL: 
	 			<ulink url="http://localhost:8080/bpel-console">http://localhost:8080/bpel-console</ulink>.
	 			</para>
	 			
	 			<para>
	 			The first screen that is presented is the login screen:
	 			</para>
	 			
				<imageobject>
					<imagedata fileref="images/BPELConsole-login.png" align="center" width="6in" />
				</imageobject>		
				
				<para>
				The default username is <emphasis>admin</emphasis> with password
				<emphasis>password</emphasis>.
				</para>
				
				<para>
				The Access Control mechanism used by the admin console is configured
				in the <filename>$deployFolder/bpel-console/bpel-identity.sar/META-INF/jboss-service.xml</filename>.
				The JAAS login module is initially set to use a property file based
				access mechanism, but can be replaced to use any appropriate alternative
				implementation.
				</para>
				
				<para>
				The users for the default mechanism are configured in the property file
				<filename>$deployFolder/bpel-console/bpel-identity.sar/bpel-users.properties</filename>.
				The entries in this file represent <emphasis>username=password</emphasis>.
				</para>
				
				<para>
				The user roles for the default mechanism are configured in the property file
				<filename>$deployFolder/bpel-console/bpel-identity.sar/bpel-roles.properties</filename>.
				The entries in this file represent <emphasis>username=role</emphasis>. The 
				only role of interest currently is <emphasis>administrator</emphasis>.	
				</para>
	       </section>
	       
	       <section>
	       		<title>Deployed Process Definitions</title>
	       		
	       		<para>
	       		Once logged in, the 'Process Overview' tab shows the currently deployed
	       		BPEL processes and their versions.
	       		</para>
	       		
				<imageobject>
					<imagedata fileref="images/BPELConsole-processes.png" align="center" width="6in" />
				</imageobject>			
				
	      </section>
	
			<section>
				<title>Process Instances</title>
	
	       		<para>
	       		When a process definition is selected, the list of active process instances for
	       		that process definition (and version) will be displayed in the right hand
	       		panel.
	       		</para>
	       		
				<imageobject>
					<imagedata fileref="images/BPELConsole-process-instances.png" align="center" width="6in" />
				</imageobject>			
	
	       		<para>
	       		When a process instance is selected, its details will be displayed in the lower
	       		<emphasis>Execution Details</emphasis>
	       		window. The <emphasis>Instance Data</emphasis> button will also become enabled, allowing
	       		further detail about the process to be displayed.
	       		</para>
	
				<imageobject>
					<imagedata fileref="images/BPELConsole-process-instance-data.png" align="center" width="6in" />
				</imageobject>			
	
			</section>
	       		
       </section>
       
</chapter>
