Managing Jive Installations

This topic walks through the general procedure for configuring one or more Jive instances for the Jive for SharePoint web parts to use. When you add one of the Jive for SharePoint web parts to a page or use the other social features, you will need to choose a Jive installation (or rely on the default installation). For each web part that is added to a page, a configuration panel (web part editor) will present a list of Jive installations. In addition, each site has a default Jive installation (defined in "Site Settings" -- see Specifying a Default Jive Instance for more information) used by site socialization, user popup, and the Copy To drop down menu.

Note: You must configure at least one Jive installation before using the Jive for SharePoint web parts. The Jive-side plugin (represented in Managing the Jive Features) will need to be installed before you can successfully configure a Jive installation.

To Manage Jive Installations

Open SharePoint Central Administration.
Locate the Jive Administration section:
In SharePoint 2007
- Central Administration > Operations > Jive Administration.
In SharePoint 2010
- Central Administration > Application Management > Jive Administration.
Under Jive Administration, click Manage Jive Installations.
On the Manage Jive Installations page, click on New Jive Installation.

Provide values for at least the following fields:

Name
Jive Internal URL
Jive External URL
Jive Service User Password

You'll find example values below. See the table below for more information about each of the fields.

Add Jive Installation Fields
Field Name	Field Description/Details	Example
Name	A name of the respective Jive installation; to be used during web part configuration, workflow configuration, and site settings.	Jive Installation 1
Jive Internal URL	URL path that is used for communication from the SharePoint server to Jive (this may be same value as used for the Jive External URL).	http://jive.jivekrb5.local
Jive External URL	URL path that is handed to the client (the user's browser) to resolve Jive-specific resources (this may be the same value as used for the Jive Internal URL).	http://jive.jivekrb5.local
SharePoint Domain	(Optional) This is used if there is more than one domain; it helps distinguish between the same user name that may exist in separate domains. Jive only allows for a single domain. If provided, it limits access to Jive functionality to only those users in the specified domain.
Jive Service User	User account (may be a normal Jive account) used to access Jive services on behalf of SharePoint users. This account simply needs to have normal access to Jive. No overrides are required.	jiveaccess
Jive Service User Password	Password that is associated to the Authentication user above. Note: The password is case sensitive.	<password>
Jive Domain	The Jive Domain/Realm is optional and is typically left blank. Custom Jive SSO configurations may require this to be set.	jivecustom

Click the Test Connection button to confirm that SharePoint is able to successfully connect to Jive.
Click OK, and review the Valid field to confirm the entry was added correctly and that SharePoint can successfully communicate with Jive. See also Jive Installation Test Fails in Troubleshooting Tips: SharePoint Administration. If the connection to Jive was successful, on the Manage Jive Installations page, under New Jive Installation, you will see the "Valid" column with a "True" value. If the connection was NOT successful, please take a look at the User name and Password for case sensitivity.

Note: Now that at least one installation of Jive is configured in SharePoint, you can begin configuring and using the Jive web parts (see Managing Jive Web Parts and the Socialization Features.