Linux generic installation

Please use this page for reference when installing OSS on a Linux system (Ubuntu, CentOS, Xandros, etc.).

The Short Version should be sufficient ; if not use the More Detailed Version.

Short version

  • Make sure you have a Java 6 Virtual Machine or newer correctly installed
  • Download the latest stable build tar.gz
  • Deflate it and run start.sh, which you'll find within the OSS folder
  • Open your favorite browser with the URL http://yourserver:9090 (replace yourserver by localhost if it's running on your own machine)
  • Enjoy discovering OpenSearchServer

More Detailed version

Install a Java runtime (JVM). Here are some commons JVMs:

  • OpenJDK (http://openjdk.java.net/)
  • Oracle/SUN Java (http://www.java.com/en/download/)
  • IBM Java (https://www.ibm.com/developerworks/java/jdk/")

The following covers the same steps as above, in more detail.

Checking your Java version

In a shell, enter the command line

java -version

Check whether your Java version is 6 or newer:

  • If your version is not Version 6 or greater you'll need to update your Java engine
  • If you don't have Java, install it (see below)

Installing Java

Our Open Source-friendly recommendation is that you install the latest OpenJDK (1.7.0 as of this writing).

To install OpenJDK just follow the instructions provided at the openJDK site

Downloading OpenSearchServer

We recommend that you always get the latest version of OSS on SourceForge.

Please download the **tar.gz** package for Linux/BSD, then deflate it as in the example below:

tar -xzvf open-search-server-1.5.tar.gz

Once unzipped you'll get a folder called **opensearchserver**. All your OSS binaries (and your future data) will be stored within this folder.

Running it

Just launch the start.sh present in your OSS base folder to get the application running:

cd open-search-server
./start.sh

To access your OSS Back Office, open you browser (Firefox, Chromium, Opera, Safari...) and open the page http://yourserver:9090

If everything went right you'll see the OSS interface. If nothing is displaying and you are sure you followed this installation procedure correctly, check the troubleshooting section.

So far, so good ? You can now go to the next step and create your first index.

Troubleshooting

Checking whether your 9090 port is free

If by chance you already have a server listening on the 9090 tcp port you'll have to make a change in the Catalina config files.

To check whether the 9090 port is already occupied use the following command line:

netstat -an | grep :9090

If you have a response resembling the one below, then your port isn't free:

TCP    0.0.0.0:9090           0.0.0.0:0              LISTENING       676

If port 9090 is already being used, we suggest that you simply use another port for OpenSearchServer. To do so:

Open in you OSS folder the file start.sh
Locate the line starting with:

SERVER_PORT=9090

Then change that to:

SERVER_PORT=9091

Save your file and start OpenSearchServer with start.sh

Your OpenSearchServer Back Office is now available at this address: http://yourserver:9091


View/edit on GitHub


comments powered by Disqus