32
Documentation Initial Setup and Configuration Trimble Quadri 2.0.FP6 and newer. Date: 15.01.2018 Trimble Quadri

Initial Setup and Configuration

  • 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