Share via


RAS Client Test Module (Windows Embedded CE 6.0)

1/6/2010

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:

  • NULL, for PPP over a direct serial cable connection
  • Modem, for PPP over a modem connection
  • PPPoE
  • L2TP, for VPN over an L2TP-based connection
  • PPTP, for VPN over a PPTP-based connection.

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.

See Also

Other Resources

Test Modules for the Windows Embedded CE Stress Tool