How to Install the OnGuard Desktop Client

Introduction

This page documents the OnGuard desktop client installation procedure.

Prerequisites

You need these prerequisites to install and run the OnGuard desktop client.

  1. A Workstation running Microsoft Windows. The OnGuard client only runs on certain versions of Microsoft Windows:
    Microsoft Windows Version Status
    10, 64-bit Officially supported. CSE verified that the OnGuard client works on this OS.
    10, 32-bit Officially UNSUPPORTED.
    8.1, 64-bit Officially supported.
    8.1, 32-bit Officially UNSUPPORTED.
    8, 64-bit Officially supported.
    8, 32-bit Officially UNSUPPORTED.
    7 (SP1), 64-bit Officially supported. CSE verified that the OnGuard client works on this OS.
    7 (SP1), 32-bit Officially UNSUPPORTED.

    Make sure the system is clean, secure, and patched with the latest updates and security fixes.

  2. Authorization from your department head naming you as a departmental OnGuard administrator.

Installation Procedure

  1. Download OnGuard Media. From CSE's secure OnGuard download directory, download OnGuard-7.4-dvd1.iso, Supp_Mat_Rev23_dvd2.iso. You need to be an Onguard admin authorized by your department head to download this media. If you're not an authorized OnGuard admin but think you should be, email us. If you're installing OnGuard from your own DVDs, make sure the version is OnGuard 7.4 Update 2 (Version 7.4.457.325).
  2. Burn DVDs. Burn the ISO files you downloaded above to DVDs. dvd1.iso produces the OnGuard Installation Disk. dvd2.iso produces the OnGuard Supplemental Materials Disk.
  3. OR mount .iso files: If running Windows 8.x or 10 you may also mount the .iso files directly to your computer.
  4. Turn off User Account Control (UAC): Control Panel --> Action Center --> Change User Account Control Settings and scroll bar down to the bottom (Never Notify).
  5. Install Prerequisite Applications. You first need to install prerequisite applications (which may already exist on your workstation). Insert the OnGuard Supplemental Materials DVD (Disk 2). If your workstation is not configured to AutoRun DVDs on insertion, run the runme.exe executable located on the disk to launch the main menu. If not already installed, clink the link to install:
    • Microsoft .NET Framework 4.6.1
    You may need to reboot.
  6. Download Oracle Client. From CIT's secure Oracle Client download directory, download the Oracle 32-bit Client (not the Instant Client) that's most appropriate for your operating system. OnGuard will work with 11.2g 32-bit but only with Windows 7 and 8.x. We highly recommend Oracle 12.2c 32-bit (NOT 12.1c) for any Windows OS:
    Operating System Oracle 12.2c Client Status Oracle 11.2g Client Status
    Microsoft Windows 7 [SP1], 64-bit win32_12201_client.zip Supported win32_11gR2_client.zip Supported
    Microsoft Windows 8, 64-bit win32_12201_client.zip Supported win32_11gR2_client.zip Supported
    Microsoft Windows 8.1, 64-bit win32_12201_client.zip Supported win32_11gR2_client.zip Supported
    Microsoft Windows 10, 64-bit win32_12201_client.zip Supported
  7. Install Oracle Client.
    1. Run setup.exe.
    2. Set 'What type of installation do you want?' == Administrator
    3. Accept remaining installation default values.
  8. Configure Oracle Client.
    1. Run Oracle Net Configuration Assistant.
      
      Start -> Oracle -> Configuration and Migration Tools -> Net Configuration Assistant
      
      
    2. Select Local Net Service Name configuration -> Next -> Add -> Next
    3. Set 'Service Name' = oraserve.sens.buffalo.edu -> Next
    4. Set 'Network Protocol' == TCP -> Next
    5. Set 'Hostname' = oraserve.sens.buffalo.edu
    6. Set 'Use the standard port number of 1521' -> Next
    7. Set 'Would you like to test the connection' == Yes -> Next. The test connection will FAIL with an "Invalid username/password" error. That error is expected.
    8. Set 'Net Service Name' = oraserve.sens.buffalo.edu
  9. Reboot.
  10. Configure DNS. Your workstation's DNS search path must include sens.buffalo.edu and MUST be listed first.
    1. Edit your Local Area Network Connections' TCP/IP properties:
      
      Start -> Control Panel -> Network and Sharing Center -> Local Area Connection -> Properties -> TCP/IPv4 Properties -> Advanced -> DNS
    2. Select "Append these DNS suffixes (in order)" and add sens.buffalo.edu to the top of the DNS search path.
  11. Install OnGuard.
    1. Insert the OnGuard Installation Disk (Disk 1) or copy the disk contents to your hard drive.
    2. Right click on setup.exe and choose 'Run as administrator'
    3. Hit the Install button. It will begin OnGuard required packages per your PC's configuration. Reboots may be required.
    4. Select 'Accept' radio button for the license agreement screen -> Next
    5. Select Client System button installation.
    6. Set System == Typical System
    7. Set database == Oracle Server (Manual) -> Next
    8. Set 'Select the computer which is the licensing host' -> Cancel (this dialogue box may appear behind the installation window).
    9. Set Provide the location of your license server == bestlock
    10. Set Port == 8189
    11. Set Provide the location of your database and provide the database login user == LENEL --> Next
    12. Hit the 'Install' button. Expect to wait for a long period of time. The amount of time depends on your system.
    13. The 'Setup Assistant' dialogue appears. This may take a few minutes to appear depending on the system. It actually gathers some information before it launches. 'Cancel' this box when it appears. You will run it manually at a later time.
  12. Reboot.
  13. Configure ODBC.
    1. Launch the Microsoft ODBC Administrator.
      1. Microsoft Windows 7, 8.x, and 10 64-bit:
        
        C:\Windows\SysWOW64\odbcad32.exe
        
        
    2. Under the "System DSN" tab, select the lenel ODBC entry.
    3. Click 'Configure...'
    4. Set TNS Service Name == oraserve.sens.buffalo.edu
    5. Set Data Source Name = lenel
    6. Set User ID = LENEL
    7. Set Description == [blank]
  14. Run Setup Assistant.
    1. Start --> OnGuard --> Setup Assistant
    2. Hit 'Start' button within Setup Assistant.
    3. Hit 'Apply Settings'
    4. It will auto complete the settings.
    5. Hit 'Close'.
  15. Test. Test the correctness of your installation, your ability to login, and your ability to administer all the access segments that you should be able to administer:
    
    Start -> -> OnGuard 7.4-> System Administration -> [login]
    
    

People

  1. cse-consult@buffalo.edu, enterprise-wide OnGuard administrators. Typically Maria and Chris.
  2. senshelp@buffalo.edu, enterprise-wide OnGuard administrator. Typically Scott Berner.