Manual SharePoint Feature Installation

If you have trouble running the SharePoint Installer for the SharePoint Connector for Confluence, you can try to install it manually instead.

The SharePoint Installer comes with several files:

• Atlassian.Confluence.SharePoint.Version2007.wsp
• Atlassian.Confluence.SharePoint.Version2010.wsp
• EULA.rtf
• MsiBanner.bmp
• Release Notes.txt
• Setup_WebParts.exe
• Setup_WebParts.exe.config

The automatic install is done through the executable file, Setup_WebParts.exe, which requires all of the files listed above to present in the same directory. To do a manual install, you only need the wsp file appropriate for your version of SharePoint. For SharePoint 2007 (including Windows SharePoint Services 3.0), you need the Atlassian.Confluence.SharePoint2007.wsp file. For SharePoint 2010, you need to the Atlassian.Confluence.SharePoint2010.wsp. A WSP file is a Solution Package which contains everything SharePoint needs for the installation. Unfortunately, installing a WSP through SharePoint is a little tedious, which is why we have used the SharePoint Solution Installer to ease the installation experience. However, if you are having problems using the installer provided , the steps are below.

Manual Installation Steps for SharePoint 2010.

Step 1: Add Solution to SharePoint Farm

1. Log in to a SharePoint server in your farm as a SharePoint farm administrator.
2. Run the following command from a Windows command prompt:

   C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\BIN\stsadm -o addsolution -filename "<full_path_to_your_sharepoint_installer_files>\Atlassian.Confluence.SharePoint2010.wsp"
   

Step 2: Deploy Solution to Web Application(s)

1. Open SharePoint 2010 Central Administration from the Start menu under Microsoft SharePoint 2010 Products.
2. Click on the System Settings menu item in SharePoint 2010 Central Administration.
3. Click on the Manage Farm Solutions link.
4. Click on atlassian.confluence.sharepoint2010.wsp.
5. Click on the Deploy Solution link.
6. Select the Now option under Choose when to deploy the solution:.
7. Select which web application you would like to deploy the solution under Choose a web application to deploy this solution:.
8. Click OK.

Step 3: Activate Solution for Web Application(s)

1. Load the Site Collection Features administration page for the site collection hosted in the web application that the solution was deployed to in Step 2. For example, if your site collection is located at http://sharepoint/mysite then go to http://sharepointserver/mysite/_layouts/ManageFeatures.aspx?Scope=Site
2. Locate the row titled Confluence Integration and click on the Activate button next to it.

Step 4: Configure the SharePoint Connector for Confluence

1. Follow the steps in the installation guide to Install and Configure the SharePoint Feature on SharePoint 2010.

Manual Un-Install Steps for SharePoint 2010

1. Log in to a SharePoint server in your farm as a SharePoint farm administrator.
2. Ensure that the SharePoint 2010 Administrative Service is running by running the following command from a Windows Command Prompt:

   net start SPAdminV4
   

3. Open SharePoint 2010 Central Administration from the Start menu under Microsoft SharePoint 2010 Products.
4. Click on the System Settings menu item in SharePoint 2010 Central Administration.
5. Click on the Manage Farm Solutions link.
6. Click on atlassian.confluence.sharepoint2010.wsp.
7. Click on the Retract Solution link.
8. Select the Now option under Choose when to deploy the solution:.
9. Select which web application you would like to retract the solution from under Choose a Web application to retract this solution:.
10. Click OK.

Manual Installation Steps for SharePoint 2007

• Log in to a SharePoint server on your farm as a SharePoint farm administrator.
• Open a command prompt (Start->Run then type "cmd") and do the following:
  • Navigate to "Bin" directory within your SharePoint installation (eg. "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\BIN" for SharePoint 2007 and "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\BIN" for SharePoint 2010).
  • Type the following command:

    stsadm -o addsolution -filename "<full_path_to_your_sharepoint_installer_files>\Atlassian.Confluence.SharePoint.wsp"

• Open SharePoint 3.0 Central Administration (under Start->Administrative Tools).
  • Navigate to Operations->Solution Management.
  • Click on "atlassian.confluence.sharepoint.wsp".
    • Click the "Deploy Solution" link.
    • Choose where to deploy this solution (e.g., "All content Web applications" or a particular web application).
    • Click OK.
    • Repeat the 3 steps immediately above if you did not choose "All content Web applications" and you want to deploy it to other web applications.
  • (Optional) Click on "atlassian.confluence.sharepoint.search.wsp" if applicable and click the OK button.
• Open a browser to a SharePoint site collection where you deployed "atlassian.confluence.sharepoint.wsp".
  • Log in as a site collection administrator if you are not already logged in as one.
  • Navigate to Site Settings (Site Action->Site Settings or Site Action->Modify All Site Settings->Site Settings).
  • Click "Site collection features" under the "Site Collection Administration group.
    • If you don't see the group you are not logged in as a site collection administrator.
    • If you only see a "Go to top level site settings" link under the group then you are not at the top level site - click this link to get there.
  • Activate the "Confluence Integration" feature if it is not already activated.
• Follow the instructions for Configuring the SharePoint Web Part on SP 2007 and optionally Configuring the SharePoint Federated Search on SP 2007.

Manual Un-Install Steps for SharePoint 2007

• Log into a SharePoint server on your farm as a SharePoint farm administrator.
• Open SharePoint 3.0 Central Administration (under Start->Administrative Tools).
  • Navigate to Operations->Solution Management.
  • Click on "atlassian.confluence.sharepoint.wsp".
    • Click Retract Solution.
    • Click OK.
    • Wait a minute or so and refresh your browser until you see "Not Deployed" for the solution.
    • Click on "atlassian.confluence.sharepoint.wsp".
    • Click Remove Solution and OK.