Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
ProjectWise
  • Product Communities
ProjectWise
ProjectWise Design Integration Wiki ProjectWise Traceroute Utility [TN]
    • Sign In
    • +ProjectWise Design Integration Wiki
    • +ProjectWise Learning
    • +Projectwise Licensing
    • +Projectwise Documentation
    • -ProjectWise Explorer Client
      • +ProjectWise Client
      • +Featured Articles - Projectwise Explorer
      • +Audit Trail - ProjectWise Explorer Client
      • +Bentley IMS Login
      • +BS1192 Rules Engine - ProjectWise Explorer Client
      • +Check In Dialog - ProjectWise Explorer Client
      • +Document Code - ProjectWise Explorer Client
      • +Document Creation - ProjectWise Explorer Client
      • +Documentation & Help - ProjectWise Explorer Client
      • +Environments and Attributes - PWE
      • +Export / Import Tool - ProjectWise Explorer Client
      • +Folders / Subfolders - ProjectWise Explorer Client
      • +GUI - ProjectWise Explorer Client
      • +Installation - ProjectWise Explorer Client
      • +Integration - General
      • +Integration - AutoCAD - ProjectWise Explorer Client
      • +Integration - Civil 3D - ProjectWise Explorer Client
      • +Integration - DGN Platform - ProjectWise Explorer Client
      • +Integration - MicroStation - ProjectWise Explorer Client
      • +Integration - Office - ProjectWise Explorer Client
      • +Integration - Revit - ProjectWise Explorer Client
      • -Logs Troubleshooting- ProjectWise Explorer Client
        • ProjectWise Traceroute Utility [TN]
        • How to setup MicroStation logging with ProjectWise Explorer Integration TN
        • Microsoft DebugDiag - Quick Guide for ProjectWise crash issues
        • ProjectWise language does not change after installing localization
        • Troubleshooting ProjectWise Explorer using Process Monitor (ProcMon)
      • +Messaging Service - ProjectWise Explorer Client
      • +MISC - ProjectWise Explorer Client
      • +Open / Save / Copy / Move - ProjectWise Explorer Client
      • +Photo Preview - ProjectWise Explorer Client
      • +ProjectWise Managed Workspaces
      • +Project - ProjectWise Explorer Client
      • +Search - ProjectWise Explorer Client
      • +Security and Permissions - ProjectWise Explorer Client
      • +User Tools - ProjectWise Explorer Client
      • +Views - ProjectWise Explorer Client
      • +Workflows & States - ProjectWise Explorer Client
      • +Network Configuration - Client
    • +ProjectWise Administrator
    • +ProjectWise Integration Server
    • +ProjectWise Caching Server
    • +ProjectWise Gateway Server
    • +ProjectWise User Synchronization Service
    • +ProjectWise Orchestration Framework
    • +ProjectWise Connected Services
    • +Working from Home with ProjectWise
    • +ProjectWise Glossary
    • +ProjectWise Logging and Tools

     
     Questions about this article, topic, or product? Click here. 

    ProjectWise Traceroute Utility [TN]

       
      Applies To 
       
      Product(s): ProjectWise
      Version(s): V8 XM Edition
      Environment:  N/A
      Area:  N/A
      Subarea:  N/A
      Original Author: Bentley Technical Support Group
       

     

     

     

     

     

     

     

     

    Overview

    ProjectWise has historically allowed the user to configure complex routing configurations, in order to allow for external access to ProjectWise resources across a corporate firewall, as well as to allow the caching of CAD data so that the data is geographically closer to the users, removing the need for the users to access large files over a potentially slow WAN.

    However, as the complexity of the routing configurations grows, the ability to determine by what route a given client contacts a server grows equally complex. Often, it is necessary to dig through configuration files on many machines in order to determine the route.  Additionally, it has historically been practically impossible for a client machine to determine the overall latency for a given route.

    What is needed is a tool to display both information about what ProjectWise servers are transited in a given route, and the latency between those servers.

    ProjectWise Traceroute Tool

    This tool, when run from a client machine, will allow the user to determine the route to a given endpoint ProjectWise server, the latency between each hop in the route, and the caching configuration on each server that is transited.  If a connection cannot be made to a hop (either due to misconfiguration of the ProjectWise route, or a broken network link between machines), this tool will also report the last node that was successfully contacted, making it easier to determine the cause of networking issues.

     

    Usage:

    Usage: pwping [-d display-name] [-h hops] [-n count] [-t timeout]  target_name

    Options:

    -d display-name:      Display name of the endpoint datasource to trace route to; name will be resolved via normal ProjectWise DNS.

    If this switch is specified, the target_name command argument must be omitted.

    -h hops:                 Maximum number of servers to transit on the  way. Defaults to the end of the route.

    -n count:               Number of ping requests to send between hops.

                                   Defaults to 1.

    -t timeout:             Timeout in milliseconds to wait for each reply.

                                   Defaults to 5000ms.

    -c:                        Display caching configuration information

    Examples:

     

    For this example, we shall assume that the server PW_INTSRV has a misconfigured route to server PW_FILESTOR. Thus, the output from pwping for each successive hop would be:

    [c:\Program Files\Bentley\ProjectWise\bin]pwping pw_gateway

    pwping: INFO  - Tracing route to host 'pw_gateway'

    pwping: INFO  - Hop: 1  Host: pw_gateway  Address: 10.10.10.191  PW Version: 08.09.03.31 AvgTime: 6ms  AvgTtl: 125

     

    [c:\Program Files\Bentley\ProjectWise\bin]pwping pw_intsrv

    pwping: INFO  - Tracing route to host 'pw_intsrv'

    pwping: INFO  - Hop: 1  Host: pw_gateway  Address: 10.10.10.191  PW Version: 08.09.03.31 AvgTime: 3ms  AvgTtl: 125

    pwping: INFO  - Hop: 2  Host: pw_intsrv  Address: 10.10.10.190  PW Version: 08.09.03.31 AvgTime: 66ms  AvgTtl: 128

     

    [c:\Program Files\Bentley\ProjectWise\bin]pwping pw_filestor

    pwping: INFO  - Tracing route to host 'pw_filestor'

    pwping: INFO  - Hop: 1  Host: pw_gateway  Address: 10.10.10.191  PW Version: 08.09.03.31 AvgTime: 2ms  AvgTtl: 125

    pwping: INFO  - Hop: 2  Host: pw_intsrv  Address: 10.10.10.190  PW Version: 08.09.03.31 AvgTime: 5ms  AvgTtl: 128

    pwping: ERROR - Failed to ping host 'pw_filestor': no route to next hop

     

    In this example, we shall ask the utility to display any caching server configuration information it finds as it transits the various servers in the route:

    [c:\Program Files\Bentley\ProjectWise\bin]pwping -c pw_intsrv

    pwping: INFO  - Tracing route to host 'pw_intsrv'

    pwping: INFO  - Hop: 1  Host: pw_gateway  Address: 10.10.10.191  PW Version: 08.09.03.31 AvgTime: 8ms  AvgTtl: 125

    pwping: INFO  -     Caching enabled on host 'pw_gateway' : Cache Path: 'c:\pw_cache\files'   Cache Limit 200 MB

    pwping: INFO  - Hop: 2  Host: pw_intsrv  Address: 10.10.10.190  PW Version: 08.09.03.31 AvgTime: 6ms  AvgTtl: 128

     

    Next, we shall trace a route to a ProjectWise integration server based on a datasource's display-name value.  In this example, a datasource with the display-name value of "PCJ_TESTROUTE" is configured on server PW_INTSRV.

    [c:\Program Files\Bentley\ProjectWise\bin]pwping -d"PCJ_TESTROUTE"

    pwping: INFO  - Tracing route to host 'pw_intsrv'

    pwping: INFO  - Hop: 1  Host: pw_gateway  Address: 10.10.10.191  PW Version: 08.09.03.31 AvgTime: 7ms  AvgTtl: 125

    pwping: INFO  - Hop: 2  Host: pw_intsrv  Address: 10.10.10.190  PW Version: 08.09.03.31 AvgTime: 5ms  AvgTtl: 128

     

    See Also

    Product TechNotes and FAQs

    ProjectWise TechNotes And FAQs

    External Links

    Bentley Technical Support KnowledgeBase

    Bentley LEARN Server

    Comments or Corrections?

    Bentley's Technical Support Group requests that you please confine any comments you have on this Wiki entry to this "Comments or Corrections?" section. THANK YOU!

        

    • TechNote
    • ProjectWise SELECTsupport
    • TN9990
    • Share
    • History
    • More
    • Cancel
    • Elisa McGraw Created by Elisa McGraw
    • When: Fri, Jul 8 2011 1:05 PM
    • Dana Guthrie Last revision by Bentley Colleague Dana Guthrie
    • When: Fri, Sep 30 2022 11:23 AM
    • Revisions: 3
    • Comments: 0
    Recommended
    Related
    Communities
    • Home
    • Getting Started
    • Community Central
    • Products
    • Support
    • Secure File Upload
    • Feedback
    Support and Services
    • Home
    • Product Support
    • Downloads
    • Subscription Services Portal
    Training and Learning
    • Home
    • About Bentley Institute
    • My Learning History
    • Reference Books
    Social Media
    •    LinkedIn
    •    Facebook
    •    Twitter
    •    YouTube
    •    RSS Feed
    •    Email

    © 2023 Bentley Systems, Incorporated  |  Contact Us  |  Privacy |  Terms of Use  |  Cookies