After it was verified that PWA Configuration is a complete match between source and target systems and the projects in the source system are published, it would be needed to perform the so-called copy dry-run. We recommend migrating 1 or 2 Projects and Project Sites firstly.
After this test migration, we need to verify migrated Projects:
- Project Owner
- Workflow Stage
- Project level custom fields in PDPs
- Schedule (cost fields, duration, % complete, work, start/finish dates, custom fields)
For Project Sites:
- Look & feel
- Navigation
- Lists & Libraries and items in them (including Tasks list)
- Connection to Project
Please note: It is recommended to test the copy of Projects and Project Sites separately.
I. Copy 1-2 Projects
1. Navigate to the G.A. Suite site and log in with your account.
2. On G.A. Suite Homepage click on the source environment title, which serves as a source of data migration, then navigate to the Change Management section and choose the Copy option:
3. On the 'Copy' page click on the Copy now button.
Copy Now window will be opened. Review and edit the required information here by clicking on the pencil-like button next to each section.
- Source location - check that the source PWA URL is correct.
- Notification Email - specify the email, where the notification will be sent on completion.
-
Source credentials - Provide specific credentials, if needed, and validate them. Multi-factor Authentication for Office 365 users is also available. For more details refer to this article.
Please note: By default G.A. Suite uses the credentials which were provided when adding PWA to G.A. Suite. These credentials are stored and may be found on the Credentials Manager or Credentials page. If for some reason you would like G.A. Suite to use a different set of credentials, use this option.
You can add multiple credentials to perform the operation and add more accounts to the accounts list.
In case of any issues with an account (permissions or access lost; password expired) during G.A. Suite operation processing, another one will be used to successfully complete the operation. Also, using the Multiple credentials option makes G.A. Suite performance faster. - Target location - the PWA configuration will be copied to the selected PWA. Please make sure the required PWA is added to your G.A. Suite tenant and licensed.
- Target credentials - provide target specific credentials if you need to use different credentials from the ones provided in the Environment Settings.
- PWA Configuration - Skip this option now.
Next, it is possible to select specific Project Plans sites for copying:
Project Plans - click on the pencil-like button to select the projects you need to upload to the target PWA now. We will choose the Selected option as we need to migrate only a few projects now.
Click on the number link to choose the needed projects.
As you click on the number link, the Project Plans window will be opened and all Projects from the source PWA will be loaded to this window at once. You can filter the projects by 'View' or by 'Modified date' if needed using the filters on the top of this window. When the required filter is selected, the projects list will be loaded from the PWA into the Project Plans page according to the selected filter.
Select the projects you need to upload to the target PWA.
Please note: If you need to select the projects from different Project Center views, it is also possible. Select the required view, check the checkboxes of the required projects. Then open the next view and select the projects that you need to include in this operation from this view as well. You will then see the total number of the selected projects by clicking on the Selected button that shows the number of projects that are currently selected for the current operation.
The Total Items button allows reviewing all projects that are loaded to the Project Plans screen.
Also, the projects can be additionally filtered out by the Project name, % Complete, Type, EPT, Modified fields, using the button next to each field. You can provide the filtering criteria there to get faster to the projects you need.
As soon as the required projects are selected, please click the 'Add selected' button.
Click Save to save the selection.
Delete Sites/Projects before upload - select this option, if you don't need to remove projects and their sites selected for upload from the target PWA before upload. (Projects with the same name and/or project UID will be deleted if the check box is not checked. The projects and sites will be deleted in the same way as you delete them manually).
Click Copy now to begin the copying process.
Copy summary screen will be opened where you can review the information for the launched operation. You can Cancel and Pause the operation if required.
Click Close to return to the Copy page.
As the process finishes, navigate to the target Project Online PWA and verify the Projects for correctness per points stated at the beginning of this article.
II. Copy 1-2 Project Sites
1. Navigate to the G.A. Suite site and log in with your account.
2. On G.A. Suite Homepage click on the source environment title, navigate to the Change Management section and choose the Copy option:
3. On the 'Copy' page click on the Copy now button:
Copy Now window will be opened. Review and edit the required information here by clicking on the pencil-like button next to each section.
- Source location - check that the source PWA URL is correct.
- Notification Email - specify the email, where the notification will be sent on completion.
-
Source credentials - Provide specific credentials, if needed, and validate them. Multi-factor Authentication for Office 365 users is also available. For more details refer to this article. Please note: By default G.A. Suite uses the credentials which were provided when adding PWA to G.A. Suite. These credentials are stored and may be found on the Credentials Manager or Credentials page. If for some reason you would like G.A. Suite to use a different set of credentials, use this option.
You can add multiple credentials to perform the operation and add more accounts to the accounts list.
In case of any issues with an account (permissions or access lost; password expired) during G.A. Suite operation processing, another one will be used to successfully complete the operation. Also, using the Multiple credentials option makes G.A. Suite performance faster. - Target location - the PWA configuration will be copied to the selected PWA. Please make sure the required PWA is added to your G.A. Suite tenant and licensed.
- Target credentials - provide target specific credentials if you need to use different credentials from the ones provided in the Environment Settings.
- PWA Configuration - Skip this option now.
Next, it is possible to select specific SharePoint sites for copying:
SharePoint Sites - click on the pencil-like button to select the sites you need to upload to the target PWA now.
Selected - this option allows us to choose particular sites and we will select this option for testing purposes. Click on the number link.
Wait a few minutes for the sites to be loaded to the SharePoint Sites window from the source PWA.
Select a few sites 3-5 maximum. Click Add Selected button.
Click Save to save the selection.
Delete Sites/Projects before upload - select this option, if you would like to remove projects and their sites selected for upload from the target PWA before upload. (Projects with the same name and/or project UID will be deleted. The projects will be deleted in the same way as you delete them manually).
Copy Document Versions - select this option if you need to migrate the document version history.
Delete Document Versions Before Upload - check this checkbox if these documents already exist on the target PWA. It is not possible to overwrite document versions using G.A. Suite. To upload the document versions to the target PWA, it is required to remove the existing documents from the target PWA.
Skip pages upload - If this option is OFF, before uploading SharePoint Sites, the Tenant Administrator should navigate to the SharePoint admin center -> Active Sites -> Select the site in question -> Open the Settings page -> Click Edit under the "Custom script" setting. Select "Allowed" and save the changes. This will allow the account you are using in G.A. Suite to copy site templates, custom forms, views, etc. With this option set to "Blocked", the copy will end with errors. For more details, please refer to this article.
This option allows skipping the upload of .aspx pages (in any libraries) as well as the Pages, Site Pages, Style Library, and PDP libraries during copy. This prevents errors during the copy process. This option can be used if you are unable to manage permissions or if you don't need these pages to be copied.
Click Copy Now button to launch the copying process.
Copy summary screen will be opened where you can review the information for the launched operation. You can Cancel and Pause the operation if required.
Click Close to return to the Copy page.
As the process finishes, navigate to the target Project Online PWA and verify the Project Sites for correctness per points stated at the beginning of this article.
After the test copy is finished and you verified that no issues occur, proceed to Copy Project Plans.