You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Basic Setup

Step 1: Download plug-in deployment package

The deployment package zip is located here.  Download it and unzip it.

The following is the directory structure within the zip file:

Step 2: Plug-In Setup

  1. Under the \config folder, locate the file named configurationParameters.xml and open it in a file editor.
  2. In the xml structure, under StagerBDCModel specify the following values:
    1. stagingRepositoryUrl: The Host:Port where the STageR is running
    2. sharePointServiceUrl: The Host:port where the SharePoint 2013 Central Administration is running
    3. searchServiceApplicationName: The name of the search service application within SharePoint
    4. stagerFolderPath: The path to the root directory of STageR
  3. Open SharePoint Management Shell as an administrator and go to the \scripts folder

  4. Run the following:

    .\DeployStagerPlugin.ps1 -configurationFilePath ..\config\configurationParameters.xml
  5. If all went well it should present the following:

Step 3: Model and Content Source Setup

  1. Under the \config folder, locate the file named configurationParameters.xml (The one you modified in the previous step) and create a copy of it.
  2. Modify the following fields in the new copy:
    1. contentSourceName: The name of the content source that will appear under Search Service Application in SharePoint
    2. storageUnitName: The name of the Storage Unit within STageR where the content will be extracted from
    3. storageUnitScope: The scope within the Storage Unit.  The value of 'publisher' is recomended 
    4. maxBatchesToProcess: The maximum number of batches processed by the plug-in per execution
    5. batchSize: The maximum number of documents per batch processed
    6. certPath: The path to the .p12 or .pfx file if SSL is needed.  Leave empty if not
    7. certPassword:  The password to the .p12/.pfx file if SSL is needed.  Leave empty if not
    8. claimsIssuer:  The issuer of the access claims.  Accepted values are 'public' for no issuer, 'aspire' to use Aspire Group Expansion or 'windows'
    9. useFullName:  Specifies if claims should use full name (i.e. domain/name) when sent to the group expander
  3. Open the SharePoint Management Shell as an administrator and go to the \scripts folder

  4. Run the following:

    .\DeployModel.ps1 -configurationFilePath ..\config\<the file name of the new xml>
  5. If all went well, it should present the following:

Step 4: Schedule the Content Source crawls

  1. Go to SharePoint Central Admin → Manage Service Applications → Search Service Application (the name specified in the configuration) → Content Sources
  2. Locate the Content Source you configured in the previous step
  3. Hover the mouse over it and click the dropdown
  4. Here you can trigger crawls directly, but to schedule automatic crawls select Edit
  5. In the new page, scroll down to Crawl Schedules and set the schedule as needed.



Uninstallation

Manual Removal

Step 1:  Remove Content Source

  1. Go to SharePoint Central Admin → Manage Service Applications → Search Service Application (the name specified in the configuration) → Content Sources
  2. Locate the Content Source you want to remove
  3. Hover the mouse over it and click the dropdown
  4. Select Delete and confirm

Step 2: Remove Model

  1. Go to SharePoint Central Admin → Manage Service Applications → Business Data Connectivity Service
  2. From the top dropdown select BDC Models
  3. Select the Model you want to remove (its name should be similar to the Content Source's)
  4. Click Delete and confirm


Step 3: Remove the Plug-In from Farm Solutions

  1. Go to the Services management console and restart the service named SharePoint Server Search 15.

    Sometimes this service doesn't release the farm solution and it becomes impossible to remove it from the SharePoint Central Admin.
  2. Make sure the service named SharePoint Timer Service is up and running
  3. Go to SharePoint Central Admin → System Settings → Manage farm solutions
  4. Click on stagerbdcplugin.wsp
  5. Click on Retract Solution.
  6. In the following page make sure the option under Retract When? is set to Now.

  7. Click OK.

    The user needs to be machine administrator for this to work.
  8. Wait for the solution to retract (keep refreshing the browser window)
  9. Once the solution is retracted, click on it again and once inside the page click on Remove Solution
  10. Removal should be quick




Automatic Removal

Step 1: Remove Content Source and Model

  1. Open SharePoint Management Shell as administrator

    A machine and farm administrator user is needed for this
  2. Go to the Deploy\scripts directory

  3. Run the following:

    .\RemoveModelAndContentSource.ps1 -configurationFilePath ..\config\<The Content Source configuration>.xml
    Make sure the configuration file you specified is the same one you used when creating the Content Source you want to remove
  4. Both the Content Source and Model should have been removed


Step 2: Remove Plug-In

  1. Open SharePoint Management Shell as administrator

    A machine and farm administrator user is needed for this
  2. Go to the Deploy\scripts directory

  3. Run the following:  

    .\RemoveStagerPlugin.ps1 -configurationFilePath ..\config\configurationParamenters.xml
  4. The farm solution should have been removed


Security Pre-Trimmer Installation

For the Security Pre-Trimmer installation go here.

  • No labels