Copying project settings to a new project

You can copy project properties from an existing project to a new project. The project settings that are copied are all the properties that are set in Project Properties except for Lab Resource and Channel Properties and Test Plan's Environment Types. You use a command line script for this task.

About this task

Timelines and team areas do not support copying settings.

In this task, the source project is the existing project that contains the project properties to copy to a new project. The target project is the new, or existing, project to which the project properties are copied. Before you can copy project settings, ensure that the following conditions are met.

Procedure

  1. On the server that contains the source project, open the command line prompt.
  2. Change the directory to the ..\tools\projectSettings folder in the install location of Rational Quality Manager, for example, C:\Program Files\IBM\JazzTeamServer\server\conf\qm\tools\projectSettings.
    Note: If Rational Quality Manager was installed as an upgrade, the context root for Rational Quality Manager is ...conf\jazz instead of ...conf\qm. For an upgrade, change the copysettings.bat file (located in the \projectSettings folder in the install path) to set the DEFAULT_CONTEXT parameter to \jazz (the default is \qm). Here is an example of how you could modify the copysettings.bat file (this is from the top of the file):
    SETLOCAL
    SET MY_TEMP="~TEMP"
    if "x%MY_TEMP%" EQU "x" (
        SET TEMP=C:\TEMP
        MD C:\TEMP
    )
    SET CURL="..\import\AQXUrlTool.exe"
    SET INTEGRATION_SERVICE=/service/com.ibm.rqm.integration.service.IIntegrationService
    SET SETTINGS_FILE=%TEMP%\settings.txt
    SET DEFAULT_CONTEXT=jazz
  3. Type copySettings and press Enter. A list of options and their descriptions displays:
    1. For Windows:
      C:\Program Files\IBM\JazzTeamServer\server\conf\qm\tools\projectSettings>copySettings
      Usage: copySettings [options]
      	/H                       : show this help
      	/SS source server        : RQM server. E.g. https://servername:9443/
      	/SC source context       : RQM source context root (Optional, default is qm)
      	/SU source username      : login username
      	/SP source password      : login password
      	/SA source area          : project alias. E.g. Quality+Manager
      	/DS destination server   : RQM server. E.g. https://servername:9443/
                                     Default is same as source.
      	/DC destination context  : RQM destination context root (Optional, default is qm)
      	/DU destination username : login username.  Default is same as source.
      	/DP destination password : login password  Default is same as source.
      	/DA destination area     : project alias.
    2. For Unix and Linux:
      /opt/IBM/JazzTeamServer/server/conf/qm/tools/projectSettings>copySettings
      Usage: copySettings [options]
      	/H                       : show this help
      	-s source server        : RQM server. E.g. https://servername:9443/
      	-c source context       : RQM source context root (Optional, default is qm)
      	-u source username      : login username
      	-p source password      : login password
      	-a source area          : project alias. E.g. Quality+Manager
      	-d destination server   : RQM server. E.g. https://servername:9443/
                                     Default is same as source.
      	-e destination context  : RQM destination context root (Optional, default is qm)
      	-n destination username : login username.  Default is same as source.
      	-w destination password : login password  Default is same as source.
      	-r destination area     : project alias.
  4. For Windows, do either of the following, depending on whether the target project is located on the same server as the source project, or on a different server.
    1. If the new project area is on the same server as the source project, type copySettings /SS <http address of source project>/ /SC <source context>/ /SU <login username> /SP <login password> /SA <source project alias> /DA <target project alias>, and press Enter.
    2. If the new project area is on a different server from the source project, you must add five attributes to the command. Type copySettings /SS <http address of source project>/ /SC <source context>/ /SU <login username> /SP <login password> /SA <source project alias> /DA <target project alias> /DS <http address of target project>/ /DC <destination context>/ /DU <login username of target project> /DP <login password of target project> /DA <target project alias>, and press Enter.
  5. For Unix and Linux, do either of the following, depending on whether the target project is located on the same server as the source project, or on a different server.
    1. If the new project area is on the same server as the source project, type copySettings -s <http address of source project> -c <source context> -u <login username> -p <login password> -a <source project alias> -r <target project alias>, and press Enter.
    2. If the new project area is on a different server from the source project, you must add five attributes to the command. Type copySettings -s <http address of source project> -c <source context> -u <login username> -p <login password> -a <source project alias> -d <http address of target project> -e <destination context> -n <login username of target project> -w <login password of target project> -r <target project alias>, and press Enter.
    Note: For AIX®, run the copySettings command from the ksh93 shell instead of the default ksh shell, for example ksh93 ./copySettings.sh.

Results

The project settings from the source project are copied to the new project. The new project is ready for use.



Have a problem or a question? Post it in the Jazz.net forum.