Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
ProjectWise
  • Product Communities
ProjectWise
ProjectWise Design Integration Wiki Using Fetch Files to Pre-populate File Cache [TN]
    • Sign In
    • ProjectWise Design Integration Wiki
    • ProjectWise Software Download
    • +ProjectWise Learning
    • +Projectwise Licensing
    • ProjectWise Programming and PowerShell
    • +Projectwise Documentation
    • +ProjectWise Explorer Client
    • +ProjectWise Administrator
    • +ProjectWise Integration Server
    • -ProjectWise Caching Server
      • 4 hour evaluation license Caching server is running in Evaluation mode
      • Using Fetch Files to Pre-populate File Cache [TN]
      • NAS for Storage With ProjectWise [TN]
      • How to Configure ProjectWise Caching Server [TN]
      • Enhancing Performance With ProjectWise File Caching [CS]
      • Configuring ProjectWise V8 2004 Edition Caching Server [CS]
      • Configure a Caching Server to a hosted environment
      • +Explorer - ProjectWise Caching Server
      • +File Transfer Svr - Caching Svr - ProjectWise Caching Server
      • +MISC - ProjectWise Caching Server
      • +Projects - ProjectWise Caching Server
      • ProjectWise SS4 Thumbnails Not Appearing
      • Reference files are not attached when checking out a file from ProjectWise
      • Restricting Access to your ProjectWise Storage area's
      • +Security - ProjectWise Caching Server
      • Application Usage Reporting Wrong License Usage
      • Caching Server configuration not working with servers located in different domains
      • Caching Server Service stoppage
      • ProjectWise connection to datasource freezing/hanging with no error message to Oracle database.
      • projectwise configurations to change the ip address of the File Transfer server
      • Fetchfiles does not recognize folders with spaces in the name
    • +ProjectWise Gateway Server
    • +ProjectWise User Synchronization Service
    • +ProjectWise Orchestration Framework
    • +ProjectWise Connected Services
    • +Working from Home with ProjectWise
    • +ProjectWise Glossary
    • ProjectWise Hosting - Manage Services
    • +ProjectWise Logging and Tools

     
     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
    • Dana Guthrie Last revision by Bentley Colleague Dana Guthrie
    • When: Fri, Sep 30 2022 1:27 PM
    • Revisions: 8
    • 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