Updating NP-View Server
This section describes how to update the NP-View Server application and the underlying components if the OVF was used for the initial installation.
Updating the NP-View Server Application
To update an existing NP-View Application, the steps are:
- Download the latest release Linux Installer Release (not the .OVF) from the Network Perception Portal and copy it onto your NP-view server using SCP (or WinSCP from a Windows client)
- Login onto the NP-View server using SSH (or Putty from a Windows client)
- Get root permissions using the command:
sudo -i - Prior to installing the new version, it is recommended to make a backup of your database (see below)
- Execute the new NP-View release file using the command:
sh NP-View_installer.sh(where NP-View_installer.sh is the name of the new release file downloaded in step 1). - Follow the guided steps of the installer, which will automatically start NP-View once the update is complete.
- Connect to the user interface of NP-View using your web browser and check in the bottom-left corner of the home page that the version number matches the new release
Get Version API call
To check the version update your server URL to the following
https://<np-view_server_address>/version
Backing up the NP-View Server Database
- Stop the NP-View Server (you can use the script
/opt/np-live/stop_nplive.sh) - From the NP-View Server folder (by default:
/opt/np-live/, run the command:tar -zcf db_backup_$(date '+%Y_%m_%d').tgz db(this command may take few minutes to complete) - Run the new release installer, which will update the containers and then launch NP-View Server
Updating CentOS 7 and Docker
If the OVF was used for the initial installation, that package included the CentOS 7 operating system and Docker. These applications must be updated separately from the NP-View Server Application using the below instructions. The instructions cover NP-View Servers that have internet access and those that do not have internet access.
Updating when the NP-View server has internet access:
– stop NP-View
cd /opt/np-live/
./stop_NP-Live.sh
– run all updates
yum update -y
– reboot server
reboot
Updating when the NP-View server does not have internet access:
If NP-View server is installed in an environment that does not have internet access, a separate Centos 7 server with Docker that has internet access is required to create the update package. All commands below are case sensitive.
Network-Perception uses this mirror for CentOS updates and this mirror for Docker updates
Centos 7 that is online:
– make sure you are root
sudo su -
– create packages directory
cd /root/
mkdir packages
cd packages
– download all packages
yum list installed | awk {'print $1; }' | tail -n +3 | xargs yumdownloader
– you should see docker included in the output list.
– compress archive (capital -C is important)
tar czf /root/packages.tar.gz *.rpm -C /root/packages/
– Copy packages.tar.gz to the offline server. The user can use the below command to scp:
scp packages.tar.gz root@ipAddress:/root/
Centos 7 that is offline running NP-View:
– make sure you are root
sudo su -
– stop NP-View
cd /opt/np-live/
./stop_NP-Live.sh
– create directory and extract the archive
cd /root/
mkdir packages/
mv packages.tar.gz packages/
cd packages/
tar -xf packages.tar.gz
– install all updates:
yum -y localinstall *.rpm
– reboot server
reboot
– now everything is up to date on the offline server.
If you get any docker swarm errors:
– make sure you are root
sudo su -
– leave and join swarm cluster
docker swarm leave --force && docker swarm init
