Install
Q: Can I deploy SnipSnap on WAR application servers?
A: Yes. See
SnipSnap-war
Q: How do I get rid of the port 8668? 
A: Provided that you run as "root" or administrator user of your system you can safely set the port number to
80 or leave it empty in the installer page. The web server will then run on the default HTTP port. Alternatively use the method of an apache proxy in front of
SnipSnap as described on the
install page. The port setting is found in the WEB-INF directory in a file named
application.conf. The property to change is
app.port=<your_port_number_here>.
Q: How do I specify a single IP address/hostname to bind to ?
A: During the initial Setup, enter the host name to bind to. Leaving the host name field empty binds to all available addresses for that host.
NOTE: doesn't always work on systems with multiple IP addresses already running servers on your chosen port (80). You may want to try editing the conf/jetty.conf file and adding the following element to the org.mortbay.jetty.SocketListener:
<Set name="Host">
<SystemProperty name="jetty.host" default="xxx.xxx.xxx.xxx"/>
</Set>
This is because even when specifying a host name during the initial setup, SnipSnap starts a new SocketListener with the default IP address of 0.0.0.0 - all available IP addresses.
Configuration
Q: How do I edit robots.txt? I have a file but this does not work.
A:
robots.txt is mapped to a special servlet that we wanted to use to
- detect new robots
- prevent some of them from indexing the page
If you remove the servlet mapping to /robots.txt from
web.xml you can use your own robots.txt file.
Q: How do I edit the logo and name of my SnipSnap that appear on every page in "page-logo" and "page-title" divs?
A: Enter Setup and use the Basic Settings pane to change the logo and enter the tagline for your site.
Q: How do I customize weblogs pings?
A: Add or remove a ping from
conf/weblogsping.txt. For example the
default configuration for pinging weblogs.com is:
org.snipsnap.xmlrpc.ping.SimplePingHandler http://rpc.weblogs.com/RPC2
The first is the handler doing the ping (Simple, Extended or RSS) and the second
entry is the URL to use.
In SnipSnap 0.5.1a the weblogs pings are stored in a Snip [SnipSnap/config/Weblogsping], using the same format as described above.
To disable weblog pings completely change the entry
app.perm.weblogsPing
in the Snip [SnipSnap/config] to
Q: How can I customize the weblog dates?
A: Enter Setup and select the localization pane to change the format of the weblog dates. Default is "EEEE, dd. MMMM yyyy". For options take a look at
this.
Q: How do I change the language of weblog dates?
A: Enter Setup and select the localization pane. Selecting German in the language setting, the blog will display the weblog dates in German. Even if the default locale on your computer is English. SnipSnap defaults to english if no special setting has been made.
Q: How do I create multiple weblogs?
A: See
MultipleWeblogs.
Q: How to allow anyone (Register user) to edit anys snip ?
A: Most of the snips are editable by everyone. Only weblogs posts and comments are protected by default. Snips can be locked. Locked snips and weblog posts can only be changed by users with the "Editor" role.
Q: How to change the ownership of a snip ?
A: Currently the owner of a snip cannot change.
Q: I want to run two separate snipsnaps on one sever. How do I get a diff port #?
A: Some info available here:
Multiple SnipSnap Instances
Q: How do I setup MySQL database connection to support my charset?
A: During initial SnipSnap setup use add parameters useUnicode=true&characterEncoding=UTF-8. So, your connection url should look similar to this:
jdbc:mysql://yourhost/snipsnapdb?useUnicode=true&characterEncoding=UTF-8
If you do not set this encoding correctly MySQL will use default (?) encoding and very probably will break your snips. This problem will be visible after the restart of the SnipSnap server.
Q: How do I add an Edit Page link to every page?
A: There is an edit page link at the top of the page by default. In order for it to work, you must be logged in with the appropriate permissions. If you don't see the edit link (and the other links, like rdf, history, diff, etc), it probably means you're using a browser that doesn't support CSS very well.
Q: I want to customize some of the WikiText syntax to look more like (eg) TWiki. How do I configure the Radeox running inside SnipSnap?
A: ?
Q: What can I do when having Duplicate Snips in the maintainance section of configuration?
A:
How to delete that?
Q: I'm having problem setting up a second Snipsnap instance on the same host as my first one. I would like to have two (or more) separate Snipsnap's running on the same host but not within a single web application. Is that possible? How?
A:
See Multiple SnipSnap Instances
If you really want to do it the hard way then here is your answer:
It depends on your WAR-Container.
In Tomcat you can either simply rename the war file and put it alongside the regular WAR file. Or you could deploy the WAR file via the admin console and simply define a different "context". The same can be done via the WebLogic console.
Q: SnipSnap running on Redhat Linux locks up regularly
A: Use the LD_ASSUME_KERNEL environment variable to revert to pre-native posix threads. Add the following to your snipsnap startup.
Q: How can I specify the directory used for storing the files? On my win32-machine the data is always stored on %userprofile%/applications, which isn't the dir I'd like to use.
A: Add the
-Duser.home=mydatadirectory
to the Java vm options in your run.bat file (run.sh on Linux), replacing mydatadirectory with the directory you'd like the data to be stored in.
Q: When deployed as WAR in Tomcat, I am unable to create Snips with non-Latin1 characters in name. How can I solve this?
A: Edit your server.xml, find Coyote connector definition (the one with port 80, 8080 or so) and add parameter URIEncoding="UTF-8". Your connector definition now should look similar to this one :
<Connector port="8080"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
debug="0" connectionTimeout="20000" disableUploadTimeout="true"
URIEncoding="UTF-8" />Restart Tomcat.
Q:I am a snipSnap user from China,and I want let snipsnap work with Mysql4.1.7(the lastest version).For surport the other web applications,we had to set mysql default charset = utf8.A problem was come up,all the Chinese I entered will become chracters people can't recognize when I restart the serverI have try all the approaches that I can make out,e.g:add parameters after the database connection uri,like this,useUnicode=true&characterEncoding=gbk.but it does not work!when I set the Mysql server's default characterset to gbk,snipsnap can work well,but all the other web applications can not work!I am puzzled about that,I have work on it for one day!sign!
Q: How do I change the DC.title meta tag? Is it possible to add a prefix so the start page is NOT just called "start" (the name of the SnipSnap)?
Q: How do I get the installer to work on Java 1.4. Running the installation on windows with run.bat with JAVA_HOME set to JDK 1.4.2_10 causes a class version error Exception in thread "main" java.lang.UnsupportedClassVersionError: org/snipsnap/server/SnipSnapLauncher (Unsupported major.minor version 49.0). Yet running in JDK 1.5.0_06 seems to work
Powered by SnipSnap 1.0b3-uttoxeter 
Thanks,
-Scott