|
|
|
| Get started with SocketPro
A unique framework implemented with batching, asynchrony and parallel computation with online compressing
1. Video Tutorial for Getting Started With SocketPro We have prepared a set of video tutorials to help you quickly get started with SocketPro. Most of video tutorials come with sample projects with simple code for your study. 2. Requirements for client and server First of all, make sure that MS dotNet framework version 2 or later is installed at both client and server machines and runs properly because some of client and server samples are written from dotNet platform enabled languages. Note that you can skip installing dotNet framework if you do not do any dotNet development. 3. Setups for SocketProAdapter If your development language is C/C++, make sure that your development environment includes the directory, ..\include. You may also meet compiling problem with the class CUQueue. If it happens, please install a Microsoft platform SDK no earlier than 2001 and your development environment use the SDK instead. At this time, you can use VC++ 6 and Borland C++ builder 5 or later to develop your C/C++ applications. You may need to add the source file sprowrap.cpp into your project for use of SocketProAdapter. If your development is based on .NET, you need to add both SocketProAdapter (SProAdapter.dll) and usocket.dll in the directory ..\bin into your client and server projects. 4. Play with tutorials At this time, SocketPro package is added with a set of tutorial projects for C++, C# and VB.NET. These tutorials comes with detailed step-by-step guides inside the directory ..\tutorials, which are very helpful for you to get started with SocketPro. 5. Setups for extra sample servers Inside the directory of ..\bin\, you will find one sample server named as RemoteConnector.exe. The server is a window NT service. After installing SocketPro, you need to manually install it by executing the following command from DOS command at the directory C:\Program Files\UDAParts\SocketPro\bin: remoteconnector /install (or uninstall for de-install) For the sake of security, SocketPro installer program doesn't automatically configure remote window file service for you. However, you can configure it by yourself as below. First, go to registry HKEY_LOCAL_MACHINE\SOFTWARE\UDAParts\SocketPro\REMOTECONNECTOR\PlugIns\, and create a new sub key Module3. Under the key Module3, create one string value (Location) and set its value to ufilesvr.dll. Also, create a DWORD value (Param) and set it to 0. After restarting it, RemoteConnector will dynamically load the library and process all of win32 file management requests as shown in the following Figure. RemoteConnector also comes with a simple MS Access database file containing data such as user ID, password, service ID and granted services for each of user. It is easy for you to understand that RemoteConnector use the database to control accessing from different clients with credentials. Open the database file and see what it has. RemoteConnector comes with the C++ source code. See it inside the directory ..\samples\others\server\RemoteConnector\. 6. Window 64bit platforms Beginning from version 5, SocketPro supports MS 64bit window platforms. However, all of samples are default to win 32bit developments. You need to manually register two COM dlls, UDB.dll and npUSocket.dll at the directory ..\udaparts\socketpro\bin\x64 on your client machines with CMD shell plus administrator account by executing the following statements.
regsvr32 npUSocket.dll Note that you can register BOTH 32bit and 64bit versions of COM dlls at the same time with the same machine without any problem. Also, you should distribute two non-COM dll, uodbsvr.dll and usktpror.dll at the directory ..\udaparts\socketpro\bin\x64 into your window system32 (for 64bit dlls) directory. If your development environment is .NET, you need to reference SProAdapter.dll at the directory ..\udaparts\socketpro\bin\x64 instead. Alternatively, to simplify your .NET development, you can install both 32bit and 64bit versions of SProAdapter.dll into .NET global assembly cache by use of .NET utility tool gacutil.exe, which is usally located at the directory C:\Program Files\Microsoft Visual Studio 8 (9)\SDK\v2.0\Bin. In case you meet the problem that your application is not able to load the file SProAdapter.dll for a client machine, you need to install Microsoft visual C++ 2005 redistributable file SP1 here. 7. USocket.dll registration on devices You can download the visual registration tool here (regsvr.zip) to register USocket.dll on devices. The tool is originally listed at the site http://windowsmobiledn.com/how-can-i-register-com-dll-on-pocket-pc/ 8. Others The SocketPro package contains a lot of traditional VB6 samples. If you are using VB.Net, you simply use Visual studio.net tool to convert them to VB.net code samples. Without registering SocketPro, a SocketPro server supports two socket sessions for free only. Otherwise, a SocketPro server will prompt a message to ask you for registering SocketPro. If so, simply click the message box and the SocketPro server will continue to run. After registering SocketPro by getting a proper key to unlock it, the message box will never appear again, no matter how many socket sessions are established. |
