Migration Guide - upgrading older projects
This is a migration guide focusing on moving projects up from Novapoint 20 to newer versions.
This video below shows how to do this from Novapoint 20 to Novapoint 2022, but is applicable to all newer versions.
From timestamp 10:45 a video demonstration of the actual upgrade process for both local and server/cloud models is shown.
How to migrate from Novapoint 20 and Quadri Server 2
This guide explains in text how get your Quadri model in Novapoint 20 to newer Novapoint desktop versions and how to upgrade Novapoint Task types. This guide also explains how to move these Quadri models from Quadri Server v2 to v3.
We will cover:
Upgrading a local model from Novapoint 20 to a newer Novapoint version
Upgrading your Quadri Server from version 2.0 to 3.0
Moving your Quadri model from a Quadri Server 2.0 to Quadri Server 3.0
Upgrading your Quadri model with a Feature Catalogue relevant on Novapoint 20, to a Feature Catalogue relevant for newer versions of Novapoint
Upgrading Novapoint Corridor Design Tasks (Road, Railway, Water/Sewer)
In a batch operation
Task-by-task
Upgrading Line tasks that are not part of corridor design tasks.
Upgrading other Novapoint Design Tasks (Bridge, Tunnel)
Upgrade a local Quadri model from Novapoint 20 to newer Novapoint versions
Note: You first need to install the new version of Novapoint.
Back up the local Quadri model.*
*After upgrading the Quadri model in a newer version of Novapoint the model cannot be downgraded to Novapoint 20.
Open the local Quadri model in the newer Novapoint version.
You are asked if you want to upgrade model, answer Yes.
The Quadri model will be converted to use the newest feature catalogue relevant to your newer Novapoint version.
Upgrade a Quadri model on Quadri Server 2.0 to be available in newer versions of Novapoint
This moves a Novapoint 20 model on a Quadri Server 2.0 to a Quadri Server 3.0 and makes the model available on a newer version of Novapoint.
1. Upgrade Trimble Quadri server to 3.0.
2. Login to QMM on the upgraded server.
3. In QMM, go to the Models page, and set the model you want to upgrade unavailable.
4. Go to the Server page > Maintenance tab, and click Upgrade Models.
5. Select the version to upgrade to: 3.0, and select the model you want to upgrade.
6. Click the “Start Upgrade” button.
7. Upgrade has started and might take some time. Go to the Models list to see the status.
8. Click the model and see that it has new version 3.0.
9. Then upgrade the FC: on the Models page, choose Upgrade Feature Catalog.
10. Select the feature catalog you want to upgrade to and select your model.
preferably you should pick the latest feature catalogue
any feature catalogues of Quadri 1.25/1930 and later will be OK to use for most cases
11. Click Upgrade feature catalog.
12. Click Yes in the next dialog.
Warning: This is NOT reversible, so be sure you want this.
13. Refresh the Models page and click a model to see that it has the correct FC.
14. Set the model available and you can download new worksets for use in NP21 clients.
Upgrading Novapoint Design Tasks
In Novapoint versions newer than Novapoint 20 we have made changes that require upgrading some of the tasks to be able to work with them.
Note that some task types will require preceding tasks to be upgraded to work as intended.
Look for the (!) mark on the task icon to see if it needs upgrading.
Upgrading Novapoint Design Tasks - batch process
Right-click the 'Process' in the explorer tree of the project and run the Corridor Upgrade at the bottom of the context menu.
A list of Novapoint Corridor Design tasks will be listed and a recommended alignment type is set. Change the alignment type if necessary.
Now run the upgrade process. It will upgrade all (or most) of the tasks.
Upgrading Alignments that are not reference alignments in existing corridor design tasks
Right-click the 'Process' in the explorer tree of the project and run the Non-Alignment Upgrade at the bottom of the context menu.
A list of Line tasks will be listed on the left, and you can select one or multiple and move them to the right. In that process you need to assign the feature type to store the line geometry to, or if you would like to store it as a Linear Element that can be used as a reference alignment in corridor tasks at a later point.
Now run the upgrade process. It will upgrade all (or most) of the tasks.
Upgrading Novapoint Design Tasks - task by task
Alignment Task
Click to edit the alignment task. A dialog appears to select a template. It is now important to select the correct template as there is no longer one type of alignment task.
If the alignment task is a reference alignment (centerline) then select what discipline it belongs:
Road
Railway
Pipeline
Sea
Air
Other
These alignment tasks will get network elements as part of the tasks in the Quadrimodel and only these ones can be used as reference alignement (centerline) in the design modules. Non-alignment line can only be used as boundary lines.
If the alignment task is only used as boundary alignments then select the template Non-alignment Line
When setting it to be a Non-alignment Line then it will not get network elements. It is also necessary to set what kind of result feature it should be, as Non-alignment Line consists of a feature separate from reference lines.
2. Click Finish on the task to complete the upgrade.
Road/Railway Task
When starting to work with a Road/Railway task, it will check if the alignment task for the reference alignment is upgraded. It also checks that the alignment and road/railway tasks used as calculation basis and in all preceding tasks are upgraded before you are able to continue.
When starting to edit a road/railway task, you may see this dialog:
Click YES and you will see which tasks need your attention to continue working:
If you need to update predecessor tasks, then to this first before continuing.
When predecessors are updated, then continue with upgrading the road/railway task.
Click to edit the road/railway task. It will now start an upgrading process using the cross-sections already calculated for the model. You will get a notice in the process info that “Task ‘XXXX’ upgraded successfully”.
Click Finish on the task to confirm and complete the upgrade. If the task has a calculation basis, it will now start a new complete build.
Water and Sewer|Cable Task
When starting to work with a WS|Cable task, it will check if the reference alignment is upgraded. It also checks that tasks used as a calculation basis and all preceding tasks are upgraded before you are able to continue.
After predecessors are upgraded you can proceed with upgrading this task.
Switch to AutoCAD environment to upgrade the WS|Cable model. IF right-clicking WS task and Edit Task, you may see this dialog:
2. In AutoCAD; select WS task and Open Construction dialogue. Click YES to upgrade.
Note: IF one or more trenches are related to a road/railway task, and the predecessors are not updated, the message below will be presented, after clicking YES to upgrade of WS model:
Click Yes to list the predecessors tasks that must be upgraded.
4. Switch back to the Quadri model and upgrade any predecessors. Due to changes in Feature Catalogue (the NP20 feature “Formation” is in NP21 replaced with new feature “SubgradeSurface”). You therefore need to update WS|Cable Calculation Basis.
5. After upgrading predecessors (Alignment and Road/railway tasks), open the Dynamic Query dialogue and add the new feature type 'SubgradeSurface'.
6. Go back to AutoCAD; select WS task and open Construction dialogue. Click YES to upgrade.
7. Click Save in Construction dialog.
8. Open Cross-Section Quantity calculation.
9. Select all trenches and Update. Click Build and recalculate.
10. Close the Calculation dialog. The upgrade from NP20 to NP21 is complete.
Bridge Task
Click the reserved Bridge task, right-click and choose Edit. Then click OK in the tool.
Note: You must migrate the connected Road/Rail task before you migrate the Bridge task.
Tunnel Task
Click the reserved Tunnel task, right-click and choose Edit. Then click OK in the tool.
Note: You must migrate the connected Road/Rail task before you migrate the Tunnel task.
After you have migrated the Tunnel task, for some situations you can’t change the geometry anymore. A better solution is to model a new tunnel task from scratch. Unfortunately, the import function of tunnel geometry files from NP 20 doesn’t work either.
Another workaround is to manually copy the conversion file from the Novapoint installation. Copy this file:
.\ Configuration\Default\Templates\Tasks\TunnelDesign\DefaultTunnel\Novapoint.QuadriModel.Tunnel For DCM.cf.xml
to all the tunnel tasks you have migrated. Replace the existing file with the same name on these tasks. You find the directory for the tunnel tasks by clicking on the tasks in the process tree and reading the GUID value. The GUID-value corresponds to a directory marked with brackets under the project directory, like this: {661be673-3db1-4fd9-8ff4-6c89d8b8a79e}
Note: You have to turn on “Show internal values” to see the GUID-value in the property window:
