Net LineDancer 14.06 natively supports Tera Term as the default SSH client for use with Terminal Proxy in the browser.  However, we understand that users have different preferences when it comes to SSH clients.  This Solution article will show you how to configure integration with either PuTTY or SecureCRT.


When you right-click on a device and choose "Open Terminal", you might encounter the following window:



Even if you intend to use PuTTY or SecureCRT, you will need to click on the "Install Integration" button and download the integration installer.  You do not need to run the installer (it is intended for Tera Term), but the act of downloading the installer tells your netLD client not to display this dialog again.


SecureCRT


Please ensure that you are using SecureCRT 7.3 or newer.


If you are using SecureCRT, download and double-click or execute the securecrt.reg file attached to this Solution.  This will create the appropriate Windows registry entry that tells your browser to open links with the ssh:// scheme using SecureCRT.


Note: the registry file has the hard-coded SecureCRT installation path C:\Program Files\VanDyke Software\SecureCRT\SecureCRT.exe.  If your installation of SecureCRT is not at this default location, you will need to edit the registry file, using a standard text editor such as Notepad, to reflect the correct path for your installation.


See the section below for VMware related issues on Windows 8, Windows 10, and Windows Server 2012.


PuTTY


If you are using PuTTY, download the PuTTY.zip file attached to this Solution.  Inside the zip file is a file called README.txt which contains further instructions (essentially copying an included batch file into the PuTTY installation directory).


Note: the registry file has the hard-coded PuTTY installation path C:\Program Files (x86)\PuTTY\putty.exe. If your installation of PuTTY is not at this default location, you will need to edit the registry file, using a standard text editor such as Notepad, to reflect the correct path for your installation.


Tera Term (Manual Method)


You can also install the Term Term integration manually.  Download and double-click or execute the teraterm.reg file attached to this Solution. This will create the appropriate Windows registry entry that tells your browser to open links with the ssh:// scheme using Tera Term.


Note: the registry file has the hard-coded Tera Term installation path C:\Program Files (x86)\teraterm\ttermpro.exe. If your installation of Tera Term is not at this default location, you will need to edit the registry file, using a standard text editor such as Notepad, to reflect the correct path for your installation.



Common Issues


SecureCRT on a VMware


When accessing Net LineDancer from a browser within a VMware instance of Windows 8, Windows 10, or Windows Server 2012 you may encounter an issue launching the Terminal Proxy client even after performing one of the integration steps above.


If you receive a dialog similar to the following, and"Default Host Application" (VMware) is in list ...


blob1476404159127.png


... there is a knowledge base article from VMware about the issue, along with instructions:


https://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=2073718


In essence, you must delete the URL association registry keys from the Default Host Application.  Here is a screenshot of the operation in progress:


blob1476404581343.png


After deleting the keys, you will need to reboot before the changes take effect.


Interference from Default Programs


If there are applications, other than your choice for integration, that have registered as handlers for the ssh:// and telnet:// protocols, it can interfere with launching the terminal client.  In order to correct his, find the programs that appear in the "How do you want to open this?" dialog above, and remove their association with the ssh:// and telnet:// protocols:


blob1476406037312.png