Configure Automated Test Framework (ATF) for Headless Browser in Microsoft Windows

Step 7 in the Microsoft Windows setup for the ServiceNow® Headless Browser for ATF: Configure ATF with properties.

Before you begin

Complete Step 6: Set up instance for Headless Browser in Microsoft Windows

Role required: admin on your ServiceNow instance and local administrator on the host machine.

Now that your connection and authentication are set up, you will configure ATF with several properties so that it can start containers successfully on the host machine.

Procedure

  1. In your instance, navigate to ATF > Administration > Properties.
  2. Enable the top two properties: Enable test/test suite execution and Enable scheduled test suite execution.
    Top two properties enabled in ATF Administration section
  3. Scroll down to the Headless Runner Properties section.
  4. Enable the top check box.
    Top check box enabled in Headless Runner Properties section
  5. Enter the following values in the Headless Runner Properties form:
    Form Label Property Name Value to Imput

    The user account used to login from the headless Client Test Runner and begin the tests

    		 sn_atf.headless.username Username of the integration user that you created in Add secrets to Docker for Headless Browser setup in Microsoft Windows

    The Docker secret ID that has the password stored of the user account

    		 sn_atf.headless.secret_id Docker “secret ID” that you obtained earlier, as well as the Docker secret name that you created in Step 2 of the Add secrets to Docker for Headless Browser setup in Microsoft Windows procedure.
    The Docker image that is used for headless Client Test Runner sn_atf.headless.docker_image_name Image name with tag that you downloaded: ghcr.io/servicenow/atf-headless-runner:<tagname>
    Note: If you forgot the secret ID, go to Windows host and run the command docker secret list.
  6. At the The absolute path of the secret file on a docker container field, enter: C:\ProgramData\Docker\secrets\<YOUR SECRET NAME>
  7. Leave the rest of the fields as they are.
  8. Select Save.