Test agent setup for Windows X86 iPhone

For iOS-Windows agent, the following 2 tools need to be installed

1. Install iTunes on Microsoft store (The iOS devices need to connected to iTunes and set as a trusted device).
2. Install tidevice: pip3 install -U "tidevice[openssl]"
3. We also provide a script named as installer-iOS.ps1 for iOS-Windows agent. installer.zip

Setup Hydra Lab Agent on Windows(X86/X64)

1. Download the application.yml following the Guideline: Download the agent configuration.

2. Create a new folder in you PC.

3. Download the latest agent.jar or build the agent project as agent.jar. Then, copy the file to the folder. To build the agent, run the following command in the project root dir:

gradlew :agent:bootJar

4. Unzip HydraLab_Agent_Installer_Windows.zip to the folder, the folder shows like this picture.

5. Download application.yml from portal (a sample configuration is available here: sample YAML config)

• app.registry.server
  • The hostname + port of the center server. For instance, if it's running on a machine with the hostname of testagent.hydralab.com and servicing on port 9886, then this value should be "testagent.hydralab.com:9886".
• app.registry.id
• app.registry.secret
• app.registry.name
• app.registry.agent-type (An int value to indicate the type of test devices for Testing)
  • Value 1 represents WINDOWS PC + n * ANDROID devices -> For Android test agent.
  • Value 2 represents WINDOWS PC + 1 * ANDROID device, support running Appium Test case on Windows -> For Windows-Android cross-platform agent.
  • Value 3 represents WINDOWS/MAC PC + n * iOS devices -> For iOS test agent.
• management.metrics.export.prometheus.pushgateway.enabled (Optional; If true, will send metrics to our stability monitor. When an exception happens, we will receive emails.)

Start/Stop Hydra Lab Agent

1. Android or iOS agent

1. Setup log file location: modify AgentService.xml and replace {LOG_FILE_LOCATION}

2. Install it as a Windows Service: open cmd/powershell (admin), execute command : .\AgentService.exe install

3. Open Windows Services and find a service named Hydra Lab Agent Service.

4. You can start/stop the service.

5. If it starts successfully, the agent will show up in HydraLab center portal. BTW, only the agent connected with devices will be displayed on the page.