This is a walkthrough on the installer for the SharePoint features provided by the SharePoint Connector for Confluence.

Uninstall Previous Version

The Beta 0.1 version of the SharePoint Connector for Confluence did not have an installer for SharePoint. If you previously installed this product you should remove the Http Module from web.config that was manually put there in the previous beta release. Note that you do not need to remove any Confluence web parts from pages and you do not need Crowd for this release.

The Beta 0.2 version of the SharePoint Connector for Confluence had a MSI installer. Go to 'Add/Remove Programs' and remove the product. Note that you do not need to remove any Confluence web parts from pages. They should work in subsequent versions of the product.

The Beta 0.3, Beta 0.4, and Beta 0.5 versions of the SharePoint Connector for Confluence uses the same installer. When installing you will be prompted to either Upgrade or Uninstall. Either choice is fine, but the Upgrade requires less steps. Note that an uninstall will not delete web parts from SharePoint. They should still exist and work after an upgrade or uninstall/install.

Run the Installer

The download files are available from http://confluence.atlassian.com/display/CONFEXT/SharePoint+Connector+for+Confluence. Inside the ZIP you have a folder for the SharePoint Connector which contains a folder for the SharePoint Installer. The SharePoint Installer folder has the physical SharePoint installation files.

In your download you should have two Setup executables:

Setup_WebParts.exe
Setup_Search.exe

First run Setup_WebParts.exe then optionally run Setup_Search.exe.

Run on SharePoint Server

The setup executables must be run directly on a server in your SharePoint farm. Do not run them from another machine and do not run them off of a network share.

Warning

Installation causes a restart of each affected web site.

Setup Web Parts

This installs the web parts that are part of the SharePoint Connector for Confluence by installing a SharePoint feature to one or more site collections. As part of the install you will choose the site collections to which you are deploying the feature.

Welcome Page

After the welcome page loads, click the Next button.

Screenshot: The SharePoint Connector Welcome Page

System Check

The system check page makes sure that you have all of the privileges necessary for installing the feature. After the check is complete, click the Next button.

Screenshot: The installation requirements checklist

EULA

Read the end user license agreement. If you choose to continue, you must accept the license agreement by clicking the check box then click the Next button.

Screenshot: The SharePoint Connector End User Licence Agreement

Site Collection Deployment Targets

Choose the site collections within your farm that you want to have the feature. Typically this is deployed to one or more content site collections and will not be deployed to Central Administration or your Shared Resource Providers (e.g., your Shared Service Provider(s) or My Sites). After selecting one or more site collections or web applications, click the Next button.

Screenshot: Selecting web applications and site collections for deployment

Installation Progress

During installation, the solution package is loaded into SharePoint and deployed to the targets selected. Note that all servers in your farm need to be online for this to complete. After installation is complete, click the Next button.

Screenshot: Viewing deployment progress

Completion

This page shows what servers were affected during solution deployment as well as feature activation. If you have multiple servers in your farm you may see multiple entries for solution deployment. Click Next to continue.

Screenshot: Installation completion dialog

Configuration Links

This last page shows a link to this documentation as well as links for each site collection you deployed to. The link(s) are basically shortcuts directly to the configuration for each site collection. From there you can define how the web parts connect to Confluence. See SharePoint Feature Configuration for more details.

Note that it may take a bit of time for the configuration screen to appear when you click these links because the web sites are being restarted.

Note that this page is not shown during an Upgrade.

Screenshot: Installation finished dialog

Setup Search

This installs the integrated search functionality between SharePoint and Confluence by installing a SharePoint feature to your farm.

Note that this feature requires Microsoft Office SharePoint Server (MOSS) and will not install for Windows SharePoint Services (WSSv3).

The forms are similar to installing the web parts as shown above. The primary difference is the deployment targets screen which has all web applications selected. There is nothing for you to change, so just click Next to continue.

Screenshot: Choosing search deployment targets

This last page of the install shows links for configuring search. If you have My Sites, the installer is unable to differentiate them from a Shared Service Provider. Therefore you may see multiple links. You only need to click the link for your Shared Service Provider. From there you can define how to integrate SharePoint search with Confluence search. See SharePoint Search Configuration for more details.