Modified: webservices/site/trunk/targets/axis2/webadminguide.html URL: http://svn.apache.org/viewcvs/webservices/site/trunk/targets/axis2/webadminguide.html?rev=291622&r1=291621&r2=291622&view=diff ============================================================================== --- webservices/site/trunk/targets/axis2/webadminguide.html (original) +++ webservices/site/trunk/targets/axis2/webadminguide.html Mon Sep 26 06:46:26 2005 @@ -2,63 +2,71 @@ @import url("./style/maven-base.css"); @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/"; id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif";></img></a><a href="http://ws.apache.org/axis2/"; id="projectLogo"><img alt="Apache Axis 2.0" src="http://ws.apache.org/axis/images/axis.jpg";></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft"> - Last published: 09 September 2005 - | Doc for 0.91</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN"; class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="axis2tools.html">Tools</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2"; class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.html">Migrating from Axis 1.x</a></li><li class="none"><a href="api/index.html">Online Java Docs</a></li><li class="none"><a href="otherTutorials.html">Other Tutorials</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="faq.html">FAQ</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/"; title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><p></p></div><div class="section"><a name="Introduction"></a><h2>Introduction</h2><p>Axis2 web administration module provides a way to configure axis2 dynamically. -Its important to note that this dynamic configuration will NOT be persistent, i.e. if the servlet - container is restarted then all the dynamic configuration changes will be lost.</p><p></p><div class="subsection"><a name="Loging_into_administartion_site"></a><h3>Loging into administartion site</h3><p>From axis2 index page you can go to administration page by following -Axis2 Administration link, then logging page will appear asking for a user -name and a password , the default username is 'admin' (without quotes) and default -password is 'axis2' (without quotes). - You can change those two values by changing following two parameters in server.xml as required. -</p><p align="left"><strong><img src="images/parameters.jpg" alt=""></img></strong></p><p align="left"><strong><img src="images/adminloging.jpg" alt=""></img></strong></p><p>If the login succeed you will be see as shown below. This is where you can view the -configuration and the state of the running system and dynamically configure it. </p><p align="left"><strong><img src="images/admin.jpg" alt=""></img></strong></p></div></div><div class="section"><a name="Administration_Options"></a><h2>Administration Options</h2><ul> -<b>System components</b> -<li><a href="#heading1">List available services</a></li> -<li><a href="#avmodules">List available modules</a></li> -<li><a href="#globalmodules">List globally engaged modules</a></li> -<li><a href="#phases">View available phases</a></li> -<br></br> -<b>Execution chains</b> -<li><a href="#globalchains">Global chanins</a></li> -<li><a href="#operationchains">Operation specific chains</a></li> -<br></br> -<b>Other</b> -<li><a href="#engaginmodule">Engage module</a></li> -<br></br> -<b>Edit Service</b> -<li><a href="#turnoffservice">Turn off a service</a></li> -<li><a href="#editservicepara">Edit service parameters</a></li> -</ul></div><div class="section"><a name="List_Available_services"></a><h2>List Available services</h2><p>The functionality of the 'List Available Services' option is almost same - as the functionality of the axis to main page where it displayes the list of - deployed services. But as an additional feature, if there are any - modules engaged globally, to services or to operations those details - will be displayed here. </p><p align="left"><strong><img src="images/adminmain.jpg" alt=""></img></strong></p></div><div class="section"><a name="List_Available_modules"></a><h2>List Available modules</h2><p>To view the available modules in the "repository/modules" you just have - to click the 'Available Modules' then it will show you all the available modules - in the system and those modules can be engaged dynamically. </p><p align="left"><strong><img src="images/modules.jpg" alt=""></img></strong></p><br></br></div><div class="section"><a name="List_Globally_engaged_modules"></a><h2>List Globally engaged modules</h2><p>From the globally engaged modules you can see the globally engaged - modules if any , if a module was engaged globally then the - handlers that belong to that module will be executed irrespective of the service. - The 'Globally Engaged Modules' option lists the above list of modules. - </p><br></br></div><div class="section"><a name="View_available_phases"></a><h2>View available phases</h2><p>In axis2 there are two levels of phases:</p><ul> - <li>system predefined phases(not allowed to be changed)</li> - <li>user defined phases</li> - </ul><p>The main difference between those two levels of phases is that, in the case of - system predefined phases, the phases will be invoked irrespective of the irrespective of the services. - When the dispatcher finds the operation then user defined phase list will be invoked. - It should be noted that the module developers and service writers are really required to - have a good understanding of phases and phase ordering.</p><img src="images/viewphases.jpg" alt=""></img><br></br></div><div class="section"><a name="View_Global_chanins"></a><h2>View Global chanins</h2><p>The most interesting feature of axis2 web admin module is that it provide a very basic - way of viewing the global phase list and handlers inside the phases depending on - both phase and handler orders. This kind of information is extreamly useful in debugging - the system, because there is no way to list out the handlers in the - global chains except this. And if you engage a new module the new handlers - will be added to the global chains and those will be displayed in this page.</p><p align="left"><strong><img src="images/globalchain.jpg" alt=""></img></strong></p><br></br></div><div class="section"><a name="View_operation_specific_chains"></a><h2>View operation specific chains</h2><p>The 'Operation Specific Chains' can be used to view the handlers corresponding - to a given service in the same order as there in the real execution chain.</p><p align="left"><strong><img src="images/serviceHandlers.jpg" alt=""></img></strong></p><br></br></div><div class="section"><a name="Engaging_modules"></a><h2>Engaging modules</h2><p>Modules can be engaged either globally, to a service or to an operation -depending on the module implementation. If the module was designed to -engage the handlers globally then handlers in the module can be included in any phase in -the system. It can be either system predefined or user defined phase.</p><p>In there other hand if the module was implemented in such a way that is going - to be deployed to a service or to an operation then the module canNOT be included in - any of system predefined phases. So that it can only be included in user defined phases. </p><p>Immediately after engaging the module you can see the status of the engagement -, indicating whether it is engaged properly or not. </p><p align="left"><strong><img src="images/moduleengage.jpg" alt=""></img></strong></p><p> </p><br></br></div><div class="section"><a name="Turn_off_a_service"></a><h2>Turn off a service</h2><p> - This functionality provide a way to remove unnecessary services from the running system, but the removal is transient meaning if you restart the system the service will be available. - </p><p align="left"><strong><img src="images/removeservice.jpg" alt=""></img></strong></p><br></br></div><div class="section"><a name="Edit_service_parameters"></a><h2>Edit service parameters</h2><p> -This functionality provide a way to change parameters in a service or its operations, and those changes will be transient too. -</p><p align="left"><strong><img src="images/editserviecpara.jpg" alt=""></img></strong></p></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2005, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html> \ No newline at end of file + Last published: 26 September 2005 + | Doc for 0.92</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Download Axis2</a><ul><li class="none"><a href="download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN"; class="externalLink" title="External Link">Source Code</a></li></ul></li><li class="expanded"><a href="">Getting Started with Axis2</a><ul><li class="none"><a href="installationguide.html">Installation Guide</a></li><li class="none"><a href="userguide.html">User Guide</a></li><li class="none"><a href="webadminguide.html">Web Administration Guide</a></li></ul></li><li class="expanded"><a href="docs.html">Additional Reference</a><ul><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2"; class="externalLink" title="External Link">Axis2 Wiki</a></li><li class="none"><a href="Axis2ArchitectureGuide.html">Architecture Guide</a></li><li class="none"><a href="OMTutorial.html">AXIOM Tutorial</a></li><li class="none"><a href="CodegenToolReference.html">Code Generation Tutorial</a></li><li class="none"><a href="rest-ws.html">REST Support</a></li><li class="none"><a href="mtom-guide.html">Handling Binary Data with Axis2</a></li><li class="none"><a href="axis2config.html">Axis2 Configuration Guide</a></li><li class="none"><a href="migration.html">Migrating from Axis 1.x</a></li><li class="none"><a href="api/index.html">Online Java Docs</a></li><li class="none"><a href="otherTutorials.html">Other Tutorials</a></li></ul></li><li class="expanded"><a href="overview.html">Get Invloved</a><ul><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="faq.html">FAQ</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/"; title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><p></p></div><div class="section"><a name="Introduction"></a><h2>Introduction</h2><p>Axis2 web administration module provides a way to configure axis2 +dynamically. Its important to note that this dynamic configuration will NOT +be persistent, i.e. if the servlet container is restarted then all the +dynamic configuration changes will be lost.</p><p></p><div class="subsection"><a name="Login_into_administration_site"></a><h3>Login into administration site</h3><p>From axis2 index page you can go to administration page by following Axis2 +Administration link, then logging page will appear asking for a user name and +a password , the default username is 'admin' (without quotes) and default +password is 'axis2' (without quotes). You can change those two values by +changing following two parameters in server.xml as required.</p><p align="left"><strong><img src="images/parameters.jpg" alt=""></img></strong></p><p align="left"><strong><img src="images/adminlogin.jpg" alt=""></img></strong></p><p>If the login succeed you will be see as shown below. This is where you can +view the configuration and the state of the running system and dynamically +configure it.</p><p align="left"><strong><img src="images/admin.jpg" alt=""></img></strong></p></div></div><div class="section"><a name="Administration_Options"></a><h2>Administration Options</h2><ul> + <b>System components</b> <ul> + <li><a href="#heading1">List available services</a></li> + <li><a href="#avmodules">List available modules</a></li> + <li><a href="#globalmodules">List globally engaged modules</a></li> + <li><a href="#phases">View available phases</a></li> + </ul> + <br></br> + <b>Execution chains</b> <ul> + <li><a href="#globalchains">Global chains</a></li> + <li><a href="#operationchains">Operation specific chains</a></li> + </ul> + <br></br> + <b>Other</b> <ul> + <li><a href="#engaginmodule">Engage module</a></li> + </ul> + <br></br> + <b>Edit Service</b> <ul> + <li><a href="#turnoffservice">Turn off a service</a></li> + <li><a href="#editservicepara">Edit service parameters</a></li> + </ul> +</ul></div><div class="section"><a name="List_Available_services"></a><h2>List Available services</h2><p>The functionality of the 'List Available Services' option is almost same +as the functionality of the axis to main page where it displays the list of +deployed services. But as an additional feature, if there are any modules +engaged globally, to services or to operations those details will be +displayed here.</p><p align="left"><strong><img src="images/adminmain.jpg" alt=""></img></strong></p></div><div class="section"><a name="List_Available_modules"></a><h2>List Available modules</h2><p>To view the available modules in the "repository/modules" you just have to +click the 'Available Modules' then it will show you all the available modules +in the system and those modules can be engaged dynamically.</p><p align="left"><strong><img src="images/modules.jpg" alt=""></img></strong></p><br></br></div><div class="section"><a name="List_Globally_engaged_modules"></a><h2>List Globally engaged modules</h2><p>From the globally engaged modules you can see the globally engaged modules +if any , if a module was engaged globally then the handlers that belong to +that module will be executed irrespective of the service. The 'Globally +Engaged Modules' option lists the above list of modules.</p><br></br></div><div class="section"><a name="View_available_phases"></a><h2>View available phases</h2><p>In axis2 there are two levels of phases:</p><ul> + <li>system predefined phases(not allowed to be changed)</li> + <li>user defined phases</li> +</ul><p>The main difference between those two levels of phases is that, in the +case of system predefined phases, the phases will be invoked irrespective of +the irrespective of the services. When the dispatcher finds the operation +then user defined phase list will be invoked. It should be noted that the +module developers and service writers are really required to have a good +understanding of phases and phase ordering.</p><img src="images/viewphases.jpg" alt=""></img><br></br></div><div class="section"><a name="View_Global_chains"></a><h2>View Global chains</h2><p>The most interesting feature of axis2 web admin module is that it provide +a very basic way of viewing the global phase list and handlers inside the +phases depending on both phase and handler orders. This kind of information +is extremely useful in debugging the system, because there is no way to list +out the handlers in the global chains except this. And if you engage a new +module the new handlers will be added to the global chains and those will be +displayed in this page.</p><p align="left"><strong><img src="images/globalchain.jpg" alt=""></img></strong></p><br></br></div><div class="section"><a name="View_operation_specific_chains"></a><h2>View operation specific chains</h2><p>The 'Operation Specific Chains' can be used to view the handlers +corresponding to a given service in the same order as there in the real +execution chain.</p><p align="left"><strong><img src="images/serviceHandlers.jpg" alt=""></img></strong></p><br></br></div><div class="section"><a name="Engaging_modules"></a><h2>Engaging modules</h2><p>Modules can be engaged either globally, to a service or to an operation +depending on the module implementation. If the module was designed to engage +the handlers globally then handlers in the module can be included in any +phase in the system. It can be either system predefined or user defined +phase.</p><p>In there other hand if the module was implemented in such a way that is +going to be deployed to a service or to an operation then the module canNOT +be included in any of system predefined phases. So that it can only be +included in user defined phases.</p><p>Immediately after engaging the module you can see the status of the +engagement , indicating whether it is engaged properly or not.</p><p align="left"><strong><img src="images/moduleengage.jpg" alt=""></img></strong></p><p> </p><br></br></div><div class="section"><a name="Turn_off_a_service"></a><h2>Turn off a service</h2><p>This functionality provide a way to remove unnecessary services from the +running system, but the removal is transient meaning if you restart the +system the service will be available.</p><p align="left"><strong><img src="images/removeservice.jpg" alt=""></img></strong></p><br></br></div><div class="section"><a name="Edit_service_parameters"></a><h2>Edit service parameters</h2><p>This functionality provide a way to change parameters in a service or its +operations, and those changes will be transient too.</p><p align="left"><strong><img src="images/editserviecpara.jpg" alt=""></img></strong></p></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2005, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html> \ No newline at end of file
![http://www.apache.org/images/asf-logo.gif"](http://www.apache.org/images/asf-logo.gif"){kind=link}
![http://ws.apache.org/axis/images/axis.jpg"](http://ws.apache.org/axis/images/axis.jpg"){kind=link}
