{"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":"493b69d8-dcea-4209-94da-d857677564ff"}},{"type":"hardBreak"},{"text":"Applies to QESTField","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This article details the installation process for the QESTField 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":"63d7f0cd-2817-42c1-9c4d-ecb68047f231"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"QESTField is an ASP.NET web application which is hosted via Microsoft Internet Information Services (IIS). An instance of QESTNet must already exist as a connection to the QESTNet service is required, through which QESTField will communicate with 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.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Machine","type":"text"}]},{"type":"bulletList","content":[{"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 QEST Web API 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":"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":"The QESTField installer file ","type":"text"},{"text":"QESTField v4.5.B.R.exe","type":"text","marks":[{"type":"strong"}]},{"text":" (where B and R are the build and revision numbers). e.g. ","type":"text"},{"text":"QESTField v4.5.1140.35145.exe","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A sample configuration file - ","type":"text"},{"text":"Web.Config","type":"text","marks":[{"type":"strong"}]},{"text":" to add to the QestField installation, or inform about what needs to be updated for existing installations.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installing QESTField","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If Microsoft .NET Framework 4.6.2 requires installation, internet access is needed during the QEST Web API installation process.","type":"text"}]}]},{"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 Installation Options section below.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy the ","type":"text"},{"text":"Web.config","type":"text","marks":[{"type":"strong"}]},{"text":" file into ","type":"text"},{"text":"QESTField","type":"text","marks":[{"type":"strong"}]},{"text":" (or alternative) folder. The default directory is ","type":"text"},{"text":"[WindowsVolume]inetpub\\QEST Platform\\QESTField","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installation Options","type":"text"}]},{"type":"paragraph"},{"type":"table","attrs":{"layout":"wide","localId":"b02be632-8ae7-4db8-a53f-3be921afb286"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[137.0]},"content":[{"type":"paragraph","content":[{"text":"Setting","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[683.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[137.0]},"content":[{"type":"paragraph","content":[{"text":"Install location","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[683.0]},"content":[{"type":"paragraph","content":[{"text":"Path to which the QESTField files will be installed (under sub-folder ","type":"text"},{"text":"QESTField","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":[140.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":[137.0]},"content":[{"type":"paragraph","content":[{"text":"Configure QEST Platform website and QESTField application","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[683.0]},"content":[{"type":"paragraph","content":[{"text":"If checked, the installer will automatically set up the IIS configuration for the QEST Platform website and QESTField application. Uncheck this option for systems which require manual configuration via the IIS Manager.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"Checked","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[137.0]},"content":[{"type":"paragraph","content":[{"text":"Force start QEST Platform website","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[683.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":[140.0]},"content":[{"type":"paragraph","content":[{"text":"Unchecked","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Configuring QESTField","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the ","type":"text"},{"text":"Web.config","type":"text","marks":[{"type":"strong"}]},{"text":" file 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 that QESTField will be connecting to. 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":"If any custom workflows will be used ensure that all required additions to the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" section are added. These are all specified in an example configuration file distributed with QESTField.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Verifying Installation","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open Internet Information Services (IIS) Manager through Control Panel -> Administrative Tools -> Internet Information Services (IIS) Manager.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"With the QEST Platform site selected click the start button.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the QESTField application and click the ","type":"text"},{"text":"Browse","type":"text","marks":[{"type":"strong"}]},{"text":" action and ensure the QESTField login page is displayed in the browser that opens. . Configure network settings to provide the necessary access for this environment. e.g. provide access to this site on the public Internet.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If this installation is for public use, we recommend securing the connection via SSL/HTTPS security.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"QESTField is now installed and ready for use.","type":"text"}]},{"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":"\"Could not load file or assembly\" error","type":"text"}]},{"type":"paragraph","content":[{"text":"When attempting to access QESTField, an error message similar to the below appears:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Server Error in '/' Application.\n\nCould not load file or assembly 'Newtonsoft.Json, Version=4.5.0.0, Culture=neutral, PublicKeyToken=30ad4fe6b2a6aeed' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)\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 select ","type":"text"},{"text":"Basic Settings...","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check that the \"Physical Path\" of the site exists and contains the QESTField files (including a valid ","type":"text"},{"text":"Web.config","type":"text","marks":[{"type":"code"}]},{"text":" file in the root directory).","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":35.0},"content":[{"type":"media","attrs":{"width":532,"id":"a7ac7631-bc41-4338-8d57-d2695282bb33","collection":"contentId-1149208298","type":"file","height":294}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Configuration error - Unrecognised attribute 'targetFramework'","type":"text"}]},{"type":"paragraph","content":[{"text":"When attempting to access QESTField, an error message similar to the below appears:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Server Error in '/' Application.\n\nConfiguration Error\n\nDescription: 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":"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 ","type":"text"},{"text":"Basic Settings","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check that the \"Application Pool\" selected uses .NET v4.0 or higher (click 'Select...' to see more details of the selected Application Pool).","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":30.0},"content":[{"type":"media","attrs":{"width":532,"id":"ebe67095-31b5-4c5d-8980-4ab0a1581ccb","collection":"contentId-1149208298","type":"file","height":339}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"\"No connection could be made because the target machine actively refused it\" error","type":"text"}]},{"type":"paragraph","content":[{"text":"When attempting to access QESTField, an error message similar to the below appears:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Server Error in '/' Application.\n\nNo 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 directory and check the client endpoint addresses match the address of the QESTNet server to which QESTField 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 QESTField Configuration Guide section system.serviceModel (above).","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 (above).","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":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 QESTField will have a \"Show Details\" link. This will display a lot of extra information that is useful for diagnosing problems. Please paste this information into the bottom of the ","type":"text"},{"text":"Support Request Form","type":"text","marks":[{"type":"link","attrs":{"href":"http://online.spectraqest.com/images/3/35/Support_Request_Form.dotx"}}]},{"text":" when sending the form.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":445,"id":"462915d0-1629-4bee-8448-ed2540dcf75d","collection":"contentId-1149208298","type":"file","height":224}}]},{"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":"0a9d6043-5cc7-4282-98a4-792f7de9094c"}}]},{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported