Difference between revisions of "Installing PARS Connect"

From PARS
Jump to navigationJump to search
Line 1: Line 1:
 
[[Image:topology.png|thumb|The PARS Connect network topology]]
 
[[Image:topology.png|thumb|The PARS Connect network topology]]
  
PARS Connect is a web based version of PARS .net. Installation is done on one or more webservers on which webpages are hosted and can be accessed from client machines via a web browser.
+
PARS Connect is a web based version of PARS .net. Installation is performed on one or more webservers on which the webpages are hosted and can be accessed from client machines via a web browser. <br> <br>
 
   
 
   
To install the PARS Connect webserver, follow these steps:  
+
To install PARS Connect on the webserver, you will need the following installed: <br> <br>
==The SIMS.net Workstation components==
 
  
These components should be installed on the webserver(s) using the SIMSInst.exe file found in the SIMS\Setups directory. <br> <br>
+
*SIMS .net
 +
*IIS (version 7 or higher)
 +
*Microsoft .Net Framework (version 4.0 or higher)
 +
*ASP.NET (version 4.5 or higher)
  
<p style="font-size:15pt; font-weight:bold; border:2pt solid red; padding:5px">PARS Connect uses the local SIMS.net [[Connect.ini]] and this should NOT contain a redirect to a [[Connect.ini]] in a mapped folder</p>.
+
=Installation=
  
==Microsoft's Internet Information Services 7 (IIS7) (or IIS8) ==
+
==Prerequisites==
[[Image:IIS.gif|thumb|Using Internet Information Services to manage the website]]
 
If this is not already installed it is found under:
 
  
Windows Control Panel -> Add or Remove programs -> Add/Remove Windows Components.
+
This tab will check that you have the required prerequisites in order to install or update PARS. Also note that this '''must''' be performed on the IIS server. PARS will need: <br> <br>
  
If you are using IIS7 or later, please ensure the following features are present:
+
*Version 7 or higher of IIS to be installed
 +
*SIMS .net to be installed on this machine <br> <br>
  
Web Server
+
If both of the prerequisites have ticks next to them, then you can move on to the next step of the installer. To do this, click the "Next" button at the bottom right of the window. Otherwise, install the missing components then rerun the PARS installer. <br> <br>
: Common HTTP Features
 
:: Static Content
 
:: Default Document
 
:: HTTP Errors
 
:: HTTP Redirection
 
: Application Development
 
:: ASP .NET
 
:: .Net Extensibility
 
:: ASP
 
:: ISAPI Extensions
 
:: ISAPI Filters
 
: Security
 
:: Windows Authentication
 
: Management Tools
 
:: IIS Management Console
 
:: IIS Management Scripts and Tools
 
:: IIS 6 Management Compatibility
 
::: IIS 6 Metabase Compatibility
 
  
NOTE: It is important that on the IIS server the order of installation is Windows -> Webserver software -> .net Framework
+
[[Image:prequisites.jpg|800px]] <br> <br>
  
The [http://search.microsoft.com/results.aspx?mkt=en-US&setlang=en-US&q=internet+information+services Microsoft Website] goes into detail about installation and using IIS.
+
==Database==
  
The IIS server needs to be able to access the internet in order to check the license details on the TASC Software database. If licensing problems are encountered when running PARS Connect (e.g. a valid license could not be found), this could be due to the PARS [[Configure proxy server|proxy settings]] being incorrect. <br> <br>
+
At this stage the installer will check the connection to the SIMS database. If the installer cannot find your SIMS database, you will need to find out why then resolve the issue before running the PARS installer. <br> <br>
  
==Microsoft .Net Framework 4.0==
+
[[Image:database.jpg|800px]] <br> <br>
  
This should be installed after IIS7 or IIS8 <br>
+
Click "Next" at the bottom-right of the window and you will be asked for your System Administrator (sa) password. <br> <br>
  
If it is already installed it may be reinstalled by running a file called: aspnet_regiis.exe. Search for this file on the webserver then browse to it via a command prompt window and run it with a -i switch i.e: <br> <br>  
+
[[Image:sapwd.jpg]] <br> <br>
  
aspnet_regiis.exe -i. <br>
+
Enter your sa password then click "Connect". You will then see a window asking you to confirm that you wish to perform a new install. Click Yes. <br> <br>
  
==The PARS Connect Service Controller==
+
==Application==
  
Browse to and run: [Shared SIMS folder e.g. s:\SIMS]\PARS\Connect\ServiceController.exe. If you see a security error, run "Trusted.bat" found in the same folder.  
+
Generally we would recommend installing PARS under the Default Web Site, but you can create a new website if you feel this would be more suitable. None of the websites should have an asterix after their name; if they do, please contact our [[Help:Contents|helpdesk]]. <br> <br>
  
<p style="color:red">Important: If you see any further error messages during the installation process, create a ticket on the [http://www.tascsoftware.co.uk/web/support/secure.aspx PARS Helpdesk] with the "Details" text before continuing.</p>
+
[[Image:application01.jpg|800px]] <br> <br>
  
The "Application Tier" option should be highlighted, if not click this now. To the right of the "Web Site" label in the main panel is a + button. Click this to add a website. Enter the Web site name (e.g. "PARS" or "Connect"), the port number you would like it to use. Click on the (none) option in the Certificate section. For the physical path choose a location to host the files for PARS Connect. The path should in most cases be within this folder: c:\Inetpub\wwwroot\ e.g. c:\Inetpub\wwwroot\PARSConnect.
+
==Session State==
  
Still on the "Application tier" page, highlight the new PARS website under "Web sites" and then click the + button to the right of "Applications" to create the Application pool.
+
This tab gives options for handling the session state of logged in users. '''If you are unsure of which option you need to select, or do not know the pros and cons of each option, then you should choose the top option.''' <br> <br>
  
Make sure the PARS website is still highlighted under "Web sites" and then click "Commit" followed by "Begin".  
+
[[Image:sessionstate.jpg|800px]] <br> <br>
  
'''N.B. You will need to re-run ServiceController.exe and click "Commit" => "Begin" every time there is a PARS .net update that contains an update for PARS Connect.'''
+
==Commit==
  
After installing the Service Controller, a login page for PARS Connect should open in the default web browser on the server. Make a note of the URL. To access PARS connect from a different machine use this url, substituting the webserver's name if "Localhost" is included. e.g:
+
As long as there are no errors, you will not see this tab. The installer will skip past this tab and perform all of the steps for you. <br> <br>
  
'''http://localhost:1595/PARS/Login.aspx'''
+
[[Image:commit01.jpg|800px]] <br> <br>
  
Can be accessed on a different machine on the network via:
+
==Auxiliary==
 
'''http://webserver_name:1595/PARS/Login.aspx'''
 
  
==Additional==
+
You can click the "Details" button if you want to see your PARS Connect URL. Otherwise, click the "Finish" button to complete the PARS installation. <br> <br>
  
Also in the service controller is the installer for the Automation Windows services you should install.
+
[[Image:auxiliary01.jpg|800px]] <br> <br>
  
The Automation service periodically makes requests to the server, keeping the application loaded in IIS.  This prevents a delay for the first user accessing the site after a delay long enough for IIS to unload the application.  Importantly this provides the trigger for the main application to consider running automated process and scheduled reports.
+
=Extras=
  
If the Automation Keep Alive service is not installed, click Install and then start.  If an upgrade is pending you will be informed in the "Version:" field; Stop, un-install, install and start to perform the upgrade.
+
==CAPTCHA==
 
 
If you wish to access PARS Connect over the internet it is recommended that you install Secure Socket Layer (SSL) encryption. Failure to do this could leave your data open to unauthorised access. A detailed description of how to install SSL is given [http://www.petri.co.il/configure_ssl_on_your_website_with_iis.htm here].
 
 
 
You may find that if the enable HTTPS and disable HTTP the Automation Keep Alive service will no longer be able to reach the address it was originally configured to use.  In this case, or if the port number has changed for example, correct the address in the "Using address:" field, stop and restart the service.
 
  
==CAPTCHA==
+
If you wish you can set a [http://en.wikipedia.org/wiki/Captcha CAPTCHA] which will be required for users to log in to PARS Connect. To enable this, find the web.config file on the IIS server (by default it is found in c:\inetpub\wwwroot\pars) and open the file in Notepad. Find the lines of text below and make sure that "value" is set to "On". <br> <br>
By default a [http://en.wikipedia.org/wiki/Captcha CAPTCHA] is required to log in to PARS Connect. To disable this, find the web.config file on the IIS server, by default it is found in c:\Inetpub\wwwroot\pars. Open the file in Notepad and find these lines of text:
 
  
 
  <setting name="CAPTCHA" serializeAs="String">
 
  <setting name="CAPTCHA" serializeAs="String">
   <value>Off</value>
+
   <value>On</value>
  </setting>
+
  </setting> <br> <br>
 
 
 
 
Change the value of CAPTCHA to "Off". It is not recommended that the CAPTCHA be turned off if PARS Connect is to be made accessible via the internet.
 
  
 
==PINS==
 
==PINS==
  
Each user can be assigned a temporary PIN that is required along with their password in order to log in. The PIN is valid for 5 minutes after it is issued and is send to a person's email address or as an SMS message when a person tries to log in. To enable PINs, find this text in the PARS web.config file on the IIS server, by default it is found in c:\Inetpub\wwwroot\pars. Open the file in Notepad and find these lines of text:
+
Each user can be assigned a temporary PIN that is required along with their password in order to log in. The PIN is valid for 5 minutes after it is issued and is send to a person's email address or as an SMS message when a person tries to log in. To enable this, find the web.config file on the IIS server (by default it is found in c:\inetpub\wwwroot\pars) and open the file in Notepad. Find the lines of text below and make sure that "value" is set to "On". <br> <br>
  
 
  <setting name="PINS" serializeAs="String">
 
  <setting name="PINS" serializeAs="String">
   <value>Off</value>
+
   <value>On</value>
 
  </setting>
 
  </setting>
 
And change the value to "On".
 
 
 
 
=Troubleshoot / Errors=
 
 
==HTTP Error 500.19  Error Code: 0x80070021==
 
Q: This configuration section cannot be used at this path.  This happens when the section is locked at a parent level. Locking is either by default (overrideModeDefault="Deny"), or set explicitly by a location tage with overrideMode="Deny" or the legacy allowOverride="false"
 
 
Config source: <br>
 
161: </modules>
 
162: <handles>
 
163: <remove name="WebServiceHandlerFactory-Integrated" />
 
<br>
 
A: Look in IIS Manager, under the server name --> feature delegation. If Handler Mappings is set to readonly flip the value to read/write
 
 
Config Source: <br>
 
155: <validation validateIntegratedModeConfiguration="false" />
 
156: <modules>
 
157: <remove name=ScriptModule" />
 
 
A: Open an elevated Command Prompt and run <br>
 
%windir%\system32\inetsrv\appcmd unlock config -section:system.webServer/modules
 
 
==HTTP Error 403.14 - Forbidden==
 
 
Module        DirectoryListing Module
 
Notification  ExecuteRequestHandler
 
Handler        StaticFile
 
 
A: Use IIS Manager to ensure you have a DEFAULT.ASPX in your Default Documents list.
 
<br>
 
Ensure ASPNET is installed on the server - for ASPNET follow:  http://browse.feedreader.com/c/Developer_OneNote/196983817 looking mostly at steps 7 and 8
 
 
==Web Site Error==
 
 
===REDIRECTINCONNECTINI===
 
A:Copy the connect.ini off your shared SIMS drive into %program files%sims\sims.net so that it does not contain a redirect that NETWORK SERVICE will not be able to follow.
 
 
You can either copy the whole file, or enter the SERVERNAME and DATABASENAME from the central version.
 
  
 
[[Category:Technical]]
 
[[Category:Technical]]
 
[[Category:Configuration]]
 
[[Category:Configuration]]

Revision as of 13:14, 7 July 2014

The PARS Connect network topology

PARS Connect is a web based version of PARS .net. Installation is performed on one or more webservers on which the webpages are hosted and can be accessed from client machines via a web browser.

To install PARS Connect on the webserver, you will need the following installed:

  • SIMS .net
  • IIS (version 7 or higher)
  • Microsoft .Net Framework (version 4.0 or higher)
  • ASP.NET (version 4.5 or higher)

Installation

Prerequisites

This tab will check that you have the required prerequisites in order to install or update PARS. Also note that this must be performed on the IIS server. PARS will need:

  • Version 7 or higher of IIS to be installed
  • SIMS .net to be installed on this machine

If both of the prerequisites have ticks next to them, then you can move on to the next step of the installer. To do this, click the "Next" button at the bottom right of the window. Otherwise, install the missing components then rerun the PARS installer.

Prequisites.jpg

Database

At this stage the installer will check the connection to the SIMS database. If the installer cannot find your SIMS database, you will need to find out why then resolve the issue before running the PARS installer.

Database.jpg

Click "Next" at the bottom-right of the window and you will be asked for your System Administrator (sa) password.

Sapwd.jpg

Enter your sa password then click "Connect". You will then see a window asking you to confirm that you wish to perform a new install. Click Yes.

Application

Generally we would recommend installing PARS under the Default Web Site, but you can create a new website if you feel this would be more suitable. None of the websites should have an asterix after their name; if they do, please contact our helpdesk.

Application01.jpg

Session State

This tab gives options for handling the session state of logged in users. If you are unsure of which option you need to select, or do not know the pros and cons of each option, then you should choose the top option.

Sessionstate.jpg

Commit

As long as there are no errors, you will not see this tab. The installer will skip past this tab and perform all of the steps for you.

Commit01.jpg

Auxiliary

You can click the "Details" button if you want to see your PARS Connect URL. Otherwise, click the "Finish" button to complete the PARS installation.

Auxiliary01.jpg

Extras

CAPTCHA

If you wish you can set a CAPTCHA which will be required for users to log in to PARS Connect. To enable this, find the web.config file on the IIS server (by default it is found in c:\inetpub\wwwroot\pars) and open the file in Notepad. Find the lines of text below and make sure that "value" is set to "On".

<setting name="CAPTCHA" serializeAs="String">
  <value>On</value>
</setting> 

PINS

Each user can be assigned a temporary PIN that is required along with their password in order to log in. The PIN is valid for 5 minutes after it is issued and is send to a person's email address or as an SMS message when a person tries to log in. To enable this, find the web.config file on the IIS server (by default it is found in c:\inetpub\wwwroot\pars) and open the file in Notepad. Find the lines of text below and make sure that "value" is set to "On".

<setting name="PINS" serializeAs="String">
  <value>On</value>
</setting>