ProjectWise Plug-in for Bentley Web Services Gateway Readme

To Deploy Bentley Web Services Gateway and the ProjectWise Plug-in

  1. Go to the Start page and type Deploy Web Services Gateway.
  2. When the Deployment Wizard opens, select Deploy Web Services Gateway and click Next.
  3. On the Web Site page, select the IIS website you want to deploy Bentley Web Services Gateway to and click Next.
  4. On the Virtual Directory page, enter the name of the directory you want to create for Bentley Web Services Gateway under the selected IIS website.

    The name is set to 'ws' by default. You can accept the default or change it if needed. When the ws is used, users connecting to this Bentley Web Services Gateway website from a mobile app only need to specify the fully-qualified domain name of the computer on which Bentley Web Services Gateway is installed (for example, servername.domain.com). If you change the default virtual directory name from ws to anything else, then ProjectWise Explorer Mobile app users will have to specify the fully-qualified domain name of the computer plus the virtual directory name, when entering the address (for example, servername.domain.com/virtualdirectoryname).

  5. (Optional) On the Configure URL redirection page, turn on Use URL redirection and click Next.

    You can skip this page if URL redirection is not needed.

    URL Rewrite must be installed to be able to turn on Use URL redirection. You can download URL Rewrite from here: https://www.iis.net/downloads/microsoft/url-rewrite

  6. On the Working Directory and CORS page:
    1. In the first field, accept the default working directory (C:\ProgramData\Bentley\WSG\WorkDir\02.06) or click Browse to select a different folder.

      The working directory is used by Bentley Web Services Gateway to store files that are being transferred between the main ProjectWise server and the app making the request.

      Note:
      • Make sure the folder you specify is not already being used by any other deployment.
      • The working directory must be located on the Bentley Web Services Gateway computer.
      • The working directory cannot be located under the website's home directory (for example, it cannot be here: C:\inetpub\wwwroot)
      • Make sure the local system account has Write permission to the specified folder.
      • UNC paths (\\servername\sharename) are not supported.
    2. In the second field, enter the URL of each Bentley web service (separated by a comma) that needs to communicate with (make cross-origin (CORS) requests to) this particular Bentley Web Services Gateway deployment.
      For this service Enter this URL Purpose
      ProjectWise Web https://connect-projectwisewac.bentley.com Required to create and open work area connections in ProjectWise Web.
      ProjectWise 365 https://projectwise365.bentley.com Required to create and open work area connections in ProjectWise 365.
      PDF Markup Service https://connect-pdfmarkup.bentley.com Lets ProjectWise Web and ProjectWise 365 users markup PDF documents using the PDF Markup Service (users can still open PDFs as read-only in the PDF Markup Service, even if this URL is not configured).
      Integration with Microsoft Teams https://connect-projectwiseteamshost.bentley.com Lets ProjectWise Web and ProjectWise 365 users access their work area connection from a Microsoft Teams tab.
      Microsoft 365 co-authoring https://office365collaboration.bentley.com Lets ProjectWise Web and ProjectWise 365 users co-author Office documents.
      Integration with the ProjectWise Deliverables Management portal (all of these URLs are required)
      • *.pwdm.bentley.com
      • https://pwdm.bentley.com
      • https://connect-bts.bentley.com
      • https://connect-bts-eus.bentley.com
      • https://connect-bts-uks.bentley.com
      • https://connect-bts-neu.bentley.com
      • https://connect-bts-sea.bentley.com
      • https://connect-bts-aue.bentley.com
      • https://connect-bts-cac.bentley.com
      		Lets users add ProjectWise documents (via work area connections) to transmittals from the ProjectWise Deliverables Management portal.
      older work area connections https://projectshareportal.bentley.com Required for ProjectWise Web users to open older work area connections (those connections created in old ProjectWise Web / ProjectWise Share).
      ProjectWise Web View https://connect-projectwisewebview.bentley.com Required to create and open datasource connections in ProjectWise Web View.
      ProjectWise Web View integration with Microsoft Office for the web https://connect-mswopiclient.bentley.com Required to open Office documents in Office for the web from ProjectWise Web View (users will get an error when they try to open an Office document from ProjectWise Web View, if this is not configured).

      If you plan to use all of the services mentioned above with this deployment, then in the deployment wizard, you would enter them all together on one line, like this: 

      https://connect-projectwisewac.bentley.com,https://projectwise365.bentley.com,https://connect-pdfmarkup.bentley.com,https://connect-projectwiseteamshost.bentley.com,*.pwdm.bentley.com,https://pwdm.bentley.com,https://connect-bts.bentley.com,https://connect-bts-eus.bentley.com,https://connect-bts-uks.bentley.com,https://connect-bts-neu.bentley.com,https://connect-bts-sea.bentley.com,https://connect-bts-aue.bentley.com,https://connect-bts-cac.bentley.com,https://projectshareportal.bentley.com,https://connect-projectwisewebview.bentley.com,https://connect-mswopiclient.bentley.com
    3. Click Next.
  7. On the Select plugins page, select the Bentley WSG ProjectWise Plug-in and click Next.
  8. Configure the setting on the ProjectWise plugin settings page and click Deploy.
  9. When deployment is complete, click Finish.
Parent topic: Deploying the ProjectWise Plug-in for Bentley Web Services Gateway