JSPWiki portable binaries#
As for 2.10.1, JSPWiki is also available on portable binaries
User notes#
- Based on Siegfried Goeschl's JSPWiki On A StickContent unavailable! (broken link)https://jspwiki-vm1.apache.org/images/out.png
- Launches a JSPWiki instance at http://localhost:9627/JSPWiki, to avoid conflicts with existing servers running on port 80 and/or 8080
The Pre-configured Wikis#
Personal Wiki#
This configuration makes the following assumptions
- You are the one and only user of JSPWiki
- You don't need to authenticate for working with JSPWiki
- Using BasicSearchProvider reg-exp grepping
- No page versioning
- Registered users with admin rights
- [ user , user ]
Department Public Wiki#
This configuration makes the following assumptions
- A group of mostly trust-worthy people are using the wiki
- Anonymous users have with read-only access
- Using VersioningFileProvider
- LuceneSearchProvider only picks up changes through JSPWiki
- Registered users with read/write access
- [ admin , lEtMeIn ]
- [ user , user ]
Dev notes#
Mac OS X#
- The Mac OS X JarBundlerContent unavailable! (broken link)https://jspwiki-vm1.apache.org/images/out.png 2.2.0 is used to build a native Mac OS X app but it depends on having the Apple JDK installed
- Supporting a modern Oracle JDK is done using the Oracle's AppBundler TaskContent unavailable! (broken link)https://jspwiki-vm1.apache.org/images/out.png
Creating The Native Launchers#
The native launchers are under version control and can be re-created manually. In other words there are not automatically build because
- Considering the complex setup I'm glad that it works on the JSPWiki committer boxes
- Downloading all the stuff is time-consuming and would slow the build for everyone
- There should be some manual testing before promoting the native launchers
Creating The Windows Launcher#
Run the following commands
jspwiki-portable> mvn clean package
jspwiki-portable> ant woas:download-launch4j-for-mac woas:create-windows-app
Buildfile: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/build.xml
woas:download-launch4j-for-mac:
[mkdir] Created dir: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack/launch4j
[get] Getting: http://netassist.dl.sourceforge.net/project/launch4j/launch4j-3/3.8/launch4j-3.8-macosx-x86.tgz
[get] To: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack/launch4j/launch4j-3.8-macosx-x86.tgz
[untar] Expanding: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack/launch4j/launch4j-3.8-macosx-x86.tgz into /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack
[delete] Deleting: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack/launch4j/launch4j-3.8-macosx-x86.tgz
woas:create-windows-app:
[launch4j] Compiling resources
[launch4j] Linking
[launch4j] Wrapping
[launch4j] Successfully created /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/woas/woas.exe
[echo] Created /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/woas/woas.exe ...
BUILD SUCCESSFUL
The generated woas.exe can be copied manually to ./jspwiki-portable/src/overlay/launchers/tomcat/woas.exe after manual testing.
note: on windows platforms, use ant woas:download-launch4j-for-win woas:create-windows-app to create the launcher.
Creating The Mac OS X Launcher#
Run the following commands
jspwiki-portable> mvn clean package
jspwiki-portable> ant woas:download-appbundler-for-mac woas:mac-app-oracle-jdk
Buildfile: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/build.xml
woas:download-appbundler-for-mac:
[mkdir] Created dir: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack/appbundler
[get] Getting: https://java.net/downloads/appbundler/appbundler-1.0.jar
[get] To: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack/appbundler/appbundler-1.0.jar
woas:mac-app-oracle-jdk:
[echo] Building Mac OS X launcher for Oracle JDK
[bundleapp] Creating app bundle: woas
BUILD SUCCESSFUL
The generated woas.app can be copied manually to jspwiki-portable/src/overlay/launchers/tomcat/woas.app after manual testing.
note: on windows platforms, use ant woas:download-appbundler-for-mac woas:download-launch4j-for-mac woas:create-mac-app
