Troubleshoot (System Administration)

The Troubleshoot area allows administrators to run three basic tests against the application and can assist in identifying issues within the ProjectDox site.

SMTP Email

Tests the sending of emails from ProjectDox using the configurations established in the SMTP tab of the configuration area. SMTP Email is the ideal location to confirm that the email configuration is operational. If it is successful, the message will be “Email has been sent.” If it fails, the ideal location to review details of the failure is from the web server ProjectDox Event Log. The Event Viewer contains a ProjectDox-specific item that will give details of the failure such as “relay has been rejected.”

URL Spawning

Tests remote URL calls from the server. If a failure is received this could mean connectivity issues are present, but can vary on the level of security of the IIS server.

With URL Spawning, the server is sending an http request, as opposed to a user's browser sending the http request. The server is configured in such a way as to not allow outbound http connections to be spawned programmatically from the server.

ProjectDox uses server-spawned http for the following activities:

Folder Permissions

The Folder Permissions test will verify access to four key folders of the ProjectDox installation.

You will see green text stating “Success” meaning that the shares (UserFilesSource, UserFilesPublish, PDoxTemp, and the Queue) have been granted correct permissions. “Failed” in red will display when that is not true for any one of the four required shares. The list below describes what a failure may indicate and what it will affect within the ProjectDox system.

PDoxTemp Folder

The Web Server is unable to copy the uploaded files to create tickets in the Queue folder resulting in failures for publishing documents to ProjectDox. An inaccessible PdoxTemp folder will also prohibit the downloading of files from ProjectDox.

Queue Folder

Tickets are created in the Queue folder, but are not picked up by the Job Processor resulting in a publishing failure.

Source Folder

Uploaded file(s) cannot be copied and deposited via UNC to the UserFilesSource folder, resulting in the site being unable to create new projects, copy projects, download files, or publish files.

Publish Folder

The Job Processor cannot deposit the published files via UNC to the UserFilesPublish folder, resulting in publishing failures.