Managing a Portal Server Community

This section provides information on creating and managing communities and community users from the Sun Java^TM System Portal Server administration console.

• Managing Communities and Users

• Managing Community Webservice URL

In Community Management page, a table lists the communities in the portal. Users can search for a community, and manage communities and community users.

The Community Management table contains the following information:

• Name of the community

• Number of users in the community

• Indicates if the community is enabled or disabled

• Indicates if the community is active or marked for deletion

• Indicates if the community is listed or unlisted.

• Indicates if the community is a membership restricted community or a unrestricted community.

• Indicates if the community is a secure or a not a secure community.

For steps on how to manage communities and users, see Managing Communities and Users.

Managing Communities and Users

This section provides information on how to manage communities and users from Sun Java System Portal Server management console.

Use the following steps to manage communities and users:

• To Search for a Community

• To Create a Community

• To Manage Community Users

• To Manage Pending Users

• To Enable a Community

• To Disable a Community

• To Unmark a Community for Deletion

• To Mark a Community for Deletion

• To Edit a Community

To Search for a Community

1. Under the Portals tab, click a portal.

2. Click the Communities tab.

   The Community Management page displays.

3. Type the name of the community in the Search for communities text box, and click Search.

   Communities matching the search criteria are listed.

   ---

   Tip –

   You can do a wildcard search. For example, if your search criteria is *blog, all communities with the word blog anywhere in the name will be listed. Typing * will display all the communities.

   ---

To Create a Community

1. Under the Portals tab, click a portal.

2. Click the Communities tab.

   The Community Management page displays.

3. Click the New button.

   The Create Community page displays.

4. Type the values in the text boxes and make selections from the drop-down menus.

5. Click OK to finish.

To Manage Community Users

1. Under the Portals tab, click a portal.

2. Click the Communities tab.

   The Community Management page displays.

3. Select a community.

   ---

   Note –

   Only one community can be managed at a time

   ---

4. Click Manage Current Users button.

   The Manage Users page displays.

5. Click the Add button.

   The Add Community User page displays.

   ---

   Note –

   If you want to change the status of existing users, go to step 7.

   ---

6. Type a user name in the User DN text box, and click Add.

   1. If you do not know the user name, click Choose.

      The Select a User page displays.

   2. Type the search criteria in the Search for Users text box, and click Search.

      ---

      Tip –

      You can do a wildcard search. For example, if your search criteria is *user, all user IDs with the word user anywhere in the name will be listed. Typing * will display all the users.

      ---

   3. Specify a user, and click Select.

      The User DN text field in the Add Community User page displays the selected user name.

   4. Click Add.

7. To change the status of an existing user, select a user.

8. Click one of the available option buttons.

   The following options are available:

   • Remove – Removes user from the community

   • Assign Ownership – Assigns owner privileges to a community member

   • Unassign Ownership – Owner privileges removed

   • Ban – Banned from the community

   • Remove Ban – Ban from the community removed

9. Click Back to return to Community Management page.

To Manage Pending Users

1. Under the Portals tab, click a portal.

2. Click the Communities tab.

   The Community Management page displays.

3. Select a community, and click the Manage Pending Users button.

   The Managing Pending Users page displays.

4. Select a user from the Awaiting Membership Approval table, and click the Approve or Deny button.

5. Click Back to return to Community Management page.

To Enable a Community

1. Under the Portals tab, click a portal.

2. Click the Communities tab.

   The Community Management page displays.

3. Select a community.

   ---

   Note –

   Multiple communities can be selected.

   ---

4. Click the Enable button.

To Disable a Community

1. Under the Portals tab, click a portal.

2. Click the Communities tab.

   The Community Management page displays.

3. Select a community.

   ---

   Note –

   Multiple communities can be selected.

   ---

4. Click the Disable button.

To Unmark a Community for Deletion

1. Under the Portals tab, click a portal.

2. Click the Communities tab.

   The Community Management page displays.

3. Select a community under Name.

   ---

   Note –

   Multiple communities can be selected.

   ---

4. Click the Unmark for Deletion button.

To Mark a Community for Deletion

1. Under the Portals tab, click a portal.

2. Click the Communities tab.

   The Community Management page displays.

3. Select a community under Name.

   ---

   Note –

   Multiple communities can be selected.

   ---

4. Click the Mark for Deletion button.

   ---

   Note –

   To permanently delete the community, use the command psadmin remove-community -u amadmin -f password_file -p portal --name community_name

   ---

To Edit a Community

1. Under the Portals tab, click a portal.

2. Click the Communities tab.

   The Community Management page displays.

3. Click a community.

   The Editing page displays.

4. Change the values and selections for the community.

5. Click Save.

Managing Community Webservice URL

Community search and administration functionality involves a community webservice. By default, the community webservice URL contains the same host as the first Portal instance. In a multi-node installation that uses a load balancer, you can change the community webservice URL to use the load balancer host.

To get and set the community webservice URL

1. Type the following in a terminal window:

   ./psadmin get-attribute -u amadmin -p portal-URI -m communities -a WebServicesURL

   ./psadmin set-attribute -u amadmin -p portal-URI -m communities -a WebServicesURL URL

   amadmin

   Specifies the administrator's distinguished name.

   portal-URI

   Specifies the portal ID.

   WebServicesURL

   Specifies the value for the WebServicesURL attribute. For example, the URL can be of the format http://foo.com:8080/communitymanagerwebservices/communitymanagerwebservices. Please note that the communitymanagerwebservices/communitymanagerwebservices part of the URL must not be changed.

   ---

   Note –

   There is no default value for the WebServicesURL attribute. By default, an empty value indicates that the host of the first Portal instance will be used.

   ---