Policies Group Policy Object (GPO) Installation of WK Browser Search for Cheetah

Group Policy Object (GPO) Installation of WK Browser Search for Cheetah

WK Browser Search for Cheetah™

You wish to push WK Browser Search for Cheetah to endpoint workstations via Active Directory Group Policy Objects (GPO).

 

Prerequisites:

  • Network must have Active Directory enabled
  • Domain Administrator Privileges
  • Access to Domain Controller to use:
    • Active Directory Users and Computers
    • Group Policy Management Console
  • Network Share to be used as the Distribution Point. (A Domain Controller can be used if a separate file server is not available).

Note: If you are only installing the WK Browser Search for Cheetah for Google Chrome, a network share is not required.

  • Workstation Endpoints (Windows 7, Windows 8, etc.)
    • Internet Explorer versions 10, and 11 are supported for GPO
    • Google Chrome browser required for Chrome GPO push
    • Firefox browser required for Firefox GPO push
  • wkbrowsersearch.single.msi (main installer file for use with IE and Firefox)
  • wkbrowsersearch.xpi (plug-in for Firefox)
  • wkbrowsersearch.crx (Google Chrome plug-in automatically downloaded from the Chrome Web Store)

These instructions have been designed for administrators who may not be that familiar with pushing installations via GPO. More experienced administrators should familiarize themselves with these steps and adapt them to fit their environment. For more information regarding pushing out installations via GPO, see Microsoft article How to use Group Policy to remotely install software in Windows Server 2008 and in Windows Server 2003.

 

Procedure:

The steps below assume that the server infrastructure is running Windows 2008 and above.

Important: If you are only installing the WK Browser Search for Cheetah plug-in for Google Chrome, please skip to Step 9 below, since the plug-in is installed from the Chrome Web Store and is not dependent on the wkbrowsersearch.single.msi file. Make sure that the endpoint workstations have been added to the domain.

  1. Add the File Server (if you are using one) and Workstations to the Domain.
  2. Log onto the File Server as the Domain Administrator.
  3. On the File Server (or Domain controller if you do not have a File Server), create a network share (i.e.: Installers).
  4. Add the appropriate user Groups or Users to the share permissions and give them at least Read share level permissions.
  5. Within the share, create a folder (i.e.: CheetahSearch) to hold the Cheetah Search installation file and/or Firefox plug-in file. This folder is known as the Distribution Point since it contains the installation and files that will be distributed to the workstations.
  6. Give the folder and any subfolders within the share at least Read & Execute permissions for the appropriate user Groups or Users. Note that if you are also installing the Firefox plug-in, you may wish to create a subfolder for the Firefox plug-in file (i.e.:\CheetahSearch\Firefox).
  7. Copy the wkbrowsersearch.single.msi to the Distribution Point.
  8. If you created a separate subfolder for the Firefox plug-in file, copy wkbrowsersearch.xpi to that folder.
  9. On the Domain Controller open Active Directory Users and Computers.
  10. Create an Organizational Unit (OU) that the new GPO will be applied to.
  11. Add the Workstations that will have Cheetah Search installed on them to the OU that you just created. Note that if you have a number of computers, you may also want to create a new group at the OU level and add the workstations to it.
  12. Open the Group Policy Management console.
  13. Find the OU you just created and choose Create a GPO in this domain, and Link it here.
  14. Give the GPO a name, such as: WK Browser Search for Cheetah IE or WK Browser Search for Cheetah Firefox or WK Browser Search for Cheetah Chrome.
  15. Click on Edit.
  16. If you are installing the plug-in for Google Chrome, proceed to Step 22 below. For IE and Firefox, continue to the next step.
  17. Navigate: Computer Configuration > Policies > Software Settings > Software installation.
  18. In the right pane, right click and choose New > Package.
  19. Using an UNC path, navigate to the wkbrowsersearch.single.msi file (i.e.:\\servername\sharename\CheetahSearch\wkbrowsersearch.single.msi).
  20. Select the wkbrowsersearch.single.msi file and click Open, then OK.
  21. If you want to install the the WK Browser Search for Cheetah plug-in for IE, skip to Step 24. If you want to install the Google Chrome plug-in move to Step 22. If you want to install the Firefox plug-in move to Step 23.

 

Google Chrome Plug-in

  1. The WK Browser Search for Cheetah plug-in for Google Chrome is installed automatically from the Google Chrome store after pushing out a registry key via GPO:

A. In the left pane, navigate: Computer Configuration > Preferences > Windows Settings > Registry
B. In the right pane, right-click and choose: New > Registry Item
C. From the Action field drop-down choose: Create
D. Make sure the Hive lists HKEY_LOCAL_MACHINE
E. In the Key Path enter the following:

SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist

F. In the Value name field enter: 1
G. In the Value type field drop-down, choose: REG_SZ
H. In the Value data field enter:

hjgaiddkhcfbfjlcdaigenblddpoleod;https://clients2.google.com/service/update2/crx

I. Click OK.

Firefox Plug In

     23. If you want to install the Firefox plug-in:

A. In the left pane, navigate: Computer Configuration > Preferences > Windows Settings > Registry
B. In the right pane, right-click and choose: New > Registry Item
C. From the Action field drop-down choose: Create
D. Make sure the Hive lists HKEY_LOCAL_MACHINE
E. In the Key Path enter the following for the appropriate version of Windows:

• 32 bit: SOFTWARE\Mozilla\Firefox\Extensions
• 64 bit: SOFTWARE\Wow6432Node\Mozilla\Firefox\Extensions

F. In the Value name field enter: wkbrowsersearch@wolterskluwer.com
G. In the Value type field drop-down, choose: REG_SZ
H. In the Value data field, enter the UNC path to the wkbrowsersearch.xpi file, as in our example:

 \\servername\sharename\CheetahSearch\Firefox\wkbrowsersearch.xpi

I. Click OK.

 

All Browsers

  1. Close the Group Policy Management Editor. You should be back at the Group Policy Management Console.
  2. Make sure the new GPO is highlighted.
  3. In the right pane, under Security Filtering, a default entry, Authenticated Users is listed. Click on Remove to delete this entry.
  4. Click on Add.
  5. If your workstations were added to a group, skip to Step 31. If you are using individual computer names, click in Object Types.
  6. Check Computers.
  7. Click OK.
  8. Click on Advanced.
  9. Click on Find Now.
  10. Select your Group or Computer Names.
  11. Click on OK.
  12. Your Group or Computers should be listed in the object name window. Highlight your group or computer(s) and click OK.
  13. To force immediate processing of the GPO over the network, open a CMD window and type: gpupdate.
  14. To test your GPO deployment, log onto a workstation within the OU you created in Step 10 above using your Domain Administrator credentials.
  15. To force the GPO to the workstation, open a CMD window and type: gpupdate
  16. Once the Group Policy Update completes, reboot the computer.
  17. Before the login page displays, you should see the message “Please wait” for a few minutes. This indicates that WK Browser Search for Cheetah is installing.
  18. Log onto the computer as a Domain User.

A. Internet Explorer (10+)

i. Launch Internet Explorer.
ii. A message may appear at the bottom of the browser: “The ‘WK Browser Search for Cheetah’ add-on from ‘Wolters Kluwer’ is ready for use”. Click Enable.
iii. Close Internet Explorer and restart it.
iv. Go to Step 42.

B. Chrome

i. Launch Chrome
ii. Perform a Google, Bing or Yahoo search.
iii. Go to Step 43.

C. Firefox

i. Launch Firefox.
ii. The user will need to enable the plug-in. Note: Firefox users may experience one of two different scenarios after the plug-in has been pushed, see a. and b. below:

a. If prompted on the Firefox start page that WK Browser Search for Cheetah is available, check the Install checkbox and click Next.

1) You will be prompted that WK Browser Search for Cheetah has been installed. Close Firefox
2) Restart Firefox.
3) Skip to step 42.

b. The User receives no message that WK Browser Search for Cheetah:

1) On the Firefox start page click on Add-ons > Extensions or click on Open Menu > Add-ons > Extensions
2) At Cheetah Search, click on Enable.
3) Close Firefox.
4) Restart Firefox.
5) Skip to Step 42.

  1. Try a couple of Google, Yahoo, Bing, etc. searches (i.e.: Income Tax, Estate Tax, etc.).
  2. Make sure the WK Browser Search for Cheetah window displays Cheetah search results.
  3. Make sure you can link from Cheetah search results to Cheetah.