RAS Client Test Module
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
The RAS Client test module, RasCliSrv.dll, exercises the Remote Access Service (RAS) client for Windows Embedded CE. The test assesses the following two scenarios:
- RAS connection and disconnection
- Data transfer while connected over the RAS connection
The default behavior of the test is connection and disconnection only. You can turn on data transfer with the -d command line option. Data transfer requires an external server module running on the RAS server to handle incoming data from the client. If you run the server module on the RAS server, you can include data transfer in the test module.
The following table shows RAS connection types that you can assess with this test module.
| Connection type | Description |
|---|---|
Point-to-Point Protocol (PPP) over direct serial cable |
Requires that the client and the server be connected over COM ports by a null modem cable. |
PPP over modem |
Requires special hardware. The client requires a modem and the phone number of the server. The server must accept incoming client requests over a modem. |
PPP over Ethernet (PPPoE) |
Requires that the client be on the same subnet as the server. A common setup is to connect the client and server to the same private hub with Ethernet cables. |
Virtual private network (VPN) over Layer Two Tunneling Protocol (L2TP) |
Might require you to customize the setup. For example, you might need certificates on the client and server in order to successfully connect. |
VPN over Point-to-Point Tunneling Protocol (PPTP) |
Default setting for the client. |
The RAS server should be a desktop computer running, for example, a Windows–based server operating system (OS). You should enable and start RAS services on the server. If you need help setting up the RAS server, refer to the documentation for the OS on the server.
Windows Embedded CE provides the OEMRASServer.exe server module as an additional command line executable. The server module is required only if you include data transfer in the stress module by specifying the -d command line option. The server module spawns two threads — one TCP data server and one UDP data server — that handle all incoming data from the RAS client. If the server module is not running on the server, but the client includes data transfer, then the data transfer must fail gracefully on the client. OEMRASServer.exe does not accept any command-line options.
The default command line for this test is rasclisrv -t PPTP –d off. The following table shows the command line parameters for the RasCliSrv.dll test module.
| Parameter | Description |
|---|---|
-t RAS_type |
Connection type. You can specify one of the following values:
The default value is PPTP. |
-b baud_rate |
Baud rate for a modem or a null modem cable. The default value is 57600. |
-d value |
A value of on specifies that you want to support data transfer. The default value is off. |
-p packet_size |
Size of packet, in bytes, to be sent. This value is ignored if the -d option is set to off. The default value is 1024. |
-n number_of_sends |
Number of packets sent per test iteration. This value is ignored if the -d option is set to off. The default value is 100. |
-s server_address |
Server with which to establish the RAS connection. For VPN tests, specify the server name or address. For modem tests, specify the telephone number. |