AgileWeb - Agilaire LLC · PDF file A web server (Microsoft Windows Server 2008r2 / Server...

Click here to load reader

  • date post

    16-May-2020
  • Category

    Documents

  • view

    3
  • download

    0

Embed Size (px)

Transcript of AgileWeb - Agilaire LLC · PDF file A web server (Microsoft Windows Server 2008r2 / Server...

  • AgileWeb for AirVision Produced by Agilaire LLC

    2904-B Tazewell Pike, Suite A Knoxville, TN 37918 www.agilairecorp.com [email protected]

    Support: 865-927-9440 [email protected]

    April 2014

  • 2

    Agilaire AirVision Manual Table of Contents

    Introduction_______________________________________ _ 4

    Chapter_1__Installation_and_Configuration_________________ _ 6 _ System_Requirements_________________________________ _ 6 _ Configuring_IIS_7_ ____________________________________ _ 7 _ AgileWeb_Deployment__________________________________ _ 9 _ _ Option_#1:_Deploying_via_command_line_________________________ _ 9 _ _ Option_#2:_Deploying_in_the_IIS_Manager_user_interface _ _ __ (not_recommended_for_upgrades)____________________________ _ 10 _ After_Installation______________________________________ _ 10 _ Configuration________________________________________ _ 11 _ _ Secure_Sockets_Layer_(SSL)__________________________________ _ 11_ _ _ _ Option_#1:_Disabling_SSL__________________________________ _ 11 _ _ _ Option_#2:_Configuring_SSL________________________________ _ 11 _ _ _ Configuring_HTTPS/SSL_Binding_for_the_web_site_ ______________ _ 12 _ _ Public_Access_ ____________________________________________ _ 12 _ _ _ _“Public”_Folder__________________________________________ _ 12 _ _ Web.config_changes________________________________________ _ 13 _ _ _ _Database_Connection_ ___________________________________ _ 13 _ _ _ Map_Time_Offset_________________________________________ _ 13 _ _ Customizations_to_the_User_Interface_ __________________________ _ 14 _ _ _ Banner_Image_and_Text_ __________________________________ _ 14 _ _ _ CSS_Styles__ ___________________________________________ _ 14 _ _ _ Custom_Master_Pages____________________________________ _ 15 _ _ _ Frames________________________________________________ _ 16 _ _ Themes__________________________________________________ _ 16 _ _ _ _Predefined_Themes______________________________________ _ 16 _ _ _ Custom_Themes_(Advanced)_______________________________ _ 16 _ _ Default_Page_Configuration_(AQI_Map_and_Reports)________________ _ 17_ _ _ _ Startup_Favorite_Page_____________________________________ _ 17

  • 3

    Agilaire AirVision Manual Table of Contents

    _ _ _ AQI_Map_Configuration____________________________________ _ 18_ _ _ _ AQI_Map_Layers_________________________________________ _ 18 _ Security________________________________________________ _ 19_ _ _ Login_Access______________________________________________ _ 19 _ _ _ Anonymous_User_Permissions______________________________ _ 19 _ _ _ Frames_and_Click-Jacking_Prevention________________________ _ 19 _ _ _ Disabling_Browser_Cache__________________________________ _ 20

    Chapter_2__Using_the_Public_Web_Site__ _________________ _ 21 _ Historical_Reporting___________________________________ _ 24 _ Forecast_Editor_ _________________________________________ _ 26 _ _ _ Report_List_Configuration_(Web_Favorites)_____________________ _ 27 _ _ _ Opening_Report_Viewer_in_New_Window_or_Same_Window_ _______ _ 28 _ _ _ Web_Display_Info_Editor_ __________________________________ _ 29

    Appendix_A:__Map_Options____________________________ _ 30 _ Static_Maps_ ________________________________________ _ 30 _ _ _ Google_Static_Map_______________________________________ _ 30 _ _ _ Dynamic_Maps__________________________________________ _ 31 _ _ _ Adding_a_defaultTransfer_key_to_custom.config_________________ _ 31 _ _ _ Adding_your_API_key_to_AgileWeb____________________________ _ 31 _ _ _ Configuring_the_latitude/longitude_in_AirVision_ _________________ _ 31

  • 4

    Introduction AgileWeb for AirVision fulfils multiple roles in providing air quality data.

     AgileWeb can provide a detailed public information system by which residents can see real-time air quality data on a drill-down map and in site AQI tables.

     Website visitors can be provided with pre-configured reports (limiting exposure) or given access to generate reports and graphs using their own search criteria.

     AgileWeb can be configured to allow a password- protected interface for selected users, providing a full intranet browser-based reporting system with access to all AirVision reports.

  • 5

    AgileWeb for AirVision Introduction

    AgileWeb supports several implementation scenarios.

    Public

    If you prefer only a public display of map/reports, without login, then set the EnableLogin=False in your custom.config. This disables the login feature. Deploy to public web server which has access to the AirVision database.

    Private Only

    If you prefer only an internal (intranet) site with no public access, deploy to an internal web server which has access to the AirVision database.

    Public and Private on same web site

    If you prefer to have the web site serve public users as well as application users who can log in and utilize additional features, deploy to a public web server which has access to AirVision database.

     Note: in this scenario be sure to change your default AirVision ‘admin’ password to something more secure.

    Public and Private on separate web sites

    If you prefer to keep the public/internal sites separate, you will need to deploy two separate copies of the web application. This requires the most maintenance, but it provides the highest level of flexibility for security and hosting details. Deploy twice, using the same guidelines as the Public Only and Private Only scenarios.

  • 6

    Chapter 1

    Installation and Configuration

    System Requirements Minimum requirements for installing AgileWeb are:

     A web server (Microsoft Windows Server 2008r2 / Server 2012 / Windows 7 / Windows 8)

     Microsoft .NET Framework 4.0

     Microsoft Internet Information Server 7 (IIS) or later

    - If IIS is installed AFTER ASP.NET you will need to register it using the aspnet_regiis.exe executable with the –i switch.

     The ability to make a SQL connection to the AirVision database (or a mirrored copy of the AirVision database).

     Image files for primary map overlay and site-specific photos (See Appendix A for Google and Bing map options).

     Microsoft requires one user license for each web site visitor, so a Processor License (Workstation or better) is recommended for AirVision servers using AgileWeb.

     SSL (Secure Sockets Layer) certificate for local server if you will be enabling the login feature.

  • 7

    AgileWeb for AirVision Chapter 1 Installation and Configuration

    Configuring IIS 7 1. On your web server, open Administrative Tools.

    2. From Administrative Tools select Internet Information Services (IIS) Manager. All your web sites should be listed.

    3. We recommend creating a separate Application Pool for AirVision. This allows the AirVision application to be controlled independently of the rest of the web sites. For example, this lets it have its own user identity (for database access), and it can be recycled independently in order to pick up configuration changes.

    4. In the IIS Manager, right-click Application Pools and select Add Application Pool.

  • 8

    AgileWeb for AirVision Chapter 1 Installation and Configuration

    5. In the Add Application Pool screen, enter a Name, e.g. AgileWeb, and change the .NET Framework Version to .NET Framework v4.0.30319. Click OK.

    6. Still in the Features View of your virtual directory, double click the Authentication item. If not already set, right click Anonymous Authentication and select Enable.

    7. In the Features View, open the SSL Settings. Select Require SSL. If this option is disabled, you will need to add a certificate to the root web site in IIS to enable this option. You need a certificate for SSL so the login name and password can be encrypted. See the Configuration section later in this document for more information about SSL.

  • 9

    AgileWeb for AirVision Chapter 1 Installation and Configuration

    AgileWeb Deployment Default values are defined below. These may be changed by the IIS administrator if needed.

    • Copy the AgileWeb deployment package folder to a known location on the web server’s hard drive.

     Note: This is not the actual web app folder in IIS; this is only used for the deployment process. You can use a temp folder or desktop, etc.

    • If this is a first time installation, you must first ensure the desired web site exists in IIS and verify the application pool in IIS Manager. The Application Pool of the target web site must be set to .NET Framework Version v4.0.

    • If this is an upgrade and you have a previous custom.config file, Custom folder, or any other additions or modified files, you need to make a copy of them now before proceeding to prevent against accidental deletion.

    The application can be installed either via command line or via the IIS Manager user interface. However the IIS Manager user interface does not allow specific files to be deleted or saved individually and this results in deletion of custom files during the upgrade. Because of this, Agilaire recommends using the command line method for upgrades.

    Option #1: Deploying via command line By default, the web application is deployed to Default Web Site\AirVision in IIS. If you have another web site on the server you prefer to install the application into, you may choose to install AgileWeb within th