Upload
others
View
24
Download
0
Embed Size (px)
Citation preview
Documentation
Initial Setup and Configuration
Trimble Quadri 20FP6 and newer Date 15012018
Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 2
Table of Contents
1 ABOUT THIS SETUP AND CONFIGURE TRIMBLE QUADRI DOCUMENT 3
2 GETTING AN AUTHORIZATION CODE 3
3 DOWNLOAD TRIMBLE QUADRI INSTALLATION PACKAGE 3
4 PREREQUISITES FOR A SUCCESSFUL TRIMBLE QUADRI INSTALLATION 4
41 OPERATING SYSTEM 4 42 SYSTEM ACCESS USING A SYSTEM ADMINISTRATOR ACCOUNT 4 43 SYSTEM HARDWARE REQUIREMENTS 4 44 MICROSOFT NET 40 FRAMEWORK 4 45 ENABLE APPLICATION SERVER AND WEB SERVER (IIS) SUPPORT 4
451 Enabling in Windows 2008 R2 Server 4 452 Enabling in Windows 2012 R2 Server 9
46 OPEN FOR ACCESS TO MICROSOFT SITE FOR DOWNLOADING MICROSOFT WEB DEPLOY SERVICE 14 47 WINDOWS UPDATE 14 48 SOURCE FOR USER ACCOUNTS 14
481 Active Directory as source for user accounts 14 482 Trimble Identity as source for user accounts 14
5 INSTALL TRIMBLE QUADRI EMBEDDED DATABASE SERVER 14
6 INSTALL TRIMBLE QUADRI 15
7 INITIAL CONFIGURATION OF TRIMBLE QUADRI 16
71 CREATE NEW TRIMBLE QUADRI 16 711 Installation and Configuration of the Embedded Database Server 17 712 Trimble Quadri Web Application Configuration 18 713 Trimble Quadri Configuration 20
72 DOCUMENTATION OF THE INSTALLATION AND CONFIGURATION 23
8 ADD A VALID LICENSE KEY TO TRIMBLE QUADRI 24
9 MODIFY THE SCHEDULE OF THE INTERNAL HOT DATA BACK-UP 24
91 FULL BACK-UP 25 92 INCREMENTAL BACK-UP 25
10 UPGRADE A TRIMBLE QUADRI INSTALLATION TO A NEWER VERSION 26
11 RECONFIGURE AN EXISTING TRIMBLE QUADRI INSTALLATION 26
111 RECONFIGURE TRIMBLE QUADRI TO USE ACTIVE DIRECTORY AS SOURCE FOR USER ACCOUNTS 27
12 STEP BY STEP GUIDE TO VERIFY THE TRIMBLE QUADRI INSTALLATION 29
121 VERIFY CONNECTION AND AUTHENTICATION 29 122 VERIFY THAT A TEST MODEL CAN BE CREATED 29 123 VERIFY THAT A TEST PROJECTS CAN BE CREATED AND USED 30 124 VERIFY THAT HOT DATA BACK-UP CAN BE PERFORMED 30 125 VERIFY THAT HUMAN ERROR RECOVERY IS POSSIBLE 31 126 VERIFY THAT SCHEDULED HOT DATA BACK-UP IS RUNNING 32 127 CLEAN UP AFTER VERIFICATION TEST 32
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 3
1 About this Setup and configure Trimble Quadri document
This document describes how to install and configure Trimble Quadri in a corporate network
The most up to date version of this document can be downloaded from httphelpnovapointcom
This version of the document is updated 15th of January 2018
2 Getting an authorization code
In order to use Trimble Quadri ldquoPrivate Cloudrdquo1) you need an authorization code for the number of
users that your license covers Send a mail to novapointordervianovano We will keep in touch
with you within latest 2 hours after the download in our service centres opening time 2) We will
setup a Trimble Quadri Term agreement and agree an appointment with our Trimble Quadri
Serviceteam who will guide you through the installation setup
1) Private Cloud Server and operating environment is Customers responsibility (Both hardware and software)
2) Service Centre Open between 0900-1500 CET
3 Download Trimble Quadri Installation Package
Download the installation package using the link received from Trimble Solutions Sandvika AS
In general all installation packages can be downloaded from this site
ftpWebfilesW5bf1esftpnovapointcomDownloadsQuadriDCM
The installation package is distributed as zip files and the downloaded ZIP-files should be unzipped
to a new folder that does not contain any other files All files must be kept together in the same
structure as they are unzipped
The installation package contains these files
1 Readme[version number]txt
2 Trimble Quadri Embedded DB server 11204zip
3 Quadri DCM setup_[version number]zip
Readme [version number]txt contains important information (typically last minute info) related to
the specific installation of one version You should always read this file
Files in Trimble Quadri Embedded DB server 11204zip is the setup files that installs the
embedded database server
Files in Quadri DCM setup_[version number]zip is the setup files that installs the application
server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 4
4 Prerequisites for a successful Trimble Quadri installation
41 Operating System
Trimble Quadri is currently using Windows Server 2008 R2 or Windows Server 2012 R2
Windows Server 2012 R2 is the recommended OS for new installations
42 System Access using a System Administrator Account
The installation and configuration must be done using a system administrator account on the
Windows Server
43 System Hardware Requirements
For system hardware requirement see
httphelpnovapointcomdokuphpid=ennpmiscellaneoussystem_requirementssystem_require
ments_Trimble Quadri
44 Microsoft NET 40 Framework
Trimble Quadri depends on Microsoft NET 40 Framework
In Windows 2008 R2 Server it is suitable to install the framework run Windows Update install all
related updates and if needed restart the server before continuing
In Windows 2012 R2 Server it is already a part of operating system
45 Enable Application Server and Web Server (IIS) support
Trimble Quadri depends on the Application Server and the Web Server (IIS) support
on your Windows 2008 R2 Server or Windows 2012 R2 Server What to be enable is slightly
different for the two versions
451 Enabling in Windows 2008 R2 Server
Trimble Quadri depends on the Application Server and the Web Server (IIS) support
on your Windows 2008 R2 Server
Open Server Manager and select the Roles node
Click ldquoAdd Rolesrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 5
The ldquoAdd Roles Wizardrdquo opens in a new Window
Click ldquoNextrdquo
Select ldquoApplication Serverrdquo and ldquoWeb Server (IIS)rdquo
When selecting ldquoApplication Serverrdquo a dialog box regarding required features is displayed
Click ldquoAdd Required Featuresrdquo in the dialog box
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 6
Click ldquoNextrdquo
Select ldquoWeb Server (IIS) Supportrdquo
When selecting ldquoWeb Server (IIS) Supportrdquo a dialog box regarding required role services
and features is displayed
Click ldquoAdd Required Role Servicesrdquo in the dialog box
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 7
Click ldquoNextrdquo
Select ldquoServer Side Includesrdquo under ldquoApplication Developmentrdquo
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 8
Click ldquoInstallrdquo
Wait for the installation to complete
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 9
Click ldquoCloserdquo
452 Enabling in Windows 2012 R2 Server
Open Server Manager and select Add roles and features
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 10
The Add Roles and Features Wizard opens in a new window
Click Next
On the Select Installation type screen select Role-based or feature-based installation
On the Select destination server screen select the target server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 11
On the Select Server Roles screen select Application Server
Select Web Server (IIS)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 12
When selecting Web Server (IIS) a dialog box regarding required features is displayed
Click Add Features in the box
On the Select features screen select Windows Process Activation Service
On the Role Services screen select Web Server (IIS) Support
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 2
Table of Contents
1 ABOUT THIS SETUP AND CONFIGURE TRIMBLE QUADRI DOCUMENT 3
2 GETTING AN AUTHORIZATION CODE 3
3 DOWNLOAD TRIMBLE QUADRI INSTALLATION PACKAGE 3
4 PREREQUISITES FOR A SUCCESSFUL TRIMBLE QUADRI INSTALLATION 4
41 OPERATING SYSTEM 4 42 SYSTEM ACCESS USING A SYSTEM ADMINISTRATOR ACCOUNT 4 43 SYSTEM HARDWARE REQUIREMENTS 4 44 MICROSOFT NET 40 FRAMEWORK 4 45 ENABLE APPLICATION SERVER AND WEB SERVER (IIS) SUPPORT 4
451 Enabling in Windows 2008 R2 Server 4 452 Enabling in Windows 2012 R2 Server 9
46 OPEN FOR ACCESS TO MICROSOFT SITE FOR DOWNLOADING MICROSOFT WEB DEPLOY SERVICE 14 47 WINDOWS UPDATE 14 48 SOURCE FOR USER ACCOUNTS 14
481 Active Directory as source for user accounts 14 482 Trimble Identity as source for user accounts 14
5 INSTALL TRIMBLE QUADRI EMBEDDED DATABASE SERVER 14
6 INSTALL TRIMBLE QUADRI 15
7 INITIAL CONFIGURATION OF TRIMBLE QUADRI 16
71 CREATE NEW TRIMBLE QUADRI 16 711 Installation and Configuration of the Embedded Database Server 17 712 Trimble Quadri Web Application Configuration 18 713 Trimble Quadri Configuration 20
72 DOCUMENTATION OF THE INSTALLATION AND CONFIGURATION 23
8 ADD A VALID LICENSE KEY TO TRIMBLE QUADRI 24
9 MODIFY THE SCHEDULE OF THE INTERNAL HOT DATA BACK-UP 24
91 FULL BACK-UP 25 92 INCREMENTAL BACK-UP 25
10 UPGRADE A TRIMBLE QUADRI INSTALLATION TO A NEWER VERSION 26
11 RECONFIGURE AN EXISTING TRIMBLE QUADRI INSTALLATION 26
111 RECONFIGURE TRIMBLE QUADRI TO USE ACTIVE DIRECTORY AS SOURCE FOR USER ACCOUNTS 27
12 STEP BY STEP GUIDE TO VERIFY THE TRIMBLE QUADRI INSTALLATION 29
121 VERIFY CONNECTION AND AUTHENTICATION 29 122 VERIFY THAT A TEST MODEL CAN BE CREATED 29 123 VERIFY THAT A TEST PROJECTS CAN BE CREATED AND USED 30 124 VERIFY THAT HOT DATA BACK-UP CAN BE PERFORMED 30 125 VERIFY THAT HUMAN ERROR RECOVERY IS POSSIBLE 31 126 VERIFY THAT SCHEDULED HOT DATA BACK-UP IS RUNNING 32 127 CLEAN UP AFTER VERIFICATION TEST 32
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 3
1 About this Setup and configure Trimble Quadri document
This document describes how to install and configure Trimble Quadri in a corporate network
The most up to date version of this document can be downloaded from httphelpnovapointcom
This version of the document is updated 15th of January 2018
2 Getting an authorization code
In order to use Trimble Quadri ldquoPrivate Cloudrdquo1) you need an authorization code for the number of
users that your license covers Send a mail to novapointordervianovano We will keep in touch
with you within latest 2 hours after the download in our service centres opening time 2) We will
setup a Trimble Quadri Term agreement and agree an appointment with our Trimble Quadri
Serviceteam who will guide you through the installation setup
1) Private Cloud Server and operating environment is Customers responsibility (Both hardware and software)
2) Service Centre Open between 0900-1500 CET
3 Download Trimble Quadri Installation Package
Download the installation package using the link received from Trimble Solutions Sandvika AS
In general all installation packages can be downloaded from this site
ftpWebfilesW5bf1esftpnovapointcomDownloadsQuadriDCM
The installation package is distributed as zip files and the downloaded ZIP-files should be unzipped
to a new folder that does not contain any other files All files must be kept together in the same
structure as they are unzipped
The installation package contains these files
1 Readme[version number]txt
2 Trimble Quadri Embedded DB server 11204zip
3 Quadri DCM setup_[version number]zip
Readme [version number]txt contains important information (typically last minute info) related to
the specific installation of one version You should always read this file
Files in Trimble Quadri Embedded DB server 11204zip is the setup files that installs the
embedded database server
Files in Quadri DCM setup_[version number]zip is the setup files that installs the application
server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 4
4 Prerequisites for a successful Trimble Quadri installation
41 Operating System
Trimble Quadri is currently using Windows Server 2008 R2 or Windows Server 2012 R2
Windows Server 2012 R2 is the recommended OS for new installations
42 System Access using a System Administrator Account
The installation and configuration must be done using a system administrator account on the
Windows Server
43 System Hardware Requirements
For system hardware requirement see
httphelpnovapointcomdokuphpid=ennpmiscellaneoussystem_requirementssystem_require
ments_Trimble Quadri
44 Microsoft NET 40 Framework
Trimble Quadri depends on Microsoft NET 40 Framework
In Windows 2008 R2 Server it is suitable to install the framework run Windows Update install all
related updates and if needed restart the server before continuing
In Windows 2012 R2 Server it is already a part of operating system
45 Enable Application Server and Web Server (IIS) support
Trimble Quadri depends on the Application Server and the Web Server (IIS) support
on your Windows 2008 R2 Server or Windows 2012 R2 Server What to be enable is slightly
different for the two versions
451 Enabling in Windows 2008 R2 Server
Trimble Quadri depends on the Application Server and the Web Server (IIS) support
on your Windows 2008 R2 Server
Open Server Manager and select the Roles node
Click ldquoAdd Rolesrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 5
The ldquoAdd Roles Wizardrdquo opens in a new Window
Click ldquoNextrdquo
Select ldquoApplication Serverrdquo and ldquoWeb Server (IIS)rdquo
When selecting ldquoApplication Serverrdquo a dialog box regarding required features is displayed
Click ldquoAdd Required Featuresrdquo in the dialog box
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 6
Click ldquoNextrdquo
Select ldquoWeb Server (IIS) Supportrdquo
When selecting ldquoWeb Server (IIS) Supportrdquo a dialog box regarding required role services
and features is displayed
Click ldquoAdd Required Role Servicesrdquo in the dialog box
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 7
Click ldquoNextrdquo
Select ldquoServer Side Includesrdquo under ldquoApplication Developmentrdquo
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 8
Click ldquoInstallrdquo
Wait for the installation to complete
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 9
Click ldquoCloserdquo
452 Enabling in Windows 2012 R2 Server
Open Server Manager and select Add roles and features
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 10
The Add Roles and Features Wizard opens in a new window
Click Next
On the Select Installation type screen select Role-based or feature-based installation
On the Select destination server screen select the target server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 11
On the Select Server Roles screen select Application Server
Select Web Server (IIS)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 12
When selecting Web Server (IIS) a dialog box regarding required features is displayed
Click Add Features in the box
On the Select features screen select Windows Process Activation Service
On the Role Services screen select Web Server (IIS) Support
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 3
1 About this Setup and configure Trimble Quadri document
This document describes how to install and configure Trimble Quadri in a corporate network
The most up to date version of this document can be downloaded from httphelpnovapointcom
This version of the document is updated 15th of January 2018
2 Getting an authorization code
In order to use Trimble Quadri ldquoPrivate Cloudrdquo1) you need an authorization code for the number of
users that your license covers Send a mail to novapointordervianovano We will keep in touch
with you within latest 2 hours after the download in our service centres opening time 2) We will
setup a Trimble Quadri Term agreement and agree an appointment with our Trimble Quadri
Serviceteam who will guide you through the installation setup
1) Private Cloud Server and operating environment is Customers responsibility (Both hardware and software)
2) Service Centre Open between 0900-1500 CET
3 Download Trimble Quadri Installation Package
Download the installation package using the link received from Trimble Solutions Sandvika AS
In general all installation packages can be downloaded from this site
ftpWebfilesW5bf1esftpnovapointcomDownloadsQuadriDCM
The installation package is distributed as zip files and the downloaded ZIP-files should be unzipped
to a new folder that does not contain any other files All files must be kept together in the same
structure as they are unzipped
The installation package contains these files
1 Readme[version number]txt
2 Trimble Quadri Embedded DB server 11204zip
3 Quadri DCM setup_[version number]zip
Readme [version number]txt contains important information (typically last minute info) related to
the specific installation of one version You should always read this file
Files in Trimble Quadri Embedded DB server 11204zip is the setup files that installs the
embedded database server
Files in Quadri DCM setup_[version number]zip is the setup files that installs the application
server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 4
4 Prerequisites for a successful Trimble Quadri installation
41 Operating System
Trimble Quadri is currently using Windows Server 2008 R2 or Windows Server 2012 R2
Windows Server 2012 R2 is the recommended OS for new installations
42 System Access using a System Administrator Account
The installation and configuration must be done using a system administrator account on the
Windows Server
43 System Hardware Requirements
For system hardware requirement see
httphelpnovapointcomdokuphpid=ennpmiscellaneoussystem_requirementssystem_require
ments_Trimble Quadri
44 Microsoft NET 40 Framework
Trimble Quadri depends on Microsoft NET 40 Framework
In Windows 2008 R2 Server it is suitable to install the framework run Windows Update install all
related updates and if needed restart the server before continuing
In Windows 2012 R2 Server it is already a part of operating system
45 Enable Application Server and Web Server (IIS) support
Trimble Quadri depends on the Application Server and the Web Server (IIS) support
on your Windows 2008 R2 Server or Windows 2012 R2 Server What to be enable is slightly
different for the two versions
451 Enabling in Windows 2008 R2 Server
Trimble Quadri depends on the Application Server and the Web Server (IIS) support
on your Windows 2008 R2 Server
Open Server Manager and select the Roles node
Click ldquoAdd Rolesrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 5
The ldquoAdd Roles Wizardrdquo opens in a new Window
Click ldquoNextrdquo
Select ldquoApplication Serverrdquo and ldquoWeb Server (IIS)rdquo
When selecting ldquoApplication Serverrdquo a dialog box regarding required features is displayed
Click ldquoAdd Required Featuresrdquo in the dialog box
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 6
Click ldquoNextrdquo
Select ldquoWeb Server (IIS) Supportrdquo
When selecting ldquoWeb Server (IIS) Supportrdquo a dialog box regarding required role services
and features is displayed
Click ldquoAdd Required Role Servicesrdquo in the dialog box
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 7
Click ldquoNextrdquo
Select ldquoServer Side Includesrdquo under ldquoApplication Developmentrdquo
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 8
Click ldquoInstallrdquo
Wait for the installation to complete
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 9
Click ldquoCloserdquo
452 Enabling in Windows 2012 R2 Server
Open Server Manager and select Add roles and features
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 10
The Add Roles and Features Wizard opens in a new window
Click Next
On the Select Installation type screen select Role-based or feature-based installation
On the Select destination server screen select the target server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 11
On the Select Server Roles screen select Application Server
Select Web Server (IIS)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 12
When selecting Web Server (IIS) a dialog box regarding required features is displayed
Click Add Features in the box
On the Select features screen select Windows Process Activation Service
On the Role Services screen select Web Server (IIS) Support
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 4
4 Prerequisites for a successful Trimble Quadri installation
41 Operating System
Trimble Quadri is currently using Windows Server 2008 R2 or Windows Server 2012 R2
Windows Server 2012 R2 is the recommended OS for new installations
42 System Access using a System Administrator Account
The installation and configuration must be done using a system administrator account on the
Windows Server
43 System Hardware Requirements
For system hardware requirement see
httphelpnovapointcomdokuphpid=ennpmiscellaneoussystem_requirementssystem_require
ments_Trimble Quadri
44 Microsoft NET 40 Framework
Trimble Quadri depends on Microsoft NET 40 Framework
In Windows 2008 R2 Server it is suitable to install the framework run Windows Update install all
related updates and if needed restart the server before continuing
In Windows 2012 R2 Server it is already a part of operating system
45 Enable Application Server and Web Server (IIS) support
Trimble Quadri depends on the Application Server and the Web Server (IIS) support
on your Windows 2008 R2 Server or Windows 2012 R2 Server What to be enable is slightly
different for the two versions
451 Enabling in Windows 2008 R2 Server
Trimble Quadri depends on the Application Server and the Web Server (IIS) support
on your Windows 2008 R2 Server
Open Server Manager and select the Roles node
Click ldquoAdd Rolesrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 5
The ldquoAdd Roles Wizardrdquo opens in a new Window
Click ldquoNextrdquo
Select ldquoApplication Serverrdquo and ldquoWeb Server (IIS)rdquo
When selecting ldquoApplication Serverrdquo a dialog box regarding required features is displayed
Click ldquoAdd Required Featuresrdquo in the dialog box
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 6
Click ldquoNextrdquo
Select ldquoWeb Server (IIS) Supportrdquo
When selecting ldquoWeb Server (IIS) Supportrdquo a dialog box regarding required role services
and features is displayed
Click ldquoAdd Required Role Servicesrdquo in the dialog box
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 7
Click ldquoNextrdquo
Select ldquoServer Side Includesrdquo under ldquoApplication Developmentrdquo
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 8
Click ldquoInstallrdquo
Wait for the installation to complete
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 9
Click ldquoCloserdquo
452 Enabling in Windows 2012 R2 Server
Open Server Manager and select Add roles and features
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 10
The Add Roles and Features Wizard opens in a new window
Click Next
On the Select Installation type screen select Role-based or feature-based installation
On the Select destination server screen select the target server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 11
On the Select Server Roles screen select Application Server
Select Web Server (IIS)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 12
When selecting Web Server (IIS) a dialog box regarding required features is displayed
Click Add Features in the box
On the Select features screen select Windows Process Activation Service
On the Role Services screen select Web Server (IIS) Support
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 5
The ldquoAdd Roles Wizardrdquo opens in a new Window
Click ldquoNextrdquo
Select ldquoApplication Serverrdquo and ldquoWeb Server (IIS)rdquo
When selecting ldquoApplication Serverrdquo a dialog box regarding required features is displayed
Click ldquoAdd Required Featuresrdquo in the dialog box
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 6
Click ldquoNextrdquo
Select ldquoWeb Server (IIS) Supportrdquo
When selecting ldquoWeb Server (IIS) Supportrdquo a dialog box regarding required role services
and features is displayed
Click ldquoAdd Required Role Servicesrdquo in the dialog box
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 7
Click ldquoNextrdquo
Select ldquoServer Side Includesrdquo under ldquoApplication Developmentrdquo
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 8
Click ldquoInstallrdquo
Wait for the installation to complete
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 9
Click ldquoCloserdquo
452 Enabling in Windows 2012 R2 Server
Open Server Manager and select Add roles and features
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 10
The Add Roles and Features Wizard opens in a new window
Click Next
On the Select Installation type screen select Role-based or feature-based installation
On the Select destination server screen select the target server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 11
On the Select Server Roles screen select Application Server
Select Web Server (IIS)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 12
When selecting Web Server (IIS) a dialog box regarding required features is displayed
Click Add Features in the box
On the Select features screen select Windows Process Activation Service
On the Role Services screen select Web Server (IIS) Support
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 6
Click ldquoNextrdquo
Select ldquoWeb Server (IIS) Supportrdquo
When selecting ldquoWeb Server (IIS) Supportrdquo a dialog box regarding required role services
and features is displayed
Click ldquoAdd Required Role Servicesrdquo in the dialog box
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 7
Click ldquoNextrdquo
Select ldquoServer Side Includesrdquo under ldquoApplication Developmentrdquo
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 8
Click ldquoInstallrdquo
Wait for the installation to complete
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 9
Click ldquoCloserdquo
452 Enabling in Windows 2012 R2 Server
Open Server Manager and select Add roles and features
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 10
The Add Roles and Features Wizard opens in a new window
Click Next
On the Select Installation type screen select Role-based or feature-based installation
On the Select destination server screen select the target server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 11
On the Select Server Roles screen select Application Server
Select Web Server (IIS)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 12
When selecting Web Server (IIS) a dialog box regarding required features is displayed
Click Add Features in the box
On the Select features screen select Windows Process Activation Service
On the Role Services screen select Web Server (IIS) Support
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 7
Click ldquoNextrdquo
Select ldquoServer Side Includesrdquo under ldquoApplication Developmentrdquo
Click ldquoNextrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 8
Click ldquoInstallrdquo
Wait for the installation to complete
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 9
Click ldquoCloserdquo
452 Enabling in Windows 2012 R2 Server
Open Server Manager and select Add roles and features
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 10
The Add Roles and Features Wizard opens in a new window
Click Next
On the Select Installation type screen select Role-based or feature-based installation
On the Select destination server screen select the target server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 11
On the Select Server Roles screen select Application Server
Select Web Server (IIS)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 12
When selecting Web Server (IIS) a dialog box regarding required features is displayed
Click Add Features in the box
On the Select features screen select Windows Process Activation Service
On the Role Services screen select Web Server (IIS) Support
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 8
Click ldquoInstallrdquo
Wait for the installation to complete
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 9
Click ldquoCloserdquo
452 Enabling in Windows 2012 R2 Server
Open Server Manager and select Add roles and features
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 10
The Add Roles and Features Wizard opens in a new window
Click Next
On the Select Installation type screen select Role-based or feature-based installation
On the Select destination server screen select the target server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 11
On the Select Server Roles screen select Application Server
Select Web Server (IIS)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 12
When selecting Web Server (IIS) a dialog box regarding required features is displayed
Click Add Features in the box
On the Select features screen select Windows Process Activation Service
On the Role Services screen select Web Server (IIS) Support
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 9
Click ldquoCloserdquo
452 Enabling in Windows 2012 R2 Server
Open Server Manager and select Add roles and features
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 10
The Add Roles and Features Wizard opens in a new window
Click Next
On the Select Installation type screen select Role-based or feature-based installation
On the Select destination server screen select the target server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 11
On the Select Server Roles screen select Application Server
Select Web Server (IIS)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 12
When selecting Web Server (IIS) a dialog box regarding required features is displayed
Click Add Features in the box
On the Select features screen select Windows Process Activation Service
On the Role Services screen select Web Server (IIS) Support
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 10
The Add Roles and Features Wizard opens in a new window
Click Next
On the Select Installation type screen select Role-based or feature-based installation
On the Select destination server screen select the target server
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 11
On the Select Server Roles screen select Application Server
Select Web Server (IIS)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 12
When selecting Web Server (IIS) a dialog box regarding required features is displayed
Click Add Features in the box
On the Select features screen select Windows Process Activation Service
On the Role Services screen select Web Server (IIS) Support
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 11
On the Select Server Roles screen select Application Server
Select Web Server (IIS)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 12
When selecting Web Server (IIS) a dialog box regarding required features is displayed
Click Add Features in the box
On the Select features screen select Windows Process Activation Service
On the Role Services screen select Web Server (IIS) Support
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 12
When selecting Web Server (IIS) a dialog box regarding required features is displayed
Click Add Features in the box
On the Select features screen select Windows Process Activation Service
On the Role Services screen select Web Server (IIS) Support
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 13
When selecting Web Server (IIS) Support a dialog box regarding required features is
displayed Click Add Features in the box
Select HTTP Activation
On Confirm installation selections screen select install
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 14
46 Open for access to Microsoft site for downloading Microsoft Web Deploy service
Installation of Trimble Quadri requires internet access to a Microsoft site for downloading
Microsoft Web Deploy service
Alternatively download from the link below and install it before you continue
httpdownloadmicrosoftcomdownload89B89B754A5-56F7-45BD-B074-
8974FD2039AFWebDeploy_2_10_amd64_en-USmsi
Trimble Quadri requires access to this later during upcoming upgrades So do not remove this web
deploy service
47 Windows Update
Please run Windows Update install all updates and if needed restart the server before continuing
48 Source for user accounts
During installation of Trimble Quadri you can decide to use Active Directory or Trimble Identity
as source for user accounts and not the user account system embedded in Trimble Quadri
481 Active Directory as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to AD every time
necessary No users from AD will be stored in the Trimble Quadri database and no synchronization
between Trimble Quadri and AD is necessary
If you have decided to use Active Directory as source for user accounts you must complete
the configuration from within Quadri Model Manager
482 Trimble Identity as source for user accounts
If you select AD as source for users QMM and Novapoint will connect to Trimble Identity every
time necessary No user information will be stored in the Trimble Quadri database and no
synchronization between Trimble Quadri and Trimble Identity is necessary
5 Install Trimble Quadri Embedded Database Server
Right-click Trimble Quadri Embedded DB server 11204msi in the folder where Trimble Quadri
Embedded DB server 11204zip
was unzipped and select ldquoRun as Administratorrdquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 15
Now follow the instructions from the wizard to install Trimble Quadri Embedded Database Server
6 Install Trimble Quadri
This installation step can only be carried out if Trimble Quadri Embedded Database Server is
installed
Right-click Quadri DCM setup_[version number]exe in the folder where the installation was unzipped
and select ldquoRun as Administratorrdquo
Now follow the instructions from the wizard to install Trimble Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 16
7 Initial configuration of Trimble Quadri
After installing Trimble Quadri a shortcut is created on the Start Menu
In Windows 2008 R2 Server if the shortcut is not found when clicking the Start-button please go to
ldquoAll ProgramsVianovaQuadri DCMConfiguration Toolrdquo
In Windows 2012 R2 Server the shortcut can be found in the Apps screen
This tool is used to configure Trimble Quadri
71 Create new Trimble Quadri
Start the Configuration Tool to configure a new server
Click the ldquoNew Trimble Quadrirdquo-button on the start-screen to start configuring a new Trimble
Quadri
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 17
The smaller buttons are for reconfiguring existing server setup or change connection to Active
Directory unlock database System account and database QMSYS account and to display Help
information
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Continuing the configuration will be possible even if the prerequisites are not met but the
configuration might fail or the daily use of the system may suffer
711 Installation and Configuration of the Embedded Database Server
The installation and configuration process contains these steps which you must carry out in this
order
1 Database
2 Patches
3 Backup
4 Schedule
5 Schema
6 Tests
7 Firewall
You may run the steps Schema Tests and Firewall multiple times
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 18
1 Select drives to install the database embedded with Trimble Quadri
a SW Drive for the embedded database software
b Data Drive used for storing database data
c Backup Drive used for storing database backup-files
Do not install any part of the embedded database on a removable drive
2 Click ldquoDatabaserdquo- button and wait for the database configuration to complete ndash this operation
might take a while
Verify that all selected components have been installed and Click ldquoOKrdquo-button
Click the expand-button to the right (marked ldquordquo) to continue with the next step
712 Trimble Quadri Web Application Configuration
In this section you specify the different parts of the URL the end users use to utilize the Trimble
Quadri you are installing
1 Click the button IIS Values
2 Set up port that Trimble Quadri will be accessed through Default value is 80
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 19
3 Set up path to Quadri Model Manager (QMM)
o Specify a value for the optional Application Group As default this sub-part of the
path is not used
o Specify a value for QMM Name Default value is qmmweb
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character lsquondashlsquoand lsquo_rsquo
4 Click OK to save (Itrsquos required to click OK at least once)
5 Click the button lsquoSSL(Off)rsquo if you want to secure Trimble Quadri by using SSL
6 Check the SSL checkbox and browse to the SSL Certificate File
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 20
7 Type the SSL Certificate password and click OK to save
8 Click the ldquoIISrdquo-button
9 Wait for the Trimble Quadri Model Manager Installation and configuration to complete
10 Verify that all selected components have been installed and Click ldquoOKrdquo-button
The configuration of the web application may be started multiple times
11 Click the expand-button to the right (marked ldquordquo) to continue to the next step
713 Trimble Quadri Configuration
1 Click lsquoParametersrsquo button
a) Specify the application name if you donrsquot want to use the default name lsquoquadrirsquo Be
aware that if an optional Application Group is specified in 3 Set up path to Quadri
Model Manager (QMM) then this application group will used in addition to the
Application name here
Allowed characters are lowercase letters lsquoa ndash zrsquo digits lsquo0 ndash 9rsquo and special character
lsquondashlsquoand lsquo_rsquo
b) Specify server alias if you donrsquot want to use the default alias lsquoTrimble Quadrirsquo
c) If you donrsquot want to make logs from the server side available for clients remove
check for lsquoAllow Server Logsrsquo
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 21
d) Click OK button to apply the changes
Unless you have several Trimble Quadri installation that due to technical issues needs to
be separated by unique application names we recommends that you use the default
application name lsquoquadrirsquo
Server alias is used as a ldquofriendly namerdquo in the client for the connection data that points to
this specific Trimble Quadri installation This replace the IP-address port application
name etc in the user interface
Allow server logs creates a Virtual Directory that makes it possible to download trace logs
from the server side from the clients in the context of crash reporting
2 Select the source for the user accounts ndash lsquoTrimble Quadri Usersrsquo (embedded user accounts)
Active Directory or Trimble Identity
If you select lsquoTrimble Quadri Usersrsquo or lsquoActive Directoryrsquo you should drop the next step
and continue at step 4
If you select Trimble Quadri users the user accounts have to be created in QMM If you
select Active Directory you get the user accounts from a specified Active Directory server
And if you select Trimble Identity user must Sign up to create their own Trimble identity
3 Click lsquoTID Valuesrsquo
Specify Consumer Key and Consumer Secret
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 22
4 Specify a password for the user account ldquoadminrdquo
Specify the password to use for the user account lsquoadminrsquo
The Password must be between 8 and 50 characters long and have at least three out of four
of these characters lowercase uppercase digit and special character
Special characters are the following $amp()+-ltgt=_|
Dependent of whether you configure Trimble Quadri to use Active Directory or not the use
of this password is slightly different
a) If user source is lsquoTrimble Quadri Usersrsquo then this password must be used when you
start up and sign in to QMM as the only account that are authorized to use QMM is
the lsquoadminrsquo account On some major irreversible actions like deleting a model this
password must be used to confirm the selected action
b) If user source is lsquoActive Directoryrsquo or lsquoTrimble Identityrsquo this password must also
be used to confirm major irreversible action like deleting a model
5 Please write down the admin-password and deliver the information to the person(s) who are
going to manage the models in this Trimble Quadri installation
6 Click the lsquoTrimble Quadrirsquo button and wait for the Trimble Quadri configuration to
complete
A new Trimble Quadri application is now created
An Internet Explorer instance with the Trimble Quadri Model Manager site (aka QMM)
will be started if the installation is successful If you have selected Trimble Quadri users
the username is ldquoadminrdquo and password is the one specified above If you have selected
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 23
users from Active Directory you have to create a group in AD called QMM Users and add
users that should be able to log in to QMM All users in the QMM Users group will be able
to log in to QMM with their AD credentials
A shortcut to the Trimble Quadri Model Manager site (QMM) is also installed on the
desktop of the server
72 Documentation of the installation and configuration
1 Click ldquoLrdquo-button to open Log for the installation and configuration
2 Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 24
8 Add a valid license key to Trimble Quadri
When the installation of Trimble Quadri is finished you need to start Trimble Quadri Model
Manager (QMM) to add the authorization key
Trimble Quadri Model Manager is a web-application designed to administrate the Trimble Quadri
installation When you install Trimble Quadri the application is automatically installed and is
accessible on the server desktop and in the Start Menu
This link
httphelpnovapointcomdokuphpid=ennpserverqmmcontractsstart
contains information about how to add a valid license key for Trimble Quadri
If you have selected Trimble Quadri users during the installation the username is ldquoadminrdquo and
password is the one specified when installing
If you have selected users from Active Directory use any of the username for any of the members of
the QMM Users group who will all be able to sign in to QMM with their windows credentials
9 Modify the schedule of the internal hot data back-up
As default the internal hot data back-up runs with full back-up every Sunday at 0100 and
incremental backup once a day at 0100 on the six subsequent days The back-up files recycles
every week
To modify the schedule you open Windows Task Scheduler
Mark the actual task lsquoFull backup of Quadrirsquo and open the associated properties dialog
Locate the tab Triggers and edit the scheduling plan according to the needs
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 25
91 Full back-up
92 Incremental back-up
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 26
10 Upgrade a Trimble Quadri installation to a newer version
For each new version of Trimble Quadri there exist a setup and configuration document with info
about how to upgrade a given version of the Trimble Quadri configuration to a newer version
These setup and configuration documents are located here
httphelpnovapointcomdokuphpid=ennpservertechnical_documentationupgradesstart
Be aware that currently it is not possible to have two versions of Trimble Quadri running on one
computer
11 Reconfigure an existing Trimble Quadri installation
Click the ldquoExisting Serverrdquo-button on the start-screen to reconfigure a Trimble Quadri
You will be asked for a password for the database System Account to continue
If any of the prerequisites are not met a window displaying the prerequisites will be activated
Installation will be possible even if the prerequisites are not met but the installation might fail or
the daily use of the Trimble Quadri may suffer
Click ldquoDatabaserdquo button
By default there are only two steps available in the Existing Server interface
Tests
Open port in Firewall
These steps can be selected and started multiple times
Wait for the selected steps to complete
Wait until all selected steps have been completed and Click ldquoOKrdquo
Click ldquoTrimble Quadri Model Managerrdquo button
The Trimble Quadri Model Manager installation and configuration can be started multiple
times
Wait for the Trimble Quadri Model Manager Installation and configuration to complete
An Internet Explorer instance with the Model Manager site will be started if the installation
is successful
A shortcut to the Model Manager site is also installed on the desktop of the server
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoTrimble Quadrirdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 27
The Trimble Quadri installation and configuration can be started multiple times
Wait for the Trimble Quadri installation and configuration to complete
Verify that all selected components have been installed and Click ldquoOKrdquo
Click ldquoLrdquo-button to open Log for the installation and configuration
Please save the log-file to your local disk (ldquoFilerdquo ldquoSave Ashelliprdquo in Notepad)
111 Reconfigure Trimble Quadri to use Active Directory as source for user accounts
If you have selected Active Directory as source for user accounts you need to set up a
connection to the Active Directory server that contains the user accounts
In the configuration tool click the ldquoSetupChange Active Directoryrdquo button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 28
Fill in the parameters
This link
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
contains more info about the parameters
You may also use QMM to set up the parameters to connect to Active Directory Log in to
QMM and select the Admin tab and Ldap Parameters See here for more info on the
parameters
httphelpnovapointcomdokuphpid=ennpserverqmmadminldap_parametersstart
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 29
12 Step by step guide to verify the Trimble Quadri installation
By carrying out the steps bellow it can be verified that the Trimble Quadri installation is successful
and any problems might be sorted out before end users start to use the installation in their daily
work
To carry out the verification process you need some minimum knowledge about how to use the
Trimble Quadri Model Manager and Novapoint as a client on Trimble Quadri
If you do not hold that knowledge yourself you should contact someone in your organization that
might help you to carry out this process
Your local Trimble Quadri contact may also give you help and advices Novapoint resource centre
httphelpnovapointcomdokuphpid=start is also a good source for knowledge
Documentation for QMM can be found here
httphelpnovapointcomdokuphpid=ennpserverqmmstart
And How to get started with Trimble Quadri section
httphelpnovapointcomdokuphpid=ennpserverqmmtutorialshow_to_get_startedstart
Data files used during the verification process can be downloaded from
httphelpnovapointcomlibexefetchphpmedia=ennpservertechnical_documentationdata_file
s_to_verify_Trimble Quadri_installationzipx
121 Verify connection and authentication
Start a web browser and enter the following URL http[addressport][applicationname]loginindexhtml
Your browserrsquos Sign In dialogue should appear
Sign In as lsquoAdminrsquo and use the password you specified during the initial configuration of Trimble
Quadri
A page with the text lsquoHello World from Quadri Login Handlerrsquo should appear
122 Verify that a test model can be created
Start a web browser and enter the URL for QMM
User Accounts -gt New account
Username TestUser
Models -gt Add a model
Model Name TestModel
Feature Catalogue Quadri_1903_104
Storage CRS
Configuration All
Projected 3044
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 30
Vertical 5776
Projected Workset CRS
3044
Vertical Workset CRS
5776
Models -gt Modify model -gt Users
Add TestUser as user of TestModel
Models -gt Modify model -gt Roles
TestUser should hold both roles (Project admin + Design) for TestModel
123 Verify that a test projects can be created and used
Start Novapoint
Novapoint-gt Manage Projects
Create a project in TestModel
o Project Name TestProject
o Where A boundary for the test project can be defined by the polygon in the file
lsquoAreaOfInterestTestProjectToVerifyInstallationtxtrsquo
Novapoint -gt New -gt New binder
Binder name TestBinder
Novapoint -gt Join Project
Select TestProject
Insert Ribbon -gt Insert structure
Select any one of the available structures
Insert Ribbon -gt Import
Select the file lsquoDataToVerifyTheInstallationSOS lsquo
Home -gt Share
Novapoint -gt Join Project
Again - select TestProject
In the binder there should now be two identical worksets one with reservations and one without any reservations
Does the number of tasks match Does the number of features match
Exit Novapoint
124 Verify that hot data back-up can be performed
Start Windows Task Scheduler and select the task lsquoFullBackup of Quadrirsquo Press the Run button
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 31
When the data back-up is finished you will see a set of new files in the backup folder that you
selected during the initial Trimble Quadri installation
Did a new set of files appear on the data back-up disk
125 Verify that human error recovery is possible
The next step is to simulate a human error and then verify that Human error recovery can be
completed by restoring a model from the online data back-up Ensure that the back-up process
started in the previous step is finished before you continue
Start Novapoint
Start page -gt recently used Binder
Select TestBinder
Activate the workset that contains reservations and delete the Import task including features
Home -gt Share
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Restore model
Model
Select TestModel
Select Time to Restore Select the nearest time before the ldquohuman errorrdquo deleted tasks and features
Start Novapoint
Novapoint -gt Open Binder
Novapoint -gt Join Project
Once again ndash select TestProject
In the binder there should now be three worksets Two of them should be identical
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser
Date 15012018 Trimble Quadri
copy Trimble Solutions Sandvika Page 32
Does the number of tasks match Does the number of features match
Exit Novapoint
126 Verify that scheduled hot data back-up is running
After first scheduled hot data back-up the steps in 125 Verify that human error recovery is possible
should be repeated
127 Clean up after verification test
Start Novapoint
Start page -gt recently used binders
Select TestBinder
Disconnect all three Worksets (Popup menu on Workset in Explorer view)
Exit Novapoint
Start a web browser and enter the URL for QMM
Models -gt Delete Model
Select TestModel
User Accounts -gt Delete Account
Select TestUser