RPM-GreenHopper-Users-Projects-Import-Tool

Overview

The Users and Projects Utility helps you migrate your users and projects from Jira to CA Agile Central Portfolio Manager (RPM).

Contents

Overview

System Setup and Requirements

Running the Utility

Debug/Troubleshoot

System Setup and Requirements

General Requirements

  • An RPM Connector VM running on your network - the utility will be installed on that VM.

Running the utility

By executing the following, you should receive a command line help

get_users Obtains users from CA Agile Central and Other Connector (Only one supported is Jira) and outputs 3 CSV files.
(rally-users.csv, other-users.csv and diff-users.csv)
get_projects Obtains projects from CA Agile Central and Other Connector (Only one supported is Jira) and outputs 3 CSV files.
(rally-projects.csv, other-projects.csv and diff-projects.csv)
create_users Creates users from a CSV file (diff-users.csv)
create_projects Creates projects from a CSV file (diff-projects.csv)

get_users

Usage:
get_users <options>
where <options> are:
                  --rally-csv, -r <s>:   CA Agile Central CSV - CSV name for users in CA Agile Central workspace (default: rally-users.csv)
                  --other-csv, -o <s>:   Other CSV - CSV name for users (default: other-users.csv)
                   --diff-csv, -d <s>:   Diff CSV - CSV name for users (default: diff-users.csv)
      --other-connection-type, -t <s>:   Type of connector to import users from: Jira, TFS, v1 (default: Jira)
       --other-connection-url, -j <s>:   Authorization for other connection URL.  Ex https://www.server.com:port
  --other-connection-username, -n <s>:   Authorization for other connection Username
  --other-connection-password, -s <s>:   Authorization for other connection Password
       --rally-connection-url, -y <s>:   Authorization for CA Agile Central connection URL.  Ex https://rally1.rallypass.com/slm
  --rally-connection-username, -u <s>:   CA Agile Central Username
  --rally-connection-password, -p <s>:   CA Agile Central Password
                   --projects, -e <s>:   Comma delimited list of project keys.  Default is all projects.  Ex
                                         "Project-one,Project_two,Project Three"
                        --version, -v:   Print version and exit
                           --help, -h:   Show this message

Example Usage
get_users -y https://trial.rallypass.com/slm -u user@rallypass.com -p rallypass -j http://orca-ubujira1:8080/ -n admin -s jirapass

get_projects

Usage:
get_projects <options>
where <options> are:
                  --rally-csv, -r <s>:   CA Agile Central CSV - CSV name for projects in CA Agile Central workspace (default: rally-projects.csv)
                  --other-csv, -o <s>:   Other CSV - CSV name for projects (default: other-projects.csv)
                   --diff-csv, -d <s>:   Diff CSV - CSV name for projects (default: diff-projects.csv)
      --other-connection-type, -t <s>:   Type of connector to import projects from: Jira, TFS, v1 (default: Jira)
       --other-connection-url, -j <s>:   Authorization for other connection URL.  Ex https://www.server.com:port
  --other-connection-username, -n <s>:   Authorization for other connection Username
  --other-connection-password, -s <s>:   Authorization for other connection Password
       --rally-connection-url, -y <s>:   Authorization for CA Agile Central connection URL.  Ex https://rally1.rallypass.com/slm
  --rally-connection-username, -u <s>:   CA Agile Central Username
  --rally-connection-password, -p <s>:   CA Agile Central Password
       --rally-workspace-name, -w <s>:   CA Agile Central Workspace Name
                        --version, -v:   Print version and exit
                           --help, -h:   Show this message

Example Usage
get_projects -y https://trial.rallypass.com/slm -u user@rallypass.com -p rallypass -w OrcaUtils -j http://orca-ubujira1:8080/ -n admin -s jirapass

create_users

Usage:
create_users <options>
where <options> are:
                   --diff-csv, -d <s>:   Diff CSV - CSV name for users (default: diff-users.csv)
       --rally-connection-url, -y <s>:   Authorization for CA Agile Central connection URL.  Ex https://rally1.rallypass.com/slm
  --rally-connection-username, -u <s>:   CA Agile Central Username
  --rally-connection-password, -p <s>:   CA Agile Central Password
                        --version, -v:   Print version and exit
                           --help, -h:   Show this message

Example Usage
create_users -y https://trial.rallypass.com/slm -u user@rallypass.com -p rallypass -w OrcaUtils

create_projects

Usage:
create_projects <options>
where <options> are:
                   --diff-csv, -d <s>:   Diff CSV - CSV name for projects (default: diff-projects.csv)
       --rally-connection-url, -y <s>:   Authorization for CA Agile Central connection URL.  Ex https://rally1.rallypass.com/slm
  --rally-connection-username, -u <s>:   CA Agile Central Username
  --rally-connection-password, -p <s>:   CA Agile Central Password
       --rally-workspace-name, -w <s>:   CA Agile Central Workspace Name
                        --version, -v:   Print version and exit
                           --help, -h:   Show this message
Example Usage
create_projects -y https://trial.rallypass.com/slm -u user@rallypass.com -p rallypass -w OrcaUtils

Feedback

Need more help? The CA Agile Central Community is your one-stop shop for self-service and support. To submit feedback or cases to CA Agile Central Support, find answers, and collaborate with others, please join us in the CA Agile Central Community.