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.
- You must have administrative permissions and access to the IBM® Rational® Quality Manager server.
- You must have access to a command prompt.
- Ensure that the target project exists. Create a new project if
necessary.
- The target project can be on the same server as the source project,
or on a different server. The procedure for copying project settings
is different depending on whether the target project is on the same
server or a different server than the source project.
Note: If you
are copying the project onto a different server, both the source and
target servers must be on the same version of Rational Quality Manager.
- You must know what the source and target project aliases are.
The project alias is based on the project name. If there are spaces
in the project name, in the project alias, the spaces are replaced
by + (plus signs). Project aliases are case-sensitive. The project
alias is always the same for a project, even if the project name changes.
For example, if the original project name is Quality Manager, the
project alias is Quality+Manager. If you rename the project to RQM,
the project alias will still be Quality+Manager even though the project
name is now RQM.
Note: To find out what the project alias is, on the
server on which Rational Quality Manager is
installed, browse to https://[server name]:9443/context
root/service/com.ibm.rqm.integration.service.IIntegrationService/projects,
where context root is either qm or jazz.
If Rational Quality Manager was
upgraded from version 2.x, the context root is jazz.
Otherwise, the context root is qm. Click the
URL to display a feed of the projects on the server. The project alias
displays in the feed.
- You cannot copy lab resource properties to another project.
Procedure
- On the server that contains the source project, open the
command line prompt.
- 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
- Type copySettings and press Enter.
A list of options and their descriptions displays:
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.