KonaSearch Installation Guide

Before You Begin

  • You must be running Salesforce, Enterprise, Unlimited, or Developer edition.
  • You will need to be a Salesforce administrator to install the application.
  • Installation should take about 15 minutes to complete.
  • Indexing time is separate and will depend on the amount of information being indexed.
  • Your browser must be IE 7/8/9, Firefox, Chrome or Safari. All most recent and up to date.

Install KonaSearchAlready Installed? Skip to Configuration

  1. In the App menu, click Add AppExchange Apps…
  2. Type "konasearch" in the Search box and press the ENTER key or click on the magnifying glass.
  3. Click the Kona icon or KonaSearch: Advanced Search for Salesforce.
  4. Click Get It Now.
  5. Select your environment type: production or sandbox (test).
  6. Read and agree to the Terms and Conditions by selecting the I have read… checkbox. For Sandbox environments, complete the information in the form provided and Click Submit.
  7. A screen like the one below will appear. Review the Package Components and then Click Continue to begin the installation.
  8. A window will pop up like the one below. You will be asked to approve third-party access to your Salesforce data. This is to let KonaSearch index your data in a private, secure index in the Amazon AWS cloud. Select the Yes, grant access… checkbox and then Click Continue.
  9. NOTE: Steps 9, 10, and 11 are the standard three steps from the Salesforce package installation wizard.

  10. Grant access to the package API. Review the permissions and Click Next.
  11. Choose a security level. We recommend choosing Grant access to all users but you may wish to limit access to certain user profiles. Click Next when done.
  12. Click Install to begin installing the application from the package.
  13. Once the installation is complete (may take up to a minute), a screen like the one below will appear (field values may be different). At this time, you can review the installation details by viewing the package components and dependencies. When you are done, proceed to Step 13.
  14. In the App Menu, Click KonaSearch for the KonaSearch application. You should see six KonaSearch tabs along with your Home tab, as shown below. Click Welcome. KonaSearch Welcome is our welcome page with general information about our company, products and how to contact us. There is also a link to this installation guide for anyone who hasn't opened it yet.

KonaSearch Configuration Guide

Before You Begin

If you are here in the KonaSearch installation guide, it means you have successfully installed KonaSearch, you are "in" the KonaSearch application, and you are ready to configure it. If you do not already have the installation instructions open, you can get them by clicking on the red Installation Guide link.

Configuring KonaSearch requires the successful completion of 5 tasks:

  • Establishing a secure connection between Salesforce and your search index.
  • Indexing your Salesforce data to make it searchable.
  • Adding a KonaSearch tab to your applications that you use to search your data.
  • Adding the KonaSearch Gadget to your page layouts. The Gadget is a slide-out sidebar on the right side of the page that allows you to search from virtually everywhere in Salesforce.
  • Assigning your KonaSearch licenses to your users.

Establish Secure Connection

  1. Click Configuration tab. Enter name of the Salesforce Instance for your org (na9, cs1, etc.) in the “Salesforce Instance” text box and Click Save. If you have created a custom Salesforce domain name for your organization using the My Domain service, enter the full domain name in the “My Domain” text box; e.g., https://custom_name.my.salesforce.com/.
  2. Click Object Setup tab. Then click “Register Org” button (the button will disappear after the registration is completed). This step registers your org with Kona and creates the necessary credentials for establishing and authenticating its connection with your search index.
  3. Click Authenticate tab. This authenticates the connection between your org and index. You will be asked to log in again to your org. This is part of the authorization security procedure. Once you have successfully logged in, you will be asked to allow KonaSearch to access your data. Click Allow.
  4. The screen will look like this when the authentication is completed:

    Index Your Data

  5. Click Object Setup tab. The Object Setup tab allows you to define the Salesforce objects you want searched. Note that all your Custom Objects plus Custom Objects for all your managed packages are listed here as well. Select or deselect the objects you want searched. You may also select or deselect the object’s Chatter feed from the Chatter column on the right. Certain objects (e.g., User and Profile) are permanently selected and therefore grayed out. Once you have finalized your selection, click Save. You can change your selection at any time.
  6. Click “Update Profiles” button. This button creates a job that will send your object profile to your search index. Note you won’t see anything happening on the screen but the job has been launched.
  7. Click Configuration tab. The Configuration tab allows you to schedule when updates from your org are sent to the search index. You can send them once an hour on the hour (select first checkbox), once an hour on the half-hour (select second checkbox), or once every half hour (select both checkboxes). When done, click Save. Kona will begin indexing your data automatically according to your schedule.
  8. If you don’t wish to wait for the scheduled index time and force an index now, or you want to see your indexing progress, click Status tab. To see the latest status one time, click Refresh. The screen will update accordingly. To have the latest status update every 5 seconds, click Start Auto Refresh.
  9. The Last Modified Date tells you when a record for the object was last modified; the Uploaded To Date tells you when the object was last uploaded to the search index. To force an upload to the index now, click either Upload Changes or Upload All Objects. Upload Changes uploads only the records that have changed since the last upload was performed. Upload All Objects will upload every record in your instance, overwriting everything that is currently in the index. For your very first index, both buttons do the same thing, but in practice it is recommended to use the Upload Changes command unless there is a specific reason not to.

    If you scroll down, you will see the job status table. All indexing functions are run as batch jobs. The table shows the jobs currently running , in queue, or completed within the last 5 minutes.

    Once you have launched your indexing process, you are free to leave your Salesforce session or continue to work. The indexing jobs will continue running regardless. You can even begin searching, although you will get only partial results for the jobs that completed. Total indexing time will vary depending on the amount of data you have in your org and the load you have on your system from your other apps.

    Add KonaSearch Tab to Your Apps

    KonaSearch includes a tab you use to search your data. The steps in this task let you add the tab to your Salesforce apps.

  10. Click "Your Name" | Setup | Create | Apps.
  11. Click Edit for each app you wish to add the KonaSearch search tab to (e.g. Sales).
  12. In the Available Tabs list, find "KonaSearch" and Click Add to add it to the Selected Tabs list. Position it by clicking Up and Down. We recommend placing it one or two tabs from Home. Click Save.
  13. Add KonaSearch Gadget

    KonaSearch includes a gadget that appears as a slide-out sidebar on the right side of most pages, allowing you to search from virtually anywhere in Salesforce. The steps in this task let you add the gadget to your Salesforce pages.

  14. Click "Your Name" | Setup | Customize | Home | Home Page Layouts.
  15. Click Edit for each Home Page Layout you wish to add the KonaSearch Gadget to.
  16. Under Select Narrow Components to Show select Kona DataSearch Gadget and then Click Next. "Kona DataSearch Gadget" should appear last in the Narrow (Left) Column list. You can position the component anywhere you like but we recommend keeping it last as you will not need to interact with it, the gadget itself is configured next. When finished, Click Save.
  17. Click "Your Name" | Setup | Customize | User Interface.
  18. Under Sidebar click Show Custom Sidebar Components on All Pages and then Click Save.
  19. Assign Licenses

    In this series of steps, you assign your KonaSearch licenses to your users (allow them to see and use the KonaSearch tab and Gadget). KonaSearch does not require license parity with Salesforce, so you may have fewer licenses of KonaSearch then Salesforce.

  20. Click "Your Name" | Setup | Manage Users | Profiles.
  21. Click Edit for each Profile you wish to assign a KonaSearch license.
  22. Under Custom Tab Settings, KonaSearch should be set to Default On. If not, please set it and then Click Save. This will return you to the Profiles list.
  23. Click Profile name to open Profile for reading. Scroll to Enabled Visualforce Page Access table (bottom of page) and click “Edit” button.
  24. The Visualforce pages listed in the following image should all be in the Enable Visualforce Pages list. If not, please add them and then click Save.

KonaSearch Testing Guide

Now that you have everything installed, it's time to test. To test the KonaSearch Tab and the KonaSearch Gadget, follow these steps:

  1. Select an application you added KonaSearch to and click the KonaSearch tab.
  2. If your sidebar is collapsed, expand it. This will make the Kona facets visible.
  3. Enter the wildcard character * in the search box. This should return all indexed content.
  4. Add up the facet counts under the Objects facet. The sum should be the total number of searchable records based on your current object profile.
  5. In this example, we have a total of 244 objects in the index.

  6. Enter a term in the search box you know is in your data and examine the results.
  7. Select a facet (e.g. object type) to see if it filters the set of results properly.
  8. Select a Layout (e.g. Home or Leads) where you added the KonaSearch Gadget. The Gadget should be visible on the right edge of your window just below the Salesforce Quick Access menu (which is only visible if you are SA).
  9. Click the Gadget. It should slide out revealing a simple search layout.
  10. Enter a term in the search box you know is in your data and examine the results.
  11. Scroll the window vertically (if you can). The Gadget should not move up or down.

Uninstalling KonaSearch

NOTE: If you get the following message when uninstalling KonaSearch:

Click “Your Name” | Setup | Monitoring | Scheduled Jobs and you should see 1 or more of the following three jobs in the queue. Delete them. This should allow KonaSearch to uninstall successfully.

Correcting Problems

If an error occurs during the installation process, we suggest you retrace your steps. Make sure the authentication process succeeded, for example. Failing this step will not allow your org and index to recognize or communicate with each other. You can try it any time by clicking on the Authenticate tab in the KonaSearch app.

If an error occurs with search – missing data for example – you can re-index your data by clicking the Status tab in the KonaSearch app and then “Upload All Objects” button.

Still having problems? Please contact Kona and we'll be glad to help you out. Here’s how to get a hold of us: