About server resources

A server resource in the console represents a host where you can run projects or steps.

As an administrator setting up the system, servers must be created first. Create collectors that are assigned to servers. Run the collectors to populate the server manifests. After these tasks are completed, build engineers create projects with selectors that determine where to run project steps.

Each server resource points to a host that has an agent installed on it. When adding a server resource, you describe how the Management Console accesses and uses a specific host.

Before a server is created, ensure that data objects dependent on the server already exist. Assign these items to a server:
Item Required or option Description
Server authentication Required Specifies the login name and password to use with the server.
Collector Optional Defines the properties that the system collects from the server, in addition to default properties.
Environment Optional Specifies environment variables that are assigned when a project is run on the server.
Note: You can create more than one server object within the Management Console for a single physical server. These server objects are called logical servers. Logical servers are typically used allowing projects to access the same hardware with different properties. For example, two logical servers might use different paths or different environments:
  • Two logical servers with different paths create separate working directories on the same server. You can distinguish work performed using one server, from work performed with another server. All output is saved in different directories.
  • Two logical servers with different environments run steps with different starting environment values.

About the Servers panel

Use the Servers panel to specify servers on which to run projects.

To manage servers on the Management Console, click Servers in the left menu.

Details tab

The Details tab provides the following fields:

Host
The name of a host that is running the Rational® Build Forge agent.
Collector
The collector to use with the server.
Environment
The environment to use with the server.
Server Provider
The provider that facilitates the communication with the end point servers. The default server provider is Agent Server Provider. It provides the communication with Build Forge Agent end point servers.
Authentication
The server authentication login and password.
Password Encryption
Determines whether the agent password is encrypted.
Files
The types of file transfers to use with the .get and .put commands
Access
The access group of users on the server.
SSL Enabled
Indicates whether you have configured the Rational Build Forge system to use SSL.
Max Jobs
The maximum number of jobs that should run simultaneously.

Manifest tab

The Manifest tab displays various server properties. It provides a default set of properties. You can include additional properties by using a collector.

Test Results tab

The Test Results tab indicates the status of the last test of the connection between the Management Console and the server.

Notes tab

The Notes® tab provides a convenient location for storing and sharing comments about a server.


Feedback