SoftPerfect Switch Port Mapper
Online User Manual

Getting started

Once you start the application, you will see its main window:

SoftPerfect Switch Port Mapper - Main window

First of all, you need to configure the Port Mapper to connect to your switch and optionally your router. This can be done in two ways:

  • If you have more than one device, it’s a good idea to add them in the device list for quick access in the future. To do so, choose File – Manage Devices.
  • If you only have one device or do not wish to store device details, choose File – Quick Connect.

In both cases, you will be asked for a host name and the credentials for your devices. It is important to understand that the software uses SNMP to access network equipment, which means only managed hardware is supported and it must have SNMP enabled.

Adding a device

To add a device, or a pair of devices click Add in the device manager.

SoftPerfect Switch Port Mapper - Adding a device

Enter the host name of a switch whose port mappings you want to receive. Then choose an SNMP version that your switch supports. It is recommended to choose SNMPv2c or SNMPv3 wherever possible as these versions of the protocol support bulk operations.

For SNMPv1 and SNMPv2c you will need to specify a community name. It acts like a password for the device access.

For SNMPv3 it is a bit more complicated. The third version of the protocol supports secure authentication and data encryption. You will need to choose a cipher, a hash algorithm and one or two passwords, depending on the required security level.

If you require IP information to be displayed, you can also specify a router (see the Getting Mappings section below for details).

Clicking Test Connection will display basic device information:

SoftPerfect Switch Port Mapper - Device Info

Quick connect

The Quick Connect panel allows you to pull switch port mappings without having to store it in the device list. In this case there is no need to choose an SNMP version. The software attempts to connect to the device(s) with SNMPv2c and if it fails, it uses SNMPv1.

SoftPerfect Switch Port Mapper - Quick connect

Getting mappings

Once you have configured your switch’s connection details, and optionally your router’s, you are good to go. So click Go.

The software will connect to the switch and pull a list of available ports, their speed, duplex status and other information. It will also pull a list of MAC addresses connected to each port.

After that (in fact, in parallel), the software will either connect to your router if you have configured it and pull a list of IP-to-MAC address mappings, or scan the current subnet for this information.

Once the Port Mapper has retrieved the required information, it cross-references the received data. The list of MAC addresses received from the switch is matched against the list of IP-to-MAC address mappings. At the final pass, those IP addresses are resolved into host names.

If there is no mapping information for a specific MAC address, you will only see Client MAC address, without IP information or host name.

SoftPerfect Switch Port Mapper - Main window with mapping results

Third-party applications

The Port Mapper allows you to quickly launch third-party applications for troubleshooting and testing. Select a row where an IP address is present and you will be able to launch an application to connect to that IP address or test connectivity:

SoftPerfect Switch Port Mapper - Third-party applications

More applications can be added in File – Settings & Preferences.

Comments

The software allows you to have comments assigned to an IP address, MAC address or a switch port. Right-click a row and choose Add/Edit Comment to add or update a comment.

Comments assigned to a MAC or IP address are treated as global. You will see the comments, even if these MAC or IP addresses are pulled from a different switch. Comments assigned to a switch port are specific to that switch.

Console version

Almost identical functionality is available through the console version of the Port Mapper software. The console version does not have a list of devices, so their credentials need to be passed in a command line:

SoftPerfect Switch Port Mapper - Console
Launching the console version without parameters displays parameters syntax.
SoftPerfect Switch Port Mapper - Command line
In this example we retrieve the same information using the console version.

License keys

In the GUI version, a license key to remove the trial restrictions can be entered in Help – Enter License Key.

To apply a license key to the console version, copy the key’s contents between the tags as shown below and save it as a *.key file with the same name as the console executable. Usually it will be NSMapCon.key.

------ KEY BEGIN KEY ------
...key’s contents...
------ KEY END KEY ------

License agreement

END USER LICENSE AGREEMENT (EULA)

Copyright in this software and included documentation belongs to SoftPerfect Research. All rights are reserved. The software may be used, installed or copied only in accordance with the terms of the license which is described in the following paragraphs.

DISTRIBUTION TERMS

The evaluation version of the software may be freely distributed provided that the original distribution package is not modified in any way.

EVALUATION VERSION

This is not free software. You are hereby licensed to use this software for evaluation purposes without charge. The software comes with a restriction that it displays up to 10 switch ports at a time. To remove the restriction, you need to purchase a license.

GRANT OF LICENSE

For the purpose of this EULA an organisation is defined as a company, corporation, firm, enterprise or institution, or part thereof that has its own function(s) and administration and that supplies products or services to other organisations or individuals.

The software is licensed, not sold. Upon purchase of a license, SoftPerfect Research grants you non-exclusive, non-transferable rights to use the Software according to the terms of this EULA. There are the following two types of license issued for this software:

  • Single Computer License. A single computer license grants the purchaser, or agents of the purchaser, rights to install and use the software on one computer or server.
  • Site License. A site license grants an organisation, or agents of an organisation, rights to install and use the software on an unlimited number of computers or servers within one organisation site. For the purposes of this EULA an organisation site is defined as a location, or group of locations, used by the organisation which are all within 100 miles (160 kilometres) of each other.

DISTRIBUTION OF LICENSE KEYS

Except for the specific purposes described in the GRANT OF LICENSE section of this EULA, license keys issued by SoftPerfect Research may not be distributed by any person or organisation or their agents without written permission from the copyright holder, SoftPerfect Research.

DISCLAIMER

THIS PRODUCT IS DISTRIBUTED “AS IS”. NO WARRANTY OF ANY KIND IS EXPRESSED OR IMPLIED. YOU USE IT AT YOUR OWN RISK. NEITHER THE AUTHOR NOR AGENTS OF THE AUTHOR WILL BE LIABLE FOR DATA LOSS, DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR MISUSING THIS SOFTWARE.

MODIFICATIONS

Unauthorised modification, decompilation or reverse engineering of the program or any subset of the program without written permission from the copyright holder is strictly prohibited.

TERMS OF ACCEPTANCE

Installation or use of this program signifies acceptance of the terms and conditions of the license. If you do not agree with the terms and conditions, you must not install the software, or remove the software from your computer(s) if it is already installed. SoftPerfect Research reserves all rights not expressly granted here.

Product Page & Download