Upgrading the SharePoint-Side Plugin

This topic describes how to upgrade the SharePoint-side plugin. The upgrade process involves removing the old plugin, and then installing the new version. To upgrade, you must be logged directly into the SharePoint server using a SharePoint Administrator user account. See Special Cases for additional installation/configuration scenarios.

Note: If you'd rather upgrade manually, you can use our manual uninstallation and installation instructions instead of using the automatic installer (Setup_Jive.SharePoint.exe). For more on this, see Manually Uninstalling SharePoint-side Plugin and then Manually Installing the SharePoint-side Plugin

Removing the Existing Version of the Connector (Part 1 of 3)

The following procedure will not remove your existing SharePoint web parts and related settings. However, it will render the web parts unusable. If you subsequently install the connector, the prior settings are retained.

If you use the installer to uninstall the features and subsequently install the features to only a subset of the site collections, it will activate the features on site collections not chosen the second time around if they were chosen the first time and the web application for the feature was also chosen. If you manually deactivate the features before uninstalling with the installer, they will not be activated the next time the installer runs unless chosen during the install.

To uninstall the SharePoint-side plugin:

  1. Download the Jive-side plugin and extract the package to a desired location on your environment (such as a new folder on the Desktop of the SharePoint server).
  2. Open the new folder from step 1 and click Setup_Jive.SharePoint.exe.
  3. If you are running Windows Server 2008 and you're prompted by the Open File - Security Warning dialog box, click Run.
  4. In the Jive SharePoint Connector dialog box, click Next.
  5. In the System Check dialog box, if all prerequisites pass, click Next (otherwise see Special Cases ).
  6. In the Repair or Remove dialog box, click Remove to retract the current solution, then click Next.
  7. In the Uninstalling dialog box, allow the removal to complete, then click Next.
  8. Review the status of the uninstall and click Close.
  9. Clean up Jive web parts. For more on this, see Cleaning up after Uninstalling.

Installing the New Version of the Connector (Part 2 of 3)

After you've removed the old version of the connector, you can install the new version.

Important: If Jive features are active on any site collection, you must either have the site collection admin deactivate features before the farm admin upgrades the .wsp or make the farm admin a site collection admin on the site collections where the features are active.
  1. From the Jive SharePoint Connector package you downloaded and extracted, click Setup_Jive.SharePoint.exe.
  2. If you are running Windows Server 2008 and you're prompted by the Open File - Security Warning, click Run.
  3. In the Jive SharePoint Connector dialog box, click Next.
  4. In the System Check dialog box, if all prerequisites pass, click Next (otherwise see Special Cases ).
  5. In the End-User License Agreement dialog box, read the license agreement, then select the I accept the terms in the License Agreement check box and click Next.
  6. In the Site Collection Deployment Targets dialog box, choose the web application(s) and site collection(s) where you would like to deploy the SharePoint web parts (see following 2 screens). Click Next.
    Note: See Deploying to New Web Applications and Site Collections if you want to deploy to new web applications or site collections sometime later after the install process has completed.
  7. In the Installing dialog box, allow the installation to complete, then click Next.
  8. In the Installation Successfully Completed dialog box, review the status of the installation and click Close.
  9. Restart the Central Administration application pool to view the Jive-related links within Central Administration. To do this, run IISRESET from a command line for each web front-end. This restarts all application pools, not just the Central Adminstration application pool.

Enabling Jive Copy Workflows (Part 3 of 3)

When you perform an upgrade of the SharePoint-side plugin, all configured Jive Copy Workflow associations to any document libraries are disabled across your entire farm, preventing new instances from running. This also happens across an entire site collection if you simply disable and re-enable the Jive Copy To Workflow feature in a site collection. To correct this, SharePoint site administrators need to set their Jive Copy workflows to allow new instances. For detailed instructions, see Allowing New Instances for Jive Copy Workflow.