Difference between revisions of "Installation"

From InsightWiki
Jump to navigation Jump to search
Line 11: Line 11:
 
'''Installing INSIGHT:'''
 
'''Installing INSIGHT:'''
  
Once INSIGHT is installed and parent login details set (see full [[Installation Procedure|installation procedures]]) internet access to the school system can be set up.
+
On the IIS server, open the main Insight installer package and click 'run'.
  
This can be primarily one of two ways:-
+
*You will see a license agreement which you must accept to proceed. Following acceptance, the package files will be extracted.
  
1. Directly by giving users the school IP address and INSIGHT path allowing them direct access or
 
  
2. Inserting a link into the existing school web site which directs users on to the school.
+
[[Image:license_box.jpg]]
  
With the detailed instructions and support from TASC most secondary schools should be able to carry out these functions themselves. Smaller Primary Schools may not have the expertise but will usually have Local Authority technical support.
+
 
 +
*The following window will briefly appear as pre-requisites are checked:
 +
 
 +
 
 +
[[Image:brief_box.jpg]]
 +
 
 +
 
 +
*If all pre-requisites have been met then main Service Controller window will open.  You can also view the Service Controller using \\''simscentralservername''\''SIMSROOTFOLDER''\SIMS\INSIGHT from now on (i.e. when you update).
 +
 
 +
 
 +
The Service Controller is the program used to actually install the Insight database, and the web site or sites.  There are a number of buttons on the left hand side, each revealing a page with a specific purpose in mind.  in general, you should work from the top button down in turn.
 +
 
 +
*'''Database''' tab: In here you will need to enter your server name. Depending on the rights associated with your login you may or may not have to enter the SQL server’s SA username and password. Once the correct details have been added the service controller will create the Insight database.  This will be stored on your existing SIMS SQL Server.
 +
 
 +
[[Image:sc_database.jpg]]
 +
 
 +
 
 +
*Then, click on the '''Web site''' button to configure a website. For IIS 7 servers, click on the 'create IIS7' button.  Once you have created this it will show the status as started. You can select an existing web site from the central drop down choice, or create a new one by clicking on the 'create' link.  If you do choose to create a dedicated web site, you will be asked to choose a folder to use.  It is recommended to create a folder called INSIGHTFOLDER inside inetpub\wwwroot and install to this.  You will be asked to select which SSL certificate to use (or choose ''(none)'' if you are to be installing this at a later date), and the SSL port to be used.  This port should not collide with any existing sites or services.
 +
 
 +
 
 +
[[Image:sc_web_site.jpg]]
 +
 
 +
 
 +
*Then, click on the '''SIMS users''' tab where you will need to specify some SIMS usernames and passwords which Insight will use internally.  These do not need to have any SIMS .net permissions set, although they do need to exist. Use the Add and Remove buttons to manage the SIMS users. Normally, only between one and three users will be required, dependant upon expected load.
 +
 +
 
 +
[[Image:sc_sims.jpg]]
 +
 
 +
 
 +
*Then, click on the '''Application''' tab. If you are about to create the application for the fist time, click on the Create button.  If you are returning, or have just created the application, you will have options to:
 +
:*Select a theme.
 +
:*Choose an image to use as a logo, which must be in the root web folder (INSIGHTFOLDER), and will override any logo stored in SIMS.
 +
:*enable a link to PARS,if in use.
 +
:*An API can be enabled which can allow external applications to read data from Insight.
 +
:*Enable Anti-DOS filter can be enabled which will lock down any IP for one minute if requests are made with too high a frequency.
 +
:*Windows Authentication can be specified on a particular page designed to be used as part of a [SSO|Single Sign On] system.
 +
You will also then be able to "recycle" the application.  This will need to be performed each time an Insight service pack is downloaded, to apply the changes to the web server.
 +
 
 +
 
 +
[[Image:sc_application.jpg]]
 +
 
 +
Following a "Create" or "Recycle" process, a browser window is opened, on the server, to the default starting page of Insight. The first attempt to load Insight following one of these processes can take up to one minute, where it will appear not much is happening, but you should soon see a login page. Use the following credentials to login:
 +
 
 +
:'''Username:''' admin
 +
:'''Password:''' password
 +
 
 +
 
 +
*If this is your first log on, you will most likely be taken to a ''''No license found'''' page. This screen will prompt you to retrieve a licence.  Click on the ‘here’ link to attempt this.  If proxy authentication is required, enter your proxy details into the boxes provided and click the "Update" button.  Retry until a licence can be obtained.  In extreme circumstances, you can also collect a licence key manually, and submit it using the area towards the bottom of the page.
 +
 
 +
*Once Insight has been fully installed [[Preferences]] must be setup which affects all INSIGHT users. Then [[Manage Roles|Roles]] must be created and then [[Manage Users|users]] need to be created. 
 +
 
 +
For a Getting Started guide, please [http://www.tascsoftware.co.uk/insight/wiki/files/Insight-Getting%20started.pdf click here] .
 +
 
 +
*When you are happy that your users and preferences are configured, you will need to ensure that a route is configured from outside to the Insight IIS server.  Although not authoritative, the example below may help you to with this stage.
 +
[[Image:Drawing1.png]]
  
 
'''Where schools are linked via a Grid for Learning Network managed by their Local Authority slightly different procedures may be required. In this case talk to TASC and to your Local Authority Technical Officers.'''
 
'''Where schools are linked via a Grid for Learning Network managed by their Local Authority slightly different procedures may be required. In this case talk to TASC and to your Local Authority Technical Officers.'''
 
Whichever means is required you can be sure of the full support of TASC.
 

Revision as of 15:34, 21 December 2010

Installing INSIGHT

Prerequisites before installing INSIGHT::-

  • A Web Server with IIS and Microsoft.Net Framework 4.0 installed. Larger secondary schools may already have this or at least capacity on existing servers for it to be installed. Smaller Primary Schools with just one or two PCs running SIMS may need to purchase an extra “box” for this.
  • The Web Server must be networked with SIMS SQL server and to a router with broadband connection. The broadband line must have a fixed IP address – most schools will already have this but some may need to arrange this via their ISP and a small charge may be made.


Installing INSIGHT:

On the IIS server, open the main Insight installer package and click 'run'.

  • You will see a license agreement which you must accept to proceed. Following acceptance, the package files will be extracted.


License box.jpg


  • The following window will briefly appear as pre-requisites are checked:


Brief box.jpg


  • If all pre-requisites have been met then main Service Controller window will open. You can also view the Service Controller using \\simscentralservername\SIMSROOTFOLDER\SIMS\INSIGHT from now on (i.e. when you update).


The Service Controller is the program used to actually install the Insight database, and the web site or sites. There are a number of buttons on the left hand side, each revealing a page with a specific purpose in mind. in general, you should work from the top button down in turn.

  • Database tab: In here you will need to enter your server name. Depending on the rights associated with your login you may or may not have to enter the SQL server’s SA username and password. Once the correct details have been added the service controller will create the Insight database. This will be stored on your existing SIMS SQL Server.

Sc database.jpg


  • Then, click on the Web site button to configure a website. For IIS 7 servers, click on the 'create IIS7' button. Once you have created this it will show the status as started. You can select an existing web site from the central drop down choice, or create a new one by clicking on the 'create' link. If you do choose to create a dedicated web site, you will be asked to choose a folder to use. It is recommended to create a folder called INSIGHTFOLDER inside inetpub\wwwroot and install to this. You will be asked to select which SSL certificate to use (or choose (none) if you are to be installing this at a later date), and the SSL port to be used. This port should not collide with any existing sites or services.


Sc web site.jpg


  • Then, click on the SIMS users tab where you will need to specify some SIMS usernames and passwords which Insight will use internally. These do not need to have any SIMS .net permissions set, although they do need to exist. Use the Add and Remove buttons to manage the SIMS users. Normally, only between one and three users will be required, dependant upon expected load.


Sc sims.jpg


  • Then, click on the Application tab. If you are about to create the application for the fist time, click on the Create button. If you are returning, or have just created the application, you will have options to:
  • Select a theme.
  • Choose an image to use as a logo, which must be in the root web folder (INSIGHTFOLDER), and will override any logo stored in SIMS.
  • enable a link to PARS,if in use.
  • An API can be enabled which can allow external applications to read data from Insight.
  • Enable Anti-DOS filter can be enabled which will lock down any IP for one minute if requests are made with too high a frequency.
  • Windows Authentication can be specified on a particular page designed to be used as part of a [SSO|Single Sign On] system.

You will also then be able to "recycle" the application. This will need to be performed each time an Insight service pack is downloaded, to apply the changes to the web server.


Sc application.jpg

Following a "Create" or "Recycle" process, a browser window is opened, on the server, to the default starting page of Insight. The first attempt to load Insight following one of these processes can take up to one minute, where it will appear not much is happening, but you should soon see a login page. Use the following credentials to login:

Username: admin
Password: password


  • If this is your first log on, you will most likely be taken to a 'No license found' page. This screen will prompt you to retrieve a licence. Click on the ‘here’ link to attempt this. If proxy authentication is required, enter your proxy details into the boxes provided and click the "Update" button. Retry until a licence can be obtained. In extreme circumstances, you can also collect a licence key manually, and submit it using the area towards the bottom of the page.
  • Once Insight has been fully installed Preferences must be setup which affects all INSIGHT users. Then Roles must be created and then users need to be created.

For a Getting Started guide, please click here .

  • When you are happy that your users and preferences are configured, you will need to ensure that a route is configured from outside to the Insight IIS server. Although not authoritative, the example below may help you to with this stage.

Drawing1.png

Where schools are linked via a Grid for Learning Network managed by their Local Authority slightly different procedures may be required. In this case talk to TASC and to your Local Authority Technical Officers.