<!--
  ~ Copyright 2005-2007 WSO2, Inc. (http://wso2.com)
  ~
  ~ Licensed under the Apache License, Version 2.0 (the "License");
  ~ you may not use this file except in compliance with the License.
  ~ You may obtain a copy of the License at
  ~
  ~ http://www.apache.org/licenses/LICENSE-2.0
  ~
  ~ Unless required by applicable law or agreed to in writing, software
  ~ distributed under the License is distributed on an "AS IS" BASIS,
  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  ~ See the License for the specific language governing permissions and
  ~ limitations under the License.
  -->

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
        "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html>
<body>
<p>[<a
        href="http://dist.wso2.org/products/wsas/java/@wso2wsas_version@">Download</a>]
    | [<a href="index_docs.html">Documentation Home</a>] | [<a
        href="release_notes.html">Release Note</a>]</p>

<h1>Frequently Asked Questions(FAQs)</h1>

<ol>
    <li><a href="#q1">Some views of the Management Console are garbled for me. Why and how do I avoid this?</a></li>
    <li><a href="#q2">Management console sometimes gives me an alert saying "Access Denied. Please Loging First". Why?</a></li>
    <li><a href="#q3"> Why do I see two endpoints listed for my service in the Service Information Page?</a></li>
    <li><a href="#q4">When a module is uploaded @server_short_name@ asks me to restart the server. Why is this necessary ?</a></li>
    <li><a href="#q5">I cannot monitor the messages using the tracer! What's wrong?</a></li>
    <li><a href="#q6">How can I configure @server_short_name@ to use persistentRM?</a></li>
    <li><a href="#q7">How can I change @server_short_name@ SSL certificate?</a></li>
    <li><a href="#q8">How do I run @server_short_name@ as a Unix daemon?</a></li>
    <li><a href="#q9">On Sun Solaris, when I start @server_short_name@, I get a security exception. How do I rectify this?</a></li>
    <li><a href="#q10">When I start @server_short_name@, I get a security exception. How do I rectify this?</a></li>
    <li><a href="#q11">How do I run @server_short_name@ behind an Apache HTTPD proxy server?</a></li>
    <li><a href="#q12">How to Set up the JAVA_HOME Environment Variable on Windows?</a></li>
    <li><a href="#q13">How do I disable the WSAS console when I deploy it on my production server?</a></li>
</ol>
<hr/>

<a name="q1"/>    
<p><strong>Q1: Some views of the Management Console are garbled for me. Why
and how do I avoid this?</strong><br />
A1: @server_short_name@ Management Console only supports IE 6.0 and upwards,
Firefox 1.0 and upwards. Since the console is dependent on browser based XSLT
processing it may not appear correctly on other browsers. Switching to a
@server_short_name@ supported browser would solve your problem.</p>
<hr />

<a name="q2"/>
<p><strong>Q2: Management console sometimes gives me an alert saying "Access Denied. Please Loging First". Why?</strong><br />
A2: The admin console HTTP session has been set to time out in 30 minutes for security
reasons.</p>
<hr />

<a name="q3"/>
<p><strong>Q3: Why do I see two endpoints listed for my service in the
Service Information Page?</strong><br />
A3: Default behaviour of @server_short_name@ is to expose a deployed service
in all available transports. This behaviour can be controlled by putting
transport entry in the service.xml.</p>
<hr />

<a name="q4"/>
<p><strong>Q4: When a module is uploaded @server_short_name@ asks me to
restart the server. Why is this necessary ?</strong><br />
A4: Modules represent significant functionality changes to the system and
hence the @server_short_name@ server does not allow the modules to be hot
deployed. The server must be restarted to make the modules active.</p>
<hr />
    
<a name="q5"/>
<p><strong>Q5: I cannot monitor the messages using the tracer! What's
wrong?</strong><br />
A5: Tracer is a separate service and needs to be activated before any message
can be traced. This can be done through the configuration link in the
Management Console.</p>
<hr />

<a name="q6"/>
<p><strong>Q6: How can I configure @server_short_name@ to use persistent
RM?</strong><br />
A6: Change the value of the property in the axis2.xml named
"Sandesha2StorageManager" to 'persistent'.</p>
<hr />

<a name="q7"/>
<p><strong>Q7: How can I change @server_short_name@ SSL
certificate?</strong><br />
A7: Please refer to <a href="keys.html">How To Change
@server_short_name@ Crypto Keys</a></p>
<hr />

<a name="q8"/>
<p><strong>Q8: How do I run @server_short_name@ as a Unix daemon?</strong><br />
A8: $WSO2WSAS_HOME/bin/daemon.sh start - Start the daemon <br/>
    $WSO2WSAS_HOME/bin/daemon.sh stop  - Stop the daemon <br/>
    $WSO2WSAS_HOME/bin/daemon.sh restart - Restart the daemon <br/><br/>

    In addition, you could do; <br/>
    cd /etc/init.d  <br/>
    ln -s $WSO2WSAS_HOME/bin/daemon.sh wso2wsas <br/><br/>

    Now, you could do /etc/init.d wso2wsas [start | stop | restart] <br/>
</p>
<hr />

<a name="q9"/>
<p><strong>Q9. On Sun Solaris, when I start @server_short_name@, I get a security exception.
    How do I rectify this?</strong><br/>
A9. Locate the $JAVA_HOME/jre/lib/security/java.security file, and go to the section titled
    "List of providers and their preference orders" in this file. Add a new provider as follows: <br/>

    security.provider.&lt;n&gt;=org.bouncycastle.jce.provider.BouncyCastleProvider <br/>
    where n = the location of the provider you just added. e.g. security.provider.8=org.bouncycastle.jce.provider.BouncyCastleProvider<br/>
</p>
<hr />

<a name="q10"/>
<p><strong>Q10. When I start @server_short_name@, I get a security exception.
    How do I rectify this?</strong><br/>
A10. Here is one possible fix. Locate the $JAVA_HOME/jre/lib/security/java.security file, and go to the section titled
    "List of providers and their preference orders" in this file. Add a new provider as follows: <br/>

    security.provider.&lt;n&gt;=org.bouncycastle.jce.provider.BouncyCastleProvider <br/>
    where n = the location of the provider you just added. e.g. security.provider.8=org.bouncycastle.jce.provider.BouncyCastleProvider<br/>
</p>
<hr />

<a name="q11"/>
<p><strong>Q11: How do I run @server_short_name@ behind an Apache HTTPD proxy server?</strong><br />
A11: Please see <a href="proxy_guide.html">Running Behind a Proxy Server</a></p>
<hr />

<a name="q12"/>
<p><strong>Q12. How to Set up the JAVA_HOME Environment Variable on Windows</strong>

    A12. Please follow the instructions to set up the JAVA_HOME environment
    variable in your computer. First locate the installation folder of the Java
    development kit (JDK) in your machine. Let us assume it is installed in the
    folder "C:/j2sdk1.4.2"</p>
<ol>
    <li>Right-click on the My Computer icon on your desktop and then click
        Properties.
    </li>
    <li>Click the Advanced tab.</li>
    <li>Click Environment Variables.</li>
    <li>Under System Variables, click New.</li>
    <li>In the Variable name field, enter JAVA_HOME.</li>
    <li>In the Variable value field, enter the installation path of the Java
        Development Kit.
    </li>
    <li>Click OK.</li>
    <li>Click Apply Changes.</li>
</ol>
<img src="images/set-java-home.jpg" width="802" height="590" alt=""></img>

<br/>
<hr />

<a name="q13"/>
<p><strong>Q13. How do I disable the WSAS console when I deploy it on my production server?</strong></p>
<p>A13. Follow these steps to disable the Management Console</p>
<ol>
    <li>Locate WSO2WSAS_HOME/conf/server.xml</li>
    <li>Locate the following section in the above file <br/>
        <code>
           &lt;!--<br/>
               Functions related to the Management Console<br/>
            --&gt;<br/>
            &lt;Management&gt;<br/>
                <br/>
                &lt;!--<br/>
                   Enable the Management Console, true/false<br/>
                --&gt;<br/>
                &lt;EnableConsole&gt;true&lt;/EnableConsole&gt;<br/>
            &lt;/Management&gt;<br/>
            </code>
        </li>
        <li>Change the  "EnableConsole" entry to "false"</li>
        <li>Restart WSO2 WSAS</li>
        <li>Try to access the management console just to verify that it has been disabled. You should see the following message on your browser:<br/>
            <code>
            Management Console has been disabled. Enable it in the server.xml and try again.
            </code>
        </li>
</ol>
<br/>
<hr />

</body>
</html>
