Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
  • Welcome
  • Products
  • Support
  • About
  • More
  • Cancel
ProjectWise
  • Product Communities
  • More
ProjectWise
ProjectWise Design Integration Wiki ProjectWise Traceroute Utility [TN]
    • Sign in
    • -ProjectWise Design Integration Wiki
      • About ProjectWise
      • +GreenBook - Best Practices
      • +ProjectWise Accreditation Programs
      • +ProjectWise Managed Workspaces
      • -SELECTsupport TechNotes and FAQ's
        • +Application Integration
        • +Bentley Transmittal Services for ProjectWise
        • How to setup MicroStation logging with ProjectWise Explorer Integration TN
        • +Installation/Upgrade
        • +iPad Applications
        • +Licensing
        • +Orchestration Framework/Automation Service/Distribution Service
        • +ProjectWise Administrator
        • +ProjectWise Client
        • +ProjectWise Glossary
        • -ProjectWise Server
          • Clustered Server Environment [TN]
          • Configuring ProjectWise V8 2004 Edition Caching Server [CS]
          • Distributed Servers in ProjectWise [TN]
          • Enhancing Performance With ProjectWise File Caching [CS]
          • How to Configure ProjectWise Caching Server [TN]
          • NAS for Storage With ProjectWise [TN]
          • ProjectWise Gateway/Connection Server [TN]
          • ProjectWise Integration Server and MIME Types [TN]
          • ProjectWise Traceroute Utility [TN]
          • The History and Origins of ProjectWise
          • +Troubleshooting ProjectWise Gateway or Connection Server [TN]
          • Understanding ProjectWise Delta File Transfer [DFT] Settings
          • Using Clustered Indexes [TN]
          • Using Fetch Files to Pre-populate File Cache [TN]
          • Using ProjectWise Authentication Server In Active Directory Domain Model [CS]
        • +ProjectWise StartPoint
        • +ProjectWise Web Server
      • Project Creation Automation Service
    • +Bentley i-model Composition Server
    • +Field Data Management - Welcome
    • +ProjectWise Caching Server
    • +ProjectWise Change Storage Area
    • +ProjectWise Integration CONNECT Edition
    • +ProjectWise Design Integration Server
    • +ProjectWise Design Integration V8i
    • +ProjectWise Document Publisher
    • +ProjectWise Edge - Mobile
    • +ProjectWise Explorer Client
    • +ProjectWise Explorer Client V8i
    • ProjectWise Explorer Connect Edition Upd3 Unattended Install
    • +ProjectWise integration module for Revit
    • +ProjectWise Integration Server
    • +ProjectWise Publishing Server
    • +ProjectWise Solutions
    • +ProjectWise Web View Server
    • ProjectWise Project Insights
    • +ProjectWise Web Cloud Service
    • +ProjectWise Drive
    • +ProjectWise Web View
    • +Microsoft Teams Integration
    • +ProjectWise Workflow Rules Engine
    • +Working from Home with ProjectWise
    • ISO 19650 data model within ProjectWise
    • Learn ProjectWise

     
     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
    • Elisabeth Pry Last revision by Bentley Colleague Elisabeth Pry
    • When: Mon, Jun 10 2013 11:27 AM
    • Revisions: 2
    • 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

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