100% pure java Wiki using the same file database as the
UseMod Wiki(perl)
Release v1.2
Test Environment :
- OS: Window XP
- Server: jakarta-Tomcat 4.1.xx( testing v4.1.30, v4.1.24)
- JDK : J2SDK? 1.4 (testing jdk 1.4.2_06)
- Deploy package: usemodj-utf8.war ( drop to ../jakarta-Tomcat4.1.xx/webapps/usemodj-utf8.war )
- Test url: http://localhost:8080/usemodj-utf8/
Installing the Java Wiki UseModj? v1.2 WAR version
1. Install a Java Development Kit (JDK) from http://java.sun.com/j2se/downloads.html .
Be sure to get the JDK, not the JRE.
2. Set the JAVA_HOME variable to where you installed Java.
3. Unzip the usemodj-utf8 WAR.
4. Copy this over to the webapps directory of your application server (assuming you are using tomcat ).
5. Edit the usemodj.properties file in the webapps\usemodj-utf8\WEB-INF\classes directory
and set the DataDir?, UploadDir? properties to a directory of your choice.
These directory is where usemodj wiki will store its configuration information, indexes and attachments.
6. Restart your webserver if necessary.
7. Point your browser at http://localhost:8080/usemodj-utf8 .
ex) webapps\usemodj-utf8\WEB-INF\classes\usemodj.properties :
# Main wiki directory
DataDir? = d:/usemodjdb-utf8
# uploaded file or image location
UploadDir? = d:/usemodjdb-utf8/uploads
# country language unicode range : (http://www.unicode.org/charts/)
AnyLetter?=\u0370-\u1FFFF\uAC00-\uD7A3\u3040-\u309F\u30A0-\u30FF\u31F0-\u31FF\u4E00-\u9FAF\u3400-\u4DBF\uF900-\uFAFF
Release ~ v1.1a
1. Install Environment:
- J2SDK1.4.1
- Tomcat-1.4.24 (.war)
- JBoss? J2EE? Server-3.2.3 (.ear)
2. default configuration setting :
# /WEB-INF/classes/usemodj.properties :
DataDir? = /usemodjdb
AdminPass? = admin
DataDir? = root directory of the location of the wiki pages
# /WEB-INF/web.xml :
encoding: euc-kr (korean)
English : iso-8859-1 (encoding)
# /vm/layout/Default.vm : - layout template
charset : euc-kr (korean)
<HEAD> <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=EUC-KR">
...
3. deploy location of usemodj.war or usemodj.ear
a. tomcat4.1.24 : TOMCAT_HOME/webapps/usemodj.war
(unzip usemodj-1.0a-tomcat-4.1.24.zip )
b. jboss3.2.3 : JBOSS_HOME/server/default/deploy/usemodj.ear
(unzip usemodj-1.0a-jboss-3.2.3.zip)
4. http request url location (usemodj.war or usemodj.ear):
- http://localhost:8080/usemodj
Configuration properties for Administator
File: WEB-INF/classes/usemodj.properties :
...
# Set to non-blank to enable password(s)
AdminPass? = admin
# Like AdminPass?, but for editing only
EditPass? =
...
Administator or Editor Login :
- First confirm AdminPass? or EditPass? password in WEB-INF/classes/usemodj.properties
- Next, goto "Preferences" menu page and input admin password into Administrator Password: text box and save
- Then, Administration menu box apprears the left pane of all pages
Administator or Editor Logout :
- Goto "Preferences" menu page and input empty into Administrator Password: text box and save
Configuration properties for file upload (after UseModj? v1.1a)
File: WEB-INF/classes/usemodj.properties :
.....
# 1 = allow uploads, 0 = no uploads
UseUpload? = 1
# Full path (like <Context ROOT Real Path>/uploads/<the first char of fileName>/<fileName>)
# UploadDir? = $CONTEXT_DIR/uploads ($CONTEXT_DIR = C:/cafe/jakarta-tomcat-4.1.24/webapps/usemodj)
UploadDir? = C:/cafe/jakarta-tomcat-4.1.24/webapps/usemodj/uploads
# Full URL (like [http://foo.com]/<Context ROOT>/uploads/<the first char of fileName>/<fileName>)
# UploadUrl? = $CONTEXT_URI/uploads ($CONTEXT_URI= /usemodj)
UploadUrl? = /usemodj/uploads
.....