{"type":"doc","content":[{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"About"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"0c50bb6c-5ae7-48b0-a51b-ee439b1f3145"},"schemaVersion":{"value":"1"},"title":"Excerpt Include"}},"localId":"d1d0e8cc-9832-43b4-afee-c77920f5096d"}},{"type":"hardBreak"},{"text":"Applies to QESTField Scheduler","type":"text","marks":[{"type":"strong"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This article details the installation process for the QESTField Scheduler product. This includes installation, configuration and solutions to common problems.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Contents","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"exclude":{"value":"Contents"}},"macroMetadata":{"macroId":{"value":"79042eda-38cc-4475-8dd8-eea5f9dd0ee0"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"dbcc18f1-3f98-4f46-9ac3-1db058e09756"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"QESTField Scheduler is a React.js front-end + ASP.NET back-end web application, which is hosted via Internet Information Services (IIS). A connection to an instance of the QESTNet service is required, through which it can operate on the QEST Platform database.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"paragraph","content":[{"text":"The following must be present in the target environment to support QESTField Scheduler.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Machine","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Google Chrome (or other Webkit-based web browser)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Windows Server 2008 R2, Windows 7 or later (64-bit).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Microsoft .NET Framework 4.6.2 or later. If required, this will be installed via the QESTNet installer if the environment has internet access.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Internet Information Services 7.0 or later with default features plus ASP.NET v4.5.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"QESTField v4.6.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Services","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"QESTNet v4.6 with the QESTLab API for QESTNet installed (default), accessible via TCP or HTTP.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installation Files","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Installer ","type":"text"},{"text":"QESTFieldScheduler.Installer.Ma.Mi.B.R.exe","type":"text","marks":[{"type":"strong"}]},{"text":" where Ma, Mi, B and R are the major version, minor version, build and revision numbers. E.g. ","type":"text"},{"text":"QESTFieldScheduler.Installer.4.6.2895.26827.exe","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installing QESTField Scheduler","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the provided installer.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If required, click on Options to change the installation options listed in the section below.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Agree to the terms and conditions and click Install. The installer will install and turn on any required Windows features before installing QESTField Scheduler.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installation Options","type":"text"}]},{"type":"table","attrs":{"layout":"wide","localId":"3a629429-aa61-4c20-8841-71640c96a1b0"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[201.0]},"content":[{"type":"paragraph","content":[{"text":"Setting","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[488.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[271.0]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[201.0]},"content":[{"type":"paragraph","content":[{"text":"Install location","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[488.0]},"content":[{"type":"paragraph","content":[{"text":"Path to which the QESTField Scheduler files will be installed (under sub-folder ","type":"text"},{"text":"QESTField Scheduler","type":"text","marks":[{"type":"code"}]},{"text":"). If an existing installation of the QEST Platform website exists, this should match the path of that website.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[271.0]},"content":[{"type":"paragraph","content":[{"text":"[WindowsVolume]\\inetpub\\QEST Platform","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[201.0]},"content":[{"type":"paragraph","content":[{"text":"Configure QEST Platform website and QESTField Scheduler application","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[488.0]},"content":[{"type":"paragraph","content":[{"text":"If checked, the installer will automatically set up the IIS configuration for the QEST Platform website and QESTField Scheduler application. Uncheck this option for systems which require manual configuration via the IIS Manager.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[271.0]},"content":[{"type":"paragraph","content":[{"text":"Checked","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[201.0]},"content":[{"type":"paragraph","content":[{"text":"Force start QEST Platform website","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[488.0]},"content":[{"type":"paragraph","content":[{"text":"If checked, the installer will attempt to stop all websites running on the default port (80) so that the QEST Platform site can be started.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[271.0]},"content":[{"type":"paragraph","content":[{"text":"Unchecked","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Configuring QESTField Scheduler","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If required, open the ","type":"text"},{"text":"Web.config","type":"text","marks":[{"type":"strong"}]},{"text":" file which was installed into the ","type":"text"},{"text":"QESTField Scheduler","type":"text","marks":[{"type":"strong"}]},{"text":" folder with a text editor. At the bottom of the file change all client endpoint address host names from localhost to the name or IP of the QESTNet server to which QESTField Scheduler will be connecting. Close and save the file. ","type":"text"},{"text":"If any other configuration changes were made to the QESTNet such as port or protocol then the same changes must be made here.","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":" \n \n ...\n \n \n \n \n \n \n ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Depending on the installation options used, the QEST Platform website and QESTField Scheduler application may need to be manually configured and/or started via the IIS Manager. Note if you are manually configuring the QESTField Scheduler application, it must be configured with alias \"Scheduler\".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"QESTField Scheduler is now installed and ready for use. If you navigate to the URL where QESTField Scheduler is hosted, you should see the login screen.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":66.0},"content":[{"type":"media","attrs":{"width":490,"id":"1fb0a047-770e-4514-90fb-8c41adfc8cc7","collection":"contentId-3079211855","type":"file","height":317}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Troubleshooting guide","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installation","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Unspecified Error","type":"text"}]},{"type":"paragraph","content":[{"text":"If you get the following installation error ‘0x80072ee7 – Unspecified Error’, this is most likely due to the installer being unable to download and install .NET Framework 4.6.2.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can confirm that this is the issue by viewing the log file and looking for the following: Failed attempt to download URL: '","type":"text"},{"text":"http://go.microsoft.com/fwlink/?LinkId=671728","type":"text","marks":[{"type":"link","attrs":{"href":"http://go.microsoft.com/fwlink/?LinkId=671728"}}]},{"text":"' to: 'C:\\Windows\\Temp{B321459C-617D-4C9F-8C70-15AEEE5945CF}\\NetFx462Web'","type":"text"}]},{"type":"paragraph","content":[{"text":"Fix: To install QESTField Scheduler you will need to download .NET Framework 4.6.2 and install it prior to installing QESTField Scheduler. The .NET Framework 4.6.2 Installer can be found here: ","type":"text"},{"text":"https://www.microsoft.com/en-au/download/details.aspx?id=53344","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.microsoft.com/en-au/download/details.aspx?id=53344"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"HTTP Error 500.19 - Internal Server Error","type":"text"}]},{"type":"paragraph","content":[{"text":"An error page with the following message appears when attempting to access the QESTField Scheduler:","type":"text"}]},{"type":"codeBlock","content":[{"text":"HTTP Error 500.19 - Internal Server Error\nThe requested page cannot be accessed because the related configuration data for the page is invalid.\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Resolution","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open Internet Information Services (IIS) Manager through ","type":"text"},{"text":"Control Panel -> Administrative Tools -> Internet Information Services (IIS) Manager","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the QESTField site, then the action ","type":"text"},{"text":"View Applications","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check that the \"Physical Path\" of the application exists and contains the QESTField Scheduler files (including the file ","type":"text"},{"text":"Web.config","type":"text","marks":[{"type":"code"}]},{"text":" in the root directory).","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":798,"id":"f72a7823-6733-466f-b82d-a95690730fbb","collection":"contentId-3079211855","type":"file","height":250}}]},{"type":"paragraph","content":[{"text":"To change the path of the application, select ","type":"text"},{"text":"Edit Application -> Basic Settings...","type":"text","marks":[{"type":"em"}]},{"text":" in the IIS Manager.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Configuration error - Unrecognised attribute 'targetFramework'","type":"text"}]},{"type":"paragraph","content":[{"text":"An error page with the following message appears when attempting to access the QESTField Scheduler:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Description: An error occurred during the processing of a configuration file required to service this request. Please review the specific error details below and modify your configuration file appropriately.\n\nParser Error Message: Unrecognized attribute 'targetFramework'. Note that attribute names are case-sensitive.\n","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":802,"id":"40802d35-a415-4314-a11c-9a1b85573b27","collection":"contentId-3079211855","type":"file","height":46}}]},{"type":"paragraph","content":[{"text":"Resolution","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open Internet Information Services (IIS) Manager through ","type":"text"},{"text":"Control Panel -> Administrative Tools -> Internet Information Services (IIS) Manager","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the QESTField site, then the action ","type":"text"},{"text":"View Applications","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check that the \"Application Pool\" of the QESTField Scheduler application uses .NET v4.0 or highter.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Images fail to load","type":"text"}]},{"type":"paragraph","content":[{"text":"Image files (such as the QESTField logo on the login page) do not load.","type":"text"}]},{"type":"paragraph","content":[{"text":"Resolution","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open Internet Information Services (IIS) Manager through ","type":"text"},{"text":"Control Panel -> Administrative Tools -> Internet Information Services (IIS) Manager","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the QESTField site, then the action ","type":"text"},{"text":"View Applications","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check that QESTField Scheduler is installed as an application under the QESTField site with virtual path \"/Scheduler\". ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":825,"id":"6142f688-fecb-43a5-885f-b961f7542319","collection":"contentId-3079211855","type":"file","height":250}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If QESTField Scheduler is not installed as in Step 3, follow the steps provided in the ","type":"text"},{"text":"QESTField Scheduler Installation Guide","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=1023836214"}}]},{"text":" to install it correctly.","type":"text"}]},{"type":"paragraph","content":[{"text":"If QESTField Scheduler is already installed as in Step 3, there may be an issue with the configuration of the QESTField Scheduler build that was supplied. Please contact Spectra QEST for further information (see below).","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"\"The underlying provider failed on Open\" error on login","type":"text"}]},{"type":"paragraph","content":[{"text":"When attempting to login, the error message \"The underlying provider failed on Open\" appears.","type":"text"}]},{"type":"paragraph","content":[{"text":"Resolution","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check that the database connection for QESTNet is properly configured in the QESTNet configuration file (refer to the QESTNet Configuration Guide section \"connectionStrings\").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check that the server running the QESTNet service has sufficient permissions for this database.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"\"Could not Connect\" error on login","type":"text"}]},{"type":"paragraph","content":[{"text":"When attempting to login, an error message similar to the below appears:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Could not connect to net.tcp://localhost:52525/Lab.\nThe connection attempt lasted for a time span of 00:00:02.0026098.\nTCP error code 10061: No connection could be made because the target machine actively refused it 127.0.0.1:52525.\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Resolution","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Confirm that the QESTNet service is running.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the ","type":"text"},{"text":"Web.config","type":"text","marks":[{"type":"code"}]},{"text":" file in the root QESTField Scheduler directory and check the client endpoint addresses match the address of the QESTNet server to which the QESTField Scheduler is connecting. These addresses are specified in a section similar to the one below:","type":"text"}]},{"type":"codeBlock","content":[{"text":" \n \n ...\n \n \n \n \n \n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"For more information, refer to the ","type":"text"},{"text":"QESTField Scheduler Configuration Guide","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/QPD54/pages/3079211960"}}]},{"text":" section \"system.serviceModel\".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"General Usage","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"\"Gateway Timeout\" error","type":"text"}]},{"type":"paragraph","content":[{"text":"After performing an action in QESTField Scheduler, a \"Gateway Timeout\" error message appears. Multiple instances of this error may occur at once. This error occurs when the QESTField Scheduler's web server becomes inaccessible.","type":"text"}]},{"type":"paragraph","content":[{"text":"Resolution","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Check that the web server hosting the QESTField Scheduler application is running normally.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Redirected to Login page unexpectedly","type":"text"}]},{"type":"paragraph","content":[{"text":"When performing an action in QESTField Scheduler, the page redirects to the Login page unexpectedly. This occurs when the QESTNET service is no longer available, or the current user's session has expired from inactivity.","type":"text"}]},{"type":"paragraph","content":[{"text":"Resolution","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check that the QESTNet service is running normally.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If user sessions are being invalidated too quickly, the session lifetime specified in the QESTNet configuration file can be changed (refer to the QESTNet Configuration Guide section \"engine sessions\").","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Spinner loops constantly, page never loads","type":"text"}]},{"type":"paragraph","content":[{"text":"When accessing the QESTField Scheduler site, a red spinner loops constantly but the page never loads.","type":"text"}]},{"type":"paragraph","content":[{"text":"Resolution","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Check that the site is being accessed via a recent version of a supported browser:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Google Chrome","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mozilla Firefox","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"\"Could not find work order\" error","type":"text"}]},{"type":"paragraph","content":[{"text":"After performing an action on a work order, an error message similar to \"Could not find work order with QestUUID \" appears. This error occurs when the work order has been deleted by another user since it was loaded into the QESTField Scheduler.","type":"text"}]},{"type":"paragraph","content":[{"text":"Resolution","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Click the \"refresh work orders\" button at the top of the scheduler page to remove deleted work orders from the QESTField Scheduler.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reporting Errors","type":"text"}]},{"type":"paragraph","content":[{"text":"If the information above has not resolved your issue, the Spectra QEST Service Desk procedure (","type":"text"},{"text":"Product Support Procedure Overview","type":"text","marks":[{"type":"link","attrs":{"href":"http://online.spectraqest.com/index.php?title=Support:Product_Support_Procedure_Overview"}}]},{"text":") should be followed to report the problem.","type":"text"}]},{"type":"paragraph","content":[{"text":"Specific errors that occur in the QESTField Scheduler have a \"Copy details to clipboard\" link. This will include a lot of extra information that is useful for diagnosing problems. Please paste these into tickets raised in Spectra QEST's service desk.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":82.0},"content":[{"type":"media","attrs":{"width":668,"id":"4bfb4969-620b-4cd8-b078-d8ebea4f2b0d","collection":"contentId-3079211855","type":"file","height":53}}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"Trademarks, Terms of Use and Privacy Statement"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"57f2e167-04c3-4c86-afba-ec557b669ba8"},"schemaVersion":{"value":"1"},"title":"Excerpt Include"}},"localId":"5cb4fd7f-1c83-470c-b61b-ac36255adb3b"}}]},{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported