Current Revision posted to Content Management - Wiki by Ranveer.Basra on 10/24/2013 1:47:13 PM
ProjectWise Web Services & ProjectWise Explorer (iPad) FAQ
TechNote,ProjectWiseSELECTsupport,iPadwebservices
![]()
| | | |
| Applies To | | |
| | | |
| Product(s): | ProjectWise Explorer and ProjectWise Web Services for the iPad | |
| Version(s): | All | |
| Environment: | N/A | |
| Area: | N/A | |
| Subarea: | N/A | |
| Original Author: | Bentley Technical Support Group | |
| | | |
ProjectWise web services FAQ
*Please refer to the iPad help for full details on these and many other topics.
What is ProjectWise web services?
ProjectWise web services is a web service that provides ProjectWise Explorer for the iPad users with a list of ProjectWise datasources they can connect to and access documents from. ProjectWiseWebServiceswillonlyworkwiththeiOSProejctWiseExplorerclient.ProjectWisewebservicesortheProjectWiseiOSExplorerapplicationItwillnotworkwiththeiOSBentleyFieldSupervisorapplicationorBentleyWebServicesGateway.
Where can I download ProjectWise web services?
A standalone ProjectWise web services installation package can be downloaded from Bentley’s SELECT downloads website or the Bentley iWare site: http://www.bentley.com/en-US/Free+Software/.
Is ProjectWise web services easy to set up?
Yes! Setting up ProjectWise web services is easy. Please read the delivered documentation for step-by-step instructions.
Where can I find the ProjectWise web services documentation?
There is a PDF included with the ProjectWise web services download. The PDF includes information about setting up prerequisite software, installing and deploying ProjectWise web services, and configuring the datasource list for ProjectWise Explorer for the iPad users. You can also follow the linked how to: http://communities.bentley.com/products/projectwise/content_management/w/wiki/projectwise-web-services-install-tn.aspx
Do I need a license for ProjectWise web services?
A license is not needed for ProjectWise web services; however a Passport is required for the ProjectWise Explorer Mobile application for the iPad user connecting to the ProjectWise web services.
What operating system do I need?
64-bit Windows Server 2008 SP2 or R2 SP1 (Windows Server 2003 is not supported)
Which version of ProjectWise does it work with?
ProjectWise web services has been tested using ProjectWise V8i (SELECTseries 3) and ProjectWise V8i (SELECTseries 4), therefore it is recommended that you use one of these versions. Earlier versions may work, but they have not been tested and are not supported.
Can I install ProjectWise web services on the same computer as ProjectWise Web Server?
Yes, you can install these two servers on the same computer. If you do, please consider the following items:
· Always deploy ProjectWise web services to its own IIS website, and never to a website being used by ProjectWise Web Server, or any other ProjectWise application.
· Always use a dedicated port for the ProjectWise web services website, and never the same port as the ProjectWise Web Server website (or any other website on the computer for that matter).
· The Web Server (IIS) role services required for ProjectWise Web Server do not interfere with ProjectWise web services, and should be left as is, if you already set them up for ProjectWise Web Server. Just make sure you install / turn on the additional role services required by ProjectWise web services, as mentioned in the ProjectWise web services documentation.
IIS is already configured for ProjectWise Web Server. Can I use the same IIS settings for ProjectWise web services?
The IIS role services required for ProjectWise Web Server are different than those required for ProjectWise web services. If you have already installed the Web Server (IIS) role and role services required for ProjectWise Web Server, you can leave those role services turned on; they do not interfere with ProjectWise web services. Just make sure you install / turn on the additional role services mentioned in the ProjectWise web services documentation.
Why is SSL required?
SSL ensures that ProjectWise Explorer for the iPad users are connecting to ProjectWise web services over a secure connection. ProjectWise web services will not work if the underlying IIS website does not have SSL enabled. Complete instructions for enabling SSL are included in the ProjectWise web services documentation.
Contact your IT department if you need help obtaining an official SSL certificate To create a self-signed certificate, see the following Microsoft topic:
http://technet.microsoft.com/en-us/library/cc753127(v=ws.10).aspx
Which ports does ProjectWise web services use for client and server communications?
ProjectWise web services uses two different ports – one for communication with the ProjectWise Integration Server, and one for communication with ProjectWise Explorer for the iPad users. To open each port, you need to add them both to the Windows Firewall exception list on the ProjectWise web services computer.
The port used for communication with ProjectWise Integration Server depends on which port is set as the listener port on the ProjectWise Integration Server computer. 5800 is ProjectWise Integration Server’s default listener port; contact your ProjectWise administrator to verify the correct port number to use.
The ProjectWise web services website’s SSL port is the port used for communication with ProjectWise Explorer for the iPad users. Port 443 is the default SSL port. If ProjectWise Web Server is already installed and using the SSL port 443, it is recommended that you use another port for ProjectWise web services.
Will ProjectWise web services work with ProjectWise caching?
Yes. Just make sure that the computer on which you install ProjectWise web services is able to ping the ProjectWise Integration or Caching Servers that are hosting ProjectWise storage areas.
How can I troubleshoot a connection problem?
Check the following:
· Make sure the SSL and listener ports are both open
· Check if https://server/pwmobileacccess works from a browser
· Check if https://server/pwmobileacccess/datasources works
· Check the Event Viewer log
· Check your IIS logs (c:\inetpub\logs)
· Check your ProjectWise web services log (C:\Users\Public\Bentley\Logs\pwmobileaccess.log)
You can also run the pwping.exe utility from a command prompt to show you all the hops the ProjectWise web services is making to communicate to the ProjectWise Integration Server. Check the Event Viewer to see if any warnings or errors are shown. IIS logging can also be helpful along with ProjectWise web services logging.
ProjectWise Explorer for the iPad FAQ
What is ProjectWise Explorer for the iPad?
ProjectWise Explorer for the iPad is Bentley’s iPad app that lets you connect to ProjectWise and access your documents from the iPad. You can use it to check out and check in documents, preview documents, email documents, and create new documents and folders.
Which version of iOS do I need for ProjectWise Explorer for the iPad?
iOS 5.0 or later
What version of ProjectWise can I use with ProjectWise Explorer for the iPad?
ProjectWise Explorer for the iPad has been tested using ProjectWise V8i (SELECTseries 3) and ProjectWise V8i (SELECTseries 4), therefore it is recommended that you use one of these versions. Earlier versions may work, but they have not been tested and are not supported.
Which types of documents can I view directly in the app?
· Office documents: XLS/XLSX, DOC/DOCX, PPT/PPTX
· Imagefiles: JPEG, TIFF, GIF, PNG
· Other files: TXT and PDFs
How do I view DGN and DWG files?
On the desktop, publish an optimized i-model from an original DGN or DWG stored in ProjectWise. Then in ProjectWise Explorer for the iPad, connect to your datasource and open the optimized i-model into Bentley Navigator for the iPad. Complete workflow is documented in the help.
How do I refresh the current folder in ProjectWise Explorer for the iPad?
Swipe your finger vertically down the document list and release your finger to refresh. You will see the text ‘Release to refresh’ at the top of the document list as you are swiping.
Does a refresh of the current folder also refresh documents I have already downloaded, if they are out of date?
Yes. If you have already downloaded a document from the current folder and there is a newer copy of the document on the server, then a new copy of the document will be downloaded when you refresh the current folder, thus replacing your existing local copy.
How do I delete a datasource connection, a file, or a folder?
Swipe your finger over the datasource, file, or folder you want to delete. A Delete button appears next to the item. Tap the Delete button, then tap Delete again when prompted to confirm that you want to delete the item.
How does ProjectWise Explorer for the iPad download files from ProjectWise?
When you tap a document in the document list in ProjectWise Explorer for the iPad, ProjectWise web services gets the latest copy of the file from the ProjectWise storage area and then sends a copy of it to ProjectWise Explorer for the iPad. If ProjectWise web services already have the latest copy cached from a previous transaction, then it simply sends the copy it has to ProjectWise Explorer for the iPad.