Converting a directory to a subproject

You can convert a directory to a subproject.

Procedure

  1. Start a session from the command prompt. See Starting a CLI session for steps.

    After the session starts, the Rational Synergy address (CCM_ADDR) is printed in your command window (Windows) or in the shell where you started the session (UNIX).

  2. Set your role to build_mgr.

    ccm set role build_mgr

  3. Create a task, assign it to yourself, and set it as the default.

    ccm task -create -synopsis "set up subproject" -release 1.0 -default

  4. Change to the directory in your work area above the directory you want to convert to a project.
  5. Create a project, specifying the directory as its root.

    ccm create -type project -root existing_dir -version int
    -release 1.0 -purpose "Integration Testing"

  6. Set the platform value for the subproject, if necessary.

    ccm attr -create platform -type string -value platform
    -project project_spec

  7. Use the ccm unuse command to unuse the directory.
  8. Add the new integration testing project to your integration testing project hierarchy.

    ccm use -p project_spec

  9. Windows users: If you use absolute subprojects, change the makefiles, the build process, and all automated jobs to reflect the changes you have made.

    If you use relative subprojects, no changes are necessary.

  10. Complete the current task.

    ccm task -complete default

  11. Perform an integration test cycle, then Creating a baseline.
  12. Copy a system testing project from the new project.

    This operation is discussed in Creating the system testing projects.

  13. Update your top-level system testing project, rebuild your application, then run your test suite.
    Note: Repeat this process for each platform, checking out integration and system testing project for each platform.
  14. Exit from the database.

    ccm stop


Feedback