[opencms-dev] setting up mvnforum in the same context of opencms 6 alpha 2

Sun Oct 31 00:40:51 CEST 2004

#### A short introduction to setting up mvnforum ####
#### in the same context of opencms 6 alpha 2  ####

I assume you have opencms 6 alpha or other future releases in place and
have

 <http://localhost:8080/opencms/opencms>
http://localhost:8080/opencms/opencms as your standard installation URI
and 

would like to run mvnforum inside opencms, for instance from:

 <http://localhost:8080/opencms/forum>
http://localhost:8080/opencms/forum

Furthermore you would like to use the same Database "opencms" and
install the mvnforum

db-tables into it, so that they could be linked together for e.g. using
the same user 

management or integrate some parts of the mvnforum application into your
opencms templates.

#### Bevor doing anything please backup your current OpenCMS
installation ####

The following Installation has been tested on windows and SuSE Linux
Enterprise Server 9 (sles9) with following apps:

JDK version:    1.4.2_06    
Servlet engine:  Apache Tomcat\5.0.19   
XML Parser:   Xerces-J 2.6.1
OpenCMS :  Alpha 2
Database:   MySQL 4.x

O.K. lets go:

1. after downloading the source of mvnForum 1.0.0 RC3_01(Update 1)from:

 <http://www.mvnforum.com/mvnforumweb/index.jsp>
http://www.mvnforum.com/mvnforumweb/index.jsp

extract the source to e.g: c:\mvnforum-1.0.0-rc3-src  

2. Database Installation:

create the mvnforum db-tables in your opencms database. For doing that,
run mvnForum_mysql.sql script over opencms database as root or
opencmsuser

/$> mysql -uroot -Dopencms <
C:\mvnforum-1.0.0-rc3-src\mvnforum\sql\mvnForum_mysql.sql -p

you will be asked for root user password, possibly you can install the
db with opencmsuser
account (use -uopencmsuser instead -uroot)

3. change the property settings of
C:\mvnforum-1.0.0-rc3-src\mvnforum\build.properties
as follow:

changes:

deploy.localhost=c:/tomcat5/webapps ### set your own tomcat path with /
"be aware "\" doesn't work on windows !!!"

app.name=opencms

sqldriver.jar=mysql-connector-java-3.0.14-production-bin.jar  ### or
future releases

4. change property settings for:

C:\mvnforum-1.0.0-rc3-src\mvnforum\properties\mvnforum.xml

change url_patterns:

    <url_pattern>/forumadmin</url_pattern>
    </adminmoduleconfig>
    <usermoduleconfig>
        <url_pattern>/forum</url_pattern>
    </usermoduleconfig>
    <mvnforumconfig>

change mvnforumhome to:

c:\tomcat5\webapps\opencms\WEB-INF\mvnForumHome

3. change property settings for:

C:\mvnforum-1.0.0-rc3-src\myvietnam\properties\mvncore.xml

        <driver_class_name>com.mysql.jdbc.Driver</driver_class_name>

<database_url>jdbc:mysql://<ServerName>/opencms?useUnicode=true&char
acterEncoding=utf-8</database_url>
        <database_user>opencmsuser</database_user>
        <database_password>secret</database_password>   ### be aware of
<database_password/> !!! ####
        <max_connection>500</max_connection>
        <max_time_to_wait>2000</max_time_to_wait>
        <minutes_between_refresh>30</minutes_between_refresh>

        ### change according to your needs

 <mailoptions>
        <mail_server>localhost</mail_server>
        <default_mail_from>webmaster at localhost</default_mail_from>
        <username/>
        <password/>
        <port>25</port>
     </mailoptions>

     <paramoptions>
        <context_path>/opencms</context_path>
        <server_path>http://<ServerName>:8080</server_path>
     </paramoptions>

 4. change C:\mvnforum-1.0.0-rc3-src/mvnforum/srcweb/WEB-INF/web.xml
like this:

<servlet-mapping>
    <servlet-name>ForumAdminServlet</servlet-name>
    <url-pattern>/forumadmin/*</url-pattern>
  </servlet-mapping>

  <servlet-mapping>
    <servlet-name>ForumUserServlet</servlet-name>
    <url-pattern>/forum/*</url-pattern>
  </servlet-mapping>

  4. backup / rename your opencms web.xml to web.opencms.xml

  5. run ant to deploy mvnforum in to opencms 

  C:\mvnforum-1.0.0-rc3-src\mvnforum> ant deploy-localhost

  6. register mvnforum servlet into opencms web.xml as follow

  rename web.xml (thats now mvnforum web.xml) to web.mvnforum.xml

  rename web.opencms.xml back to web.xml and copy the following section
to web.xml below opencms </taglib>

   ---- copy this section to opencms web.xml between </taglib> and
</web-app>  ----

   ----  mvnforum web.xml section -----

  <filter>
    <filter-name>CompressionFilter</filter-name>

<filter-class>net.myvietnam.mvncore.servlet.filter.CompressionFilter</fi
lter-class>
    <init-param>
      <param-name>compressionThreshold</param-name>
      <param-value>128</param-value>
    </init-param>
  </filter>

  <filter-mapping>
    <filter-name>CompressionFilter</filter-name>
    <url-pattern>/mvnforum___/*</url-pattern>
  </filter-mapping>
  <filter-mapping>
    <filter-name>CompressionFilter</filter-name>
    <url-pattern>/mvnforumadmin___/*</url-pattern>
  </filter-mapping>

  <listener>

<listener-class>com.mvnforum.MVNForumContextListener</listener-class>
  </listener>

  <servlet>
    <servlet-name>ForumAdminServlet</servlet-name>
    <servlet-class>com.mvnforum.admin.ForumAdminServlet</servlet-class>
  </servlet>
  <servlet>
    <servlet-name>ForumUserServlet</servlet-name>
    <servlet-class>com.mvnforum.user.ForumUserServlet</servlet-class>
  </servlet>

  <!-- Action Servlet Configuration -->
  <!-- comment out for the next RC3_dev release
  <servlet>
    <servlet-name>action</servlet-name>

<servlet-class>org.apache.struts.action.ActionServlet</servlet-class>
    <init-param>
      <param-name>config</param-name>
      <param-value>/WEB-INF/struts-config.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  -->

  <!-- Action Servlet Mapping -->
  <servlet-mapping>
    <servlet-name>ForumAdminServlet</servlet-name>
    <url-pattern>/forumadmin/*</url-pattern>
  </servlet-mapping>

  <!-- comment out for the next RC3_dev release
  <servlet-mapping>
    <servlet-name>action</servlet-name>
    <url-pattern>/mvnforum/index*</url-pattern>
  </servlet-mapping>
  -->

  <servlet-mapping>
    <servlet-name>ForumUserServlet</servlet-name>
    <url-pattern>/forum/*</url-pattern>
  </servlet-mapping>

  <taglib>
    <taglib-uri>http://jsptags.com/tags/navigation/pager</taglib-uri>
    <taglib-location>/WEB-INF/pager-taglib.tld</taglib-location>
  </taglib>

  ----  End of mvnforum web.xml section -----
 .......

 </web-app>

 7. restart tomcat

 8. Test the installation:

  <http://localhost:8080/opencms/forum/index>
http://localhost:8080/opencms/forum/index
  <http://localhost:8080/opencms/forumadmin/index>
http://localhost:8080/opencms/forumadmin/index

 have fun!

 P.S:

 additional settings can / must be done to mvnforum.xml and mvncore.xml
for production use
 (under WEB-INF/classes directory)for mailserver settings or
<max_attachment_size>1MB</max_attachment_size>

 Now you can upload mvnvorum.jar into the classes folder of your opencms
module and should be able to integrate
 /forum/index or other mvnforum pages into your application, if
necessary.

 ------------------
 Nice to have:
 ------------------

 link opencms user tables and mvnforum member tables to each other, so
that your opencms users
 don't have to register to mvnforum (or use your own authentication
services).

 Best Regards
 Arash

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://webmail.opencms.org/pipermail/opencms-dev/attachments/20041031/cf665b04/attachment.htm>