BuildForge Help

Creating a Hello World Project

This topic describes how to create and execute a simple project to verify that Build Forge is set up properly.

  1. Create a server authentication, selector, and a server object. These objects are required before you can create a project.
  2. Create a project named HelloWorld. Select Projects. In the Project Details form at the bottom of the main content pane, enter HelloWorld as the Project Name and choose a selector. Click Save Project.
    Figure 1. Creating HelloWorld Figure shows the Project Details for the Hello World example project.
  3. Add a step to the project named EchoHelloWorld.
    1. Select the HelloWorld project. The system displays the empty step list for the project and a blank Step Details form.
    2. In the Step Details form, enter a Name of EchoHelloWorld.
    3. In the Command field, enter a command line that will write "Hello World" to standard output on your chosen server. For example, the following command line works on Windows®, Solaris, Linux®, UNIX®, and Macintosh OS X systems:
      echo Hello World
      Then click the Save Step button.
  4. Run the project. Select Projects to redisplay the project list, then click the Figure shows the quick start (green button with a white triangle) icon icon next to the HelloWorld project. The system displays the Running tab of the Jobs module, with the HelloWorld project listed as running.
    Note: If the HelloWorld project is not listed, skip to step 6.
  5. Click the Refresh link at intervals until the Hello World project disappears from the Running list.
  6. Click the Completed tab.
  7. Click the job tag for the job. The default job tag for an initial job is BUILD_1. The system displays details for the run, with the step log at the bottom of the main pane.
  8. Examine the log for the project. In most Hello World examples, you would see the "Hello World" text in a console window or pop-up window. The Management Console does its work by sending commands to the agent process on the targeted server; the agent then sends the output from those commands back to the Management Console, which stores them in the logs. The log has many sections; the relevant one is the final EXEC section. Click on it to display the results of your command:
    EXEC
    274 Jun 13, 2006 - 16:52 start [c:\BuildForgeTests\HelloWorld\BUILD_1@mcsystem] echo Hello World
    275 Jun 13, 2006 - 16:52 Performing variable expansion on command line
    276 Jun 13, 2006 - 16:52 Hello World
    277 Jun 13, 2006 - 16:52 end [c:\BuildForgeTests\HelloWorld\BUILD_1@mcsystem] echo Hello World (0)
This project demonstrates that you have configured your system correctly, that projects can successfully access a server, run and generate output on a server. The echo command can be replaced with any command that can be run on the target server.