1.5 Initial configuration
In order to gather the configuration data of the network devices in your network, netLD needs to know how to access those devices. In this section, we give a brief overview of how to set up the initial configurations in netLD. After these configurations are completed, we gain full access to the network devices via our convenient interfaces.
1. Add Devices. First, add devices to netLD inventory. You can either add devices manually, or using ”automatic device discovery.” See Sec. 3.3.1 for details.
2. Set Credentials. Register a username and the associated password of each device. This information is used every time netLD log in to the devices under control. See Sec. 3.1 for details.
3. Perform a Backup. netLD creates backups of the configuration data for each device in the inventory. It allows you to compare configurations between devices, detect changes in configurations and track down the history afterward. See Sec. 3.4 for details.
4. Setup Scheduled backups. We recommend that you schedule a backup on a regular basis. Further description is available in Sec. 3.7.
Start-up Wizard. We also provide a built-in Startup Wizard that will run when you log into netLD the first time. This wizard can be suspended or invoked at any time. To access the wizard, select the Inventory drop down menu in the upper-right menu bar. Select Run Startup Wizard.
1.5.1 Adding the Devices
You can add devices to the inventory either manually or automatically. First, we will describe the automatic method. Open up Startup Wizard. You will see two input areas, IP Address/CIDR and Community String. IP Address and CIDR specify the target range of the IP Addresses with a subnet mask. Community String is the information netLD uses in the SNMP communication during the automatic discovery. For most devices, the (read-only) community string is public by default.
Example of Menu Items
IP Address/CIDR 192.168.0.1/24
Community String public
Once you have entered the required information, click the Discover button. A new table shows up and tells you about the progress. The leftmost icons are supposed to show or which indicates some information is missing. However, this is to be expected because we have not yet entered the credential information. Credential information is described in the next section.
Figure 1.5.1: Results after adding a device. Icons indicate the status of the device e.g. in this figure, indicates successful addition.
The discovery can be run later (described in Sec. 3.3.1.) If you already have a CSV spreadsheet containing the list of device IP addresses, Import from Excel option might be useful. The specification of the spreadsheet columns is available in Sec. 3.3.6.
1.5.2 Setting the Credentials
After the devices are added, you have to specify the login credentials for the devices in order to allow netLD to freely login to the devices. In Startup Wizard, you can click on the large Credentials icon to do this.
First, enter an arbitrary name for the network group. This can be modified later. In this example, we used ”LogicVein”.
Next, choose the IP address by range (Dynamic) or by entering the IP address directly or, from the spreadsheet (Static). In most cases, the Dynamic method is preferred for new users.
Clicking on the above icons will change the current tab in Startup Wizard, allowing you to go back and forth at any time in this Startup Wizard. For instance, clicking back to Add Devices section to run the discovery again. If the devices are not detected correctly, then you can repeatedly add the credential information and retry the discovery. Similarly, you can add the credential information, try the backup, discover more devices, and add the credential information . . . (looping). These cycles iteratively improve the information accuracy and the completeness in the database. Note that during discovery and backup, the device configurations are not modified and it is safe to run these operations repeatedly.
Enter the login information for each device, or group of devices.
In VTY Username and VTY password area enter the CUI login username and the password used during the SSH (or telnet) connection. if the devices have both the secret password and enable password, enter the secret password. If only the enable password is available on the device, enter the enable password.
You can add multiple Network Groups. Also, you can register multiple Credentials and IP ranges per group. The concepts like Network Groups and †4 Credentials are described in detail in the later chapter Sec. 2.
The Credential feature is available outside of Startup Wizard just as Adding devices is. You can change the value in Inventory → Credentials. Further description is available in Sec. 3.1.
1.5.3 Performing a Backup
Once the devices are added to the inventory (or your discovery has completed), perform the first backup by clicking on the Run Backup button.
The backup status of each device is indicated with an icon. Successful backups show a green icon, Credential errors shows a yellow icon, Failures shows a red icon and so on. Details are described in Sec. 2.2.
You may fail to get the complete backup of all devices in the first attempt due to incorrect configurations on your network devices. This is a good example, showing that managing the devices is diﬃcult and requires considerable eﬀorts. Now that you have netLD, you no longer have to worry about this issue!
In order to increase the number of devices successfully backed up, quickly review the following conditions on each device where the backup has failed.
• Go back to the previous section and check if the registered credentials (Username, Password, Community, etc.) are consistent with the information on each
• Back to the previous section and check if no network groups are using the same range of IP addresses.
• Required protocols (e.g., telnet, ssh, etc.) are already enabled on the device.
In order to do this, you have to manually log in to each device via CUI and change the configurations. The required protocols are listed in Sec. 7.1.
• Certain ports for those communications are not blocked neither by any firewall(s) nor by any antivirus software. The list of TCP/UDP ports used by netLD is available in Sec. 7.1.
• Check if your devices are supported. The available device adapter list is in Sec. 7.7.
If the program is still not able to perform a backup even though the above conditions have been met, please get the log file through the following steps and send it to our support oﬃce(firstname.lastname@example.org).
1. Take a memo on the devices whose backup fails.
2. Click on the Close button in the bottom-right of the Startup Wizard dialog.
3. Find the Help section in the menu bar located in the upper right corner of the screen.
4. Navigate through Help → About → Adapter Logging.
5. Enter the IP addresses of the devices in IP/CIDR field. Check on Enable recording of adapter operations and click on the OK button.
6. Perform a backup for those devices.
7. The log file is exported to C:ˇProgram FilesˇNet LineDancerˇscratch
ˇlogs (on Windows Server).
8. If you have setup the SMTP server setting, you can:
(a) Select Help menu located in the upper right corner of the screen and select About option.
(b) Click on the Send Log and enter your e-mail address in Your E-Mail field, and click on the OK button.
In order to setup the SMTP server, see Sec. 5.2.3. Otherwise, you can simply send an email to email@example.com with the log file.
1.5.4 Scheduling the Backups
Now that you have successfully completed your first backup you can schedule netLD to automatically run your backups on a regular basis. Constant tracking of all the configurations is critical for the robustness and the security of your network.
Figure 1.5.2: Scheduling a backup.
Creating a periodical schedule of backup jobs is quite easy. Just go to the next tab in the Startup Wizard and select Setup Schedules and create a Backup job. In Run daily at, you can specify which time of the day you want to perform the backup. In netLD, the scheduled tasks are called jobs. The options available in Startup Wizard are quite limited compared to what can be done in Jobs tab. The full feature of job scheduling is described in Sec. 3.7.
You can also specify a discovery job, in which netLD acquires the neighboring device information from each of the network devices. Like the backup jobs, only daily schedules can be created in the Startup Wizard. However, in-depth configuration can be made afterward in the Jobs tab section 3
If you need further assistance or technical support about Net LineDancer, please feel free to contact below. We will be sure to help you when you find any errors or ambiguities in this manual, or any questions regarding them as well. Please note that we are closed on weekends, national holidays, New Years and summer holidays in Japanese time.
We accept e-mails for 24 hours but we will only reply during business hours.
Thank you for your cooperation.
LogicVein, Inc. Technical Support