# Migrating to Device Farm desktop browser testing from Selenium Grid
Migrating from Selenium Grid

To migrate Selenium test suites in an environment that use Selenium Grid and `RemoteWebDriver`), you must modify your test suite setup procedure. Using the AWS SDK, you request a signed command executor (hub) URL from the Device Farm desktop browser testing API. Then you pass that URL along with your requested capabilities to your `RemoteWebDriver`.

For more information about Selenium Grid, see the [Selenium Grid documentation](https://www.selenium.dev/documentation/grid/).

**To migrate**

1. Run your tests locally to observe and confirm your current test suite behavior. 

1. To use the desktop browser testing feature, you must install and configure the [AWS SDK](https://aws.amazon.com/getting-started/tools-sdks/#SDKs) for the language appropriate for your tests. 

1. Use the console or CLI to create a project:

------
#### [ Console ]

   1. Sign in to the Device Farm console at [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm).

   1. In the navigation pane, choose **Desktop Browser Testing**, and then choose **Projects**.

   1. If you already have a project, under **Desktop browser testing projects**, choose the name of your project.

      Otherwise, to create a new project, choose **New project**. Then, on the **Create Project** page, do the following:

      1. Enter a **Project name**.

      1. (Optional) Enter a project **Description**.

      1. (Optional) Under **Virtual Private Cloud (VPC) Settings**, you can configure your project's VPC peering settings by choosing the **VPC**, its **Subnets**, and its **Security Groups**. For instructions on connecting Device Farm to a VPC, see [Working with Amazon Virtual Private Cloud across Regions](https://docs.aws.amazon.com/devicefarm/latest/developerguide/amazon-vpc-cross-region.html) in the *Device Farm Developer Guide*.

      1. Choose **Create**.

   1. In the project details, note the project's Amazon Resource Name (ARN). It looks like this: `arn:aws:devicefarm:us-west-2:111122223333:testgrid-project:123e4567-e89b-12d3-a456-426655440000`.
**Note**  
For instructions on updating your project configuration, see [Configuring your project to use Amazon VPC endpoints](techref-vpc.md#techref-vpc-configure).

------
#### [ CLI ]

   The following creates a project:

   ```
   aws devicefarm create-test-grid-project --name "Peculiar Things"
   ```

**Note**  
To update your project configuration, see [Configuring your project to use Amazon VPC endpoints](techref-vpc.md#techref-vpc-configure).

------

1. Modify your `RemoteWebDriver` initialization to use the WebDriver endpoint.

------
#### [ Java ]

**Note**  
This example uses JUnit 5 and the AWS SDK for Java 2.x. For more information about the AWS SDK for Java 2.x, see [AWS SDK for Java 2.x API Reference](https://docs.aws.amazon.com/sdk-for-java/latest/reference/). If you are using a different test framework, be aware that `@Before` and `@After` are called before and after each test, respectively.

   ```
   // Import the AWS SDK for Java 2.x Device Farm client:
   import software.amazon.awssdk.regions.Region;
   import software.amazon.awssdk.services.devicefarm.*;
   import software.amazon.awssdk.services.devicefarm.model.*;
   import java.net.URL;
   
   // in your tests ...
   public class MyTests {
     // ... When you set up your test suite
     private static RemoteWebDriver driver;
   
     @Before
     void setUp() {
       String myProjectARN = "arn:aws:devicefarm:us-west-2:111122223333:testgrid-project:123e4567-e89b-12d3-a456-426655440000";
       DeviceFarmClient client  = DeviceFarmClient.builder().region(Region.US_WEST_2).build();
       CreateTestGridUrlRequest request = CreateTestGridUrlRequest.builder()
         .expiresInSeconds(300)
         .projectArn(myProjectARN)
         .build();
       CreateTestGridUrlResponse response = client.createTestGridUrl(request);
       URL testGridUrl = new URL(response.url());
       // You can now pass this URL into RemoteWebDriver.
       WebDriver driver = new RemoteWebDriver(testGridUrl, DesiredCapabilities.firefox());
     }
     
     @After
     void tearDown() {
       // make sure to close your WebDriver:
       driver.quit();
     }
   
   }
   ```

   For more information, see [Migrating a Java test suite to Device Farm](testing-frameworks-java.md).

------
#### [ Python ]

**Important**  
This example is written with the assumption you are using Python 3 with pytest. If you are using another testing framework, see the documentation.

   ```
   # Include boto3, the Python SDK's main package:
   import boto3, pytest
   
   # in your tests:
   # Set up the Device Farm client, get a driver URL:
   class myTestSuite:
     def setup_method(self, method):
       devicefarm_client = boto3.client("devicefarm", region_name="us-west-2")
       testgrid_url_response = devicefarm_client.create_test_grid_url(
         projectArn="arn:aws:devicefarm:us-west-2:111122223333:testgrid-project:123e4567-e89b-12d3-a456-426655440000",
         expiresInSeconds=300)
       self. driver = selenium.webdriver.Remote(testgrid_url_response["url"], selenium.webdriver.DesiredCapabilities.FIREFOX)
   
     # later, make sure to end your WebDriver session:
     def teardown_method(self, method):
       self.driver.quit()
   ```

   For more information, see [Migrating Python tests to Device Farm desktop browser testing](testing-frameworks-python.md).

------

1. Make sure that the environment variables `AWS_ACCESS_KEY` and `AWS_SECRET_KEY` are configured in your testing environment.

1. Run your tests.