Reference: This article has been modified from the content presented on www.formsys.com at http://www.formsys.com/support/dongle-problems/hasp-network-dongles. SoilVision Systems Ltd. is not associated with these companies or products in any way, except that we also use the NetHASP Network USB Keys.
NetHASP Dongle Troubleshooting Guide
Network dongle troubleshooting can be a tricky process - mostly because every network is different and there are more steps involved in setting it up. To that end, I've created a troubleshooting guide - with a list of 22 questions to answer which may lead to the source of the problem.
You can answer these below:
- Are the latest HASP drivers installed on the server machine (see Where do I get the latest usb key drivers?) to get the latest drivers.
- Did you restart the server after installing the drivers?
- Are the latest HASP drivers installed on the client machine (see Where do I get the latest usb key drivers?) to get the latest drivers.
- Did you restart the client machine after installing the drivers?
- Is a network dongle attached?
- Is it a network dongle? colour = red, if any other colour (including purple) then not a network dongle.
- Is it a SoilVision Systems Ltd. network dongle?
- Is the license manager installed?
- Is the license manager the latest version? (see the HASP Download Page for latest)
- Is the license manager running? - there should be an icon on the system tray saying so.
- Restart the license manager to make sure it is working correctly and free up any locked licenses.
- Is the server/client actually on a network?
- If no, then check network dongle faq entry for standalone installation
- Are the server and client on the same subnet?
- if yes: is it greater than a C-class network? (ie. are the first three blocks of the ip address the same)
- if yes: is a nethasp.ini present? (see nethasp.ini info)
- no - then create one as it may be required and would certainly be faster.
- is there connectivity between the server and client? - perform ping test
- if no, check network connection and firewalls
- if yes, a nethasp.ini file will be needed
- Perform Diagnostix on client and server machines and check the log files:
- Does the server machine see a dongle attached?
- Does the client see the server license manager?
- Is a nethasp.ini file present on the client machine?
- if yes - check the configuration of the file, including that the ip address is the right address of the server. Also make sure that the SERVER NAME and SERVER IP are not both specified - this seems to confuse it. You should only specify one of those.
- Are there any stray nethasp.ini files on the client machine? search C:\ for 'nethasp'
- Are there any firewalls on client or server?
- yes - ensure they are configured to allow TCP/UDP port 475, or simply try turning them both off briefly to see if they are interfering.
- If it works with the firewall turned off, but doesn't work when firewall on even with port 475 open on the firewall, then add the application to the firewall instead.
- What is the exact error message given by our application? - check nethasp error code against table below and see if it gives any clue
- Is there more than one SoilVision Systems Ltd. dongle available on the network?
- if yes, then this should work only if a nethasp.ini file is used AND the two network dongles are on different servers.
- Are you using Terminal Services/Remote Desktop to connect to the server?
- if yes, this will prevent the license manager from running properly unless you connect to it using /Console option or simply go to the machine manually to restart it.
NetHASP Error Codes
If you're trying to diagnose why a network dongle isn't working - our software may display error codes received from trying to communicate with the nethasp dongle, and this can be useful in tracking the problem down. Please use the following error codes - the first 128 error codes are all from the software, while the error codes from 129 and above are errors from the License Manager itself.
Error Code |
Description |
0 |
Operation successful. |
1 |
The IPX, NetBIOS or TCP/IP protocols have not been installed properly. Act accordingly. |
2 |
Communication error. Unable to get socket number. Applies to IPX and TCP/IP. Verify that the protocol is installed properly. |
3 |
Communication error. - NetBIOS: Unable to establish session. Verify that the protocol is installed properly. - IPX: Unable to get NetHASP License Manager's immediate address. Verify that the protocol is installed properly. - TCP/IP: Unable to connect to the server. Verify that the server address is correct in the INI file. |
4 |
No NetHASP License Manager was found. Check whether your software has a path and read permission to the address file. |
5 |
Cannot read the NetHASP License Manager address file. |
6 |
Cannot close the NetHASP License Manager address file. |
7 |
Communication error. Failed to send packet. Verify that the protocol is installed properly. |
8 |
No answer from the NetHASP License Manager. IPX - The network is busy or incorrect address files found. In the latter case, delete all copies of the HASPADDR.DAT and NEWHADDR.DAT files. NetBIOS - the network is busy. TCP/IP - If the TCP method is used then the network is busy. If the UDP method is used then the network is busy or there is an incorrect address in the INI file. |
10 |
You called the hasp() routine with one of the services, without first calling the LOGIN service. |
11 |
Communication error. Adapter error. Applies only to NetBIOS. This error can also happen when the NETBIOS protocol is not installed. Verify that the protocol is installed properly. |
15 |
No active NetHASP License Manager was found. |
18 |
Cannot Login because the SET_SERVER_BY_NAME call was not successful. |
19 |
Syntax error in the NetHASP configuration file (LASTSTATUS service returns the line number in which the error occurred in Par2). If LastStatus returns 0 in par2, either there is an environment variable with an illegal setting, or no IP address was found (when working with TCP/IP or UDP to host). |
20 |
Error handling the NetHASP configuration file. A file operation like ”open file” or ”read file” failed. A possible reason can be that the system has run out of file handles. The LastStatus service returns the OS system error code in Par2. |
21 |
NetHASP did not succeed in allocating memory. This error is unique to NetHASP interfaces for Microsoft Windows applications and DOS extenders. Try to free DOS memory. |
22 |
NetHASP did not succeed in freeing memory. This error is unique to NetHASP interfaces for Microsoft Windows applications and DOS extenders. |
23 |
Invalid NetHASP memory address. |
25 |
Failed to load the DLL (winsock.dll or w32sock.dll). Applies only to TCP/IP or IPX. |
26 |
Failed to unload the DLL (winsock.dll or w32sock.dll). Applies only to TCP/IP or IPX. |
28 |
Winsock.dll startup error. Applies only to TCP/IP. |
30 |
Failed to close the socket. Applies to TCP/IP only. |
33 |
Protocol already set. Returned only when you attempt to set the protocol without having logged out completely from the API. |
129 |
The correct NetHASP key is not connected to the NetHASP License Manager. |
130 |
The Program Number (Prg Num) specified is not in the Program List of the NetHASP memory. |
131 |
Error reading from NetHASP memory. |
132 |
Error writing to NetHASP memory. |
133 |
The current LOGIN request exceeds the number of stations which may run the software concurrently. |
134 |
The current LOGIN request exceeds the number of authorized activations for the software. |
135 |
You called the hasp() routine with the LOGOUT service without first calling the LOGIN service. This can happen when the License Manager was reloaded or you have been logged out from the License Manager. |
136 |
The NetHASP License Manager is busy. This may occur if your NetHASP system is not well adapted to the network. |
137 |
There is no space in the NetHASP user list. |
138 |
Internal NetHASP error. The Number of Authorized Stations is larger than the maximum number designated by the NetHASP model. |
139 |
The NetHASP License Manager crashed and was reactivated, or you called the hasp() routine with one of the services without first calling the LOGIN service. |
140 |
The NetHASP Licence Manager does not serve your station's network. |
141 |
Invalid service, or new version of the HASP API is communicating with an older version of the NetHASP License Manager. |
142 |
Cannot find the NetHASP License Manager matching the name specified in the NetHASP configuration file. |
150 |
No NetHASP License Manager with the assigned name was found (this error is returned by SET_SERVER_BY_NAME). |
151 |
Two or more different NetHASP License Managers with the assigned name were found (this error is returned by SET_SERVER_BY_NAME). |
152 |
The encode operation failed because the service was not supported by the hardware. |
153 |
The decode operation failed because the service was not supported by the hardware. |
155 |
An old version of the License Manager has been found. The API used required a newer version of the License Manager to be installed. |
Comments
0 comments
Article is closed for comments.