0% found this document useful (0 votes)
416 views

Poly Works Talisman Network Security and Setup Guide

Uploaded by

tibor
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
416 views

Poly Works Talisman Network Security and Setup Guide

Uploaded by

tibor
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 40

PolyWorks|Talisman™

Network Security
and Setup
© 2011–2020 InnovMetric Software Inc. All rights reserved. PolyWorks® is a registered
trademark of InnovMetric Software Inc. InnovMetric, PolyWorks|Inspector,
PolyWorks|Modeler, PolyWorks|Talisman, PolyWorks|Reviewer, IMAlign, IMMerge, and "The
Universal 3D Metrology Software Platform" are trademarks of InnovMetric Software Inc.
Apple, App Store, iPod touch, iPad, iPhone, and Bonjour are registered trademarks of Apple
Inc. Android™ and Google Play are trademarks of Google Inc. SmartGD&T is a trademark of
Multi Metrics Inc. All other trademarks are the property of their respective owners.

This manual, as well as the software described in it, is furnished under license and may be
used or copied only in accordance with the terms of such license. The content of this
document is furnished for informational use only, and is subject to change without notice.
InnovMetric Software Inc. assumes no responsibility or liability for any errors or inaccuracies
that may appear in this document.

Except as permitted by such license, reproduction in whole or in part in any way without
written permission from InnovMetric Software is strictly prohibited.

PolyWorks|Talisman Network Security and Setup Guide


2020/03/17
PolyWorks® Metrology Suite 2020
Contents

5 1. Overview of Project Detection and Connections

6 2. Implementing Network Security Mechanisms


6 2.1 Requirements
6 2.2 Network security mechanisms
6 2.2.1 Encrypted network communication
7 2.2.2 PolyWorks server whitelist
8 2.2.3 TCP port restriction
9 2.2.4 Firewall configuration
15 2.2.5 Virtual Private Network (VPN) connection

16 3. Setting up a Wi-Fi network


16 3.1 Setting up a router or an access point
25 3.2 Using Windows to create a Wi-Fi hotspot with a notebook computer

27 4. Installing the Bonjour Networking Technology


27 4.1 Installation procedure

30 5. Troubleshooting
31 5.1 Talisman connection troubleshooting steps
31 5.1.1 Project not visible on the Talisman Projects page
32 5.1.2 Connection to the project not successful
33 5.2 Verifying the network configuration
33 5.2.1 PolyWorks server network configuration
33 5.2.1.1 Verifying the network configuration from PolyWorks
34 5.2.1.2 Verifying the network configuration in Windows
36 5.2.2 Subnet mask values
36 5.3 Choosing a different network connection
38 5.4 Restarting the PolyWorks server for Talisman
39 5.5 Technical support

40 Appendix A: Project Detection and Connection Diagram

PolyWorks|Talisman Network Security and Setup Guide 2020 3


Introduction

This guide covers network issues that network administrators must consider when
using PolyWorks|Talisman™. Talisman is a remote control application for mobile devices
that allows, for example, operators to take measurements and obtain project
information without having to navigate back and forth to the computer running the
PolyWorks Metrology Suite.

Talisman is based on client-server technology. Information between the PolyWorks


server (PolyWorks|Inspector or IMAlign) and the Talisman client (Apple mobile devices
or Android mobile devices) is exchanged through a local Wi-Fi network. This
communication relies on network communication protocols for project detection and
connections. This subject is covered in Chapter 1 Overview of Project Detection and
Connections.

Note that no proprietary information is saved on the mobile device. The application has
been designed to guarantee total confidentiality under all circumstances. This subject
is presented in Chapter 2 Implementing Network Security Mechanisms and Chapter 3
Setting up a Wi-Fi network.

This guide also gives instructions with regards to the following:

 Installing the Bonjour networking technology, a trademark of Apple Inc., which is


required to use Talisman (see Chapter 4 Installing the Bonjour Networking
Technology).

 Troubleshooting Talisman, if problems occur (see Chapter 5 Troubleshooting).

For information on how to use Talisman, see the Talisman document available from the
Help menu of the Workspace Manager, the PolyWorks|Inspector module, and the
IMAlign module.

PolyWorks|Talisman Network Security and Setup Guide 2020 4


1. Overview of Project Detection and
Connections
This chapter introduces the network technology used to communicate between the
Talisman client (Apple mobile devices or Android mobile devices) and the PolyWorks
server (the PolyWorks|Inspector or the IMAlign module of the PolyWorks Metrology
Suite). This communication relies on two different network communication protocols:

 The User Datagram Protocol (UDP) is a simple broadcast protocol for pushing
information on a network without establishing a connection with any specific host,
without any guarantee regarding the order in which the information arrives or
whether the information will arrive at all.

The Bonjour networking technology, required by Talisman, uses UDP to broadcast


PolyWorks project information to Talisman applications.

 The Transmission Control Protocol (TCP) establishes a peer-to-peer connection with


a remote host, and then uses that connection to send and receive information that
should always arrive in the correct order.

The Talisman application uses TCP to connect to a PolyWorks project and exchange
information with it.

Here is a diagram that illustrates the communication between the Talisman client and
the PolyWorks server:

UDP

PolyWorks server Talisman client


(e.g., Inspector)
Wi-Fi router

TCP
Mobile device

Computer

For detailed information concerning the steps involved in Talisman project detection
and connections, see Appendix A Project Detection and Connection Diagram.

PolyWorks|Talisman Network Security and Setup Guide 2020 5


2. Implementing Network Security
Mechanisms
Talisman is a remote control application that uses a Wi-Fi network to connect the
mobile device to the Windows-based PolyWorks Metrology Suite.

This chapter describes best practices with regards to the requirements and security
mechanisms.

2.1 Requirements
Before using Talisman, the following requirements must be met:

 A Wi-Fi network is required.

If no Wi-Fi network is set up, it is recommended to build one with a Wi-Fi access point
device. It is not recommended to use a notebook computer with Wi-Fi capabilities, as
this can be extremely cumbersome. Chapter 3 Setting up a Wi-Fi network explains
how to set up an access point.

 The PolyWorks® Metrology Suite 2020 or later must be installed on your workstation.

 The Bonjour networking technology must be installed.

See Chapter 4 Installing the Bonjour Networking Technology for the installation
procedure.

 The Talisman app must be downloaded. It is available for Apple mobile devices from
the App Store online store, and for Android mobile devices from Google Play.

2.2 Network security mechanisms


To ensure network security, the issues described in the following subsections need to
be considered.

2.2.1 Encrypted network communication

It is recommended that you configure your Wi-Fi network so that the communications
are encrypted.

In addition to this encryption, the communication between the remote control


application and the PolyWorks Metrology Suite has been secured using a proprietary
encryption method.

PolyWorks|Talisman Network Security and Setup Guide 2020 6


Implementing Network Security Mechanisms Network security mechanisms

2.2.2 PolyWorks server whitelist

You can set up a list of authorized devices for a PolyWorks server. On the PolyWorks
server, proceed as follows:

1. Open the TalismanDevices.txt file, which is located in the PolyWorks Metrology


Suite installation folder (usually C:\Program Files\InnovMetric\PolyWorks MS 2020).

2. Specify the Device ID of each allowed device, then save the file. More information on
the Device ID is provided later in this section.

Here is an example of the TalismanDevices.txt file with two Device IDs:

Only the devices included in the whitelist are granted access to Talisman projects. There
are two levels of verification:

 A verification is performed by Talisman at project discovery.

 A verification is performed by the PolyWorks server at connection time.

Note:
If there is no TalismanDevices.txt file in the PolyWorks Metrology Suite installation
folder (default behavior), or if this file is empty, all devices are authorized.

A visual indicator (icon) is added to the status bar of PolyWorks servers for Talisman
(e.g., PolyWorks|Inspector). By means of this indicator, it is possible to access the

PolyWorks|Talisman Network Security and Setup Guide 2020 7


Implementing Network Security Mechanisms Network security mechanisms

Talisman client device (e.g., iPod touch) information (see the figure that follows). The
Device ID can be copied from there and be used to create the whitelist.

2.2.3 TCP port restriction

Communication between a client device and the PolyWorks server uses TCP ports. By
default, these ports are not specified, which means that they are determined by the
server.

To specify minimum and maximum port numbers to use to find an available port:

1. Create a file named innovmetric.config in the PolyWorks Metrology Suite


installation folder.

2. In this file, enter the following lines (see the note that follows):

TALISMAN_TCPIP_RESTRICT_PORTS = 1

TALISMAN_TCPIP_PORT_MIN = [minimum port number]

TALISMAN_TCPIP_PORT_MAX = [maximum port number]

If you want to specify port numbers, the TALISMAN_TCPIP_RESTRICT_PORTS must


be set to 1. Otherwise, the ports are automatically determined by the server (default
behavior).

When TALISMAN_TCPIP_RESTRICT_PORTS is set to 1, you must specify the


minimum and maximum values according to your needs (see the table that follows).

PolyWorks|Talisman Network Security and Setup Guide 2020 8


Implementing Network Security Mechanisms Network security mechanisms

Note that valid port numbers are 0, and between 1025 and 65535 inclusively. Zero
means that the port number is determined by the server.

To specify... Examples

A minimum port number only TALISMAN_TCPIP_PORT_MIN = 3000


(e.g., 3000) TALISMAN_TCPIP_PORT_MAX= 0

A maximum port number only TALISMAN_TCPIP_PORT_MIN = 0


(e.g., 4000) TALISMAN_TCPIP_PORT_MAX= 4000

A range of ports with a TALISMAN_TCPIP_PORT_MIN = 3000


minimum and a maximum TALISMAN_TCPIP_PORT_MAX= 4000
limit (e.g., between 3000 and
4000)

A single port number (e.g., TALISMAN_TCPIP_PORT_MIN = 3000


3000) TALISMAN_TCPIP_PORT_MAX= 3000

Note that the number of concurrent PolyWorks servers enabled on the same
computer is limited by the number of allowed ports.

3. Save and close the file.

The TCP port setting applies to all PolyWorks users of the same computer. However, it
can be overridden by a user through the Workspace Manager options.

2.2.4 Firewall configuration

When starting Talisman on the mobile device, a list of available projects is displayed on
the screen. If you cannot connect to a project, you may need to open some TCP ports in
your computer's firewall.

PolyWorks|Talisman Network Security and Setup Guide 2020 9


Implementing Network Security Mechanisms Network security mechanisms

To open TCP ports in your firewall (Windows 7 or later):

1. In Windows 10, right-click the Start button to access the Control Panel. In Windows
7 and Windows 8, on the Start menu, choose Control Panel, then Windows
Firewall.

2. In the left pane, click Advanced settings.

The Windows Firewall with Advanced Security window displays.

PolyWorks|Talisman Network Security and Setup Guide 2020 10


Implementing Network Security Mechanisms Network security mechanisms

3. In the left pane, click Inbound Rules, and make sure that PolyWorks|Inspector or
IMAlign is not blocked by deleting any existing blocking rule related to
PolyWorks|Inspector or IMAlign.

4. In the right pane, click New Rule.

The New Inbound Rule Wizard displays.

PolyWorks|Talisman Network Security and Setup Guide 2020 11


Implementing Network Security Mechanisms Network security mechanisms

5. Select the Port rule type and click Next.

6. Select the TCP port type, and enter the specific local ports that were specified for
Talisman, either through the Workspace Manager options or the global
configuration file.

PolyWorks|Talisman Network Security and Setup Guide 2020 12


Implementing Network Security Mechanisms Network security mechanisms

7. Click Next.

8. Select Allow the connection, then click Next.

9. Select the type of network to which the rule applies, then click Next.

PolyWorks|Talisman Network Security and Setup Guide 2020 13


Implementing Network Security Mechanisms Network security mechanisms

10. Enter a name and a description for the rule, then click Finish.

The rule should now be listed in the Inbound Rules section. See the following
example.

If the projects are not visible on the Projects page of Talisman, add similar firewall
inbound and outbound rules for UDP port 5353, which is used by the Bonjour
networking technology to broadcast project information. For more information on UDP

PolyWorks|Talisman Network Security and Setup Guide 2020 14


Implementing Network Security Mechanisms Network security mechanisms

port 5353, see the introduction in Chapter 4 Installing the Bonjour Networking
Technology.

If any change has been made, restart the PolyWorks server for Talisman (see Section 5.4
Restarting the PolyWorks server for Talisman).

2.2.5 Virtual Private Network (VPN) connection

Talisman can be used with a VPN connection. Note, however, that:

 Communication may be slower.

 The Bonjour networking technology is not supported through a VPN so PolyWorks


project name broadcasting and discovery does not work. Therefore, Talisman must
be configured to allow entering the PolyWorks server coordinates manually.

PolyWorks|Talisman Network Security and Setup Guide 2020 15


3. Setting up a Wi-Fi network
This chapter explains how to set up a Wi-Fi network in the context of Talisman. There
are two options:

 Use a router or an access point (recommended in a production environment where


stability and reliability are critical). See Section 3.1 Setting up a router or an access
point.

 In Windows 7 or later, create a Wi-Fi hotspot with a notebook computer with Wi-Fi
capabilities (can be used for a quick setup, like a demonstration). See Section 3.2
Using Windows to create a Wi-Fi hotspot with a notebook computer.

3.1 Setting up a router or an access point


Different brands of wireless routers or access points can be used for Talisman. In this
section, the setup procedure is explained using a TP-Link TL-WA901ND access point.

To set up the Wi-Fi network, you must first take note of the current network
configuration (Steps 1 to 4 that follow). You must also verify that the Talisman client and
the PolyWorks server have the same network configuration. However, if the computer
used to set up the router, or the access point, is not part of a network, go to Step 5.

1. Using Windows 7 or later, open the Network Connections window. From the
Control Panel, choose Network and Sharing Center, then Change adapter
settings (on the left menu).

2. Right-click Local Area Connection and choose Properties.

PolyWorks|Talisman Network Security and Setup Guide 2020 16


Setting up a Wi-Fi network Setting up a router or an access point

3. In the dialog box displayed, select Internet Protocol Version 4 (TCP/IPv4) (for
Windows 7 or later). Then, click the Properties button.

4. Note every configuration setting displayed in the dialog box. You will have to re-
enter this information after the access point configuration.

PolyWorks|Talisman Network Security and Setup Guide 2020 17


Setting up a Wi-Fi network Setting up a router or an access point

Note:
If the Obtain an IP address automatically option is selected, you must obtain this
address:

 In Windows 10, right-click the Start button to access the Run item. In Windows 7
and Windows 8, from the Start menu, choose Run.

 Enter cmd, then press Enter.

 Enter the ipconfig /all command.

In the following example, the IP address is 192.168.0.60.

 Write down the IP address as well as the default gateway.

Once the computer is disconnected from the network:

5. Connect the power cable to the TP-Link access point, and connect the access point
to your computer using a network cable.

You are ready to change or add the configuration, as described in the text that follows:

6. Open the IP address dialog box (see Steps 1-3 for instructions on accessing the
dialog box).

PolyWorks|Talisman Network Security and Setup Guide 2020 18


Setting up a Wi-Fi network Setting up a router or an access point

7. Set the following parameters using the values that follow:

8. Close all the opened dialog boxes.

9. Launch your Web browser (such as Internet Explorer) and enter 192.168.1.254 in
the address bar.

10. Press the Enter key.

A login dialog box is displayed.

PolyWorks|Talisman Network Security and Setup Guide 2020 19


Setting up a Wi-Fi network Setting up a router or an access point

11. Enter the user name and password for the TP-Link access point. By default, the
values are:

User name = admin

Password = admin

Remember the user name and password; they are required in a following step.

12. Click the OK button.

The following window appears. This is the main menu of the access point device.

13. On the vertical menu, click QSS.

PolyWorks|Talisman Network Security and Setup Guide 2020 20


Setting up a Wi-Fi network Setting up a router or an access point

14. In the QSS (Quick Secure Setup) window, click the Disable QSS button. The QSS
status becomes Disabled.

15. On the menu, click Network.

16. Enter an IP address for the access point in your current network.

Since the starting IP address was 192.168.0.132, the network identifier is 192.168.0.
You must keep the first three digit groups and change only the last one (in our
example, 132). Do not use 1, 50, or 254 as the last digit group since these groups are
often used by devices. In this example, we use 180.

17. Enter the correct default gateway (in our example, 192.168.1.254).

PolyWorks|Talisman Network Security and Setup Guide 2020 21


Setting up a Wi-Fi network Setting up a router or an access point

18. Click the Save button.

You will lose access to the access point since it is rebooting.

19. Connect the computer and the access point to your local network.

20. Reconfigure your network card as it was in Step 4.

21. Restart your Web browser and use the new access point address to establish the
connection with the access point (in our example, 192.168.0.180).

22. Enter the same user name and password as entered before.

23. On the menu of the TP-LINK main window, click Wireless.

PolyWorks|Talisman Network Security and Setup Guide 2020 22


Setting up a Wi-Fi network Setting up a router or an access point

24. In the SSID field of the Wireless Settings window, specify a name for the access
point.

You can change the default name (in this example, TP-LINK_ABF0A4) for another
name. The name specified in the SSID field will be the one displayed on the Wi-Fi
devices (i.e., iPad) at connection time.

25. Set your country.

26. Click the Save button.

27. In the Wireless Security section, choose WPA-PSK/WPA2/PSK.

28. Enter a PSK password (e.g., SecuringFrankAccessPoint12541).

Note:
Remember this password since it will be required to configure certain mobile
devices (i.e., iPod touch).

29. Click the Save button.

30. On the menu, click DHCP.

PolyWorks|Talisman Network Security and Setup Guide 2020 23


Setting up a Wi-Fi network Setting up a router or an access point

31. In the DHCP Settings section, select the Enable option.

You can change the pool of addresses available on your wireless network. In the
previous example, there are only six IP addresses available for the wireless devices
(from 192.168.0.100 to 192.168.0.105).

32. Enter the appropriate default gateway address.

33. Click the Save button.

34. On the menu, click System Tools.

35. In the Backup & Restore section, you can save a copy of the configuration on your
main computer.

PolyWorks|Talisman Network Security and Setup Guide 2020 24


Setting up a Wi-Fi network Using Windows to create a Wi-Fi hotspot with a notebook
computer

36. In the Password section, it is strongly recommended that you change the default
password for security reasons.

37. Reboot the TP-Link access point (by unplugging the power cable for a few seconds).

38. Plug the power cable back in and wait about a minute.

39. Test the wireless access point with a wireless-capable device (i.e., iPad).

3.2 Using Windows to create a Wi-Fi hotspot with a


notebook computer
If you need to quickly set up a wireless network (e.g., to demonstrate Talisman), you can
create a Wi-Fi hotspot using your notebook computer. This solution is not
recommended in a production environment since reliability is not guaranteed. For a
production environment, see Section 3.1 Setting up a router or an access point.

Requirements:

 Windows 7 or later must be installed on the computer.

 The computer must have Wi-Fi capabilities.

1. Run the cmd.exe command-line utility with administrator rights and enter the
following command:

netsh wlan set hostednetwork mode=allow

PolyWorks|Talisman Network Security and Setup Guide 2020 25


Setting up a Wi-Fi network Using Windows to create a Wi-Fi hotspot with a notebook
computer

2. Register a network called "TALISMAN" with the “SecretCode90125” encryption key:

netsh wlan set hostednetwork ssid=TALISMAN key=


SecretCode90125 keyUsage=persistent

3. Run the service:

netsh wlan start hostednetwork

To stop the service, enter the following command:

netsh wlan stop hostednetwork

PolyWorks|Talisman Network Security and Setup Guide 2020 26


4. Installing the Bonjour Networking
Technology
The Bonjour networking technology is required to use Talisman. It enables automatic
discovery of computers, devices, and services on IP networks. For more information
about this service, visit http://www.apple.com/support/bonjour/.

This chapter explains how to install the Bonjour service. This installation must be
performed before enabling the PolyWorks server. Otherwise, when clicking PolyWorks
server for Talisman in the Workspace Manager options, you will be prompted to install
the service.

Note that the Bonjour networking protocol sends and receives network packets on
UDP port 5353. The Bonjour installer configures the Windows firewall appropriately
during installation on supported systems. However, if you have a separate “personal
firewall” enabled, you have to make sure that UDP port 5353 is open. Otherwise, no
projects will be displayed on the Projects page of Talisman. See Section 2.2.4 Firewall
configuration for information on how to open TCP ports in your firewall.

4.1 Installation procedure


To install the service:

1. Open the PolyWorks Metrology Suite installation folder (usually C:\Program


Files\InnovMetric\PolyWorks MS 2020).

2. Open the redist folder, and double-click the Bonjour.msi file (or Bonjour64.msi for
64-bit systems).The following window appears:

PolyWorks|Talisman Network Security and Setup Guide 2020 27


Installing the Bonjour Networking Technology Installation procedure

3. Click Next to launch the installation procedure.

4. In the window displayed, choose I accept the terms in the license agreement.

5. Click Next.

6. Read the information displayed on screen.

7. Click Next.

PolyWorks|Talisman Network Security and Setup Guide 2020 28


Installing the Bonjour Networking Technology Installation procedure

8. In the Installation Options window, set the appropriate options and choose the
destination folder.

Note that the parameters set in this window do not affect the Talisman
functionalities.

9. Click Install.

10. When the installation procedure is completed, click Finish.

PolyWorks|Talisman Network Security and Setup Guide 2020 29


5. Troubleshooting
If you encounter a problem using Talisman (the projects are not visible on the Talisman
Projects page or the connection to the project fails), refer to the following flowchart.
For more information, refer to Section 5.1 Talisman connection troubleshooting steps.

Start

In Section 5.1.1 Project not visible on the Talisman Projects page

Check the PolyWorks server for Talisman


option in the Workspace Manager (see step 1.).

Restart the PolyWorks server for Talisman and


restart the Talisman application (see step 2.).

Is the project Check the network configuration for both the


visible on the No computer and the mobile device (see step 3.).
Talisman
Projects page?
Change the network connection (see step 4.).

Make sure that the Bonjour networking


technology is installed and running (see step 5.).

Make sure that UDP port 5353, needed by


Yes Bonjour, is open (see step 6.).

If any change has been made, restart the


PolyWorks server for Talisman (see Section 5.4
Restarting the PolyWorks server for Talisman).

In Section 5.1.2 Connection to the project not successful

Check the network configuration for both the


computer and the mobile device (see step 1.).
Is connection No
to the project
successful? Make sure that the TCP ports are open
(see step 2.).

Change the network connection (see step 3.).

Yes

If any change has been made, restart the


PolyWorks server for Talisman (see Section 5.4
End Restarting the PolyWorks server for Talisman).

PolyWorks|Talisman Network Security and Setup Guide 2020 30


Troubleshooting Talisman connection troubleshooting steps

5.1 Talisman connection troubleshooting steps


This section explains how to perform troubleshooting steps for issues that may occur
when you try to use Talisman. If the problem remains unsolved, contact the
InnovMetric Software technical support team (see Section 5.5 Technical support).

5.1.1 Project not visible on the Talisman Projects page

1. Check the PolyWorks server for Talisman option in the Workspace Manager:

1.1 In the Workspace Manager, choose Tools > Options.

1.2 Click the Talisman page in the left part of the dialog box.

1.3 Make sure that the PolyWorks server for Talisman option is selected,
then click Apply.

2. Restart the PolyWorks server, then restart the Talisman application:

2.1 In the module, open the menu of the Talisman status bar icon and select
Restart PolyWorks Server.

2.2 On the mobile device, press or tap the Home button to close the Talisman
application.

2.3 For Apple mobile devices, press or tap the Home button twice to remove
the application from the device’s cache. For Android mobile devices, press
or tap the Recent Apps button and swipe the application to the left or
right.

2.4 Start the Talisman application again.

PolyWorks|Talisman Network Security and Setup Guide 2020 31


Troubleshooting Talisman connection troubleshooting steps

3. Check the network configuration for both the computer and the mobile device.

See Section 5.2 Verifying the network configuration for more information.

4. Choose a different network connection.

See Section 5.3 Choosing a different network connection for more information.

5. Make sure that Bonjour is installed and running:

5.1 In the Workspace Manager, choose Tools > Options.

5.2 Click Talisman in the left part of the dialog box.

5.3 Deselect the PolyWorks server for Talisman option and click Apply.

5.4 Select the PolyWorks server for Talisman option and click Apply.

Reapplying the option validates the Bonjour installation and the current
running status, prompting the user if a problem is detected.

If any changes are made, you must restart the PolyWorks server (see
Section 5.4 Restarting the PolyWorks server for Talisman).

6. Make sure that UDP port 5353, needed by Bonjour, is open:

Check if there is a network security software or device that is blocking the port. See
Section 2.2.4 Firewall configuration for information on how to modify the Windows
firewall.

5.1.2 Connection to the project not successful

1. Check the network configuration for both the computer and the mobile device:

See Section 5.2 Verifying the network configuration for more information.

2. Make sure that the TCP ports are open:

Check if there is a network security software or device that blocks the TCP ports used
for the static and dynamic ports. See Section 2.2.4 Firewall configuration for
information on how to modify the Windows firewall.

3. Choose a different network connection.

See Section 5.3 Choosing a different network connection for more information.

PolyWorks|Talisman Network Security and Setup Guide 2020 32


Troubleshooting Verifying the network configuration

5.2 Verifying the network configuration


Verify that the Talisman client and the PolyWorks server are on the same Wi-Fi by
checking the network configuration for both the computer and the mobile device. The
following subsections describe how to verify the server network configuration.

5.2.1 PolyWorks server network configuration

5.2.1.1 Verifying the network configuration from PolyWorks

1. Click the Talisman icon on the module’s status bar, or select PolyWorks Server
Status from the icon's menu.

The PolyWorks Server Status for Talisman window displays. It contains the
PolyWorks server’s Name, IP address, Static port number (the TCP port used for the
PolyWorks server), and Dynamic port number (the TCP port used for the project).

PolyWorks|Talisman Network Security and Setup Guide 2020 33


Troubleshooting Verifying the network configuration

5.2.1.2 Verifying the network configuration in Windows

1. In Windows 10, right-click the Start button to access the Control Panel. In Windows
7 and Windows 8, choose Start > Control Panel > Network and Sharing Center.

2. In the list of active networks, click the name of the network adapter next to the
Connections label.

PolyWorks|Talisman Network Security and Setup Guide 2020 34


Troubleshooting Verifying the network configuration

3. In the window displayed, click the Details button. The details concerning the
current network configuration, including the IPv4 address and IPv4 subnet mask,
are displayed in the Network Connection Details window.

Note that the same information can be obtained using the ipconfig command in
the Command Prompt.

Also, the ipconfig /release command followed by the ipconfig /renew command
can be used to force a computer that does not use a static IP address to release its
address and reacquire it. This might be useful if you have to change some network
settings of the computer, or its router or access point.

PolyWorks|Talisman Network Security and Setup Guide 2020 35


Troubleshooting Choosing a different network connection

5.2.2 Subnet mask values

To avoid problems, the subnet masks for both the mobile device and the server should
have the same values. As a result, the IP addresses will be very similar, the only
differences being the numbers for which the corresponding subnet mask value is 0. See
the following table:

Subnet mask Sample client IP address Sample server IPv4 address

255.255.255.0 192.115.2.208 192.115.2.134

255.255.0.0 192.115.4.208 192.115.2.134

If the subnet mask values are not the same on both the mobile device and the server,
you have to change either the Wi-Fi router's or access point's settings (to change the
mobile device's subnet mask), or the computer’s network adapter settings (to change
the server's subnet mask).

If any change is made, you must restart the PolyWorks server for Talisman (see Section
5.4 Restarting the PolyWorks server for Talisman).

5.3 Choosing a different network connection


If the projects are not visible on the Projects page of Talisman, or if you see the projects
but cannot connect to them, you might need to change the network connection used
by the server.

To change the network connection:

1. Access the PolyWorks server for Talisman option in the Workspace Manager:

1.1 In the Workspace Manager, choose Tools > Options.

1.2 In the left part of the dialog box, click the Talisman page.

PolyWorks|Talisman Network Security and Setup Guide 2020 36


Troubleshooting Choosing a different network connection

1.3 Make sure that the PolyWorks server for Talisman option is selected.

2. Change the network connection:

2.1 From the Network connection list box, choose a connection through
which both the server and the client will be able to communicate.

2.2 Click Apply.

For more information on choosing a network connection, see the “Talisman options”
section of the PolyWorks Reference Guide.

PolyWorks|Talisman Network Security and Setup Guide 2020 37


Troubleshooting Restarting the PolyWorks server for Talisman

5.4 Restarting the PolyWorks server for Talisman


If a change is made to the server's network configuration, the active PolyWorks server
for Talisman must be restarted.

To restart a PolyWorks server for Talisman:

1. Open the menu of the Talisman status bar icon in PolyWorks|Inspector or IMAlign.

2. Choose Restart PolyWorks Server.

PolyWorks|Talisman Network Security and Setup Guide 2020 38


Troubleshooting Technical support

5.5 Technical support


To contact technical support personnel for any unresolved problems, use the
instructions that follow:

1. Click the Talisman status bar icon in the module and copy and paste the information
found in the PolyWorks Server Status for Talisman window to a text file.

2. Generate a server log file by adding the following line to the [user configuration
folder]/.innovmetric.[version]/innovmetric.config2 file:

TALISMAN_LOG_FILE = [path to log file, ex: C:\TalismanLog.txt]

Restart PolyWorks|Inspector or IMAlign and perform the sequence of actions that


lead to the problem. Then, delete the line that you have added in the configuration
file.

3. Generate a support assistant file using the Workspace Manager's Help > Support
Assistant menu item.

4. In another text file, write down as much information as possible regarding the
mobile device, including the Talisman version number (found at the bottom of the
Projects page), the device type (i.e., iPad) and the device OS information.

5. Send a detailed description of the problem along with the above files to the
InnovMetric Software technical support team at [email protected].

PolyWorks|Talisman Network Security and Setup Guide 2020 39


Appendix A: Project Detection and
Connection Diagram
The diagram that follows illustrates the steps involved in Talisman project detection
and connection. A legend provides a description for each step.

PolyWorks server
(e.g., Inspector)

1 10 11

Network Talisman client


adapter

UDP via Bonjour 5 6 15


2 9 12
3 4

8 7 Operating
Firewall
system

13 14

Computer TCP/IP Wi-Fi router Mobile device

Detection using UDP via Bonjour Connection using TCP/IP

1. Port acquisition and project 6. Project selection and client identification information
information packaging for Bonjoura. packaging for TCP/IP.
2. Outgoing UDP broadcast 7. Outgoing TCP/IP call.
authorization for Bonjour. 8. Incoming TCP/IP call authorization.
3. Project coordinates (IP address and 9. TCP/IP call reception.
TCP port) broadcast. 10. Client identification information analysis.
4. Incoming UDP broadcast 11. Client initialization information packaging for TCP/IP.
authorization for Bonjour. 12. Outgoing TCP/IP call authorization.
5. Project list display using the 13. Outgoing TCP/IP call.
information received from Bonjour.
14. Incoming TCP/IP call authorization.
15. Client initialization and connection confirmation.

a. Bonjour is a trademark of Apple Inc.

PolyWorks|Talisman Network Security and Setup Guide 2020 40

You might also like