Add and edit build servers

Add and edit build servers from the ALI Summary or Builds pages in the configuration area.

1. Add and edit build servers manually

   Do one of the following:

   • To add a new build server, click Add Build Server.

   • To edit an existing build server's details, click the build server's name.

   The New Build Server or the Build Server details page opens.

2. Enter the server connection details.

   On the New Build Server or the Build Server details page, enter the connection details for the build server. Click Validate Configuration to check the connection.

   Note: The server location is a full path using the format http://xx.xx.xxx.xxx/[yyyy]. This address should be in DNS form. The /yyyy segment is optional.

   TFS users

   If you are using a TFS server, you must use the following format for the server address: http://tfsServer:tfsport/tfsali/Service/BuildService.svc/ali/projectCollectionName. The build service is part of HPE ALI TFS Services which you have to download and install on the TFS server. The installer may be downloaded from the ALI Summary page

   Note: Elements of the TFS server address are defined as follows:

   • tfsServer is the address of the TFS server.
   • :tfsport is the port that the TFS server uses.
   • /tfsali is the name of the application on the IIS site defined during the installation of the HPEALI TFS Services.
   • /projectCollectionName is the name of the project collection.

   For details on ALI TFS Services, see Set up TFS for ALI

3. Share the build server.

   If you are a site administrator, and want to enable this build server to be used in other workspaces, click Shared. The button turns blue when the build server is shared. Click it again to disable sharing for this build server.

   Caution: Only disable sharing after verifying that the build server is not used in ALI configurations in any workspace in the site.

   For details about shared artifacts, see Sharing ALI artifacts across workspaces.

4. Edit the build server properties.

   In the Properties section of the New Build Server or the Build Server details page, set the following server properties:

   Retrieve incomplete data	Retrieves build information for all build configurations specified for the build server. Only those builds which have ALI enabled connect build information to the development information. By default, this property is disabled.
   Preemptive authentication	Enables you to automatically enable communication between Agile Manager and the build server. By default, this property is enabled.

5. Add build configurations to a new server connection.

   1. Expand the Select Configuration section at the bottom of the page.
   2. Select the build configurations to add to the build server.

   All added configurations are displayed as sub-parts of the Build Server on the Builds page. For details on adding additional configurations, see Add and edit build configurations.

6. Edit the change detection settings for a build server.

   As part of its integration with the development process, Agile Manager detects new builds on the build server. In order to enable the retrieving of build information from the build server, you must set the Change Detection settings.

   Set the following Change Detection settings in the Change Detection section of the Build Server details page:

   Read changes from the Build Server and receive builds transmitted by Build Server Agents	Enables Agile Manager to automatically check the Build Server for new build information.
   Change interval	The length of time Agile Manager waits to check the build server for new build information. By default, this interval is 60 minutes.
   Synchronize now	Click this button to check the repository for new commits.