Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
  • Welcome
  • Products
  • Support
  • About
  • More
  • Cancel
ProjectWise
  • Product Communities
  • More
ProjectWise
ProjectWise Design Integration Wiki Using Fetch Files to Pre-populate File Cache [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. 

    Using Fetch Files to Pre-populate File Cache [TN]

       
      Applies To 
       
      Product(s): ProjectWise
      Version(s): 2004, XM, and V8i
      Environment:  N/A
      Area:  N/A
      Subarea:  N/A
      Original Author: Bill Kenney, Bentley Technical Support Group
       

     

     

     

     

     

     

     

     

    Overview

    ProjectWise provides the ability to temporarily cache files on ProjectWise Servers. This temporary caching allows for optimized performance when opening files. This technote will describe how to distribute a group of files or folders, to a large number of Caching Servers using the FetchFiles command.  The Fetch Files executable is a command line program that provides a way to pre-populate the cache from the specified storage area into a directory on the Caching Server.  This is useful if there are certain documents stored in a central location that are used by a particular set of remote users.  Either folders can be fetched, or use of the FetchFiles command with individual documents can be done.  The FetchFiles command would have to be run from each Caching Server targeted to store the temporarily cached folders and files.

    Pre-Requisites

    This tech note assumes the reader is familiar with the running command line programs and ProjectWise File Caching. For more information on File Caching, see the ProjectWise Administrator Help.

    FetchFiles Set up:

    1. File caching must be configured on the ProjectWise Caching or Gateway server. Below is a simple example of how to configure File Caching. In this example, files from the Integration server will be cached on the Caching server. Clients will be configured to retrieve files from the Caching server.

    • Using notepad, Open the c:\ Program Files\Bentley\ProjectWise\bin\dmskrnl.cfg file on the Caching
      Server (See Caching Server B in network example in Figure 1). In the General Server Configuration Information section, make sure that “FileTransferSrv=1” is uncommented. (remove the semicolon in front of the line)

      Example

      FileTransferSrv=1

     

    • In the Gateway section: Add this entry <Integration Server name>=<Caching Server name with no
      semicolon in front of the line.

      Example

      Integration Server A=Caching Server B

     

    • In Routing Section: Add this entry <Integration Server>=5800 with no semicolon in front of the
      line

      Example

      Integration Server A=5800

     

    • The following configuration turns on file caching, provides a path to where the files are temporarily stored, and sets a limit of disk space to be used in megabytes. In the area labeled “[Cache]” Remove the semicolons in front of the following lines:

      [Cache]

      enabled=true

      storage path=C:\cache

      limit=200



    2. On the machine where fetchfiles will be run, update the ProjectWise Network Configuration settings to point to the Caching server configured in step 1. This can be done in the ProjectWise Network Utility found in the Start Menu > Control Panel.

    • On the Datasource Listing tab, populate the Caching Server name and the Host/IP name > add
      Port 5800.
    • Do the same on the DNS tab.



    3. In Windows Explorer, on the Caching server, create a temporary Working directory (PWork for example) different from the ProjectWise Storage area (or any temporary Caching directory). This directory will act as a temporary holding place for the Fetchfiles before they are placed in the Caching directory.



    4. Use the FetchFiles command to collect the desired files from the Datasource. See examples below.



    There is additional helpful reading on FetchFiles in the ProjectWise Administrator “Help” section on File Caching.

    FetchFiles options:

             -d  ;the name of the Datasource you are fetching files or folders from
             -u  ;the username given (typically with administrative permissions) that fetchfiles will use to log into the Datasource.
             -p  ;password of the username
             -w  ;This switch is required.  Provides the path to the fetchifles working directory
              -v   ;Verbose logging.  Describes what is happening as the command executes.
              -f   ;Set this switch before the path to the file you want to cache.  The -f tells FetchFiles to treat it as a document instead of a folder
              -n ;This option turns re-cursing off for the path that follows.  If no option is specified , -n is assumed by default

              -r  ;If you want the Fetchfiles utility to re-curse the specified folder (that is, to look for files in the subfolders of the specified folder), then enter the -r option

                   before entering the path

    Examples

        The following is an example of a command line for fetching a folder called “Archive” from the Datasource called “TSG-Play” on a server called “neo”.  Once the files are fetched they will be placed in the temporary caching directory as configured by the dmskrnl.cfg file
    C:\Program Files\Bentley\ProjectWise\bin>fetchfiles -d  neo:TSG-PLAY -u admin  -p admin -w C:\PWork  -n  Civil\BPlans\Archive  -v

         The following is an example of a command line for fetching a document called “2004master” from  a  Datasource called “TSG-Play”, from a server called “neo”, and from a folder called Nextlevel.
     C:\Program Files\Bentley\ProjectWise\bin>fetchfiles -d neo:TSG:Play -u admin -p admin -w  C:\PWork -n\XFolder\Nextlevel -f \Bill\Nextgen\2004master.dgn

    See Also

    Product 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
    • Caching
    • FetchFiles
    • Share
    • History
    • More
    • Cancel
    • Elisa McGraw Created by Elisa McGraw
    • When: Fri, Jul 8 2011 1:07 PM
    • Bill Kenney Last revision by Bill Kenney
    • When: Thu, Nov 9 2017 8:07 AM
    • Revisions: 7
    • 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