Sentinel Troubleshooting Guide
Sentinel Troubleshooting Guide
Sentinel Troubleshooting Guide
End User Troubleshooting Guide for Sentinel SuperPro, UltraPro & Sentinel Hardware Keys
Page 1 of 27
Revision 1.0
AUTHOR Amit
Page 2 of 27
Revision 1.0
Preface
Welcome to Safenet End User Troubleshooting guide!
This guide is intended to assist our Distributors, Customers and their end-users troubleshoot issues with our Sentinel keys (SuperPro, UltraPro, and Sentinel Hardware Keys). This guide provides in-depth troubleshooting of our Sentinel System Drivers along with troubleshooting both Parallel and USB Sentinel keys. This guide also contains a complete description of our driver installation.
Troubleshooting Tips:
Key Not Found. Blue Screen Of Death (BSOD) / Crash. Driver not loaded correctly. Using key through Remote Desktop or Terminal Server. Port Converters issue Detecting Key in VMWARE
Supported Platforms
Page 3 of 27
Revision 1.0
Part 1
Troubleshooting Tips
Key Not Found Blue Screen Of Death (BSOD) Using Key through Remote Desktop or Terminal Server Port Converters support Drivers Not Loaded Correctly Detecting Key in VMWARE
Page 4 of 27
Revision 1.0
Page 5 of 27
Revision 1.0
NOTE: If you are a developer, please use your Customer Connection Account to search our knowledge base for the latest information/faq/technical tips. If you need assistance please contact Tech-Support for more help and information at support@safenet-inc.com
Page 6 of 27
Revision 1.0
5. If no entries are found, please check the key on a different USB port on this computer and/or check the key on another computer. 6. If there is an (x) mark or (!) mark on Safenet USB SuperPro/UltraPro or Sentinel Hardware Keys icon. Follow the steps to uninstall the driver and reinstall the driver described in page 10. 7. If no marks are displayed, please make sure that the driver is installed properly by running Sentinel Advance Medic, refer to page 7. 8. If you experience any issues with the driver, please uninstall and reinstall the driver. 9. For uninstalling and cleanup, follow the steps described in page 9 & 10.
Page 7 of 27
Revision 1.0
Page 8 of 27
Revision 1.0
Page 9 of 27
Revision 1.0
Page 10 of 27
Revision 1.0
Part 2
Quick Install/Uninstall Diagnostic Utilities Sentinel Advance Medic Monitoring Tool
CleanUp Utility SSDCleanup Driver Installation/Uninstallation How to install/uninstall the driver on Mac and Linux? Parallel Port Settings Port Converters
Page 11 of 27
Revision 1.0
Quick Install/Uninstall
Quick install, please perform the following steps:
1. Log in as Administrator 2. Unplug the key(s). 3. Download and install the latest driver from the link given below: http://www.safenet-inc.com/support/tech/latestdriver.asp NOTE: If you are using Standalone applications, you can do the custom install and uncheck the Server(s) from the installation. The Sentinel Keys Server only needs to be installed on a SHK key server computer. The Sentinel Protection Server only needs to be installed on a SuperPro and/or UltraPro key server computer. 4. Plug in the key(s). 5. Test the application software.
Page 12 of 27
Revision 1.0
Page 13 of 27
Revision 1.0
If the Sentinel Advanced Medic detects the key and your application fails to start, please contact your software vendor for assistance, as issue could be application specific. Otherwise please contact SafeNet Technical Support via e-mail at support@safenetinc.com with the error Sentinel SuperPro Medic/Advanced Medic Shows and log file generated with the SAM.
Page 14 of 27
Revision 1.0
Monitoring Tool
The Monitoring Tool allows you to view and keep track of Sentinel servers on your network. The Monitoring Tool is a convenient way to view and track license activity on your network so that you can analyze application usage. With this tool, you can: View the address and version of each available server View each of the keys connected to available servers View the hard license limit for each key Track how many licenses are currently in use View the highest number of licenses issued by a key Monitor the number of time-outs recorded by the server for clients using licenses from a key
Page 15 of 27
Revision 1.0
Page 16 of 27
Revision 1.0
Page 17 of 27
Revision 1.0
Note: We recommend using the normal driver un-installation (Control Panel Add or Remove Programs) for our drivers. SSDCleanUp might remove your Sentinel protected software application and other Sentinel SDK installation. Therefore, SSDCleanUp should be used as the last option for driver uninstall.
1. Use the link below to download the SSDCleanUp utility. http://www.safenet-inc.com/support/tech/sentinel.asp 2. Reboot the system. Following is the screenshot from Sentinel Advance Medic:
Page 18 of 27
Revision 1.0
Driver Installation/Uninstallation
Steps for installing the Sentinel Drivers:1. Please make sure that the key(s) is /are unplugged. 2. Download the latest Sentinel Protection Installer from the link:
NOTE: If you are using Standalone applications, you can do a custom install by unchecking the Servers from the installation.
4. The Sentinel Keys Server only needs to be installed on a SHK key server computer. The Sentinel Protection Server only needs to be installed on a SuperPro and/or UltraPro key server computer. 5. Click Next to proceed with the installation.
Page 19 of 27
Revision 1.0
6. When installation is finished, restart your machine if required, then connect your Key.
Try to find the key with Sentinel SuperPro Medic and Sentinel Advanced Medic, as explained earlier in this document.
Steps for uninstalling the Sentinel Protection Installer:For (32-bit and 64-bit) Windows 2000 SP4, XP SP2, Server 2003, and Vista
1. Unplug the key(s) 2. Uninstall the Sentinel Protection Installer/Sentinel Keys Protection Installer. To uninstall the Sentinel Protection Installer: a. Go to "Add/Remove Programs" (Vista is Programs and Features) from the Control Panel via Start -> Settings -> Control Panel -> Add/Remove Programs or Programs and Features b. Find the "Sentinel System Driver", Sentinel Protection Installer, or Sentinel Keys Protection Installer from the list and remove the item(s).
Page 20 of 27
Revision 1.0
c. However, if you do not see the "Sentinel System Driver" or Sentinel Protection Installer or Sentinel Keys Protection Installer on the list, move to Step 4. Otherwise go to step 6. 3. Manually delete the "Sentinel.sys" and "sntnlusb.sys", or skeysusb.sys, or Sentinel64.sys and sntusb64.sys files. 4. To delete the "Sentinel.sys", "sntnlusb.sys" and skeysusb.sys files: a. Open the Windows Explorer. b. Go to (for Win 2000) C:\winnt\system32\drivers\ or for (32-bit) Win XP/Server 2003/Vista, C:\Windows\system32\drivers c. Find "Sentinel.sys", "sntnlusb.sys" and skeysusb.sys from the list of files. d. Right Click on the file, and choose delete. Click "Yes" when asked for the confirmation. 5.To delete the "Sentinel64.sys" and "sntusb64.sys" files: a. Open the Windows Explorer. b. Go to C:\Windows\system32\drivers for (64-bit) Win XP/Server 2003/Vista. c. Find "Sentinel64.sys" and "sntusb64.sys" from the list of files. d. Right Click on the file(s), and choose delete. Click "Yes" when asked for the confirmation. 6. To delete the server and driver files: a. Open the Windows Explorer. b. Go to C:\Program Files\Common Files\SafeNet Sentinel. c. Delete the following directories: Sentinel System Driver Sentinel Protection Server Sentinel Keys Server
Page 21 of 27
Revision 1.0
Uninstallation:
1. Run the script protection_unstall.sh on the computer where you will be attaching your Sentinel key. It will show you the following options 0 (Exit), 1 Uninstall only driver, or 2 uninstall both Sentinel Protection Server and SUD7.1.1. 2. Select the required option Uninstall using the RPM Commands Use the rpm -e sntl-sud-7.1.1-0.i386.rpm command to uninstall the parallel port driver and USB daemon. Use the rpm -e sntl-server-7.1.0-0.i386.rpm command to uninstall the Sentinel Protection Server.
Page 22 of 27
Revision 1.0
Uninstallation: FrameWork
The Sentinel.Framework is a driver framework. This framework is copied or installed in the path: /Library/Frameworks Simply delete this framework from the above path.
Installation: .kext
Double click the package to install the new driver. The installer will install the Sentinel.kext in /System/Library/Extentions folder
Uninstallation: .kext If Sentinel.Kext is installed on your machine, remove it using following instructions: $ Change directory to /System/Library/Extensions folder $ sudo kextunload -v Sentinel.kext $ sudo rm -f Sentinel.kext
Page 23 of 27
Revision 1.0
Port Converters
Sorry USB to Parallel adaptors/converters are not supported as they do not provide a "physical address" (i.e. 378) within Windows. Therefore our drivers can not communicate with the keys. In order to add a Parallel port on laptops, the solution is to use a Parallel PCMCIA cardbus. You can, for instance, use the card Quatech SPP-100. See details : http://www.quatech.com/catalog/parallel_pcmcia.php or the SUNIX card See details : http://www.sunix.com.tw/it/en/Product_Detail.php?cate=2&class_a_id=23&sid=539 In order to add a Parallel port on PC Desktop, the solution is to use a Parallel PCI card. You can, for instance, use one of these cards: "70583" PCI (32 Bit) Parallel Card, 2 Ports Parallel ECP/EPP See details : http://www.lindy.com/int/productfolder/07/70583/index.php "70582" PCI (32 Bit) Parallel Card, 1 Port Parallel ECP/EPP See details : http://www.lindy.com/int/productfolder/07/70582/index.php
Page 24 of 27
Revision 1.0
For many adapters the port address is shown under the resources of the Multi-IO adapter and not under LPT ports. The value circled in red in the Parallel PCI Card properties page above is the address used by the parallel port. Perform the following steps to configure the Sentinel System Driver to use the port address: 1. Install the Sentinel System Driver. 2. Start the driver configuration utility, SetupSysDriver.exe. It is usually located at C:\Program
Page 25 of 27
Revision 1.0
3. Click the "Configure Driver" button, as can be seen in the picture above. 4. The following dialog will be displayed. Click the "Add" button.
5. The following dialog will be displayed. Enter the I/O address of the PCI parallel port adapter into the "Bus Address" field.
6. Click on OK. It will show that a User Created port has been added at address 1088. 7. Click the OK button to close the dialog and then open the File menu and choose Exit to close the Sentinel System Driver Configuration Utility. The Sentinel System Driver should now be configured to use the Parallel PCI adapter.
Page 26 of 27
Revision 1.0
Supported but with different driver versions depending on kernel versions
Not Supported
Windows Vista 32 bit Windows XP SP1 and Server 2003 (64 bit) Windows XP SP2 and Server 2003 (32 bit) Windows 2000 SP4 Windows NT Windows 98/ME Windows 95 Linux RedHat/SUSE
Only SuperPro
Not Supported
Page 27 of 27