Chapter 1.2 - Installing Net Line Dancer for Windows and Linux

1.2.1 Instructions for Windows


With a Windows installation there is little or no software dependency when installing netLD. The installer sets everything up that you will need at that time. Below is the list of automatically installed software:


Adobe Flash Player v.10.3 or above. Installation is system-wide.


Java7 SE Runtime Environment and ActivePerl. Installation is package- local, so it does not conflict with the system-wide installation of the Java environment or ActivePerl.


Below, we provide screen-by-screen instructions for the installation of netLD. If you’re already familiar with the installation of windows, you will find our installation very straightforward. However, please note: we require an internet connection to automatically activate your license key or you will be required to run an additional process to be explained later. On the server, double-click on the netLD installer to start the installation.


blob1476393550658.png


Select a language from the drop-down menu and click on the “OK” button to start the Setup wizard.


blob1476393557307.png


Next NetLD checks the port usage. The following error message will appear if the installer finds any applications using the required port.


blob1476393566552.png


Click the “Next” button to see the License Agreement.



blob1476393580368.png


License Agreement. Press the down arrow to read the rest of the agreement and click “I Agree” to continue.



blob1476393604516.png


Specify the install directory by clicking “Browse”. Click on the “Next” button to continue.



blob1476393613988.png


Select the license. To activate the free trial version, select Activate Evaluation and enjoy the 30-day free trial. If you have already purchased netLD and have a license key, choose Activate withexisting License Key or License File.



blob1476393625676.png


If your environment is connected to the Internet, enter your serial number in the Internet Activation Serial field and click on Next. Otherwise, get a license file from us (support@logicvein.com), choose that file and click on Next. Note that the online serial authentication may fail under LDAP certification.


blob1476393632323.png


In the SSL Certificate dialog, enter the required information and click on the Install button. Information entered here can be edited after the installation. See Sec. 5.4.1 for details.


blob1476393640550.png


Installation continues.



blob1476393647119.png


NetLD authenticates the serial number via Internet; Internet connection is required in order to activate it. Without an Internet connection, you have to obtain a static license file from us. Please contact support@logicvein.com . Also, when we issue a license file, we require the MAC Address of your server. MAC Address can be obtained by ipconfig /all (on windows CUI) or ifconfig (on UNIX-like systems). If the server has multiple NICs, we require only one of them.


Click on the Next button if Installation Complete dialog is displayed.

blob1476393654920.png


Click on the Finish button to close the setup wizard.


blob1476393661879.png


1.2.2 Instruction on Linux family of OS


System Requirements

The netLD server for Linux can be installed on CentOS 6, CentOS 7, RedHat 6, and RedHat 7. Only 64bit operation systems are supported. More details about the system requirements can be found here: https://logicvein.com/system.php


Download the netLD installer

The Linux installer can be downloaded from the LogicVein website here: http://logicvein.com/download.php

To download the Linux installer for netLD..


  Navigate to the LogicVein download page here: http://logicvein.com/download.php

1. From the download page select the Linux evaluation program download. (This download same download can be used for evaluation downloads as well as for full licensed product.)

2. On the next page you will be asked for contact information. For evaluation installations this information is required in order for the activation license to be automatically generated.

3. Once you have entered your information and click I Agree and Send your download will begin. You will also be sent an email containing the activation license for your evaluation. (If you already have a valid activation license for your system, you can disregard this email)

4. The download is a zip file that contains the main netLD server installer (eg: netld-2014.06.0-x86-64.bin) as well as the Linux SmartBridge installer (eg: netld-bridge-2014.06.0-x86_64.bin).


Package Dependencies

All package dependencies will be automatically installed when installing with an internet connection. But in the case that there is no internet connection the following packages are required before the netLD installation can begin:


unzip, wget, gmp, iptables, iptables-ipv6, openssh, openssh-clients, shadow-utils, sudo

Additionally, for CentOS 6 the "compat-expat1" and "openssl098e-0.9.8e" packages are required, but for CentOS 7 the "openssl098e" package is required.

Running the Installer

Unzip the netLD installer (netld-2014.06.0-x86-64.bin) from the downloaded zip file.

Change to the root user using the su command. (alternatively, if your user is configured as a sudoer you can run all of the following commands using the sudo command)

Execute the netLD installer script:

sh netld-2014.06.0-x86-64.bin


You will asked if you would like to create a new certificate for this server. SSL is used for communication between the netLD web interface and server. For this to work an SSL certificate must be generated for this machine. This process will generate a self-signed certificate for your server, you can find more details on installing CA signed certificates here: Importing Certificates

 A certificate has already been created for this server. Would you like to overwrite it?


Overwrite [y/n]: 

Type "y" to continue. (If this is not a fresh install, you can select "n" to prevent the existing certificate from being overwritten.)

Finally you will be asked to enter the details for the new SSL certificate...

 Net LineDancer clients use SSL to communicate with the server. An SSL certificate must be generated for this machine. The hostname field below must accurately reflect the hostname for this server. Only ASCII characters are supported.

Hostname (FQDN): documentation-test

Organization Unit: docs

Organization: LogicVein

City: Austin

State or Province: Texas

Country Code [JP/KR/US]: US

From here the installer will complete and if there are no problems you will see the Installation Successful message. The netLD service will also be started automatically.

Connect to the netLD Server

Once the service has started successfully you can now connect to it through the netLD web interface. You can navigate to the web interface at https://localhost/

Note: The first time you connect to netLD from a browser, most browsers will display a warning that the connection is insecure. This is because of the connection is using a self-signed certificate. Once the certificate is installed into the browser, this warning message will go away.


License Activation

When you connect to the netLD web interface after installing for the first time, you will be presented with a license activation page. Enter your activation key here to activate your server.


Logging In

Once the server license has been activated, you will prompted with a login screen.

The default login credentials are.. 


Username: admin

Password: password

Starting and Stopping the Service

The netLD service is managed using a SysV init.d script. The service can be started and stopped using theservice command as the root user.

To start the netLD service:

service netld start

To stop the netLD service:

service netld stop


Uninstalling

The netLD installation can be removed by using the yum command. Beware that uninstalling netLD will remove all data as well, be sure to perform a system backup before uninstalling.

To uninstall netLD, run the following command as root:

yum remove netld

Open the browser and access https://localhost/. If your installation is successful and the server starts without error, it would show the uncertified SSL warnings, described in the next section.

If you run into trouble:

If you are using virtualization software such as VirtualBox or VMware and run netLD in a guest OS, pay special attention on how the network device on the guest OS is emulated. If you are using any of the above and are having troubles running netLD, themethod below may work for you:


• First of all, take a memo of your local IP address, for example 192.168.0.78.

• On a browser, try accessing the IP address (192.168.0.78) instead of localhost.

• If this does not work, see the log file.

– The log file is located in /usr/share/netld/, which is also the installation path.

– Below the directory, you will see netLD.log (via ls /usr/share/netld/.)

– Look into the log file and see the warning messages (via less netLD.log).

If you find java.net.UnknownHostException XXXX: XXXX: name or

service unknown or similar error messages, this is an system-dependent

problem.

∗ In this case, you have to resolve the name XXXX via /etc/hosts file or via DNS.

∗ Let XXXX be centos-virtual for example. This is usually the hostname of your machine (available via hostname command on the terminal).

∗ Add the following line to the /etc/hosts:

<real host IP address> centos-virtual

If the above example does not solve the problem, or if you have other setup issues, please contact support@logicvein.com with the above log file attached. Our professional support team is ready to assist.