UI Developers' Guide - Installation

Total Page:16

File Type:pdf, Size:1020Kb

UI Developers' Guide - Installation UI Developers' Guide - Installation This section outlines the steps necessary to download, configure, build, and run the Ed-Fi Dashboard UI on a development machine. UI Developers' Guide The Ed-Fi Dashboards configuration described in this document has been tested with the following Contents software configuration: Read more about the UI Developers' Windows 8.1 Professional (64-bit) and Enterprise (64-bit); Windows 10 Professional (64-bit) Guide: and Enterprise (64-bit). Windows Server 2012 and Windows Server 2008 R2 (Windows Server 2008 releases before R2 are not supported). Internet Information Services (IIS) 8.0 and IIS 10.0. Microsoft SQL Server 2012 – with Service Pack 3 or higher (Standard Edition, Developer Edition, or Enterprise Edition. Note that Express Edition is not supported). Configure SQL Server with the following features: Database Engine Services (replication/text search not required). Management Tools (complete). Use the default instance (MSSQLSERVER). Choose Mixed Mode security (the application uses a SQL login). Specify a password for the sa account. In the “Specify SQL Server administrator” click on Add Current User. Visual Studio 2013 or 2015 (Professional Edition or higher). .NET Framework 4.5.2. Preparing a development environment to run the dashboards can be summarized as follows: Step 1. Download and Extract the Dashboard Source Code The Ed-Fi Dashboards source code is contained in one repository that can be downloaded using git clone or as a ZIP archive from the Ed-Fi Alliance source code repository in GitHub at https://github.com /Ed-Fi-Alliance/Ed-Fi-Dashboard. The links to the latest stable and development code versions are located in the section Getting Started - Downloading the Code. Git Clone or extract the repository to the folder C:\Ed-Fi\ if the code is not already present. It is recommended to clone/extract the repo to C:\Ed-Fi\ to avoid issues with the path and file name length. If you use a different path be sure to substitute your chosen path when following the setup instructions throughout this document. When the extraction and renaming is complete, there should be six folders for the dashboard source code as shown below: Step 2. Restore Sample Databases Two sample data sets are provided: Grand Bend Sample Data Set. A small sample data set with around 1,000 students. Glendale Sample Data Set. A robust sample set with around 47,000 students. This data set is used by the Alliance for dashboard development, unit testing, and integration testing. To restore one of the sample data sets: Open a PowerShell window and navigate to C:\Ed-Fi\Database\ (presuming the installation path used in the Getting Started documentation was the recommended C:\Ed-Fi\). If the SQL Server is not set up as the default instance (MSSQLSERVER), then run the command $env:db_server = ". \MYNAMEDINSTANCE" to setup the named SQL Server instance. By default the script will restore the Glendale data set. To restore the Grand Bend data set, execute $env:db_agency = "GrandBend" fro m the PowerShell command window. To restore the Glendale data set, execute $env:db_agency = "Glendale" from the PowerShell command window. Run the command .\build samples to restore the following databases, fully pre-populated with sample data: The ODS v2.0 database with the necessary views to support the ETL process. The Application, Dashboard, and DashboardDW databases, each fully populated with sample data. Running the .\build samples script may take several minutes to execute. Step 3. Install and Configure Windows Components Verify that the following Windows components are installed and configured: Install IIS 8.0 or IIS 10.0. Configure IIS using the Windows Features function. You can launch it by typing Turn Windows features on or off in the Windows Start menu search box, or by opening the Control Panel and navigating to Programs and Features > Turn Windows features on or off. Verify that IIS is configured with the options shown in the figure below: If you install IIS after Visual Studio you will need to take the following steps to register ASP.NET with IIS: On Windows 10: Uninstall/reinstall ASP.NET 4.5 with IIS using the the Turn Windows Features On/Off dialog or the Server Manager management tool. On versions of Windows prior to Windows 10: Open a command prompt, go to % system_root%\Microsoft.NET\Framework\v4.0.30319, and run the following command: aspnet_regiis -i. Install Windows 8 SDK (available at https://dev.windows.com/en-us/downloads/windows-8-sdk) or Windows 10 SDK (available at https://dev.windows.com/en-us/downloads/windows-10-sdk). Uncheck all options except Windows Development Tools (Windows 8) or Windows Software Development Kit (Windows 10): Install Windows Identity Foundation. Step 4. Configure Internet Information Services Perform the following IIS configuration tasks to configure IIS for secure communications (HTTPS): Launch IIS Manager and click on “Server Certificates”: In the “Action” panel on the right side of the window, click Open Feature. Server Certificates Actions are listed. In the “Action” panel on the right side of the window, click Create Self-Signed Certificate. When prompted, enter a friendly name (e.g. “MY-PC”) for the certificate and click OK. Back in the IIS Manager window, edit the bindings for the default website to use SSL, as shown below: Step 5. Configure Windows Identity Foundation (WIF) Make sure you have installed the Windows Identity Foundation as part of Step 3. Launch the Microsoft Management Console by selecting Start > Run… > mmc.exe. Select File > Add/Remove Snap-in… From the list, select the “Certificates” entry and click Add >. When prompted, select Computer Account, click Next, then select the Local computer option, click Finish, then click OK. Add the STSTestCert certificate to your local machine: From the Console Root, navigate to the Certificates (Local Computer) > Personal > Certificates folder. Right-click on the Certificates node and select All Tasks > Import… Click Next. Locate the “STSTestCert.pfx” file in the C:\Ed-Fi\Dashboard\Logistics\certificates fol der. Change the File Types selection on the dialog to Personal Information Exchange in order to see *.pfx files. Select file, and click Next. When prompted for a password to access the certificate file, leave it empty as the certificate does not have a password, and click Next. Follow the instructions on screen and click Next until you can click Finish. Grant Read access to the IIS_IUSRS group by right clicking on the “STSTestCert” entry in the list and selecting the All Tasks > Manage private keys… menu item. If IIS_IUSRS group is not listed in "Groups or user names," click Add..., enter "iis_iusrs", click OK. The following step is only appropriate for a development workstation, and for test purposes only. Repeat the steps above to also import the STSTestCert into the Certificates (Local Computer) > Trusted Root Certificate Authorities > Certificates folder. This step allows the Dashboards website to trust the certificate used to sign the security tokens issued by the STS web application. Step 6. Configure Visual Studio NuGet Settings and Sources The Ed-Fi Dashboard source code references customized libraries distributed as NuGet packages via a Myget.org feed. You must make some changes to your Visual Studio NuGet settings prior to building the solution. This will enable the NuGet package to restore “missing” dependencies when building the software. The setting to “Allow NuGet to download missing packages during build” is disabled by default and must be enabled. In Visual Studio, select Tools > Nuget Package Manager> Package Manager Settings > General, and make sure the checkbox is selected, as shown below: Select the “Package Sources” node in the tree of the Options dialog, or from within Visual Studio, select Tools > Nuget Package Manager > Package Manager Settings > Package Sources, and uncheck the default NuGet official package source and add a new package source to the Ed-Fi Myget URL (which includes the default nuget.org source, http://www.myget. org/F/d10f0142ad50421a8938b3a9e49977b4/). Step 7. Build and Launch the Dashboards Web Application Launch Visual Studio with UAC off or as Administrator. Open the C:\Ed-Fi\Dashboard\Application\EdFi.sln file in Visual Studio. The first time the solution is opened, you may be prompted to create the virtual directories for the application and for the Security Token Service website. If so, click Yes on both dialogs to automatically create the virtual directories. After the EdFiDashboardDev virtual folder has been created in IIS, set the website’s application pool to load user profiles so that the WIF Security Token Service token can be decrypted properly. Set the application pool used for both web applications to ASP.NET V4.0 (or higher): Ensure the Load User Profile value for the application pool is set to true (or the web application won’t be able to access the certificate needed to validate the security token received from the STS): Back in Visual Studio, click on Build > Rebuild Solution. Next right click on the EdFi.Dashboards.Presentation.Web project in Solution Explorer, and select the Set as StartUp Project menu item. Launch the debugger (F5 on most Visual Studio keyboard configurations). You will probably see a certificate error similar to the following, depending on your browser. Click the option to Continue. You should now see the website’s home page. Click on the Glendale ISD link and then on the resulting web page, click Log In to the Dashboards. At this point, installation is complete and the Dashboards are ready for you to explore. Step 8. Running the Dashboards Once you have the Dashboards set up on a local development machine, you can log in and explore the system as different user types using the credentials that ship with the source code: Grand Bend Sample Data Set Superintendent.
Recommended publications
  • Steps to Disable Or Uninstall Skype for Business Method 1: Disable Skype for Business Via Skype Settings
    Steps to Disable or Uninstall Skype for Business Method 1: Disable Skype for Business via Skype Settings To disable this feature to prevent it from starting up, please following the instruction below. Step 1: Open the Settings of Skype for Business, navigate to the Tools tab and choose the Options option. Step 2: Select the Personal option from the left side, and uncheck Automatically start the app when I log on to Windows 10 and Start the app in the foreground, and then click the OK button to confirm the changes. Step 3: Click the Settings button again on the Skype for Business interface and choose File then Exit. After the three steps, you have successfully disabled Skype for Business from your PC and you will no longer see it although it is still on your computer. Method 2: Uninstall Skype for Business via Control Panel This method requires you to clear all your profile cache for the Skype for Business account and then uninstall it from Windows 10 via Control Panel. Here is the detailed tutorial on uninstalling Skype for Business. Step 1: Open your Skype for business and then sign out of this application. Step 2: In the Sign in interface, please click the Delete my sign-in info option. Note: This step will clear all your profile cache for the Skype for Business account and will disable the auto sign-in when the application opens. Step 3: Close Skype for Business. Step 4: You should uninstall Skype for Business like any other software on your computer. Click on the Windows button in the bottom left of your screen and type Control Panel.
    [Show full text]
  • Opening Skype on Windows 10
    Skype Opening Skype on Windows 10 ................... 1 Making a Video Call ..................................... 3 Checking Your Audio & Video .................... 2 Accepting a Video Call .................................4 Using Skype ................................................. 3 Installing Skype ........................................... 5 Finding Someone ........................................ 3 Opening Skype on Windows 10 1. On a Windows 10 computer, in the lower left corner click the Windows icon. 2. Type in “Skype” and as soon as you see “Skype” click on that selection, and enter your Skype username and password if prompted. If you do not already have a Skype account, you can easily create one—they are free. You can even create a Microsoft account just for Skype at https://outlook.live.com/owa Checking Your Audio & Video 1. Open Skype. 2. In the left pane, in the top right corner, click on the ellipse (…). 3. Your Settings open. 4. In the left pane, select Audio & Video. 5. In the Camera section your live picture should appear. If it does not, see if there is an option above your picture, and try selecting a different web camera. 6. Scroll down until you see the Audio section. Test your microphone and speakers and adjust the volume as needed. 7. Close the dialog box by clicking the X in the top left corner. Using Skype Once you open Skype, you will select someone to call from the left pane. You have some important options there: Search, Chats, Contacts The first couple times you use Skype you may need to search for your friends and family. You can search by name or email address associated with their Skype account.
    [Show full text]
  • Microsoft Windows 10 Update Hello, Microsoft Has Begun
    Subject Line: Microsoft Windows 10 Update Hello, Microsoft has begun pushing a warning message to Windows 10 computers that a critical security update must be performed. Several clients have informed us that they are seeing the warning message. It will appear as a generic blue screen after your computer has been powered up, and it states that after April 10, 2018 Microsoft will no longer support your version of Windows 10 until the critical security update has been performed. Please note if your UAN computer has not been recently connected to the internet, you would not have received this message. UAN has confirmed that the warning message is a genuine message from Microsoft, and UAN strongly encourages all clients to perform this critical security update as soon as possible. Please note: ‐ This update is a Microsoft requirement and UAN cannot stop or delay its roll out. To perform the critical security updated select the ‘Download update’ button located within the warning message. ‐ This update is very large, for those clients that have metered internet usage at their home may want to perform the update at a different location with unmetered high speed internet, perhaps at another family member’s home. ‐ Several UAN staff members have performed the critical security update on their home computers, and the process took more than an hour to complete. To check that your computer has been updated or to force the update at a time that is convenient to you, go to the windows Start button and click on Settings (the icon that looks like a gear above the Start button) > Update and Security > Windows Update > Check for Updates and then follow the instructions on the screen.
    [Show full text]
  • How to Set up Cortana (Or Remove Her) in Windows 10
    How to set up Cortana (or remove her) in Windows 10 Cortana, the personal digital assistant feature in Windows 10, will help you complete tasks, make it to your appointments on time, send messages and emails on your behalf, research the web and even launch applications. Orignally released with the Windows Phone (and named after the AI character from Microsoft's Halo franchise, looks to be a key element in the Windows 10 operating system. To begin the set up process, click or tap the microphone icon in the search bar and say "Hey Cortana" (if listening is enabled), followed by your question or search term. When properly set up Cortana is a powerful digital assistant. Start by clicking into the Cortana search box, and waiting for the results pane to appear. In the top- left corner of this, click the “hamburger” menu and then open Notebook. This tool allows you to determine what information Cortana can gather about you, and the more data she has, the more she can do. Cortana will have already asked you to input your name, but you can change this and more by opening About Me. Here, set the name you want her to use. Under Settings you can enable tracking info by switching on Find flights and more, which analyses your emails for such details. The Settings screen also enables you to toggle whether Cortana responds to “Hey, Cortana” which is very similar to Android’s “OK, Google“–the system will constantly be on the look-out for you saying this phrase, and will open Cortana when it is detected.
    [Show full text]
  • What Is Ipswitch WS FTP Server?
    User Guide Contents CHAPTER 1 WS_FTP Server Overview What is Ipswitch WS_FTP Server? ........................................................................................................................... 1 System requirements .................................................................................................................................................. 1 How FTP works .............................................................................................................................................................. 2 How SSH works.............................................................................................................................................................. 3 Sending feedback......................................................................................................................................................... 3 CHAPTER 2 Learning about WS_FTP Server Manager Understanding the server architecture ................................................................................................................ 5 Understanding the relationship between listeners and hosts..................................................................... 6 Accessing the WS_FTP Server Manager ............................................................................................................... 7 Managing WS_FTP Server remotely.......................................................................................................... 7 Navigating the WS_FTP Server Manager ............................................................................................................
    [Show full text]
  • Quick Guide Page | 1
    Quick Guide Page | 1 Contents Welcome to Windows 10 ................................................................................................................................................................................................... 3 Key innovations ...................................................................................................................................................................................................................... 3 Cortana ................................................................................................................................................................................................................................. 3 Microsoft Edge .................................................................................................................................................................................................................. 4 Gaming & Xbox ................................................................................................................................................................................................................ 5 Built-in apps ....................................................................................................................................................................................................................... 7 Enterprise-grade secure and fast ...................................................................................................................................................................................
    [Show full text]
  • Feature Description
    NTLM Feature Description UPDATED: 19 March 2021 NTLM Copyright Notices Copyright © 2002-2021 Kemp Technologies, Inc. All rights reserved. Kemp Technologies and the Kemp Technologies logo are registered trademarks of Kemp Technologies, Inc. Kemp Technologies, Inc. reserves all ownership rights for the LoadMaster and Kemp 360 product line including software and documentation. Used, under license, U.S. Patent Nos. 6,473,802, 6,374,300, 8,392,563, 8,103,770, 7,831,712, 7,606,912, 7,346,695, 7,287,084 and 6,970,933 kemp.ax 2 Copyright 2002-2021, Kemp Technologies, All Rights Reserved NTLM Table of Contents 1 Introduction 4 1.1 Document Purpose 6 1.2 Intended Audience 6 1.3 Related Firmware Version 6 2 Configure NTLM Authentication 7 2.1 Configure Internet Options on the Client Machine 7 2.2 Configure the LoadMaster 11 2.2.1 Enable NTLM Proxy Mode 13 2.2.2 Configure the Server Side SSO Domain 13 2.2.3 Configure the Client Side SSO Domain 15 2.2.4 Configure the Virtual Service 15 2.3 Configure Firefox to Allow NTLM (if needed) 17 2.4 Troubleshooting 18 References 19 Last Updated Date 20 kemp.ax 3 Copyright 2002-2021, Kemp Technologies, All Rights Reserved NTLM 1 Introduction 1 Introduction NT LAN Manager (NTLM) is a Windows Challenge/Response authentication protocol that is often used on networks that include systems running the Windows operating system and Active Directory. Kerberos authentication adds greater security than NTLM systems on a network and provides Windows-based systems with an integrated single sign-on (SSO) mechanism.
    [Show full text]
  • Web Server IIS Deployment
    https://www.halvorsen.blog ASP.NET Core Web Server IIS Deployment Hans-Petter Halvorsen Introduction • Introduction to IIS deployment • If you have never used ASP.NET Core, I suggest the following Videos: – ASP.NET Core - Hello World https://youtu.be/lcQsWYgQXK4 – ASP.NET Core – Introduction https://youtu.be/zkOtiBcwo8s 2 Scenario Development Environment Test/Production Environment Local PC with Windows 10 Windows 10/Windows Server ASP.NET Core IIS Web Application SQL Server Visual Studio ASP.NET Core SQL Server Express Web Application Visual Studio Web Server • A web server is server software that can satisfy client requests on the World Wide Web. • A web server can contain one or more websites. • A web server processes incoming network requests over HTTP and several other related protocols. • The primary function of a web server is to store, process and deliver web pages to clients. • The communication between client and server takes place using the Hypertext Transfer Protocol (HTTP). • Pages delivered are most frequently HTML documents, which may include images, style sheets and scripts in addition to the text content. https://en.wikipedia.org/wiki/Web_server 4 Web Pages and Web Applications Web Server Client Web Server software, e.g., Internet Information Services (IIS) Request Web Browser, (URL) e.g., Edge, Internet Chrome, Safari, or Local etc. Response Network (LAN) Data- (HTML) base Operating System, e.g., Windows Server PC with Windows 10, macOS or Linux Smartphone with Android or iOS, etc. Web Server Software PHP (pronounced "engine x") Internet Information Services - Has become very popular lately ASP.NET Cross-platform: UNIX, Linux, OS X, Windows, ..
    [Show full text]
  • INSECURE-Mag-9.Pdf
    Another year is almost over and a plethora of information security problems are behind us. To let 2006 go out in style, we bring you a feature packed issue of (IN)SECURE. As the feature interview for this issue we had the pleasure of talking with Kurt Sauer, the CSO at Skype, one of the most well-known companies in the digital world. We’ll be back next year with many new ideas in the pipeline. Stay tuned for coverage from a few conferences including the RSA Conference in San Francisco and the Black Hat Briefings &Training in Amsterdam. If you’re attending, be sure to drop me an e-mail and we’ll grab a drink. We wish you a safe 2007! Mirko Zorz Chief Editor Visit the magazine website at www.insecuremag.com (IN)SECURE Magazine contacts Feedback and contributions: Mirko Zorz, Chief Editor - [email protected] Marketing: Berislav Kucan, Director of Marketing - [email protected] Distribution (IN)SECURE Magazine can be freely distributed in the form of the original, non modified PDF document. Distribution of modified versions of (IN)SECURE Magazine content is prohibited without the explicit permission from the editor. For reprinting information please send an email to [email protected] or send a fax to 1-866-420-2598. Copyright HNS Consulting Ltd. 2006. www.insecuremag.com New enterprise single sign-on authentication software DigitalPersona announced the latest version of its award-winning enterprise product, DigitalPersona Pro 4.0. The new and improved software delivers a complete, accurate and trusted fingerprint Enterprise Single Sign-On (ESSO) solution with more secure authentication, improved manageability and the broadest support available for the world’s leading biometrically-enabled notebooks including models from Lenovo, HP, Dell, and Toshiba.
    [Show full text]
  • Windows XP, Vista, 7 & 8
    Windows XP, Vista, 7 & 8 ExhibitView Version 5.0 Product Guide Please read this document carefully before using ExhibitView 5.0. This document introduces one to the rich features embedded in ExhibitView software. It also acts as a basic reference for someone to get started working on ExhibitView. ExhibitView is free to use for first 14 days. ExhibitView is EASY! FAST! INTUITIVE! Connect your projector. Launch ExhibitView. You are ready for GREAT Presentations. ExhibitView supports wide range of file formats Table of Contents Look for each section below and in order. Section: 1. What's New in ExhibitView 5.0 a. System Requirements b. Installation Requirements c. Overview of ExhibitView 5 d. Known compatibility issues 2. Live Online Training 3. Creating and Saving Projects 4. File Formats Supported 5. Main Interface, The ExhibitView Desktop a. SlideMaker b. Documents c. Images d. Audio/Video e. Web Pages 6. The Presentation Area a. The area you see b. The area the jury sees c. Present side by side or full screen d. Courtroom setup 7. The Tools in the Toolbar 8. Video Controls and Marking on Videos while playing 9. The SlideMaker 10. The Synchronized Video Deposition Viewer 11. Keyboard Shortcuts 12. Help and Contact Information Section 1. What is New in ExhibitView 5.0? The fresh new ExhibitView 5.0 now makes your favorite presentation management system even more powerful, fast and feature rich. The old screens have given to the new rich user interface. The icons are now even easier to locate and use. Navigation is a breeze. ExhibitView 5.0 makes learning fun and easy.
    [Show full text]
  • Outlook Office 365 Search Training
    Outlook Office 365 Search Rylander Consulting www.RylanderConsulting.com [email protected] 425.445.0064 i Outlook Office 365 Search Table of Contents Searching in Outlook Office 365 ..................................................................................................................... 1 Begin a Search............................................................................................................................................ 2 Using the Search Tab ...................................................................................................................................... 4 Scope of Search ......................................................................................................................................... 4 Refine Search ............................................................................................................................................. 5 Search by From or Subject .................................................................................................................... 6 Search for E-mail with Attachments ..................................................................................................... 8 Search Options Group ................................................................................................................................ 9 Recent Searches .................................................................................................................................... 9 Search Tools .........................................................................................................................................
    [Show full text]
  • Students, Faculty and Staff Guide for Windows 10
    Students, Faculty and Staff Guide for Windows 10 Prepared by Information Technology Division Lehman College, CUNY Revised - January 31, 2020 This document was originally prepared by Microsoft. It was modified and adapted for use at Lehman College. Information Technology Division Lehman College, CUNY Guide contents The purpose of this guide is to introduce you to the key features in Windows 10, and give you tips and tricks on how to get started using those features. You’ll find information on the following topics: A few feature highlights Cortana Using Microsoft Office Personalization • Start menu • What can Cortana do? 365 with Windows 10 and Settings • Access your email • A new look • How to search • Cortana’s Notebook • Use Office 365 on • Personalize your lock • Using tiles Microsoft Edge mobile devices screen • Task view • Hub • Use Office 365 with • Get started with themes • Virtual desktops OneDrive for Business to • Web Notes • Change your desktop work with files anywhere • Windows behavior in • Reading List background and color modern applications • Sign in to Office 365 Apps and the • Charms functionality in Setting things up • Create a file action center modern applications • Set up your email and • Share a file calendar • Snap enhancements • Synchronize a file • Change your • Quick access tools account picture • Protect your PC Information Technology Division Lehman College, CUNY A few feature highlights in Windows 10 Windows 10 is designed to please both touch and mouse users. It’s also designed to be intuitive for users of both Windows 7 and Windows 8.1, incorporating the “best of both worlds” to enhance your experience and help you be more productive.
    [Show full text]