Web Pages Installation Overview
When installing the BlueWeb web pages there are a few steps that will ensure that this process goes smoothly. The web pages were designed to run against BlueView software version 15.3 or higher. This document is intended for system administrators that already have knowledge about setting up a website on a server.
BlueView software should be installed and configured before installing web pages. A Windows account with Administrator access to the BlueView server and an administrative login to the BlueView software is required for setup.
For Windows Server 2008/2008 R2 or Windows 7
Install IIS7 on the server that will be hosting the web pages
The web pages were developed using Microsoft .Net 4.0, and are designed to run on Internet Information Services(IIS). IIS must be installed on the server that will be hosting the web pages, hereafter referred to as the web server.
1. Click Start, point to Administrative Tools, and then click Server Manager.
2. In Roles Summary, click Add Roles.
3. Use the Add Roles Wizard to add the Web server role.
4. On the Select Role Services page, note the preselected role services that are installed by default, and then select the following additional role services:
• ASP.NET
• .NET Extensibility
• Request Filtering
• ISAPI
• ISAPI Extensions
5. On the Summary of Features to Install page, confirm your selections, and then click Install. 6. On the Installation Results page, confirm that your installation of the Web Server (IIS) role and required role services completed successfully, and then click Close.
6. To verify that IIS installed successfully, type the following into a Web browser: http://localhost/
You should see the default IIS Welcome page.
Once IIS is installed, proceed to the section Setting up the Website.
For Windows 8/8.1/10/11
Install IIS8 on the server that will be hosting the web pages
The web pages were developed using Microsoft .Net 4.0, and are designed to run on Internet Information Services(IIS).
1. IIS in Windows is an optional “Windows Feature.” To install it, on the Start Page, click the Control Panel tile. In the Control Panel, click Programs, then click Turn Windows features on or off.
2. Click on the Internet Information Services check box.
3. Check additional features as shown below.
4. It may take some time for the features to be enabled. To verify that IIS installed successfully, type the following into a Web browser:
You should see the default IIS Welcome page.
Once IIS is installed, proceed to the section Setting up the Website on page 6.
For Windows Server 2012/2012 R2
Install IIS8 on the server that will be hosting the web pages
On the Start page, click the Server Manager tile, and then click OK.
1. In Server Manager, select Dashboard, and click Add roles and features.
2. In the Add Roles and Features Wizard, on the Before you begin page, click Next. 3. On the Select installation type page, select Role-based or feature-based installation, and click Next. 4. On the Select destination server page, select Select a server from the server pool, select your server, and click Next.
5. On the Select server roles page, select Web Server (IIS), and click Next.
6. On the Select features page, click Next.
7. On the Web Server Role (IIS) page, click Next.
8. On the Select role services page, note the preselected role services that are installed by default, expand the Application Development node, and then select ASP.NET 4.5.
9. On the Summary of Features to Install page, confirm your selections, and then click Install. 10. In the Add features that are required for ASP.NET 4.5? box, click Add Features.
11. The following additional features are added:
• .NET Extensibility 4.5
• ISAPI Extensions
• ISAPI Filters
12. Click Next.
13. On the Confirm installation selections page, click Install.
14. On the Installation progress page, confirm that your installation of the Web Server (IIS) role and required role services completed successfully, and then click Close.
15. To verify that IIS installed successfully, type the following into a Web browser:
You should see the default IIS Welcome page
Once IIS is installed, proceed to the section Setting up the Website on page 6.
Setting up the Website
Now that IIS has been installed on your computer, open the application. It can be found in the Windows Start menu under Administrative Tools, or by searching from the Windows Start screen for “IIS.” The official name of the application is Internet Information Services (IIS) Manager.
Create an app pool on the web server to run the web site
Under the Application Pools section create a new application pool for the BlueWeb web pages. Name the application pool ‘BlueWebAppPool’.
When creating the Application Pool the .NET Framework version must be set to ‘.NET Framework v4.0.30319’, Managed pipeline mode is set at ‘Integrated’, and the Start application pool immediately is checked.
Create a website
There are a couple of different ways to set up the BlueWave web interface in IIS, either by creating a new website on the default port 80 for the application or using the default website.
For the first approach, you will first need to stop the default site (Default Web Site → Manage Website → Stop) and/or change the port it's using to something other than 80 (select Default Web Site, then click on Bindings under Edit Site.)
Under ‘Sites’ create a new web site by right clicking on ‘Sites’ then ‘Add Web Site.’ Choose a name for the site (we recommend BlueWeb), and then select the Application Pool created above. Browse to the physical path for the web site, which by default is C:\Program Files\BlueView\BlueWeb. Click OK.
6/10
Set up access to SQL Server for the web site
In the BlueView software, go to Tools → Database Configuration. If your database connection is configured to use Integrated Security, it needs to be changed to use a SQL Server login. Click on the Create SQL Login button to create one. When you are done, click Apply, let the system confirm the settings again, and then Close. Open a browser of your choice on the web server and point it to http://localhost/ . You should see the BlueWeb login screen. It should look like this:
Log in with the same user name and password that is used to log in to the BlueView application Once the Login page is displayed, log in to the web pages with the same user name and password that is used to log in to the BlueView application. The default administrative login is User Name admin and Password a1. To configure other logins, go to Tools → Login Administration in BlueView.
Set permissions on the website directories
We need to provide the ApplicationPool for the website write access to the files in the web site's directory. This is used when uploading pictures for new People from the website.
In Windows Explorer, navigate to the physical path of the website. Typically, it will be C:\Program Files\BlueView\BlueWeb. Right-click on the BlueWeb directory and select Properties. Then click on the Security tab. Click Edit to edit the permissions, and then Add to add a new permission. In the Add screen, under Enter the object names to select, type IIS AppPool\BlueWebAppPool.
Note: On some versions of Windows, the application pool name will fail “Check Names.” This is okay. Just type the name in the box and then click OK and it will add it without doing the check.
Click OK to add the user, then back on the Permissions for BlueWeb, select BlueWebAppPool and check the box next to “Write.” Then click OK to return to the BlueWeb Properties dialog.
Once the Application Pool has been given the appropriate level of access, click on the General tab and uncheck the Read Only box. Click OK.
You will be prompted that you are going to apply this change to all subfolders as well. Click OK again. On some versions of Windows, you may also be prompted to provide administrator permission to change these attributes. Click Continue.
Configure Windows firewall to allow access to BlueWeb
In Windows on the web server, go to Control Panel → System and Security → Firewall. Click Allow a program or feature through the Windows Firewall. Make sure World Wide Web Services (HTTP) is checked for all applicable networks.
At this point the BlueWeb web pages should be running on the web server. Provided that the local network is configured to allow it, the web pages can be accessed from other machines on the network using the web server's machine name or IP address.
Troubleshooting
If during the last step you encountered an error while logging in to the web site, the issue might be the permissions to the database and/or the path to the database. Double check these settings from the Database Configuration screen inside the BlueView software.
A few other things you can try:
• Look for more information about errors in the Windows Event Logs and in the BlueWeb logs. To find the BlueWeb logs, in BlueView, go to Tools → Open Log File Location. The web logs are usually named w3wp.log and w3wp.transactions.log and can be opened with Notepad (or another text editor) or BareTail (live log viewer).
• If you get the error “Policy Exception: Required permissions cannot be acquired” on one of the Microsoft Enterprise Library dlls, in IIS go to the Advanced Settings for your application pool. Under “Process Model,” set Load User Profile to true.
• Reset the web site by right-clicking on the web site in IIS, choosing Manage Web Site and then Restart. • Also in IIS, under Application Pools, right-click on BlueWebAppPool and select Recycle. • Make sure the computer is fully up to date with Windows Updates, and then reboot it. • Make sure the web browser used to access BlueWeb is set to accept cookies.
• Try a different web browser (Internet Explorer, Firefox, Chrome, Safari), to see if the problem is browser-related.
• If you have trouble accessing BlueWeb from other machines, check the firewall settings on the server.