BCPro Installation Instructions Code No. LIT Software Release 3.0 Issued September 2017

Transcription

1 Code No. LIT Software Release 3.0 Issued September 2017 Welcome...2 Summary of Changes...2 Related Documentation...2 Installation Overview...2 Prerequisite Software Checklist for Installation or Upgrade...2 Installing BCPro Software...3 Windows Enabling ASP.NET...4 Checking for and Installing the Windows Software DST Update...5 Configuring the Windows Firewall for Windows Windows Installing Microsoft.NET Framework 3.5 Features with Internet Connection...12 Installing Microsoft.NET Framework 3.5 Features without Internet Connection...13 Enabling ASP.NET...13 Checking for and Installing Windows Software DST Update for Windows Configuring the Windows Firewall for Windows Windows Installing Microsoft.NET Framework 3.5 Features with Internet Connection...22 Installing Microsoft.NET Framework 3.5 Features without Internet Connection...23 Enabling ASP.NET...23 Checking for and Installing Windows Software DST Update for Windows Configuring the Windows Firewall for Windows BCPro Software...32 Installing the BCPro Software...32 Uninstalling the BCPro UI Software...36 Licensing the BCPro Workstation Software...38 Launching the BCPro Workstation...39 Logging in to the BCPro UI...41 Appendix: Installing Antivirus Software...42 Installing and Configuring Symantec Endpoint Protection Software...42 Installing and Configuring McAfee VirusScan Enterprise Software...49 Appendix: Troubleshooting BCPro Software...53 BCPro Troubleshooting

2 Welcome Welcome to the BCPro software. This document describes how to prepare your computer for accepting the BCPro software. This document then covers how to install the software. Summary of Changes The following information is new or revised: Updated for Release 3.0. Replaced screens to reflect Release 3.0 Updated the following: Windows 8 - Installing Microsoft.NET Framework 3.5 Features with Internet Connection - Installing Microsoft.NET Framework 3.5 Features without Internet Connection Windows 10 - Installing Microsoft.NET Framework 3.5 Features with Internet Connection - Installing Microsoft.NET Framework 3.5 Features without Internet Connection Installing the BCPro Software Uninstalling the BCPro UI Software Related Documentation The following table lists documentation related to BCPro software. Table 1: Related Documentation For Information On See Document LIT or Part Number License Activation Using the BCPro User Interface Software License Activator Technical Bulletin BCPro User Guide LIT Contact your local branch office. Installation Overview This section is an overview to the installation of the BCPro and BCPro UI software for Release 3.0. If you are installing this software for the first time, review the Prerequisite Software Checklist for Installation or Upgrade to verify that you have the computer software required to run the BCPro Workstation and BCPro UI software. Prerequisite Software Checklist for Installation or Upgrade Review the following table to verify that you have the computer software required to run BCPro software. The table also indicates where you can obtain each software component. Table 2: Prerequisite Software Checklist for BCPro Software Software Component Where to Obtain Operating System Windows 7, with SP1, 64-bit, x64 Platform Microsoft Corporation (Professional, Enterprise, or Ultimate Edition) Windows 8.1, 64-bit, x64 Platform Microsoft Corporation (Professional, Enterprise, or Ultimate Edition) Windows 10, 64-bit, x64 Platform Microsoft Corporation (Professional or Enterprise Edition) 2

3 Table 2: Prerequisite Software Checklist for BCPro Software Software Component Where to Obtain Operating System Components Internet Information Services (IIS) 7.0 (included with operating system) Microsoft Message Queuing (MSMQ) 1 Microsoft Windows PowerShell 2.0 or Operating system media Miscellaneous Daylight Saving Time (DST) Patch for Operating Systems Windows Internet Explorer 11 Operating system media Note: Microsoft Edge, the default browser for Windows 10, does not function with BCPro software. Use Internet Explorer 11 instead. Private Java Runtime Environment (JRE) SAP Crystal Reports Runtime Engine for.net Framework 4.0 (Version ) Microsoft Office Excel 2007 or later Installed by Launcher Installed during BCPro software installation Microsoft Corporation 1 Required for BCPro Workstation software. 2 Required for SQL Server Management Studio Express software. PowerShell for Windows 7 is a built-in feature; no download is required. Installing BCPro Software 1. Verify or install a supported operating system with required service pack, then install and configure all other necessary operating system components. Depending on your operating system, see, Windows 8.1, or Windows Create a full disk image backup of the computer's hard drive to external media before installing BCPro and software (optional but recommended). 3. Install the BCPro software, which includes the BCPro Workstation and BCPro UI in a single software installation package. See Installing the BCPro Software. 4. Create a full disk image backup of the computer's hard drive to external media after installing BCPro Workstation and BCPro UI software (optional but recommended). 3

4 Windows 7 Important: The Windows 7 computer that you want to use for BCPro Workstation or BCPro UI software must have had the operating system installed on a cleanly formatted hard disk. Do not use a computer that was upgraded from a previous version of Windows (for example, upgraded to Windows 7 from Windows XP). The Windows upgrade process can leave behind files and registry settings that may adversely affect the installation of BCPro Workstation or BCPro UI system software. To verify correct settings, make sure a folder called WINDOWS.OLD does not exist on the hard disk. If the WINDOWS.OLD folder is present, reinstall Windows 7 from the media, making sure the hard disk is formatted prior to operating system installation. Verify all necessary software drivers are available before the hard disk is reimaged. For BCPro Workstation or BCPro UI software, we currently support Windows 7 with SP1 (64-bit), in any of these editions: Professional, Enterprise, or Ultimate. Other Windows 7 editions are not supported. The section that follows explains how to install, verify, and configure the Windows 7 components that the BCPro Workstation or BCPro UI software requires. The required components include: Internet Information Services (IIS) ASP.NET SNMP Message Queuing (MSMQ) The last two sections describe how to enable ASP.NET and configure the Windows firewall. Enabling ASP.NET 1. In Control Panel, select System and Security, then Administrative Tools. 2. In Administrative Tools, double-click Internet Information Services (IIS) Manager in the right pane. The Internet Information Services (IIS) Manager window appears. 3. In the tree on the left, select the name of the local computer. When you select the computer, the message Do you want to get started with MS Web Platform may appear. Click No to continue. The middle pane refreshes to show an IIS configuration screen. 4. In the middle pane, locate the IIS section and double-click the ISAPI and CGI Restrictions icon. Verify that the following items are allowed: ASP.NET v and ASP.NET v If these items are not allowed, select each one and click Allow. You can ignore the Common Gateway Interface (CGI) module alert in the upper-right pane. Figure 1: ASP.NET Configuration 6. Close all windows. 7. Go to Checking for and Installing the Windows Software DST Update. 4

5 Checking for and Installing the Windows Software DST Update 1. In Control Panel, click Programs > Programs and Features, then select View Installed Updates in the left pane of the window. 2. Click the Name column to sort the list alphabetically and type KB in the search box. Figure 2: Installed Updates - Windows 7 Example 3. In the Microsoft Windows section, look for the following: Update for Microsoft Windows (KB ) 4. If you do not find KB , continue to Step 5. If you do find KB , go to Configuring the Windows Firewall for Windows Close the View Installed Updates screen. 6. Using a web browser, navigate to Note: You can also search for the update number on 7. Use the instructions on the Microsoft Corporation page to download and install the update for Windows 7. Note: If a message appears at the start of installation that indicates the update is not applicable to your computer, the update may have been installed during an automatic Windows update session. In some cases, the update was installed but KB does not show up as an installed update. Click OK to the user message and disregard this DST update. 8. Close all windows. 9. Go to Configuring the Windows Firewall for Windows 7. Configuring the Windows Firewall for Windows 7 Note: As a best practice, enable the Windows Firewall as indicated in this section, but always follow the recommendation of the customer's local IT staff. Some customers may not require enabling the Windows Firewall. 1. In Control Panel, click System and Security, then click Windows Firewall. The Windows Firewall window appears. 2. In the Windows Firewall window, make sure the firewall is On. If not, turn on the Windows Firewall. 5

6 Note: An anti-virus program might be managing the firewall. For example, if the computer uses Symantec anti-virus software, the message These settings are managed by vendor application Symantec Endpoint Protection may appear on the Windows Firewall screen. In this case, consult the local IT department for further direction, then continue to Step 3. Figure 3: Windows Firewall 3. Click Advanced Settings. The Windows Firewall with Advanced Security window appears. Figure 4: Windows Firewall with Advanced Security 4. In the left pane, click Inbound Rules. The Inbound Rules pane appears. 6

7 Figure 5: Windows Firewall - Inbound Rules 5. In the Actions pane, select New Rule. The New Inbound Rule Wizard opens and the Rule Type window appears. Figure 6: New Inbound Rule Wizard: Rule Type 6. Select Port and click Next. The Protocol and Ports window appears. 7

8 Figure 7: New Inbound Rule Wizard: TCP Protocol and Ports 7. Select TCP, and in the Specific Local Ports field, enter the port numbers (80, 88, 123, 135, 389, 443, 445, 1025, 1433) as shown in Figure 7 and specified in Table 3. Table 3: Ports to Open for TCP Protocol Protocol HTTP Kerberos NTP Remote Procedure Call (RPC) LDAP Secure Sockets Layer (SSL) NT LAN Manager Version 2 (NTLMv2) Remote Procedure Call (RPC) Microsoft SQL Server Database 8. Click Next. The Action window appears. Port Uses TCP TCP TCP TCP TCP TCP TCP TCP TCP 8

9 Figure 8: New Inbound Rule Wizard: Action 9. Select Allow the connection. Click Next. The Profile window appears. Figure 9: New Inbound Rule Wizard: Profile 10. Keep all profile check boxes selected (default). Click Next. The Name window appears. 9

10 Figure 10: New Inbound Rule Wizard: Name 11. Specify BCPro (TCP Protocol) as the name. Optionally, you can add a description to identify this new rule. Click Finish. The Inbound Rules table refreshes to indicate the new rule called BCPro (TCP Protocol). Ports 80, 88, 135, 389, 443, 445, 1025, and 1433 are now open and ready for use. 12. Repeat Step 5 through Step 11 to add a new BCPRo inbound rule for the UDP protocol. When the Protocol and Ports window appears (Figure 11), select UDP, and in the Specific Local Ports field, enter the port numbers as shown in Figure 11 (25, 53, 67, 68, 69, 88, 161, 162, 9910, 9911, 47808) and listed in Table 4. Table 4: Ports to Open for UDP Protocol Protocol Port Uses SMTP DNS DHCP DHCP Kerberos SNMP SNMP Trap SYPE-Transport BACnet UDP UDP UDP UDP UDP UDP UDP UDP UDP 13. Complete the steps to add the new inbound rule. Name the new rule BCPro (UDP Protocol). 10

11 Figure 11: New Inbound Rule Wizard: UDP Protocol and Ports When finished, the Windows Firewall with Advanced Security window appears and the Inbound Rules table refreshes to indicate the new rule called BCPro (UDP Protocol). Ports 25, 67, 68, 69, 53, 88, 123, 161, 162, 9910, 9911, and are now open and ready for use. 14. In the Windows Firewall with Advanced Security window, verify that the two new BCPro inbound rules are defined and enabled. Figure 12: Inbound Rules Defined and Enabled 15. Close the Windows Firewall with Advanced Security window. 16. Close all windows. Go to BCPro Software. 11

12 Windows 8.1 Important: The Windows 8.1 computer that you want to use for BCPro Workstation or BCPro UI software must have had the operating system installed on a cleanly formatted hard disk. Do not use a computer that was upgraded from a previous version of Windows (for example, upgraded to Windows 8.1 from Windows 7). The Windows upgrade process can leave behind files and registry settings that may adversely affect the installation of BCPro Workstation or BCPro UI system software. To verify correct settings, make sure a folder called WINDOWS.OLD does not exist on the hard disk. If the WINDOWS.OLD folder is present, reinstall Windows 8.1 from the media, making sure the hard disk is formatted prior to operating system installation. Verify all necessary software drivers are available before the hard disk is reimaged. For BCPro Workstation or BCPro UI software, we currently support Windows 8.1 Pro or Windows 8.1 Enterprise (64-bit editions only). The sections that follow explain how to install, verify, and configure the Windows 8.1 components that the BCPro Workstation or BCPro UI software requires. The required components include: Internet Information Services (IIS) ASP.NET SNMP Message Queuing (MSMQ).NET Framework 4.5 and 3.5 Windows Firewall The steps for adding the.net Framework 4.5 and.net Framework 3.5 components to Windows 8.1 depend on whether your computer has an active Internet connection. The steps for adding the.net Framework components with and without an Internet connection are covered within the Installing Microsoft.NET Framework 3.5 Features with Internet Connection section. For best results when setting up the Windows 8.1 user interface, we recommend that you add a shortcut to Control Panel on the computer desktop. The instructions in this section presume that Control Panel is easily accessible. Installing Microsoft.NET Framework 3.5 Features with Internet Connection Note: If your computer does not have an active connection to the Internet, do not follow the steps in this section; instead, go to Installing Microsoft.NET Framework 3.5 Features without Internet Connection. 1. In Control Panel, click Programs > Programs and Features. The Programs and Features window appears. 2. Click Turn Windows features on or off. 3. Click Yes if prompted for consent. The Windows Features window appears. 4. Use the + marks to expand.net Framework 3.5 (includes.net 2.0 and 3.0) feature. 5. Enable the.net framework 3.5 features. 6. Click OK. A dialog box appears indicating files from Windows Update are needed. Click Download files from Windows Update. A progress bar appears as the features are installed on your computer. Note: If Windows cannot access the Internet to retrieve the necessary files, the message Windows couldn't complete the requested changes appears. Check your Internet connection and try these steps again. If no Internet connection is available, cancel these steps and go to Installing Microsoft.NET Framework 3.5 Features without Internet Connection. 7. After installation is successful, restart the system. 12

13 Installing Microsoft.NET Framework 3.5 Features without Internet Connection Notes: If your computer has an active connection to the Internet, do not follow the steps in this section; instead, go to Installing Microsoft.NET Framework 3.5 Features with Internet Connection. The steps for installing the Microsoft.NET Framework 3.5 feature come after you install the other Windows components and requires the use of the Windows 8.1 operating system installation media. For details on how to create installation media for Windows 8.1, download the free Windows Media Tool ( with a computer that has Internet access. 1. Insert the Windows 8.1 installation media. Ignore the Autorun prompt that may appear. 2. Click the Windows Start button. The Start window appears. 3. Click the down arrow in the lower-left part of the screen to open the Apps window. 4. Under the Windows System category in the Apps window, right-click Command Prompt and select Run as Administrator. Click Yes if prompted for consent. The Command Prompt window appears. 5. At the command prompt, type the following command: Dism /online /enable-feature /featurename:netfx3 /All /Source:<drive>:\sources\sxs /LimitAccess where <drive> is a placeholder for the drive letter where the Windows 8.1 installation media resides (hard drive, network drive, or flash drive). For example, with the media in drive D: Dism /online /enable-feature /featurename:netfx3 /All /Source:d:\sources\sxs /LimitAccess 6. Press Enter to run the command. A progress bar appears as the.net Framework 3.5 feature is enabled. After this step is successful, the Command window may prompt you to restart the computer. Press Y to restart and then log back in to your computer. If no restart is required, type exit and press Enter to close the Command window. 7. After restarting the system, go to Control Panel, click Programs > Programs and Features. The Programs and Features window appears. 8. Click Turn Windows features on or off. 9. Click Yes if prompted for consent. The Windows Features window appears. 10. Use the + marks to expand.net Framework 3.5 (includes.net 2.0 and 3.0) features. 11. Select.NET Framework 3.5 (includes.net 2.0 and 3.0). 12. Restart the system. Enabling ASP.NET 1. In Control Panel, select System and Security, then Administrative Tools. 2. In Administrative Tools, double-click Internet Information Services (IIS) Manager in the right pane. The Internet Information Services (IIS) Manager window appears. 3. In the tree on the left, select the name of the local computer. When you select the computer, the message Do you want to get started with MS Web Platform may appear. Click No to continue. The middle pane refreshes to show an IIS configuration screen. 4. In the middle pane, locate the IIS section and double-click the ISAPI and CGI Restrictions icon. Verify that the following items are allowed: ASP.NET v and ASP.NET v If these items are not allowed, select each one and click Allow. You can ignore the Common Gateway Interface (CGI) module alert in the upper-right pane. 13

14 Figure 13: ASP.NET Configuration 6. Close all windows. Checking for and Installing Windows Software DST Update for Windows In Control Panel, click Programs > Programs and Features, then select View Installed Updates in the left pane of the window. 2. Click the Name column to sort the list alphabetically and type KB in the search box. Figure 14: Installed Updates - Windows In the list of currently installed programs and updates, look for the following update: 14

15 Update for Microsoft Windows (KB ) 4. If you do not find KB , continue to Step 5. If you do find your operating system update, go to Configuring the Windows Firewall for Windows Close the Add or Remove Programs or View Installed Updates screen. 6. Using a web browser, navigate to one of the following addresses, depending on your operating system. Note: You can also search for the update number on 7. Use the instructions on the Microsoft Corporation page to download and install the update for Windows 8.1. If your operating system is using Enhanced Security, you may not be able to install any updates until you add as a trusted site in the Internet Explorer web browser. Note: If a message appears at the start of installation that indicates the update is not applicable to your computer, the update may have been installed during an automatic Windows update session. In some cases, the update was installed, but KB does not show up as an installed update. Click OK to the user message and disregard this DST update. 8. Close all windows. Configuring the Windows Firewall for Windows In Control Panel, click System and Security, then click Windows Firewall. The Windows Firewall window appears. 2. On the Windows Firewall window, make sure the firewall is On. If not, turn on the Windows Firewall. Note: An anti-virus program might be managing the firewall. For example, if the computer uses Symantec anti-virus software, the message These settings are managed by vendor application Symantec Endpoint Protection may appear on the Windows Firewall screen. In this case, consult the local IT department for further direction, then continue to Step 3. Figure 15: Windows Firewall 3. Click Advanced Settings. The Windows Firewall with Advanced Security window appears. 15

16 Figure 16: Windows Firewall with Advanced Security 4. In the left pane, click Inbound Rules. The Inbound Rules pane appears. Figure 17: Windows Firewall - Inbound Rules 5. In the Actions pane, select New Rule. The New Inbound Rule Wizard opens and the Rule Type window appears. 16

17 Figure 18: New Inbound Rule Wizard: Rule Type 6. Click Port and click Next. The Protocol and Ports window appears. Figure 19: New Inbound Rule Wizard: TCP Protocol and Ports 7. Click TCP, and in the Specific Local Ports field, enter the port numbers (80,88,123,135,389,443,445,1025,1433) as shown in Figure 19 and specified in Table 5. 17

18 Table 5: Ports to Open for TCP Protocol Name Port Protocol HTTP Kerberos NTP RPC LDAP SSL NTLMv2 RPC MS SQL DB 8. Click Next. The Action window appears TCP TCP TCP TCP TCP TCP TCP TCP TCP Figure 20: New Inbound Rule Wizard: Action 9. Click Allow the connection. Click Next. The Profile window appears. 18

19 Figure 21: New Inbound Rule Wizard: Profile 10. Keep all profile selections selected (default). Click Next. The Name window appears. Figure 22: New Inbound Rule Wizard: Name 11. Specify BCPro (TCP Protocol) as the name and add an optional description to identify this new rule. Click Finish. The Inbound Rules table refreshes to indicate the new rule called BCPro TCP Protocol). Ports 80, 88, 123, 135, 389, 443, 445, 1025, and 1433 are now open and ready for use. 19

20 12. Repeat Step 5 through Step 11 to add a new inbound rule for the UDP protocol. When the Protocol and Ports window appears, click UDP, and in the Specific Local Ports field, enter the port numbers (25,67,68,53,88,161,162,9911,47808) as shown in Figure 23 and listed in Table 6. Figure 23: New Inbound Rule Wizard: UDP Protocol and Ports Table 6: Ports to Open for UDP Protocol Name Port Protocol SMTP DHCP DHCP DNS Kerberos SNMP SNMP Trap SYPE-Transport BACnet UDP UDP UDP UDP UDP UDP UDP UDP UDP 13. Complete the steps to add the new inbound rule. Name the new rule BCPro (UDP Protocol). When finished, the Windows Firewall with Advanced Security window appears with the Inbound Rules table refreshed to indicate the new rule called BCPro (UDP Protocol). Ports 25, 67, 68, 53, 88, 161, 162, 9911, and are now open and ready for use. 14. In the Windows Firewall with Advanced Security window, verify that the two new BCPro inbound rules are defined and enabled. 20

21 Figure 24: Inbound Rules Defined and Enabled 15. Close the Windows Firewall with Advanced Security window. 16. Close all windows. Go to BCPro Software. 21

22 Windows 10 Important: The Windows 10 computer that you want to use for BCPro Workstation or BCPro UI software must have had the operating system installed on a cleanly formatted hard disk. Do not use a computer that was upgraded from a previous version of Windows (for example, upgraded to Windows 10 from Windows 7). The Windows upgrade process can leave behind files and registry settings that may adversely affect the installation of BCPro Workstation or BCPro UI system software. To verify correct settings, make sure a folder called WINDOWS.OLD does not exist on the hard disk. If the WINDOWS.OLD folder is present, reinstall Windows 10 from the media, making sure the hard disk is formatted prior to operating system installation. Verify all necessary software drivers are available before the hard disk is reimaged. For BCPro Workstation or BCPro UI software, we currently support Windows 10 Pro or Windows 10 Enterprise (64-bit editions only). The sections that follow explain how to install, verify, and configure the Windows 10 components that the BCPro Workstation or BCPro UI software requires. The required components include: Internet Information Services (IIS) ASP.NET SNMP Message Queuing (MSMQ).NET Framework 4.5 and 3.5 Windows Firewall The steps for adding.net Framework 4.6 and.net Framework 3.5 components in Windows 10 depend on whether your computer has an active Internet connection. The steps for adding.net Framework 4.6 components and.net Framework 3.5 components with and without an Internet connection are covered in the the following two sections. For best results when setting up the Windows 10 user interface, we recommend that you add a shortcut to Control Panel on the computer desktop. The instructions in this section presume that Control Panel is easily accessible. Installing Microsoft.NET Framework 3.5 Features with Internet Connection Note: If your computer does not have an active connection to the Internet, do not follow the steps in this section; instead, go to Installing Microsoft.NET Framework 3.5 Features without Internet Connection. 1. In Control Panel, click Programs > Programs and Features. The Programs and Features window appears. 2. Click Turn Windows features on or off. 3. Click Yes if prompted for consent. The Windows Features window appears. 4. Use the + marks to expand.net Framework 3.5 (includes.net 2.0 and 3.0) feature. 5. Enable the.net framework 3.5 features. 6. Click OK. A dialog box appears indicating files from Windows Update are needed. Click Download files from Windows Update. A progress bar appears as the features are installed on your computer. Note: If Windows cannot access the Internet to retrieve the necessary files, the message Windows couldn't complete the requested changes appears. Check your Internet connection and try these steps again. If no Internet connection is available, cancel these steps and go to Installing Microsoft.NET Framework 3.5 Features without Internet Connection. 7. After installation is successful, restart the system. 22

23 Installing Microsoft.NET Framework 3.5 Features without Internet Connection Notes: If your computer has an active connection to the Internet, do not follow the steps in this section; instead, go to Installing Microsoft.NET Framework 3.5 Features with Internet Connection. The steps for installing the Microsoft.NET Framework 3.5 feature come after you install the other Windows components and requires the use of the Windows 10 operating system installation media. For details on how to create installation media for Windows 10, download the free Windows Media Tool ( with a computer that has Internet access. 1. Insert the Windows 10 installation media. Ignore the Autorun prompt that may appear. 2. Click the Windows Start button. The Start window appears. 3. Click the down arrow in the lower-left part of the screen to open the Apps window. 4. Under the Windows System category in the Apps window, right-click Command Prompt and select Run as Administrator. Click Yes if prompted for consent. The Command Prompt window appears. 5. At the command prompt, type the following command: Dism /online /enable-feature /featurename:netfx3 /All /Source:<drive>:\sources\sxs /LimitAccess where <drive> is a placeholder for the drive letter where the Windows 10 installation media resides (hard drive, network drive, or flash drive). For example, with the media in drive D: Dism /online /enable-feature /featurename:netfx3 /All /Source:d:\sources\sxs /LimitAccess 6. Press Enter to run the command. A progress bar appears as the.net Framework 3.5 feature is enabled. After this step is successful, the Command window may prompt you to restart the computer. Press Y to restart and then log back in to your computer. If no restart is required, type exit and press Enter to close the Command window. 7. After restarting the system, go to Control Panel, click Programs > Programs and Features. The Programs and Features window appears. 8. Click Turn Windows features on or off. 9. Click Yes if prompted for consent. The Windows Features window appears 10. Use the + marks to expand.net Framework 3.5 (includes.net 2.0 and 3.0) features. 11. Select.NET Framework 3.5 (includes.net 2.0 and 3.0). 12. Restart the system. Enabling ASP.NET 1. In Control Panel, select System and Security, then Administrative Tools. 2. In Administrative Tools, double-click Internet Information Services (IIS) Manager in the right pane. The Internet Information Services (IIS) Manager window appears. 3. In the tree on the left, select the name of the local computer. When you select the computer, the message Do you want to get started with MS Web Platform may appear. Click No to continue. The middle pane refreshes to show an IIS configuration screen. 4. In the middle pane, locate the IIS section and double-click the ISAPI and CGI Restrictions icon. Verify that the following items are allowed: ASP.NET v and ASP.NET v If these items are not allowed, select each one and click Allow. You can ignore the Common Gateway Interface (CGI) module alert in the upper-right pane. 23

24 Figure 25: ASP.NET Configuration 6. Close all windows. 7. Go to Checking for and Installing Windows Software DST Update for Windows 10. Checking for and Installing Windows Software DST Update for Windows In Control Panel, click Programs > Programs and Features, then select View Installed Updates in the left pane of the window. 2. Click the Name column to sort the list alphabetically. Figure 26: Installed Updates - Windows 10 Example 24

25 3. In the list of currently installed programs and updates, look for the following update: Update for Microsoft Windows (KB ) 4. If you do not find KB , continue to Step 5. If you do find your operating system update, go to Configuring the Windows Firewall for Windows Close the Add or Remove Programs or View Installed Updates screen. 6. Using a web browser, navigate to one of the following addresses, depending on your operating system. Note: You can also search for the update number on 7. Use the instructions on the Microsoft Corporation page to download and install the update for Windows 10. If your operating system is using Enhanced Security, you may not be able to install any updates until you add as a trusted site in the Internet Explorer web browser. Note: If a message appears at the start of installation that indicates the update is not applicable to your computer, the update may have been installed during an automatic Windows update session. In some cases, the update was installed, but KB does not show up as an installed update. Click OK to the user message and disregard this DST update. 8. Close all windows. 9. Go to Configuring the Windows Firewall for Windows 10. Configuring the Windows Firewall for Windows In Control Panel, click System and Security, then click Windows Firewall. The Windows Firewall window appears. 2. On the Windows Firewall window, make sure the firewall is On. If not, turn on the Windows Firewall. Note: An anti-virus program might be managing the firewall. For example, if the computer uses Symantec anti-virus software, the message These settings are being managed by vendor application Symantec Endpoint Protection may appear on the Windows Firewall screen. In this case, consult the local IT department for further direction, then continue to Step 3. Figure 27: Windows Firewall 3. Click Advanced Settings. The Windows Firewall with Advanced Security window appears. 25

26 Figure 28: Windows Firewall with Advanced Security 4. In the left pane, click Inbound Rules. The Inbound Rules pane appears. Figure 29: Windows Firewall - Inbound Rules 5. In the Actions pane, select New Rule. The New Inbound Rule Wizard opens and the Rule Type window appears. 26

27 Figure 30: New Inbound Rule Wizard: Rule Type 6. Click Port and click Next. The Protocol and Ports window appears. Figure 31: New Inbound Rule Wizard: TCP Protocol and Ports 7. Click TCP, and in the Specific Local Ports field, enter the port numbers (80,88,123,135,389,443,445,1025,1433) specified in and shown in the following table. 27

28 Table 7: Ports to Open for TCP Protocol Name Port Protocol HTTP Kerberos NTP RPC LDAP SSL NTLMv2 RPC MS SQL DB 8. Click Next. The Action window appears TCP TCP TCP TCP TCP TCP TCP TCP TCP Figure 32: New Inbound Rule Wizard: Action 9. Click Allow the connection. Click Next. The Profile window appears. 28

29 Figure 33: New Inbound Rule Wizard: Profile 10. Keep all profile selections selected (default). Click Next. The Name window appears. Figure 34: New Inbound Rule Wizard: Name 11. Specify BCPro (TCP Protocol) as the name and add an optional description to identify this new rule. Click Finish. The Inbound Rules table refreshes to indicate the new rule called BCPro (TCP Protocol). Ports 80, 88, 123, 135, 389, 443, 445, 1025, and 1433 are now open and ready for use. 29

30 12. Repeat Step 5 through Step 11 to add a new BCPro inbound rule for the UDP protocol. When the Protocol and Ports window appears, click UDP, and in the Specific Local Ports field, enter the port numbers (25,67,68,53,161,162,9911,47808) shown in Figure 35 and listed in Table 8. Figure 35: New Inbound Rule Wizard: UDP Protocol and Ports Table 8: Ports to Open for UDP Protocol Name Port Protocol SMTP DHCP DHCP DNS Kerberos SNMP SNMP Trap SYPE-Transport BACnet UDP UDP UDP UDP UDP UDP UDP UDP UDP 13. Complete the steps to add the new inbound rule. Name the new rule BCPro (UDP Protocol). When finished, the Windows Firewall with Advanced Security window appears with the Inbound Rules table refreshed to indicate the new rule called BCPro (UDP Protocol). Ports 25, 67, 68, 53, 88, 161, 162, 9911, and are now open and ready for use. 14. In the Windows Firewall with Advanced Security window, verify that the two new BCPro inbound rules are defined and enabled. 30

31 Figure 36: BCPro Inbound Rules Defined and Enabled 15. Close the Windows Firewall with Advanced Security window. 16. Close all windows. Go to BCPro Software. 31

32 BCPro Software If you have a version of BCPro software already installed, you must uninstall it before you install the newest version. If you are installing the BCPro software for the first time, please note the following: When you install BCPro software, desktop shortcuts for the BCPro UI are created. The BCPro software requires at least 800 MB of available hard disk space. The computer on which BCPro system software is installed requires the most recent Daylight Saving Time (DST) update from the Microsoft Corporation. If SQL Server is already installed, the BCPro software installation requires a user account with administrator access to SQL Server software to create and manage BCPro databases and SQL Server user accounts used during runtime of the BCPro. After the BCPro databases and SQL user accounts are created, the account with administrator access to SQL Server is no longer used. You may remove SQL Server software database Administrator rights from this user if directed to do so by the IT department. The BCPro software uses the SQL user accounts that were created by the BCPro installation program. If the IT department requests information about managing these new SQL user accounts, contact the Johnson Controls Field Support Center. When installing the SQL Server software, make sure that the Collation tab lists SQL_Latin1_General_CP1_CI_AS. BCPro requires this SQL Collation. The Ethernet Network Interface Card (NIC) must have a valid connection status for the installation to complete successfully. Connect your Ethernet NIC to the powered up Ethernet hub or to a live Ethernet network. Do not install other software applications on the BCPro computer because they may interfere with BCPro operation. If SQL Server is already installed, then SQL Server software must be running and be network accessible before you attempt to install the BCPro software. To verify that SQL Server software is running, use SQL Server Configuration Manager. We strongly recommend that you shut down anti-virus software before installing BCPro software. Work with the IT department to determine if the computer is running anti-virus software and, if applicable, how to stop it. Be sure to restart anti-virus software after BCPro software installation is complete. The default password is intended for temporary use only. Change the password to a valid, complex password after you successfully install the BCPro Workstation software. For more details regarding the BCProSysAgent default password, contact your local Johnson Controls representative. Installing the BCPro Software 1. Click Accept and Install to install.net framework. The following screen appears only if.net framework is not already installed on the machine. Figure 37:.NET Framework Installation Acceptance 32

33 Figure 38:.NET Framework Installation Progress 2. Click Install. Figure 39: BCPro Installation Welcome Screen 3. If SQL Server is not installed, then the following screen appears. The server name is (local) and by default database is connected through Windows Authentication mode. You can switch to Server Authentication mode by selecting the Server authentication credentials radio button. The Username and Password fields automatically populate with default SQL server credentials. 4. Click Install to start the installation of packages. Figure 40: SQL Server Mode Selection 33

34 5. If SQL Server is installed on the machine, then the Server Name list box is populated with the list of all the installed SQL instances. You can select SQL instances from the Server Name list box. By default, Windows authentication mode is selected. You can switch to Server authentication mode by selecting the radio button. The Username is populated with default SQL server username. Enter the password that is used while installing each selected SQL instance. 6. Click Install to start the installation. Packages such as DISMHelper and CrystalReport start installing. Figure 41: SQL Server Instance Name Figure 42: SQL Server Installation Screen 7. After all the packages install, a dialog box appears asking to allow changes to your computer. Click Yes. 8. Click Restart Now. BCPro appears in the Programs > Programs and Features section of the Control Panel and the BCPro Icon appears on your computer desktop. 34

35 Figure 43: System Restart Required Figure 44: BCPro Installation Control Panel Entry 35

36 Uninstalling the BCPro UI Software 1. Go to Control Panel and select Uninstall a program. Figure 45: Control Panel 2. Right-click Johnson Controls BCPro 3.0 and select Uninstall. Figure 46: BCPro ET Uninstall from Control Panel 3. Click Uninstall to uninstall BCPro. 36

37 Figure 47: BCPro UI Uninstall 4. Click Yes to delete BCPro UI database in addition to clicking Uninstall BCPro UI. Click No to uninstall BCPro UI without deleting BCPro UI database. The BCPro UI and associated applications uninstall. Figure 48: BCPro UI Database Uninstall Selection 37

38 Figure 49: BCPro UI Uninstalling 5. Click Finish. Figure 50: BCPro UI Successfully Uninstalled Licensing the BCPro Workstation Software Refer to the Software License Activator Technical Bulletin (LIT ) to license the BCPro Workstation software. To verify BCPro Workstation installation, go to Launching the BCPro Workstation. To verify BCPro UI installation, go to Logging in to the BCPro UI. 38

39 Launching the BCPro Workstation To launch the BCPro Workstation, start the Launcher by performing one of the following steps: From the BCPro Workstation computer, go to Start > All Programs > Johnson Controls > Launcher. From the BCPro Workstation computer, double-click the Launcher icon on the desktop. Configure the network credentials of the BCPro Workstation computer to add its profile to the Launcher. For details, refer to the Launcher Help (LIT ). From another computer on the same network as the BCPro Workstation, browse to or address>/metasys where <name or address> is the computer name or IP address of the target BCPro Workstation. When you browse to the BCPro Workstation computer from a client for the first time, the Windows Launcher Download screen appears. Click Full Launcher Installer to retrieve the user interface files (that is, private version of the JRE) from the BCPro Workstation computer, then run the Launcher installation file. For details, refer to the Launcher Installation Instructions (LIT ). Figure 51: Launcher Download Screen After you install the Launcher to your local hard drive, the Main Screen of the Launcher appears from which you can configure the network credentials of the BCPro Workstation computer. Figure 52: Launcher Main Screen Using the Launcher, configure the network credentials of the BCPro Workstation computer to add its profile to the Launcher. For details, refer to the Launcher Help (LIT ). After you add the BCPro Workstation, select it from the profile list under the SMP tab and click Launch. The BCPro Workstation UI login screen appears. Log in with the BCProSysAgent user and default password. (To 39

40 obtain the default password, contact your local Johnson Controls representative.) If this is the first time you are logging in to the BCPro software, the Change Password screen appears for the BCProSysAgent user. Type the default (old) password, then type a new password twice. We recommend you choose a complex password that contains eight or more letters, numbers, and symbols that cannot be guessed easily. Click OK. Verify that the user interface appears. After you install Launcher, use the Launcher, not the web browser, to access the BCPro Workstation. If you use the web browser, the Launcher Download screen appears again. Do not reinstall the Launcher. 40

41 Logging in to the BCPro UI To log in to the BCPro UI, browse to or address>/bcproapp/login.aspx where <name or address> is the computer name or IP address of the target BCPro UI computer. The login screen appears. Figure 53: BCPro User Login Screen Specify a valid user ID and password. Select a language and click Login. Note: The default User Name is Admin. The default password is Admin. If you want the UI screen to remember your Password the next time you log in, click Remember Me. Note: We recommend that you disable popup blocking on your browser, especially if you are using Google Chrome. 41

42 Appendix: Installing Antivirus Software Follow the steps in this appendix for installing antivirus software on computers that run BCPro software. We recommend one of the following antivirus software programs: Symantec Endpoint Protection software Corporate Edition version 12.0 or later McAfee VirusScan Enterprise version 8.8 with Patch 3 or Patch 5 (Patch 4 is not compatible) Note: Windows Defender, provided by some Microsoft operating systems, is not supported on a computer that is running BCPro software. Make sure you turn off Windows Defender before bringing the system online. Installing and Configuring Symantec Endpoint Protection Software Symantec Endpoint Protection software at version 12.0 is permitted on computers that run BCPro and BCPro UI software. Select only the anti-virus and anti-spyware features. The other two features, Proactive Threat Protection and Network Threat Protection, can interfere with communication between BCPro software and supervisory devices. Follow the steps in this section to properly install and configure this software. Table 9: Symantec Endpoint Protection Installation 1. Start 2. Figure 54: Welcome Screen If you have already installed Symantec Endpoint Protection, go to Step 16. If you have not yet installed Symantec Endpoint Protection software, start the Symantec Endpoint Protection software installation. The Symantec Endpoint Protection welcome screen appears. Select Install Symantec Endpoint Protection. 3. Figure 55: Install an Unmanaged Client Select Install an unmanaged client. A question box appears regarding installation as an unmanaged client. Click Yes to continue. Figure 56: Question About Installing an Unmanaged Client 42

43 Table 9: Symantec Endpoint Protection Installation 4. Figure 57: Installation Wizard Welcome Screen Click Next. 5. Figure 58: License Agreement Screen Review and accept the license agreement. Click Next. 6. Figure 59: Client Type Screen Select Unmanaged client and click Next. Note: Do not select Managed client. If your network is managed by a Symantec server, selecting the Managed Client option changes the custom settings and could prevent the BCPro user interface from working correctly. 43

44 Table 9: Symantec Endpoint Protection Installation 7. Figure 60: Setup Type Screen Select Custom and click Next. 8. Figure 61: Custom Setup Screen Disable the installation of these options: Advanced Download Protection, Outlook Scanner, Notes Scanner, POP3/SMTP Scanner, Proactive Threat Protection, and Network Threat Protection. To disable, click the down arrow and select Entire feature will be unavailable. Click Next. Figure 62: Disabling Features 9. Figure 63: Protection Options Screen Select all three protection options and click Next. 44

45 Table 9: Symantec Endpoint Protection Installation 10. Figure 64: File Reputation Data Submission Screen Do not select the File Reputation Data Submission check box. Click Next. 11. Figure 65: Data Collection Screen Do not select the check box under Data Collection -- Installation Options. Click Install. 12. Figure 66: Wizard Completed Screen Click Finish. 45

46 Table 9: Symantec Endpoint Protection Installation 13. Figure 67: LiveUpdate Status Screen After the installation completes, the LiveUpdate process starts. The update process may take several minutes to complete. Do not stop the process. When the Live Update session is complete message appears in the status window, click Close Figure 68: Symantec Intrusion Prevention Pop-up Message Restart the computer. Open the web browser. A Symantec Intrusion Prevention message appears. Click Don't enable. Go to Step Figure 69: Symantec Endpoint Protection Icon Double-click the Symantec Endpoint Protection icon in the Windows task bar. The Status screen appears. 17. Figure 70: Proactive Threat Protection and Network Threat Protection Not Installed Verify that the Proactive Threat Protection and Network Threat Protection features are not installed. If they do not appear on the Status screen, they are not installed. Go to Step

47 Table 9: Symantec Endpoint Protection Installation 18. Figure 71: Proactive Threat Protection and Network Threat Protection Incorrectly Installed If the Proactive Threat Protection and Network Threat Protection features are installed, they appear on the Status screen. You must remove them from your computer. Go to Step Figure 72: Change Program In Control Panel, select Programs > Programs and Features. Click Symantec Endpoint Protection in the list of installed programs. Click Change to start the InstallShield Wizard for Symantec Endpoint Protection. 21. Figure 73: Program Maintenance When you reach the Program Maintenance screen, select Modify. Click Next. The Custom Setup screen appears. 47

48 Table 9: Symantec Endpoint Protection Installation 22. Figure 74: Custom Setup Click the feature icon and select Entire feature will be unavailable for both Proactive Threat Protection and Network Threat Protection. An X appears in front of those features Figure 75: Proactive Threat Protection and Network Threat Protection Not Installed Click Next. Complete the steps in the installation wizard. Restart the computer. When the computer restarts, log in and open the Symantec Endpoint Protection Status screen to verify that the Proactive Threat Protection and Network Threat Protection features do not appear. 26. Figure 76: Symantec Intrusion Prevention Pop-up Message Open the Internet Explorer web browser. A Symantec Intrusion Prevention message appears. Click Don't enable. 27. Done. The steps for installing the Symantec Endpoint Protection software are complete. 48

49 Installing and Configuring McAfee VirusScan Enterprise Software McAfee VirusScan Enterprise version 8.8 with Patch 3 or Patch 5 is permitted on computers that run BCPro and BCPro UI software. Important: Use only McAfee VirusScan Enterprise software version 8.8 with Patch 3 or Patch 5 on your Windows 10, Windows 8.1, Windows 7, Windows Server 2012 R2, Windows Server 2012, or Windows Server 2008 R2 computer. McAfee VirusScan Enterprise software version with Patch 4 causes BCPro software operational issues. We recommend installing McAfee VirusScan Enterprise software using the steps in the following table. If you deviate from these steps, BCPro software may not work correctly. If you must enable higher security settings from what is recommended, gradually add changes and check for system reliability as you do so. Table 10: McAfee VirusScan Enterprise Installation 1. Start 2. Figure 77: McAfee VirusScan Setup Start the McAfee VirusScan Enterprise software installation. The McAfee VirusScan Enterprise Setup screen appears. Click Next. 3. Figure 78: McAfee End User License Agreement Accept the licensing agreement and click OK. 49

50 Table 10: McAfee VirusScan Enterprise Installation 4. Figure 79: Select Setup Type Select Typical. Click Next. 5. Figure 80: Select Access Protection Level Select Standard Protection. Click Next. 6. Figure 81: Ready to Install Click Install to begin McAfee VirusScan Enterprise installation. 50

51 Table 10: McAfee VirusScan Enterprise Installation 7. Figure 82: McAfee VirusScan Enterprise Setup Complete When setup is done, the completed successfully screen appears. Select Run On-Demand Scan. We recommend that you take the time now to run a full scan to ensure the computer is prepared for BCPro software. This process can take from 30 to 60 minutes to complete. Click Next. 8. Figure 83: McAfee Agent Updater The McAfee Agent Updater runs. Wait until the updater finishes. Click Finish on the McAfee setup complete window. 9. Figure 84: Access Protection Properties Right-click the McAfee icon in the task bar and click VirusScan Console. The VirusScan Console appears. Click Task > Properties. The Access Protection Properties window appears. Under Categories, select Anti-virus Standard Protection. In the protection rules table, remove the Block and Report check marks for Prevent Mass Mailing Worms From Sending Mail. Leave all other category settings at their defaults. Click OK. 51

52 Table 10: McAfee VirusScan Enterprise Installation 10. Figure 85: System Utilization On the VirusScan Console, right-click Full Scan and select Properties. The On-Demand Scan Properties-Full Scan window appears. Click the Performance tab. Under System utilization, slide the bar pointer to the Low setting. Click Schedule, and with the assistance of your local IT staff, define a daily scan schedule. Note: Do not scan at midnight because the BCPro system performs a daily archive at that time. Click OK to save the schedule. Click OK on the On-Demand Scan Properties-Full Scan window. Figure 86: Adding SQL Server as a Low-Risk Process On the VirusScan Console, click Task > On-Access Scanner Properties. The On-Access Scanner Properties window appears. Click the All Processes icon, then select Configure different scanning policies for high-risk, low-risk, and default processes. The left pane refreshes to show additional icons. Click Low-Risk Processes. Click Add and add Sqlservr.exe and Sqlwriter.exe to the list of low-risk processes. (If the files do not appear in the list box, click Browse and locate them under the Microsoft SQL Server folder.) Click OK to save the changes. Close the VirusScan Console. 12. Done. The steps for installing the McAfee VirusScan Enterprise software are complete. 52

53 Appendix: Troubleshooting BCPro Software Follow the information in this appendix to help you troubleshoot BCPro software installation and other general BCPro software operations. BCPro Troubleshooting See the following table for general BCPro troubleshooting information. Table 11: Troubleshooting - BCPro Problem You experience installation problems and would like to consult the error log. Solution The error messages are located in the following folder: C:\Users\<username>\AppData\Local\Temp\ Note the full path defined in error message. Open the log file respective to the failure package. The following files exist for each BCPro system product: DISMHelper.log CrystalReport.log LicenseActivator.log MetasysServerDatabase.log MetasysServer.log BCProAPP.log If DISMHelper failed to install, see the log file DISMHelper.log file at path given in error message. If you find text similar tothe source files could not be found or downloaded, then see the section Installing Microsoft.NET Framework 3.5 feature with Internet Connection for the respective operating system. Close BCPro Application in all browsers. Then uninstall the BCPro software again. 53

54 Table 11: Troubleshooting - BCPro Problem Solution This message occurs when user selects No on the following screen. We recommend to always select Yes on this screen. See to install.net 4.0 framework in IIS manually. See the MestasysServerDatabase.log file. If the file shows the error: CreateDatabase: ERROR - executesql: Cannot create file 'C:\Program Files\Microsoft SQL Server\MSSQL12.MSSQLSERVER\MSSQL\DATA\JCIReportingDB.mdf' because it already exists. However, JCIReportingDB.mdf is not appearing in given folder. This means there is an issue with the SQL Server. Install SSMS and delete the Metasys Server Database. If you experience the same error, then uninstall all software which uses SQL Server and then SQL Server. Delete the folder C:\Program Files\Microsoft SQL Server\MSSQL12.MSSQLSERVER and then reinstall the software you uninstalled. Building Technologies & Solutions 507 E. Michigan Street, Milwaukee, WI Johnson Controls is a registered trademark of Johnson Controls. All other marks herein are the marks of their respective owners Johnson Controls Published in U.S.A. 54