Manual setup can be used for situations where the target system may not have a desktop UI. Follow the steps here to manually download and set up the local agent.
- Navigate to Resources > Local Agents on ACCELQ application. Click on the "Download" button and select the "Manual Setup" link. You are presented with the step-by-step instructions as displayed below.
- Download the zip file and unzip it to a preferred location. (Preferably unzip it in your root drive). Make sure there are no spaces in the folder name path.
- In ACCELQ application, Navigate to Resources > Local Agents and click on the link “Click to generate” in step 3.
- In the Configure Agent Properties modal:
Agent Name: Provide a unique name for this agent, so you can recognize this agent during test execution. Do remember only alpha-numeric and underscore characters are allowed, space is not allowed in the Agent name.
Agent Type: Indicates the scope or visibility of the Agent. The agent visibility can be set at User (only you can view the agent), Project (all the users assigned to the project can access the agent), or Tenant level (all users across all projects can access the Agent). When you are using Project type, you can select one or more Projects to which this Agent should be available.
Concurrent Jobs Count: Indicates the maximum number of concurrent jobs this Agent can accept. If the count of jobs exceeds the threshold then the subsequent jobs will be queued up for execution.
Parallel Test Cases per Job: If you choose to run in parallel mode, multiple Test Cases can run simultaneously.
- On ACCELQ, click on the “Generate” button in the Configure Agent Properties modal.
- Download the Agent Properties file or you can also copy the configuration to the clipboard.
- Navigate to the location in your machine where you have unzipped the Local Agent Folder. Open the folder, the folder should have these files:
- Replace the “agent.properties” file with the new Agent Properties file that you have downloaded.
- Start the Agent by executing the shell script in the Agent folder. The file name should be “start_agent_windows.bat” (or, in the case of Linux it should be “start_agent_linux.sh”).
- Navigate to Resources > Local Agents on ACCELQ application (click on the tab once again, to refresh). You should see your configured Local Agent listed in the grid.
- Congratulations !!!, you can now use the Local Agent when running a test.
If there are any issues setting up and configuring Local Agent you can read more here on how to troubleshoot.