Creating an external project

About this task

Be sure that you already have build management project hierarchies. Creating an integration testing project is described in Creating the integration testing projects. Creating a system testing project is described in Creating the system testing projects.

Procedure

  1. Create a task to create an external project, leave yourself as the resolver.

    The newly created task is set as the current task.

  2. Copy a project to be the external project.
    1. Create the new project.
    2. Set the properties for the new project.
    3. Click OK.
  3. Add the product object(s) (and any other objects) to your external project by using drag and drop or copy and paste.
  4. Add the new external project to your original project.
    1. View the appropriate build management project in the Work pane.
    2. Cut the original subprojects from your original project. (You will need to do this if you are creating an external project from an existing subproject.)

      If you have a guilib project, and you created a guilib_ext external project, you will need to replace each occurrence of the guilib project with guilib_ext. You will need to do this for each external project.

      For example, Joe would add guilib_ext to his toolkit project, and remove the guilib project from his toolkit project. Moreover, he could delete his copy of the guilib project if he never needed to build that subproject.

    3. Add your new external project to your original project. (If the new external project is a subproject, you can skip this step.)

      Refer to 3 above.

  5. Repeat 4 for each project that should include the external project.
    Note: Modify your build scripts and makefiles to properly reference the new external project(s).
  6. Complete the current task.
  7. Perform an integration test cycle on your integration testing projects.
  8. Create a baseline from the project hierarchy.
  9. Copy a system test build management project from the external baseline project.
  10. Perform a system testing build and test cycle on your system testing project.

Procedure

  1. Change to the build_mgr role.
  2. Create a task to create an external project, then assign it to yourself.
  3. Set the new task as the current task.
  4. Create an external project. You will need to set its name, version, purpose, and release.
  5. Add the product object(s) (and any other objects) to your external project.
    1. Change directory to your new project’s work area.
    2. Use the ccm query command to query to find the objects you want to add to your external project.
    3. Use the ccm use command to add the object(s) to the external project.
  6. Add the new external project to your original project.
    1. Change directory to the appropriate prep project.
    2. Unuse the projects from your original project.

      For example, if you have a guilib project, and you created a guilib_x external project, you will need to replace each occurrence of the guilib project with guilib_x. You will need to do this for each external project.

    3. Add your new external project to your original project.

      Refer to 5 above.

  7. Update each integration prep project that should include the external project.
    Note: You will now have to modify your build scripts and makefiles to properly accommodate the new external project(s).
  8. Complete the current task.
  9. Perform an integration test cycle on your integration prep projects.
  10. Create a baseline from the project hierarchy.
  11. Copy a system test prep project from the external baseline project.
  12. Perform a system testing build and test cycle on your system test prep projects.

Feedback