disclaimer warranty restrictions further copyrights · this software is provided by chad z. hower...

Disclaimer The information and data contained in this manual are subject to change without prior notification. The names and data used in the examples are imaginary, if not stated otherwise. No part of this document may be re-produced or transmitted for any use, in any form or by any means, elec-tronically or mechanically without the prior written permission of PTV AG.

Warranty Restrictions Although every precaution has been taken in the preparation of this man-ual, the publisher and author assume no responsibility for errors or omis-sions. Notes on errors will be gratefully received at any time.

Copyrights © 23. March 2017 PTV, HERE, AND

All brand or product names are trademarks or registered trademarks of the corresponding companies or organisations. All rights reserved.

Further Copyrights

Europe

Austria: © Bundesamt für Eich- und Vermessungswesen Belgium: Realized by means of Brussels UrbIS®©

Croatia, Cyprus, Estonia, Latvia, Lithuania, Moldova, Poland, Slovenia and/or Ukraine: © EuroGeographics

Denmark: "Includes data available from the U.S. Geological Survey."

Finland: Contains data from the National Land Survey of Finland Topo-graphic Database 06/2012

France: source: © IGN France 2009 - BD TOPO ®

Germany: Die Grundlagendaten wurden mit Genehmigung der zuständi-gen Behörden entnommen

Great Britain: Contains Ordnance Survey data © Crown copyright and database right 2010

Contains Royal Mail data © Royal Mail copyright and database right 2010

Greece: Copyright Geomatics Ltd.

Guernsey: ©The States of Guernsey, ©The States of Alderney, ©The Chief Please of Sark, ©The Royal Court of Guernsey

Ireland: Contains data made available by the Dublin City Council Multi Story Car Parking Space Availability as of 2013-11-02

Italy: La Banca Dati Italiana è stata prodotta usando quale riferimento anche cartografia numerica ed al tratto prodotta e fornita dalla Regione Toscana.

Norway: Copyright © 2000; Norwegian Mapping Authority

Portugal: Source: IgeoE – Portugal

Spain: Información geográfica propiedad del CNIG

Sweden: Based upon electronic data © National Land Survey Sweden.

Switzerland: Topografische Grundlage: © Bundesamt für Landestopogra-phie.

World Markets

Asia Pacific

Australia "Australia © Hema Maps Pty. Ltd, 2014.

Copyright. Based on data provided under license from PSMA Australia Limited (www.psma.com.au).

Product incorporates data which is © 2014 Telstra Corporation Limited, GM Holden Limited, Intelematics Australia Pty Ltd, NAVTEQ International LLC, Sentinel Content Pty Limited and Continental Pty Ltd.

Middle East/Africa Israel: © Survey of Israel data source

Jordan: © Royal Jordanian Geographic Centre

Mozambique: Certain Data for Mozambique provided by Cenacarta © 2014 by Cenacarta.

Réunion: source: © IGN 2009 - BD TOPO ®

http://www.psma.com.au/

TCP/IP Interface Portions of this software are Copyright (c) 1993 - 2001, Chad Z. Hower (Kudzu) and the Indy Pit Crew - http://www.nevrona.com/Indy/ Redistribu-tion and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation, about box and/or other materials provided with the distribution.

No personal names or organizations names associated with the Indy pro-ject may be used to endorse or promote products derived from this soft-ware without specific prior written permission of the specific individual or organization.

THIS SOFTWARE IS PROVIDED BY Chad Z. Hower (Kudzu) and the Indy Pit Crew "AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABIL-ITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSE-QUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCURE-MENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Legal notice PTV Planung Transport Verkehr AG

Haid-und-Neu-Str. 15

76131 Karlsruhe

Germany

Phone: +49 721 9651-8199

Fax: +49 721 9651-8599

Email: [email protected]

www.ptvgroup.com

mailto:[email protected]

http://www.ptvgroup.com/

Contents

1 Before you begin... ................................................................................... 1

2 Installation ................................................................................................. 2

2.1 Product Components ................................................................... 2

2.1.1 PTV xServer components .............................................. 2

2.1.2 Map server...................................................................... 3

2.1.3 Database ........................................................................ 4

2.1.4 PTV Map&Guide intranet web application .................. 4

2.2 System requirements ................................................................... 5

2.2.1 Operating System .......................................................... 5

2.2.2 Database ........................................................................ 6

2.2.3 Hardware ........................................................................ 6

2.2.4 Browser and resolution ................................................. 9

2.2.5 Important notes ............................................................. 9

2.2.6 Add-ons ........................................................................ 10

2.3 Installation types ......................................................................... 11

2.3.1 Multi-server installation ............................................... 11

2.3.2 Single-server installation ............................................. 14

2.4 Installation sequence ................................................................. 15

2.5 Multi-server installation .............................................................. 15

2.5.1 Installation on three computers ................................. 15

2.5.2 Installation on two computers .................................... 24

2.5.3 Enabling ports .............................................................. 31

2.6 Single-server installation ........................................................... 37

2.6.1 Installing a map ........................................................... 38

2.6.2 Installing additional components .............................. 38

3 Install Internet Information Service (IIS) manually ............................... 43

4 Getting started ....................................................................................... 47

4.1 Release with serial number and PIN code ............................... 47

4.2 Edit administrator data .............................................................. 48

4.3 Enter SMTP server access data ................................................. 49

5 PTV Map&Guide intranet 2016 update ............................................... 51

5.1 Parallel installation on three computers................................... 51

5.1.1 Computer 1 .................................................................. 51

5.1.2 Computer 2 .................................................................. 53

5.1.3 Computer 3 .................................................................. 57

5.2 Parallel installation on two computers ..................................... 59

5.2.1 Computer 1 .................................................................. 59

5.2.2 Computer 2 .................................................................. 61

5.3 Transferring data from PTV Map&Guide intranet 2016 .......... 66

5.4 Uninstalling the previous version ............................................. 68

6 Setting up manual backup of the databases ....................................... 71

6.1 Changing the backup directory ................................................ 72

6.2 Determining SQL user ............................................................... 72

6.3 Setting up jobs ........................................................................... 73

7 Tips and Tricks........................................................................................ 76

7.1 Changing log file path ............................................................... 76

7.2 Subsequent enabling of traffic information retrieval .............. 76

7.3 Change web application to https ............................................. 77

7.3.1 Assigning the IIS certificate......................................... 77

7.3.2 Enabling rerouting rules ............................................. 79

7.3.3 Amending URLs in the configuration files ................. 81

7.4 Hide access to the administration tool in the login

window ........................................................................................ 81

7.5 Display preferences for road types with values. ...................... 82

7.6 Expanding information text for new users ............................... 84

7.7 Possibilities for load sharing ...................................................... 85

7.8 Use remote control .................................................................... 85

Before you begin...

1

1 Before you begin...

This document describes the system requirements and the installation process for PTV Map&Guide intranet.

Please observe the following points before you begin the installation:

Before starting the setup, decide on how the distributed installation should occur on multiple computers (see chapter 2.3 "Installation types" on page 11).

Make sure that all requirements are fulfilled for the installation (see chapter 2.2 "System requirements" on page 5).

Observe the prescribed sequence for the installation. Depending on the dis-tribution of the product components on different computers, the execution of the setup on several computers is required (see chapter 2.4 "Installation se-quence" on page 15).

Your operating system must be up to date for the installation of PTV Map&Guide intranet. First install all Microsoft® updates.

Support You can contact our technical support at any time of day via the Support request form (www.mapandguide.com/en/service/support/support-contact/).

http://www.mapandguide.com/en/service/support/support-contact/

2

2 Installation

In this chapter you will find information about

Product Components

System requirements

Installation types

Installation sequence

Multi-server installation

Single-server installation

2.1 Product Components

PTV Map&Guide intranet consists of several individual components, which will be explained in brief as follows. Which system requirements must be fulfilled for the components can be found in chapter 2.2 "System requirements" on page 5.

In a multi-server installation, the components can be installed in a distributed manner on several computers. To do so, install the setup and the respective component on the computer of your choice. During the setup process, you can specify paths and folders.

Note: The installation of the components must be executed directly on the cho-sen target computer. Remote installations or automatic software distribution are not supported.

2.1.1 PTV xServer components

This deals with a collection of software components, which offer geographic and logistic functions. They have a modular design and due to their cluster technolo-gy, they allow for a simple scalability so that the performance requirements can be easily guaranteed.

Installation

3

Four PTV xServer components are used in PTV Map&Guide intranet:

PTV xRoute: Calculation of routes, emissions, toll

PTV xTour: Trip optimisation

PTV xLocate: Geocoding

PTV xMap: Display of maps and customer addresses

An SMPT server is needed for the (optional) email notification about current toll updates. This can either be a server locally installed in your network or one of the services offered online, for example, mail.yahoo.de. The access data for the mail delivery is stored in the administration tool (see chapter 4.3 "Enter SMTP server access data" on page 49).

A TI Servlet is required to view traffic information. This should only be installed system-wide on the computer which serves as host for the PTV xServer compo-nents. This is why, if you install the PTV xServer components , you will be asked whether you want to access traffic information from the internet.

Note: An internet connection is required to access traffic information, currency exchange rates, toll updates and orders from the freight exchange.

2.1.2 Map server

The map server is a special service which provides the map's background tiles and geocodes their databases in the background. This allows for the map to be shown quickly in the PTV Map&Guide intranet web application and enables a faster location search.

The map server is contacted by the PTV Map&Guide intranet scheduler service, which is installed in parallel to the PTV Map&Guide intranet application.

Note: Together with the map server, the Internet Information Service (IIS) and the PTV xServer components PTV xMap and PTV xLocate are installed automatically.

The PTV xLocate Server is required for automatically geocoding user-defined address tables and ensures that automatic geocoding of imported addresses does not affect the speed of interactive geocoding during route planning.

4

2.1.3 Database

During the installation you can choose whether you want to use an existing data-base server. If none of the listed database versions are installed, the English-language version of Microsoft® SQL Server® 2014 Express is automatically in-stalled.

2.1.4 PTV Map&Guide intranet web application

The web application consists of middleware and front-end components and runs within the Internet Information Service (IIS). The IIS can be installed automatically during the setup, or you can install the IIS manually.

PTV Map&Guide intranet Scheduler This deals with a Windows service, which can be managed through the service administration. This service executes time-controlled functions (trigger-based, interval-based) in the PTV Map&Guide intranet application environment. The service is installed together with the web application and fulfils the following tasks:

Accessing current currency exchange rates. The requirement for access is an active internet connection.

Geocoding of user defined addresses during the import of data into address tables. For geocoding, the PTV xLocate component is installed separately on the computer with the map server so as not to hinder the interactive ge-ocoding within the web application.

Checking of toll updates and (optional) notification by email. An active inter-net connection is required for the check. The email delivery requires SMTP Server access. Access data can be entered in the administration tool (see chapter 4.3 "Enter SMTP server access data" on page 49).

Access truck parking spaces from Truck Parking Europe (https://truck.infinum.co). The requirement for access is an active internet connection.

https://truck.infinum.co/

Installation

5

2.2 System requirements

PTV Map&Guide intranet can be used and tested under the following system requirements. This does not rule out the fact that PTV Map&Guide intranet may run under different circumstances, but subject to conditions.

For the installation, a DVD drive is required on all computers or access to a folder/network drive on which the contents of the installation DVD were cop-ied.

You must be logged in with local administration rights in order to install the PTV Map&Guide intranet components. A remote installation is not supported.

2.2.1 Operating System

The PTV Map&Guide intranet components are tested and released for the follow-ing operating systems:

Microsoft® Windows Server 2016 (64-bit)


Microsoft® Windows Server 2012 R2 (64-bit)


Microsoft® Windows Server 2008 R2 (64-bit)

Microsoft® Windows 10 Professional (64-bit)

Microsoft® Windows 8/8.1 (64-bit)

Microsoft® Windows 7 (64-bit)

We recommend the use of Microsoft® Windows Server 2012 for all computers on which PTV Map&Guide intranet components are installed.

Note: Please remember that it must be at least the Standard Edition of Microsoft® Windows Server. The Web Edition is inadequate.

6

2.2.2 Database

The PTV Map&Guide intranet database requires one of the following databases (or a more current version of the same type):

Microsoft® SQL 2016 Standard

Microsoft® SQL 2016 Express





Microsoft® SQL 2012 R2 Standard

Microsoft® SQL 2012 R2 Express

During the installation you can choose whether you want to use an existing data-base server. If none of the listed database versions are installed, the English-language version of Microsoft® SQL Server® 2014 Express is automatically in-stalled.

The database must be configured for the SQL Server authentication ("mixed mode"). If Microsoft® SQL Server® 2014 Express is installed through the PTV Map&Guide intranet setup, this occurs automatically.

Note: At the time of the product approval, the licence conditions of Microsoft® SQL Server® 2014 Express explicitly allow for its use in commercial products. Only usage in commercial hosting environments is excluded. As the licence con-ditions of the Express editions can occasionally change, we would recommend checking the current licence conditions and, if necessary, installing the paid ver-sion of Microsoft® SQL Server® 2014 Edition.

2.2.3 Hardware

Depending on whether you wish to carry out a multi-server installation or a sin-gle-server installation, the hardware requirements differ for individual computers.

Installation

7

2.2.3.1 Multi-server installation

The hardware requirements for the PTV Map&Guide intranet components and the required port numbers for release are listed in the following table.

To ensure that access to the PTV xServer components and Microsoft® Windows SQL Server® is possible during a distributed installation across all computers, ports must be released. Run this step on the individual computers directly after the components have been installed.

The RAM specifications are found in the memory, which is also required be-sides the operating system and other applications.

The hard drive specifications indicate the required free disk space.

Note: If you already use PTV Map&Guide intranet 2016 and are installing the new version in parallel, the system requirements increase (see chapter 5 "PTV Map&Guide intranet 2016 update" on page 51). For them to work effectively, both versions should not be used at the same time as this could lead to perfor-mance problems. For a parallel installation, we recommend using only one sys-tem for test purposes and one productively.

Components Free RAM Free disk space

Processor Other

PTV Map&Guide intranet web applica-tion

2 GB 2 GB for application and log files

x86 CPU with at least 1 GHz

Database and data-base services

At least 4 GB, recommend-ed: 8 GB

10 GB x86 CPU with at least 1 GHz

If database back-ups have been set up, additional free storage space is required for the backups.

8

Components Free RAM Free disk space

Processor Other

Map server (PTV xLocate, PTV xMap)

2 GB 1 GB + 15 GB for the map (Europa City)


Port numbers:

Map server: 80

PTV xLocate: 52722

PTV xServer Components:

PTV xRoute

PTV xTour

PTV xLocate

PTV xMap

4 GB

More memory can increase performance (depending on the type and number of requests).

2 GB + 15 GB for the map (Europa City)


Port numbers:

PTV xRoute: 52732

PTV xTour: 52792

PTV xLocate: 52722

PTV xMap: 52712

Note: We recommend the use of multiple processors or a multi-core processor for all computers on which PTV Map&Guide intranet components are installed, in order to provide ideal support for the different server components. For comput-ers on which the PTV xServer components are installed, we recommend one CPU (core) per PTV xServer module instance.

Example: Four PTV xServer components are generally installed on one computer along with the map. This computer should have 8 GB RAM and 6 or more CPU cores for optimal performance

2.2.3.2 Single-server installation

Note: Because all PTV Map&Guide intranet components are installed on one computer during a single-server installation, no ports need to be released.

Memory: minimum 12 GB

Hard disk space: minimum 40 GB free

CPU: X86 CPU with at least 1 GHz and 8 or more CPU cores

Installation

9

2.2.4 Browser and resolution

You can use PTV Map&Guide intranet with all standard browsers. However, de-pending on which browser type and version you use, it is possible that not all functions will be supported.

Note: We cannot guarantee that our program can be used without problems with browser versions which are not shown in the list.

Internet Explorer 11

Microsoft Edge 38

Firefox 51

Chrome 56

Note: Since browser versions are updated regularly, there is still no official re-lease for the latest versions. Please note that Javascript must be activated in your browser settings. Java, Flash and Silverlight are not required.

Note: Specially for Internet Explorer on Windows 2016 Server, the Enhanced Security Configuration should be turned off if problems occur when starting the PTV Map&Guide intranet web application.

Screen resolution Please note that the interface of the PTV Map&Guide intranet frontend has been optimised for a minimum resolution of 1280 x 1024 pixels.

2.2.5 Important notes

Please see the following notes regarding installation.

2.2.5.1 Access to web services

If you use PTV Map&Guide intranet you have access to different web services, such as traffic information or currency exchange rates. These require internet access.

10

During installation you will be asked whether you are using a proxy server. If this is the case, you must enable the following URLs to access the web services.

Traffic information http://ti.ptvgroup.com

Toll updates http://lds.ptvgroup.com

Exchange rates http://www.ecb.europa.eu

Freight exchange https://connect.wktransportservices.com

Truck Parking Europe https://truck.infinum.co

PTV Navigator https://naviparse.azurewebsites.net

PTV Map&Guide intranet FAQ http://www.mapandguide.com/de/service/support/ptv-mapguide-intranet

2.2.5.2 Other

The map must be installed prior to installation of the map server and the PTV xServer components.

If applicable, a plugin to display PDF files in the browser must be installed to show print previews.

For the creation of PDF files, the folder …\middleware\reporting\userdata in the installation directory of the PTV Map&Guide intranet web application (for example C:\Program Files\PTVGROUP\PTV Map&Guide intranet 2017\middleware\reporting\userdata) is granted write permissions for all us-ers during the setup.

2.2.6 Add-ons

If not available, the following programs are automatically installed through the setup.

Microsoft® Windows Powershell 1.0 or higher

Microsoft® .NET Framework 4.5

Microsoft® Windows Installer 4.5 or higher

Internet Information Server (IIS)

For the PTV Map&Guide intranet web application, the Internet Information Ser-vice (IIS) must be installed.

http://ti.ptvgroup.com/

http://lds.ptvgroup.com/

http://www.ecb.europa.eu/

https://connect.wktransportservices.com/

https://truck.infinum.co/

https://naviparse.azurewebsites.net/

http://www.mapandguide.com/de/service/support/ptv-mapguide-intranet

Installation

11

The installation can be done automatically via the setup:

The web server role (IIS) is installed via Windows Server.

The IIS is installed via Windows Features using a client operating system.

Alternatively, you can install the IIS manually (see chapter 3 "Install Internet Infor-mation Service (IIS) manually" on page 43).

2.3 Installation types

Depending on the number of users, you can install PTV Map&Guide intranet in the multi-server version or the single-server version.

2.3.1 Multi-server installation

The architecture of PTV Map&Guide intranet allows for a distributed installation over multiple computers. This allows for a simple scaling and flexible configura-tion in order to guarantee optimal performance even with increasing numbers of users.

You need 2 computers for the minimal installation type. However, we recom-mend using 3 computers. A computer can be dedicated hardware as well as a virtualised host.

Note: For more complex distributed installations or other individual operational concepts, please speak beforehand with your PTV Map&Guide intranet consult-ant.

12

2.3.1.1 Installation on three computers (recommend-ed)

Computer 1:

Map

Map server (IIS, PTV xLocate, PTV xMap)

Computer 2:


Database

PTV Map&Guide intranet web application

PTV Map&Guide intranet Scheduler (a Windows service for the execu-tion of time controlled (background) functions)

Computer 3:

Map

PTV xServer components (PTV xMap, PTV xLocate, PTV xRoute, PTV xTour)

Installation

13

2.3.1.2 Installation on two computers

Computer 1:

Map


Computer 2:


Map

Database

PTV xServer components (PTV xMap, PTV xLocate, PTV xRoute, PTV xTour)


PTV Map&Guide intranet Scheduler (Windows service for the execution of time controlled (background) functions)

14

2.3.2 Single-server installation

All program components are installed on one server.

You can use this variation under the following circumstances:

A maximum of 25 users will work with PTV Map&Guide intranet

A high-performance server is available for installation (see chapter 2.2.3.2 "Single-server installation" on page 8).

Installation

15

2.4 Installation sequence

You install multiple components in sequence.

Map

PTV Map&Guide intranet components: Map server (IIS, PTV xLocate, PTV xMap) Microsoft® SQL Server® 2014 Express database (English-language ver-sion) or using an available SQL Server PTV xServer components (PTV xMap, PTV xLocate, PTV xRoute, PTV xTour) PTV Map&Guide intranet web application

Which components are installed on which computer depends on the installation type chosen.

Multi-server installation: Setup must be executed on two or three computers. The required components must be selected and installed on each computer.

Single-server installation: All components are installed on one computer.

2.5 Multi-server installation

You can decide whether you want to install PTV Map&Guide intranet on two or three computers.

Note: For performance reasons, we recommend installation on three computers.

2.5.1 Installation on three computers

Notes: While specifying the computer addresses during installation, you can use either the computer names or the IP addresses. We recommend using computer names and only entering the IP addresses if there are problems with the name resolution in the network.

16

Should this cause problems with the name resolution in your network, you can replace the server name with the IP address in the table APPCFG_MapInstances in the PTV Map&Guide_intranet_2017 database using SQL Management Studio.

2.5.1.1 Computer 1

The following components must be installed on computer 1:

Map


Installing a map

Note: Install the map before you install the map server!

1. Insert the map DVD into the DVD drive.

The start screen appears.

Note: If the startup screen does not automatically appear, start the installation via the setup.exe file.

2. Click on Install.

The installation Wizard opens.

3. Follow the instructions of the installation wizard.

4. Select PTV Map&Guide intranet as the map application.

5. Specify the map path.

6. Enter the map serial number specified as listed on your licence certificate.

7. Confirm your settings.

8. Exit the installation wizard with Finish.

The map has now been installed.

Next, install the map server.

Installation

17

Installing a map server

Notes: Ensure that the map is installed on the computer before installing the map server. Together with the map server, the IIS and the PTV xServer components PTV xMap and PTV xLocate are installed automatically.

1. Insert the program DVD into your DVD drive.




Tip: If the installation does not automatically appear, start the installation via the setup.exe file.


4. On the Installation type page, select Multi-server installation.

5. Activate the following option on the Component selection page:

Map server

Database


PTV xServer components

6. Select the folder in which the map server should be installed.

7. Select the folder in which you have previously installed the map.


After installation, release the installation server ports (see chapter 2.5.3.2"PTV xServer components" on page 35).

PTV xLocate Server: 52722

Map server 80

Note: Port 80 has normally already been released.

18

2.5.1.2 Computer 2



Database


Install database and PTV Map&Guide intranet web application For the installation and operation of the PTV Map&Guide intranet web applica-tion, an enabled Internet Information Service (IIS) is required.

The IIS can be installed automatically through the setup, or alternatively you can install the IIS manually.

Note: The IIS must be installed manually before the PTV Map&Guide intranet setup. Observe the notes in chapter 2.1.4 "PTV Map&Guide intranet web applica-tion" on page 4 and chapter 3 "Install Internet Information Service (IIS) manually" on page 43.

The database and PTV Map&Guide intranet web application are installed on the same computer by default. If a suitable version of Microsoft SQL Server is already installed, this can be used for the PTV Map&Guide intranet database. Optionally, your own copy of Microsoft® SQL Server® 2014 Express (English-language ver-sion) can be installed through the setup. See the notes in chapter 2.1.3 "Database" on page 4.

Note: If you would like to manage the PTV Map&Guide intranet databases on an SQL server that is located on another computer, you must start the setup for the database on that computer.






Installation

19



5. Enable the following options on the page Component selection:

Map server

Database



Note: You can install the IIS automatically through the setup. Alternatively, you can install the IIS manually before you proceed with the installation of PTV Map&Guide (see chapter 3 "Install Internet Information Service (IIS) manually" on page 43).

6. In the Component selection window, select whether you want to use an existing SQL instance.

Note: If you do not want to use an existing database, the setup installs a Microsoft® SQL-Server® 2014 Express. You can change the suggested standard port 1433 in setup. Do not forget to release the ports for the SQL server after installation (see chapter 2.5.3.1 "SQL server" on page 32).

7. If you would like to use an existing SQL instance, you must select the data-base server and the authentication methods in the next step.

Note: Please log in with an SQL user who has SYSADMIN privileges. If the existing SQL server does not run on port 1433, specify the port separated by a comma after the SQL server, e.g. <WKA-WN-FDT\PTVMG, 1453>.

8. On the Select map server page, enter the computer on which you have in-stalled the map server (computer 1).

Note: For the installation to be successful, the map server ports must be released.

9. If required, on the Proxy configuration page state the login data for your proxy server.

20

10. On the Select the target folder for PTV Map&Guide intranet page, select the folder in which the web applications (client and administration tool) should be installed.

11. Select the SQL database file directory on the Select data directory for PTV Map&Guide intranet page.

Note: The data directory must be stored on a local drive. If the computer has several drives, you should not select the C: drive for performance rea-sons.

12. On the Backup and maintenance of the database page, state whether backups of the database should be created automatically.

Yes: The database backup is set up automatically. You can adjust the security information subsequently (see chapter 6 "Setting up manual backup of the databases" on page 71).

No: An automatic backup of the database is not created. Set up the da-tabase backup manually (see chapter 6 "Setting up manual backup of the databases" on page 71).

Note: For technical reasons, the user database recovery model is set to Complete after installation. The complete recovery model means that the transaction log (*.ldf file) permanently requires more disk space. The transaction log is automatically kept small by the automatic data-base backup scripts. Important: If you do not set up the database backup, you must reset the database recovery model to Simple manually.

To do so, open the PTV Map&Guide intranet 2017 database module using SQL Management Studio.

Enter the following command via New request: ALTER DATABASE [PTV Map&Guide_intranet_2017_usermanagement] SET RECOV-

ERY SIMPLE WITH NO_WAIT and confirm with Run.

13. If you have selected an automatic backup, enter a path to the backup di-rectory on the Select drive for the backup medium page.

Installation

21

Note: If possible, do not select the same hard disk on which the database has been installed for backing up the databases.

14. On the Names of the virtual directories page, state the names for the cli-ent and administration tool directories in the IIS.

Note: The directory names entered here become part of the URLs via which the client and the administration tool are accessed.

15. On the Select links page, select whether you want to start the client or the administration tool directly from the desktop.

16. On the Start copying page you will see an overview of the selected set-tings.

17. Confirm by pressing Next in order to start copying.

After installation of the database and web application, you must release the ports for the SQL server (see chapter 2.5.3.1 "SQL server" on page 32).

The following ports must be released:

SQL Server (TCP) 1433 (default) or the port which you assigned to the SQL server.

SQL Server (UDP) 1434

PTV Map&Guide intranet Scheduler service 559

The following entries are created on computer 2 by the installation wizard in the start menu under PTV Map&Guide intranet 2017:

Log file directory 2017

This is where the log files for PTV Map&Guide intranet are stored.

PTV Map&Guide intranet Administration Tool 2017

URL to access the PTV Map&Guide intranet administration tool.

PTV Map&Guide intranet Client 2017

URL to access the PTV Map&Guide intranet client.

Tools

Monitoring 2017 Displays a page with a status overview of the individual components of PTV Map&Guide intranet.

22

Diagnostic Tool 2017 If support is needed, you can send important system information via the diagnostic tool.

Data transfer intranet 2016 Tool to transfer the data from PTV Map&Guide intranet 2016.

2.5.1.3 Computer 3


Map


Installing a map

Note: Install the map before you install the PTV xServer components.



Note: If the startup screen does not automatically appear, start the installa-tion via the setup.exe file.










Next, install the PTV xServer components.

Installation

23

Installing PTV xServer components

Notes: Ensure that the map is installed on the computer before installing the PTV xServer components.









Map server

Database



6. On the Select database server page, state the database server on which you have previously installed the database for PTV Map&Guide intranet: <Computer name>\<SQL Server instance>.

7. On the Select destination path page, select the directory in which the PTV xServer components should be installed.

8. If you wish to access traffic information from the internet, select the option Yes on the Traffic information page.


10. On the Select map directory page, select the path to the previously in-stalled map.



24

Each PTV xServer component is installed as a Windows service and is started automatically after completion of the setup. After installation you must release the ports and check locally and from another computer whether it is possible to communicate with the PTV xServer components (see. chapter 2.5.3.1 "PTV xServer components" on page 32).


PTV xMap Server: 52712


PTV xRoute Server: 52732

PTV xTour Server: 52792

2.5.2 Installation on two computers


This installation type only requires two computers because the database, PTV xServer components and the web application are installed on the same computer.

Note: We recommend installation on three computers, because simpler scaling is possible with an increasing number of users (see 2.3.1.1 "Installation on three computers (recommended)" on page 12).

2.5.2.1 Computer 1


Map


Installation

25

Installing a map






















26




Map server

Database








Map server 80


2.5.2.2 Computer 2


Map


Database



Installing a map

Note: Install the map before you install other components!



Installation

27


2. Click on Install. The installation Wizard opens.








In the next step, install other components.

Installing the database, PTV Map&Guide intranet web application and PTV xServer components

For the installation and operation of the PTV Map&Guide intranet web applica-tion, an enabled Internet Information Service (IIS) is required.

The IIS can be installed automatically through the setup, or alternatively you can install the IIS manually.

Note: The IIS must be installed manually before the PTV Map&Guide intranet setup. Observe the notes in chapter 2.1.4 "PTV Map&Guide intranet web applica-tion" on page 4 and chapter 3 "Install Internet Information Service (IIS) manually" on page 43.

The database and PTV Map&Guide intranet web application are installed on the same computer by default. If a suitable version of Microsoft SQL Server is already installed, this can be used for the PTV Map&Guide intranet database.

Optionally, your own Microsoft® SQL Server® 2014 Express can be installed through the setup. See the notes in chapter 2.1.3 "Database" on page 4.

Notes: If you would like to manage the PTV Map&Guide intranet databases on an SQL server that is located on another computer, you must start the setup for the database on that computer.

28

Before the installation, make sure that the map has already been installed on the computer.









Map server

Database



Note: You can install the IIS automatically through the setup. Alternatively, you can install the IIS manually before you proceed with the installation of PTV Map&Guide (see chapter 3 "Install Internet Information Service (IIS) manually" on page 43).

6. In the Component selection window, select whether you want to use an existing SQL instance.

Note: If you do not want to use an existing database, the setup installs a Microsoft® SQL-Server® 2014 Express. You can change the suggested standard port 1433 in setup.

7. If you would like to use an existing SQL instance, you must select the data-base server and the authentication methods in the next step.

Installation

29

Note: Please log in with an SQL user who has SYSADMIN privileges. If the existing SQL server does not run on port 1433, specify the port separated by a comma after the SQL server, e.g. <WKA-WN-FDT\PTVMG, 1453>












30

Note: For technical reasons, the user database recovery model is set to Complete after installation. The complete recovery model means that the transaction log (*.ldf file) permanently requires more disk space. The transaction log is automatically kept small by the automatic data-base backup scripts. Important: If you did not set up the database backup, you must reset the database recovery model to Simple manually. To do so, open the PTV Map&Guide intranet 2017 database module via the SQL Management Studio. Enter the following command via New request: ALTER DATABASE [PTV Map&Guide_intranet_2017_usermanagement] SET RECOV-




17. On the Names of the virtual directories page, state the names for the cli-ent and administration tool directories on the IIS.





Each PTV xServer component is installed as a Windows service and is started automatically after completion of the setup.




Installation

31





Tools




2.5.3 Enabling ports

Note: You only need to enable ports for a multi-server installation so that the individual components can communicate with each other.

Three-server installation The following ports must be released for a three-server installation.

Computer 1

Map server: 80

Note: Port 80 is assigned to the map server. This has normally already been released.


Computer 2

SQL Server (TCP): 1433 (standard) or the port which you assigned to the SQL server.

SQL Server (UDP) 1434


32

Computer 3





Two-server installation The following ports must be released for a two-server installation.

Computer 1


Map server: 80


2.5.3.1 SQL server

For a three-server installation, ports for communication with the PTV xServer components on computer 3 must be enabled.

Note: If PTVxServer components are being installed, an attempt is made to ac-cess the database server. In individual cases, despite released ports, access was not possible during our test installations. Should this problem occur in your case, briefly disable the firewall on the data-base server and then quickly activate it again. Afterwards you should have access.

Configuring your firewall

Note: The following functions and windows described allow you to configure the Microsoft® Windows Firewall. However, they might vary depending on the Mi-crosoft® Windows version you are using!

The following steps describe the settings you need to set under Microsoft ® Win-dows Server 2012.

You will need to first release the TCP port and then the UDP port.

Releasing the TCP port

1. Open the dashboard via Server Manager.

Installation

33

2. Select the entry Windows Firewall with Advanced Security in the Tools menu.

3. Select the entry Inbound rules in the Windows Firewall with Advanced Se-curity window in the navigation tree.

4. In the Actions section under Inbound Rules, select the New Rule entry.

This opens the New Inbound Rule Wizard.

5. On the Rule type page, select the Port option.

6. Click on Next.

7. On the Protocols and ports page, select the TCP option and the Specific local ports option.

8. If you have not changed the default port for the SQL server, enter port 1433, otherwise specify the port number which you use for the SQL server.

9. Click on Next.

10. In the Action window, select the Allow the connection option.

11. Click on Next.

12. In the Profile window, select the option Domain, Private or Public, which-ever corresponds to the computer's connection to your network.

13. Click on Next.

14. In the Name field, enter: SQL <Name database> TCP

Releasing the UDP port



3. Select the entry Inbound rules in the Windows Firewall with Advanced Se-curity window in the navigation tree.




6. Click on Next.

34

7. On the Protocols and ports page, select the UDP option and the Specific local ports option.

8. Enter the port 1434.

9. Click on Next.

10. In the Action window, select the Allow connection option.

11. Click on Next.

12. Select the Domain, Private or Public option which corresponds to the computer's connection to the network.

13. Click on Next.

14. In the Name field, enter: SQL <Name database> UDP

Testing enabled ports Run the test from a computer that has the PTV xServer components installed!

Note: The following functions and windows described allow you to make admin-istrative settings. However, they might vary depending on the Microsoft® Win-dows version you are using!

1. Open the computer's administration settings via Control Panel > System and Security > Administration.

2. Double click on the ODBC data sources entry.

3. In the ODBC data sources administrator window, select the User DSN tab.

4. Click on Add.

5. In the Create new data source window, select the SQL Server entry.

6. Click on Finish.

7. In the Create new data source for SQL server window, enter in the Name field: SQL PTV Map&Guide intranet.

8. Under Which SQL Server would you like to connect to, enter the following in the Server field: <IP address of the SQL Server or the SQL Server instance>\<Name of the database>.

Note: If the SQL database has been installed through the PTV Map&Guide intranet setup, this could, for example, be called <dbserver>\PTVMG.

9. Click on Next.

Installation

35

10. Activate the option With SQL server authentication based on the user name and password entered by the user.

11. In the User Name field, enter: mapandguide

12. In the Password field enter: mapandguide

13. Click on Next.

14. Confirm the settings of the window with Next.

15. Confirm the settings of the window with Finish.

16. Click Test data source in the ODBC Microsoft SQL Server Setup window.

Testing connection again If you would like to test the connection again or change settings, in the window ODBC Data Source Administrator, select > Tab User DSN > Configure.

2.5.3.2 PTV xServer components

Because the PTV Map&Guide intranet web application and PTV xServer compo-nents are installed on different computers, ports for communication must be released on the computers on which PTV xServer components are installed.


The following steps describe the settings you need to set under Microsoft ® Win-dows Server 2012.

Take the following steps to release the ports for the PTV xServer components.



3. In the Windows Firewall with Advanced Security window, select the In-bound Rules entry in the navigation tree.




36

6. Click on Next.


8. Depending on the components installed, enter the following values:





Map server 80


9. Click on Next.

10. In the window Action, select Action > Allow connection.

11. Click on Next.


13. Click on Next.

14. Enter the name, e.g. <PTV xServer>, in the Name field.

If the ports are successfully released, the PTV xServer Management Console page will appear with information about the respective PTV xServer.

2.5.3.3 PTV Map&Guide intranet Scheduler service

You must release port 559 for TCP on the computer on which the web applica-tion and the PTV Map&Guide intranet Scheduler service are installed. This allows for the status query about the service and the illustration in a monitoring page from other computers.


Installation

37

The following steps describe the settings you need to set under Microsoft® Win-dows 2012 Server.



3. In the Windows Firewall with Advanced Security window, select the In-bound Rules entry in the navigation tree.




6. Click on Next.


8. Enter port 559.

9. Click on Next.

10. In the window Action, select Action > Allow connection.

11. Click on Next.


13. Click on Next.

14. In the Name field, enter the name for the PTV Map&Guide intranet Sched-uler service.

2.6 Single-server installation

You can install the components of PTV Map&Guide intranet on one server if the following requirements are met:

A maximum of 25 users will work with PTV Map&Guide intranet.

A high-performance server is available for installation. Available (see chapter 2.2.3.2 "Single-server installation" on page 8).

38

2.6.1 Installing a map




Note: If the startup screen does not automatically appear, start the installation via the setup.exe file.










2.6.2 Installing additional components







4. On the Installation type page, choose Single-server installation and con-firm with Next.

The Setup type page is shown.

Installation

39

You can choose whether you want to run a Simple installation with the default settings or whether you want to change the settings via User-defined installation.

2.6.2.1 Simple installation

1. On the Setup type page, choose Simple installation.

The setup checks whether the IIS Windows features are activated on the server. If not, the IIS will be installed during the setup.

2. On the Select map directory page, choose the directory in which the map was installed.

3. If you are connected to the internet through a proxy server, enter the re-quired details on the Proxy configuration page.

4. Enter your chosen installation path in the Target directory for PTV Map&Guide intranet page.

5. State whether a shortcut for the PTV Map&Guide intranet Client or the administration tool should be created on the desktop on the Select shortcuts page.

A summary of the components to be installed is shown.

6. Confirm the settings with Next.

7. Setup installs SQL Server Express, the PTV Map&Guide intranet Client and Administration Tool and the PTV xServer components.

Note: Please note that installation of the individual components can take some time.

Once the installation is complete, you can automatically start the PTV Map&Guide intranet Administration Tool to create users (see chapter 4 "Getting started" on page 47).

2.6.2.2 User-defined installation

1. On the Setup type page, choose User-defined installation.

The setup checks whether the IIS Windows features are activated on the server. If not, the IIS will be installed during the setup.

2. On the SQL Server Instance page, choose the option No, install new SQL server instance.

40

3. On the Select destination path page, choose the directory in which the PTV xServer components should be installed.

4. On the Select map directory page, choose the directory in which you in-stalled the map.









Note: For technical reasons, the user database recovery model is set to Complete after installation. The complete recovery model means that the transaction log (*.ldf file) permanently requires more disk space. The transaction log is automatically kept small by the automatic data-base backup scripts. Important: If you did not set up the database backup, you must reset the database recovery model to Simple manually. To do so, open the PTV Map&Guide intranet 2017 database module via the SQL Management Studio.

Installation

41











Once the installation is complete, the following entries are created in the Win-dows start menu under PTV Map&Guide intranet 2017:







Tools


42



Install Internet Information Service (IIS) manually

43

3 Install Internet Information Service (IIS) manually

For the PTV Map&Guide intranet web application, the Internet Information Ser-vice (IIS) must be installed.

It can be installed automatically via setup or you can install the IIS manually:

Under Windows Server, install the IIS via the web server role (IIS) in the Server Manager.

Install the IIS via Windows Features using a client operating system.

Note: Install the IIS before installing the PTV Map&Guide intranet web application on computer 2.

Installation using Microsoft® Windows Server 2012 is described below.

Microsoft® Windows Server 2012 1. Choose the Add Roles and Features option via Server-Manager > Dash-

board.

The Add Roles and Features Wizard opens.

2. Confirm the Before You Begin page by pressing Next.

3. On the Installation type page, select the option Role-based or feature-based installation and click on Next to confirm.

4. On the Select destination server page, choose the Select a server from the server pool option.

5. In the Server Pool area, select the computer on which the database and the web application were installed and confirm this with Next.

6. Select Server Roles.

7. Activate the Web Server (IIS) entry.

8. On the Add features that are required for Web Server (IIS) page, click on Add Features.

On the Features page, .NET Framework 3.5 and .NET Framework 4.5 are activated.

44

9. Confirm by pressing Next.

10. Confirm the instructions on the Web Server Role (IIS) page by pressing Next.

11. Make sure that the entries made on the Role Services page have been ac-tivated:

Install Internet Information Service (IIS) manually

45

12. Confirm the settings by clicking Next.

46

A summary of your settings will be displayed on the Confirm installation selections page.

13. In the event that the server should be restarted directly after installation, enable the Restart the destination server automatically if required option.

14. Confirm your details by pressing Install.

Note: Ensure that the server has been restarted after the installation.

Getting started

47

4 Getting started

After you have installed PTV Map&Guide intranet 2017, you must take the follow-ing steps.

4.1 Release with serial number and PIN code

1. In order to setup your PTV Map&Guide intranet version, open the admin-istration tool, which is found on the web application computer. After an installation in standard directories, you can open it via the URL:

http://<Name/IP des Webservers>/mgi2017-admin/

2. Specify a user name and a password for the administrator.

Note: The selection of the language is only in regards to the current ses-sion and has no effect on other users.

3. Confirm your details with Log in.

The administration tool starts.

4. In the window First start > tab Licence assistant, enter your serial number and confirm with Add.

The Activation tab opens. Here, using the serial number and a system-dependent reference number, you generate a PIN code which releases PTV Map&Guide intranet.

5. Click on Generate PIN.

If the PIN was generated successfully, you can work with PTV Map&Guide intra-net.

Note: The PIN code is generated in a system-dependent manner. If you wish to install PTV Map&Guide intranet on another computer following activation, con-tact our Technical Support team: (http://www.mapandguide.com/en/service/support/support-contact/).

http://www.mapandguide.com/en/service/support/support-contact/

48

4.2 Edit administrator data

After starting the administration tool, you have already been created as a user of the Administrator group.

Note: We deliver two predefined groups: Administrator and standard.

In the Administrator group, all access rights to PTV Map&Guide intranet are available. In addition, a user who is assigned to the Administrator group also has access to the administration tool. He can therefore administrate users and groups.

In the Standard group, all important access rights to PTV Map&Guide intranet are available.

1. If you would like to edit your user data, select the entry in the navigator User Management > User.

The list of the created users is displayed.

2. Double click on the created user.

3. Add your user data.

4. If you would like to be informed of toll updates, add your email address and activate the Notify of new toll updates option.

Getting started

49

Note: The information about the new toll updates is only sent to the speci-fied email address if you have set up an SMTP server (see chapter 4.3 "Enter SMTP server access data" on page 49).

You can create other users through the toolbar > User area > New.

Tip: More information about creating users and working with the administration tool can be found in the online help.

4.3 Enter SMTP server access data

An SMTP server is needed for the optional email notification about current toll updates. This can either be a server locally installed in your network or one of the services offered online, for example, mail.yahoo.de. The access data for the SMTP servers can be entered in the administration tool.

1. Following login, select the Setup mail server entry in the toolbar of the administration area .

The Setup mail server window will open

50

2. Enter the required data.

If you have already added your user data and stored an email address (see chap-ter 4.2 "Edit administrator data" on page 48), you can check the mail delivery by clicking on Connection test. You will receive a test mail sent to the stored email address.

Note: Please note that an active internet connection is required for toll updates on a computer on which the PTV xServer components are installed.

PTV Map&Guide intranet 2016 update

51

5 PTV Map&Guide intranet 2016 update

Note: In contrast to earlier versions, you can no longer use the previous version once you have installed PTV Map&Guide intranet 2017. If you want to test PTV Map&Guide intranet 2017 first, install the version on a new system.

The update process occurs as follows:

Parallel installation on two or three computers

Transfer of the data from the previous version

Uninstalling PTV Map&Guide intranet 2016

5.1 Parallel installation on three computers

Installation takes place on three computers in parallel to the existing version PTV Map&Guide intranet 2016.


5.1.1 Computer 1


Map


Installing a map

Note: The map must be installed before you install the map server!



52







Note: Usually the previous version of the map is already installed in the suggested directory. The map path is therefore renamed by the setup. A new Europe city map is, for example, not installed in the existing Euro-pePremium.geo directory, but rather in the EuropePremium_1.geo direc-tory.














53




Map server

Database








Map server 80


5.1.2 Computer 2



Database


PTV Map&Guide intranet Scheduler (a Windows service for the execu-tion of time controlled (background) functions)

Note: Before beginning, ensure that the Internet Information Service (IIS) is ena-bled.

54

Install database and PTV Map&Guide intranet web application

Notes: The existing Microsoft SQL server can be used for the PTV Map&Guide intranet 2017 database. If the SQL server is on another computer, you must start the setup for the data-base locally on that computer.









Map server

Database



6. In the Component selection window, select that you would like to use an existing SQL instance.

7. If you do not use the SQL Server Express installed by the PTV Map&Guide intranet, select the database server and the authentication method in the next step.




55






Important: Set up the database jobs even if you have already done this for the previous version!



Note: For technical reasons, the user database recovery model is set to Complete after installation. The complete recovery model means that the transaction log (*.ldf file) permanently requires more disk space. The transaction log is automatically kept small by the automatic data-base backup scripts.

Important: If you did not set up the database backup, you must reset the database recovery model to Simple manually.

To do so, open the PTV Map&Guide intranet 2017 database module using SQL Management Studio.

56










After installing the web application, you must release the following ports.









Tools



57


Data transfer intranet 2016 Tool to transfer the data from PTV Map&Guide intranet 2016

5.1.3 Computer 3


Map


Installing a map





2. Click on Install. The installation Wizard opens.








58


Next, install the PTV xServer components.

Installing PTV xServer components

Notes: Ensure that the map is installed on the computer before installing the PTV xServer components.









Map server

Database



6. On the Select database server page, state the database server on which you have previously installed the database for PTV Map&Guide intranet: <Computer name\<SQL Server instance>.






59



Each PTV xServer component is installed as a Windows service and is started automatically after completion of the setup. After installation you must release the ports and check locally and from another computer whether it is possible to communicate with the PTV xServer components (see chapter 2.5.3.2 "PTV xServer components" on page 35).






5.2 Parallel installation on two computers


When installing on two computers, the map and map server are installed on one computer, while the map, database, PTV xServer components and web applica-tion are installed on the other computer.

5.2.1 Computer 1


Map

Map server

60

Installing a map
















Installing the map server







61




Map server

Database








Map server: 80


5.2.2 Computer 2



Map

Database



PTV Map&Guide intranet Scheduler (Windows service for the execution of time controlled (background) functions)

Note: Before beginning, ensure that the Internet Information Service (IIS) is ena-bled.

62

Installing a map










Note: Usually the previous version of the map is already installed in the suggested directory. The map path is therefore renamed by the setup.

A new Europe city map is, for example, not installed in the existing Euro-pePremium.geo directory, but rather in the EuropePremium_1.geo direc-tory.





In the next step, install other components.

Installing the database, PTV Map&Guide intranet web application and PTV xServer components

Notes: Before the installation, make sure that the map has already been installed on the computer. The existing Microsoft SQL server can be used for the PTV Map&Guide intranet 2017 database.


63

If the SQL server is on another computer, you must start the setup for the data-base locally on that computer.









Map server

Database



6. In the Component selection window, select that you would like to use an existing SQL instance.

7. If you do not use the SQL Server Express installed by the PTV Map&Guide intranet, select the database server and the authentication method in the next step.





64




14. Select the directory of the SQL database files on the Select data directory for PTV Map&Guide intranet page.



Important: Set up the database jobs even if you have already done this for the previous version!



Note: For technical reasons, the user database recovery model is set to Complete after installation. The complete recovery model means that the transaction log (*.ldf file) permanently requires more disk space. The transaction log is automatically kept small by the automatic data-base backup scripts. Important: If you did not set up the database backup, you must reset the database recovery model to Simple manually. To do so, open the PTV Map&Guide intranet 2017 database module using SQL Management Studio.


65














PTV Map&Guide intranet administration tool


PTV Map&Guide intranet client


Tools


66



5.3 Transferring data from PTV Map&Guide in-tranet 2016

Notes: Start the PTV Map&Guide intranet Administration Tool before the data transfer and enter the available serial number. This gives you free licences for the transfer of other users and this ensures that users are not transferred with the deactivated status. If you have fewer licences available in PTV Map&Guide intranet 2017 than in the previous version, the last users created in the previous version are trans-ferred with the status Deactivated.

The following data that you created in a previous version is transferred to the new version.

User and groups from the Administration Tool

Vehicles, profiles and station lists from the web application

Databases from the data manager

The data is stored in databases on the SQL server.

There is an update tool for you to use to transfer the data. After an installation in the standard directories, you can find the tool on the computer where the web application was installed under C:\ProgramFiles\PTVGROUP\ PTV Map&Guide intranet 2017\Tools\Updatetool PTV Map&Guide intra-net\Updatetool.exe or in the start menu under PTV Map&Guide intranet 2017\Tools\Datatransfer intranet 2016.

If you use the previous version of the SQL server for the databases of the new version, the data is automatically transferred by the update tool.

If you wish to use a different SQL server for the new version's databases, you must back up the databases and save them in the new SQL servers via the update tool.


67

Notes: Before you start a data transfer, all users must log out of the client and the administration tool.

The data transfer can be executed as often as necessary.

Please note that all data that you have already created in the new version, PTV Map&Guide intranet 2017 , is lost in the data transfer. Only the user name and password of the administrator who was the first to start the PTV Map&Guide in-tranet 2017 Administration Tool remain unchanged.

Do you use the previous version of SQL Server?

1. Move them to the computer on which you have installed the web applica-tion.

If you have installed PTV Map&Guide intranet 2017 in the default directo-ries, you will find the update tool under C:\ProgramFiles\PTVGROUP\PTV Map&Guide intranet 2017\Tools\Updatetool PTV Map&Guide intranet\ Updatetool.exe or in the start menu under PTV Map&Guide intranet 2017\Tools\Datatransfer intranet 2016.

2. Start the update tool.

3. Click on Start.

4. Confirm by inputting Yes.

The data from the previous version will be transferred.

Do you not use the previous version of SQL Server?

If you wish to use an SQL server on a different computer than for the previous version, you have access to an SQL script that you can use to back up the data-bases of version 2016 before starting the update tool.

You must first create a backup of the 2016 database using the SQL script and copy this into the new SQL server's directory. Then start the update tool and the data are imported.

1. Start Microsoft SQL Server Management Studio and open the PTV Map&Guide intranet 2016 database.

68

2. Open the script Backup_2016.sql that is located on the computer with the web application.

Note: If you have carried out an installation in the standard directories, the SQL script can be found with the web application on the computer under C:\Program Files\PTVGROUP\PTV Map&Guide intranet 2017\Tools\ Updatetool PTV Map&Guide intranet\SQLScripts\Backup_2016.sql.

3. Click on Run.

A database backup is created on the computer with the 2016 version of the SQL server in the following directory: C:\ProgramData\PTVGROUP\PTV Map&Guide intranet 2016\ PTV Map&Guide_intranet\DATA\Backup_Update\

4. Copy the Backup_Update directory to the computer where the new ver-sion's SQL server is running in the DATA directory.

After installation in the default directories, the data directory is C:\ProgramData\PTVGROUP\PTV Map&Guide intranet 2017\PTV Map&Guide_intranet_2017\DATA.

5. Start the update tool on the computer where you installed the web appli-cation.

If you have installed PTV Map&Guide intranet 2017 in the default directo-ries, you will find the update tool under C:\ProgramFiles\PTVGROUP\PTV Map&Guide intranet 2017\Tools\Updatetool PTV Map&Guide intranet\Updatetool.exe.

6. Click on Start.

7. Confirm by inputting Yes.

The data from the previous version will be transferred.

5.4 Uninstalling the previous version

After you have installed the new version of PTV Map&Guide intranet, you can uninstall the previous version.


69

Notes: Please note that you must carry out the uninstallation on every computer on which the components of PTV Map&Guide intranet 2016 were installed.

Automatic uninstallation via the control panel

PTV Map&Guide intranet 2016

Automatic uninstallation removes the web applications, PTV xServer compo-nents, Ajax Maps Server and PTV Map&Guide intranet Scheduler.

PTV Europe City Map Premium 2016.2H

Automatic uninstallation removes the maps used by PTV Map&Guide intranet 2016.

Manual uninstallation of the remaining files Automatic uninstallation does not completely remove all files and data.

As such, check whether the following file is still present and delete it manually if necessary.

C:\Program Files\PTVGROUP\PTV Map&Guide intranet 2016

Note: All path information relates to installation of the previous version in the default directories.

Deleting databases and LOG files from the previous version

Attention: Only delete databases and LOG files if you have transferred the data to the new version (see chapter 5.3 "Transferring data from PTV Map&Guide intra-net 2016" on page 66). If the databases have been deleted, it is no longer possible to carry out the trans-fer using the update tool.

1. On the computer on which the database was installed, open the Microsoft SQL Server Management Studio.

2. Under Databases, delete the following entries:

mapandguide_intranet_2016

mapandguide_intranet_2016_datamanager

mapandguide_intranet_2016_poi

mapandguide_intranet_2016_usermanagement

70

mapandguide_intranet_2016_work

3. Under C:\ProgramData\PTVGROUP\PTV MapAndGuide intranet 2016, de-lete the Log folder.

Setting up manual backup of the databases

71

6 Setting up manual backup of the databases

Notes: If you have selected an automatic backup in Setup, the database jobs are installed and set up automatically. However, you can adjust the scripts and tasks subsequently. Important: The jobs for backing up the databases of a previous version do not back up the databases of the new version! If you would like to back up version 2017 databases, you must set up the jobs again.

Regular backups are created of the PTV Map&Guide intranet databases and the system databases via the database jobs. Furthermore, the database indexes are optimised and a database integration check is carried out.

If you have not set up an automatic database backup via Setup, you can set up the database jobs to back up the PTV Map&Guide intranet databases manually.

After installation in the default directories, you will find the necessary installation files under C:\ProgramData\PTVGROUP\PTV Map&Guide intranet 2017\PTV Map&Guide_intranet_2017\DATA\Scripte\Maintenance.

The databases are backed up via the freely available SQL script SQL Server Maintenance Solution by Ola Hallegreen.

72

Notes: The recommended backup strategy is freely available free of charge. It is used by many well-known organisations. Further information on this can be found at: http://ola.hallengren.com/organizations.html

PTV AG accepts no responsibility for the correctness, completeness and up-to-date nature of the recommended backup strategy.

The required SQL procedures and tables are created and the Windows tasks are set up via the installation files that back up and check the PTV Map&Guide intra-net databases at specified intervals.

6.1 Changing the backup directory

You can state in the installation files that another directory is used for backups.

Notes: If you do not change the directories, the database backups are stored in the folder C:\ProgramData\PTVGROUP\PTV Map&Guide intranet 2017\PTV Map&Guide_intranet_2017\DATA\ in a subdirectory which is named in the same way as the SQL instance name, e.g. MGINTRA$PTVMG. If the computer where the SQL Server is installed has multiple hard disks, the hard disk where the database data is stored should be used for the backup.

Make the change in the following installation files:

dba_UserDBs_DifferentialBackup.cmd

dba_UserDBs_FullBackup.cmd

dba_SysDBs_FullBackup.cmd

dba_UserDBs_LogBackup.cmd

Determine the required backup directory via the entry @Directory=<path>, e.g. @Directory=D:\MGintra_backup_DB

6.2 Determining SQL user

In order to create the SQL procedures and tables, you require an SQL user who is assigned to the sysadmin role.

http://ola.hallengren.com/organizations.html


73

You specify the sysadmin role login data in the file dba_MaintenanceSolution.cmd.

1. Open the dba_MaintenanceSolution.cmd script with a text editor.

2. Enter the login data of an SQL user with sysadmin role: -U <User> -P "<Password>", e.g. –U admin –P "PW9988"

6.3 Setting up jobs

After you have carried out all necessary adjustments (if necessary, see chapter 6.1 "Changing the backup directory" on page 72 and chapter 6.2 "Determining SQL user" on page 72), you can install the jobs in the next step.

Important: Start the installation files using administrator rights.

Setting up Windows tasks

Start the file schtask_create_all.cmd using administrator rights.

8 command files are activated via the file to set up the Windows tasks. In the Windows task planning, the following tasks are set up to back up the databases.

PTV Map&Guide intranet 2017_UserDBs_LogBackup

Carries out a backup of the transaction log of all relevant PTV Map&Guide in-tranet databases.

PTV Map&Guide intranet 2017_UserDBs_IntegrityCheck

Carries out an integrity check of all relevant PTV Map&Guide intranet data-bases.

PTV Map&Guide intranet 2017_UserDBs_IndexOptimize

Optimises indexes and statistics for all relevant PTV Map&Guide intranet da-tabases.

PTV Map&Guide intranet 2017_UserDBs_FullBackup

Carries out a full backup of all relevant PTV Map&Guide intranet databases.

Note: The task is run once during the setup, so you can monitor in Windows task planning whether the setup has been successful.

74

PTV Map&Guide intranet 2017_UserDBs_DifferentialBackup

Carries out an incremental backup of all relevant PTV Map&Guide intranet da-tabases. The only data that are backed up are those which have been modi-fied or newly added since the last backup.

PTV Map&Guide intranet 2017_SysDBs_IntegrityCheck

Carries out an integrity check of all system databases (master, model, msdb)

PTV Map&Guide intranet 2017_SysDBs_FullBackup

Carries out a full backup of the system databases (master, model, msdb).

Checking the task setup

During the setup, a full backup of all relevant PTV Map&Guide intranet databases is run once for test purposes via the task PTV Map&Guide intranet 2017_UserDBs_FullBackup.

In Windows task planning you can check whether the backup has been carried out successfully.

1. Open Windows task planning via Start > Run > taskschd.msc.

2. In the navigation tree, select the Task library entry.

The following tasks are entered to back up the databases.

Note: The PTV Map&Guide intranet 2017_UserDBs_FullBackup task has already been run once during setup.

3. Check the following:

In the PTV Map&Guide intranet 2017_UserDBs_ FullBackup task, is the entry The operation was completed successfully (0x0) in the Last Run Result column?


75

In the specified backup directory (Standard: C:\ProgramData\PTVGROUP\PTV Map&Guide intranet 2017\DATA\ <SQL-Instanzname>\PTV Map&Guide_intranet \FULL, was a *.bak file created?

If both entries are there, the setup has been successful.

Notes: If required, you can adjust the set times at which the tasks are carried out through the Windows Task Planner. The intervals are set so that a full database backup is carried out every 8 days. Backups that are older than 8 days are automatically deleted by the jobs.

Checking log files Log files are created by carrying out the Windows tasks.

The result of the action last carried out is recorded in a log file which has the same name as the corresponding task. Log files are saved under C:\ProgramData\PTVGROUP\PTV Map&Guide intranet 2017\Log\ MaintenanceSolution.

Note: For security reasons we recommend you check the log files at regular inter-vals.

Deleting Windows tasks

You can delete all the Windows tasks again to back up the PTV Map&Guide intra-net databases.

To do this, start the file schtask_delete_all.cmd using administrator rights.

76

7 Tips and Tricks

7.1 Changing log file path

After installation, log files are saved in the default directories under C:\ProgramData\PTVGROUP\PTV PTV Map&Guide intranet 2017\Log\.

You can change this path at the beginning of the installation. To do so you must call up the Setup. exe with the following parameters

setup.exe Logpath = "<Path details>", e.g.

setup.exe Logpath = "D:\MGintra 2017"

7.2 Subsequent enabling of traffic information retrieval

If you have not enabled traffic information retrieval during installation, you can do this subsequently.

1. Go to the directory in which the PTV xRoute Server has been installed.

Note: When installing using the default directories, the PTV xRoute Server component can be found under C:\Program Files\PTVGROUP\PTV Map&Guide intranet 2017\xServer\ xRoute.

2. Open the webapps directory.

3. Rename the TrafficInfoLoader.wa_ file as TrafficInfoLoader.war.

After a few minutes, the traffic information will be retrieved automatically.

Tips and Tricks

77

7.3 Change web application to https

Note: To redirect the web application to https, changes need to be made in the configuration files. Changes should only be made by experienced users because settings containing errors could cause the program to become unstable or the version to become impossible to run.

You can change the URL to a secure connection (https://) via the IIS and the con-figuration files for the web application.

Note: To convert the URLs, the Microsoft module "URL Rewrite" must be installed in the IIS. You can find the module on the installation DVD under Sup-port\MUI\URL_Rewrite or online at http://www.iis.net/downloads/microsoft/url-rewrite

7.3.1 Assigning the IIS certificate

Open the Internet Information Services (IIS) Manager.

1. Choose the computer on which the web application was installed.

http://www.iis.net/downloads/microsoft/url-rewrite

78

2. Choose the entry Server Certificates.

3. Click on Open Feature.

Create a self-signed certificate.

Tip: Alternatively, you can import a certificate that already exists.

1. Click on Create Self-Signed Certificate in the Actions pane.

2. Give the certificate a name.

3. Confirm your entries with OK.

Tips and Tricks

79

Assign the certificate to the website.

1. Choose Default Web Site in the navigator.

2. Click on Bindings in the Actions pane.

3. Click on Add on the Site Bindings page.

4. Choose https in the Type drop-down list on the Add Site Bindings page.

5. Choose your certificate from the SSL Certificate drop-down list.

6. Confirm your entries with OK.

7.3.2 Enabling rerouting rules

In the next step, enable the rerouting rules in the PTV Map&Guide intranet web.config files in which you enable the rewrite function.

Note: The rules are in four web.config files with comments. You need to re-move only the comments.

80

1. Switch to the PTV Map&Guide intranet 2017 installation directory (follow-ing standard installation, this would be under C:\Program Files\ PTVGROUP\ PTV Map&Guide intranet 2017).

2. Search for files with the name web.config.

3. Mark the web.config files found.

Note: You must not edit the Web.config file in the xServerProxy directory.

4. Open the files with a text editor.

5. In each web.config file, search for the entry <rewrite>.

6. Remove the start and end of the comment to activate the function.

If the rule has been activated in all four web.config files, the call-up is converted to https.

Tips and Tricks

81

7.3.3 Amending URLs in the configuration files

To ensure that the online help and contents of the state monitors are still shown after conversion, you must convert both URLs in the configuration files to https.

Administration Tool configuration file: 1. Open the administration tool's configuration file (after a standard installa-

tion found under C:\Program Files\PTVGROUP\PTV Map&Guide intranet 2017\frontend_admin\conf\config.js).

2. Search for the entry "webhelp.url" and change the URL from http to https.

3. Search for the entry "fe.url" and change the URL from http to https.

PTV Map&Guide intranet configuration file: 1. Open PTV Map&Guide intranet's configuration file (after a standard instal-

lation found under C:\Program Files\PTVGROUP\PTV Map&Guide intranet 2017\frontend\conf\config.js).

2. Search for the entry "webhelp.url" and change the URL from http to https.

3. Search for the entry "fe.url" and change the URL from http to https.

7.4 Hide access to the administration tool in the login window

In the standard configuration, each user is offered access to the administration tool when logging into PTV Map&Guide intranet. If you want to allow users access only to the PTV Map&Guide intranet application (web client), you can change the settings in the configuration file config.js.

Note: Changes in the configuration file should only be made by experienced users because settings containing errors could cause the program to become unstable or the version to become impossible to run. Before any changes, we recommend you to save the config.js file.

On the computer on which the web application was installed, open the file config.js under C:\Program Files\PTVGROUP\PTV Map&Guide in-tranet 2017\frontend\conf.

82

Change the "hideAdminToolLogin" entry: false, to "hideAdminToolLogin": true,

7.5 Display preferences for road types with val-ues.

In PTV Map&Guide intranet, when creating routing profiles, you can specify which road types you prefer for the planning of a route.

You have sliders here with which you can specify whether you wish to favour or avoid a road type.

In factory settings, no values are displayed for the sliders. The internally stored values are abstract and have not got any significance in themselves.

However, if you wish to compare the values set, for example, if each user is to work with the same settings, it can be useful to display the values or enter values.

Tips and Tricks

83

As such, you can enable this function. To do this, the configuration file Con-fig.js needs to be changed.


On the computer on which the web application was installed, open the file config.js under C:\Program Files\PTVGROUP\PTV Map&Guide in-tranet 2017\frontend\conf.

Search for the entry "vehicle.RoutingProfileNumberFields":false,

Change the entry to "vehicle.RoutingProfileNumberFields":true,

Note: If the entry does not exist, add it.

The next time that you start up PTV Map&Guide intranet, the values will be dis-played under the slider and you can entry your own values into the input field.

84

Note: Please note that you can enter values only between -99 and 2501. -99 means very strong preference for the road type, 2501 works like a block. In the value field, 400 values will be different. If you enter the value 1000, for example, this is rounded to the next known value in PTV Map&Guide intranet, in this exam-ple, 1003.

7.6 Expanding information text for new users

If you have created a user in the administration tool, you can send the required login data to the user by email.

There is a standard text here in the administration tool:

Link to PTV Map&Guide intranet 2017: <Link>

User name: <User name>

Password: <Password>

If you do not wish to give the user more information, you can amend the standard text in the configuration file Config.js.


On the computer on which the web application was installed, open the file config.js under C:\Program Files\PTVGROUP\PTV Map&Guide in-tranet 2017\frontend_admin\conf.

Search for the entry "newuser.infotext":““,

Enter your chosen information text, e.g.: "newuser.infotext":"Please change the password at: My account > Change password",

Note: If the entry does not exist, add it.

Tips and Tricks

85

7.7 Possibilities for load sharing

Note: In order to increase the performance of the system, there are different possibilities. To find the optimal solution for your system environment, contact your PTV Map&Guide intranet consultant in advance.

As an example, you have the option of also installing additional PTV xServer components on other computers in order to achieve a better load distribution.

1. On the new computer, please run the setup.exe program DVD for the in-stallation.


3. Select the following components in the setup and follow the instructions from the installation wizard:

Map server

Database



After successful installation of the PTV xServer components, you must restart the Internet Information Server (IIS) on the computer on which the web application is running.

Note: Restarting the Internet Information Server causes a short-term interruption when working with PTV Map&Guide intranet. We therefore recommend restart-ing at a time when no users are working with PTV Map&Guide intranet.

7.8 Use remote control

In the PTV Map&Guide intranet Client, information can be transferred through an interface via the external systems, such as trip or customer administration sys-tems. Therefore, for example, a route can be created, calculated and optimised from customer addresses in the Route planning application.

You will find a detailed description of the remote control in the help for the ad-ministration tool.

disclaimer warranty restrictions further copyrights · this software is provided by chad z. hower...

Documents