Versions Compared

Version Old Version 30 New Version Current
Changes made by

Anand Rajaraman

Emmanuel Morales

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

..Before installing and using the Velocity Web Services Client, you must first install Microsoft’s Internet Information Services (IIS) on your Velocity WorkstationServer, Velocity ServerWorkstation, or dedicated IIS Server.

...

For details about the Windows versions supported by recent Velocity releases, please look at refer to Step 4 in the Introduction topic below.

The details for installing IIS to support the Velocity Web Services Client vary somewhat for each version of Windows; that this information is provided in the appropriate version of the Velocity Web Services Client Installation Guide and Release Notes. For your convenience, this topic provides procedures for installing IIS on Windows 10\11 Pro, Windows Server 2016, 2019, and Windows Server 20192022.

System Requirements

This version of the Velocity Web Services Client requires the following components:

  • A physical access control system with various hardware components controlled by version Velocity 3.8.5 of the Hirsch Velocity security management system software6

  • The optional Velocity Web Services Client software

  • A Web Server running Microsoft’s Internet Information Services (IIS) (version 6.0 or later)

  • A For optimal performance, use a personal computer , tablet computer, or smartphone running a relatively current Web browser such asor tablet with a modern web browser. Recommended browser versions are:

    • Google’s Chrome minimum version is 45 (64-bit): Minimum version 118.0 but ; recommended is 110version 124.0 or later

    • Microsoft’s Edge minimum version is 18 (64-bit): Minimum version 117.0 but ; recommended is 110version 120.0 or later

    • Mozilla’s Firefox (64-bit): minimum version is 34119.0 but ; recommended is 110version 124.0 or later

    • Apple’s Safari minimum version is 10.0, but it is recommended to be 16.0

...

    • (64-bit): Minimum version 17.0; recommended version 17.4 or later

Hirsch recommends using Google Chrome (64-bit) with a device display resolution of 1024 1280 x 768720 px. ( At a lower resolution, you will not be able to see part of an extensive dialog resolutions, parts of large dialogs, such as Credential Properties) , may not be fully visible.

Infonote

Microsoft Internet Explorer is no longer supported.

...

Prerequisites

The optional Velocity Web Services Client can be installed either as part of a full Velocity 3.8.5 during a new Velocity installation or separately after the Velocity installation. After installing this client, you must also perform a few configuration and setup tasks.

Info

To install the Velocity Web Services Client, you must be logged into Windows using an account with administrator privileges, and you must know the name and password of the Velocity Services account (specified during the Velocity installation).

The Velocity Web Services Client must only is ONLY needed to be installed on your the server.  If you want to install and use this optional client, you must first install Microsoft’s Internet Information Services (IIS).  The installer checks your system to see whether all prerequisites have been met.

Installing Microsoft’s Internet Information Services (IIS)

Before installing and using the Velocity Web Services Client, you must first install Microsoft’s Internet Information Services (IIS) on your standalone WorkstationVelocity Server, Velocity ServerWorkstation, or dedicated IIS Server. 

The following table shows which versions of Windows are supported by Velocity 3.8.5 for those computer table below lists the supported Windows versions for each of these system roles.

System Role

The Windows versions supported

version of Windows

by Velocity 3.8.

5

6

Velocity Server or Dedicated IIS Server

  • Windows Server 2022

  • Windows Server 2019

  • Windows Server 2016

Velocity Standalone Workstation

  • Windows Server 2022

  • Windows Server 2019

  • Windows Server 2016

  • Windows 11 Pro

  • Windows 10 Pro

Tip

The following procedures

...

outline how to install IIS on: Windows

...

11 Pro, Windows

...

10 Pro, and Windows Server

...

2022,

...

2019, and

...

2016.

Installing IIS on Windows 10 Pro

  1. Open the Control Panel and click on Programs.

  2. Locate and click on the “Turn Under Programs and Features, select Turn Windows Features on or off” linkoff.

  3. In the resulting Windows Features dialog, expand the folders for .NET Framework 3.5 (includes .NET 2.0 and 3.0), the .NET Framework 4.7 Advanced Services, and the Internet Information Services folders to reveal view the available options.

  4. Check [√]Select the following set of options, and then click OK. (Most of these options are shown in the subsequent screen capture.)features to install IIS and additional IIS Management features.

    • .NET Framework 3.5 (includes .NET 2.0 and 3.0).NET Framework 3.5 (includes .NET 2.0 and 3.0) >

      • (tick) Windows Communication Foundation HTTP Activation

      • (tick) Windows Communication Foundation Non-HTTP Activation

    • .NET Framework 3.5 (includes .NET 2.0 and 3.0) > Windows Communication Foundation Non-HTTP Activation.NET Framework 4.7 Advanced Services > 4.7 Advanced Services

      • (tick) ASP.NET 4.7

      NET Framework 4.7 Advanced Services >

      • WCF Services

      >

        • (tick) TCP Port Sharing

      Internet Explorer 11

    • Internet Information Services >

      • Web Management Tools

      > Internet Information Services > Web Management Tools > IIS 6 Management Compatibility >

        • IIS 6 Management Compatibility

    • Internet Information Services > Web Management Tools > IIS 6 Management Compatibility > IIS 6 Management Console

          • (tick) IIS 6 Management Console

          • (tick) IIS 6 Scripting Tools

      Internet Information Services > Web Management Tools >

          • (tick) IIS 6

      Management Compatibility > IIS 6

          • WMI Compatibility

      Internet Information Services > Web Management Tools > IIS 6 Management Compatibility >

          • (tick) IIS 6 Metabase and IIS 6 configuration compatibility

      Internet Information Services > Web Management Tools >

        • (tick) IIS Management Console

      Internet Information Services >

      • World Wide Web Services

      >

        • Application Development Features

      >

          • (tick) .NET Extensibility 3.5

      Internet Information Services > World Wide Web Services > Application Development Features >

          • (tick) .NET Extensibility 4.7

      Internet Information Services > World Wide Web Services > Application Development Features >

          • (tick) ASP.NET 3.5

      Internet Information Services > World Wide Web Services > Application Development Features > Internet Information Services > World Wide Web Services > Performance Features >

          • (tick) ASP.NET 4.7

    • Internet Information Services > World Wide Web Services > Application Development Features > ISAPI Extensions

    • Internet Information Services > World Wide Web Services > Application Development Features > ISAPI Filters

    • Internet Information Services > World Wide Web Services > Application Development Features > Web Socket Protocol

    • Internet Information Services > World Wide Web Services > Common HTTP Features > Default Document

    • Internet Information Services > World Wide Web Services > Common HTTP Features > HTTP Errors

    • Internet Information Services > World Wide Web Services > Common HTTP Features > Static Content

          • (tick) ISAPI Extensions

          • (tick) ISAPI Filters

          • (tick) WebSocket Protocol

      • Common HTTP Features

        • (tick) Default Document

        • (tick) HTTP Errors

        • (tick) Static Content

      • Performance Features

        • (tick) Static Content Compression

          Image Modified

Enabling the WebSocket Protocol option manually in IIS increases feature is required to increase the efficiency of the web application.

...

  1. Click OK and wait a few moments for the features to install.

  2. When prompted, restart your PC to apply the changes.

Installing IIS on Windows 11 Pro

  1. Click on the Search icon given on the Windows 11 Taskbar.

  2. Enter features and select the option “Turn Windows features on or off“.

    Image Removed

    This will open the Window Features dialog to enable the different in-built options of Windows 11 including the Internet Information Services (IIS).

    Image Removed

    From the list of the options, click the box given for Internet Information Services Web Management Tools-> World Wide Web Services to select them.

    Image Removed

  3. This installs IIS along with other IIS Management Console Application features.

  4. Click on the OK button.
    Wait for a few seconds for the features to get installed and then a dialog asks you to restart your PC.

  5. Reboot your system for the changes to occurOpen the Control Panel and click on Programs.

  6. Under Programs and Features, select Turn Windows Features on or off.

  7. In the Windows Features dialog, expand the folders for the .NET Framework 4.8 Advanced Services, and Internet Information Services to view the available options.

  8. Select the following features to install IIS and additional IIS Management features.

    • .NET Framework 4.8 Advanced Services

      • (tick) ASP.NET 4.8

      • WCF Services

        • (tick) TCP Port Sharing

    • Internet Information Services

      • Web Management Tools

        • IIS 6 Management Compatibility

          • (tick) IIS 6 Management Console

          • (tick) IIS 6 Scripting Tools

          • (tick) IIS 6 WMI Compatibility

          • (tick) IIS 6 Metabase and IIS 6 configuration compatibility

        • (tick) IIS Management Console

        • (tick) IIS Management Scripts and Tools

      • World Wide Web Services

        • Application Development Features

          • (tick) .NET Extensibility 3.5

          • (tick) .NET Extensibility 4.8

          • (tick) ASP.NET 3.5

          • (tick) ASP.NET 4.8

          • (tick) ISAPI Extensions

          • (tick) ISAPI Filters

          • (tick) WebSocket Protocol

        • Common HTTP Features

          • (tick) Default Document

          • (tick) Directory Browsing

          • (tick) HTTP Errors

          • (tick) Static Content

        • Performance Features

          • (tick) Static Content Compression

  9. Click OK and wait a few moments for the features to install.

  10. When prompted, restart your PC to apply the changes.

Installing IIS on Windows Server 2016

  1. Open Control Panel.

  2. Locate and click on the “Turn Windows Features on or off” link.

  3. In the resulting Server Manager window, click the Features item (in the left pane) and click the Add Features link.

  4. In the resulting Add Roles and Features Wizard, provide the necessary information and click Next on each of the first few pages.

  5. On the Select server roles page of the wizard, check [√]the Web Server (IIS) role, and click Next.

  6. In the resulting dialog that asks ‘Add features that are required for Web Server (IIS)?’, check[√] the option to ‘Include management tools (if applicable),’ and click the Add Features button.

  7. On the Select features page of the wizard, check [√]the following options (as shown in the screen capture), and click Next.

    • .NET Framework 3.5 Features

    • .NET Framework 3.5 Features > .NET Framework 3.5 (includes .NET 2.0 and 3.0)

    • .NET Framework 4.6 Features > ASP.NET 4.6

    • .NET Framework 4.6 Features > WCF Services > TCP Port Sharing

  8. Read the displayed information on the wizard's resulting Web Server Role (IIS) page and click Next.

  9. On the wizard's resulting Select role services page, check [√] the following options (as shown in the subsequent screen capture), and click Next.

    • Web Server

    • Web Server > Common HTTP Features

    • Web Server > Common HTTP Features > Default Document

    • Web Server > Common HTTP Features > Directory Browsing

    • Web Server > Common HTTP Features > HTTP Errors

    • Web Server > Common HTTP Features > Static Content

    • Web Server > Common HTTP Features > HTTP Redirection

    • Web Server > Health and Diagnostics

    • Web Server > Health and Diagnostics > HTTP Logging

    • Web Server > Performance

    • Web Server > Performance > Static Content Compression

    • Web Server > Security

    • Web Server > Security > Request Filtering

    • Web Server > Application Development

    • Web Server > Application Development > .NET Extensibility 3.5

    • Web Server > Application Development > .NET Extensibility 4.6

    • Web Server > Application Development > ASP.NET 3.5

    • Web Server > Application Development > ASP.NET 4.6

    • Web Server > Application Development > ISAPI Extensions

    • Web Server > Application Development > ISAPI Filters

    • Management Tools

    • Management Tools > IIS Management Console

    • Management Tools > IIS 6 Management Compatibility

    • Management Tools > IIS 6 Management Compatibility > IIS 6 Metabase Compatibility

    • Management Tools > IIS 6 Management Compatibility > IIS 6 Management Console

    • Management Tools > IIS 6 Management Compatibility > IIS 6 Scripting Tools

    • Management Tools > IIS 6 Management Compatibility > IIS 6 WMI Compatibility

    • Management Tools > IIS Management Scripts and Tools

  10. On the wizard's resulting Confirm installation selections page, check [√] the option to ‘Restart the destination server automatically if required, and review the displayed information to determine whether it is correct.

    • If something is not correct, click Previous to return to the previous page and make the necessary changes.

    • If everything is correct, click Install.

      Progress messages on the Installation progress page of the wizard are displayed until the installation is complete.

  11. Verify that the Web Server (IIS) role was installed in the Server Manager window. You can then close the Server Manager window and the Control Panel.

Installing IIS on Windows Server 2019

  1. Open Control Panel.

  2. Locate and click on the ‘ Programs and Features' link.

  3. Once in the Programs and Features window, click on the “Turn Turn Windows Features on or off” off link.

  4. In the resulting Server Manager window, click the Dashboard item (in the left pane), and click the Add roles and features link.

  5. In the resulting Add Roles and Features Wizard | Before you Begin, click Next.

  6. Select Role-based or feature-based installation in the Add Roles and Features Wizard | Installation Type, and click Next.

  7. In the resulting Add Roles and Features Wizard | Server Selection, select a server from the server pool and click Next.

  8. In the resulting Add Roles and Features Wizard | Server Roles, select Web Server (IIS).

  9. In the resulting dialog that asks ‘Add features that are required for Web Server (IIS)?’, check [√] the option to ‘ Include management tools (if applicable), ’ and click the Add Features button, then click Next.

  10. On the Select features page of the wizard, check [√] the following options (as shown in the screen capture), and click Next.

    • .NET Framework 3.5 Features

    • .NET Framework 3.5 Features > .NET Framework 3.5 (includes .NET 2.0 and 3.0)

    • .NET Framework 4.7 Features

    • .NET Framework 4.7 Features > .NET Framework 4.7 (Installed)

    • .NET Framework 4.7 Features > WCF Services > TCP Port Sharing (Installed)

  11. In the resulting Add Roles and Features Wizard | Web Server Role (IIS), read the displayed information, and click Next.

  12. On the wizard's resulting Select role services page, check [√] the following options (as shown in the subsequent screen capture), and click Next..

    • Web Server

      • Web Server > Common HTTP Features

      • Web Server > Common HTTP Features > Default Document

      • Web Server > Common HTTP Features > Directory Browsing

      • Web Server > Common HTTP Features > HTTP Errors

      • Web Server > Common HTTP Features > Static Content

      • Web Server > Common HTTP Features > HTTP Redirection

      • Web Server > Health and Diagnostics

      • Web Server > Health and Diagnostics > HTTP Logging

      • Web Server > Performance

      • Web Server > Performance > Static Content Compression

      • Web Server > Security

      • Web Server > Security > Request Filtering

      • Web Server > Application Development

      • Web Server > Application Development > .NET Extensibility 3.5

      • Web Server > Application Development > .NET Extensibility 4.7

      • Web Server > Application Development > ASP.NET 3.5

      • Web Server > Application Development > ASP.NET 4.7

      • Web Server > Application Development > ISAPI Extensions

      • Web Server > Application Development > ISAPI Filters

    • Management Tools

      • Management Tools > IIS Management Console

      • Management Tools > IIS 6 Management Compatibility

      • Management Tools > IIS 6 Management Compatibility > IIS 6 Metabase Compatibility

      • Management Tools > IIS 6 Management Compatibility > IIS 6 Management Console

      • Management Tools > IIS 6 Management Compatibility > IIS 6 Scripting Tools

      • Management Tools > IIS 6 Management Compatibility > IIS 6 WMI Compatibility

      • Management Tools > IIS Management Scripts and Tools

        Image Modified

  13. On the wizard's resulting Confirm installation selections page, check [√] the option to ‘ Restart the destination server automatically if required, and review the displayed information to determine whether it is correct.

    • If something is not correct, click the Previous to return to the previous page and button to make the necessary changes.

    • If everything is correct, click the Install. button

  14. Progress messages on the Installation progress page of the wizard are displayed until the installation is complete.

  15. Verify that the Web Server (IIS) role was installed in the Server Manager window . You can and then close the Server Manager window and the Control Panel.

Installing IIS on Windows Server 2022

  1. Open Control Panel.

  2. Locate and click on the ‘ Programs and Features' link.

  3. Once in the Programs and Features window, click on the 'Turn Windows Features on or off link.

  4. In the resulting Server Manager window, click the Dashboard item (in the left pane), and click the Add roles and features link.

  5. In the resulting Add Roles and Features Wizard | Before you Begin, click Next.

  6. Select Role-based or feature-based installation in the Add Roles and Features Wizard | Installation Type, and click Next.

  7. In the resulting Add Roles and Features Wizard | Server Selection, select a server from the server pool, and click Next.

  8. In the resulting Add Roles and Features Wizard | Server Roles, select Web Server (IIS).

  9. In the resulting dialog that asks ‘Add features that are required for Web Server (IIS)?’, check [√] the option to ‘ Include management tools (if applicable), ’ and click the Add Features button, then click Next.

  10. On the Select features page of the wizard, check [√] the following options (as shown in the screen capture), and click Next.

    • .NET Framework 3.5 Features

    • .NET Framework 3.5 Features > .NET Framework 3.5 (includes .NET 2.0 and 3.0)

    • .NET Framework 4.8 Features

    • .NET Framework 4.8 Features > .NET Framework 4.8 (Installed)

    • .NET Framework 4.8 Features > WCF Services > TCP Port Sharing (Installed)

  11. In the resulting Add Roles and Features Wizard | Web Server Role (IIS), read the displayed information, and click Next.

  12. On the wizard's resulting Select role services page, check [√] the following options (as shown in the subsequent screen capture), and click Next.

    • Web Server

      • Web Server > Common HTTP Features

      • Web Server > Common HTTP Features > Default Document

      • Web Server > Common HTTP Features > Directory Browsing

      • Web Server > Common HTTP Features > HTTP Errors

      • Web Server > Common HTTP Features > Static Content

      • Web Server > Common HTTP Features > HTTP Redirection

      • Web Server > Health and Diagnostics

      • Web Server > Health and Diagnostics > HTTP Logging

      • Web Server > Performance

      • Web Server > Performance > Static Content Compression

      • Web Server > Security

      • Web Server > Security > Request Filtering

      • Web Server > Application Development

      • Web Server > Application Development > .NET Extensibility 3.5

      • Web Server > Application Development > .NET Extensibility 4.8

      • Web Server > Application Development > ASP.NET 3.5

      • Web Server > Application Development > ASP.NET 4.8

      • Web Server > Application Development > ISAPI Extensions

      • Web Server > Application Development > ISAPI Filters

      • Web Server > Application Development > WebSocket Protocol

    • Management Tools

      • Management Tools > IIS Management Console

      • Management Tools > IIS 6 Management Compatibility

      • Management Tools > IIS 6 Management Compatibility > IIS 6 Metabase Compatibility

      • Management Tools > IIS 6 Management Compatibility > IIS 6 Management Console

      • Management Tools > IIS 6 Management Compatibility > IIS 6 Scripting Tools

      • Management Tools > IIS 6 Management Compatibility > IIS 6 WMI Compatibility

      • Management Tools > IIS Management Scripts and Tools

        Image Modified

  13. On the wizard's resulting Confirm installation selections page, check [√] the option to ‘ Restart the destination server automatically if required, and review the displayed information to determine whether it is correct.

    • If something is not correct, click the Previous to return to the previous page and button to make the necessary changes.

    • If everything is correct, click the Install. button

  14. Progress messages on the Installation progress page of the wizard are displayed until the installation is complete.

  15. Verify that the Web Server (IIS) role was installed in the Server Manager window . You can and then close the Server Manager window and the Control Panel.

Configuring the

...

Network Port used by the

...

Default IIS Web

...

Site

The Velocity Web Services Client works like a typical Web page and connects to Microsoft’s IIS using the HTTP protocol. The default network port is 80, which some other programs might already be using.

...

  1. From your Windows Server Start menu (on the computer where IIS and the Velocity Server are installed), select Administrative Tools ▶ > Internet Information Services (IIS) Manager.

  2. In the Connections pane of the Internet Information Services (IIS) Manager window, expand the computer name, expand Sites, and then click on Default Web Site.

  3. In the Actions pane (under Edit Site), click on Bindings.

  4. In the resulting Site Bindings dialog, click the HTTP entry, and then click on Edit.

  5. In the resulting Edit Site Bindings dialog, enter the desired value (such as 8080) for the Port, and click OK.

  6. Close the Site Bindings dialog.

  7. In the Actions pane of the Internet Information Services (IIS) Manager window (under Manage Web Site), click Stop, and then Start.

Ensuring that the Network Port used by the Default IIS Web Site is Allowed Through Your Firewalls

Because the Velocity Web Services Client communicates across a shared network (instead of a dedicated physical security network), you will have to work with your network administrator to ensure that the network port used by the default Default IIS Web site Site is allowed through your firewalls. Some networks use the software firewall provided with Microsoft Windows, others use a software firewall provided by a different vendor (as shown in the following image), and high-security networks include hardware firewalls.

...

Because the firewalls on a network can vary so much, we cannot provide a detailed procedure for your specific network.  But the following example for the Windows 7 Windows 10 Pro Firewall should help illustrate the general process.

  1. Open the Windows 10 Control Panel, and click on the Windows Firewall link.

  2. Click on the Advanced settings link (in the left column).

  3. In the resulting Windows Firewall with Advanced Security window, click on Inbound Rules (in the left pane), and then click on New Rule… in the Actions pane.

  4. Select the Port option on the Rule Type page of the resulting New Inbound Rule Wizard, and then click Next.

  5. On the Protocol and Ports page, select the TCP option, select the Specific local ports option, enter the desired value (such as 8080), and click Next.

  6. On the Action page, click Next to accept the defaultsdefault selection.

  7. On the Profile page, click Next to accept the defaultsdefault selections.

  8. On the Name page, enter the required name in the Name field, optionally enter a description in the Description field, and click Finish.
    This allows the Network Port used by the Default IIS Web Site through your Firewalls.