ANT Licensing
Provar supports using a relative ANT licensing path and an absolute one. This aids in running Provar within cloud-based Continuous Integration & Continuous Deployment tools where the full file specification isn’t always static and if you have a mix of environments (e.g., MS Windows, Mac OS, Linux) sharing the same Provar build.xml file.
This page provides more information about Provar’s license processing. Refer to ANT Task Parameters and Running Provar on Linux for more details.
Provar ANT build.xml License Path
Within a Provar Build.xml, the Run-Test-Case task includes an optional attribute for licensePath. The information below relates to how you can specify the licensePath to suit running Provar ANT tasks.
Specified LicensePath
The license path can be a folder or an exact file path.
If it is a file, then it is used as it is. Note that the file must be a properties file (name and value pairs) and in the format expected by Provar.
The following includes an example of the information provided in a properties file.
#Thu Jul 05 15:52:26 IST 2018 licenseStatus=Activated licenseType=FixedSeat licenseKey=XXXXX-XXXXX-XXXXXX-XXXXX-XXXXX lastOnlineAvailabilityCheckUtc=1530786146160
If it is a folder, Provar will iterate over all the files contained within, check for property files, and attempt to use the first active license found.
Note: Cleaning out inactive or expired Provar license key files is recommended to slightly speed up your ANT execution.
LicensePath Resolution
- If an absolute path (e.g. D:/Users/Provar/.licenses, /user/provar/serverkeys)
- return to the same path
- If a relative (e.g. ../serverkeys)
- Check under the Provar home location for the custom license path or ‘.licenses’ as default (this is the change in 1.9.4)
- If found, use it
- Check under userhome/Provar for the custom license path or ‘.licenses’ as default; (for the existing customers who had it in userhome)
- If found, use it
- Otherwise, it will be as derived from the above step
- Check under the Provar home location for the custom license path or ‘.licenses’ as default (this is the change in 1.9.4)
The Provar tool should not be affected by this and should always use the UserHome/Provar/.licenses folder.
ANT licensing logs should show the final file path and the appropriate error message.
Examples of LicensePath
- No LicensePath attribute set
- .licenses folder under Provar Home or UserHome/Provar should be found
- License Path set as C:/Provar_Licenses
- This is an absolute path; this folder is searched to find the properties file and the first active license.
- License Path set as C:/Provar_Licenses/ExecutionLicense.properties
- This is a file path. It should be in the expected format by Provar and read for the active license
- License Path set as ../Provar_Licenses
- This is a relative path and should be found in either the ProvarHome or UserHome folders.
- Provar Automation
- System Requirements
- Browser and Driver Recommendations
- Installing Provar Automation
- Updating Provar Automation
- Licensing Provar
- Granting Org Permissions to Provar Automation
- Optimizing Org and Connection Metadata Processing in Provar
- Using Provar Automation
- API Testing
- Behavior-Driven Development
- Consolidating Multiple Test Execution Reports
- Creating and Importing Projects
- Creating Test Cases
- Custom Table Mapping
- Functions
- Debugging Tests
- Defining a Namespace Prefix on a Connection
- Defining Proxy Settings
- Environment Management
- Exporting Test Cases into a PDF
- Exporting Test Projects
- Japanese Language Support
- Override Auto-Retry for Test Step
- Mapping and Executing the Lightning Article Editor in Provar
- Managing Test Steps
- Namespace Org Testing
- NitroX
- Provar Automation
- Provar Test Builder
- ProvarDX
- Refresh and Recompile
- Reintroduction of CLI License Check
- Reload Org Cache
- Reporting
- Running Tests
- Searching Provar with Find Usages
- Secrets Management and Encryption
- Setup and Teardown Test Cases
- Tags and Service Level Agreements (SLAs)
- Test Cycles
- Test Plans
- Testing Browser Options
- Tooltip Testing
- Using the Test Palette
- Using Custom APIs
- Callable Tests
- Data-Driven Testing
- Page Objects
- Block Locator Strategies
- Introduction to XPaths
- Creating an XPath
- JavaScript Locator Support
- Label Locator Strategies
- Maintaining Page Objects
- Mapping Non-Salesforce fields
- Page Object Operations
- ProvarX™
- Refresh and Reselect Field Locators in Test Builder
- Using Java Method Annotations for Custom Objects
- Applications Testing
- Provar Manager
- How to Use Provar Manager
- Provar Manager Setup
- Provar Manager Integrations
- Release Management
- Test Management
- Test Operations
- Provar Manager and Provar Automation
- Setting Up a Connection to Provar Manager
- Object Mapping Between Automation and Manager
- How to Upload Test Plans, Test Plan Folders, Test Plan Instances, and Test Cases
- Provar Manager Filters
- Uploading Callable Test Cases in Provar Manager
- Uploading Test Steps in Provar Manager
- How to Know if a File in Automation is Linked in Test Manager
- Test Execution Reporting
- Metadata Coverage with Manager
- Provar Grid
- DevOps
- Introduction to Provar DevOps
- Introduction to Test Scheduling
- Apache Ant
- Configuration for Sending Emails via the Automation Command Line Interface
- Continuous Integration
- AutoRABIT Salesforce DevOps in Provar Test
- Azure DevOps
- Running a Provar CI Task in Azure DevOps Pipelines
- Configuring the Automation secrets password in Microsoft Azure Pipelines
- Parallel Execution in Microsoft Azure Pipelines using Multiple build.xml Files
- Parallel Execution in Microsoft Azure Pipelines using Targets
- Parallel execution in Microsoft Azure Pipelines using Test Plans
- Bitbucket Pipelines
- CircleCI
- Copado
- Docker
- Flosum
- Gearset
- GitHub Actions
- Integrating GitHub Actions CI to Run Automation CI Task
- Remote Trigger in GitHub Actions
- Parameterization using Environment Variables in GitHub Actions
- Parallel Execution in GitHub Actions using Multiple build.xml Files
- Parallel Execution in GitHub Actions using Targets
- Parallel Execution in GitHub Actions using Test Plan
- Parallel Execution in GitHub Actions using Job Matrix
- GitLab Continuous Integration
- Travis CI
- Jenkins
- Execution Environment Security Configuration
- Provar Jenkins Plugin
- Parallel Execution
- Running Provar on Linux
- Reporting
- Salesforce DX
- Git
- Version Control
- Masking Provar Credentials on CI
- Salesforce Testing
- Best Practices
- Salesforce Connection Best Practices
- Improve Your Metadata Performance
- Testing Best Practices
- Automation Planning
- Supported Testing Phases
- Provar Naming Standards
- Test Case Design
- Create records via API
- Avoid using static values
- Abort Unused Test Sessions/Runs
- Avoid Metadata performance issues
- Increase auto-retry waits for steps using a global variable
- Create different page objects for different pages
- The Best Ways to Change Callable Test Case Locations
- Working with the .testProject file and .secrets file
- Best practices for the .provarCaches folder
- Best practices for .pageObject files
- Troubleshooting
- How to Use Keytool Command for Importing Certificates
- Browsers
- Configurations and Permissions
- Connections
- DevOps
- Error Messages
- Provar Manager 3.0 Install Error Resolution
- Provar Manager Test Case Upload Resolution
- Administrator has Blocked Access to Client
- JavascriptException: Javascript Error
- macOS Big Sur Upgrade
- Resolving Failed to Create ChromeDriver Error
- Resolving Jenkins License Missing Error
- Resolving Metadata Timeout Errors
- Test Execution Fails – Firefox Not Installed
- Selenium 4 Upgrade
- Licensing, Installation and Firewalls
- Memory
- Test Builder and Test Cases
- Release Notes