After downloading the stable release of OSS at their SourceForge page load up their Quick Start guide for your platform. Decompress the package to your /opt/ directory. The first thing you will want to do is create a “nobody” user account for the server to run under.
On Gentoo, run:
# useradd -d /opt/open-search-server -s /sbin/nologin -r oss
The -d flag specifies the user’s home directory, -s /sbin/nologin specifies a disabled shell and -r puts the UID of the given user in the “system accounts” range. It is important that the data directory is writable by the new account so change its ownership:
# chown oss: data/ -R
You also need to make some of the tomcat applet container’s files writable:
# chown oss: apache-tomcat-6.0.20/logs/ -R # chown oss: apache-tomcat-6.0.20/temp/ -R # chown oss: apache-tomcat-6.0.20/work/ -R
Now we want the server to start on boot-up. You can either make an init script or take the easy route and drop it in your local. On Gentoo edit /etc/conf.d/local.start to reflect:
cd /opt/open-search-server sudo -u oss ./start.sh
You will either need to change the working directory as shown above or add OSS to your PATH otherwise java will complain about missing files.
Similarly, configure your local to shut down the app gracefully:
killall -15 java
Start your init script or restart local and you should find your instance of OSS chugging away:
spider open-search-server # ps aux | grep java oss 9744 57.9 63.5 279724 166616 pts/0 Sl 14:43 2:28 /usr/lib/jvm/icedtea6-bin/bin/java -Djava.util.logging.config.file=/opt/open-search-server/apache-tomcat-6.0.20/conf/logging.properties -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Djava.endorsed.dirs=/opt/open-search-server/apache-tomcat-6.0.20/endorsed -classpath :/opt/open-search-server/apache-tomcat-6.0.20/bin/bootstrap.jar -Dcatalina.base=/opt/open-search-server/apache-tomcat-6.0.20 -Dcatalina.home=/opt/open-search-server/apache-tomcat-6.0.20 -Djava.io.tmpdir=/opt/open-search-server/apache-tomcat-6.0.20/temp org.apache.catalina.startup.Bootstrap start
You can now connect to the management interface at http://[server-addresss]:8080 .