[wsas-java-dev] svn commit r475 - wsas/java/trunk/xdocs
svn at wso2.com
svn at wso2.com
Wed Jan 17 21:58:12 PST 2007
Author: marietta
Date: Wed Jan 17 21:58:06 2007
New Revision: 475
Modified:
wsas/java/trunk/xdocs/installation_standalone.html
Log:
Reviewed.
Modified: wsas/java/trunk/xdocs/installation_standalone.html
==============================================================================
--- wsas/java/trunk/xdocs/installation_standalone.html (original)
+++ wsas/java/trunk/xdocs/installation_standalone.html Wed Jan 17 21:58:06 2007
@@ -6,29 +6,28 @@
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
<title>WSO2 Web Services Application Server Standalone Edition for Java
@wso2wsas_version@ - Installation Guide</title>
- <meta name="generator" content="Bluefish 1.0.4"/>
- <link href="tools/cmd/css/wsas-dist-doc.css" rel="stylesheet" type="text/css"
- media="all" />
+ <link href="tools/cmd/css/wsas-dist-doc.css" rel="stylesheet"
+ type="text/css" media="all" />
</head>
<body xml:lang="en">
<h1>WSO2 Web Services Application Server Standalone Edition for Java,
v at wso2wsas_version@ - Installation Guide</h1>
-<p>This guide provides the installation procedure for WSO2
-WSAS Standalone Edition for Java. Pre-requisites of WSO2 WSAS and installation
-instructions including how to start WSO2 WSAS & access its Management
-Console are laid down here.</p>
+<p>This guide provides instructions on how to install the WSO2 WSAS
+Standalone Edition for Java. Pre-requisites for WSO2 WSAS and installation
+instructions including how to start WSO2 WSAS and access its Management
+Console are included.</p>
-<p>Your feedback on WSO2 WSAS for Java is most appreciated. Please send them to our <a
-href="index.html#mail">mailing lists.</a></p>
+<p>Your feedback on WSO2 WSAS for Java is most appreciated. Please send them
+to our <a href="index.html#mail">mailing lists.</a></p>
<h2>Content</h2>
<ul>
<li><a href="#req">System Requirements</a></li>
<li><a href="#win">Installing on Microsoft Windows</a>
<ul>
- <li><a href="#wizard">Running Installation Wizard</a></li>
+ <li><a href="#wizard">Running the Installation Wizard</a></li>
<li><a href="#win_binary">Installing using Binary Distribution</a></li>
</ul>
</li>
@@ -42,7 +41,8 @@
</ul>
</li>
<li><a href="#uninstall">Modify/ Repair/ Remove Installation</a></li>
- <li><a href="#mgtconsole">Accessing WSO2 WSAS for Java Management Console</a></li>
+ <li><a href="#mgtconsole">Accessing WSO2 WSAS for Java Management
+ Console</a></li>
</ul>
<a id="req"></a>
@@ -80,24 +80,26 @@
<h2>Installing on Microsoft Windows</h2>
-<p><strong>Note</strong>: WSO2 WSAS for Java, v at wso2wsas_version@ release successfully tested only on
-Windows XP</p>
+<p><strong>Note</strong>: The WSO2 WSAS for Java, v at wso2wsas_version@ release
+has been successfully tested only on Windows XP.</p>
-<p>There are two methods of installation on MS Windows Operating System.</p>
+<p>There are two methods of installation on the MS Windows operating
+system.</p>
<ol>
- <li><a href="#wizard">Using the Installation Wizard</a> (WSO2 WSAS for Java, v at wso2wsas_version@
- Setup wizard)</li>
+ <li><a href="#wizard">Using the Installation Wizard</a> (WSO2 WSAS for
+ Java, v at wso2wsas_version@ Setup wizard)</li>
<li><a href="#win_binary">Using the Binary Distribution</a></li>
</ol>
<a id="wizard"></a>
-<h3>Running Installation Wizard</h3>
+<h3>Running the Installation Wizard</h3>
-<p><a href="http://dist.wso2.org/products/wsas/java/@wso2wsas_version@">Download</a> the
-wso2wsas-standalone-edition-java- at wso2wsas_version@.msi</p>
+<p><a
+href="http://dist.wso2.org/products/wsas/java/@wso2wsas_version@">Download</a>
+the wso2wsas-standalone-edition-java- at wso2wsas_version@.msi</p>
-<p>Execute the msi and follow the instructions on the WSO2 WSAS for Java, v at wso2wsas_version@ Setup
-wizard</p>
+<p>Execute the .msi and follow the instructions on the WSO2 WSAS for Java,
+v at wso2wsas_version@ Setup wizard</p>
<p>The first page of the installation wizard is as follows</p>
@@ -105,55 +107,53 @@
/><br />
</p>
-<p>Clicking on Next will lead you to End-User License Agreement.</p>
+<p>Click Next. It will lead you to the End-User License Agreement.</p>
<p><img alt="Figure2:Installation Wizard Page2-EULA"
src="images/installer2.jpg" /><br />
</p>
-<p>Select check box to accept the terms in the license agreement which will
-enable the Next button. Clicking on Next button will lead you to the Custom
-Setup page shown below. Custom Setup page will allow you to select the
-features you want to be installed.</p>
-<a id="customsetup"></a>
+<p>Select the check box to accept the terms in the license agreement; this
+will enable the Next button. Click Next to move to the Custom Setup page
+shown below. Custom Setup will allow you to select the features you want to
+install.</p>
-<p><img alt="Figure3:Installation Wizard Page3-Custom Setup"
-src="images/installer3.jpg" /><br />
+<p><br />
</p>
-<p>Browse button will take you to the page below where you can select the installation folder of WSO2 WSAS for Java.</p>
+<p>Click Browse to select the installation folder of WSO2 WSAS for Java, as
+shown below.</p>
<p><img alt="Figure4:Installation Wizard Page3-Browse for Location"
src="images/destination_folder.jpg" /><br />
</p>
-Clicking Disk Usage button on <a href="#customsetup">Custom Setup page</a>
-will take you to the page below. This will give you information on the disk
-sizes of the volumes on your computer, free disk space, and amount required
-for the selected WSO2 WSAS for Java features.
+Click Disk Usage on the <a href="#customsetup">Custom Setup page</a> to move
+to the page displayed below. This will give you information on the disk sizes
+of the volumes on your computer, free disk space, and the amount required for
+the selected WSO2 WSAS for Java features.
<p><img alt="Figure5:Installation Wizard Page4-Disk Space Requirements"
src="images/installer4.jpg" /><br />
</p>
-<p>By clicking on <a href="#customsetup">Custom Setup Page's</a> Next button
-you go to the Ready to Install page below. By clicking on Install button WSO2
-WSAS for Java, v at wso2wsas_version@ will be installed in your computer.</p>
+<p>Click Next on the <a href="#customsetup">Custom Setup Page</a> to move to
+the Ready to Install page displayed below. Click Install. WSO2 WSAS for Java,
+v at wso2wsas_version@ will be installed in your computer.</p>
<p><img alt="Figure6:Installation Wizard Page5-Ready to install"
src="images/installer5.jpg" /><br />
</p>
-<p>Once installation is complete and set up exits, by clicking on the
-Finish button on the WiX setup wizard, you'll be able to view WSO2 WSAS on
-the programs list of the start menu of Windows. Shortcut to WSO2 WSAS for Java,
+<p>Once the installation is complete and the setup exits, click Finish on the
+WiX setup wizard. You willl be able to view WSO2 WSAS on the programs list of
+the Start menu of Windows. A shortcut to WSO2 WSAS for Java,
v at wso2wsas_version@ will also appear on the Desktop.</p>
-<p>On the programs list of the start menu, WSO2 WSAS for Java will have following options :
-
-<ul>
- <li>start the server</li>
- <li>add server as a Network (NT) Service to Windows Services</li>
- <li>remove WSO2 WSAS service from Windows Services</li>
+<p>On the programs list of the Start menu, WSO2 WSAS for Java will have the
+following options : <ul>
+ <li>Start the server</li>
+ <li>Add server as a Network (NT) Service to Windows Services</li>
+ <li>Remove WSO2 WSAS service from Windows Services</li>
</ul>
</p>
@@ -161,8 +161,9 @@
/>
</p>
-<p>Once you add WSO2 WSAS for Java as an NT service to Windows services, you can start
-this service from Services in Administrative tools of the Control Panel.</p>
+<p>Once you add WSO2 WSAS for Java as an NT service to Windows services, you
+can start this service from Services in Administrative tools of the Control
+Panel.</p>
<p><img alt="Figure8:Network service" src="images/service.jpg" /><br />
</p>
@@ -170,22 +171,24 @@
<h3>Installing using Binary Distribution</h3>
-<p>The following steps will take you through the installation for MS Windows
-Operating System</p>
+<p>The following steps will take you through the installation for the MS
+Windows operating system</p>
<ol>
- <li><a href="http://dist.wso2.org/products/wsas/java/@wso2wsas_version@">Download</a> the WSO2
- WSAS binary distribution.</li>
+ <li><a
+ href="http://dist.wso2.org/products/wsas/java/@wso2wsas_version@">Download</a>
+ the WSO2 WSAS binary distribution.</li>
<li>Extract the zip archive.</li>
- <li>Set <a href="setting-java-home.html">JAVA_HOME</a> environment variable to your Java installation.</li>
- <li>Execute the WSO2 WSAS starting script. eg:
+ <li>Set the <a href="setting-java-home.html">JAVA_HOME</a> environment
+ variable to your Java installation.</li>
+ <li>Execute the WSO2 WSAS starting script. e.g.,
C:\wso2wsas-standalone-edition-java- at wso2wsas_version@\bin\wso2wsas.bat</li>
- <li>Check your WSO2 WSAS instance using this URL https://localhost:9443</li>
+ <li>Check your WSO2 WSAS instance using the URL https://localhost:9443</li>
</ol>
<a id="linux"></a>
<h2>Installing on Linux</h2>
-<p>Again, there are two methods of installation on Linux:</p>
+<p>Again, there are two methods of installing on Linux:</p>
<ol>
<li><a href="#linux_binary">Using Binary Distribution</a></li>
<li><a href="#linux_binary_installers">Using Binary Installers
@@ -195,15 +198,18 @@
<h3>Installing using Binary Distribution</h3>
<ol>
- <li><a href="http://dist.wso2.org/products/wsas/java/@wso2wsas_version@">Download</a> the WSO2
- WSAS binary distribution.</li>
- <li>Extract the zip archive . eg: unzip wso2wsas-standalone-edition-java- at wso2wsas_version@.zip -d /opt</li>
- <li>Set JAVA_HOME environment variable to your Java installation using
- export command or by editing /etc/profile. eg : export
+ <li><a
+ href="http://dist.wso2.org/products/wsas/java/@wso2wsas_version@">Download</a>
+ the WSO2 WSAS binary distribution.</li>
+ <li>Extract the zip archive. e.g., unzip
+ wso2wsas-standalone-edition-java- at wso2wsas_version@.zip -d /opt</li>
+ <li>Set the JAVA_HOME environment variable to your Java installation using
+ the export command or by editing /etc/profile. e.g., export
JAVA_HOME="/opt/j2sdk"</li>
- <li>Execute the WSO2 WSAS starting script. eg: cd
- /opt/wso2wsas-standalone-edition-java- at wso2wsas_version/bin; sh wso2wsas.sh</li>
- <li>Check your WSO2 WSAS instance using this URL https://localhost:9443</li>
+ <li>Execute the WSO2 WSAS starting script. e.g., cd
+ /opt/wso2wsas-standalone-edition-java- at wso2wsas_version/bin; sh
+ wso2wsas.sh</li>
+ <li>Check your WSO2 WSAS instance using the URL https://localhost:9443</li>
</ol>
<!--<h3>Troubleshooting Installation</h3>-->
<a id="linux_binary_installers"></a>
@@ -214,63 +220,71 @@
installation.</p>
<ol>
<li>Download WSO2 WSAS <a
- href="http://dist.wso2.org/products/wsas/@wso2wsas_version@">deb</a> or <a
- href="http://dist.wso2.org/products/wsas/@wso2wsas_version@">RPM</a> binary</li>
- <li>Install Debian binary ( deb ) eg: dpkg -i wso2wsas-java- at wso2wsas_version@.deb (To
- install deb, log in to the system as root user.)</li>
- <li>Install RPM binary ( rpm ) eg: rpm -Uvh wso2wsas-java- at wso2wsas_version@.i386.rpm (To
- install rpm, log in to the system as root user.)</li>
- <li>Execute/start the WSO2 WSAS server from shell. eg: /etc/init.d/wso2wsas start</li>
- <p>(You can also stop the server from shell. eg: /etc/init.d/wso2wsas stop)</p>
+ href="http://dist.wso2.org/products/wsas/@wso2wsas_version@">deb</a> or
+ <a href="http://dist.wso2.org/products/wsas/@wso2wsas_version@">RPM</a>
+ binary</li>
+ <li>Install Debian binary ( deb ) e.g., dpkg -i
+ wso2wsas-java- at wso2wsas_version@.deb (To install deb, log on to the
+ system as root user.)</li>
+ <li>Install RPM binary ( rpm ) e.g., rpm -Uvh
+ wso2wsas-java- at wso2wsas_version@.i386.rpm (To install rpm, log on to the
+ system as root user.)</li>
+ <li>Execute/start the WSO2 WSAS from the shell. e.g., /etc/init.d/wso2wsas
+ start</li>
+
+ <p>(You can also stop the server from the shell. e.g., /etc/init.d/wso2wsas
+ stop)</p>
</ol>
<a id="linux_trouble"></a>
<h3>Troubleshooting Installation</h3>
-<p>When trying to execute the WSO2 WSAS binary from a shell. eg:
-/usr/bin/wso2wsas (after WSO2 WSAS for Java, v at wso2wsas_version@ has been installed), if
-an error message saying 'Permission denied' pops up, then check the file
-permission of the run.sh script and set execution permission.</p>
+<p>When trying to execute the WSO2 WSAS binary from a shell. e.g.,
+/usr/bin/wso2wsas (after WSO2 WSAS for Java, v at wso2wsas_version@ has been
+installed), if the error message 'Permission denied' pops up, then check the
+file permission of the run.sh script and set the execution permission.</p>
<a id="uninstall"></a>
<h2>Modify/ Repair/ Remove Installation</h2>
-<p>On <strong>MS Windows</strong> systems use</p>
-<ol>
- <li>"Add or Remove programs" utility on Control Panel to change or remove
- WSO2 WSAS installation</li>
- <li>or return to wso2wsas-standalone-edition-java- at wso2wsas_version@.msi, execute & follow the
- instructions as seen below.</li>
-</ol>
+<p>On <strong>MS Windows</strong> systems,</p>
+<ul>
+ <li>Use the "Add or Remove programs" utility on the Control Panel to change
+ or remove the WSO2 WSAS installation
+ <p>or</p>
+ </li>
+ <li>Return to wso2wsas-standalone-edition-java- at wso2wsas_version@.msi,
+ execute, and follow the instructions given below.</li>
+</ul>
<p><img alt="Figure9:modify_repair_remove" src="images/uninstall.jpg" /><br />
</p>
-<p>In <strong>Debian Linux</strong> system use dpkg utility to remove the
-WSO2 WSAS installation. eg : dpkg -r wso2wsas-java- at wso2wsas_version@</p>
+<p>In <strong>Debian Linux</strong> systems, use the dpkg utility to remove
+the WSO2 WSAS installation. e.g., dpkg -r wso2wsas-java- at wso2wsas_version@</p>
-<p>In <strong>Redhat Linux</strong> systems use rpm utility to remove the
-WSO2 WSAS installation. e: rpm -e wso2wsas-java- at wso2wsas_version@</p>
+<p>In <strong>Redhat Linux</strong> systems, use the rpm utility to remove
+the WSO2 WSAS installation. e.g.,: rpm -e wso2wsas-java- at wso2wsas_version@</p>
<a id="mgtconsole"></a>
<h2>Accessing the Management Console</h2>
-<p>Once WSO2 WSAS for Java, v at wso2wsas_version@ is successfully installed, in order to
-access the Management Console, first start the server, then launch a web
-browser instance and point it to the URL <a
+<p>Once WSO2 WSAS for Java, v at wso2wsas_version@ has been successfully
+installed, in order to access the Management Console, first start the server,
+launch a web browser instance, and then point it to the URL <a
href="https://localhost:9443/">https://localhost:9443/</a> (if you are using
the default settings). This will take you to the "Sign In" page of the
-Management Console as seen as below</p>
+Management Console as displayed below.</p>
-<p><strong>Note:</strong> WSO2 WSAS by default has two listeners, HTTP and
+<p><strong>Note:</strong> By default, WSO2 WSAS has two listeners, HTTP and
HTTPS. The HTTP listener opens on port 9762, while the HTTPS listener opens
-on port 9443. The admin is exposed only via the HTTPS port.</p>
+on port 9443. The administrator functions are exposed only via the HTTPS
+port.</p>
<p><img alt="Figure10:mgtconsole" src="images/sign_in.jpg" /><br />
</p>
-<p>For details on WSO2 WSAS for Java Management Console see <a
+<p>For details on WSO2 WSAS for Java Management Console see the <a
href="administratorguide.html">Administrator's Guide</a></p>
-
</body>
</html>
More information about the Wsas-java-dev
mailing list