Checking your Java version
In a shell, enter the command line
java -version
Check whether your Java version is 7 or newer:
- If your version is not Version 7 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 use your favorite package manager:
apt-get install openjdk-7-jdk
Installing OpenSearchServer
We recommend that you always get the latest version of OSS on SourceForge.
Please download the **opensearchserver-X.X.X-bXXX.deb** package for Debian, then install it as in the example below:
dpkg -i opensearchserver-X.X.X-bXXX.deb
Once installed you will get the following folders:
- /var/lib/opensearchserver: Contains all your data (indexes).
- /usr/share/opensearchserver: Contains all your OSS binaries.
You also get the following files:
- /etc/opensearchserver: The configuration file of your OpenSearchServer instance
- /etc/init.d/opensearchserver: The script used by the system to start and stop the OpenSearchServer instance.
Running it
Just use the service command:
service opensearchserver start
To access your OSS Back Office, open you browser (Firefox, Chromium, Opera, Safari…) and open the page http://yourserver:9090
Stopping it
Use the service command with the stop parameter:
service opensearchserver stop
Configuration
The configuration file is located at /etc/opensearchserver.
Changing the listening port
If by chance you already have a server listening on the 9090 tcp port you’ll have to make a change in the config files.
Locate the line starting with:
SERVER_PORT=9090
Then change that to another port:
SERVER_PORT=9091
Restart your OpenSearchServer instance:
service opensearchserver stop
service opensearchserver start
Your OpenSearchServer Back Office is now available at this address: http://yourserver:9091
Changing the memory usage
By default, OpenSearchServer don’t set the memory allocation. It uses the default value from the Java Virtual Machine.
If you need to increase it, just edit the configuration file.
Locate the line with:
#JAVA_OPTS="-Xms1G -Xmx1G"
Uncomment the line, and set the memory value as needed:
JAVA_OPTS="-Xms2G -Xmx2G"
Restart OpenSearchServer.
Be aware that if you set a value greater than the physical memory available, OpenSearchServer will not start.