Testing the connection

You can test the connection to the agent by using telnet.

To test the connection from the command line:

  1. Connect to the agent with a telnet command. If you are logged on to the host where the agent is running, you can use localhost as the host name.
    telnet hostname 5555
    This response indicates a successful connection:
    200 HELLO - BuildForge Agent v7.0.1.buildnumber
  2. Check authentication by issuing the following commands, using your login credentials:
    telnet localhost 5555
    username user name
    password  password
    cmd ping
    go

    The following message indicates success:

    AUTH: set user account to <user name>
    If the above tests work but jobs are failing, and a test of your server shows a user authentication error, check the pluggable authentication modules (PAM) configuration. If you see a message like the following, proceed to the next step.
    AUTH: unable to set user account to <user name>: unknown account (1)
  3. Type the following command:
    cmd ping go

    The following output of a telnet session is typical. In particular look forRESULT 0 at the end of the output as an indication of success. This test ran on an agent running on Windows®.

    300 DATA s 67
    AUTH: Running as: [SYSTEM] in domain [NT AUTHORITY] SID Type [User]
    300 DATA s 52
    AUTH: Running with Privilege: [Lock pages in memory]
    300 DATA s 66
    AUTH: Running with Privilege: [Adjust memory quotas for a process]
    300 DATA s 63
    AUTH: Running with Privilege: [Create permanent shared objects]
    300 DATA s 46
    AUTH: Running with Privilege: [Debug programs]
    300 DATA s 56
    AUTH: Running with Privilege: [Bypass traverse checking]
    300 DATA s 61
    AUTH: Running with Privilege: [Back up files and directories]
    300 DATA s 54
    AUTH: Running with Privilege: [Change the system time]
    300 DATA s 68
    AUTH: Running with Privilege: [Remove computer from docking station]
    300 DATA s 73
    AUTH: Running with Privilege: [Impersonate a client after authentication]
    300 HEARTBEAT 1
    300 DATA s 16
    PLAT: Windows XP
    250 RESULT 0
    PING: internal loopback test complete
    260 EOR

Feedback