Summary Agent and probe introduction... 2 Parameters of connection on Windows... 4 Parameters of connection to the test center on Windows... 4 Start and stop an agent or probe on Windows... 5 Start and stop an agent on Linux... 6 Start/Stop a probe on Linux... 7 Open external IDE... 8 Author: Denis Machard Date: 10/09/2015 Version: 1.3 1
Agent and probe introduction Agent or probes are used to communicate remotely with the system under test (SUT and are controlled by the test center. Agents or probseare configured automatically to start on boot of the computer. One agent or one probe can be deployed on Windows or Linux. The agent or probe use the port tcp/443 to communicate with the test center over the following protocols: WebSocket and HTTPS. Agent or probes must be registered to the test center, the name must be unique. Message sent from the test center to agent: «Init» : initialization message «Notify» : notification message «Reset» : reset message Messages sent from agent to the test center: «Error» : error message «Data» : data message «Notify» : notification message Available agents: «dummy» : agent for example only «socket» : communicate on network over TCP/UDP and SSL «ftp» : communicate with ftp server «sikulix» : integration of the «Sikuli» project: www.sikuli.org «selenium» : integration of the «Selenium» project: www.seleniumhq.org «soapui» : integration of the «SoapUI» project: www.soapui.org «command» : execute system commands «file» : read file on system «command» : execute system commands gateway-sms : send or received texto 2
Commands sent from the test center to the probe: «Start» : start a probe «Stop» : stop a probe All type of probes available: «dummy» : example «textual» : tailf on text file «network» : network probe «file» : files collect 3
Parameters of connection on Windows 1. Set the name of the agent or probe, this name must be unique 2. Select the agent or probe type to start 3. Set a small description, it s optional. All agent or probes types availables Parameters of connection to the test center on Windows 1. Set the address of your test center 2. Check the following option «Use a HTTPS proxy server» if a proxy is needed. 4
Start and stop an agent or probe on Windows Click on the button «Deploy» to start an agent or the probe. The registration is automatic. The result of the registration is displayed on the logs viewer. A new tab appears with the name of the agent or probe. You can click on the button Terminate to stop it. 5
Start and stop an agent on Linux 1. Run the script «./toolagent» to start one agent from the command line #./toolagent Command line agent launcher Usage:./agent [test-server-ip] [test-server-port] [ssl-support] [dummy socket ftp sikuli selenium soapui command file] [agent-name] [agentdescription] [[proxy-ip] [proxy-port]] * Server parameters [test-server-ip]: your test server ip or hostname. This option is mandatory. [test-server-port]: your test server port. This option is mandatory. [ssl-support=true/false]: ssl support. This option is mandatory. * Agents parameters [Values expected: dummy socket ftp sikuli command file]: agent type to start. This option is mandatory. [agent-name]: The agent name. This option is mandatory. [agent-description]: The agent description. This option is mandatory. * Proxy parameters [proxy-ip]: proxy address. This option is optional. [proxy-port]: proxy port. This option is optional. 6
Start/Stop a probe on Linux 1. Run the script«./toolprobe» to start a probe from Linux #./toolprobe Command line probe launcher Usage:./probe [test-server-ip] [test-server-port] [ssl-support] [dummy textual network file] [probe-name] [probe-description] [[proxy-ip] [proxy-port]] * Server parameters [test-server-ip]: your test server ip or hostname. This option is mandatory. [test-server-port]: your test server port. This option is mandatory. [ssl-support=true/false]: ssl support. This option is mandatory. * Probes parameters [Values expected: dummy textual network file]: probe type to start. This option is mandatory. [probe-name]: The probe name. This option is mandatory. [probe-description]: The probe description. This option is mandatory. * Proxy parameters [proxy-ip]: proxy address. This option is optional. [proxy-port]: proxy port. This option is optional. 7
Open external IDE 1. Select the type agent Sikuli or SoapUI on the combo list 2. Click on the button Open IDE to open the external IDE 8