Converting a directory to a subproject

About this task

You can perform this operation from the CLI only.

Procedure

  1. Start Rational Synergy from the command prompt.

    ccm start -h engine_hostname -d database_path -nogui

    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 "string" -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 release -purpose "Integration Testing"

  6. Create the platform 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_name delimiter version

  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 through your test suite.
    Note: Repeat this process for each platform, checking out integration and system testing project for each platform.
  14. Exit from the Rational Synergy CLI.

    ccm stop


Feedback