Page History
Use the following Frequently Asked Questions (FAQ) & Troubleshooting to find answers to questions about SharePoint 2013 Publisher.
On this page:
Table of Contents |
---|
FAQs
Specific
Changing the Intermediate Repository Path
Before making any changes to the publisher components, the new Repository folder has to have the following:
- Read/Write permissions for the AspireUsers group or at least for the account(s) you are using to access the folder
- The Shared Path of the new folder
- The folder has to be accessible from the servers running the Aspire Distribution and the AspireBDCService.
Aspire SP2013 Publisher
For the Aspire SP2013 Publisher, you only need to change the Repository Path on the publisher's configuration and click Save.
AspireBDCService
- Go to IIS and look for the AspireBDCService site.
- Right-click on the site and select Explore.
- Look for the web.config file and open it.
- Under <appSettings> look for the "RepositoryPath" key and set the new path.
- Save it.
Working with Multiple BDC Service Applications
Having more than one Business Data Connectivity Service Applications on the same SharePoint Server causes the Aspire SharePoint 2013 Publisher to fail when trying to create the new content source on the Search Service Application and link it to the corresponding BDC Model. Because of this issue the content source won't start crawling when the Notification Endpoint triggers it.
When a new BDCS is created its proxy has to be assigned to a Service Application Proxy Group. All BDCS proxies (and all the other Service Applications Proxies) that the admin creates will be assigned to the default Service Application Proxy Group unless it's changed. The proxy group is where the Aspire BDC Model is imported and where the Notification Endpoint gets the BDC url to create the content source. To get the proxy group the BDCS is loaded using the BDCS name on the endpoint parameters and ask for its proxy group, then the model is uploaded to that proxy group. The issue is that in that step the proxy group has multiple BDCS proxies assigned and there’s no way to tell it which one is needed, so it uses the default BDCS proxy (the first one created). After that the content source is created without the BDC url because, even though the BDCS proxy group name and the model name are sent as parameters, there are multiple BDCS proxies, the Proxy Group isn’t able to resolve the BDC url needed and it then returns nothing, leaving the content source with no BDC association.
To fix this we need to create a custom Proxy Group Association for each BDCS that we want to use to crawl batches from the Intermediate Repository. Each Service Application can have a custom Application Proxy Group association. So when having one custom Proxy Group Association for each BDCS, we can leave each Proxy Group with only one BDCS proxy (the one we need), and then when creating the BDC model and the content source, it will only have one BDCS and will be able to load and resolve everything without getting lost.
Create a Custom Proxy Group for a Service Application
- Go to Central Administration > Application Management > Configure service application associations
2. On the view drop down, select Service Applications.
3. Now select the BDCS where you want to add the custom Proxy Group.
4. On the group of connections drop down, select custom.
5. Select the all of the Service Applications you need except the other BDCS available on the server. Make sure you set the BDCS as default for this Proxy Group.
6. Save the custom proxy group by clicking OK.
7. If everything works fine, you'll see the new group on the next screen.
Publishing to Https SharePoint 2013Server
If the SharePoint 2013 server where the Aspire Notification Service solution was deployed is using https, then the Notification Service will also be using said protocol. In this case Aspire needs to know the certificate needed to connect to the Notification Service. Follow these steps to register your certificate.
- Download the site certificate using your web browser.
- Open a new Command Prompt as an Administrator
Run the following command:
Code Block language text theme FadeToGrey keytool -import -noprompt -trustcacerts -alias <AliasName> -file <certificate> -keystore <KeystoreFile> -storepass <Password>
<AliasName>: an alias for your site certificate
<certificate>: path to the certificate you want to register
<KeystoreFile>: path to the keystore used by your Java installation. The default location is: %JAVA_HOME%\lib\security\cacerts.
<Password>: password for the keystore. The default value is changeit.
Check that your certificate is now registered:
Code Block keytool -list -keystore "%JAVA_HOME%/jre/lib/security/cacerts"
No Full Crawl Debugging with
"Enable Cleanup
"Option Disabled
In this scenario, even if a full crawl was initiated in Aspire, the Publish to SharePoint 2013 publisher will not trigger a full crawl in SharePoint.
In the Publish to SharePoint 2013 window, select the follow options:
- Enable CleanUp: Clear the check box to disable the background thread that removes old batches from the intermediate repository.
Debug: Select the check box to run the publisher in debug mode.
The SharePoint Publisher is designed to write files to a shared folder and then instruct SharePoint to crawl those files. A full crawl is not triggered since the remaining files are not removed. Therefore, this behavior is as expected.
SharePoint 2013 AspireBDCService FAQ
See Aspire BDC Service FAQ page.
SharePoint 2013 Notification Service FAQ
See Notification Service FAQ page.
SharePoint 2013 Security Pre-Trimmer FAQ
See Security Pre-Trimmer FAQ page.