Before installing NetVizura make sure to set the time on your server correctly. Time change after the installation will invalidate the license! |
Before installing NetVizura you will have to install: Oracle Java 1.7, Tomcat 7 and PostgreSQL 9.3 or higher, in that order. The installation process has been tested on Ubuntu 14. |
To install NetVizura follow these steps:
Step 1: sudo package installation: execute apt-get install sudo
Step 2: Oracle Java 1.7 package installation:
Default Java implementation is OpenJDK. You need to install Oracle Java package. Java packages should be installed before the Tomcat7 packages, if not Tomcat will use OpenJDK |
in file /etc/apt/sources.list, add the following lines:
deb http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main
deb-src http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main
execute command apt-get update
ignore the error about "public key is not available"
If you receive something like:
enter the following commands: rm /var/lib/apt/lists/* -vf apt-get update |
3. execute command apt-get install oracle-java7-installer
and answer affirmatively to "Proceed without verification" and all other installation questions
4. execute command ln
-s
/usr/lib/jvm/java-7-oracle
/usr/lib/jvm/default-java
to set Oracle's Java as a default Java on the system
5. check if java is properly installed with command java -version
Step 3: Tomcat 7 package installation:
apt-get install tomcat7
service tomcat7 start
service tomcat7 status
Step 4: PostgreSQL package installation
Create a file pgdg.list in /etc/apt/sources.list.d/ with some text editor:
nano /etc/apt/sources.list.d/pgdg.list
and add the following line:
deb http://apt.postgresql.org/pub/repos/apt/ trusty-pgdg main
execute command: wget --quiet -O - http://apt.postgresql.org/pub/repos/apt/ACCC4CF8.asc | sudo apt-key add -
execute command apt-get update
execute command apt-get install postgresql postgresql-client
verify that PostgreSQL is running properly with the command service postgresql status
dpkg -i downloaded_file_name.deb
Step 6: Verify installation
After installation tweaking of configuration files is required in order to utilize the installed RAM to the fullest extent. The main consumers of RAM are operating system, PostgreSQL database and Tomcat. General rule for distributing memory is to split it in ratio 2:1 between PostgreSQL and Tomcat with 1 GB or more reserved for operating system. For instance:
Installed RAM | PostgreSQL | Tomcat | OS |
---|---|---|---|
4 GB | 2 GB | 1 GB | 1 GB |
16 GB | 10 GB | 5 GB | 1 GB |
During installation NetVizura automatically allocates memory for Tomcat process. The amount allocated to Tomcat process is calculated according to the formula:
(RAMtotal - 1GB) / 3
but no less than 1GB.
For instance:
Total RAM | Tomcat |
---|---|
3 GB | 1 GB |
4 GB | 1 GB |
16 GB | 5 GB |
However, if you need to tweak Tomcat RAM allocation differently (the example for 2048MB):
/etc/default/tomcat7
JAVA_OPTS
environment variable that defines memory and uncomment it if it is
commented. This line looks something like the following:JAVA_OPTS="${JAVA_OPTS} -Xmx1024m -Xms1024m +UseConcMarkSweepGC"
-Xmx
parameter to allocate additional memory to Tomcat. Additionally, set parameter -Xms
to the same amount. This should look something like:JAVA_OPTS="-Djava.awt.headless=true -Xmx2048M -Xms2048M -XX:+UseConcMarkSweepGC"
service tomcat7 restart
Tweaking PostgreSQL for best performance is a topic on which many books were written, but the following are some common sense suggestions. In general there are two groups of PostgreSQL tweaks that are helpful for NetVizura performance - "safe" and "unsafe" tweaks. "Safe" tweaks are those which can be applied in all cases. "Unsafe" tweaks trade reliability for performance. For the curious ones recommended reads (among countless others) are PostgreSQL Optimization Guide, PostgreSQL Tuning Guide, this article and this book.
In order to apply following tweaks edit file /etc/postgresql/PG_VERSION_NUMBER/main/postgresql.conf
. You will need to restart the PostgreSQL service after done editing with command: service postgresql restart
. Almost all of the following parameters are commented with carron character (#
). Although these tweaks are considered "safe" do take notice of the default values. Usually you can comment out the parameter that has been changed and PostgreSQL will revert to the default value.