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.

NetVizura Installation Steps

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

  1. 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
  2. execute command apt-get update

    1. ignore the error about "public key is not available"

If you receive something like:

W: GPG error: http://ppa.launchpad.net trusty InRelease: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY C2518248EEA14886
W: Failed to fetch http://security.ubuntu.com/ubuntu/dists/trusty-security/main/source/Sources Hash Sum mismatch

W: Failed to fetch http://security.ubuntu.com/ubuntu/dists/trusty-security/universe/source/Sources Hash Sum mismatch

W: Failed to fetch http://security.ubuntu.com/ubuntu/dists/trusty-security/main/binary-amd64/Packages Hash Sum mismatch

W: Failed to fetch http://security.ubuntu.com/ubuntu/dists/trusty-security/universe/binary-amd64/Packages Hash Sum mismatch

W: Failed to fetch http://security.ubuntu.com/ubuntu/dists/trusty-security/main/binary-i386/Packages Hash Sum mismatch

W: Failed to fetch http://security.ubuntu.com/ubuntu/dists/trusty-security/universe/binary-i386/Packages Hash Sum mismatch

E: Some index files failed to download. They have been ignored, or old ones used instead.

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:

  1. execute command apt-get install tomcat7
  2. start Tomcat: service tomcat7 start
  3. verify that Tomcat is running properly with the command service tomcat7 status

Step 4: PostgreSQL package installation

  1. 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 

  2. execute command: wget --quiet -O - http://apt.postgresql.org/pub/repos/apt/ACCC4CF8.asc | sudo apt-key add -

  3. execute command apt-get update

  4. execute command apt-get install postgresql postgresql-client

  5. verify that PostgreSQL is running properly with the command service postgresql status


Step 5: NetVizura package installation
After this steps, install the NetVizura package downloaded from the website with the command: dpkg -i downloaded_file_name.deb

Step 6: Verify installation

Post Install Steps

Tomcat Memory Allocation 

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 RAMPostgreSQLTomcatOS
4 GB2 GB1 GB1 GB
16 GB10 GB5 GB1 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 RAMTomcat
3 GB1 GB
4 GB1 GB
16 GB5 GB

However, if you need to tweak Tomcat RAM allocation differently (the example for 2048MB):

  1. Edit file /etc/default/tomcat7
  2. Locate 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"
  3. Modify the -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"
  1. Save the file and restart Tomcat: service tomcat7 restart

Tweaking PostgreSQL

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 GuidePostgreSQL 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.