Server selectors allow you to describe the kind of server that a project or step should use by listing desired properties and values. When you apply a selector to a project or step, the system uses the selector to determine which servers are valid choices for the task, and then selects an available server from the valid ones.
You can use selectors to be specific (choosing a specific server by name) or general (any Windows® server). A selector is a list of properties which describe the desired server. To manage selectors, use the
page.If you want to select servers based on properties you define, create appropriate collector properties first. For example, you can create a collector with a property named BUILDING (with a value equal to the name of the building that houses a server). This allows you to select servers based on their physical location. However, when you create selector variables, you must choose properties from a list that the system generates from all of your collectors.
If a selector does not find a server that matches its property list, then the project or step fails and the system creates a build note.
Although it does not appear in a server's manifest, the property BF_NAME is automatically assigned to every server; its value is the logical name of the server. To create a selector for a specific server, create a selector variable that selects BF_NAME=<logical server name>.
When comparing selector variables with manifest properties to look for matches, the system looks at the variable's value and the manifest property's value. The system performs a lexical (string) comparison unless both values match the following criteria for numbers:
Property Name |
Manifest property value |
Operator |
Selector Variable Value | Comparison Type |
Match? |
---|---|---|---|---|---|
PerlVersion | v5.8.4 | >= | 5.2.1 | Lexical | Yes |
PerlVersion | v5.8.4 | >= | v.5.2.1 | Lexical | Yes |
PerlVersion | v5.8.4 | >= | v5.22.1 | Lexical | Yes |
OS_VERSION | 1.15 | >= | 1.1 | Numeric | Yes |
OS_VERSION | 1.10 | >= | 1.1.0 | Sub-version numeric | Yes |
BF_NAME | WinServer1 | contains | win | Lexical | Yes |
BF_NAME | Server123 | = | 123 | Lexical | No |