Read Training Notes text version

Setting up Accelerus Web

Windows Server 2003 with IIS6

February 2012

Semaphore Consulting Pty Ltd

SCHOOL SOFTWARE SPECIALISTS Suite 18, 79 Mahoneys Road Forest Hill, Victoria 3131 tel: 1300 65 62 63 fax: +61 (03) 9877 9961

ABN 79 007 089 661 www.accelerus.com.au [email protected]

Information in this document is subject to change without notice and does not represent a commitment on the part of Semaphore Consulting Pty Ltd. The software described in this document is supplied under a licence agreement. The software may be used or copied only in accordance with the terms of the agreement. No part of these notes may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, without the written permission of Semaphore Consulting Pty Ltd. Copyright Semaphore Consulting Pty Ltd 2008 - 2012. All rights reserved. MarkBook and Accelerus are Registered Trademarks of Semaphore Consulting Pty Ltd.

Setting up Accelerus Web ­ Windows Server 2003

Page 2

Semaphore Consulting Pty Ltd

Prerequisites

A school may allow teachers to enter their class results in the Accelerus database via a web browser, rather than using offline files or logging into the database directly using the Accelerus program. In order to do so:

The school must be have installed Accelerus V1.2 or above of Accelerus and followed the steps to upgrade the database outlined in the V1.2 Release Notes. It is expected that the school has the appropriate permission and knowledge of their server and network configuration, and the necessary expertise, to set up and manage a web hosting environment. The school must be running Accelerus with an SQL Server database, and not an Access-type database. The school must have a web server with the following:

Windows Server 2003 or 2008 which includes Microsoft Internet Information Services (IIS). .NET Framework 4.0. These notes apply to the deployment of the Accelerus web service using Windows Server 2003 with IIS6.

NB

To allow internet access for teachers, the school must have a domain name. Web browsers that may be used by teachers include Safari, Firefox and Internet Explorer 8 or above. Internet Explorer 7 or earlier versions are not recommended. If teachers are using Internet Explorer 9, you must ensure that they are not in IE9 compatibility mode. To do this, in IE9, press F12 and a box will open at the top or bottom of the screen. Click Browser Mode in the window and, in the drop down list, change the selection from Internet Explorer 9 Compatibility Mode to just Internet Explorer 9.

Step by Step 1. Download and unzip AccelerusWebInstaller.exe

Download AccelerusWebInstaller.exe, a self-extracting zip file. Double-click the downloaded file and select the location to store the extracted files. This will create the following three folders containing various files, in the selected location: WebService WebSite

2.

Installation of the Windows web server

Please review these steps to ensure that the required features of IIS6 are enabled.

Go to Control Panel and select Add/Remove Programs. Click Add/Remove Windows Components in the left hand panel. In the Windows Components Wizard that appears, double-click Application Server.

Semaphore Consulting Pty Ltd

Page 3

Setting up Accelerus Web ­ Windows Server 2003

In the Application Server window that then opens: Ensure that ASP.NET is ticked. Double-click Internet Information Services (IIS).

In the Internet Information Services box, double-click World Wide Web Service.

In the World Wide Web Service box, ensure that World Wide Web Service is checked and then click OK.

Setting up Accelerus Web ­ Windows Server 2003

Page 4

Semaphore Consulting Pty Ltd

Click OK in each of the windows you are returned to, until back to the Windows Components Wizard. Click Next and follow the steps to install the web server.

3.

Web Service setup

The website itself does not connect to the database directly. It calls web services that expose data securely from the Accelerus database. This step of the setup requires that IIS is setup and ready. NB It is expected that most installations will have the website and the web service on the same server. This guide covers allowing a local website to communicate with a local web service. In a situation where the service is to be hosted on another machine be sure to configure the host name and binding details so they are publically accessible. Click Start > Programs > Administrative Tools > Internet Information Services (IIS) Manager. In the IIS Manager, right click on Web Sites in the left-hand pane and select New > Web Site.

In the Web Site Creation Wizard enter AccelerusWebService as the description and click Next.

Enter the Host header name as AccelerusWebService and click Next.

Semaphore Consulting Pty Ltd

Page 5

Setting up Accelerus Web ­ Windows Server 2003

NB

If you use a different host header value name, you must, later, change the WebSite Web.Config file, as outlined in step 6.

Browse to the directory where you have copied the Accelerus WebService folder (see Step 1) and select it so that it appears in the Path field, then click Next.

Tick each of the Read, Run scripts and Executive check boxes.

Click Next to complete the wizard.

Setting up Accelerus Web ­ Windows Server 2003

Page 6

Semaphore Consulting Pty Ltd

In the left-hand pane in the Internet Information Services (IIS) Manager, right click the AccelerusWebService website and select Properties.

Click the ASP.NET tab in the AccelerusWebService Properties window. NB This tab will not appear if you have not yet installed .NET4. Change the ASP.NET version field to one that begins with 4.0, eg 4.0.30319 as shown below.

If a message appears asking you whether you wish to continue, click Yes. Click Apply and then OK. To integrate WCF for web service calls into IIS6 you must run the following command at the command prompt, all on one line: %systemroot%\Microsoft.NET\Framework\v4.0.30319\ServiceModelReg.exe -ia NB Ensure that the >NET framework version matches that selected in the ASP.NETversion in the previous step. As this guide expects to have the service and the website on the same machine we setup the website in the HOSTS File: Click Start -> Run and type in: notepad %systemroot%/system32/drivers/etc/hosts To the end of the file add: 127.0.0.1 acceleruswebservice

Semaphore Consulting Pty Ltd

Page 7

Setting up Accelerus Web ­ Windows Server 2003

Of course, if you did not use this as the host header value for the web service site on page 5, enter the name you assigned.

Save and close the file.

Test the web service by opening Internet Explorer and visiting one of the service end points directly, eg visit the web address: http://acceleruswebservice/StudentService.svc, or your site name. You should have a page like that shown below appear. If you do not, check the steps and refer to the Troubleshooting guide on page 19.

4.

Web Site setup

This section details setting up the Accelerus Web application site. The site itself will communicate with the service that was set up in the previous section. Many of the steps will be familiar to those undertaken to set up the web service.

Open Internet Information Services (IIS) Manager by clicking Start > Programs > Administrative Tools > Internet Information Services (IIIS) Manager. In the IIS Manager, right click on Web Sites in the left-hand pane and select New > Web Site.

Setting up Accelerus Web ­ Windows Server 2003

Page 8

Semaphore Consulting Pty Ltd

In the Web Site Creation Wizard enter AccelerusWebSite as the description and click Next.

In the IP Address and Port Settings window of the wizard: If your school is already using Port 80, enter an unused Port number for the website. In the Host header values, for testing purposes to begin with, enter a host header name of mywebsite. NB Do not use website as the host header name.

Click Next. This host name is being used for local testing on your server only. You may wish to configure this differently to ensure that the website is accessible on your intranet. This will differ from environment to environment so it is suggested that you test locally with this approach and then reconfigure later, with the URL to be used by teachers, once you have confirmed the application is running. (see step 7)

Set the physical path to the directory where you have copied the WebSite folder (see Step 1) containing the installation files for the website, and then click Next.

Semaphore Consulting Pty Ltd

Page 9

Setting up Accelerus Web ­ Windows Server 2003

Tick the Read, Run scripts and Executive check boxes, and then click Next to complete the wizard.

In the left-hand pane in the Internet Information Services (IIS) Manager, expand the Application Pools branch. Right click AccelerusAppPools and from the menu select Properties. In the AccelerusAppPool Properties window: Click the Performance tab. Deselect the Idle timeout checkbox, so that the application pool never times out.

Click the Identity tab. Click the Configurable option and enter the user name and password of a user who has full permissions to the Accelerus database. NB NetworkService, as shown below, should only be used for testing purposes. If you choose to use this when testing, ensure you return to this window and nominate a configurable account. If you are using Windows Small Business Server 2003, the user that is nominated must be in the IIS_WPG user group.

Click OK.

Setting up Accelerus Web ­ Windows Server 2003

Page 10

Semaphore Consulting Pty Ltd

In the left-hand pane in the Internet Information Services (IIS) Manager, expand the Web Sites branch. Right click AccelerusWebSite and, from the menu, select Properties. Click the ASP.NET tab in the AccelerusWebSite Properties window. Change the ASP.NET version field to one that begins with 4.0, eg 4.0.30319 as shown below. Click Apply. If a message appears asking you whether you wish to continue, click Yes.

Click the Home Directory tab. Click the Configuration button.

In the Application Configuration window, click the Insert button for Wildcard application maps.

Semaphore Consulting Pty Ltd

Page 11

Setting up Accelerus Web ­ Windows Server 2003

In the Add/Edit Application Extension Mapping box: Browse for the following executable file: C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll NB Ensure that the >NET framework version matches that selected in the ASP.NETversion in the previous step.

Deselect the checkbox Verify that file exists. Click OK.

Click OK several times as you taken back to the Internet Information Services (IIS) Manager. Close the Internet Information Services (IIS) Manager. As this guide expects to have the service and the website on the same machine we setup the website in the HOSTS File: Click Start -> Run and type in: notepad %systemroot%/system32/drivers/etc/hosts To the end of the file add: 127.0.0.1 mywebsite.

Save and close the file.

5.

Edit the WebService Web.Config file

Go to Windows Explorer, navigate to the location where AccelerusWebInstaller.exe was unzipped, and open the folder WebService. Double-click the file Web.config to open it in Notepad. Make the following <add key> value changes to the Web.config file, in the locations indicated by comments, eg <! --Enter your database server name below -->: Add the name of the database server, ie where the database resides. Add the name of the database. If you want to use SQL authentication, add the username and password. Otherwise, leave these blank.

Setting up Accelerus Web ­ Windows Server 2003

Page 12

Semaphore Consulting Pty Ltd

When editing the Web.config file, it is important that only the actual values are changed and the syntax of the fields is correct, ie only the data after each value=, within the quotation marks, should be changed.

Save and close the Web.config file.

6.

Edit the WebSite Web.Config file

If, when adding the Web Service site, in step 3 on page 5, you inserted a site name other than AccelerusWebService:

Go to Windows Explorer, navigate to the location where AccelerusWebInstaller.exe was unzipped, and open the folder WebSite. Double-click the file Web.config to open it in Notepad. Search for and go to the <client> tag. For each service endpoint URL, change Acceleruswebservice to the site name you entered in step 3 on page 5. Save and close the file.

7.

Configure website sessionState timeout setting

This setting relates to how long an individual teacher's Accelerus Web session can remain idle before it times out. However, if using Active Directory and computers are configured to lock after a certain amount of time, the Accelerus timeout may be irrelevant.

Go to Windows Explorer, navigate to the location where AccelerusWebInstaller.exe was unzipped, and open the folder WebSite. Double-click the file Web.config to open it in Notepad.

Semaphore Consulting Pty Ltd

Page 13

Setting up Accelerus Web ­ Windows Server 2003

Under <system.web> change the <sessionState timeout = " "> to the required number of minutes, as shown below.

Save and close the Web.config file.

8.

Set the AutoSaveSecondTime setting

This setting determines how often an automatic save to the database is performed when teachers make changes while logged in to an Accelerus Web session. The default setting is 20 seconds. Consider carefully the impact before changing this setting ­ if set too high, automatic saves may not take place often enough; if set too low the performance of the session could degrade. To configure the AutoSaveSecondTime setting:

Go to Windows Explorer, navigate to the location where AccelerusWebInstaller.exe was unzipped, and open the folder WebSite. Double-click the file Web.config to open it in Notepad. Under <appSettings> change the <add key > "AutoSaveSecondTime" value as to the number of seconds required. Save and close the Web.config file.

9.

9.1

Integrating Active Directory with Accelerus logins

Enable Active Directory integration in Accelerus database

Schools may integrate their Accelerus logins with teachers' Windows logins so that teachers do not have to use or remember an additional user name and password for Accelerus. Instead, their school Windows login is used to verify their identity. If your school uses Windows Active Directory and wants to enable Active Directory integration:

Login to the Accelerus database and go to Tools > School Settings. Click the System Items tab. In the Login Settings section: Tick the Enable Active Directory Integration checkbox. Make your selection from the two available options. You MUST read the full documentation on this setting, its two options and the various checkboxes, the steps you must take and the implications of each. This is available via online help by pressing F1 when in this window.

Setting up Accelerus Web ­ Windows Server 2003

Page 14

Semaphore Consulting Pty Ltd

When Active Directory integration has been enabled, an additional field appears in every teacher's window ­ Domain User Name ­in order to link the Accelerus teacher record with their domain user name. The Domain User Name must be entered as the full domain user name, eg SchoolDomain\jemm, as seen here. You must add the domain user name of each teacher in their individual teac her records or import these via a CSV file.

9.2

Enable Windows authentication for the website

In the IIS Manager, under Sites, right click the AccelerusWebSite, and select Properties from the menu.

Click the ASP.NET tab in the Properties window. Click the Edit Configuration button.

Semaphore Consulting Pty Ltd

Page 15

Setting up Accelerus Web ­ Windows Server 2003

In the Configuration Settings window: Click the Authentication tab. Under Authentication mode, select Windows from the dropdown menu.

Click OK in the Configuration Settings window and then in the Properties window.

10.

Testing and going live

Test the website on the server by opening a web browser and visiting http://mywebsite It should direct you to the Accelerus login window. If this does not happen or you receive an error, review the setup steps or check in the Troubleshooting section on page 19.

When ready to go live: Click Start > Programs > Administrative Tools > Internet Information Services (IIS) Manager. In the left panel, open the Sites branch, right-click AccelerusWebSite and select Properties.

In the Web Site tab, click the Advanced button.

Setting up Accelerus Web ­ Windows Server 2003

Page 16

Semaphore Consulting Pty Ltd

Double-click the row containing the mywebsite details.

In the Add/Edit Web Site Identification box, replace the Host Header value with: o o The name or IP address of the server to be used by teachers when accessing Accelerus via the intranet. OR The domain name to be used by teachers when accessing via the internet.

Semaphore Consulting Pty Ltd

Page 17

Setting up Accelerus Web ­ Windows Server 2003

11.

Securing the transport for Web Services with SSL

If the Web application and Web services have been deployed on separate machines then you will want to review if the connection between the Web application and Web services should be secured. The recommended approach for intranet scenarios is to use transport level security. Securing the transport is achieved by creating an encrypted channel between the Web application and Web services using SSL. A valid SSL certificate, either self-signed or purchased, with a valid hostname must be acquired before proceeding with configuring the system. To configure the system for using SSL:

Install and enable the SSL certificate on the web site hosting the web services. Ensure that the SSL certificate is trusted on the machine hosting the web site hosting the web application. In the web.config for Accelerus.WebSite: Locate the <system.serviceModel> section. Locate the <bindings> sub-section which will contain a single <wsHttpBinding> element. Underneath this element will be a <binding> sub-section which will contain the line: <security mode="None"/> Change this line to read: <security mode="Transport"/> Locate the <system.serviceModel> section, and then the <client> subsection. For each <endpoint> element, update the address so that the URL is prefixed with https:// instead of http://.

In the web.config for Accelerus.WebService: Locate the <system.serviceModel> section, and then the <bindings> sub-section which will contain a single <wsHttpBinding> element. Underneath this element will be a <binding> sub-section which will contain the line: <security mode="None"/> Change this line to read: <security mode="Transport"/>

Setting up Accelerus Web ­ Windows Server 2003

Page 18

Semaphore Consulting Pty Ltd

12.

Troubleshooting

When visiting the root of the website I get an error about directory listings not being allowed. Ensure that the Application Pool for the website is running as .NET Framework 4.0 and, if the error still persists, run the following command to ensure ASP.NET is correctly integrated with IIS: C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe ­iru NB Your Windows directory location may be different and the v4.x.xxxxx directory may have subtly different numbers, depending on which exact version of .NET 4.0 is installed.

I get a message that an assembly cannot be loaded This can occur on 64 bit machines where the application pool needs configuring to support 32bit assemblies. In the Advanced Settings for the Accelerus Web Service Application Pool, change Enable 32-Bit Applications to True.

I'm on a 64 bit version of Windows and files referenced are not in the Framework directory ­ what can I do? You may find some referenced files live under the Framework64 directory. In those cases, simply change references from: %systemroot%/Microsoft .NET/ Framework/v4.0.30319 to %systemroot%/Microsoft.NET/Framework64/v4.0.30319 NB Ensure 64 appears on the end of the folder called Framework.

When browsing the web server or web site, I get a The page cannot be displayed error. Click Start > Run and type in: notepad %systemroot%/system32/drivers/etc/hosts Check the hosts file contains the lines: 127.0.0.1 acceleruswebservice 127.0.0.1 mywebsite, Of course, if you did not use these as the host header names for the web service and web site on page 5, you would enter the names you assigned.

I get a Script Error Check that the host name for the web site (as set in the steps on page 5) is not website. If this has been used, change this to another value, eg mywebsite.

Semaphore Consulting Pty Ltd

Page 19

Setting up Accelerus Web ­ Windows Server 2003

Information

Training Notes

19 pages

Find more like this

Report File (DMCA)

Our content is added by our users. We aim to remove reported files within 1 working day. Please use this link to notify us:

Report this file as copyright or inappropriate

686153


You might also be interested in

BETA
Training Notes