Install Collaboration Center components

The topics in this section describe how to install Collaboration Center components onto WebSphere Portal. For the latest information about Collaboration Center installation, refer to the Collaboration Center release notes.

The Collaboration Center is included with WebSphere Portal Express Plus only.

 

Prerequisites

Before you install Collaboration Center components for the first time, make sure that your existing portal environment is correctly set up with an LDAP service using WebSphere Member Manager in the portal, enabled for single signon (SSO), and that Lotus Companion Products are enabled to work with the portal. Refer to the Information Center sections on installing WebSphere Portal and installing Lotus Collaborative Components, and setting Configuration properties.

Configuration properties

Before you run the Collaboration Center installation program, make sure that the WebSphere Portal configuration properties file, wpconfig.properties, is up to date and has correct values specified for the following properties:

  • PortalAdminIdShort

  • PortalAdminPwd

  • WpsHostName

  • WpsHostPort

You can locate the wpconfig.properties in the /qibm/userdata/webas5/base/<instance_name>/portalserver5/config directory.

For complete information about working with the wpconfig.properties file, refer to the Configuration properties reference topic.

WpsHostName and WpsHostPort properties are described in the table of WebSphere Application Server properties. PortalAdminIDShort and PortalAdminPwd properties are described in the table of Portal configuration properties.

 

Components

The installation program adds the following Collaboration Center components to your portal environment:

  1. Five portlets that integrate the activities of people working together in the Collaboration Center

  2. The deployment file for the Collaboration Center portlets

    DeployCollabCenterPortlets.xml

  3. The deployment file for the sample Collaboration Center page

    DeployCollabCenterPage.xml

Go to Top of Section

Go to Top of Document

 

Installation

Perform the following instructions to install Collaboration Center.

  1. Locate the Collaboration Center CD.

  2. Do one of the following to access the files on the CD:

    • To access the files locally on your iSeries system, insert the Collaboration Center CD.

    • To copy the files from a Windows workstation to your iSeries system, perform the following steps:

      1. Insert the Collaboration Center CD in the disc drive of the Windows workstation.

      2. Map a network drive to the iSeries integrated file system.

      3. Copy the contents of the collabcenter/ directory from the CD to a /temp directory on the iSeries system.

  3. Sign on to an OS/400 workstation.

  4. From the command line prompt, start the Qshell Interpreter by entering the following command: 
    STRQSH

  5. Do one of the following to change to the appropriate directory:

    • To access files locally, change to the collabcenter directory of the CD by entering the following: 
      cd /qopt/wpxp-4-4/collabcenter

    • To access the files on the directory that you created for the copy from the Windows workstation, change to the temp directory. For example: 
      cd /home/<user_id>/temp

  6. Enter the following command to start installation: 
     
sh install.sh /qibm/ProdData/portalserver5

  7. After the installation, perform the following steps to add the Collaboration Center files to your portal instance:

    1. Change to the directory /qibm/ProdData/portalserver5/config.

    2. Enter the following command to copy the Collaboration Center files from the /ProdData/portalserver5 directory to your portal instance. 
      sh addwpsinst.sh -instance <was_instance_name>

    Notes:

    • The addwpsinst.sh command performs the following actions:

      • Adds WebSphere Portal to a WebSphere Application Server instance. Adding WebSphere Portal to a WebSphere Application Server instance means that select files are copied from the Product directory (/qibm/ProdData/portalserver5) to the User directory (/qibm/UserData/webas5/base/<was_instance_name>/portalserver5).

      • Upgrades your portal instance with the Collaboration Center files.

    • If a portal instance already exists when you run the addwpsinst.sh command, look for a message that states that the Collaboration Center files were copied to your portal successfully, and ignore a BUILD FAILED message, if one displays. The BUILD FAILED message displays because the addwpsinst.sh command recognizes the existing portal instance and does not attempt to add another one.

    • If you do not see the message stating that the Collaboration Center files were copied successfully, perform the preceding steps again.

Go to Top of Section

Go to Top of Document

 

Post-install operations

After you have installed Collaboration Center components, perform an additional task of specifying style sheets.

  • Specifying style sheets for the People Finder portlet

Specifying style sheets for the People Finder portlet

The upgrade installer for WebSphere Portal 5.02 contains additional Cascading Style Sheets that must be accessed by your theme for proper operation of the People Finder portlet and Person tag. To access the new CSS files, perform the following manual steps for each theme that supports an HTML markup:

  1. Determine the location where CSS files are linked into the <HEAD> section of the page. For most themes, this will be a version of Head.jsp. The themes provided with WebSphere Portal have a version of this file located at: 
    /QIBM/UserData/WebAS5/Base/<instance>/installedApps/<HostName>/wps.ear/wps.war/themes/html/Head.jsp

    where instance is the name of the WebSphere Application Server instance.

  2. Edit this file and search for lines similar to the following lines: 
    <link href='<wps:urlFindInTheme file="Styles.css"/>' rel="styleSheet" type="text/css">

    <link href='<wps:urlFindInTheme file="HelpStyles.css"/>' rel="styleSheet" type="text/css">

  3. After the two lines in step 2, add the following line and save your changes: 
    <link href='<wps:urlFindInTheme file="LWP_Styles.css"/>' rel="styleSheet" type="text/css">

  4. Touch the timestamp on the theme's Default.jsp file so it will be re-compiled by the JSP compiler. You can touch the timestamp by editing the file, adding a blank line, and saving it.

  5. Restart the portal server.


 

See also