Friday, February 19, 2010

UBS Dongle Installation and common lock errors


Contents



1. UBS 9.2 Standalone Installation

2. UBS 9.2 Multi-user Installation - on the server

- on the workstation

3. Common Reason for License Detection Failure

4. Windows Firewall Setting for Version 9.2

5. About other Firewalls

6. FAQ


1. UBS 9.2 Standalone Installation
1.1. Insert UBS Installation CD and install the required UBS software.
1.2. To detect the license, plug in the USB key (Blue colour) onto the computer. Start UBS, and at the Select Company menu, click on Setting to enter SmartLock Setting menu.
1.3. Select USB key.
1.4. Click Ok and you are done.
2. UBS 9.2 Multi-user Installation
On the Server
2.1. Start by installing the required UBS software in the Server. 2.2. Plug in the USB key LAN (Green colour) onto the computer.
2.3. Start UBS. For Window Vista, remember to right-click the UBS icon and select Run as
Administrator. This is for the purpose of registering the USB key only, you don't need to run UBS
as administrator for normal use.
2.4. At Select Companymenu, click on Setting to enter SmartLockSetting menu. 2.5. Select USB key for LAN, and select the computer's operating system. 2.6. You need to register the USB key:
· Window XP/2000/2003/Vista - Tick USB LAN RegistrationVersion 1.0
· Windows 98/ME - Tick Add usbserver2k.exe to the Startup Group. 2.7. Most new products have no built-in function to register SmartLock. You can manually run
USBLanReg.EXE to register. These files can be found under the Networkfolder on UBS program
folder.
2.8. Go into UBS program folder, then into network folder and run the application SetIPAddr8USBLAN.exe.
2.9. Key in the IP address of this computer, then click OK. It is strongly recommended that the Server be assigned a static or fixed IP address. Do not use automatic IP address or DHCP address to avoid problems in the future.
2.10. Restart the PC, or start the UBS LAN service, Usblan_ldr.
2.11. For Windows XP SP2 and Vista, be sure to create exception in the firewall for the smartlock service or turn off the firewall.

2.12. Share the UBS folder:
Generally, the whole UBS folder must be shared with Full Control. Under My Computer or Windows Explorer, look for the USB folder (e.g. ubsacc9O, ubswpay9O). Right-Click the UBS folder and select Sharing and Security.
There are 3 interfaces of file sharing:
a. Simple File Sharing (Window XP Home / Pro)
Make sure you tick both Share this folder on the network and Allow network users to change my files.
b. Advance File Sharing (Window XP Pro, Server 2000/2003)
Make sure to select Maximum allowed. Click Permissions, then highlight Everyone, then tick Full Control. Then Apply.
Go to Security, then highlight Everyone, then tick FullControl. Then Apply.
Note: If Everyone does not exist, then click Addand type in Everyone.
C. Vista File Sharing (Window Vista)
Select Guestfrom the pull down menu, click Add. Highlight Guestin the list, and then set the Permission Levelto Contributor. Click Share to finish.
If Guest is not available for select, click on the Networkand Sharing Center link. Select Turn off password protected sharing under Password protected sharing. Click Apply.
Once the folder is shared, you will see an icon on the folder as below:
2.13. Go into UBS. Under Select Companyscreen, add a new company, select it and let it generate the data.
2.14. Go back to the Select Companyscreen, and change the Directory to the format of
\\servername\ubs program folder\data folder. e.g. \\PC1\ubsacc9O\data
2.15. Another way to determine the network directory is to use My Network Places to browse to the server and to the UBS data folder, then copy the address and paste into UBS.
2.16. Under Select Company screen, click Setting, then tick Country Setting. Change the Standard Report Directory into a network path.
e. g.
C:\UBSSTK9O\REPORTS\REPORTS_TIMES_NEW_ROMAN\
change to:
\\servername\UBSSTK9O\REPORTS\REPORTS_TIMES_NEW_ROMAN\
On the Workstation:
There are 2 methods:
2.17. Method 1 - Run from server shortcut:
Install UBS on the workstation. Then through the network, browse to the server, look for UBS folder, right-click the UBS executable file e.g. Daccount.exe and select Create Shortcut. Copy this shortcut and paste onto the desktop.
2.18. Method 2 - Run from local program:
Install UBS on the workstation. Start UBS on the workstation. Then under Select Company screen, add the company and directory following the one already created in the server. Also, change the Standard Report Directoryfollowing the directory on the server.
2.19. Either way, you have to into UBS program folder, then into network folder and run the application SetIPAddr_USBLAN.exe. This time key in the IP address of the Server, which is the PC which have the USB key plugged in. So UBS will directly contact this IP address to detect the license.
3. Common Reasons For License Detection Failure
3.1. Windows is unable to detect the USB Key.
Go to Device Manager (Right-Click on My Computer-'Hardware-'Device Manager). If the USB key is detected, it will show under Human Interface Devices. For each key detected, a pair of entries with the name HID-compliant Device and USB Human Interface Device will appear. That means if there is 3 USB keys, you should see 3 pairs of HID-compliant Devices and USB Human Interface Device. If not, unplug the USB keys, and plug in again to let Windows detect it again. If you have multiple USB keys, plug it in one by one slowly. Too fast will caused detection failure.
For Windows 98/ME, you must install the related driver for USB Human Interface Device. (Windows will prompt you for installation, and might require you to insert the Windows Installation CD.)
3.2. Server's IP address not set or wrong (Multi-user only)
You did not run SetIPAddr JUSBLA~.exe to set the Server's IP address, or you entered the wrong IP address. Try running the program and enter the Server's IP address again.
3.3. Did not run USB LAN Registration on Server (Multi-user only)
Refer to 2.4 of UBS 9.2 Multi-user Installation.
3.4. Problems with USBLAN_LDR service (Multi-user only)
This service will appear after you have run USB LAN Registration. Go to Control Panel-> AdministrativeTools -> Services, look for USBLAN_Ldr. Make sure the Status is Started. If not, right-click the service and select Start. Also, try to restart the service by right-click the service and select Restart.
3.5. Blocked by Firewall (Multi-user only)
Windows XP Service Pack 2 and Windows Vista comes with built-in firewall. Make sure to create exceptions for UBS program and service, or turn off the firewall. Refer to 4. Windows Firewall Setting forVersion 9.2 for step-by-step guide.
Also check for third-party firewalls especially those bundled with antivirus software suites. Example is McAfee Antivirus and Norton Antivirus.
3.6. Network is not connected (Multi-user only)
Network needs to be connected and running to detect the multi-user licence.
4. Windows Firewall Setting for Version 9.2
4.1. The main objective is to give permission for the USB key service to run. The files involved is usbserver2k.exe and usblan_ldr.exe.
1. First make sure you have registered the USB key in UBS.
2. Control panel -> Administrative tools -> Services
3. Look for the service name USBLAN_Ldr
4. Right-click ->properties, take note of the 'Path to Executable' E.g.
C:\UBSACC9O\NETWORK\USB\USBLAN_Ldr.EXE
5. Control panel -> Windows firewall
6. Select Exceptions, click Add program
7. Click Browse, browse to the directory as specified in the 'Path to Executable' E.g.
C:\UBSACC9O\NETWORK\USB
8. Select usblan_ldr.exe, OK
9. Usblan_ldr.exe will be in the list of Exceptions.
10. Repeat steps 6 to 8, this time select usbserver2k.exe. For Windows Vista select usbserver.exe
11. Usbserver2k.exe or usbserver.exe will be in the list of Exceptions.
5. About other Firewalls
Symantec Norton Antivirus:
-Look for an option called Internet Worm Protection. This is actually a firewall. Use Program Control to
give permission to UBS programs and service, or disable the Internet Worm Protection.
McAfee Antivirus:-Look for an option called Personal Firewall. Then look for an option for Internet Programs, give Full Access to UBS programs and service, or disable the Personal Firewall.
6. FAQ
6.1. Comparison Chart between 9.2 USB, 9.0 USB and Smartlock Multi-user dongle
Feature
9.2 USB
9.0 USB
Smartlock


Plug 2 or more dongles on the same PC
9.2 USB /9.0 USB /Smartlock
Yes / Yes but with conditions /No



Plug 2 or more dongles on different PCs
9.2 USB /9.0 USB /Smartlock
Yes /No /No


Supports add-on cards and hubs for extra ports
9.2 USB /9.0 USB /Smartlock
Yes /Yes /No, only support built-in port


Combine locks (2-in-1)
9.2 USB /9.0 USB /Smartlock
No /Yes /Yes


Plug and Play for standalone version (WinXP and above)
9.2 USB /9.0 USB /Smartlock
Yes /Yes but need to select correct DLL /No

6.2. I plan to use Account, Stock and Payroll 9.2 multi-user version in my company. Can I put the Payroll dongle in the HR Department server, Account and Stock in the Accounts Department server?

Can. Use SetIPAddr_USBLAN tool to set the IP address of the workstations to their respective server. Set the workstations using Payroll to the HR Dept. server's IP, the workstations using Account and Stock to the Accounts Dept. server's IP.

6.3. Referring to FAQ 6.2, if I am the boss, can I use all 3 Account, Stock and Payroll, from my own PC?

No. You can either use Account and Stock, or Payroll only. Because SetIPAddr_USBLAN tool can only set 1 IP address. So you can either set it to detect the license at the Accounts Dept. server, or at the HR dept. server. There are 3 solution to this:
1) Put all 3 USB dongles in one server
2) You can still use UBS under demo version for limited functions like viewing reports. 3) Use SetIPAddr_USBLAN each time to reset the IP address to the appropriate server before using UBS.

6.4. Can 9.2 USB dongle use for version 9.1 and below?

No. Version 9.2 dongles can only be used for version 9.2 only. You can maintain the 9.1 dongle if you wish to maintain the old versions.

6.5. How to detect smartlock LAN or USB key LAN on a standalone Window XP PC without connecting to a network?

You need to install a Microsoft Loopback Adapter to create a virtual network. The Steps:
1) Go to Control Panel,AddHardware.
2) Click Next, select Yes, Ihave already connected the hardware, click Next
3) Scroll down the list to the end, then select Adda new hardware device.
4) Select Installthe hardware that I manually select form the list (Advanced/, click Next.
5) Scroll down the list to select NetworkAdapters.
6) The manufacturer is MicrosoAt, select the device MicrosoAtLoopbackAdapter.
7) Next, Next, Finish. Now the Microsoft Loopback Adapter is installed. You can check at Control Panel-'Network Connections, you will see a new LocalArea Network Connection icon.
8) The next step is to set IPAddress for this network adapter. Right-click this new Local Area Network Connection icon, select Properties.
9) Key in the IP address and subnet mask. Example:
· IP address: 192.168.5.10
· Network mask: 255.255.255.0
10) Disable the original Local Area Connection. Right-click the original Local Area Network Connection icon, select Disable.
11) UBS smartlock LAN and USB key LAN driver will now accept this to be a valid network, and will allow the smartlock to be detected.
If you want to connect this PC back to a network environment, disable the Microsoft Loopback Adapter, and enable the original Local Area Network Connection.

6.6. Limitation on networking for Window XP as a UBS server.

Window XP has limitation on how many connections it can accept at one time.
- Window XP Professional - 10 connections only
- Window XP Home - 5 connections only
Most of the times you can assume 1 PC = 1 connection. So XP Pro can connect to 10 PCs at one time, XP Home can only connect to 5 PCs. But sometimes 1 PC can take 2 connections, so it will lower the number of PCs the server can connect. To overcome the limitation, you should use Windows Server edition.

6.7. UBS program failed to start with the error message "Cannot Locate The
MicrosoAt Visual FoxPro Support Library"

Solution 1: Reinstall the UBS program into this PC (must use the same version date.)
Solution 2: Browse the UBS CD, go to ubs-'Network-'Vfp. There are 3 VFP (Visual Fox Pro) zip files:
- Vfp50 (for version 8.x),
- Vfp70 (for version 9.2 Account and Stock, version 9.0, year 2004 and before) - Vfp80 (for version 9.0, end of 2004 till 2005, version 9.1 and version 9.2). Unzip the correct file, run Setup.exe to install the Visual Fox Pro Library files

6.8. How to solve when Control Panel -.> Add or Remove Program failed to uninstall UBS Program?

Go to Start-'Run, type Regedit, click on O~. Look for the entries under -
HKEY_LOCAL_MACHINE ISoftware IMicrosoft IWindows ICurrentVersion IUninstall.
Click on each folder and check the Product Name. When you found the product you want to uninstall, delete the whole folder. Exit the Registry and restart the PC.

6.9. Error encountered: 'Cannot update the cursor' was prompted when logging into UBS, or when trying to do transactions and saving.
This message means UBS could not update the required files. It's caused by incorrect file sharing and the database files were set to read-only. The solution: Make sure the UBS folder is shared with the correct permissions. Refer to the file sharing section 2.12.

6.10. When double click on shortcut button of UBS system, message prompted: Resource File version mismatch. After click on 'OK' button, another message
prompted: Visual Foxpro cannot start. Could not load resources.
Go to UBS system program folder, delete the foxuser.dbf and foxuser.ftp file. These two fiels will auto generate when you start UBS.

6.11. Steps to detect smartlock and USB key for version 9.1 and below on Window Vista?
Smartlock Standalone:

a) Right-Click the UBS shortcut and select Run as Administrator.
b) Go to smartlock setting and register the smartlock as usual. Select the OS as Window XP or Window 2000
c) For version 8.x which does not have the option to register the smartlock, you will need to copy the files over from the UBS CD, under \ubs\network\WinXp\SL. (This step is same with what you do for detecting 8.1/8.2 under WinXP)

USB Key Standalone:
a) Just plug in the USB key and select the correct DLL. Nothing extra needs to be done under Vista.

Smartlock LAN:
a) Insert the UBS CD (must be year 2006 or later)
b) Go to browse CD. Look under\Ubs\Network\win2003server\. You should see a folder win2003service. If this folder does not exist, extract it from the zip file win2k3svr.zip. Copy this folder into UBS program network folder.
c) Right-click the file InstallReg.exe and select Run as Administrator.
d) Select Smartlock NetPro, then click Register. Close the program after complete.
e) Inside the same folder, rename the file SLLPROSV2K.exe to SLLPROSV.exe.
f) Set permissions for Windows Firewall. (same steps as Win XP, except select SLLPROSV instead of SLLP2KP)
g) Start the SLLPRONT_LDR service or restart the PC.

USB key LAN:
a. Right-Click the UBS shortcut and select Run as Administrator.
b. Go to smartlock setting and register the USB key LAN as usual. Select the OS as Window XP.
c. Go under UBS program folder, the browse to the network\usb folder, if not exist, just go under networkfolder.
d. Rename usbserver2k.exe to usbserver.exe
e. Set permissions for Windows Firewall. (same steps as Win XP, except select usbserver.exe instead of usbserver2k.exe)
f. Start the USBLAN_LDR service or restart the PC.


Hope These will help, Like it did when I first got problem with UBS Installation.