Upgrading Smart Bridges from Version 14.06 to Version 16



Version 16 Download


In order to upgrade to Version 16, you first need to upgrade your core NetLD server.  You can download the Version 16 installer by navigating to: http://logicvein.com/customer


You will be prompted to log in. The credentials are below.

  • User Name: netld
  • Password: download


You will see Windows and Linux installers with the newest revision, which you will need to download and install to upgrade from version 14 to 16.


Cautions:

  • Make sure to perform a system backup before upgrading.

Smart Bridge Upgrades from the Core Server


Version 16 added new functionality to our Smart Bridge feature. For more information on configuring your smart bridges refer to the article below: http://support.logicvein.com/solution/articles/13000012970-configuring-a-smartbridge-connection


If your Smart Bridge servers are Linux-based, you can perform the upgrades from the core NetLD server by following the steps below.  If your Smart Bridge servers are Windows-based, you will need to run the Smart Bridge installer manually on each bridge server.


The Version 16 core server includes an automation script, upgradeBridge.pl, to assist in upgrading remote Linux-based Smart Bridges, either individually or en mass.  Please read the instructions fully before attempting to upgrade your servers.


Detailed usage information is displayed when running the script with the "--help" command line option:


Script to automate netLD SmartBridge upgrades
 Note: This script is not required when upgrading from 16 or above.
       In that case the SmartBridges will be upgraded automatically.

To upgrade all SmartBridges:
 upgradeBridge.pl [options] all

To upgrade a single smart bridge:
 upgradeBridge.pl [options] single <bridge-ip-address>

     bridge-ip-address  The IP address of the bridge to upgrade

options:
 --netld-user=USER    The user to use to connect to the local netld API (default: admin)
 --netld-pass=PASS    The password to use to connect to the local netld API (default: password)
 --debug              Enable debug logging
 --sudo               Use sudo when executing commands on the SmartBridge
 --sudo-user=USER     Use user to sudo to when running sudo (default: root)
 --sudo-pass=PASS     Use password for the sudo user (default: none)
 --sudo-cmd=COMMAND   Use command to use to escalate to super user (default: sudo)
 --bridge-user=USER   The linux username to use when connecting to the SmartBridge (default: root)
 --bridge-pass=PASS   The linux password to use when connecting to the SmartBridge (default: password)
 --scp-timeout=SEC    The timeout in seconds for the SCP to complete for a single SmartBridge (default: 600)



Windows core NetLD Server:


In order to upgrade remote Linux-based Smart Bridge servers to Version 16, follow these steps:


Step 1:


Open a Windows command shell (CMD.EXE) and navigate to the NetLD installation directory.


cd "C:\Program Files\Net LineDancer"


Step 2:


Execute the Perl script, and fill out your credential information similar to the example below:


perl.bat upgradeBridge.pl --bridge-user=root --bridge-pass=password single 192.168.0.10


Example output:

Net LineDancer> perl.bat upgradeBridge.pl --bridge-user=root --bridge-pass=password single 192.168.0.10
Upgrade successful [192.168.0.10]


For an example of upgrading all servers see the Multiple Server Upgrade section below.



Linux core NetLD Server:


In order to upgrade remote Linux-based Smart Bridge servers to Version 16, follow these steps:


Step 1:


In a Linux bash command shell, as root, navigate to the NetLD installation directory.


cd /usr/share/netld



Step 2:



Execute the Perl script, and fill out your credential information similar to the example below:


perl/bin/perl upgradeBridge.pl --bridge-user=root --bridge-pass=password single 192.168.0.10


Example output:

$ perl/bin/perl upgradeBridge.pl --bridge-user=root --bridge-pass=password single 192.168.0.10
Upgrade successful [192.168.0.10]


For an example of upgrading all servers see the Multiple Server Upgrade section below.



Multiple Server Upgrade


  • For people upgrading multiple smart bridges we also recommend to try and upgrade a single smart bridge first to ensure that it is upgrading properly. 
  • Once you have verified this process works for you, you can mass update all of your Smart Bridge servers with the upgradeBridge.pl script as instructed here.


The upgradeBridge.pl script is capable of upgrading multiple Smart Bridge servers based on the Smart Bridges registered within NetLD.


In order to perform this action the "all" parameter can be used.  This usage of the upgradeBridge.pl script also requires that you specify the credentials of an Administrator role user in NetLD (e.g. admin).


Here is an example command used to perform this type of upgrade:


$ perl/bin/perl upgradeBridge.pl --netld-pass=password --bridge-user=root --bridge-pass=password all


See the usage details at the top of this solution for a full list of command line options.