Installing

For a list of required software components, see System Requirements.

To install the community preview of Social Connector for Rational Jazz™ on the Jazz Team Server, complete the following steps:

  1. Download the archived Jazz Team Server update site from Mainsoft.
  2. Extract the update site (preserving the folder structure) to the parent folder of the JazzInstallDir directory.
    After extraction, the directory structure should look like this:
    • JazzInstallDir
      • server
    • LotusConnectionsForJazzServerUpdateSite
      • features
      • plugins
  3. Stop the Jazz Team Server, by running server.shutdown.bat from the JazzInstallDir/server/ folder.
  4. Copy LotusConnectionsForJazzServerUpdateSite/mainsoft-social-profile.ini to your server provision profiles folder, JazzInstallDir/server/conf/jazz/provision_profiles.
    The file mainsoft-social-profile.ini instructs the Jazz Team Server to look for LotusConnectionsForJazzServerUpdateSite next to the JazzInstallDir folder.
    Note: If the LotusConnectionsForJazzServerUpdateSite folder is located elsewhere, edit the mainsoft-social-profile.ini file to point to its location. For example:
    • Windows: url=file://bob-xp/MainsoftDownloadedAndExtractedZipFiles/
      LotusConnectionsForJazzServerUpdateSite
    • Linux: url=file:///machinename/users/bob/MainsoftDownloadedAndExtractedZipFiles/
      LotusConnectionsForJazzServerUpdateSite

    If your Jazz Team Server is running on a WebSphere Application Server, the .ini file in the server provision profiles directory must use an absolute path for the URL property.
  5. Open a Command Prompt, and run the following commands:
    > cd <JazzInstallDir>\jazz\server
    > repotools.bat -addTables

    Note: When you install Social Connector for Rational Jazz the first time, you will see the message Component has not been installed in the database: com.mainsoft.team.social. You can safely ignore this message and continue with the installation.
  6. Start the Jazz Team Server, by running server.startup.bat from the JazzInstallDir/server/ folder.

To verify that your server installation was successful, open the Web admin interface at https://localhost:9443/jazz/admin and click the Component Status link. The Component Status page should list com.mainsoft.team.social, and the two services com.mainsoft.team.social.common.internal.ISocialContentService and com.mainsoft.team.social.common.internal.ISocialRestService.

Note: When visiting the Social Network tab in Edit Profile the first time after installing the product, you may see an error message: [ERROR]: com.ibm.team.repository.web.ui.internal.admin.users.UserEditor: (line 16): Could not load 'com.mainsoft.team.social.web.ui.internal.ContributorSocialEditorPage'; last tried '../com/mainsoft/team/social/web/ui/internal/ContributorSocialEditorPage.js'. Refresh the page in the Web browser to fix this issue.

To learn how to work with the community preview of Social Connector for Rational Jazz, read the Getting Started Guide.

Upgrading your installation

To upgrade your Social Connector for Rational Jazz installation, perform these tasks:

  1. Type the following URL to reset request: https://localhost:9443/jazz/admin/cmd/requestReset
  2. Stop the Jazz Team Server.
  3. Export data by running the following command:

    4. % repotools -export toFile=/export.tar
  4. Copy the new server update site LotusConnectionsForJazzServerUpdatesite to JazzInstallDir folder.
  5. Replace the provision profile file mainsoft-documents-profile.ini with mainsoft-social-profile.ini
  6. Clean repotools cache by removing all data from the folder JazzInstallDir/jazz/server/repotools/eclipse/configuration, except for config.ini.
  7. Re-create tables by running the following command:

    8. % repotools -createTables
  8. Import data by the following command:

    9. % repotools -import fromFile=/export.tar
  9. Start the Jazz Team Server.