A server resource represents a host on which you can run
projects and steps.
To create a server:
- 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.
- Provide the server details:
- Name: Enter a name for the server. 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: Enter 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 .
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 when this server is used to run a project.
These variables are applied before all other variables. They set parameters
specific to the server.
- Server Provider: Select the provider to
facilitate the communication with the endpoint servers. The default
server provider is Agent Server Provider. It provides the communication
with the Build Forge Agent endpoint servers.
- 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 can 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 cannot communicate with the
agent.
- 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.