[wsas-java-dev] svn commit r64 - wsas/java/trunk/xdocs/tools
svn at wso2.com
svn at wso2.com
Fri Dec 1 06:26:38 PST 2006
Author: chatra
Date: Fri Dec 1 06:26:33 2006
New Revision: 64
Modified:
wsas/java/trunk/xdocs/tools/change_passwd.html
Log:
finalized
Modified: wsas/java/trunk/xdocs/tools/change_passwd.html
==============================================================================
--- wsas/java/trunk/xdocs/tools/change_passwd.html (original)
+++ wsas/java/trunk/xdocs/tools/change_passwd.html Fri Dec 1 06:26:33 2006
@@ -5,22 +5,25 @@
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
<meta content="text/html; charset=iso-8859-1" />
- <title>WSO2 Web Services Application Server @wso2wswas_version@ - Change Password Tool</title>
+ <title>WSO2 Web Services Application Server @wso2wswas_version@ - Change
+ Password Tool</title>
</head>
<body>
-<h1>WSO2 Web Services Application Server(WSO2 WSAS) @wso2wswas_version@ - Change Password Tool</h1>
+<h1>WSO2 Web Services Application Server for Java, v at wso2wswas_version@ -
+Change Password Tool</h1>
<p>This document will instruct how an admin user can change his password.</p>
<h2>Introduction</h2>
<p>If an admin user forgets his password he cannot retrieve it using the
-Management Console due to security concerns. Furthermore, if you started WSO2 WSAS for the first time on
-one version of a JDK (1.4 say), and later decide to switch to another version of a JDK (1.5 say),
-it becomes impossible for WSO2 WSAS to decrypt the user passwords,
-since the security providers for different JDKs are different. <br/>
- In such scenarios, you would have to change the relevant password(s) by
+Management Console due to security concerns. Furthermore, if you started WSO2
+WSAS for Java for the first time on one version of a JDK (1.4 say), and later
+decide to switch to another version of a JDK (1.5 say), it becomes impossible
+for WSO2 WSAS to decrypt the user passwords, since the security providers for
+different JDKs are different. <br />
+In such scenarios, you would have to change the relevant password(s) by
running the chpasswd script on the machine which is hosting the WSO2 WSAS
server.</p>
@@ -35,14 +38,15 @@
information</p>
<ol>
<li>The WSO2 WSAS database URL
- <p>WSO2 WSAS by default ships with the Apache Derby database and hence the
- default URL would be jdbc:derby:/home/<strong>[user
+ <p>WSO2 WSAS by default ships with the Apache Derby database and hence
+ the default URL would be jdbc:derby:/home/<strong>[user
name]</strong>/.wso2wsas/database/WSO2WSAS_DB (For Windows
jdbc:derby:C:\Documents and Settings\<strong>[user
name]</strong>\.wso2wsas\database\WSO2WSAS_DB) . This may differ if a
- different database was specified during the installation process.Then the
- URL will be in the form of jdbc:derby:WSO2WSAS_HOME/database/WSO2WSAS_DB, where
- WSO2WSAS_HOME will be the custom location specified during the installation.</p>
+ different database was specified during the installation process.Then the
+ URL will be in the form of jdbc:derby:WSO2WSAS_HOME/database/WSO2WSAS_DB,
+ where WSO2WSAS_HOME will be the custom location specified during the
+ installation.</p>
</li>
<li>The Database driver class
<p>For the default Apache Derby database, the driver will be
@@ -54,19 +58,21 @@
password will be used by the system. However, if a different
username/password is used they are needed to reset the admin password.</p>
</li>
- <li>The username and new password of the user whose password is to be changed
- <p>If you do not provide these as command line arguments, you will be prompted for
- it during the execution of this tool.</p>
+ <li>The username and new password of the user whose password is to be
+ changed
+ <p>If you do not provide these as command line arguments, you will be
+ prompted for it during the execution of this tool.</p>
</li>
</ol>
<h2>Resetting the Password</h2>
-<p>This script is located in WSO2WSAS_HOME/bin. Usually this is the directory to which
-you have installed WSO2 WSAS in the case of the Standalone Edition, or the
- WSO2WSAS_HOME directory you specified during the installation of the Servlet Edition.</p>
+<p>This script is located in WSO2WSAS_HOME/bin. Usually this is the directory
+to which you have installed WSO2 WSAS in the case of the Standalone Edition,
+or the WSO2WSAS_HOME directory you specified during the installation of the
+Servlet Edition.</p>
-<p>The command line options available for chpasswd is as follows: </p>
+<p>The command line options available for chpasswd is as follows:</p>
<table border="1">
<caption></caption>
@@ -98,20 +104,20 @@
</tr>
<tr>
<td>--username</td>
- <td>The username of the user whose password is to be changed.<br/>
- If this is not given, you will be prompted for this field later.</td>
+ <td>The username of the user whose password is to be changed.<br />
+ If this is not given, you will be prompted for this field later.</td>
<td>No</td>
</tr>
<tr>
<td>--new-password</td>
- <td>The new password of the user whose password is to be changed.<br/>
- If this is not given, you will be prompted for this field later.</td>
+ <td>The new password of the user whose password is to be changed.<br />
+ If this is not given, you will be prompted for this field later.</td>
<td>No</td>
</tr>
</tbody>
</table>
-<p><b>Example </b></p>
+<p><b>Example</b></p>
<pre>chpasswd --db-url "jdbc:derby:WSO2WSAS_HOME/database/WSO2WSAS_DB"</pre>
<p><b>Example (on Windows)</b></p>
@@ -120,16 +126,17 @@
<p><b>Example (on *nix)</b></p>
<pre>chpasswd --db-url jdbc:derby:home/user/.wso2wsas/database/WSO2WSAS_DB</pre>
-<p>If you have not provided the --username or --new-password input parameters, the system will prompt you
- for it. If the password was updated successfully, you should see the following message: <br/><br/>
-
- <pre>Password of user [username] updated successfully</pre>
+<p>If you have not provided the --username or --new-password input
+parameters, the system will prompt you for it. If the password was updated
+successfully, you should see the following message: <br />
+<br />
+<pre>Password of user [username] updated successfully</pre>
</p>
<h2>Important Note</h2>
<ul>
- <li>If the database path includes directory names with spaces,
- the whole URL needs to be included inside a pair of quotations.
+ <li>If the database path includes directory names with spaces, the whole
+ URL needs to be included inside a pair of quotations.
<p></p>
</li>
</ul>
More information about the Wsas-java-dev
mailing list