BlueWave Web Pages Installation Guide

Modified on Wed, 01 Mar 2023 at 11:31 AM

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: 

http://localhost/ 

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 Next3. 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 Install10. 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: 

http://localhost/ 

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.  



Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article