Pre-check utility tool for self-hosted deployment

The pre-check utility tool verifies that your environment meets all necessary requirements before deploying a self-hosted BrowserStack grid. By proactively checking configurations, the tool helps you avoid common setup issues and reduces the troubleshooting time associated with grid deployment. Additionally, the tool generates a detailed validation report to simplify communication with our support teams, streamlining the debugging process.

Use the pre-check utility

Execute the pre-check utility through your command-line interface (CLI). You have two options to perform the pre-check:

1. Using cloud parameters
2. Using grid profile

Using cloud parameters

Run the following command in your terminal, specifying your cloud provider, cluster name, and region:

npx browserstack-cli ats pre-check grid --cloud-provider 'azure' --cluster-name 'samplecluster' --region 'centralindia'

Using grid profile

If you have a predefined grid profile, run the following command instead:

npx browserstack-cli ats pre-check grid --grid-profile 'samplegridprofile'

Pre-check validations

The pre-check utility performs critical validations to ensure your system’s readiness:

• CLI tool installation: Checks that all required command-line tools are installed.

• User permissions: Validates that the current user has the necessary permissions for grid creation.

• BrowserStack endpoint access: Confirms connectivity to required BrowserStack services and endpoints.

• SSL configuration: Ensures secure SSL configurations are correctly implemented.

These validations help quickly pinpoint and rectify potential setup issues, ensuring a smooth and efficient grid deployment.

Validation report

After completion, the pre-check utility generates a comprehensive log report detailing validation results. The report clearly identifies misconfigurations, provides recommended fixes, and is saved locally for easy reference and future troubleshooting.

To facilitate faster support, you can share this validation report with BrowserStack’s support team, ensuring efficient issue resolution.

By using the pre-check utility, you can prepare your environment for successful BrowserStack grid deployment. The proactive validations and detailed reporting ensure you identify and resolve issues early, enabling a smooth, reliable, and secure deployment experience.