Creating a server

A server resource represents a host on which you can run projects and steps.

To create a server:

  1. Select Servers in the left menu. The system displays the New Server panel at the bottom of the main content panel. If you have selected an existing server, click Add Server to erase the panel so that you can add a new server.
  2. Provide the server details:
    Screen image of the New Server form in the Servers panel
    • Name: Give the server a name. This name is the BF_NAME property of the server. You refer to this name in selectors to specify a server by name.
    • Path: Specify a directory that the server uses when it creates project and job directories, such as c:/buildforgeprojects. The system uses this path value as a starting point when it creates the build directory.
      Tip: The system does not create the server path. The path must exist before a build attempts to access the server. If the path does not exist, the build fails.
    • Host: Provide the host name for a physical computer that is running the agent. Use value localhost if you are defining the Management Console computer as a server. (The agent must also be installed on the Management Console.)
      Note: You can include a port number with the host name; for example, host_name:port_number. If you specify a port number with the host name, it overrides the port number that the Default Agent Port system setting defines. (Click Administration > System > Default Agent Port.)
      Note: Do not precede the host name with a protocol. For example, do not use http://.
    • Authentication: Select the server authentication to use with this server.
    • Access: Select an access group of users who can use this server.
    • Collector: Select the collector to use with this server.
    • Environment: Select a group of environment variables to be applied whenever this server is used to run a project. These variables are applied before all other variables. They set parameters specific to the server.
    • Files: Define the types of file transfers for this server that can be used with the .get and .put commands. You can choose no transfers (None), file reads (.get), file writes (.put), or both (.get and .put).
    • Max Jobs: Enter the maximum number of jobs that should be run simultaneously. Default is 3.
    • Password Encryption Configuration: Select Enabled if you want the agent password to be encrypted. Default is Disabled.
    • SSL Enabled: Select Yes if you have configured the Build Forge system to use SSL and you want this server resource to communicate with the agent through SSL. Default is No.
      Note: If you select Yes but Build Forge is not correctly configured for SSL, this server resource is not able to communicate with the agent at all.
  3. Click Save. Your new server is displayed in the server list at the top of the content panel. To verify that you have correctly configured the server, select your server in the list and then click Test Connection. The system reports errors if it cannot communicate with the server.

Feedback