docs.jsp

用java 写的论坛

  </tr>
  <tr bgcolor="White">
    <td colspan="2">
        IV.2
    </td>
    <td class="messageText" colspan="3">
        <a href="#IV2">Posting</a>
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="2">
        IV.3
    </td>
    <td class="messageText" colspan="3">
        <a href="#IV3">Groups</a>
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="2">
        IV.4
    </td>
    <td class="messageText" colspan="3">
        <a href="#IV4">Searching - to be supported at release xx</a>
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="2">
        IV.5
    </td>
    <td class="messageText" colspan="3">
        <a href="#IV5">Watching Topics - to be supported at release Release Candidate 1</a>
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="2">
        IV.6
    </td>
    <td class="messageText" colspan="3">
        <a href="#IV6">Moderating - to be supported at release xx</a>
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="5" height="16px">&nbsp;
    </td>
  </tr>
  <tr bgcolor="#666699" class="header">
    <td align="center" colspan="5">Online Documentation - Body</td>
  </tr>
  <tr bgcolor="White">
    <td class="messageText" colspan="5">
      If the documentation did not help, then you might try the frequently asked questions (FAQ) documents to see if someone before you has had a similar problem.  Most of the questions and responses came from <a href="http://www.mvnForum.com">mvnForum web site</a>.
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="I">I. Introduction
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="I1">I.1. What is a forum
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="I2">I.2. Features
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="5" height="16px">&nbsp;</td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II">II. Installation
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II1">II.1. System Requirements
    </td>
  </tr>
  <tr bgcolor="White">
    <td class="messageText" colspan="5">
      mvnForum has the following system requirements:
      <ul>
       <li>Any App Server supports Jsp 1.2 and Servlet 2.3
       <li>JDK 1.3 or later
       <li>A JDBC 2.0-compliant database (see <a href="#II3"> for list of supported databases</a><br>
          (this release includes 4 drivers: mm.mysql, Connector/J, postgreSQL and hsqldb)
      </ul>
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II2">II.2. Application Server Setup
    </td>
  </tr>
  <tr bgcolor="White">
    <td class="messageText" colspan="5">
      Follow these steps to setup the application server.
      <ul>
       <li>Create a home folder for mvnForum, which should not be accessible from the web.  This is where you will edit files and perform temporary actions while installing the forum software.</li>
       <li>Unzip the distributed zip file into this folder.</li>
       <li>Create a context in your app server.  See <a href="#II2a">below</a> for application server-specific configuration options.
       <li>In the extracted folder, find the dir <code>webapp\WEB-INF\classes</code>.
         There are 7 properties files here.  Open each file in a text editor and change
         the config parameters to appropriate values.  In each property file are the instructions for the parameters in the configurations.<br>
         NOTE: Set database parameters to the correct values.  Database server-specific information is presented <a href="#II3a">below</a> and also in the header of the sql script file.<br>
         NOTE: Currently you have to restart your App Server if you make changes
        in properties files (if not, your new config cannot take effect)
       <li>Copy the content of webapp dir in the extracted folder to the context dir that you have created above.</li>
      </ul>
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II2a">II.2.a. Apache Tomcat Application Server
    </td>
  </tr>
  <tr bgcolor="White">
    <td class="messageText" colspan="5">
      Following is tomcat-specific application server setup configuration information:
      <ul>
        <li>To create a context, create a folder beneath tomcat/webapps (for example : mvnforum). This dir (context) MUST be in lower case (such as mvnforum).</li>
      </ul>
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II2b">II.2.b. Caucho Resin Application Server
    </td>
  </tr>
  <tr bgcolor="White">
    <td class="messageText" colspan="5">
      Following is resin-specific application server setup configuration information:
     Following is a directory layout for a mvnForum installation in the ROOT context (where the &lt;resin-root&gt; is /var/www):
      <ul>
        <li>&lt;resin-root&gt;/mvnplugin</li>
        <li>&lt;resin-root&gt;/mvnplugin/mvnforum (contains all JSP files)</li>
        <li>&lt;resin-root&gt;/mvnplugin/WEB-INF (created by RESIN)</li>
        <li>&lt;resin-root&gt;/WEB-INF/</li>
        <li>&lt;resin-root&gt;/WEB-INF/web.xml (see below)</li>
        <li>&lt;resin-root&gt;/WEB-INF/lib/</li>
        <li>&lt;resin-root&gt;/WEB-INF/lib/commons-beanutils.jar, commons-logging.jar, mvnforum.jar, myvietnam.jar (activation.jar, jndi.jar, mail.jar, and servlet.jar are in /resin/lib because they are globally used)</li>
        <li>&lt;resin-root&gt;/WEB-INF/classes/</li>
        <li>&lt;resin-root&gt;/WEB-INF/classes/*.properties files (7 files)</li>
        <br><br>
      Snippet of web.xml:
      <pre>
      &lt;servlet-mapping&gt;
         &lt;servlet-name&gt;ForumUserServlet&lt;/servlet-name&gt;
         &lt;url-pattern&gt;/brds/*&lt;/url-pattern&gt;
      &lt;/servlet-mapping&gt;
      &lt;servlet-mapping&gt;
         &lt;servlet-name&gt;ForumAdminServlet&lt;/servlet-name&gt;
         &lt;url-pattern&gt;/mvnforumsadmin/*&lt;/url-pattern&gt;
      &lt;/servlet-mapping&gt;
      </pre>
      This results in an application that maps to:<br>
      &nbsp;&nbsp;&nbsp;http://&lt;host name&gt;/brds/index
      </ul>
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II2c">II.2.c. Other...
    </td>
  </tr>
  <tr bgcolor="White">
    <td class="messageText" colspan="5">
      Following is other-specific application server setup configuration information:
      <ul>
      </ul>
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II3">II.3. Database Server Setup
    </td>
  </tr>
  <tr bgcolor="White">
    <td class="messageText" colspan="5">
      Follow these steps to setup the mvnForum database schema and prepare the data tables with seed forum data.
      <ul>
      NOTE: If you are updating from either beta1 or beta2, then you must apply one patch to the existing database schema.  This patch adds the
      ability to have two forums with the same name under separate categories. To upgrade your database schema from
	  beta1/beta2 release to beta3 release, run the sql script <code>sql\upgrade\1_0_0_beta2_to_1_0_0_beta3\mvnForum_update_mysql.sql</code><br>
      The file: mvnForum_&lt;supported database server&gt;.sql can be use for beta1 and beta2, and beta3<br>
      NOTE: before running the script, we highly recommend that you back up all your data.<br>
       <li>In the extracted folder, find the file sql/mvnForum_&lt;supported database server&gt;.sql</li>
       <li>Create a database and confirm the correct database parameters have been set in the application server configuration step <a href="#II2">above</a></li>
       <li>Run the script. Please see the documentation for your database server for details on how to run sql scripts.  Details on the sql scripts are presented in the database server-specific sections below.</li>
       <li>Copy the jdbc driver for your database to the WEB-INF/lib folder of your context in step 3 above.  (Note that this release includes 4 drivers for MySql,
            postgreSQL and hsqldb)</li>
        NOTE: mvnForum includes an embedded database for hsqldb in folder sql/hsqldb, so you can
         copy this folder (hsqldb) to your mvnForumHome and set the proper config file
         mvncore_db_DBOptions.properties. This is the quickest way to get started with mvnForum.
      </ul>
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II3a">II.3.a. MySQL
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II3b">II.3.b. postgreSQL
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II3c">II.3.c. Microsoft SQL Server
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II3d">II.3.d. Oracle
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II3e">II.3.e. hsqldb
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II4">II.4. First-time setup
    </td>
  </tr>
  <tr bgcolor="White">
    <td class="messageText" colspan="5">
      With the database and application server setup, you should be able to navigate to your new forum.  The forum is setup with two separate zones, the administrator zone and the user zone.<br><br>
      With the default installation, the two zones are:<br>
      http://www.[yourserver].com/[yourcontext]/mvnforum/index : home for mvnForum<br>
      http://www.[yourserver].com/[yourcontext]/mvnforumadmin/index : Admin Zone
      <br>
      If you installed in the ROOT context, the URLS are:<br>
      http://www.[yourserver].com/mvnforum/index : home for mvnForum<br>
      http://www.[yourserver].com/mvnforumadmin/index : home for the Admin Zone<br>
      Follow these steps to login to the administrator zone and start configuring your forums:
      <ul>
       <li>Navigate to the Admin Zone and enter username = admin and password = admin</li>
       <li>If Login is successful, click a Test System Configuration to check that the mvnForum has been properly configured. </li>
       <li>The index page you see when you login lists server, MyVietnam Framework, application server version and database information.</li>
       <li>Change the password and edit your profile by clicking Forum Index, then click MyProfile.</li>
       <li>Click Forum Management to create forum for your community.</li>
       <li>You can create new users and set permissions for these new users.</li>
      </ul>
    </td>
  </tr>
  <tr bgcolor="White">
    <td colspan="3">
      <img src="<%=contextPath%>/mvnplugin/mvnforum/images/nav.gif">
    </td>
    <td class="messageText" colspan="2">
      <a name="II5">II.5. Versions
    </td>
  </tr>
  <tr bgcolor="White">
    <td class="messageText" colspan="5">
       Information about Versions - to maintain some history      
    </td>
  </tr>