Guide for installing the netLD server on a linux system.


This document will explain the steps required in order to install Net LineDancer on a Linux system.


Overview

  1. System Requirements
  2. Downloading the netLD Installer
  3. Package Dependencies
  4. Running the Installer
  5. Connecting to the netLD Server
  6. License Activation
  7. Logging In
  8. Starting and Stopping the Service
  9. Uninstalling

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


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

  1. Navigate to the LogicVein download page here: http://logicvein.com/download.php
  2. 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.)
  3. 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.
  4. 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)


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


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


More details about the installation dependencies can be found here: Linux Dependencies


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


If the system doesn't have an internet connection, the netLD installer can be forced to run in offline mode by using the --force-offline switch. This switch causes the installer to pass --disablerepo=* as an argument when executing yum commands.

sh netld-2014.06.0-x86-64.bin --force-offline



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.


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

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

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



8. Starting and Stopping the Service

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


To start the netLD service:

service netld start


To stop the netLD service:

service netld stop


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