Step 1. Launch Aspire and open the Content Source Management Page

Launch Aspire (if it's not already running). See:

• Launch Control
• Browse to: http://localhost:50505. For details on using the Aspire Content Source Management page, please refer to Admin UI

Step 2. Add a new Selenium Content Source

To specify exactly what shared folder to crawl, we will need to create a new "Content Source".

To create a new content source:

1. From the Content Source , click on "Add Source" button.
2. Click on "Selenium Connector".

Step 2a. Specify Basic Information

In the "General" tab in the Content Source Configuration window, specify basic information for the content source:

1. Enter a content source name in the "Name" field. 
   1. This is any useful name which you decide is a good name for the source. It will be displayed in the content source page, in error messages, etc.
2. Click on the Scheduled pulldown list and select one of the following: Manually, Periodically, Daily, Weekly or Advanced.
   1. Aspire can automatically schedule content sources to be crawled on a set schedule, such as once a day, several times a week, or periodically (every N minutes or hours).For the purposes of this tutorial, you may want to select Manually and then set up a regular crawling schedule later.
3. Click on the Action pulldown list to select one of the following: Start, Stop, Pause, or Resume.
   1. This is the action that will be performed for that specific schedule.
4. Click on the Crawl pulldown list and select one of the following: Incremental, Full, Real Time, or Cache Groups.
   1. This will be the type of crawl to execute for that specific schedule.
      

After selecting a Scheduled, specify the details, if applicable:

• Manually: No additional options.
• Periodically: Specify the "Run every:" options by entering the number of "hours" and "minutes."
• Daily: Specify the "Start time:" by clicking on the hours and minutes drop-down lists and selecting options.
• Weekly: Specify the "Start time:" by clicking on the hours and minutes drop-down lists and selecting options, then clicking on the day checkboxes to specify days of the week to run the crawl.
• Advanced: Enter a custom CRON Expression (e.g. 0 0 0 ? * *)

Step 2b. Specify the Connector Information

In the "Connector" tab, specify the connection information to crawl the Selenium.

1. Select the Web driver implementation you want to use, this is related to the browser that will be controlled by Selenium.
   Currently there are two options
   
   1. Chrome.
   2. Firefox.
2. Set the path to the web driver.
   Once a driver implementation is selected, a path to the executable driver must be provided.
3. Set the headless mode if required, if the connector is running on headless mode UI window will be displayed for the browser.
4. Select the "Use seeds file" if the connector should read the seed urls from a file.
   1. If selected, set the path to the seeds file.
   2. Otherwise fill the "Seeds URLs" text area with the desired urls.
5. Check the "Crawl Sitemap urls" if there are sitemaps that must be processed by the crawler.
   1. If selected, select the "Use sitemaps from file" if the urls are on a file.
      1. Select the sitemap urls file.
   2. Otherwise set the "Sitemap URLs" text area with the desired sitemaps.
      
6.  Select a Crawl Scope:
   1. Host Only: The crawler will not process any url that has a different hostname from the seed urls.
   2. Custom: The crawler will process any url that matches the provided regular expression.
   3. Everything: The crawler will process any url it finds.
7. Page Render Settings, this section will tell the crawler how to handle the urls rendered by the browser.
   This section allows for multiple entries, each entry must specify:
   
   1. Pattern: Regular expression that will be evaluated against each url, if it matches the remaining elements will apply.
   2. Page render cooldown: Time (in seconds) the crawler will wait after the page is done loading before retrieving the content.
   3. Interact with page before processing:
      1. If selected, provide the "Interaction Script" with the instructions for the selenium driver before retrieving the content.
8. Set the crawl depth
   1. The max number of "jumps" the crawler goes through a seed url to reach the current url, leaving 0 will make the crawler to process only the seed urls.
9. Set the max content size (in bytes)
   1. The crawler will not process any url that contains more than the allowed size.
10. Set case sensitive urls
    1. If selected, the crawler wll treat the urls as case sensitive.
11. Set strip internal links
    1. If selected, the crawler will remove internal links before processing the urls.
12. Set obey robots.txt
    1. If selected, the crawler will check with the site robots.txt and page meta tags if the url should be processed.
13. Set show 400s and 500s status as errors
    1. If selected, the crawler will report as error any incoming response with 4XX and 5XX status code.
14. Set url cleanup for incremental regular expression
    1. This expression will be used if the urls must be cleaned up in order to match the previous crawl urls.
15. Set deletes policy:
    1. Inmmediate: the deleted urls are reported in the crawl they were first discovered.
    2. Time based: the deleted urls will be reported on an incremental crawl after X days have passed.
    3. After X incrementals: the deleted urls will be reported on an incremental crawl after X incremental crawls have been executed since they were first discovered.
16. Set link extraction script flag.
    1. If selected provide a script with the steps to retrieve the discovered urls from the current page.
17. Set Reject Images / Videos / Javascript / CSS
    1. If selected, multi-media, javascript and css urls will not be processed by the crawler.
18. Set content cleanup
    1. If selected  

Step 2c. Specify Workflow Information

In the "Workflow" tab, specify the workflow steps for the jobs that come out of the crawl. Drag and drop rules to determine which steps should an item follow after being crawled. This rules could be where to publish the document or transformations needed on the data before sending it to a search engine. See Workflow for more information.

1. For the purpose of this tutorial, drag and drop the Publish To File rule found under the Publishers tab to the onPublish Workflow tree.
   1. Specify a Name and Description for the Publisher.
   2. Click Add.

After completing this steps click on the Save then Done and you'll be sent back to the Home Page.

Step 3: Initiate a Full Crawl

Now that the content source is set up, the crawl can be initiated.

1. Click on the crawl type option to set it as "Full" (is set as "Incremental" by default and the first time it'll work like a full crawl. After the first crawl, set it to "Incremental" to crawl for any changes done in the repository).
2. Click on the Start button.

During the Crawl

• Click on the "Refresh" button on the Content Sources page to view the latest status of the crawl.

  The status will show RUNNING while the crawl is going, and CRAWLED when it is finished.

• Click on "Complete" to view the number of documents crawled so far, the number of documents submitted, and the number of documents with errors.

If there are errors, you will get a clickable "Error" flag that will take you to a detailed error message page.

Step 4: Initiate an Incremental Crawl

If you only want to process content updates from the Selenium (documents which are added, modified, or removed), then click on the "Incremental" button instead of the "Full" button. The Selenium connector will automatically identify only changes which have occurred since the last crawl.

If this is the first time that the connector has crawled, the action of the "Incremental" button depends on the exact method of change discovery. It may perform the same action as a "Full" crawl crawling everything, or it may not crawl anything. Thereafter, the Incremental button will only crawl updates.