+

Search Tips   |   Advanced Search

Connections 4.5 CR1 Part 2: Administering common areas, Activities, Blogs, Bookmarks, Communities, Files, and Forums


Administer

The following features are new or updated in version 4.5.

Connections:

  • You can lock the default frequency with which email digests from Connections applications are sent to users by configuring the frequencyLocked property in notification-config.xml.

Activities:

  • The EventLogPurgeJob task deletes old entries from the Activities events log. This task helps maintain performance and keeps the log from becoming too large. By default, it runs daily at 2 AM. You can specify the time that the log is purged and set the properties that define which entries can be deleted.

Communities:

Files:

  • You can now use a Files administrative command to obtain the ID of a community library using its community uuid value. The format of the command is...

      FilesLibraryService.getByExternalContainerId(string community_id)

Forums:

  • There are no new or updated administration features for the Forums application in this release.

News:

Profiles:

  • You can now exclude nicknames when adding or updating user profiles by specifying a new name.expansion property in the tdi-profiles-config.xml file.

  • You can use the new mapToNameTable property in the profiles-types.xml file to specify an additional givenname or surname value for use with Profiles directory search.

  • You can integrate the Profiles business card with your web application by mapping an LDAP distinguished name, using the DN parameter; in addition to the previously available user ID and email mapping options.
  • The hashEmail extended attribute can be added to the map_dbrepos_from_source.properties file or profileExtension table in the tdi-profiles-config.xml file to support Profiles users in conjunction with the Microsoft Outlook Social Connector. For related information, see Use the Connections Desktop Plug-ins for Microsoft Windows.

Search:

Wikis:


Administer common areas


Database and file system backup and maintenance


Tasks to schedule

  1. No tasks can run while the search index is being built. You do not have to do anything to create the initial search index because it runs automatically during the installation process. Wait for one of the default indexing tasks to run. To re-create the search index, stop all scheduled tasks first. You can re-create the index by using one of the following procedures:

  2. Schedule the following tasks:

    • Schedule PowerCube refreshes for the Metrics application.

    • For user directory maintenance:

      • To keep the Profiles data in sync with the source from which you populated it, schedule the sync_all_dns script to run nightly.

        If you made any customizations to the population process, schedule your custom synchronization script to run nightly instead.

      • To keep information about managers up-to-date, run the mark_managers program.


Manage content

  • Moderation

    Content that is added to Blogs, Forums, or Files in Communities must be reviewed by a moderator before it can be made public. Alternatively, you can allow people to add content freely, but enable others to flag content as inappropriate.

  • To enable administrators to perform advanced tasks in all applications, create a global administrator.

  • Designate who can view and interact with server-level metrics . By default, community owners can view metrics only for their communities; users cannot view any metrics.


Integrate with other products


Security considerations

  • Connections uses single sign-on (SSO) to secure the transfer of user ID and password information used authenticate with the system. With SSO, users can switch to different applications without needing to authenticate again

  • By default, the Connections AJAX proxy is configured to allow cookies, headers or mime types, and all HTTP actions to be exchanged among the Connections applications. To change the traffic that is allowed from non-Connections services, you must explicitly configure it.


Customize the product

  • Start Connections and review the product user interface to determine which areas of user interface to customize .

  • You can also use an OAuth 2.0 consumer proxy to allow the Homepage component to surface gadgets in an OpenSocial container that interacts with an OAuth 2.0 protected service


Testing the environment for production readiness

  • If during product installation you specified directory paths to application data and resources that were different from the default paths, you must change your environment variables to reflect those changes. The application configuration files that define the behavior of the applications reference the directory paths using these environment variables.

  • Make sure references to administrator IDs and passwords are correct.

  • If your IBM HTTP Server is hosting multiple web servers, you might want to change the session cookie name of one of them to prevent the cookie from being lost when the user is redirected from one product to another.


Administration tools

Use the wsadmin utility to edit configuration properties or run administrative commands.

The wsadmin utility is a tool provided with WebSphere Application Server used to manage applications hosted by WAS, including Connections.

The wsadmin tool runs Connections script-based commands that you enter into a wsadmin command session. Behind the scenes, these scripts are based on the Jython scripting language, and they invoke WebSphere Application Server and Connections commands that do the actual work. These scripts can both change XML-based file values that control an application's configuration and run Connections-supplied MBean commands, which are grouped into services that perform related tasks, such as managing application membership.

You can change the behavior of Connections using wsadmin to perform one of the following actions:

    Edit configuration properties
    These properties control configurable aspects of the applications and are stored in XML-formatted configuration files. When you change these types of properties, you must use scripts that check out the configuration file, make the change, and then check the configuration file back in. After checking in your changes, restart the servers for the changes to take effect. In a network deployment, synchronize the nodes to propagate the changes across a cluster.

    Run administrative commands
    Run administrative commands to invoke MBean commands associated with the product applications. MBeans control the applications that run on the server. When you run an administrative command, you must start the Jython script interpreter, but you do not have to check out any configuration files nor restart the server. Your changes take effect immediately.


Start wsadmin

Use the wsadmin client to make configuration changes to applications.

You can use the client to access and change properties of your Connections configuration. You can configure common properties that apply across all applications or you can configure properties that apply only to an individual application.

To start wsadmin:

    cd WAS_HOME/profiles/Dmgr01/bin
    ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

You must run the command to Start wsadmin from this specific directory because the Jython files for the product are stored there. If you start the client from a different directory, the execfile() command does not work correctly.


Edit configuration files

You can edit configuration files either using wsadmin or by editing the files directly.

To edit a configuration file, check it out first.

Each configuration file is an XML that is paired with an XSD file. The XML file contains configuration settings and the corresponding XSD files is used to validate the XML file.

  1. Start wsadmin:

      cd WAS_HOME/profiles/Dmgr01/bin
      ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

  2. Access the configuration files:

    execfile("application_py_file")

    where application_py_file is one of the following values:

    • Connections-wide: connectionsConfig.py

    • Activities: activitiesAdmin.py
    • Blogs: blogsAdmin.py
    • Bookmarks: dogearAdmin.py
    • Communities: communitiesAdmin.py
    • Files: filesAdmin.py
    • Forums: forumsAdmin.py
    • Home page: homepageAdmin.py
    • News: newsAdmin.py
    • Profiles: profilesAdmin.py

    • Search: searchAdmin.py
    • Wikis: wikisAdmin.py
    • Metrics: metricsAdmin.py

    If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

  3. Check out the configuration file for an application:

    service_name.checkOutConfig("working_directory", "cell_name")

    where:

    • service_name is one of the following values:

      • Connections-wide: LCConfigService

      • Activities: ActivitiesConfigService
      • Blogs: Configuration settings for Blogs are not in a configuration file. You do not have to edit a file. Changes are written directly to the Blogs database.
      • Bookmarks: DogearCellConfig
      • Communities: CommunitiesConfigService
      • Files: FilesConfigService
      • Forums: ForumsConfigService
      • News: NewsCellConfig
      • Profiles: ProfilesConfigService
      • Search: SearchCellConfig
      • Wikis: WikisConfigService
      • Metrics: MetricsConfigService

    • working_directory is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them. Notes:

      • When you specify a path to the working directory on a system that is running Microsoft Windows, use a forward slash for the directory.

        For example: "C:/temp".

      • AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

    • cell_name is the name of the WAS cell that hosts the Connections application. To get cell name: print AdminControl.getCell()

      This input parameter is case-sensitive.

    For example:

  4. To see the current values of the configuration properties:

      service_name.showConfig()

    where service_name is one of the service names that are defined in step 4.

  5. Edit the configuration properties to change. Some properties must be edited using wsadmin; others can be edited only by editing the configuration XML file directly.

    For example:

    service_name.updateConfig("property_name","new_value")

    For more information about the configuration properties that you can edit, see the documentation for the individual application sections.

  6. To force users' browsers to pick up the changes to the configuration, update the value of the version stamp configuration property.

  7. Check in the configuration files: service_name.checkInConfig()

    where service_name is one of the service names that are defined in step 4. You do not have to complete this step for the Blogs application. To check in events-config.xml, use the LCConfigService.checkInEventsConfig() command.

    You must check in the file in the same wsadmin session in which you checked it out.

  8. Sychronize nodes: synchAllNodes()

  9. To exit the wsadmin client, type exit at the prompt.

  10. Stop and restart the servers that host the Connections applications.

    If you changed Blogs configuration settings only, you do not have to restart the servers.


Connections configuration property values

To figure out which properties are editable, do one of the following:

  • Refer to the topic which lists all of the configuration properties for an application.

  • Find the topic that describes the task to complete. Many of the tasks you can perform involve editing a configuration property; the rest are completed using administrative commands.


Connections configuration files

The following table lists the configuration files that are provided with Connections and describes what they do.


Configuration file Description
calendar-config.xml Control the behavior of the Events widgets.
communities-config.xml Control the behavior of the Communities application.
communities-policy.xml Permission levels of different roles in the Communities application.

For example, specify that owners in a public community can modify the community description or members in a private community can add bookmarks.

contentreview-config.xml Defines settings for content moderation in the Blogs, Files, and Forums applications.
directory.services.xml Control the behavior of common directory services.
dogear-config-cell.xml Properties that affect Bookmarks at the cell level, such as differentiating between intranet and internet sites.
events-config.xml Control how events are collected and managed.
files-config.xml Control the behavior of the Files application.
forum-config.xml Control the behavior of the Forums application.
forum-policy.xml Permission levels of different roles in the Forums application.
gettingstarted-config.xml Properties that define the content of the Getting Started tab in the home page.
library-config.xml Control the behavior of library widgets in the Communities application.
LotusConnections-config.xml Control common Connections applications, such as the navigation bar links.
media-gallery-config.xml Control the behavior of the Media Gallery widget in the Communities application.
metrics-config.xml Control the behavior of the Metrics application.
mime-files-config.xml Stores MIME type assignments for file extensions and icons in the Files application.
mime-wikis-config.xml Stores MIME type assignments for file extensions and icons in the Wikis application.
mobile-config.xml Control the behavior of the Connections Mobile service.
news-config.xml Control how information is cleaned up and synchronized in the news repository.
notification-config.xml Control email notifications across all of the applications.
oa-config.xml Properties that affect Activities, such as managing uploaded files, defining which statistics to collect, and purging the trash.
opensocial-config.xml Properties that affect the behavior of the OpenSocial service, and is used for the integration of OpenSocial gadgets.
profiles-config.xml Control the behavior of the Profiles application.
profiles-policy.xml Properties that can enable or disable profiles on the basis of profile type and properties that control the behavior of status updates in Profiles.
proxy-config.tpl Proxy server redirects for specific URL patterns. Allows access to web sites that you deem to be safe or block access to web sites that you deem to be dangerous. Also defines rewrite rules that specify aliases for web addresses.
search-config.xml Control the behavior of the Search application.
uiextensions-config.xml Properties that manage customization in the business card, Communities, the home page, and Profiles.
widgets-config.xml Control the behavior of the widgets that can be added to the Communities and Profiles applications.
wikis-config.xml Control the behavior of the Wikis application.
XRDS.xml Standard definition document in XML format for the discovery of metadata about a resource.


Edit events-config.xml

Edit events-config.xml to change how events are collected and managed

To edit the events configuration file, check it out first.

  1. Start wsadmin:

      cd WAS_HOME/profiles/Dmgr01/bin
      ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

  2. Access the configuration file:

      execfile("connectionsConfig.py")

  3. Check out events-config.xml:

      LCConfigService.checkOutEventsConfig("working_directory", "cell_name")

    where:

    • working_directory is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

      When you specify a path to the working directory on a system that is running Microsoft Windows, use a forward slash for the directory.

      For example: "C:/temp".

      AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

    • cell_name is the name of the WAS cell that hosts the Connections application. To get cell name: print AdminControl.getCell()

      This input parameter is case-sensitive.

    For example:

      LCConfigService.checkOutEventsConfig("C:/temp","Cell01")

  4. Go to the working directory specified in Step 3, open events-config.xml, and edit the properties to change.

  5. Check in the file:

      LCConfigService.checkInEventsConfig("working_directory", "cell_name")

    You must check in the file in the same wsadmin session in which you checked it out.

  6. Sychronize nodes: synchAllNodes()

  7. To exit the wsadmin client, type exit at the prompt.

  8. Stop and restart the servers that host the Connections.


Change common configuration property values

Configuration settings control how and when various common operations take place. You can edit the settings to change how Connections behaves.

Use the connectionsConfig script in the wsadmin client to interact with LotusConnections-config.xml. When you change common configuration settings, you must synchronize the nodes and restart the application servers.

Some properties in LotusConnections-config.xml cannot be edited with this procedure. They cannot be edited by using the updateConfig command nor displayed by using showConfig. Instead, check out the configuration file by using the checkOutConfig command and then edit the property values with a text editor. After you edit the file, save it and open it in a web browser to make sure that you did not introduce any errors. XML files that are well formed display in a web browser; if there are errors, the web browser reports that an error was encountered. After you fix any errors, check in the file using checkInConfig.

Use showConfig to determine which properties you can edit using wsadmin. This command returns a list of all the properties that can be edited by using the updateConfig command and their current values.

To change common configuration settings using wsadmin:

  1. Start wsadmin:

      cd WAS_HOME/profiles/Dmgr01/bin
      ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

  2. Use the wsadmin client to check out Connections configuration files:

    1. Access the Connections configuration file: execfile("connectionsConfig.py")

      If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

    2. Check out Connections configuration files:

      LCConfigService.checkOutConfig("working_directory","cell_name")

      where:

      • working_directory is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

        When you specify a path to the working directory on a system that is running Microsoft Windows, use a forward slash for the directory.

        For example: "C:/temp".

        AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

      • cell_name is the name of the WAS cell that hosts the Connections application. To get cell name: print AdminControl.getCell()

        This input parameter is case-sensitive.

    For example:

    • AIX or Linux:

      LCConfigService.checkOutConfig("/opt/temp","Cell01")

    • IBM i:

      LCConfigService.checkOutConfig("/temp","Cell01")

      Windows:

      LCConfigService.checkOutConfig("c:/temp","Cell01")

  3. To list the current configuration settings and values:

    LCConfigService.showConfig()

  4. To change a common configuration setting:

    LCConfigService.updateConfig("property","value")

    ...where Connections configuration properties and value is the new value with which you want to set that property.

    For a complete list of editable properties, see Common configuration properties .

    For example:

      LCConfigService.updateConfig("versionStamp","")

  5. Repeat the previous step for each property setting to change.

Check the configuration files back in in the same wsadmin session in which you checked them out.

For more information, see the Applying common configuration property changes topic.


Common configuration properties

Common configuration properties for Connections are stored in LotusConnections-config.xml. The properties are represented as XML elements.

You can change the values of the properties in either one of the following ways:

  • Use the updateConfig command in the wsadmin client.

    When you use the wsadmin client to edit a property value, the changes are validated. Any errors are notified so that you can correct them before you save the file.

    For more information, see the Properties that you can edit using wsadmin topic.

    Not all properties can be edited with the wsadmin client. The values of such properties must be changed by editing the configuration file directly. To display all the properties that can be edited with the wsadmin client, use the showConfig wsadmin command.

  • Edit the configuration file using a text editor.

    You still must use the checkOutConfig wsadmin command to check out the configuration file and the checkInConfig wsadmin command to check the file back in. When you check in the file, validation runs on the edited file and you are informed if you introduced any errors. Fix any errors, save the file, and try to check it in again.

    This method of editing properties is more error-prone than using the wsadmin client because you might inadvertently edit other content in the file.


Apply common configuration property changes

After editing the configuration properties common to all Connections applications, check the changed configuration files in, and restart the servers to apply the changes.

Perform the check in in the same wsadmin session in which you checked out the files.

  1. Start the wsadmin client.

  2. To confirm changes, list the configuration settings and values

      LCConfigService.showConfig()

  3. Update the value of the version stamp configuration property to force users' browsers to pick up this change.

    Increment the value of the versionStamp property:

    LCConfigService.updateConfig("versionStamp","gmt_timestamp")

    Where gmt_timestamp is the GMT time. You can specify an empty string for the time stamp or provide a GMT value string. When you specify an empty string, the client calculates the current GMT time and updates the version stamp with that value. If you choose to provide the time, specify it using the following format:

      yyyyMMdd.HHmmss

    ... and specify the time in GMT. It is best to provide an empty string and let the client format the time stamp.

    For example:

  4. To check in the changed configuration property files

      LCConfigService.checkInConfig()

  5. After making updates, deploy the changes

      synchAllNodes()

  6. To exit the wsadmin client, type exit at the prompt.

  7. Stop and restart all of the Connections application servers.


Run administrative commands

Use administrative commands to run tasks on the server.

Administrative commands interact with Connections applications through scripts. These scripts use the AdminControl object in the wsadmin client to interact with the applications. Each script uses managed beans (MBeans) to set administration properties.

When you use administrative commands to change administration properties, you do not have to check out any files nor restart the server for the changes to take effect. You must, however, understand how to manipulate Java™ objects.

When you use these commands, the item, member information, and access level information are represented as hash tables. Many of the commands return a vector of hash tables that represent application resources. Commands used to perform tasks, such as deleting, archiving, and restoring, take parameters that are formatted as vectors of hash tables. You can pass information in the hash tables to commands that run server tasks.

When an administrative command is started, a SOAP request is made to the target Connections application. The number of seconds that the wsadmin client waits for a response to a SOAP request is specified in the com.ibm.SOAP.requestTimeout property in the soap.client.props file. The file is stored in: WAS_HOME\profiles\PROFILE_NAME\properties.

If a command takes longer to complete than the value of the property...

    com.ibm.SOAP.requestTimeout

...an error is displayed in the wsadmin client and any value that is returned from the command is lost. The command continues to be processed by the application but the connection to the client is lost. This fact is important to note because some commands take a long time to run.

For example, in a system with many Activities, the command...

    ActivityService.fetchActivities()

...can take a long time to complete. You can monitor the status of these operations by scanning the SystemOut.log file for success and failure messages.

To increase the time interval that passes before a request fails, set com.ibm.SOAP.requestTimeout in soap.client.props. Restart the server for changes to take effect.

  1. Start wsadmin:

      cd WAS_HOME/profiles/Dmgr01/bin
      ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

  2. Access the configuration files:

    execfile("application_py_file")

    where application_py_file is one of the following values:

    • Connections-wide: connectionsConfig.py

    • Activities: activitiesAdmin.py
    • Blogs: blogsAdmin.py
    • Bookmarks: dogearAdmin.py
    • Communities: communitiesAdmin.py
    • Files: filesAdmin.py
    • Forums: forumsAdmin.py
    • Home page: homepageAdmin.py
    • News: newsAdmin.py
    • Profiles: profilesAdmin.py

    • Search: searchAdmin.py
    • Wikis: wikisAdmin.py
    • Metrics: metricsAdmin.py

    If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

  3. Edit administrative properties and run administrative tasks by using administrative commands. These commands are documented in the individual application sections of the product documentation.


Starting or stopping Connections applications

  1. Log in to the WebSphere Administrative Console on the Connections server.

  2. Click Applications > Application Types > WebSphere enterprise applications

  3. Select the check box for the application you want started or stopped.

  4. Click a button:

    Option Description
    Start Runs the application and changes the state of the application to Started. The status is changed to partially started if not all servers on which the application is deployed are running.
    Stop Stops the processing of the application and changes the state of the application to Stopped.

    To restart a running application, select the application you want to restart, click Stop and then click Start.


System maintenance

Make sure Connections works properly in your particular environment.


Change WAS environment variables

The directory paths to Connections application data and other resources are given associated WAS environment variables. If you change default paths in your environment, update the variables.

The environment variables are given default values unless you change them during the product installation.

See WAS environment variables for a list of the default values.

If, for example, you decide to move the directory associated with an application, such as the index directory for Bookmarks, to a different system driver, you can do so, but also update the environment variable defined for the Bookmarks index directory in WebSphere Application Server. It is important to update the environment variables because the application configuration files that define the behavior of the applications reference the directory paths using these environment variables.

  1. Use an administrator ID, log into the WAS admin console associated with the profile to which you installed Connections. If you installed the applications to multiple WAS profiles, log into the console associated with the appropriate profile.

  2. Expand Environment, and then click WebSphere Variables.

  3. Find the environment variable to change and edit it from the list.

  4. Save and apply your changes, and then restart the server.


WAS environment variables

Unless you change the directory paths during the installation, the default IBM WebSphere environment variables are defined for Connections application directories. These variables are referenced from the configuration files that are associated with the applications. The following tables list the default environment variables that are defined for application directories and for the customization base directory.

Production deployments often use more than one shared content store to avoid problems when applications attempt to read or write to a device at the same time. If you use multiple devices, change the environment variables to match your deployment. You must also update the properties in the Connections configuration engine; otherwise, the export/import utility does not work properly.

For more information about Connections configuration engine properties, see ConfigEngine properties.


Table 3. Activities default WebSphere environment variables

Variable name Description Local/Shared Default value
ACTIVITIES_CONTENT_DIR File upload directory shared AIX/Linux: /opt/IBM/Connections/data/shared/activities/content
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/activities/content
Windows: C:\IBM\Connections\data\shared\activities\content
ACTIVITIES_HOME Directory in which Activities was installed. Required on first node only. local AIX/Linux: /opt/IBM/Connections/activities/activities/activities
IBM i: /QIBM/ProdData/IBM/Connections/activities/activities/activities
Windows: C\IBM\Connections\activities\activities\activities
ACTIVITIES_JDBC_DRIVER_HOME JDBC Driver JAR files directory local JDBC driver library path specified when you installed the product.

For example: opt/ibm/db2/java

ACTIVITIES_STATS_DIR Statistics directory shared AIX/Linux: /opt/IBM/Connections/data/shared/activities/statistics
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/activities/statistics
Windows: C:\IBM\Connections\data\shared\activities\statistics


Table 3. Blogs default WebSphere environment variables

Variable name Description Local/Shared Default value
BLOGS_CONTENT_DIR File upload directory shared AIX/Linux: /opt/IBM/Connections/data/shared/blogs/upload
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/blogs/upload
Windows: C:\IBM\Connections\data\shared\blogs\upload
BLOGS_JDBC_DRIVER_HOME JDBC Driver JAR files directory local JDBC driver library path specified when you installed the product.
BLOGS_HOME Directory in which Blogs was installed. Required on first node only. local AIX/Linux: /opt/IBM/Connections/blogs/blogs/blogs
IBM i: /QIBM/Proddata/IBM/Connections/blogs/blogs/blogs
Windows: C:\IBM\Connections\blogs\blogs\blogs


Table 4. Bookmarks default WebSphere environment variables

Variable name Description Local/Shared Default value
DOGEAR_FAVICON_DIR Icons upload directory shared AIX/Linux: /opt/IBM/Connections/data/shared/dogear/favorite
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/dogear/favorite
Windows: C:\IBM\Connections\data\shared\dogear\favorite
DOGEAR_JDBC_DRIVER_HOME JDBC Driver JAR files directory local JDBC driver library path specified when you installed the product.
DOGEAR_HOME Directory in which the Bookmarks application was installed. Required on first node only. local AIX/Linux: /opt/IBM/Connections/dogear/dogear/dogear
IBM i: /QIBM/Proddata/IBM/Connections/dogear/dogear/dogear
Windows: C:\IBM\Connections\dogear\dogear\dogear


Table 5. Communities default WebSphere environment variables

Variable name Description Local/Shared Default value
CATALOG_INDEX_DIR Directory in which the index is stored local AIX/Linux: /opt/IBM/Connections/data/local/catalog/index
IBM i: /QIBM/Proddata/IBM/Connections/data/local/catalog/index
Windows: C\IBM\Connections\data\local\catalog\index
CATALOG_REPLICATION_DIR Directory in which the delta index files are stored shared AIX/Linux: /opt/IBM/Connections/data/shared/catalog/indexReplication
IBM i: /QIBM/Proddata/IBM/Connections/data/local/catalog/indexReplication
Windows: C\IBM\Connections\data\shared\catalog\indexReplication
COMMUNITIES_JDBC_DRIVER_HOME JDBC Driver JAR files directory local JDBC driver library path specified when you installed the product.
COMMUNITIES_HOME Directory in which Communities was installed. Required on first node only. local AIX/Linux: /opt/IBM/Connections/communities/communities/communities
IBM i: /QIBM/Proddata/IBM/Connections/communities/communities/communities
Windows: C:\IBM\Connections\communities\communities\communities


Table 6. Customization default WebSphere environment variable

Variable name Description Local/Shared Default value
CONNECTIONS_CUSTOMIZATION_PATH Customization directory shared AIX/Linux: /opt/IBM/Connections/data/shared/customization
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/customization
Windows: C:\Program files\IBM\Connections\data\shared\customization


Table 7. Files default WebSphere environment variables

Variable name Description Local/Shared Default value
FILES_CONTENT_DIR File upload directory shared AIX/Linux: /opt/IBM/Connections/data/shared/files/upload
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/files/upload
Windows: C:\IBM\Connections\data\shared\files\upload
Files_HOME Directory in which the Files application was installed. Required on first node only. local AIX/Linux: /opt/IBM/Connections/files/files/files
IBM i: /QIBM/Proddata/IBM/Connections/files/files/files
Windows: C:\IBM\Connections\files\files\files
Files_JDBC_DRIVER_HOME JDBC Driver JAR files directory local JDBC driver library path specified when you installed the product.


Table 8. Forums default WebSphere environment variables

Variable name Description Local/Shared Default value
FORUM_CONTENT_DIR Forum content directory shared AIX/Linux: /opt/IBM/Connections/data/shared/forums/content
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/forums/content
Windows: C:\IBM\Connections\data\shared\forums\content
FORUM_JDBC_DRIVER_HOME JDBC Driver JAR files directory local JDBC driver library path specified when you installed the product.
FORUM_HOME Directory in which the Forum application was installed. Required on first node only. local AIX/Linux: /opt/IBM/Connections/forum/forum/forum
IBM i: /QIBM/Proddata/IBM/Connections/forum/forum/forum
Windows: C:\IBM\Connections\forum\forum\forum


Table 9. Home page default WebSphere environment variables

Variable name Description Local/Shared Default value
Homepage_JDBC_DRIVER_HOME JDBC Driver JAR files directory local JDBC driver library path specified when you installed the product.
Homepage_HOME Directory in which the Home page application was installed. Required on first node only. local AIX/Linux: /opt/IBM/Connections/homepage/homepage/homepage
IBM i: /QIBM/Proddata/IBM/Connections/homepage/homepage/homepage
Windows: C:\IBM\Connections\homepage\homepage\homepage


Metrics default WebSphere environment variables

Variable name Description Local/Shared Default value
METRICS_HOME Directory in which the Metrics application was installed. Required on first node only. local AIX/Linux: /opt/IBM/Connections/metrics/metrics/metrics
IBM i: /QIBM/Proddata/IBM/Connections/metrics/metrics/metrics
Windows: C:\IBM\Connections\metrics\metrics\metrics
METRICS_JDBC_DRIVER_HOME JDBC driver JAR files directory local. JDBC driver library path specified when you installed the product.


News default WebSphere environment variables

Variable name Description Local/Shared Default value
ACTIVITY_STREAM_SEARCH_INDEX_DIR Directory in which the index for Activity Stream search is stored local AIX/Linux: /opt/IBM/Connections/data/local/news/search/index
IBM i: /QIBM/Proddata/IBM/Connections/data/local/news/search/index
Windows: C:\IBM\Connections\data\local\news\search\index
ACTIVITY_STREAM_SEARCH_REPLICATION_DIR Replication directory for Activity Stream Search shared AIX/Linux: /opt/IBM/Connections/data/news/search/indexReplication/ActivityStream
IBM i: /QIBM/Proddata/IBM/Connections/data/news/search/indexReplication/ActivityStream
Windows: C:\IBM\Connections\data\news\search\indexReplication\ActivityStream
AUDIT_FILE_ROOT_DIR Stores temporary attachments for audit purposes. shared AIX/Linux: /opt/IBM/Connections/data/shared/audit
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/audit
Windows: C:\IBM\Connections\data\shared\audit
NEWS_JDBC_DRIVER_HOME JDBC Driver JAR files directory local JDBC driver library path specified when you installed the product.
NEWS_HOME Directory in which the News application was installed. Required on first node only. local AIX/Linux: /opt/IBM/Connections/news/news/news
IBM i: /QIBM/Proddata/IBM/Connections/news/news/news
Windows: C:\IBM\Connections\news\news\news


Profiles default WebSphere environment variables

Variable name Description Local/Shared Default value
PROFILES_CACHE_DIR Cache directory local AIX/Linux: /opt/IBM/Connections/data/local/profiles/cache
IBM i: /QIBM/Proddata/IBM/Connections/data/local/profiles/cache
Windows: C:\IBM\Connections\data\local\profiles\cache
PROFILES_HOME Directory in which the Profiles application was installed. Required on first node only. local AIX/Linux: /opt/IBM/Connections/profiles/profiles/profiles
IBM i: /QIBM/Proddata/IBM/Connections/profiles/profiles/profiles
Windows: C:\IBM\Connections\profiles\profiles\profiles
PROFILES_JDBC_DRIVER_HOME JDBC Driver JAR files directory local JDBC driver library path specified when you installed the product.
PROFILES_STATS_DIR Statistics directory shared AIX/Linux: /opt/IBM/Connections/data/shared/profiles/statistics
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/profiles/statistics
Windows: C:\IBM\Connections\data\shared\profiles\statistics


Search default WebSphere environment variables

Variable name Description Local/Shared Default value
CRAWLER_PAGE_PERSISTENCE_DIR Directory used to store the seedlist pages persisted during crawling. AIX/Linux: /opt/IBM/Connections/data/local/search/persistence
IBM i: /QIBM/Proddata/IBM/Connections/data/local/search/persistence
Windows: C:\IBM\Connections\data\local\search\persistence
EXTRACTED_FILE_STORE Directory used to store the extracted file content. AIX/Linux: /opt/IBM/Connections/data/shared/search/extracted
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/search/ExtractedText
Windows: C:\IBM\Connections\data\shared\search\extracted
FILE_CONTENT_CONVERSION Platform-specific path to the application that is called for text extraction from files at indexing time. local AIX/Linux: /opt/IBM/WebSphere/Connections/data/local/search/stellent/dcs/oiexport/exporter
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/search/stellent/dcs/oiexport/exporter
Windows: IBM\Connections\data\local\search\stellent\dcs\oiexport\exporter
SEARCH_DICTIONARY_DIR Dictionary directory shared AIX/Linux: /opt/IBM/Connections/data/shared/search/dictionary
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/search/dictionary
Windows: C:\IBM\Connections\data\shared\search\dictionary
SEARCH_HOME Directory in which Search was installed. This variable is necessary only on the first node. local AIX/Linux: /opt/IBM/Connections/search/search/search
IBM i: /QIBM/Proddata/IBM/Connections/search/search/search
Windows: C:\IBM\Connections\search\search\search
SEARCH_INDEX_DIR Index directory local AIX/Linux: /opt/IBM/Connections/data/local/search/index
IBM i: /QIBM/Proddata/IBM/Connections/data/local/search/index
Windows: C:\IBM\Connections\data\local\search\index
SEARCH_INDEX_BACKUP_DIR Backup index directory local AIX/Linux: /opt/IBM/Connections/data/local/search/backup
IBM i: /QIBM/Proddata/IBM/Connections/data/local/search/backup
Windows: C:\IBM\Connections\data\local\search\backup
SEARCH_INDEX_SHARED_COPY_LOCATION Directory used for automatic distribution of the baseline index to other nodes. An index in this folder will be deleted 30 days after it is created. If WAS variable SEARCH_INDEX_SHARED_COPY_LOCATION is deleted, automatic index rollout will be disabled. shared AIX/Linux: /opt/IBM/Connections/data/shared/search/staging/
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/search/staging/
Windows: C:\IBM\Connections\data\shared\search\staging\
SEARCH_JDBC_DRIVER_HOME JDBC Driver JAR files directory local JDBC driver library path specified when you installed the product.


WebSphere Application Server Service Integration Bus file store environment variables

Variable name Description Local/Shared Default value
MESSAGE_STORE_PATH Directory used to store the files that are used and managed by the messaging engines of the WebSphere Service Integration Bus (SIB) for the Connections bus (permanent, temporary, and log file) shared

The same requirements for other shared content apply to this directory. In addition, if NFS is used, use version 4 of the protocol.

AIX/Linux: /opt/IBM/Connections/data/shared/messageStores
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/messageStores
Windows: C:\IBM\Connections\data\shared\messageStores


Wikis default WAS environment variables

Variable name Description Local/Shared Default value
WIKIS_CONTENT_DIR File upload directory, shared AIX/Linux: /opt/IBM/Connections/data/shared/wikis/upload
IBM i: /QIBM/Proddata/IBM/Connections/data/shared/wikis/upload
Windows: C:\IBM\Connections\data\shared\wikis\upload
WIKIS_HOME Directory in which the Wikis application was installed. This variable is necessary only on the first node. local AIX/Linux: /opt/IBM/Connections/wikis/wikis/wikis
IBM i: /QIBM/ProdData/IBM/Connections/wikis/wikis/wikis
Windows: C:\IBM\Connections\wikis\wikis\wikis
WIKIS_JDBC_DRIVER_HOME JDBC Driver JAR files directory local JDBC driver library path specified when you installed the product.

*Shared content must be accessible (read/write) by all nodes in a cluster. The shared content store must be in a shared repository that grants read/write access to the Deployment Manager and all the nodes.

Use one of the following methods to create a shared data directory:

  • Network-based file shares (for example: NFS, SMB/Samba, and other share types)

  • Storage area network drives (SAN)

  • If you are using a shared-file system on Microsoft Windows, specify the file location by using the Universal Naming Convention (UNC) format.

    For example: \\server_name\share_name

From version 3 of Connections, all variables changed from being server-level variables to cell-level variables. Variables with a server level scope are more granular than variables with a node or cell level scope.

Both shared and local content stores must be accessible by using the same path from nodes and the deployment manager.


ConfigEngine properties

The ConfigEngine properties in the wkplc_comp.properties file are used during the export/import operation. Production deployments often use more than one shared content store to avoid issues when all the applications are trying to read or write to the same attached device. In the event that you need to change the values of WAS environment variables to match your deployment, update the properties in the Connections configuration engine at the same time to ensure that the utility for exporting and importing functions correctly.

Connections uses WAS environment variables at runtime, but during the export/import operation, the utility uses the wkplc_comp.properties file. The file is located in the following directory:

LC_install_dir/ConfigEngine/properties/wkplc_comp.properties


ConfigEngine properties

WebSphere environment variables ConfigEngine Properties
ACTIVITIES_CONTENT_DIR activities.objectstore.file.directory
ACTIVITIES_STATS_DIR activities.statistic.directory
AUDIT_FILE_ROOT_DIR news.auditFileDir
BLOGS_CONTENT_DIR blogs.UploadDirectory
COMMUNITIES_STATS_DIR communities.StatisticDirectory
CONNECTIONS_CUSTOMIZATION_PATH connections.CustomizationDirectory
DOGEAR_FAVICON_DIR dogear.UploadDirectory
FILES_CONTENT_DIR files.UploadDirectory
FILE_CONTENT_CONVERSION search.StellentDirectory
FORUM_CONTENT_DIR forum.UploadDirectory
PROFILES_STATS_DIR profiles.statistic.directory
SEARCH_DICTIONARY_DIR search.DictionaryDirectory
WIKIS_CONTENT_DIR wikis.UploadDirectory


Change the name of the session cookie ID

The session cookie ID for Connections is named JSESSIONID by default. Other products hosted by WAS often use the same name for their session cookie. If IBM HTTP Server is hosting multiple web servers, you might want to change the cookie name of one of them to prevent the cookie from being lost when the user is redirected from one product to another.

  1. If multiple products are hosted on the IBM WAS cell, by default the other application WAS servers will have conflicting use of the JSESSIONID session ID cookie.

    For each WAS appserver that uses the same virtual host as the one that hosts Lotus Connections applications, do the following:

    1. In WAS admin console, expand...

        Servers | Server Types | WebSphere application servers | server_name | Container Settings | Web Container Settings | Web container | Additional Properties | Session management

    2. Select Enable cookies.

    3. Enter a different cookie name in the Cookie name field, for example, LCSESSIONID.

    4. Click OK, click Save, and then click Save again.

    5. Repeat with each clustered server.

  2. Restart the appserver.

  3. Regenerate the plugin-cfg.xml file for the IBM HTTP Server in WAS admin console.:

    1. Open WAS admin console and expand...

        Servers | Server Types | Web servers

    2. Select the check box next to the IBM HTTP Server name.

      For example: webserver1.

    3. Click Generate Plug-in to regenerate the plugin-cfg.xml file.

    4. If necessary, click Propagate Plug-in to copy the plugin-cfg.xml file from the local directory where the Application Server is installed to the remote machine.

  4. Restart the IBM HTTP Server.


Schedule tasks

The Activities, Communities, Files, Forums, News, Search, and Wikis applications use the WAS scheduling service to perform regular tasks. You can use wsadmin commands to change the schedule by which a task runs or to disable a scheduled task altogether.

The scheduling service allows you to reliably process workloads using parallel processing, and to schedule resource-intensive tasks during off-peak hours when there is low traffic.

For more information about WAS scheduling service, see the WebSphere Application Server information center.

The WebSphere Application Server scheduling service is based on the Cron calendar, which uses predefined date algorithms to determine when a task should run. Connections tasks are configured by default to run on a certain schedule. You can change the time at which the scheduled tasks run using wsadmin commands to edit the configuration files for the associated application. Cron schedule values use the following syntax:

    second minute hourOfDay dayOfMonth month dayOfWeek

Some tips when specifying the cron schedule values:

  • Specify an asterisk (*) to indicate to select all options.

    For example, if you specify * as the value of the dayOfWeek parameter, the task runs every day of the week.

  • Always set seconds to 0, except for in the Profiles task, which runs every 20 seconds and is specified using the syntax */20.

    The */n syntax means take the first value in the range, and then every nth value. So, if you specified */3 in the month position, the task would run quarterly in January, April, July, and October.

  • dayOfMonth and dayOfWeek are mutually exclusive; always set one to ?.

    The ? indicates that no value is being provided.

  • You can indicate in a single cron expression that you want a task to run multiple times by using multiple values separated by commas or you can specify a range by separating the values with a dash.

    • You can specify the value in dayOfWeek using SUN, MON or using numbers 1,2 where 1 represents Sunday.

    • You can specify JAN, FEB for the value of month or by using numbers 1,2 where 1 represents January.

    • To specify one or more seconds, use the values 0, 1, ... 59.

    • To specify one or more hours, use the values 0, 1, ... 23.

    For example, specifying 1,4,7,10 in the month position specifies that you want the task to run quarterly. Specifying 2-6 in the dayOfWeek position indicates that you want the task to run Monday through Friday.

  • If it is easier for you to read and define the schedule by separating out the values into multiple cron expressions, you can do so and use a | to concatenate the values into a composite schedule.

    For example, you could indicate to schedule to run quarterly at 3:45 PM on the second day of the month using the following string: 0 45 15 2 1 ? | 0 45 15 2 4 ? | 0 45 15 2 7 ? | 0 45 15 2 10 ?

To see examples of cron expressions and what they mean, see Examples of scheduler values.

For more information on the Cron calendar, see the WebSphere Application Server information center.

To disable a scheduled task, use wsadmin commands.


Examples of scheduler values

Use the examples provided here to construct your own Cron calendar scheduler values or copy and paste these values into your wsadmin commands to reuse them.

    */30 * * * * ?
    Every 30 seconds

    0 */5 * * * ?
    Every 5 minutes starting at midnight. Be very sure to specify ‘0' for seconds

    0 0 * * * ?
    Every hour

    0 0 * ? * *
    Every hour on the hour

    0 50 * * * ?
    Every hour at 50 minutes past the hour

    0 15 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23 1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31 1,2,3,4,5,6,7,8,9,10,11,12 ?
    Every hour at 15 minutes past the hour

    0 0 0-22/2 * *
    Every other hour starting at midnight.

    0 0 4/5 * * ?
    Every 5 hours starting at 4 AM. This would run at 4:00, 9:00, 14:00, and 20:00.

    0 0 0,8,16 * * ?
    Midnight, 8 AM, and 4 PM every day

    0 0 11 * * ?
    Every day at 11 AM

    0 0 0 * * ?
    Every day at midnight

    0 0 2 ? * *
    Every day at 2 AM

    0 0 12 ? * MON,TUE,WED,THU,FRI
    Weekdays at noon. MON and so on represent the days of the week.

    0 0 23 ? * 2-6
    Monday through Friday at 11 PM

    0 0 21 ? * 2-6/2
    Monday, Wednesday, and Friday at 9 PM

    0 30 18 ? * SAT,SUN
    Weekend days at 6:30 PM

    0 0 2 ? * SUN
    Weekly on Sundays at 2:00 AM

    0 0 23 ? * SAT
    Weekly on Sat at 11 PM

    0 0 * 1 * ?
    Every hour on the first day of every month

    0 1 0 L * ?
    Last day of every month at 00:01 AM

    0 59 23 L * ?
    Every month on last day at 11:59 PM

    0 0 22 1 * ?
    First day of every month at 10 PM

    0 45 15 2 1,4,7,10 ?
    Quarterly on the 2nd day of the month (January, April, July, October) at 3:45 PM

    0 45 15 2 */3 ?
    Quarterly on the 2nd day of the month (January, April, July, October) at 3:45 PM

    0 45 15 2 1 ? | 0 45 15 2 4 ? | 0 45 15 2 7 ? | 0 45 15 2 10 ?
    Quarterly on the 2nd day of the month (January, April, July, October) at 3:45 PM

    0 30 3 1 1,7 ?
    January 1 and July 1 at 3:30 AM

    0 30 3 2 1 ? | 0 30 3 1 7 ?
    January 2 and July 1 at 3:30 AM

    0 0 0 4 7 ?
    Once a year at midnight on the 4th of July

    0 30 9 4 7 ?
    Once a year at 9:30 AM on the 4th of July

    0 45 15 2 1 ?
    Once a year on January 2 at 3:45 PM


Clearing all scheduled tasks

Use administrative commands to clear the scheduler of all tasks.

Clear scheduled tasks only if you must re-create all scheduler tasks. If you see an exception that relates to LTPA tokens in the system log before each task runs, clear the scheduled tasks. An exception might occur, for example, after any of the following changes:

  • A new LTPA token is imported into Connections.

  • A new LTPA token is imported from a server in another cell as the result of enabling single sign-on.
  • Reverting the databases from a production environment to a staging environment.
  • Generate new LTPA keys due to a corporate security policy or LTPA timeout.

Do not run the command that is documented here unless the applications are running. The administrative command that is used in this procedure interacts with scheduler MBeans commands. The WebSphere Application Server scheduler is not application-aware, so if the cluster that hosts an application is running, the scheduler attempts to run the scheduled tasks for that application, even if the application itself is stopped. Each attempt to run a scheduled task for a stopped application results in an error message to the log.

If you disable or stop an application, cancel any scheduled tasks that are associated with it.

  1. Start wsadmin:

      cd WAS_HOME/profiles/Dmgr01/bin
      ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

  2. Use the wsadmin client to access the Connections configuration files.

    1. Access the Connections configuration file: execfile("connectionsConfig.py")

      If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

  3. To ensure that all clusters and applications are started and that no scheduled tasks are currently running, retrieve a list of tasks

      Scheduler.listAllTasks()

    From the returned list, determine what to do next by using these guidelines:

      Wsadmin client message
      Recommended action

      Status = running
      Wait until the task is completed.

      Skipping app_name application
      The cluster that hosts the application is not running. Restart the cluster.

    When you list scheduled tasks, output like the following sample is displayed: 

    wsadmin>Scheduler.listAllTasks()

Task Name  |  Status  |  Next Fire Time |  Interval
Communities tasks LifecycleRetryQueuedEvents  SCHEDULED  Mon Jun 24 09:01:00 EST 2013  0 1 0-23/3 ? * *
EventLogCleanup               SCHEDULED  Mon Jun 24 09:30:00 EST 2013   0 30 0-23/3 ? * *

Activities tasks TrashAutoPurgeJob             SCHEDULED  Sun Jun 23 02:00:00 EST 2013   0 0 2 ? * SUN
ActivityAutoCompleteJob       SCHEDULED  Sat Jun 22 23:00:00 EST 2013   0 0 23 ? * SAT
DatabaseRuntimeStats          SCHEDULED  Mon Jun 24 09:00:00 EST 2013   0 0 * * * ?
30MinStats                    SCHEDULED  Mon Jun 24 09:00:00 EST 2013   0 0/30 * * * ?
DailyStats                    SCHEDULED  Mon Jun 24 11:00:00 EST 2013   0 0 11 * * ?

Forums tasks TrashAutoPurgeJob             SCHEDULED  Sun Jun 23 02:00:00 EST 2013   0 0 2 ? * SUN

Profiles tasks Profiles Worker Process       SCHEDULED  Mon Jun 24 08:36:46 EST 2013   20seconds

Files tasks SearchClearDeletionHistory    SCHEDULED  Mon Jun 24 16:00:00 EST 2013   0 0 0,8,16 * * ?
MetricsDailyCollection        SCHEDULED  Tue Jun 25 00:00:00 EST 2013   0 0 0 * * ?
TagUpdateFrequency            SCHEDULED  Mon Jun 24 10:00:00 EST 2013   0 0 0-22/2 * * ?
DirectoryGroupSynch           SCHEDULED  Mon Jun 24 09:00:00 EST 2013   0 0 * * * ?
FileActuallyDelete            SCHEDULED  Mon Jun 24 09:00:00 EST 2013   0 0 0-23/3 * * ?|0 30 1-23/3 * * ?

Wikis tasks SearchClearDeletionHistory    SCHEDULED  Mon Jun 24 16:00:00 EST 2013   0 0 0,8,16 * * ?
MetricsDailyCollection        SCHEDULED  Tue Jun 25 00:00:00 EST 2013   0 0 0 * * ?
TagUpdateFrequency            SCHEDULED  Mon Jun 24 10:00:00 EST 2013   0 0 0-22/2 * * ?
DirectoryGroupSynch           SCHEDULED  Mon Jun 24 09:00:00 EST 2013   0 0 * * * ?
FileActuallyDelete            SCHEDULED  Mon Jun 24 09:00:00 EST 2013   0 0 0-23/3 * * ?|0 30 1-23/3 * * ?

News tasks NewsDataCleanup               SCHEDULED  Mon Jun 24 23:00:00 EST 2013   0 0 23 ? * *
NewsCheckUpdatedPersons       SCHEDULED  Mon Jun 24 08:50:00 EST 2013   0 50 * * * ?
EmailDigestDelivery           SCHEDULED  Mon Jun 24 09:00:00 EST 2013   0 0 * ? * *
MetricsCollector              SCHEDULED  Tue Jun 25 02:00:00 EST 2013   0 0 2 ? * *
PersonSpreadTranche           SCHEDULED  Tue Jul 02 22:00:00 EST 2013   0 0 22 1 * ?

Search tasks 20min-file-retrieval-task     SCHEDULED  Mon Jun 24 08:41:00 EST 2013   0 1/20 0,2-23 * * ?
15min-search-indexing-task    SCHEDULED  Mon Jun 24 08:46:00 EST 2013   0 1/15 0,2-23 * * ?
nightly-optimize-task         SCHEDULED  Tue Jun 25 01:30:00 EST 2013   0 30 1 * * ?
nightly-sand-task             SCHEDULED  Tue Jun 25 01:00:00 EST 2013   0 0 1 * * ?

wsadmin>

  4. After you complete the suggested actions, run the following command to clear the scheduled tasks

      Scheduler.clearAllTasks()

  5. Restart the clusters to force the scheduled tasks to be re-created:

    1. From WAS admin console, expand...

        Servers | Server Types | WebSphere application servers

    2. Select the check box for one server per cluster, and click Restart.


Maintaining application databases

Each Connections application stores data in a database, and some also store data on a file system. You must back up these databases and file systems on a regular schedule using the methods documented by the vendor from whom you purchased the database and file system that you are using.

If you use IBM DB2 databases, Connections provides a few SQL scripts to help you perform maintenance tasks on them, such as collecting statistics and compacting. You can collect statistics while Connections is running; there is no need to stop the applications nor bring the databases offline. However, stop all applications that access the databases before compacting and defragment them.

When you restore data for an application that is also available from the Communities application, also restore the data in the Communities application to keep the two in sync.

See Recovering from a database failure for more details.


Gathering DB2 database statistics daily

Use the scripts that are provided with Connections to gather statistics about DB2 database usage.

Up-to-date statistics are necessary for optimal performance. You can collect statistics while Connections is running. However, it is better to schedule collection during off-peak hours by using a tool such as DB2 Task Scheduler.

This procedure is relevant for DB2 databases only. Oracle and SQL Server databases gather statistics automatically.

To gather DB2 database statistics:

  1. Copy the statistics script, runstats.sql, to the root directory of the application database for which you want to gather statistics. The script is stored in the following directory:

    • AIX or Linux: /Lotus_Connections_Install/connections.sql/application_subdirectory/db2
    • IBM i: /Lotus_Connections_Install/connections.sql/application_subdirectory/db2

      Windows: \Lotus_Connections_Install\connections.sql\application_subdirectory\db2

    where application_subdirectory is the script file storage directory of the application for which you are compacting the database. Choose one of the following subdirectories:

    • activities
    • blogs
    • communities
    • dogear
    • files
    • forum
    • homepage
    • metrics
    • profiles
    • wikis

  2. Log into the database server with an ID that has administrative privileges.

  3. Open a command prompt and then change to the directory to which you copied the script.

  4. Use the following command to run the application scripts:

    • For Activities, Blogs, Communities, and Forums: db2 -td@ -vf runstats.sql

    • For Bookmarks and Profiles: db2 -tvf runstats.sql

    • For Home page: db2 -tvf updateStats.sql

    • For Files, Metrics, and Wikis: db2 -td@ -vf updateStats.sql


Improving access performance and defragmenting DB2 database data

Use the scripts that are provided with Connections to improve access performance and to reclaim fragmented space in an application database.

The script that you run to improve access performance and reclaim the fragmented space of the database takes the database offline.

To prepare the database to be taken offline, stop WAS instances for each application that you plan to administer.

This task is relevant for DB2 databases only. Oracle and SQL Server compact data automatically.

You do not have to run this script frequently. Schedule this task during another maintenance task that requires you to take the application offline.

  1. Copy the reorg.sql script to the root directory of the application database for which you want to improve performance. The scripts are stored in the following directory:

    • AIX or Linux: /Lotus_Connections_Install/connections.sql/application_subdirectory/db2
    • IBM i: /Lotus_Connections_Install/connections.sql/application_subdirectory/db2

      Windows: \Lotus_Connections_Install\connections.sql\application_subdirectory\db2

    where application_subdirectory is the directory of the application for which you are improving database access performance. Choose one of the following subdirectories:

    • activities
    • blogs
    • communities
    • dogear
    • files
    • forum
    • homepage
    • metrics
    • profiles
    • wikis

    To improve access performance of the Communities forum database, copy the reorg_forum.sql file from the communities subdirectory.

  2. From WAS admin console, stop the servers that host the application to administer:

    1. Log in to WAS admin console as an administrator.

    2. Expand Servers > Server Types and then select WebSphere application servers.

    3. Select the servers that host the applications for which you want to improve access performance.

    4. Click Stop.

  3. Log in to the database server by using an ID that has administrative privileges.

  4. cd directory to which you copied the script.

  5. Run the application scripts:

    • For Activities, Blogs, Communities, Forums, Files, Metrics, and Wikis: db2 -td@ -vf reorg.sql

    • For Bookmarks, Home page, and Profiles: db2 -tvf reorg.sql

  6. Restart the application servers.


Configure notifications

Enable support for email notifications in Connections applications.

If you did not create a mail session in WebSphere Application Server during the installation of the product, you can configure it afterward to enable support for email notifications. Complete this task only if you did not configure notifications during the installation.

When you enable notifications, users are kept informed about new information and events that take place in Connections applications.

For more information about notification types and events, see the Notification types and events topic.

You can configure notifications to be sent in one the following ways:

    Send mail from a server found by doing a lookup

    Performs a lookup of DNS MX records to retrieve a list of available SMTP servers. If the DNS lookup does not find any available SMTP servers, then notification fails. If one or more SMTP servers are returned by the lookup, then Connections attempts to send the notification email through one server and then the next until the email is sent successfully. This option avoids the risk of a single point of failure.

    Send mail from a specific SMTP server

    Uses a single SMTP server. Define the SMTP server and its associated settings as a mail session managed by WebSphere Application Server. This single SMTP server is used to send email notifications. If the server is unavailable, then notification fails.


Notification types and events

Various notification types and events are supported.

The following notification types are supported:

    Broadcast
    Sent solely to the recipients by email. Broadcast notifications are not shown on the Home Page.

    Directed
    Sent from one user, or the system, to another user or set of users. Users can opt to not receive these notifications by email by changing their email preferences. Directed notifications are always visible to the recipients and the sender from the Home Page.

    Follow
    Generated for users who follow a particular resource and who choose to have individual notifications for that type of resource.

    Moderation
    Used solely in the content moderation process.

    Response
    Used to inform a user when a comment or reply was left on their content. Response notifications go to the owner of the content only, not to followers. These notifications are sent if the user configured their email preferences to receive responses through individual emails.

The following notification events are available for Connections applications:

    Activities
    Notification events are enabled by default. Email event types are enabled only if you enabled email notifications during the installation of the product.


    Notification name Description Notification type
    add-member When an activity owner adds members to an activity, a notification is automatically sent to them to inform them about the activity. Directed
    autocomplete Activity owners receive an email to warn them that one of their inactive activities will be marked complete if it is not updated. Directed
    create When a standard activity is created, each member is sent a notification about the new activity. When a community activity is created, notifications are sent only if individual members are added. No notifications are sent when an entire community membership list is added. Directed
    notify Activity members can send other members notifications about entries. Directed

    Blogs


    Notification name Description Notification type
    approved When an entry, idea, or comment is approved, a notification is sent to the author and the last editor. Moderation
    confirmflagged When a flag on a post, idea, or comment is confirmed, a notification is sent to the flag creator. Moderation
    notify Notifications that one user sends to other users to inform them about useful blog posts. Directed
    notifyassigned-author When a blog owner assigns author permission for a blog, a notification is sent to the member to inform them of the blog and their access level. Directed
    notifyassigned-draft When a blog owner assigns draft permission for a blog, a notification is sent to the member to inform them of the blog and their access level. Directed
    notifyassigned-owner When a blog owner assigns owner permission for a blog, a notification is sent to the member to inform them of the blog and their access level. Directed
    notify-idea Notifications that one user sends to others to inform them about useful ideas. Directed
    notifyflagged When a post, idea, or comment is flagged as inappropriate, a notification is sent to content reviewers, which includes anyone in the global-moderator role. Moderation
    notifyreposted When an entry or idea is modified and reposted, a notification is sent to content reviewers, which includes anyone in the global-moderator role, to inform them about it. Moderation
    notifyreview When a new entry, idea, comment, or trackback comment is posted and put in pending status, a notification is sent to content reviewers to notify them that they must review it. Content reviewers include anyone in the global-moderator role. Moderation
    ownermsg When a new comment is posted, a notification is sent to the entry or idea creator. Response
    quarantined When an entry, idea, or comment is quarantined, a notification is sent to the authors, which includes the post creator, its last editor, and blog owners. Moderation
    rejected When an entry, idea, or comment is rejected, a notification is sent to the author and last editor. Moderation
    restored When an entry, idea, or comment is restored, a notification is sent to the author, last editor, and blog owners. Moderation
    returned When an entry or idea is returned, a notification is sent to the post authors, which includes the post creator, its last editor, and blog owners. Moderation

    Bookmarks


    Notification name Description Notification type
    brokenurl Broken URL notifications display in the activity stream on the Home page. Directed
    notify Users can send notifications to other users to inform them about useful bookmarks. Directed
    notifyReplaceURL Administrator can send a notification to the bookmark owner to report the update of a link. This notification is triggered by an MBean

    Communities


    Notification name Description Notification type
    broadcastMail Members can send notifications to other members to inform them about important events. Broadcast
    invite Members can send a notification to a non-member to invite them to join the community. Directed
    memberAdded Notifications are automatically generated and sent to members when they are added to a community. Directed
    memberRemoved Notifications are automatically generated and sent to members when they are removed from a community. Directed
    notifyEvent Community members can notify other members about specific events by opening the event and selecting More Actions > Notify Other People. The event owner can also send this notification when the event is created. Directed
    requestToJoin Users can request to join a community by sending a notification to the community's owner. Directed

    Files


    Notification name Description Notification type
    collectionMediaAdd Notification sent to users when a file is added to a folder or community that they are following. Follow
    collectionMemberUpdate Notification sent to users when a folder is shared with them or when their access level changes. This notification applies to individual users, not groups. Directed
    commentAdd Notification sent to users when a comment is created on a file that they are following. Users can follow files by opening the file page and clicking Follow. Follow
    communityVisibilityUpdate Notification sent to owners of a community when the community changes from non-public to public and when private files that are shared with the community are removed from it. Directed
    mediaEdit Notification sent to users when a file that they are following is edited. Users can follow files by opening the file page and clicking Follow. Follow
    mediaShare Notification sent to users when files are shared with them. Directed

    Moderation


    Notification name Description Notification type
    notifyApproved When an entry is approved, a notification is sent to the entry authors, including the entry's creator and its last editor, and the entry owners. Moderation
    notifyAutoQuarantined When an entry is flagged as inappropriate a specific number of times, a notification is sent to the Global Moderator and Reviewers. The number of inappropriate flags is specified in the autoQuarantine property in the contentreview-config.xml file.

    For example, if you enter a value of 5 in autoQuarantine, a notification is sent when an entry is flagged for the fifth time.

    		Moderation
    notifyFlagged When an entry is flagged as having inappropriate content and is put in pending status, a notification is sent to content reviewers, including anyone in the global-moderator role. Moderation
    notifyPending When an entry is added and needs approval, a notification is sent to the entry author. Reviewers and moderators are notified separately by a notifyReview email. Moderation
    notifyQuarantined When an entry is quarantined, a notification is sent to the entry authors, including the entry's creator, its last editor, and the entry owners. Moderation
    notifyRejected When an entry is rejected, a notification is sent to the entry authors, which includes the entry's creator, its last editor, and the entry owners. Moderation
    notifyRestored When an entry is restored, a notification is sent to the entry authors, which includes the entry's creator, its last editor, and the entry owners. Moderation
    notifyReview When an entry is added and put in pending status, a notification is sent to content reviewers, which includes anyone in the global-moderator role. Moderation

    News


    Notification name Description Notification type
    dailyDigest If email notifications are enabled on your system, your preferences are set to the Daily Newsletter option by default. Each option corresponds to a subview within the Updates News Feed view on the Home page. All options can be customized to your preferred frequency. Follow
    followIndividual If email notifications are enabled on your system, you have options that are set to Individual E-mails option by default. Each option corresponds to a subview within the Updates News Feed view. All options can be customized to any frequency. Any updates within the corresponding News Feed subview by a person other than yourself are sent to you in individual emails. Follow
    replyToError When a user replies to a ReplyTo enabled notification and an error occurs at the server, a notification is generated and sent to the user. Directed
    weeklyDigest If email notifications are enabled on your system, your preferences are set to the Weekly Newsletter option by default. Each option corresponds to a subview within the Updates News Feed view. Options can be customized to a desired frequency. Follow

    Profiles


    Notification name Description Notification type
    notify If a person designates someone else as a colleague, the colleague is sent an invitation to join that person's network. Directed
    notifyBoardOwnerForComment Board owners are notified when someone comments on their message board. Response
    notifyBoardOwnerForEntry Board owners are notified when someone posts a message in their message board. Response
    notifyEntryOwnerForComment Board owners are notified when someone comments on a message board entry. Response

    Wikis


    Notification name Description Notification type
    commentAdd Notification sent to users when a comment is created on a wiki page they are following, or on any page in a wiki they are following.

    Users can follow wiki pages or wikis by opening a page and clicking Follow, and then Follow this Page or Follow this Wiki.

    		Follow
    mediaEdit Notification sent to users when an event occurs in a wiki page or wiki they are following. Events include title or description edits, new tags, and new or deleted pages, edits, or comments.

    Users can follow wiki pages or wikis by opening a page and clicking Follow, and then Follow this Page or Follow this Wiki.

    		Follow
    roleAdd Notification sent to users when they are made members of a wiki or when their wiki access level is changed. This notification applies to individual users, not groups. Directed


Access the notification configuration file

Configure notifications with notification-config.xml.

To access configuration files, you must use the wsadmin client.

After making changes to notification configuration settings, check in the configuration file and restart the server to apply the changes. Perform the check-in in the same wsadmin session in which you checked out the files.

To change notification configuration settings....

  1. Start the wsadmin client

      cd WAS_HOME\profiles\Dmgr01\bin

    You must start the client from this directory or subsequent commands that you try to run will not execute properly.

  2. Access the Connections configuration files

      execfile("connectionsConfig.py")

    If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

  3. Check out notification-config.xml

      LCConfigService.checkOutNotificationConfig("temp_dir","cell_name")

    where

    • temp_dir is the temporary directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

    • cell_name is the WAS cell to which you installed the application for which you are enabling mail. This argument is case-sensitive, so type it with care.

    If you installed Connections into multiple WAS profiles, for example: Activities is installed on AppSrv01, Blogs is installed on AppSrv02, and so on), then there is a notification-config.xml file for each application. For this type of deployment, edit each notification-config.xml associated with each WebSphere Application Server profile.

    For example:

    • AIX or Linux:

        LCConfigService.checkOutNotificationConfig("/opt/temp","Cell01")

      Windows:

        LCConfigService.checkOutNotificationConfig("c:/temp","Cell01")

    • IBM i

        LCConfigService.checkOutNotificationConfig("/temp","Cell01")

  4. From the temporary directory to which you checked out notification-config.xml, open it in a text editor and make the necessary changes.

  5. Save and close notification-config.xml.

  6. Check in the configuration

      LCConfigService.checkInNotificationConfig("<temp_dir>","<cell-name>")

  7. Update the version stamp property to force a refresh of users' web browsers, so that they see the email preference changes the next time they access the product.


Sending mail from any available mail server

Configure Connections to perform a lookup of DNS MX records to retrieve a list of available SMTP servers. If the DNS lookup does not find any available SMTP servers, then email notifications fail to be delivered. If one or more SMTP servers are returned by the lookup, then Connections attempts to send the email through one, and then the next until the email is sent successfully.

Mail is configured as part of the installation process. Only perform this procedure if you did not enable mail during the installation or you want to change the mail configuration.

You can choose to have Connections perform a DNS lookup of multiple SMTP server to find one that is available to send the message or you can configure notifications to be sent from a single, dedicated SMTP server. If you are interested in the latter configuration, see Sending mail from a dedicated mail server. If you choose to enable mail from any available server, make sure your DNS is configured with valid MX records to ensure that available SMTP servers can be found.

  1. Start the wsadmin client

      cd WAS_HOME\profiles\Dmgr01\bin

    You must start the client from this directory or subsequent commands that you try to run will not execute properly.

  2. Access the Connections configuration files

      execfile("connectionsConfig.py")

    If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

  3. Check out notification-config.xml using the following command

      LCConfigService.checkOutNotificationConfig("temp_dir","cell_name")

    where temp_dir is a temporary directory and cell_name is the WAS cell to which you installed the application for which you are enabling mail. When you specify a path to the temporary directory on a system running Microsoft Windows, use a forward slash for the directory.

    For example: "C:/temp".

    AIX, Linux, and IBM i only: The temporary directory must grant write permissions or the command will not run successfully.

  4. From the temporary directory to which you checked out notification-config.xml, open it in a text editor.

  5. Search for the <emailChannelConfig> element, and then change the value of the <useJavaMailProvider> element from true to false

      <useJavaMailProvider>false</useJavaMailProvider>

  6. Remove the punctuation commenting out the <smtpJNDILookup> element by removing the !-- from the opening element and -- from the closing element.

    For example, change the following XML markup 

      <!--smtpJNDILookup>
...
</smtpJNDILookup-->
    to the following markup: 

    <smtpJNDILookup>
...
</smtpJNDILookup>

  7. Set the value of the <smtpJNDILookupURL> element within the <smtpJNDILookup> XML block to a valid DNS lookup web address for your environment.

    For example, the following web address performs a lookup of MX records for the acme.com domain using the default DNS server on the system on which Connections is running:

      dns:///acme.com

    This value performs the same lookup on a specific DNS server that has an IP address of 192.168.0.2.

      dns://192.168.0.2/acme.com

  8. Configure or comment out any of the remaining properties in the <smtpJNDILookup> element block as needed for your environment. Some of the elements for which you can specify values are defined as follows:

      <authEntry>
      Specifies a WebSphere managed Java 2 Connector alias that specifies the username and password to use when connecting to an SMTP server requiring authentication.

      <javamail>
      Specifies valid JavaMail properties.

      For example: 

      <javamail>
  <property name="mail.debug">false</property>
  <property name="mail.smtp.connectiontimeout">120000</property>
  <property name="mail.smtp.timeout">120000</property>
  <property name="mail.smtp.port">465</property>
  <property name="mail.smtp.socketFactory.port">465</property>
  <property     name="mail.smtp.socketFactory.class">javax.net.ssl.SSLSocketFactory
  </property>
  <property name="mail.smtp.socketFactory.fallback">false</property>
</javamail>

      The smtp properties configure a secure connection to the SMTP server using SSL. The time out properties define the amount of time for the notification to wait for the server to complete the request. If the time limit is reached, an exception is written to the server log, and an error is displayed to the Activities user that requested the notification. These properties prevent resources from being consumed in the event that the SMTP server is unavailable. The time interval is specified in milliseconds. A value of 120,000 is two minutes.

      See the JavaMail documentation for more information about these properties.

    Within the <javamail> section of notification-config.xml, add the following property: <property name="mail.smtp.sendpartial">true</property> This ensures that a message with some valid and some invalid email addresses will be sent, so that the valid email addresses will still receive the message. If set to false or not defined, an invalid email address will cause the message not to be sent to any email addresses.

  9. The <maxRecipients> element defines the maximum number of people to whom you can send a notification at one time. The default value for this element is 50, but you can change it.

      <maxRecipients>50</maxRecipients>

  10. Save and close notification-config.xml.

    You must check out and edit the same file in the procedure described in Enabling email notifications. If you plan to complete that procedure next, keep notification-config.xml open and checked out.

  11. Check in the configuration

      LCConfigService.checkInNotificationConfig("<temp_dir>","<cell-name>")

  12. Stop and restart Connections.

You must complete the steps described in Enabling email notifications before users can send and receive email notifications.


Sending mail from a dedicated mail server

Configure Connections notifications to be sent from a specific SMTP server that is managed by WebSphere Application Server. If the designated mail server is unavailable, then notification emails fail to be delivered.

Mail is configured as part of the installation process. Only perform this procedure if you did not enable mail during the installation or you want to change the mail configuration.

You can choose to configure notifications to be sent from a single SMTP or have Connections perform a lookup of multiple SMTP server to find one that is available to send the message. If you are interested in the latter configuration, see Sending mail from any available mail server.

  1. Log into the IBM WebSphere Application Server Integrated Solutions Console.

  2. Expand Resources and select Mail > Mail sessions.

  3. Select Cell scope, and then create a new session.

  4. Specify values for the following fields:

      Name
      Specify Connections Notification or another descriptive string.

      JNDI name
      Specify mail/notification as the value of the JNDI name.

  5. Specify the following custom properties to define time outs that will prevent resources from being consumed in the event that the SMTP server is unavailable

      mail.smtp.timeout=120000
      mail.smtp.connectiontimeout=120000

    The time interval is specified in milliseconds. A value of 120,000 is two minutes.

  6. In the Outgoing Mail Properties section, specify the fully qualified host name or IP address of the SMTP server to use in the Server field.

  7. If the SMTP server requires authentication, then provide values for the following fields:

      User
      User ID used to connect to the SMTP server.

      Password
      Password associated with the user ID used to connect to the SMTP server.

      Verify Password
      Repeat the password specified in the previous field.

  8. If the SMTP server requires traffic to be sent over SSL, then add the following customer properties, and then specify values for them by clicking the Custom properties link, and then clicking New:

      mail.smtp.port
      Specifies the SMTP port number, which is often 465.

      mail.smtp.socketfactory.port
      Specifies the SMTP port number, which is often 465.

      mail.smtp.socketfactory.class
      Specifies the SSL socket factory class.

      mail.smtp.socketFactory.fallback
      Specifies whether an unsecure connection can be made if SSL is not available. This property accepts the following values: true or false.

    For example: 

    mail.smtp.port=465
mail.smtp.socketfactory.port=465
mail.smtp.socketfactory.class=javax.net.ssl.SSLSocketFactory
mail.smtp.socketFactory.fallback=false

  9. Click OK, and then save your changes.

  10. Start the wsadmin client...

      cd WAS_HOME\profiles\Dmgr01\bin

    You must start the client from this directory or subsequent commands that you try to run will not execute properly.

  11. Update the notification configuration file to indicate to use a mail session managed by WebSphere Application Server.

    1. Access the Connections configuration files...

        execfile("connectionsConfig.py")

      If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

    2. Check out notification-config.xml using the following command...

        LCConfigService.checkOutNotificationConfig("temp_dir","cell_name")

      where temp_dir is a temporary directory and cell_name is the WAS cell to which you installed the application for which you are enabling mail. When you specify a path to the temporary directory on a system running Microsoft Windows, use a forward slash for the directory.

      For example: "C:/temp".

      AIX, Linux, and IBM i only: The temporary directory must grant write permissions or the command will not run successfully.

    3. From the temporary directory to which you checked out notification-config.xml, open it in a text editor.

    4. Search for the <emailChannelConfig> element, and then uncomment the following line of XML markup if it is commented out... 

      <useJavaMailProvider>true</useJavaMailProvider>

    5. Comment out the <smtpJNDILookup> element if it is not already. 

      <!--smtpJNDILookup>
...
</smtpJNDILookup-->

    6. Save and close notification-config.xml.

      You must check out and edit the same file in the procedure described in Enabling email notifications. If you plan to complete that procedure next, keep notification-config.xml open and checked out.

    7. Check in the configuration ...

        LCConfigService.checkInNotificationConfig("<temp_dir>","<cell-name>")

    8. Stop and restart Connections.

You must complete the steps described in Enabling email notifications before users can send and receive email notifications.


Enable email notifications

Edit configuration settings to enable email notifications in the Connections applications if you did not do so during the installation.

Only complete this procedure if you did not enable email notifications during the product installation. You must complete the steps described in Configuring notifications before you can start this procedure.

You might choose not to enable email notifications if you have configured Connections to hide email addresses, for example. Even when you do not enable email notifications, if you installed the Home page application, the product still supports a subset of notifications that can be displayed in the Home page application. The subset includes the notifications of type "Directed," which are listed in Configuring notifications.

When you set the enabled property to false globally or for a specific source, this disables all notification events for the Home page. Notification emails will not be sent and notifications will not display in the My Notifications view in the Home page. For this reason, when you are disabling email only, it is important to ensure that you only set the email channel to false for a specific notification type.

To configure email notifications:

  1. Start the wsadmin client...

      cd WAS_HOME\profiles\Dmgr01\bin

    You must start the client from this directory or subsequent commands that you try to run will not execute properly.

  2. Access the Connections configuration files...

      execfile("connectionsConfig.py")

    If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

  3. Check out notification-config.xml using the following command...

      LCConfigService.checkOutNotificationConfig("temp_dir","cell_name")

    where

    • temp_dir is the temporary directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

      AIX, Linux, and IBM i only: The temporary directory must grant write permissions or the command will not run successfully.

    • cell_name is the WAS cell to which you installed the application for which you are enabling mail. This argument is case-sensitive, so type it with care.

    To enable mail for all the applications and if you installed Connections into multiple WAS profiles, for example: Activities is installed on AppSrv01, Blogs is installed on AppSrv02, and so on), then there is a notification-config.xml file for each component. For this type of deployment, edit each notification-config.xml associated with each WebSphere Application Server profile.

    For example:

    • AIX/Linux...

        LCConfigService.checkOutNotificationConfig("/opt/temp","Cell01")

      Windows...

        LCConfigService.checkOutNotificationConfig("c:/temp","Cell01")

    • IBM i...

        LCConfigService.checkOutNotificationConfig("/temp","Cell01")

  4. From the temporary directory to which you checked out notification-config.xml, open it in a text editor.

  5. Find the <config> element with the ID attribute equal to notification-config.

  6. Search for the <source name="<applicationName>" string to find the section of XML markup that defines the notification settings for the application for which you want to enable email notifications.

  7. Change the value of the enabled attribute associated with the email channel element to true.

    For example: 

    <source   name="Activities"   enabled="true"   defaultFollowFrequency="DAILY">
   <type name="notify" notificationType="DIRECTED">
<type name="notify" notificationType="DIRECTED">
 <channel name="email" enabled="true">
  <property name="sender">blogs-admin@example.com</property>
  <property name="ftl">notify.ftl</property>
 </channel>
 <channel name="event" enabled="true">
  <property name="eventName">blogs.notification.notify</property>
  <property name="transformerClass">com.ibm.lotus.connections.core.notify.channels.event.BlogsNotificationEventTransformer</property>
 </channel>
</type>
...
</source>

    When you disable notifications during the installation process, all the email channels are set to false. Source events are left at true because notification events are still valid to be sent and displayed in the Home page activity stream. Setting the entire source to false disables all events, which means that notification emails will not be sent and will not display in the My Notifications view in the Home page.

  8. Save and close notification-config.xml.

  9. Check in the configuration ...

      LCConfigService.checkInNotificationConfig("temp_dir","cell-name")

    If you plan to specify administrator email addresses now, keep notification-config.xml checked out; edit values in it to complete the next procedure.

See Defining valid administrator email addresses for some additional steps that you must take to configure automatic notifications in Activities.


Set the default frequency of email digests

You can control the frequency with which email digests from Connections are sent by configuring settings in notification-config.xml. You can also lock the default frequency for a specific application or category using settings in the configuration file.

To check out configuration files, use the wsadmin client.

See Start wsadmin for details.

By updating settings in notification-config.xml, you can specify the default frequency with which email digests are sent to users. You can also lock the default frequency for specific applications or categories so that users cannot update the frequency settings for those applications or categories from the Email Preferences page. When you lock the default frequency for email digests, the setting is applied to all users. The frequency options that display on the Email Preferences page are grayed out, and a lock symbol indicates to users that the settings cannot be updated. Users can continue to select preferences for any applications for which the default frequency is not locked. User preferences are restored if you set the value of the frequencyLocked property to false at a later time.

The following sections of notification-config.xml contain the default frequency settings for Connections applications:

  • defaultEmailPreferences.categories. This section contains email setting frequencies for the following categories:

    • Responses. Controls the default email digest frequency for responses to content that users have created.
    • Tags. Controls the default email digest frequency for tags that users are following.
    • External. Provides an override for any third-party application that is enabled for email digests. It does not have a default frequency configured.

  • Connections application sources. The source for individual Connections applications contains the defaultFollowFrequency setting for those applications.

You can also specify the email digest frequency for updates from any third-party applications that are enabled for email digests.

To set the default email digest frequency for a third-party application, use the NewsActivityStreamService.updateApplicationRegistrationForEmailDigest command.

For more information about this command, see Registering third-party applications.

To set the default frequency for email digests....

  1. Start the wsadmin client...

      cd WAS_HOME\profiles\Dmgr01\bin

    You must start the client from this directory or subsequent commands that you try to run will not execute properly.

  2. Access the Connections configuration files...

      execfile("connectionsConfig.py")

    If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

  3. Check out notification-config.xml using the following command...

      LCConfigService.checkOutNotificationConfig("temp_dir","cell_name")

    where

    • temp_dir is the temporary directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

      AIX, Linux, and IBM i only: The temporary directory must grant write permissions or the command will not run successfully.

    • cell_name is the WAS cell to which you installed the application for which you are enabling mail. This argument is case-sensitive, so type it with care.

    For example:

    • AIX/Linux...

        LCConfigService.checkOutNotificationConfig("/opt/temp","Cell01")

      Windows...

        LCConfigService.checkOutNotificationConfig("c:/temp","Cell01")

    • IBM i...

        LCConfigService.checkOutNotificationConfig("/temp","Cell01")

  4. Use a text editor, open notification-config.xml from the temporary directory to which you checked it out.

  5. To set the default frequency of email digests for specific Connections applications:

    1. Look for the source of the application for which you want to configure frequency settings and update the value of the defaultFollowFrequency property to the required frequency: INDIVIDUAL, DAILY, or WEEKLY.

      For example, to configure settings for the Activities application so that users receive a daily digest containing the latest updates from Activities, set the value of the defaultFollowFrequency property to DAILY.

        <source name="Activities" enabled="true" defaultFollowFrequency="DAILY" frequencyLocked="false"/>

    2. To lock the default frequency so that users cannot change it, set the value of the frequencyLocked property to true.

        <source name="Activities" enabled="true" defaultFollowFrequency="DAILY" frequencyLocked="true"/>

  6. To configure the default frequency settings for email digests related to tags, responses to content, or to override the settings for third-party applications that are enabled for email digests:

    1. Look for the <categories> section of the file. 

      <categories>
  <!--Specifies how email notifications updates about tags a user is following are sent. Options are INDIVIDUAL (single, immediate emails) DAILY, WEEKLY or NONE. -->
  <category name="tags" defaultFollowFrequency="DAILY" frequencyLocked="false"/>
  <!-- Specifies how email notifications for responses to authored content are sent. Options are INDIVIDUAL (single, immediate emails) DAILY, WEEKLY or NONE. -->
  <category name="responses" defaultFollowFrequency="WEEKLY" frequencyLocked="false"/>
  <!-- Specifies how email notifications for updates a user is @mentioned in. Options are INDIVIDUAL (single, immediate emails) DAILY, WEEKLY or NONE. -->
  <category name="mentions" defaultFollowFrequency="INDIVIDUAL" frequencyLocked="false"/>
  <!-- Specifies how email notifications updates from third party application are sent Options are INDIVIDUAL (single, immediate emails) DAILY, WEEKLY or NONE. Note that this is only applicable when a specific frequency is not set for the 3rd party Application through the NewsActivityStreamService wsadmin command -->
  <category name="external" defaultFollowFrequency="DAILY"/>
</categories>

      The Library application has its own source. To configure the default frequency settings for email digests related to libraries, look for the following section...

        <source name="ecm_files" enabled="true" defaultFollowFrequency="INDIVIDUAL" frequencyLocked="false"/>

    2. Update the value of the defaultFollowFrequency property to the required frequency: INDIVIDUAL, DAILY, or WEEKLY.

      For example, to configure settings so that users receive a weekly digest containing the latest responses from Connections applications to content that they authored, set the value of the defaultFollowFrequency property for the responses category to WEEKLY.

        <category name="responses" defaultFollowFrequency="WEEKLY" frequencyLocked="false"/>

    3. To lock the default frequency, set the value of the frequencyLocked property to true.

        <category name="responses" defaultFollowFrequency="WEEKLY" frequencyLocked="true"/>

  7. Save your changes and close notification-config.xml.

  8. Check in the configuration ...

      LCConfigService.checkInNotificationConfig("temp_dir","cell-name")

  9. Refresh your changes to notification-config.xml.

    1. Access the News configuration file...

        execfile("newsAdmin.py")

    2. Refresh notification-config.xml with your updates by running the following command.

        NewsEmailDigestService.refreshDefaultEmailPrefsFromConfig()

        Refresh the defaultEmailPreferences section of notification-config.xml, including the source attributes, defaultFollowFrequency, and frequencyLocked settings.

        Updates to the default email preferences made in the configuration file are applied without the need for a server restart.

        This command does not take any parameters.


Configure Forums for email notification replies

Configure Forums so that users can reply to forum topics by email.

When a reply is added to a forum topic, an email is sent to followers of that forum and that topic. After you enable and configure notification replies, users receiving that email can respond by email. The content of that response is added as a new reply in the forum, after the original.

When users reply to notifications, a mail server uses a rule or trigger to direct the reply emails to a mailbox dedicated for this purpose. The Connections server uses a WebSphere Application Server mail session to process this mailbox periodically, adding content to the forums.

For this to work, an administrator must configure the mail server and mail session, and then enable the feature. Users must specify their email settings in Connections. For a user to receive notifications that they can reply to, the Notifications feature must be enabled on the server. The email notification reply feature must also be enabled on the server in the news-config.xml file. Each user who wants to receive email reply notifications must then have the feature enabled on their Settings screen.

Configure the mail session requires performing some simple steps in the WAS admin console. Configuring the mail server requires creating the dedicated mailbox, and creating a rule or trigger to direct replies to it. Steps for creating the rule or trigger will vary depending on the mail server.

For example, in Microsoft Exchange you create a transport rule; in Domino you create a trigger.

Connections supports the Simple Mail Transfer Protocol (SMTP) for sending notifications, and the Internet message access protocol (IMAP) and secure Internet message access protocol (IMAPS) for notification replies. Any mail server using these protocols can direct notifications and notification replies. This documentation only provides information on configuring the following mail servers to handle notification replies: IBM Lotus Domino 8.5.2, Microsoft Exchange 2007, and Microsoft Exchange 2010.

See Configure notifications for information on configuring notifications in an installed deployment.

In deployments with multiple Connections servers, the different servers cannot use the same mailbox. However, they can use different mailboxes on the same mail server, in which case each would require its own direction rules.


Configure Domino for email notification replies

Configure IBM Lotus Domino 8.5.2 to direct email notification replies to a dedicated mailbox.

Install and configure a IBM Lotus Domino 8.5.2 Messaging Server.

See the IBM Lotus Domino Messaging Server documentation.

The steps in this topic are required to configure Forums so that users can reply to forum topics by email. When a reply is added to a forum topic, an email is sent to followers of that forum and that topic. Users receiving that email can respond by email. The content of that response is added as a new reply in the forum, after the original.

A mail server uses a rule or trigger to direct reply emails to a mailbox dedicated for this purpose. The Connections server uses a WebSphere Application Server mail session to process this mailbox periodically, adding content to the forums. This topic documents how to configure a Domino server to direct reply emails to a dedicated mailbox.

  1. Open the Domino server and click the Domain tab.

  2. Expand Messaging in the navigator, and then click Configuration.

  3. Select the messaging server and click Edit Configuration.

  4. Click the Router/SMTP tab, then the Restrictions and Controls tab, and then the Rules tab.

  5. Click New Rule and create a rule that moves emails containing lcreplyto_ in the To field to the mailbox, for example...

      When To contains lcreplyto_ move to Database mail\mailin.nsf

    Where mail\mailin.nsf is the location and name of your dedicated email reply mailbox.

  6. Domino moves the emails to the Sent view instead of the Inbox of the mail database. Create a Notes agent to move the emails from the Sent view to the Inbox.

    1. Open the mail server in Notes.

    2. In the People & Groups tab, expand PeoplebyOrganization.

    3. Edit the account of the user used to direct reply mail.

    4. Click Open Mail File.

    5. Select the View > Agents menu item.

    6. Click New Agent.

    7. Add the following Lotusscript to the agent:

      The following script is only an example to be used for reference, and you will need to change or adjust the script based on your actual environment. 

      Sub Initialize
         Dim session As New NotesSession
    Dim db As NotesDatabase
    Dim view As NotesView
    Dim doc As NotesDocument
         Set db = session.CurrentDatabase
    Set view = db.getView("$Sent")
         Set doc = view.GetFirstDocument()
    While Not(doc Is Nothing)
        Call doc.PutInFolder("$inbox")
        Set doc = view.GetNextDocument(doc)
    Wend
          End Sub

    8. Open the agent properties:

      • In the Options section select Shared.

      • In the Runtime section select On schedule, and then select More than once a day.

      • In the Target field select All new & modified documents.

      • Set a schedule, for example have it run every 5 minutes, all day.

    9. Before running the script ensure you have adequate permissions to run it.


Configure Exchange for notification replies

Configure Microsoft Exchange 2007 or 2010 to direct email notification replies to a dedicated mailbox.

In environments with Microsoft Exchange, create a Transport Rule, on either the Edge Transport server or Hub Transport server, that identifies notification reply emails based on a pattern, and then directs that mail to the dedicated mailbox.

For example, you can create a rule that identifies emails in which the To header contains the unique domain name you've appended as a suffix to notification reply email addresses.

Example:

  • Rule type: Transport Rule, on Hub Transport
  • Condition: "when the message header contains text patterns"
  • Sub-condition: message header = "To"
  • Sub-condition: pattern = "lconn.acme.com$" (address ends with lconn.acme.com). Substitute lconn.acme.com with the domain you are using for notification reply emails.

    See Enabling notification replies for more information.

  • Action: "redirect the message to addresses"
  • Target address: "lconn@acme.com". Substitue lconn@acme.com with the address of the mailbox dedicated to storing notification reply emails.

The domain configured in news-config.xml for ReplyTo needs to be an Accepted Domain, which can be configured in the Hub Transport tab of the Exchange console.

For details on creating rules for identifying and directing email, see the Microsoft Exchange documentation.


Configure WebSphere Application Server for email notification replies

Configure an IBM WebSphere Application Server mail session to connect to a mailbox dedicated to storing email notification replies.

After you have set up your IBM Lotus Domino or Microsoft Exchange server to receive replies, you need to configure the IBM WebSphere Application Server mail session parameter to connect to the mailbox dedicated to storing email notification replies. If your environment requires authentication to connect to the mailbox containing the replies, you must use IBM WebSphere Application Server with FixPack 17 or later.

The steps in this topic are required to configure Forums so that users can reply to forum topics by email. When a reply is added to a forum topic, an email is sent to followers of that forum and that topic. Users receiving that email can respond by email. The content of that response is added as a new reply in the forum, after the original.

A mail server uses a rule or trigger to direct reply emails to a mailbox dedicated for this purpose. The Connections server uses a WebSphere Application Server mail session to process this mailbox periodically, adding content to the forums. This topic documents how to create the mail session.

The ReplyTo mailbox should be different from a Connections user's regular mailbox. It is better to have a mailbox set aside just to handle ReplyTo replies to avoid the risk of having notifications sent to that user being read back in as ReplyTo replies.

  1. Open the IBM WebSphere Administrative Console.

  2. Navigate to Resources > Mail > Mail Sessions.

  3. Select a scope, and then create a new mail session with the following properties:

    1. In the Name field type: lcreplyto

    2. In the JNDI name field type: mail/replyto

  4. In the Incoming Mail Properties section set the following properties:

    1. In the Server field, type the name of the mail server where the MailIn mailbox is located.

    2. In the Protocol field, type the name of the protocol the server will use. You must use either IMAP or IMAPS.

    3. In the User field, type the name of a user with access to the mailbox.

    4. In the Password field, type the password the user from Step c.


Enable notification replies

An administrator must edit settings in news-config.xml to allow users to reply to email notifications. Users must specify two preferences.

To edit configuration files, you must use the IBM WebSphere Application Server wsadmin client.

See Start wsadmin for details.

In news-config.xml you must enable support for the reply feature, and also provide a special ReplyTo address. If your deployment has a dedicated Connections mail domain, you must provide that as well. If your deployment uses an existing domain, provide either a prefix or suffix to add to the Connections domain.

For users to be able to reply to emails, certain of their Connections settings must be selected. They must click Settings, and then the Email Preferences tab. They must make sure Receive notifications from other people by email and Allow me to reply to notifications by email (this option is only available if mail-in is enabled in news-config.xml) are selected. In the Content that I am following section, they must make sure Forums is set to Individual Emails.

Users will not see Allow me to reply to notifications by email until you perform the steps in this topic to enable notification replies.

To configure the data synchronization task....

  1. Start the wsadmin client...

      cd WAS_HOME\profiles\Dmgr01\bin

    You must start the client from this directory or subsequent commands that you enter do not execute correctly.

  2. Start the News Jython script interpreter.

    1. Access the News configuration file...

        execfile("newsAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    2. Check out the News cell-level configuration file

      NewsCellConfig.checkOutConfig("working_dir", "cellName")

      ...where...

      • working_dir is the temporary directory to which you want to check out the cell-level configuration file. This directory must exist on the server where you are running wsadmin.

        AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

      • cellName is the name of the cell that the home page node belongs to. This argument is required. It is also case-sensitive, so type it with care. To get cell name, from wsadmin:

        print AdminControl.getCell()

      For example...

        NewsCellConfig.checkOutConfig("d:/temp", "NewsCell01")

      The command displays this message...

        News Cell Level configuration file successfully checked out.

  3. Open news-config.xml in a text editor.

  4. Locate the section containing the mailin element: 

        
<!-- These settings control the Mail-In feature, which provides support 
     for replying to certain notifications to add responses comments. -->

    <mailin enabled="true">
        <replyto enabled="true">
                     <!-- A special ReplyTo address is added to notifications where                  
                                the user can reply to the notification to respond/comment.
                 The domain may be a dedicated domain for connections bound
                 mails. Or it could be existing domain, in which case a prefix
                 of suffix should be provided also. -->

            <replytoAddressFormat>
                <domain>enterprise.com</domain>

                <!-- A prefix OR suffix (not both) may also be provided.                          
              This is necessary if an existing domain (with other                          
              email addresses) is being used.
                        There is a 28 character limit for the affix. -->

                <!--                       <affix type="suffix">_lcreplyto</affix>
                    -->

            <affix type="prefix">lcreplyto_</affix>
                             </replytoAddressFormat>
        </replyto>
    </mailin>

    • Mailin.enabled and replyto.enabled attributes as "true."

    • Specify your email server domain in the replytoAddressFormat.domain element. The example shown is enterprise.com.

    • If you use an existing, non-dedicated domain that contains other email addresses, specify either a suffix or prefix to be added to the domain in the address. The examples shown are _lcreplyto and lcreplyto_.

  5. After making changes, check the configuration files back in, and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.


Results

ReplyTo can be turned on or off by Connections users if the default setting <replyToEnabled>true</replyToEnabled> is specified in notification-config.xml. Refer to Enable email notifications for instructions on modifying notification-config.xml.


Define valid administrator email addresses

Edit configuration property settings to change the default email addresses from which system notifications, such as a request to join a community, are sent. Notifications are sent from generic administrator email addresses if you do not take action. Default email addresses are initially set during installation, so use this procedure only if you want to change them.

By default, automatic notifications are sent from a generic email address, such as blogs-admin@example.com. Edit the property to change this to a legitimate administrator email address that has access rights to send mail. Some of the notification messages sent automatically, such as the notifications used to handle blog postings that are flagged for containing inappropriate content, inform recipients that they can respond to the default administrative user email address from which the notification was sent. If you do not edit the default email address, recipients get a delivery failure notification when they try to respond to the automatic email.

  • If you plan to prevent user email addresses from being displayed in the product, define a valid email address for the global administrator. When you hide emails, this global administrator address is specified as the sender even in emails generated by user actions that would normally specify that user as the sender. The global sender email address is only used if you configure Connections to prevent emails from being displayed.

  • If you provide additional administrator email addresses for the different types of notifications, those settings take precedence over the global address. If you want the global administrator address to be used for a specific notification, comment out the sender property currently specified for that notification type.

    For example:

      <!--<property name="sender">files_admin@example.com</property>-->

You can edit the following administrator email addresses:

  • Global sender. Change the default email address of the global sender into one with the correct domain for your enterprise and a name that users will recognize and trust.
  • Specific notification types. Edit the administrator addresses used when different types of notifications are sent.

To change default email addresses from what you assigned in install:

  1. Start the wsadmin client...

      cd WAS_HOME\profiles\Dmgr01\bin

    You must start the client from this directory or subsequent commands that you try to run will not execute properly.

  2. Access the Connections configuration files...

      execfile("connectionsConfig.py")

    If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

  3. Check out notification-config.xml using the following command...

      LCConfigService.checkOutNotificationConfig("temp_dir","cell_name")

    where temp_dir is a temporary directory and cell_name is the WAS cell to which you installed Activities. When you specify a path to the working directory on a system running Microsoft Windows, use a forward slash for the directory.

    For example: "C:/temp".

    AIX, Linux, and IBM i: The directory you specify as the temporary directory must grant write permissions.

  4. From the temporary directory to which you checked out notification-config.xml, open it in a text editor.

  5. Specify a valid internet-style email address containing no spaces for the global sender by editing the globalSenderEmailAddress property in the following section of notification-config.xml... 

    <properties>
  <property name="globalSenderName">Connections Administrator</property>
  <property name="globalSenderEmailAddress">global-admin@example.com</property>  </properties>

  6. To force the email address that you specify in the globalSenderEmailAddress to be used as the sender of all notifications, add the following property to the <properties> element previously listed, and set it equal to true.

      <property name="alwaysUseGlobalSender">true</property>

  7. By default, the email address of the original sender is set as the reply-to address. If you do not want the original sender to appear as the reply-to address, then add the following property to the <properties> element previously listed, and set it equal to false.

      <property name="includeOriginalSenderAsReplyTo">false</property>

    If the alwaysUseGlobalSender property is set to false, then the includeOriginalSenderAsReplyTo property is ignored. If the alwaysUseGlobalSender property is set to true, then the includeOriginalSenderAsReplyTo is optional. The default value for this property is true if the property is added, but no value is defined for it.

  8. To specify different administrator email addresses for different notifications types per application, search for the notification types you want to change, and then change the value of the sender properties. If there is no sender property, add one.

    If a type element is present, the email address specified for it is used instead of the global administrator address. If you want the global sender address to be used instead of the address specified here, comment out the associated type element.

    For example, if you want to change the address from which notifications that inform people that they have been added to an activity are sent, edit the value of the sender property in the following notification type:

      add-member

      For example: 

      <type name="add-member">
  <channel name="email" enabled="true">
    <property name="senderName">Activities Admin</property>
    <property name="sender">activities-admin@example.com</property>
    <property name="ftl">addMemberMail.ftl</property>
  </channel>
 </type>

    No notifications are sent from the Home page application.

  9. Save and close notification-config.xml.

  10. Check in the configuration ...

      LCConfigService.checkInNotificationConfig("<temp_dir>","<cell-name>")


Related tasks:

  • Start wsadmin


    Enable users to specify email notification preferences

    Edit configuration settings to enable users to specify the email address to which they would like notifications sent, the frequency with which they receive notifications, and the language the notification is written in.

    Email notifications must be enabled in Connections for this procedure to have any effect. If you have configured Connections to hide email addresses, you might not want to enable email notifications.

    When you enable notifications, a Settings link is available from the product header that users can click to define their email preferences. Otherwise, no user interface settings are made visible to users.

    The following preferences are set by default:


    Preference Default setting
    Responses and notifications Individual emails
    Activities Daily newsletter
    Blogs Weekly newsletter
    Bookmarks Weekly newsletter
    Communities Daily newsletter
    Files Individual emails
    Forums Daily newsletter
    People Weekly newsletter
    Tags Weekly newsletter
    Wikis Daily newsletter
    Mentions Individual emails
    Libraries Individual emails

    1. Start the wsadmin client...

        cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you try to run will not execute properly.

    2. Access the Connections configuration files...

        execfile("connectionsConfig.py")

      If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

    3. Check out notification-config.xml...

        LCConfigService.checkOutNotificationConfig("temp_dir","cell_name")

      where

      • temp_dir is the temporary directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

      • cell_name is the WAS cell to which you installed the application for which you are enabling mail. This argument is case-sensitive, so type it with care.

      If you installed Connections into multiple WAS profiles, for example: Activities is installed on AppSrv01, Blogs is installed on AppSrv02, and so on), then there is a notification-config.xml file for each application. For this type of deployment, edit each notification-config.xml associated with each WebSphere Application Server profile.

      For example:

      • AIX or Linux:

          LCConfigService.checkOutNotificationConfig("/opt/temp","Cell01")

        Windows:

          LCConfigService.checkOutNotificationConfig("c:/temp","Cell01")

      • IBM i...

          LCConfigService.checkOutNotificationConfig("/temp","Cell01")

    4. From the temporary directory to which you checked out notification-config.xml, open it in a text editor.

    5. Make any of the following changes to the <defaultEmailPreferences> element:

      • To allow users to specify a preferred email address for notifications, change the value of the <allowEmailAddressOverride> element to true.

        For example: 

        <defaultEmailPreferences>
 <allowEmailAddressOverride>true</allowEmailAddressOverride>
  ...  </defaultEmailPreferences>

      • Specify whether automatic email notifications that result from one user notifying another or that are sent from the system should be sent to the person in email. If users do not receive the notification in email, they can still view the notifications from the Home page application. To prevent notifications from being sent by email, set <sendEmailsForDirectNotifications> to false.

      • Define the language in which notifications should be written:

        • If you want emails to be displayed in the language that corresponds to the locale that was set in the browser the last time the user accessed the application from the web, then set <useLanguageFromCallingComponent> to true.

        • To define a default language to use for all notification messages all of the time, set <useLanguageFromCallingComponent> to false and specify the language code of the language in the <defaultLanguage> element.

        Users can change these settings from the product user interface; you are just defining the default values here.

        The list of languages present in the Settings page represents the languages that are enabled for the product, which is defined in the <languageSelector> element in LotusConnections-config.xml. For more details, see Enabling users to set a language preference.

      • Edit the following elements:

          <defaultResponsesFrequency>
          Frequency with which users receive notifications about responses to their postings.

          Valid values include:

          • DAILY: Send a notification email with a list of notifications once a day.
          • INDIVIDUAL: Send an email each time a notification is produced.
          • NONE: Do not send any notifications by email.
          • WEEKLY: Send a notification email with a list of notifications once a week.

          Users can change this setting from the product user interface; you are just defining the default values here.

          <defaultTagFollowFrequency>
          Frequency with which users receive notifications about tags that they are following.

          Valid values include:

          • DAILY: Send a notification email with a list of notifications once a day.
          • INDIVIDUAL: Send an email each time a notification is produced.
          • NONE: Do not send any notifications by email.
          • WEEKLY: Send a notification email with a list of notifications once a week.

          Users can change this setting from the product user interface; you are just defining the default values here.

          <digestItemsPerCategory>10</digestItemsPerCategory>
          Number of items that display within a category of the daily or weekly digest. The allowable range is 5-25. The default value is 10. This setting is applied globally and cannot be configured per user.

          <replyToEnabled>true</replyToEnabled>
          When set to true, users receive emails with replyTo support. This option is displayed on the Email Settings page for each user. The default value is true.

      For example: 

      <defaultEmailPreferences>
  <allowEmailAddressOverride>true</allowEmailAddressOverride>
  <useLanguageFromCallingComponent>false</useLanguageFromCallingComponent>
  <defaultLanguage>es</defaultLanguage>
  <sendEmailsForDirectNotifications>true</sendEmailsForDirectNotifications>
  <digestItemsPerCategory>10</digestItemsPerCategory>
  <replyToEnabled>true</replyToEnabled>
</defaultEmailPreferences>

    6. For each application, you can also specify the frequency with which users should receive notifications about content that they are following by editing the defaultFollowFrequency attribute for that application.

      For example, to define the frequency with which users should receive notifications about content they are following in the Activities application, edit the source element for Activities as follows...

        <source defaultFollowFrequency="DAILY" enabled="true" name="Activities">

    7. Save and close notification-config.xml.

    8. Check in the configuration ...

        LCConfigService.checkInNotificationConfig("<temp_dir>","<cell-name>")

    9. Update the version stamp property to force a refresh of users' web browsers, so that they see the email preference changes the next time they access the product.


    Disable embedded applications in notifications

    Standard notifications sent from Connections can include an OpenSocial embedded application that is displayed in supported email clients. You can remove embedded applications from all supporting notifications by disabling a configuration property in notification-config.xml.

    To run administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    The notification types listed in the following table include the application/embed+json MIME part that is required for embedded application support. All other notifications support HTML and plain text versions only.


    Application/Embedded application Operation
    Files (specific to a file)

    • Create a file

    • Update a file

    • Comment on a file
    • Like a file
    • Share a file
    Blog entries

    • Create a blog entry

    • Update a blog entry

    • Comment on a blog entry
    • Like a blog entry
    Ideation Blog entries

    • Create an ideation blog idea

    • Comment on an ideation blog idea
    Forum topics

    • Create a forum topic

    • Update a forum topic
    • Reply to a forum topic
    Status updates

    • Post a status update

    • Comment on a status update
    • Like a status update
    • Repost a status update
    Network invites

    • Send a network invitation

    Embedded applications are only included in standard notifications; users must select the individual email option available from the Email Preferences page to receive them.

    1. Start the wsadmin client...

        cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you try to run will not execute properly.

    2. Access the Connections configuration files...

        execfile("connectionsConfig.py")

      If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

    3. Check out notification-config.xml...

        LCConfigService.checkOutNotificationConfig("temp_dir","cell_name")

      where

      • temp_dir is the temporary directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

      • cell_name is the WAS cell to which you installed the application for which you are enabling mail. This argument is case-sensitive, so type it with care.

      If you installed Connections into multiple WAS profiles, for example: Activities is installed on AppSrv01, Blogs is installed on AppSrv02, and so on), then there is a notification-config.xml file for each application. For this type of deployment, edit each notification-config.xml associated with each WebSphere Application Server profile.

      For example:

      • AIX or Linux: LCConfigService.checkOutNotificationConfig("/opt/temp","Cell01")

      Windows: LCConfigService.checkOutNotificationConfig("c:/temp","Cell01")

    4. IBM i: LCConfigService.checkOutNotificationConfig("/temp","Cell01")

    5. From the temporary directory to which you checked out notification-config.xml, open it in a text editor.

    6. Locate the following section of the file: 

      <properties>
  <property name="globalSenderName">Connections Administrator</property>
  <property name="globalSenderEmailAddress">global-admin@example.com</property>
  <includeMobileLinksInNotifications>false</includeMobileLinksInNotifications>
  <disableEmbeddedAppsInNotifications>false</disableEmbeddedAppsInNotifications>
</properties>

    7. Change the value of the <disableEmbeddedAppsInNotifications> element to true as follows:

        <disableEmbeddedAppsInNotifications>true</disableEmbeddedAppsInNotifications>

      The default value is false.

    8. Save and close notification-config.xml.

    9. Check in the configuration :

        LCConfigService.checkInNotificationConfig("<temp_dir>","<cell-name>")


    Including mobile links in notifications

    You can enable links to the Connections Mobile service from notifications by updating the value of a property in the notifications configuration file.

    To run administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    A configuration option in notification-config.xml allows you to enable links within notifications to the Connections Mobile service. When this option is enabled, if the notification being sent has a supported view in the Mobile service, an Open in Mobile link will be included in the notification. In standard notifications, the link is appended to the action link bar. In daily and weekly digests, the link is placed on the line after each entry.

    1. Start the wsadmin client

        cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you try to run will not execute properly.

    2. Access the Connections configuration files

        execfile("connectionsConfig.py")

      If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

    3. Check out notification-config.xml:

        LCConfigService.checkOutNotificationConfig("temp_dir","cell_name")

      ...where...

      • temp_dir is the temporary directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

      • cell_name is the WAS cell to which you installed the application for which you are enabling mail. This argument is case-sensitive, so type it with care.

      If you installed Connections into multiple WAS profiles, for example: Activities is installed on AppSrv01, Blogs is installed on AppSrv02, and so on), then there is a notification-config.xml file for each application. For this type of deployment, edit each notification-config.xml associated with each WebSphere Application Server profile.

      For example:

      • AIX or Linux:

        LCConfigService.checkOutNotificationConfig("/opt/temp","Cell01")

        Windows:

        LCConfigService.checkOutNotificationConfig("c:/temp","Cell01")

      • IBM i: LCConfigService.checkOutNotificationConfig("/temp","Cell01")

    4. From the temporary directory to which you checked out notification-config.xml, open it in a text editor.

    5. Locate the following section of the file: 

      <properties>
  <property name="globalSenderName">Connections Administrator</property>
  <property name="globalSenderEmailAddress">global-admin@example.com</property>
  <includeMobileLinksInNotifications>false</includeMobileLinksInNotifications>
  <disableEmbeddedAppsInNotifications>false</disableEmbeddedAppsInNotifications>
</properties>

    6. Change the value of the <includeMobileLinksInNotifications> element to true as follows:

        <includeMobileLinksInNotifications>true</includeMobileLinksInNotifications>

      The default value is false.

    7. Save and close notification-config.xml.

    8. Check in the configuration :

        LCConfigService.checkInNotificationConfig("<temp_dir>","<cell-name>")


    Remove nodes from a cluster

    You can remove IBM WebSphere Administration Server nodes from a cluster using the Integrated Solutions Console or using a command.


    Remove nodes from a cluster using the Integrated Solutions Console

    You can remove nodes from a cluster using the IBM WebSphere Application Server Integrated Solutions Console.

    To remove a node from a cluster:

    1. From the Integrated Solutions Console, select System Administration > Nodes.

    2. Select the check box next to the node to delete and click Remove Node.

      If you cannot remove the node by clicking Remove Node, remove the node from the configuration by clicking Force Delete.

    3. Restart WebSphere Application Server.


    Remove nodes from a cluster with the command line

    Use the removeNode command to remove a node from a cluster.

    For more information about the removeNode command, see removeNode command in WAS information center.

    To remove a node from a cluster:

    1. Log in to the node to remove.

    2. cd PROFILE_HOME/bin directory.

    3. Run the following script to remove the node:

      • AIX or Linux: ./removenode.sh [-username uid] [-password pwd]

      • IBM i: removenode [-username uid] [-password pwd]
      • Windows: removenode.bat[-username uid] [-password pwd]

      where:

      • uid is the Deployment Manager administrator user name
      • pwd is the Deployment Manager administrator password


    Back up and restoring data

    You must back up both the application databases and content stores on a regular schedule using the methods documented by the vendor from whom you purchased the database and file system you are using.

    When you restore data for an application that is also available from the Communities application, also restore the data in the Communities application to keep the two in sync.

    See Recovering from a database failure for more details.


    Manage content

    Use superusers, moderation, and other methods to manage Connections content.


    Administer application content

    To view and control content in your deployment, you can create a dedicated global administrator or administrators with administrative capabilities over content in the applications.

    A global administrator can edit and remove objectionable content. The Moderation feature can assist in this process, but not all components have the Moderation implemented. Also, although some wsadmin commands can be helpful with removing objectionable content, they do not cover all situations.

    For example, in the event that someone who is the only Owner of some content (such as the only owner of an activity or community) and that person leaves the organization or is out of office for an extended time period, the Global Administrator could add additional owners and even remove the original owner if needed.

    IBM recommends creating a new user account solely for these administrative purposes. This is especially true for administrators in Activities. Adding administrative abilities to your own account in other applications can result in confusion and can lead to accidental modification of data. Also recommended is that the same person (or multiple people) be given an admin role across all components, rather than assigning the admin role to someone different for each component, particularly for Communities, which might have widgets added from multiple components.

    Application Administrative capabilities Steps
    Activities

    • Access any activity returned by search

    • Open any activity using a URL address

    • Modify any activity

    • Delete any activity or entry

    • See private entries. They cannot change privacy settings.

    • Restore any activity or entry from the Trash.

    • Add, remove, and change permissions of activity members. (For a community activity, the administrator must be a community member to make membership changes.)

    To view and control Activities content:

    1. Find or create a user who will be dedicated to this purpose.

    2. Add the user to the Activities J2EE admin role.

      See Roles.

    3. Add the user to the Search J2EE search-admin role.

      See Roles.

    Blogs and Ideation Blogs

    • Configure administration settings

    • Edit any blog or blog entry

    • Delete any blog, entry, or comment

    To view and control Blogs and Ideation Blogs content:

    1. Find or create a user who will be dedicated to this purpose.

    2. Add the user to the Blogs J2EE admin role.

      See Roles.

    When the user logs into Blogs or Ideation Blogs they will see an Administration tab where they can configure administration settings.

    Bookmarks

    • Remove unwanted links
    		There is no way to create a comparable administrator for Bookmarks. However, adding a user to the J2EE search-admin role allows that user to see any bookmark in Bookmark search results. Any administrator can use the Bookmarks wsadmin commands to remove unwanted links from the Bookmarks application.
    Communities

    • Access to any community, public or restricted
    • Rights to view and update community settings, members, invitations, bookmarks and feeds
    • With some extra configuration, rights to access and edit content in remote application widgets

    • Users with this role will see an additional Administration link that will allow them to administer the Community Catalog.
    		To view and control Communities content, follow steps in Administering Communities content.
    Files

    • Editor access on all files

    To view and control Files content:

    1. Find or create a user who will be dedicated to this purpose.

    2. Add the user to the Files J2EE admin role.

      See Roles.

    Forums

    • Edit, update, or delete any forum, forum topic, or reply

    To view and control Forums content:

    1. Find or create a user who will be dedicated to this purpose.

    2. Add the user to the Forums J2EE admin role.

      See Roles.

    Home page

    • Administer site-wide settings for the Home page from...

      • Home page administration user interface
      • wsadmin client

    • Add custom widgets for use on the Home page

    • Enable and disable widgets

    • Enable and disable the My Page view
    		Users with the Home page administrator role have access to an additional Administration view on their Home page. When you are assigned this role, you can see an Administration option in the navigation sidebar, under the My Page option.
    News Events are generated by the various Connections applications whenever an activity occurs in the system. Information about these events is stored in the News repository, and the Home page application pulls data from the repository to display only the events that are relevant to a particular user on that user's Home page. You can configure News configuration settings to control how the information that the Home page receives from the News repository is stored and administered.

    The administrators are the users mapped in the admin J2EE role in the News application.

    • Register a new application or source type so that it displays in the Connections user interface.

    • Update, enable, or disable an application registration.

    • Check out/check in News repository configuration files.

    • Remove single or multiple reply-to IDs.

    • Remove all microblog and associated data for a community from the News repository.

    • Synchronize news data with other applications.

    • Return an XML synchronization report of the community resources held in the News repository.

    • Return information about a scheduled task.

    • Delete any status update and comment on status updates in the system, including community status updates.

    • Create a status update in any community.

    • Change the status update settings in any community.
    • View the Activity Stream feed from any community
    		View and control News content using scripts accessed using the wsadmin client as detailed in the Administering the News repository section.
    Profiles

    • Delete photos

    • Edit user About Me and Background information

    • Activate or deactivate any profile

    • Edit core user attributes

    To view and control Profiles content:

    1. Find or create a user who will be dedicated to this purpose.

    2. Add the user to the Profiles J2EE admin role.

      See Roles.

    You must use wsadmin commands to delete photos, edit About Me and Background information, and activate or inactivate any profile.

    See Profiles administrative commands.

    Use the Profiles REST ATOM API to edit core user attributes.

    See Profiles Administration API. Attributes you cannot edit are link roles, friends, tags, and the following and follower lists. To edit those attributes you must use direct SQL.

    Search Search in any application returns all content.

    For example, a search in Communities will return private communities even if you are not a member.

    To have search return all content:

    1. Find or create a user who will be dedicated to this purpose.

    2. Add the user to the Search J2EE search-admin role.

      See Roles.

    Wikis

    • Search returns all content

    • Create, edit, read, and delete any content

    • Remove a wiki creator from wiki membership

    To view and control Wikis content:

    1. Find or create a user who will be dedicated to this purpose.

    2. Add the user to the Wikis J2EE admin role.

      See Roles.

    Once a user creates a wiki, they are the owner of that wiki. An administrator can add new owners to the wiki, but the creator of the wiki cannot be removed from the membership. Direct SQL manipulation on the database is required to reassign the creator and remove them from the membership.


    Administer community content

    You can create a dedicated administrator with access to all communities, public or restricted. This administrator has granular control over communities content, including the ability to edit or remove inappropriate content. This administrator is also required for IBM Lotus Sametime integration with Connections.

    Global communities administrators can access all communities with rights to view and update community settings, members, invitations, bookmarks and feeds; however, within restricted communities the global administrator cannot view and manage remote widget applications, such as Activities, Blogs, Ideation Blogs, Files, Forums, and Wikis. To manage content in remote widget applications, you add the communities global administrator to the J2EE admin role for all of these applications.

    See Assigning people to J2EE roles for detailed information. After communities global administrator is in the admin role for those applications, she can manage content in any of them, whether the applications are standalone or remote widgets in a community.

    You can use search to find private communities, but you must add the global administrator to the search-admin role of the Search application. Use the Public Communities view to find public and moderated communities.

    The global administrator role is not supported on mobile devices. Global administrators must use a supported browser.

    1. Find or create a user who will be dedicated to administering content, and add them to the J2EE admin role of Communities, Activities, Blogs, Files, Forums, and Wikis. Also add them to the search-admin role of Search.

      See Roles. In the following steps, we will ensure that the communities-config.xml file contains the "admin" block of grant statements and is not commented out.

    2. Start wsadmin:

        cd WAS_HOME/profiles/Dmgr01/bin
        ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

    3. Access and check out the Communities configuration files:

      1. Access the Communities configuration files...

          execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Communities configuration ...

          CommunitiesConfigService.checkOutPolicyConfig("working_directory", "cell_name")

        ...where...

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command...

            print AdminControl.getCell()

        For example...

          CommunitiesConfigService.checkOutPolicyConfig("/opt/my_temp_dir", "CommCell01")

    4. From the temporary directory to which you just checked out the Connections configuration files, open the communities-policy.xml file in a text editor.

    5. Make sure the file contains the following grant statement, and that it is not "commented out" (disabled). 

      <comm:grant>
    <comm:principal class="com.ibm.tango.auth.principal.Role" name="admin" />
    <comm:permission class="com.ibm.tango.auth.permission.CommunityManagementPermission" communityType="*" action="*" />
    <comm:permission class="com.ibm.tango.auth.permission.CommunityMembershipPermission" communityType="*" action="*" />
    <comm:permission class="com.ibm.tango.auth.permission.CommunityAccessPermission" communityType="*" action="*" />
    <comm:permission class="com.ibm.tango.auth.permission.CommunityReferencePermission" communityType="*" action="*" />
    <comm:permission class="com.ibm.tango.auth.permission.CommunityBroadcastPermission" communityType="*" action="*" />
    <comm:permission class="com.ibm.tango.auth.permission.CommunityInvitePermission" communityType="*" action="*" />
</comm:grant>

    6. Save your changes to the communities-policy.xml file.

    7. Check in the updated file using the following wsadmin client command...

        CommunitiesConfigService.checkInPolicyConfig("<working_directory>", "<cell_name>")

    8. To exit the wsadmin client, type exit at the prompt.

    9. Stop and restart the server hosting the Communities application.


    Results

    When the global administrator specified in the various J2EE roles logs in to Communities, she should be able to view and edit all communities and community resources.


    Moderation overview

    If the moderation application is installed and enabled, you can define a person or set of people who will review and approve the content that users add to certain applications before it is published or review and act on content that has been flagged as problematic.

    Moderation can be configured to make moderation available for global moderators, community owners or blog owners, as follows:

      Global moderators
      User assigned the global-moderator J2EE role for the Moderation component can review and manage content for blogs, forums, and community files from the global moderation interface, which is accessed using the Moderation link in the application menu bar. The link is only visible to users who have been assigned the J2EE global-moderator role.

      For more information about assigning roles, see Roles.

      Community moderators
      When owner moderation is enabled for communities, community owners can access moderation options for their community by opening the community and selecting Community Actions > Moderate Community. Community moderators can only manage the content of communities that they own, and they can only do so from the community moderation interface; they cannot access the global moderation interface.

      You can specify whether owner moderation is enabled by changing the value of the ownerModerate setting in the contentreview-config.xml file.

      For more information, see Managing content moderation and flagged content.

      Blogs moderators
      If the Moderation service is enabled, you can moderate Blogs from the central moderation interface. If the Moderation service is not enabled, you can moderate Blogs from a moderation interface available from the Blogs application. When owner moderation is enabled for Blogs, blog owners can access moderation options for a blog they own by opening the blog and choosing the Moderation tab. If moderation is enabled for a blog, the blog owner can review content before it is posted to a blog. In addition, users of the Blogs application have the options to flag content as inappropriate. When content is flagged, the moderator is informed and can take action from the moderation interface.

    In addition to the user interfaces available for moderation, there is a public moderation API that can be leveraged by third-party developers to extend the capabilities of content moderation.


    Moderation roles

    Monitor and control the content of blogs, community files, and forums using the moderation tools.

    As the Connections administrator, you can do the following to enable and configure moderation:

    • Enable or disable moderation for content before it is published and after it is published.

    • Assign the Global-Moderator role to users so they can moderate all content from a central UI.

    • Set up categories and route which moderators see what flagged content.

    • Enable owner moderation for blogs, forums, or community files so that owners can publish their content directly to a blog, forum, or community file and moderate content for the blogs, forums, or community files they own.

    When moderation is enabled, users can:

    • Flag published blog or forum posts or community files that are inappropriate
    • Submit content for review.
    • Blog and forum users can edit their own published content.

    • In addition, Blog owners can view their own submitted, rejected, or published content.

    Users you have assigned the Global-Moderator role can:

    • Approve, reject or delete submitted content.
    • Dismiss, quarantine or delete flagged content and restore quarantined content.

    • Provide an explanation to the author when rejecting submitted content, dismissing or quarantining flagged content, or when restoring quarantined content.
    • View and directly edit submitted content or comments

    When owner moderation is enabled, blog, forum, or community owners can manage the content in the blog, forum, or community files they own.


    Moderated content states

    When content is moderated, it can be in a variety of states before and after being published.

    The state that content is in dictates where it is in the pre-moderation or post-moderation workflow and controls whether the content is available to users or unavailable because it has not been approved or is in quarantine.


    Content states before publication

    Content that requires review and approval before it is published can be in one of the following states:

    • Pending: The moderator can approve or reject the content.
    • Active: Content is published
    • Rejected: Content will not be published.


    Content states after publication

    Content that has already been published but requires review, for example, if it was flagged as inappropriate, can be in one of the following states:

    • Active with flags: The content is published but it may be flagged for review. The moderator can dismiss flags or quarantine the content.

    • Active: The content is published.
    • Quarantine the content is quarantined and notification is sent to the author


    Moderate content before it is published

    Review before it is published to make sure it meets your standards.

    When content is submitted by a user, it is marked for review and it displays on the Content Approval section of the Moderation tab. An authorized moderator can view the state of submitted content and take action on it. Content can be:

    • Blog entries or comments
    • Community files content or comments

    • Forum posts or comments

    The workflow described in this topic requires that valid email addresses are configured for the reviewers and that email notifications are enabled for your Connections deployment.

    When a user submits content, it sets in motion a workflow for reviewing the content. The workflow goes as follows:

    1. Notification is sent to the moderator that content has been submitted. The notification includes information about the person submitting the content and a link to the content. The content is posted to the Content Approval section in the Moderation interface for viewing and managing content before it is published.

    2. The moderator reviews the content and acts on it.

    3. If the content is acceptable, the reviewer approves it and it is published. The author receives notification email that the content is approved.

    4. If the content is considered inappropriate, the reviewer rejects the content. In this case, the author is notified by email. The posting appears on the Rejected panel.

    5. If the content is considered inappropriate, the reviewer can delete it from either the Require Approval or the Rejected tabs.
    Follow these steps to review content and take action.

    1. Click the Moderation tab.

    2. Click Content Approval in the navigation pane and then select the type of content to work with - Blogs, Files, or Forums. Content awaiting decisions are displayed along with information on who submitted the content.
    3. Review an item and choose one of these actions:

      Option Description
      Approve Publish the content.
      Reject The content is moved to the Rejected tab where you can later approve it or delete it. Blog content that is rejected can be revised by the author and resubmitted for approval.
      Delete Permanently remove the content.


    Moderate published content that is flagged

    Review published content that has been flagged as inappropriate and take action on flagged entries and comments.

    When content is flagged by a user, it is marked for review and it displays on the Flagged Content section of the Moderation tab. An authorized moderator can view the history and state of flagged content and take action on it. Flagged content can be:

    • Blog entries or comments
    • Community files content or comments
    • Forum posts

    The workflow described in this topic requires that valid email addresses are configured for the reviewers and that email notifications are enabled for your Connections deployment.

    When a user flags content as inappropriate, it sets in motion a workflow for reviewing and resolving the issue. The workflow goes as follows:

    1. Notification is sent to the moderator that content has been flagged. The notification includes information about the person flagging the content, and a link to the content in the Moderation interface. The entry or comment is posted to the Flagged Content section in the Moderation interface for viewing and managing flagged content.

      There is a setting in the contentreview-config.xml file which determines whether notification is sent to a moderator or content reviewer as follows:

      • If issueCategorization is disabled, then notification is sent to all the moderators.

      • If issueCategorization is enabled, then the notification will only be sent to the reviewers defined under each issue category, but if reviewer information is not provided, the notification will still be sent to all the moderators.

    2. The moderator reviews the content and acts on it.

    3. If the reviewer does not think the content is inappropriate, the flag is dismissed and the content remains in the blog or community.

    4. If the content is considered inappropriate, the reviewer quarantines the posting, which means it is removed and placed in a quarantined state. In this case, the author is notified. The posting appears on the Quarantined panel.

    5. If the content is considered inappropriate, the reviewer can delete it from either the Flagged for Review or the Quarantined tabs.
    Follow these steps to review flagged content and take action.

    1. Click the Moderation tab.

    2. Click Flagged Content in the navigation pane and then select the type of content to work with - Blogs, Files, or Forums. Content awaiting decisions are displayed along with information on who flagged the content and why.
    3. Review a flagged entry and choose one of these actions:

      Option Description
      Dismiss Dismiss the flag. The content remains available.
      Quarantine This option turns the post in question to a draft and removes it to a quarantine area so it is not available to readers. This option prompts you to send notification to the posting author explaining your reason for removing the post and providing a link so the author can revise the content. Quarantined content can be restored or deleted.
      Delete Permanently remove the content.

    4. View content that you have quarantined, select one or more items, and take one of the following actions:

      • Click Restore to dismiss the flag and restore the content to a published state.

      • Click Delete to permanently remove the content.


    Manage moderation when email is disabled

    If email is disabled or if users do not have email addresses, some parts of the moderation workflow must be completed manually.

    If Connections is configured so that email notification is disabled, the automatic notifications used for this workflow are disabled. The following activities would require manual intervention:

    • When an entry is flagged as inappropriate, the reviewers will not receive email indicating there is a potentially offensive posting. Reviewers will have to periodically visit the Flagged Content section of the Moderation interface to see what content needs action and then manually send confirmation notification messages to the user who flagged the content.

    • If the reviewer quarantines an item, the owner will not receive email notifications. The reviewer will have to manually send a notification message to the content owner.

    If your organization includes people with no email, the automatic notifications used for this workflow are disabled. The following activities would require manual intervention:

    • If a reviewer has no email, when an entry or comment is flagged as inappropriate, the reviewer will not receive email indicating there is a potentially offensive posting. Reviewers will have to periodically visit the Flagged Entries or Flagged Comments pages of the Moderation interface to see what entries need action.

    • If the content owner has no email, and the reviewer quarantines an item, the content owner will not receive email notifications.

    • If the person who flagged the message as inappropriate has no email, the person will not receive a confirmation email that the post they found offensive is being reviewed.


    Administer the Widget container

    The Widget Container is the Connections-specific integration of the Common Rendering Engine, also known as the CRE.

    The CRE is the successor to Mashup Enabler and adds the ability to render OpenSocial gadgets as well as iWidgets. Throughout the Connections documentation, the Connections instance of CRE will be referred to as the Widget Container. This section of the documentation is specific to the administration of the Widget Container. More details on the CRE in general can be found in the IBM Social Business Development wiki.

    To add gadgets deployed externally, such as iGoogle gadgets, configure locked domains, which isolate semi-trusted gadgets, and prevents them from accessing SSO tokens, or using DOM access to the parent page of the gadget iFrame to forward sensitive data to external sites.

    For more information on locked domains, refer to Enable locked domains.


    Administer gadgets for Connections and widgets for Home page

    Add OpenSocial gadgets to extend Home page functionality. Add them from the Administration view and then enable them for use.

    The widgets that you add to the Home page can be based on the iWidget specification, which uses technology based on JavaScript, XML, HTML, and CSS, or the OpenSocial gadget specification. The widget files are stored on an HTTP server.

    Gadgets added to Connections need to be based on the OpenSocial gadget specification, which surfaces gadgets in an OpenSocial container that interacts with an OAuth 2.0 protected service

    The widget files can be bundled as EAR applications and deployed on IBM WebSphere Application Server. They can also be hosted in LAMP, .NET, and other environments.

    You can add two types of third-party widget to the Home page:

      Opened by default
      Displays by default, but can be removed or hidden. Can be moved to a different location. For example, the To Do List widget that displays in the Updates view is opened by default.

      To confirm changes made
      Available for users to add to their Home page if they select it from the widget catalog. To confirm changes made widgets can be added, removed, hidden, or moved by Home page users.
    Any widget can be used as a default or optional widget.

    Third-party widgets can be added to the side column in the Updates view and to any column in the My Page view.


    Configure widgets

    Ensure that the widgets that you add to the catalog are from trusted sources. The widget catalog allows you to administer OpenSocial gadgets for the entire Connections system including...

      gadgets and iWidgets specific to the Home page

    To add widgets via the Home page, you must be logged in as an administrator. If you do not see an Administration option display under the My Page option in the navigation sidebar on the Home page, this means that you are not configured as an administrator of the Home page application.

    See Configure the Home page administrator for more details.

    To add gadgets deployed externally, such as iGoogle gadgets, configure locked domains, which isolate semi-trusted gadgets, and prevents them from accessing SSO tokens, or using DOM access to the parent page of the gadget iFrame to forward sensitive data to external sites.

    For more information on locked domains, refer to Enable locked domains.


    Add a widget to the widget catalog

    1. Open the Administration view.

    2. Click Add another widget .

    3. Specify whether you are adding a widget that is based on the iWidget specification or the OpenSocial gadget specification.

      To allow users to be able to integrate applications such as Facebook, Twitter, and LinkedIn into their Connections client experience, select OpenSocial gadget. Selecting OpenSocial gadget opens the Gadget settings with Activity stream or Share dialog subform, on which you need to specify the following additional options:

      1. For Security, select either a Trusted or a Restricted security type.

        • Trusted gadgets can access a wider selection of container APIs and they can interact with Connections data. Even though a gadget is marked as "trusted", its data access is still isolated from SSO data when used in combination with locked domains.

        • Select Use SSO token for trusted enterprise gadgets. Selecting this feature disables all of the security provided by locked domains for this particular gadget.

        • In general, gadgets should be written to utilize OAuth unless they are speaking to a "legacy" system that has not been OAuth enabled. For 4.0, all of the Connections APIs are now OAuth enabled. Currently SSO is not a standard OpenSocial feature, but specific to the Common Rendering Engine (CRE). Some IBM Containers, such as Notes Social Edition, do not support the SSO feature at all at the time of this writing.

        • Restricted gadgets are limited in terms of the OpenSocial features.

          For example, they are not able to popup model dialogs. In general, you should always scope gadget feature access as narrowly as possible. Use this setting if the gadget does not require the additional page API features provided to trusted gadgets.

        You should not put any external (restricted) gadgets into Connections if you have not configured locked domains.

      2. For UI integration points select where the gadget should be inserted in the user interface:

        • Show in Share dialog
        • Show for Activity stream events

        You can select both.

        Your gadget will display after the Connections gadgets in the Share dialog.

      3. Select the Server access via proxy preference as follows:

        • Only outside the intranet prevents the gadget from accessing your intranet servers. Unless specifically configured, the system will deem a server as part of the intranet if it is part of the WebSphere SSO domain. If this scoping is too narrow, it can be expanded via additional configuration settings.

        • All servers allows the gadget to access URLs in your intranet as well as outside it.

        • Custom rule defined for this gadget in the proxy-policy.dynamic file enforces settings defined in the policy file.

          For more information refer to Configure per-host proxy access rules for OpenSocial gadgets.

      4. In the Service Mappings section, create a new mapping between an OAuth client, such as Facebook or Twitter, and its associated service, or edit or remove an existing mapping.

        OAuth clients must be pre-configured via wsadmin commands. This setting just manages the association of the clients with individual gadgets.

        1. Click Add Mapping to create a new mapping between an OAuth service and an OAuth client. In the fields that display, select an OAuth Client name and enter the associated Service Name.

        2. Select an existing mapping in the map list and then click Edit Mapping to update the mapping.

        3. Select an existing mapping in the map list and then click Delete Mapping to remove that mapping from the list.

        For more information about OAuth tokens, refer to Configure OAuth for custom gadgets.

    4. Enter a name for the widget in the Widget Title field.

    5. Enter a short description of the widget in the Description field.

    6. Enter the web address for the XML widget descriptor in the URL Address field.

      This address must be an absolute web address.

    7. Enter the widget location in the Secure URL Address field.

      This address must be an absolute web address.

    8. Enter the web address for an icon to associate with the widget in the Icon URL field.

      This image is used to represent the widget when it is docked in the widget palette.

    9. Enter the location of an icon to display for the widget in the Icon Secure URL field.

      This icon displays when the widget is docked in the content palette.

    10. Select Use Connections specific tags to indicate if the widget deployment descriptor uses specific Connections tags to represent the URLs of the Connections applications.

    11. To display the widget in the My Page view, select Display in the My Page view.

      You must display the widget in the My Page view or the Updates view, or both.

    12. To display the widget in the Updates view, select Display in the Updates view.

      You must display the widget in the My Page view or the Updates view, or both.

    13. To display the widget when users open the Home page for the first time, select Opened by default.

      The widget will not display for existing users, but it will be available from the widget palette so that they can add it whenever they want.

    14. To enable multiple instances of the widget to be used, select Multiple widgets.

      Each widget instance has its own properties.

      For example, if you are using a widget that displays bookmarks for a specific tag, you can enable multiple instances of the widget so that you can follow different tags in each widget.

      This setting is only applicable for iWidgets. Only one instance of an OpenSocial gadget may be loaded at a time.

    15. If there are specific Connections applications that must be included in your deployment for the widget to function correctly, select the required applications in the Prerequisites area.

      When an Connections application is selected as a prerequisite but that application is not installed, the widget does not display on the Home page. For gadgets that declare dependencies this way, they will act as though they are "disabled" for the purposes of whitelisting if all of their dependencies are not met.

    16. Click Save.

    If you are adding widgets that are hosted on third-party servers, then you might need to update your proxy configuration.

    See Configure the AJAX proxy for a specific application.


    Enable widgets

    You need to enable widgets before they can display on the Home page or elsewhere in Connections.

    The Home page administration user interface lists the current status of widgets in the widgets catalog, and allows you to enable and disable widgets as needed. All changes made in the user interface, including enabling and disabling widgets, take immediate effect without the need for application restart.

    To change a widget's status to enabled....

    1. Open the Administration view.

    2. In the Disabled widgets area, select the widget to enable and click Enable.


    Disable widgets

    You can disable widgets from displaying on the Home page or elsewhere in Connections when you no longer want them to be available to users.

    Set a widget's status to disabled means that it no longer displays on the Home page. The Home page administration user interface lists the current status of widgets in the widget catalog, and allows the administrator to enable and disable widgets as needed. All changes made in the user interface, including enabling and disabling widgets, take immediate effect without the need for application restart.

    To change a widget's status to disabled....

    1. Open the Administration view.

    2. In the Enabled widgets area, select the widget to disable and click Disable.


    Edit widgets

    Edit a widget to change its name, description, or deployment descriptor.

    You can edit a widget to update the icon associated with the widget when it is docked, specify whether the widget deployment descriptor uses particular Connections tags to represent the URLs of Connections applications, and select Connections applications as prerequisites for the widget.

    For system widgets that are installed as part of Connections, you can only change the name of the widget.

    To edit a widget....

    1. Open the Administration view.

    2. Select the widget to edit and click Edit.

    3. Make the necessary changes in the Edit widget form and then click Save.


    Remove widgets

    If a third-party widget is no longer used or needed, you can remove it from the widget catalog. You cannot remove Connections widgets from the catalog, you can only disable them.

    To remove a third-party widget from the widget catalog....

    1. Open the Administration page.

    2. Select the widget to remove, and then click Remove.


    Gadget registration commands

    Administrators can use NewsWidgetCatalogService commands to register gadgets, particularly if the Connections Home page application, with its administrative interface, has not been installed.


    Flag constants used for widget policy settings

      GadgetFlags
      TRUSTED use to indicate that a gadget is 'trusted' and should be granted access to the non-base gadget features.
      SSO indicates that a particular gadget is granted access to the SSO feature.

      WidgetContexts
      UPDATE indicates that this widget is applicable to the updates page of the Homepage.
      WIDGET indicates that this widget is applicable to the widgets page of the Homepage.
      SHAREDIALOG indicates that this gadget is applicable to the share dialog.
      EMBEDXP indicates that this gadget is provides an embedded experience.


    Sets available for widgets

    Before using any NewsWidgetCatalogService commands, be sure to run newsAdmin.py as described in the first two steps of the topic Access the News configuration file. The following table describes the settings available for widgets:

    Sets Description
    widgetId READONLY The id of the widget.
    title REQUIRED The title for the widget in the catalog.
    text REQUIRED Descriptive text for the widget in the catalog.
    url REQUIRED URL for the widget.
    secureUrl Alternate 'secure' (HTTPS) URL for the widget XML.
    iconUrl The URL for the widget icon. This icon is placed next to the widget in the widget catalog.
    secureIconUrl Alternate secure (HTTPS) URL for the widget icon. This icon is placed next to the widget in the widget catalog.
    previewImage Set for a URL to an optional preview image.
    categoryName Set the category for the widget to be displayed in if it is available in the Customize panel. Valid values for this are the name of an Connections application (for example: 'profile', 'wikis', 'files') in lowercase.
    isSystem READONLY: Indicates if this is a system-defined widget. These should not be altered as a rule.
    isHomepageSpecific Indicates if the widget is specific to Home page. This setting is used by Homepage iWidgets.
    isDefaultOpened Indicates if the particular widget should be placed on the widgets page (if applicable) for new users.
    multipleInstanceAllowed Indicates if the user may place multiple instances of a widget onto the widgets or updates page. This setting is only valid for iWidgets.
    isGadget Indicates whether this is a OpenSocial gadget (true) or iWidget (false).
    policyFlags Also see GadgetFlags. List of policy flags set for this widget. For the 4.0 release, this setting is only relevant for gadgets.
    enabled Indicates if this widget is enabled or disabled.
    prereqs Acomma-separated list of applications that are required for this widget to be enabled. The widget is implicitly disabled if the list of prerequisites is not met.
    appContexts Also see WidgetContexts. Indicates the contexts where this widget is intended to be used.
    proxyPolicy Specifies the proxy policy access for custom gadgets. Also see ProxyPolicy constant.


    Constants for enablement

      Enablement
      ALL returns both enabled and disabled widgets
      ENABLED returns only enabled widgets
      DISABLED returns only disabled widgets


    Constants for True and False

      Constant for True
      TRUE=1

      Constant for False
      FALSE=0


    Unbounded page size constant

      PAGE_SIZE_UNBOUNDED = -1


    Constants for ProxyPolicy

      ProxyPolicy
      INTRANET_ACCESS All server access.
      EXTERNAL_ONLY Only servers outside of the SSO domain.
      CUSTOM No access. Access will be defined by the proxy-policy.dynamic file.

      For more information about the proxy-policy.dynamic file, refer to Configure per-host proxy access rules for OpenSocial gadgets.


    NewsWidgetCatalogService

      NewsWidgetCatalogService.browseWidgets(enablement = Enablement.ALL, pageSize = PAGE_SIZE_UNBOUNDED, pageNumber = 1)
      Browse the widgets in the widget catalog.
      Uses the parameter for enablement (Refer to Enablement).
      Uses the parameter for pageSize.
      Uses the parameter for pageNumber.
      Return a list of Widget objects.

        wsadmin>NewsWidgetCatalogService.browseWidgets(Enablement.ALL, 1, 1)

      NewsWidgetCatalogService.clearWidgetCaches()
      Clears cached widget.xml files from your server without needing to restart your system. If a gadget or iWidget.xml has been updated and you want to force it to be reread by the system, simply call this command.

      NewsWidgetCatalogService.countWidgets(enablement = Enablement.ALL)
      Count the widgets in the widget catalog.
      * Uses the parameter for enablement (Refer to Enablement).
      * Return a count of the number of widgets in the catalog.

      NewsWidgetCatalogService.findWidgetById(WidgetId)
      Find a widget by id.
      Uses the parameter for widgetId.
      Return the matching widget or null if no matching widget is found.

      For example:

        wsadmin>NewsWidgetCatalogService.findWidgetById("405a4f26-fa08-4cef-a995-7d90fbe2634f")

      NewsWidgetCatalogService.findWidgetByUrl(widgetUrl)
      Find a widget by Url.
      Uses the parameter for url.
      Return the matching widget or null if no matching widget is found.

      NewsWidgetCatalogService.listShareGadgets(enablement = Enablement.ALL)
      List out the share gadgets. By design, paging is not supported.
      Uses the parameter for enablement (Refer to Enablement).
      Return the share gadgets.

      For example:

        wsadmin>NewsWidgetCatalogService.listShareGadgets(Enablement.ALL)

      NewsWidgetCatalogService.updateWidgetShareOrder(widgetId, orderAfterWidgetId)
      Place the widget marked in a widgetId after a second widget in widget ordering.
      widgetId The id of the widget you wish to move.
      orderAfterWidgetId The id of the widget you want to place the gadget after. If this is null, the widget will be placed first in the ordering.

      NewsWidgetCatalogService.addWidget(**widget)
      Add a widget to the widget catalog.
      ** widget indicates that this is a free form set of key=value properties. The keys/values map to the Settings available for widgets table previously described.
      Return the ID of the newly created widget.

      The following example creates a sample EE gadget that has 'trusted' access policies. This gadget depends on the Profiles component.

        NewsWidgetCatalogService.addWidget(, text="Sample gadget description.", url="http://www.to.my.gadget.com/gadget.xml", categoryName=WidgetCategories.NONE, isGadget=TRUE,appContexts=[WidgetContexts.EMBEDXP], policyFlags=[GadgetPolicyFlags.TRUSTED], prereqs=["profiles"])

      NewsWidgetCatalogService.updateWidget(widgetId, **widget)
      Update an existing widget in the widget catalog.
      Uses the parameter for widgetId.
      ** widget indicates that this is a free form set of key=value properties. The keys/values map to the Settings available for widgets table previously described.

        wsadmin>NewsWidgetCatalogService.updateWidget("1bf9ad75-a634-4301-88c6-ce493eb03cc9", , text="test")

      NewsWidgetCatalogService.removeWidget(widgetId)
      Remove a widget matching the widgetId entered.

      For example:

        wsadmin>NewsWidgetCatalogService.removeWidget("405a4f26-fa08-4cef-a995-7d90fbe2634f")

      NewsWidgetCatalogService.ProxyPolicy
      Specify the server proxy policy.
      INTRANET_ACCESS May access intranet sites.
      EXTERNAL_ONLY May access external (non-intranet) sites only.
      CUSTOM Uses rules in the rule manager configuration.


    Configure OAuth for custom gadgets

    The Connections 4.5 release supports an OAuth 2.0 consumer proxy that allows the Homepage component to surface gadgets in an OpenSocial container that interacts with an OAuth 2.0 protected service. In order for this proxy to function, there are a series of new administration commands that are exposed in the News service to define OAuth 2.0 providers, clients, and the associated gadget that will interact with the protected service.

    See the topic Running administrative commands for steps on executing newsAdmin.py before running OAuth proxy configuration commands in Connections.

    Perform any of the following tasks using the appropriate command:


    Counting providers

      NewsOAuth2ConsumerService.countProvider()
      Return the total number of OAuth 2.0 providers registered with the consumer proxy. There are no parameters.

      Example: 

      wsadmin>NewsOAuth2ConsumerService.countProvider()

20


    Returning a list of providers

      NewsOAuth2ConsumerService.browseProvider(int pageSize, int pageNumber)
      Return a list of Map objects that represent each OAuth 2.0 provider registered with the consumer proxy, in ascending ordered by provider name. The following information is returned for each map object in the returned list:

      • authHeader: "true" or "false"
      • authUrl: the authentication url endpoint for the provider
      • clientAuth: the client authentication method in use
      • name: the name of the provider
      • tokenUrl: the token url endpoint for the provider
      • urlParam: "true" or "false"

        pageSize
        The maximum number of providers to list per page. The default value is 20. This parameter is optional.

        pageNumber
        The number of the page to display.

        For example, if you specify in the pageSize parameter that each page will have 50 items, page 1 will contain items 1-50. The default value is 1. This parameter is optional.

      Example:

        wsadmin>NewsOAuth2ConsumerService.browseProvider(50, 1)


    Returning a single provider

      NewsOAuth2ConsumerService.findProvider(string providerName)
      Return a Map with information about the registered OAuth 2.0 provider with the specified name.

        providerName
        The unique provider name.

      Example:

        wsadmin>NewsOAuth2ConsumerService.findProvider("provider123")


    Register or updating a provider

      NewsOAuth2ConsumerService.registerProvider(string providerName, string clientAuth, string authHeader, string urlParam, string authUrl, string tokenUrl)
      Register or update an existing OAuth 2.0 provider by name with the associated parameters.

        providerName
        The unique provider name.

        clientAuth
        The client authentication method for accessing this provider. Supported values out of the box are "standard" and "basic" per the specification.

        authHeader
        Value of "true" if credentials must be encoded in the authorization header, otherwise "false".

        urlParam
        Value of "true" if credentials must be specified as query parameters on the URI, otherwise "false".

        authUrl
        The authentication endpoint for the provider.

        tokenUrl
        The token endpoint for the provider.

      Example:

        wsadmin>NewsOAuth2ConsumerService.registerProvider("provider123", "standard", "true", "false", "???", "???")


    Delete a provider

      NewsOAuth2ConsumerService.deleteProvider(string providerName)
      Delete a provider by name if it exists, and has no existing associated clients or gadget bindings.

        providerName
        The unique provider name.

      Example:

        wsadmin>NewsOAuth2ConsumerService.deleteProvider("provider123")


    Counting clients

      NewsOAuth2ConsumerService.countClient(string providerName)
      Return the total number of OAuth 2.0 clients registered with the consumer proxy.

        providerName
        An optional filter to only count clients associated with the specified provider.

      Example:

        wsadmin>NewsOAuth2ConsumerService.countClient("provider123")


    Returning a single client

      NewsOAuth2ConsumerService.findClient(string clientName)
      Return a Map with information about the registered OAuth 2.0 client with the specified name.

        providerName
        The client name.

      Example:

        wsadmin>NewsOAuth2ConsumerService.findClient("client123")


    Returning a list of clients

      NewsOAuth2ConsumerService.browseClient(string providerName, int pageSize, int pageNumber)
      Return a list of Map objects that represent each OAuth 2.0 clients registered with the consumer proxy, in ascending ordered by provider name. The following information is returned for each map object in the returned list:

      • clientId: the identifier issued by the authorization server when registering your client
      • clientSecret: the secret issued by the authorization server when registering your client
      • ctype: the client type, "confidential" or "public" are the supported values per the specification
      • grantType: "code" per specification, or "client_credentials" per specification
      • name: the name of the client
      • providerName: the name of the associated provider that was previously registered
      • redirectUri: the client redirection uri

        providerName
        An optional filter to only browse clients associated with the specified provider.

        pageSize
        The maximum number of clients to list per page. The default value is 20. This parameter is optional.

        pageNumber
        The number of the page to display.

        For example, if you specify in the pageSize parameter that each page will have 50 items, page 1 will contain items 1-50. The default value is 1. This parameter is optional.

      Example:

        wsadmin>NewsOAuth2ConsumerService.browseClient("provider123", 50, 1)


    Register or updating a client

      NewsOAuth2ConsumerService.registerClient(string clientName, string providerName, string ctype, string grantType, string clientId, string clientSecret, string redirectUri)
      Register or update an existing OAuth 2.0 client by name with the associated parameters.

        clientName
        The name to associate with the client that must be unique in a deployment.

        providerName
        The name of the registered provider to associate with this client.

        ctype
        The client type. Supported values are "confidential" or "public".

        grantType
        The authorization grant type. Supported values are "code" or "client_credentials".

        clientID
        The identifier issued by the authorization server when registering your client.

        clientSecret
        The secret issued by the authorization server when registering your client.

        redirectUri
        The client redirection URI.

      Example:

        wsadmin>NewsOAuth2ConsumerService.registerClient("client123", "provider123", "confidential", "code", "my-client", "my-secret", "https://{opensocial}/gadgets/oauth2callback")


    Delete a client

      NewsOAuth2ConsumerService.deleteClient(string clientName)
      Delete a client by name if it exists, and has no existing associated gadget bindings that leverage this client.

        clientName
        The name of the client to remove.

      Example:

        wsadmin>NewsOAuth2ConsumerService.deleteClient("client123")


    Binding a gadget

      NewsOAuth2ConsumerService.bindGadget(string widgetId, string serviceName, string clientName, string allowModuleOverride)
      Binds a gadget to a client with the specified service name and client name.

        widgetId
        The id of the widget.

        serviceName
        The name to associate with the gadget. The widgetId and service name must create a unique composite key for the deployment.

        clientName
        The name of the client to associate with this gadget.

        allowModuleOverride
        Value is "true" if the gadget overrides the provider default endpoint urls, else "false".

      Example:

        wsadmin>NewsOAuth2ConsumerService.bindGadget("aad20aa1-c0fa-48ef-bd05-8abe630c0012", "connections_service", "client123", "false")


    Delete a binding

      NewsOAuth2ConsumerService.unbindGadget(string widgetId, string serviceName)
      Delete a gadget binding by widgetId and serviceName.

        widgetId
        The id of the widget.

        serviceName
        The name to associate with the gadget. The widgetId and service name must create a unique composite key for the deployment.

      Example:

        wsadmin>NewsOAuth2ConsumerService.unbindGadget("aad20aa1-c0fa-48ef-bd05-8abe630c0012", "connections_service")


    Returning bindings

      NewsOAuth2ConsumerService.browseGadgetBinding(string widgetId, string clientName, int pageSize, int pageNumber)
      Return a list of Map objects that represent each OAuth 2.0 gadget bindings registered with the consumer proxy ordered by service name ascending. The following information is returned for each map entry in the returned list:

      • clientName: the name of the associated client
      • allowModuleOverride: "true" or "false"
      • serviceName: the name of the associated service
      • uri: the gadget uri

        widgetId
        An optional filter to browse bindings only associated with a specific widget.

        clientName
        An optional filter to browse gadgets only associated with the specified client.

        pageSize
        The maximum number of bindings to list per page. The default value is 20. This parameter is optional.

        pageNumber
        The number of the page to display.

        For example, if you specify in the pageSize parameter that each page will have 50 items, page 1 will contain items 1-50. The default value is 1. This parameter is optional.

      Example:

        wsadmin>NewsOAuth2ConsumerService.browseGadgetBinding("aad20aa1-c0fa-48ef-bd05-8abe630c0012", "client123", 50, 2)


    Counting bindings

      NewsOAuth2ConsumerService.countGadgetBinding(string widgetId, string clientName)
      Return the total number of OAuth 2.0 bindings registered with the consumer proxy.

        string widgetId, string clientName
        widgetId is an optional filter to count only bindings associated with a specific widget.

      Example:

        wsadmin>NewsOAuth2ConsumerService.countGadgetBinding("aad20aa1-c0fa-48ef-bd05-8abe630c0012", "connections_servicex")


    Returning a single binding by gadgetUri

      NewsOAuth2ConsumerService.findGadgetBindingByUri(string gadgetUri, string serviceName)
      Return a Map with information about the registered OAuth 2.0 gadget bindings with the specified gadgetUri and service name.

        gadgetUri
        The uri for the gadget.

        serviceName
        The name associated with the gadget. A gadgetUri and service name create a unique composite key for a gadget in the deployment.

      Example:

        wsadmin>NewsOAuth2ConsumerService.findGadgetBindingByUri("http://www.acme.com/mygadget", "connections_service")


    Returning a single binding by widgetId

      NewsOAuth2ConsumerService.findGadgetBindingByWidgetId(string widgetId, string serviceName)
      Return a Map with information about the registered OAuth 2.0 gadget bindings with the specified widget id and service name.

        widgetId
        The id of the widget.

        serviceName
        The name associated with the gadget. A widgetId and service name create a unique composite key for a gadget in the deployment.

      Example:

        wsadmin>NewsOAuth2ConsumerService.findGadgetBinding("aad20aa1-c0fa-48ef-bd05-8abe630c0012", "connections_service")


    Purge all tokens

      NewsOAuth2ConsumerService.purgeAllTokens()
      Purge all tokens persisted in the repository. This operation should be executed if the underlying encryption method has been modified.

    Example:

      wsadmin>NewsOAuth2ConsumerService.purgeAllTokens()


    Register IBM Notes as a consumer of the Activity Stream and Embedded Experience gadgets

    Connections and Domino administrators can work together to facilitate seamless integration between Connections and IBM Notes and iNotes . Your administrator can export the Activity Stream and Embedded Experience gadgets and hand them off to the Domino administrator to be included in the corporate Widget Catalog where they can then be deployed to end users using Widget policies.

    The Activity Stream widget is supported in the Notes client only. When the widget titled Updates, is installed, end users will see a new shortcut action in the Notes shortcut bar labeled Updates. The Updates tab opens automatically for the end user showing the activity stream.

    The Embedded Experience widget is supported in both Notes and iNotes. When the widget titled Connections EE Gadget, is installed, it allows for emails from Connections to display as an Embedded Experience such that users can interact with Connections directly within their email.

    An Connections administrator can run a script that generates xml files for the Activity Stream and Embedded Experience gadgets. The files are created from six configuration files. The script reads in the template files, performs an oAuth registration to create the consumer data, and then generates six xml files in a user-specified directory. Then these six xml files are given to the Domino administrator who imports them into the Widget Catalog, completing the cycle. The jython script is in the bin directory as a sibling of oauthAdmin.py and other Connections jython scripts. The six configuration files are placed in the LotusConnections-config directory. The script is invoked as follows:

    1. From a wsadmin prompt, run the following command: execfile('gadgetAdmin.py').

    2. From a wsadmin prompt, run the following command: NotesRegistrar.registerGadgets("appid","applabel","callbackurl","outputdir"). Where

      • appId is an identifier for the application you are registering. It can be anything you like such as MyGadgets.
      • applabel is a descriptive name for your client such as My Gadgets for Open Social.
      • callbackurl is where to redirect to when the gadget has been granted authorization. This should be: http://yourdominoserver.domainx.com/fiesta/gadgets/oauth2callback where yourdominoserver is the name of your shindig server; however, you should use https if the Domino Server is enabled for it.
      • outputdir is the location on disk that will contain the output from running the command. The outputdir must exist before running the command.

      For example:

        wsadmin>NotesRegistrar.registerGadgets("MyGadgets","My Gadgets for Open Social","http://yourdominoserver.domainx.com/fiesta/gadgets/oauth2callback","c:\test")

      There is an optional fifth argument "secure" that defaults to "false". A value of "false" indicates that https is not being used and instead plain http is used. If provided and set to "true", the gadget URLs will be the secure https versions of the URLs.

      For example, NotesRegistrar.registerGadgets("appid","applabel","callbackurl","workingdir","false") is the same as calling NotesRegistrar.registerGadgets("appid","applabel","callbackurl","workingdir") and it generates gadget URLs with plain http. However, if the last argument is "true", then the URLs are generated with the https prefix. If the value of the forceConfidentialCommunications attribute in the LotusConnections-config.xml is true, then the secure parameter should also be set to true. Result: When the script completes, the following six files can be found in the specified outputdir:

      • AS.Gadget.extension.xml

      • AS.Gadget.oauth.xml

      • AS.Gadget.proxy.xml
      • EE.Gadget.extension.xml
      • EE.Gadget.oauth.xml
      • EE.Gadget.proxy.xml

    3. Transfer these files to the Domino administrator for import.


    Import task performed by the Domino administrator

    The Domino administrator needs to be careful with the xml files because the *.oauth.xml files contain the consumer key and secret. The files should be moved to a secure and safe location on your local machine.

    This process needs to be performed on the Domino side for the Activity Stream gadget and Embedded Experience gadget. Upon completion, the Activity Stream and Embedded Experiences gadgets can now be deployed to end users.

    1. Copy the AS*.xml and EE*.xml files to a folder on your local machine.

    2. Open the widget catalog on your Domino server with a Notes id that has proper access to the Widget Catalog to publish and approve widgets.

      The Notes id requires the Admins role in the Widget Catalog and the Credential Store and Manager access to both of those databases.

    3. Open the All Widgets view and click Import.

    4. Navigate to the folder you created in step 1, select the AS.Gadget.extension.xml file, and then click Open.

    5. Click Yes and then click OK. The "Updates" document opens automatically and the Security Review Status indicates Approval Needed.

    6. Click Edit and then click Approve.

    7. In the Configure Proxy dialog box click OK. You should not have to edit any values in this dialog. The import in step 4 populates the field values in this dialog.

    8. In the Configure OAuth Consumer Information dialog box click OK. You should not have to edit any values in this dialog. The import in step 4 populates the field values in this dialog. The Security Review Status will indicate Approved by YourAdmin.
    9. Close the document.

    10. Repeat steps 2 through 9 for the EE*.xml files.


    Configure per-host proxy access rules for OpenSocial gadgets

    Proxy access is configured on a per-gadget level. This configuration is distinct from the proxy configuration file in that it specifies which end points may be contacted rather than what tokens or headers may be sent. In general the proxy access is configured during gadget registration by setting the Server access setting to external (outside the SSO domain) or all server access. Beyond these two settings, an administrator may expand or restrict access further by specifying custom proxy or (in cases where they wish for extra security) may enumerate per-gadget-per-server (and even per user) custom proxy rules. Custom proxy rules are defined in a separate configuration file. The rule manager operates as a stack. If one rule allows the request and a second deny's the request, then the last rule to execute wins. In Connections the execution ordering is as follows:

    denyAll() Block all requests
    MasterRule() Consult the widget DB and allow or deny the request based on the gadget administrative data. Registering a gadget with "custom" causes a deny() to be pushed onto the stack
    Custom rules defined in proxy-policy.dynamic proxy-policy.dynamic is executed. This file contains additional allow/deny rules.

    Thus, custom rules you define in the policy file might override any other access decision. In the case of gadgets with "custom" server access, the gadget has no implicit server access.

    The "proxy-policy.dynamic" file is located in the under LotusConnections-config/opensocial-proxy-rules. Add rules as needed as described in this topic. Unlike other configuration files, an application or server restart is NOT needed to reload the file. File changes will be detected and acted upon with-in 10-15 seconds. A rule consists of an Action, User, Target URL, and Component.

    • The Action represents the action to be taken by the proxy when processing this rule such as "Allow" and "Deny".

    • The User represents a current user, and can be an anonymous user or system user, for example, the viewer or owner of a gadget.
    • Target URL represents the target URL to access through the proxy.

    • The Component represents the gadget that sends out the request.
    The rules are specified as JavaScript program source code. Each rule is specified as a JavaScript function invocation. Four functions are provided out-of-box:

    • allow - Used to specify an ALLOW rule. This function takes three parameters:

      • Current user's UID
      • Widget's URL - URL of the widget/gadget component that sends the request
      • Target URL - the URL that the widget/gadget wants to access.

      For example, allow('user1', 'http://www\.example.com/widget1\.xml', 'http://www\.google\.com') specifies that if the current user is 'user1', then the widget 'http://www.example.com/widget1.xml' is allowed to access URL 'http://www.google.com'.

    • deny - Used to specify a DENY rule. This function shares the same parameters as allow function.
    • allowAll - A shortcut function to allow all requests.
    • denyAll - A shortcut function to deny all requests.
    When using allow and deny functions, the username, widget URL and target URL are actually regular expressions so wild cards can be used.

    For example, if all user names that start with 'user' is allowed, then 'user.*' can be entered as the first parameter. A guide of JavaScript regular expression pattern can be found at here. Since the rules are specified as JavaScript program source code, JavaScript code logic also can be used. You can use an if/else clause in a rule.

    For example, The following predefined variables also are provided:

    • user: login-id of current user
    • componen URL of the widget that sends the request
    • targetUr the URL to access
    These predefined variables can be used in the JavaScript code.

    For example:

      allow('user1', '.*', '.*ibm\.com'); // user1 is allowed to access all URLs that end with ibm.com

    In another example of a gadget that draws from Connections data, you want to set a rule that only certain gadgets can communicate with the internet. To accomplish this you could set a global rule to prevent gadgets from connecting to secure.ibm.com and then make gadget- or user-specific rules to permit particular gadgets to do so. Or you can expose certain mail servers, but you might want extra protection so that only certain gadgets can make a request to those servers. Here is an example of rule configuration that uses a mix of allow and deny functions: 

    /* 
* Pre-defined variables that can be used in the script.  
* _user -> Current user's UID 
* _component -> Gadget URL 
* _targetUrl -> Target URL to access  */ 

allowAll(); // this means allow('*', '*', '*')
allow('alex', 'http://myserver/gadget1.xml', 'www.ibm.com');
deny('alex', 'http://myserver/gadget1.xml', 'www.ibm.com/private');

deny('bob', 'http://myserver/gadget2.xml', '*'); 
deny('*', 'http://myserver/gadget3.xml', '*'); 

//denyAll(); // this means deny('*', '*', '*');

if (/\S+@\S+\.ibm\.com/i.test(_user)) {  // Use regular expression 
    allow(_user, '*', '*.ibm.com');  //IBM users are allowed to access IBM sites 
}


    Control the maximum file upload size for the Connections OpenSocial Container

    You can use the container file upload policy to manage the file upload size for the OpenSocial Container.

    For features that utilize the OpenSocial container including the Files and Connections mail gadgets, the maximum file upload size is controlled via the container file upload policy. By default, this setting allows a max file upload of 10 MB. To modify this setting:

    1. Add the <properties> element at the end of LotusConnections-config.xml if it is not already present.

    2. Within the <properties> element add <genericProperty name="shindig.config.container.overrides"> to specify the maximum upload size in bytes: 

      <properties>
<genericProperty name="shindig.config.container.overrides">
{
   // Max file upload in bytes
    "gadgets.jsonProxyUrl.maxPostSize 10485760
}
</genericProperty>
<properties>


    Clearing the widget cache

    Two methods of clearing the widget cache are available:

    To clear the Widget Container-related caches

      Home page | Administration | Refresh cache

    This action forces a cached copy of a gadget or iWidget from the Widget Container cache. Refreshing the cache typically is used during development to allow a user to see changes to the gadget or iWidget immediately.

    To clear cached widget.xml files from your server without needing to restart your system...

    If a gadget or iWidget.xml has been updated and you want to force it to be reread by the system, simply call this command as follows:

    1. Start the wsadmin client: app_server_root\profiles\Dmgr01\bin

    2. Start the News Jython script interpreter

        execfile("newsAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. To clear the cache:

        wsadmin>NewsWidgetCatalogService.clearWidgetCaches()


    Security token properties

    You can configure security token properties in...

      LotusConnections-config/LCC/opensocial-config.xml

    Property Default Description
    containerTokenTTLSec 1800 The number of seconds that a container token is considered valid before the application makes a hard check of the current users' authentication data. Smaller values result in more server load from users who leave windows opened to Connections.
    transientErrorRetryIntervalSec 60 The interval to of seconds to wait before reattempting failed container token update requests.
    authErrorRetryIntervalSec 300 The interval for users reattempting container token rechecks that fail due to authentication issues.
    containerTokenCheckSec 5 The frequency by which the system polls the auth-check cookie to validate the current users' SSO data. This allows logouts to propagate between browser tabs.
    scopeAuthCheckCookieToSSODomain false The scope to which the auth-check cookie is set. Only change this value if you have vanity URLs for Connections such as, profiles.renovations.com, blogs.renovations.com, bookmarks.renovations.com, and so on.
    gadgetTokenTTLSec 2700 The number of seconds the gadget tokens are considered valid before the system issues a request to refresh the gadget tokens.


    Manage access

    Manage roles, credentials, users, and directories, and allow third-party access to Connections data.

    Manage access by setting roles, creating superusers, allowing third-party applications to access data, making sure the administrator credentials are accurate, keeping users synchronized with the directory, managing inappropriate content, and enabling moderation.


    Roles

    You can define roles for users on WebSphere Application Server. Four roles are available across all Connections applications: person, everyone, reader, and admin. Other roles are used by the applications for system administration.


    Activities roles

    J2EE Role Description
    admin Used by an administrator to manage application content.
    everyone Users with this role can access public pages without signing in to the application. The login page is an example of a page that allows such access. Do not change the default mapping for this role because it is used internally by Connections. Changing the mapping might affect the ability to log in to the application.
    person Users with this role can read and write to the application.
    reader Users with this role have read-only access to the application. By default, the role is mapped to the Everyone group. If you map the role to the All Authenticated in Application's Realm group, users must log in before they can use the application. This role is also used to restrict access to the Ajax proxy. In a production environment, map this role to the All Authenticated in Application's Realm group.
    search-admin Used by the Search application to read public and private data for creating search indexes.
    widget-admin Used by widget containers to alert widget applications about container changes.

    The role is mapped to the user that is specified in the remoteHandlerAuthenticationAlias attribute. This attribute is defined in widgets-config.xml for each application.

    The installation wizard sets this attribute to the connectionsAdmin alias and maps the widget-admin role to the user that is specified in that alias. The same user must also be mapped to the person role.


    Blogs roles

    J2EE Role Description
    admin Used by an administrator to manage application content.
    everyone Users with this role can access public pages without signing in to the application. The login page is an example of a page that allows such access. Do not change the default mapping for this role because it is used internally by Connections. Changing the mapping might affect the ability to log in to the application.
    global-moderator Users with this role can moderate content. They can read, edit, delete, reject, approve, quarantine, and close entries and comments, and flag inappropriate content.
    person Users with this role can read and write to the application.
    reader Users with this role have read-only access to the application. By default, the role is mapped to the Everyone group. If you map the role to the All Authenticated in Application's Realm group, users must log in before they can use the application. This role is also used to restrict access to the Ajax proxy. In a production environment, map this role to the All Authenticated in Application's Realm group.
    search-admin Used by the Search application to read public and private data for creating search indexes.
    widget-admin Used by widget containers to alert widget applications about container changes.

    The role is mapped to the user that is specified in the remoteHandlerAuthenticationAlias attribute. This attribute is defined in widgets-config.xml for each application.

    The installation wizard sets this attribute to the connectionsAdmin alias and maps the widget-admin role to the user that is specified in that alias. The same user must also be mapped to the person role.


    Bookmarks roles

    J2EE Role Description
    everyone Users with this role can access public pages without signing in to the application. The login page is an example of a page that allows such access. Do not change the default mapping for this role because it is used internally by Connections. Changing the mapping might affect the ability to log in to the application.
    person Users with this role can read and write to the application. .
    reader Users with this role have read-only access to the application. By default, the role is mapped to the Everyone group. If you map the role to the All Authenticated in Application's Realm group, users must log in before they can use the application. This role is also used to restrict access to the Ajax proxy. In a production environment, map this role to the All Authenticated in Application's Realm group.
    search-admin Used by the Search application to read public and private data for creating search indexes.


    Communities roles

    J2EE Role Description
    admin Used by an administrator to manage application content.
    communities-metrics-run Other than administrators, only the community owners who are assigned to the community-metrics-run role can access community metrics. Users with this level of access see static reports of community metrics, which can be refreshed by clicking Update in the Metrics user interface. You can map this role to all users or to a subset of the user population.

    For example, you can gradually provide the community metrics feature to users by mapping this role to a small group and adding more users later.

    This role and the community-metrics-run role for Metrics must be mapped to the same users.

    community-creator Users with this role can create communities. By default, this role is mapped to the Everyone group but can be changed to a more restricted group if necessary.

    A user must be mapped to this role to create a subcommunity. In addition, the user must be an owner of the parent community.

    dsx-admin Used by the Communities directory service extension to read both public and private data. Do not map real users to this role.
    everyone Not used.
    global-moderator Users with this role can see the moderation link on the navigation bar in communities. To access the moderation user interface, they must also be mapped to the Moderation global-moderator role.

    To moderate content, users must be mapped to the global-moderator role in the Blogs, Forums, or Files applications.

    For example, a user who wants to moderate Blogs in a community must be mapped to the global-moderator role in Communities, Moderation, and Blogs.

    metrics-reader Users with this role can view the general statistics for the Communities application by clicking the Server Metrics link in the standard footer.
    person Users with this role can create communities, join a public community, or request to join a moderated community. Only users with this role can create or update the Communities Atom API.
    reader Users with this role have read-only access to the application. By default, the role is mapped to the Everyone group. If you map the role to the All Authenticated in Application's Realm group, users must log in before they can use the application. This role is also used to restrict access to the Ajax proxy. In a production environment, map this role to the All Authenticated in Application's Realm group.
    search-admin Used by the Search application to read public and private data for creating search indexes.
    widget-admin Used by widget containers to alert widget applications about container changes.

    The role is mapped to the user that is specified in the remoteHandlerAuthenticationAlias attribute. This attribute is defined in widgets-config.xml for each application.

    The installation wizard sets this attribute to the connectionsAdmin alias and maps the widget-admin role to the user that is specified in that alias. The same user must also be mapped to the person role.


    Files roles

    J2EE Role Description
    admin Used by an administrator to manage application content.
    everyone By default, this role is mapped to the Everyone group. Do not change the default mapping for this role because it is used internally by Connections. Changing the mapping might affect the ability to log in to the application.
    everyone-authenticated Mapped by default to the All Authenticated in Application's Realm group. Do not modify this mapping.
    files-owner Users with this role have the privileges as the person role. They also have a personal file stream when they log in to Files. If a user is removed from this role after they already logged in to files, they continue to have a personal file library. However, the library is hidden from the main personal files user interface for them. If you change this role, or change members of groups in the role, use administrative commands to browse and delete applicable personal libraries.

    This role does not affect who can upload files to community file libraries. It is mapped to the All Authenticated in Application's Realm group by default. You can apply this role to a subset of users in the group to limit who can upload files.

    global-moderator Users with this role can moderate content. They can read, edit, and delete community files and comments that are already approved. They can reject or approve community files and comments that are awaiting approval. They can also quarantine content, restore or delete quarantined content, and close flags on content.
    person Users with this role can read and write to the application.

    When this role is mapped to All Authenticated in Application's Realm, the reader role must be mapped to Everyone.

    reader Users with this role have read-only access to the application. By default, the role is mapped to the Everyone group. If you map the role to the All Authenticated in Application's Realm group, users must log in before they can use the application. This role is also used to restrict access to the Ajax proxy. In a production environment, map this role to the All Authenticated in Application's Realm group.

    If the reader role is mapped to a group other than Everyone, the person role must have the same mappings.

    search-admin Used by the Search application to read public and private data for creating search indexes.
    widget-admin Used by widget containers to alert widget applications about container changes.

    The role is mapped to the user that is specified in the remoteHandlerAuthenticationAlias attribute. This attribute is defined in widgets-config.xml for each application.

    The installation wizard sets this attribute to the connectionsAdmin alias and maps the widget-admin role to the user that is specified in that alias. The same user must also be mapped to the person role.


    Forums roles

    J2EE Role Description
    admin Used by an administrator to manage application content.
    discussThis-user If Discuss This is enabled on Forums, users can see the Discuss This link in a topic page if they are members of a group that includes the discussThis-user role. By default, the role is mapped to the Everyone group.
    everyone Users with this role can access public pages without signing in to the application. The login page is an example of a page that allows such access. Do not change the default mapping for this role because it is used internally by Connections. Changing the mapping might affect the ability to log in to the application.
    global-moderator Users with this role can moderate content. They can read, edit, delete, reject, approve, quarantine, and close entries and comments, and flag inappropriate content.
    person Users with this role can read and write to the application.
    reader Users with this role have read-only access to the application. By default, the role is mapped to the Everyone group. If you map the role to the All Authenticated in Application's Realm group, users must log in before they can use the application. This role is also used to restrict access to the Ajax proxy. In a production environment, map this role to the All Authenticated in Application's Realm group.
    search-admin Used by the Search application to read public and private data for creating search indexes.
    widget-admin Used by widget containers to alert widget applications about container changes.

    The role is mapped to the user that is specified in the remoteHandlerAuthenticationAlias attribute. This attribute is defined in widgets-config.xml for each application.

    The installation wizard sets this attribute to the connectionsAdmin alias and maps the widget-admin role to the user that is specified in that alias. The same user must also be mapped to the person role.


    Home page roles

    J2EE Role Description
    admin This role is used to protect the Home page administrative user interface, which allows administrators to register new widgets and to enable and disable widgets. Users with this role can see a Server metrics link in the Home page footer.

    By default, this role is not mapped to any users. You must map specific administrator user IDs to the role, but do not map the role to the Everyone or All Authenticated in Application's Realm groups.

    everyone This role applies to the Home page login page and the service configuration APIs only. The role allows users to access these resources without authentication. By default, the role is mapped to the Everyone group. Do not change the default mapping for this role because it is used internally by Connections. Changing the mapping might affect the ability to log in to the application.
    person This role is used to secure the Home page user interface. By default, this role is mapped to the All Authenticated in Application's Realm group, which means that all authenticated users can access the Home page. Users must authenticate to access the Home page so, this role must not be mapped to the Everyone group. If you must restrict access to a smaller set of users, modify the mapping of this role as necessary.
    reader Users with this role have read-only access to the application. By default, the role is mapped to the Everyone group. If you map the role to the All Authenticated in Application's Realm group, users must log in before they can use the application. This role is also used to restrict access to the Ajax proxy. In a production environment, map this role to the All Authenticated in Application's Realm group.

    The Home page application uses this role to access the Search APIs.

    Modifying this role has no effect on the Home page.


    Metrics roles

    J2EE Role Description
    metrics-report-run Grants users the authority to view and interact with global metrics. Other than administrators, only the users that are assigned to the metrics-report-run role can access global metrics. Whenever a user with this authorization level views global metrics, the report information is updated automatically. For best results, limit access to a small set of users whose jobs require them to view the most recent metrics. Granting this level of access to many users might slow performance because update requests are processed in sequence
    community-metrics-run Other than administrators, only the community owners who are assigned to the community-metrics-run role can access community metrics. Users with this level of access see static reports of community metrics, which can be refreshed by clicking Update in the Metrics user interface. You can map this role to all users or to a subset of the user population.

    For example, you can gradually provide the community metrics feature to users by mapping this role to a small group and adding more users later.

    This role and the community-metrics-run role for Communities must be mapped to the same users.

    metrics-reader Grants users the authority to view metrics from the previous release of Connections (for information, see the Connections 3.0.1 topic Collecting metrics). If you upgraded to version 4, this role remains in place with its existing assignments.

     


    Mobile roles

    J2EE Role Description
    everyone Applies to the Mobile page login page API. This role allows users to access these resources without any authentication. By default, the role is mapped to the Everyone group. Do not change the default mapping for this role because it is used internally by Connections. Changing the mapping might affect the ability to log in to the application.
    person Used to secure all Mobile pages other than the login page. By default, this role is mapped to the All Authenticated in Application's Realm group so that all authenticated users can access the Mobile pages. To restrict access to a smaller set of users, modify the mapping of this role. However, do not map this role to the Everyone group because the Mobile application must not be available to unauthenticated users.


    Moderation roles

    J2EE Role Description
    reader Applies to public Atom APIs. Modifying this role limits access to the public APIs.

    Users with this role have read-only access to the application. By default, the role is mapped to the Everyone group. If you map the role to the All Authenticated in Application's Realm group, users must log in before they can use the application. This role is also used to restrict access to the Ajax proxy. In a production environment, map this role to the All Authenticated in Application's Realm group.

    everyone-authenticated Mapped by default to the All Authenticated in Application's Realm group. Do not modify this mapping.
    person Used to secure the Atom APIs for "top stories" or "saved stories" and to secure the Email preferences page. Users must authenticate to access the New APIs and preferences page. By default, this role is mapped to the All Authenticated in Application's Realm group. To restrict access to a smaller set of users, modify the mapping of this role. Do not map this role to the Everyone group because the email preferences page must not be available to unauthenticated users.
    global-moderator Users with this role can moderate content. They can read, edit, delete, reject, approve, quarantine, and close entries and comments, and flag inappropriate content.

    To moderate content, users must be mapped to the global-moderator role in the Blogs, Forums, or Files applications.

    For example, a user who wants to moderate Blogs in a community must be mapped to the global-moderator role in Communities, Moderation, and Blogs.


    News roles

    J2EE Role Description
    admin Defined in the news repository but, by default, this role is not mapped to any users. Changing the mapping of this role has no effect on the news repository.

    To delete items posted by the microblogging APIs, a user must be mapped to this role. These items include status updates such as comments, recommendations, and third-party OpenSocial APIs. A user in this role can view any Community feed.

    everyone Users with this role can access public pages without signing in to the application. The login page is an example of a page that allows such access. Do not change the default mapping for this role because it is used internally by Connections. Changing the mapping might affect the ability to log in to the application.
    person Used to secure the Atom APIs for "top stories" or "saved stories" and to secure the Email preferences page. Users must authenticate to access the New APIs and preferences page. By default, this role is mapped to the All Authenticated in Application's Realm group. To restrict access to a smaller set of users, modify the mapping of this role. Do not map this role to the Everyone group because the email preferences page must not be available to unauthenticated users.
    reader Applies to public Atom APIs. Modifying this role limits access to the public APIs.

    Users with this role have read-only access to the application. By default, the role is mapped to the Everyone group. If you map the role to the All Authenticated in Application's Realm group, users must log in before they can use the application. This role is also used to restrict access to the Ajax proxy. In a production environment, map this role to the All Authenticated in Application's Realm group.

    sharebox-reader Allows read/write access to sharebox resources. By default, this role is mapped to the Everyone group.


    Profiles roles

    J2EE Role Description
    admin Used by an administrator to manage application content.
    allAuthenticated This role is used to secure the login-redirect page. The role is needed to correctly redirect users back to the page that they were attempting to access before the login procedure began. The role is mapped to the All Authenticated in Application's Realm group by default. Do not change the default mappings for this role because it is used internally by Connections. Changing the role might affect the ability to log in to the application.
    dsx-admin Used by the Profiles directory service extension to read both public and private data. This role secures the directory service communication when email addresses are hidden.
    everyone Users with this role can access public pages without signing in to the application. The login page is an example of a page that allows such access. Do not change the default mapping for this role because it is used internally by Connections. Changing the mapping might affect the ability to log in to the application.
    person Users with this role can read and write to the application.
    reader Users with this role have read-only access to the application. By default, the role is mapped to the Everyone group. If you map the role to the All Authenticated in Application's Realm group, users must log in before they can use the application. This role is also used to restrict access to the Ajax proxy. In a production environment, map this role to the All Authenticated in Application's Realm group.
    search-admin Used by the Search application to read public and private data for creating search indexes.


    Search roles

    J2EE Role Description
    admin Administrative role. No default mappings are defined for this role. The installation wizard maps the person that is defined as the system administrator to this role.
    everyone Not used. There are no default mappings that are defined for this role. By default, this role is mapped to the Everyone group. Changing the mapping has no effect.
    person Restricts access to the user interface for the Search application and personal Atom API searches (/atom/mysearch). By default, this role is mapped to the Everyone group but this mapping can be changed to a more restricted group if needed.
    reader Used to protect the Atom APIs, except for /atom/mysearch. Modifying this role limits access to the public APIs.

    Users with this role have read-only access to the application. By default, the role is mapped to the Everyone group. If you map the role to the All Authenticated in Application's Realm group, users must log in before they can use the application. This role is also used to restrict access to the Ajax proxy. In a production environment, map this role to the All Authenticated in Application's Realm group.


    WidgetContainer roles

    J2EE Role Description
    trustedExternalApplication Used to distribute third-party events on behalf of other users. This role supports targeting to individual users and Communities and the impersonation of existing users for OpenSocial POST APIs. Connections Content Manager uses this role to publish events to the Connections activity stream.


    Wikis roles

    J2EE Role Description
    admin Used by an administrator to manage application content.
    everyone Users with this role can access public pages without signing in to the application. The login page is an example of a page that allows such access. Do not change the default mapping for this role because it is used internally by Connections. Changing the mapping might affect the ability to log in to the application.
    everyone-authenticated Mapped by default to the All Authenticated in Application's Realm group. Do not modify this mapping.
    person Users with this role can read and write to the application.

    When this role is mapped to All Authenticated in Application's Realm, the reader role must be mapped to Everyone.

    reader Users with this role have read-only access to the application. By default, the role is mapped to the Everyone group. If you map the role to the All Authenticated in Application's Realm group, users must log in before they can use the application. This role is also used to restrict access to the Ajax proxy. In a production environment, map this role to the All Authenticated in Application's Realm group.

    If this role is mapped to a group other than Everyone, the person role must have the same mappings.

    search-admin Used by the Search application to read public and private data for creating search indexes.
    widget-admin Used by widget containers to alert widget applications about container changes.

    The role is mapped to the user that is specified in the remoteHandlerAuthenticationAlias attribute. This attribute is defined in widgets-config.xml for each application.

    The installation wizard sets this attribute to the connectionsAdmin alias and maps the widget-admin role to the user that is specified in that alias. The same user must also be mapped to the person role.

    wiki-creator Users with this role can create wikis outside of communities. By default, the role is mapped to the All Authenticated in Application's Realm group. This role does not determine whether users can create wikis in communities.


    Assign people to J2EE roles

    Assign roles for Connections users on WebSphere Application Server.

    For definitions of the different roles, see the Roles topic.

    To assign a person or group to a role:

    1. From WAS admin console, expand Applications > Application Types and then select WebSphere enterprise applications.

      Find and click the link to the application to configure.

    2. Click Security role to user/group mapping.

      Find the role to add users to.

    3. Select the role to assign and click Map users or Map groups.

    4. Search for the person or group to assign to this role.

      If the user or group exists in the directory, it is displayed in the Available list.

    5. Select the user or group name from the Available box and move it into the Selected box by clicking Add.

    6. To add more users to the role, repeat Steps 4 and 5.

    7. Click OK.

    8. To map a user or group to a different role for another application, repeat steps 1–7.

    9. Click OK and then click Save to save them.

    10. Synchronize and restart all instances of WebSphere Application Server.


    Manage stored credentials

    Connections does not create nor store user names and passwords. Instead, it uses the user credentials that already exist in your LDAP directory for authentication. Connections does not store administrative user IDs and passwords either. It does, however, create and store references to existing administrative user credentials. You can make changes to those references.


    User credentials

    To change a user's password, you must change the password in the LDAP directory that you are using to store user data. Connections does not provide a method that administrators can use to change user credentials. Use the methods in place in your organization for changing user credentials. Alternatively, you can refer to the documentation provided with the LDAP directory that you are using.


    Administrative credentials

    When you install Connections, it creates a set of references to the administrative user credentials it needs to access other tools and services to configure Connections. Refer to the following topics for information on how to update these references.


    Change WAS administrative user ID password

    Update the password for the administrative user ID used to configure Connections on WebSphere Application Server.

    This is an optional procedure.

    1. Review Administrative user password settings in the WebSphere Application Server information center.

    2. WAS ND only: Synchronize the nodes of the cluster to propagate the change.

    3. If the administrative user ID is used in any of the J2C authentication aliases, update the password associated with the alias.

      In WAS administration console, select Security > Global security.

    4. In the Authentication area, expand Java Authentication and Authorization Service, and click J2C authentication data.

    5. Click the alias name to edit it, and then change the value in the Password field.

    6. Apply and save the changes.

    7. Restart the servers hosting Connections.


    Change references to database administrative credentials

    Update the aliases that reference the administrative user IDs and passwords used to manage Connections databases.

    This is an optional procedure.

    1. Change the administrative user credentials using the tools provided with the database product that you are using.

      • DB2 Configuration Assistant
      • Oracle Enterprise Manager Console
      • SQL Server Management Studio

    2. Update the reference to the administrative user credentials. Change the credential information for the corresponding J2C authentication alias.

      In WAS administration console, select Security > Global security.

    3. In the Authentication area, expand Java Authentication and Authorization Service, and click J2C authentication data.

    4. Click the alias name to edit it. .


      DB2 database user IDs and aliases

      Database user ID Description Alias
      LCUSER Admin privileges to access all of the application tables in the DB2 database. activitiesJAASAuth
      blogsJAASAuth
      communitiesJAASAuth
      dogearJAASAuth
      filesJAASAuth
      forumJAASAuth
      homepageJAASAuth
      metricsJAASAuth
      newsJAASAuth
      profilesJAASAuth
      searchJAASAuth
      wikisJAASAuth


      Oracle database user IDs and aliases

      Database user ID Description Alias
      BLOGSUSER Admin privileges to access the Blogs table in the Oracle database. blogsJAASAuth
      DFUSER Admin privileges to access the Forums table in the Oracle database. forumJAASAuth
      DOGEARUSER Admin privileges to access the Bookmarks table in the SQL Server and Oracle databases. dogearJAASAuth
      FILESUSER Admin privileges to access the Files table in the SQL Server and Oracle databases. filesJAASAuth
      HOMEPAGEUSER Admin privileges to access the Home page table in the Oracle database. The same user ID administers the Home page, Search, and Updates services. homepageJAASAuth
      newsJAASAuth
      searchJAASAuth
      METRICSUSER Admin privileges to access the Metrics table in the SQL Server and Oracle databases. metricsJAASAuth
      OAUSER Admin privileges to access the Activities table in the SQL Server and Oracle databases. activitiesJAASAuth
      PROFUSER Admin privileges to access the Profiles table in the SQL Server and Oracle databases. profilesJAASAuth
      SNCOMMUSER Admin privileges to access the Communities table in the SQL Server and Oracle databases. communitiesJAASAuth
      WIKISUSER Admin privileges to access the Wikis table in the SQL Server and Oracle databases. wikisJAASAuth


      SQL Server database user IDs and aliases

      Database user ID Description Alias
      BLOGSUSER Admin privileges to access the Blogs table in the SQL Server database. blogsJAASAuth
      DFUSER Admin privileges to access the Forums table in the SQL Server database. forumJAASAuth
      DOGEARUSER Admin privileges to access the Bookmarks table in the SQL Server and Oracle databases. dogearJAASAuth
      FILESUSER Admin privileges to access the Files table in the SQL Server and Oracle databases. filesJAASAuth
      HOMEPAGEUSER Admin privileges to access the Home page table in the SQL Server database. The same user ID administers the Home page, Search, and Updates services. homepageJAASAuth
      newsJAASAuth
      searchJAASAuth
      METRICSUSER Admin privileges to access the Metrics table in the SQL Server and Oracle databases. metricsJAASAuth
      OAUSER Admin privileges to access the Activities table in the SQL Server and Oracle databases. activitiesJAASAuth
      PROFUSER Admin privileges to access the Profiles table in the SQL Server and Oracle databases. profilesJAASAuth
      SNCOMMUSER Admin privileges to access the Communities table in the SQL Server and Oracle databases. communitiesJAASAuth
      WIKISUSER Admin privileges to access the Wikis table in the SQL Server and Oracle databases. wikisJAASAuth

    5. Change the value in the Password field to reflect the change you made in Step 1.

    6. Apply and save the changes.

    7. Restart the servers hosting Connections.


    Change references to administrative credentials

    Update the aliases that reference the administrative user IDs and passwords that are used to handle server-to-server communication.

    This task is optional.

    1. To update the aliases that manage server-to-server communication, edit the associated J2C authentication data for the alias.

      In WAS administration console, select Security > Global security.

    2. In the Authentication area, expand Java Authentication and Authorization Service, and click J2C authentication data.

    3. Click the connectionsAdmin alias to edit it.

      You defined the current user ID and password to use for the connectionsAdmin alias during the installation. The user ID and password must be one of the following values:

      • A valid user in the organization's LDAP service. Organizational security requirements might require you to change this password periodically, in which case the stored credentials must be updated to reflect the new password.

      • A user that is defined in the WebSphere Identity Manager.

    4. Update the values that changed.

    5. Apply and save the changes.

    6. Restart the servers that host Connections.

    7. If you changed the administrative user, update the mappings for the admin, dsx-admin, search-admin, trustedExternalApplication, and widget-admin J2EE roles.

      For more information, see Switching to unique administrator IDs for system level communication.

    8. Update the messaging bus configuration, which also relies on the connectionsAdmin alias.

      See Updating the messaging bus configuration when the connectionsAdmin user ID changes for more details.


    Switching to unique administrator IDs for system level communication

    Create extra J2C authentication aliases and remap the roles.

    This task is optional. Complete this task only if you want to map a different user ID to the system-level roles for one or more Connections applications.

    When you install Connections, you are prompted by the installation wizard to provide credentials for a user account for application-to-application communication. The installation wizard also creates a J2C authentication alias called connectionsAdmin. This alias is associated with the new user account and maps that account to a set of application roles. To map these roles to different system user accounts, create extra J2C authentication aliases and remap the roles.

    The connectionsAdmin is mapped to roles that carry out the following tasks:


    Roles that are associated with connectionsAdmin

    Role Description
    dsx-admin Used by the Profiles and Communities applications to retrieve user or community data. When other applications need user or community data, they use the connectionsAdmin user to authenticate with Profiles and Communities and then request the data from Profiles and Communities.
    search-admin Used by all applications to control which user IDs can query seedlist information. The seedlist data is used to create the global index. The Search application uses the connectionsAdmin user ID to authenticate with the other applications and queries them on a scheduled basis to update the index.
    widget-admin Used by applications, such as Activities, Blogs, Files, and Wikis, that make widgets available within the Communities application. Users that are assigned to this role can run administrative commands on managed applications. The Communities application uses the connectionsAdmin user ID to authenticate with the other applications and then passes the requests to them.

    The connectionsAdmin user is also used by the Home page application to secure the messaging bus connection.

    The connectionsAdmin does not represent the administrative user of an application; it represents a system-level user for application to application communication.

    To map a different user ID to one of the default roles:

    1. Complete either set of the following substeps:

      • Specify a different system-level user ID for the dsx-admin, search-admin, or widget-admin roles:

        1. From the IBM WebSphere Application Server Integrated Solutions Console, expand Securityand then select Global security.

        2. In the Authentication area, expand Java Authentication and Authorization Service and click J2C authentication data.

        3. Click New and then enter an alias name, user ID, and password.

          dsx-admin: If you use single sign-on, specify a user ID that is present in the corporate directory and not only in WebSphere Identity Manager.

          search-admin: Specify an alias with the syntax: searchapplication_nameAlias where application_name is the name of the application for which you want to create the alias. For example: searchBlogsAlias.

          widget-admin: Specify an alias name with the syntax: widgetapplication_nameAlias where application_name is the name of the application for which you want to create the alias.

          For example: widgetActivitiesAlias.

        4. Click OK and then click Save

        5. Repeat steps c to d for each new role to create.

        6. Save your changes.

      • Specify a different system-level user ID for the connectionsBus role:

        1. From WAS admin console, select Service integration > Buses.

        2. Click the bus to which you want to map a different user ID.

          All Connections buses have names that begin with Connections.

        3. Click Security > Users and groups in the bus connector role.

        4. Delete the existing user ID by selecting the check box next to the user ID and clicking Delete.

        5. To add the new user ID, click New, select User name, and then type the name of the new user ID.

        6. Click OK.

        7. Repeat steps b to f for each bus.

        8. Save the changes.

    2. Map the user in the alias to the role:

      For Activities, map the account that you are mapping to the widget-admin role to the person role as well.

      1. From WAS admin console, expand Applications > Application Types and then select WebSphere enterprise applications.

        Find and click the link to the application to configure.

      2. Click Security role to user/group mapping.

        Find the role that you created in the Role column and then click Map users or Map groups.

      3. In the Search String box, type the name of the user or group you would like to assign to this role and then click Search.

        If the user or group exists in the directory, it is displayed in the Available list.

      4. Select the user or group name from the Available box and then move it into the Selected column.

      5. Repeat steps i and j to add extra users or groups.

      6. Repeat steps f through k to define access levels and assign people to any other aliases that you created.

      7. Click OK.

      8. Click OK and then click Save to save the changes.

    3. (widget-admin role only) Edit the widget-config.xml file for each application that is affected:

      1. From the profile_root\config\cells\cellName\LotusConnections-config directory, open the widget-config.xml file in a text editor.

      2. Change the remoteHandlerAuthenticationAlias attribute in the lifecycle element for the widgetDef (widget definition) that corresponds to the application. Replace the current value with the name of the alias that you created. Include the full name of the alias, including the node name prefix, if it is present.

      3. Repeat the previous step for each application for which you defined a new alias.

      4. Save the widget-config.xml file.

    4. (dsx-admin role only) Update the value of the corresponding attributes in the LotusConnectiosn-config.xml file.

      To do so, Start wsadmin, and then complete the following steps:

      1. Access the Connections configuration file: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out Connections configuration files:

        LCConfigService.checkOutConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

          When you specify a path to the working directory on a system that is running Microsoft Windows, use a forward slash for the directory.

          For example: "C:/temp".

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

        • cell_name is the name of the WAS cell that hosts the Connections application. To get cell name: print AdminControl.getCell()

          This input parameter is case-sensitive.

      3. Use the following command to update the alias information:

        LCConfigService.updateConfig("profiles.directory.service.extension.enabled", "true")

      4. Open the LotusConnectiosn-config.xml file in a text editor and add the following values to the <sloc:serviceReference serviceName="directory"> element:

        <sloc:serviceReference serviceName="directory" communities_directory_service_extension_auth_alias="<alias_you_created>" communities_directory_service_extension_enabled="true" profiles_directory_service_extension_auth_alias="<alias_you_created>" />where alias_you_created is the alias you created in Step 1.

      5. Check in the configuration files in the same wsadmin session in which you checked them out.

        For more information, see Applying common configuration property changes.

    5. Restart the application servers that host the applications for which you created user roles.


    Update the messaging bus configuration when the connectionsAdmin user ID changes

    If the connectionsAdmin alias is changed to use a different user ID than was previously configured, complete this procedure to ensure that applications can still communicate event information to the news service.

    1. Stop all Connections applications.

    2. In WAS administration console, select...

        Service Integration | Buses | ConnectionsBus | Additional Properties | Security | Authorization Policy | Users and groups in bus connector role.

    3. Select the check box next to the existing entry of type User that contains the old user ID, and then click Delete.

    4. Click New, and then follow the wizard instructions to add the new user ID defined for the connectionsAdmin alias.

    5. Click OK, save the changes, and then restart the Connections environment..

    6. From Service Integration > Buses > ConnectionsBus, click Destinations.

    7. From the list of destinations, click connections.events.

    8. In the Message Points section, click Publication Points.

    9. For each entry in the list, click the name of the publication point, for example...

        connections.events@LCCluster1.000-ConnectionsBus

    10. Click...

        Runtime tab | Additional Properties | Subscriptions

    11. Select the check box against each subscription, so that they are all selected, and then click Delete.

    12. Repeat steps 11-14 for each publication point for the connections.events destination. There will be one publication point for each cluster in your deployment.

    13. Repeat steps 9-15 for the connections.platformCommands destination.

    14. Restart all applications.


    Change administrative credentials for the LDAP global unique ID

    When you change the credentials of the administrative user ID that serves as the global unique ID for Connections, also update the federated repository configuration for Connections.

    This is an optional procedure.

    1. In WAS administration console, expand Security, and then select Global security.

    2. Under User account repository, make sure Federated repositories is selected from the list, and then click Configure.

    3. Click the repository identifier value of the LDAP directory you are using with Connections.

    4. Update the Bind ID and Bind password fields to specify a temporary LDAP ID, and then apply your changes.

    5. Synchronize the change to all application server nodes, and then stop all application servers and restart them. Verify that you can still log in to the Integrated Solutions Console after the Deployment Manager restarts.

    6. Reset the actual production bind password in LDAP.

    7. Repeat Steps 2 through 5 to replace the temporary values specified for the Bind ID and password with the new ones.

    8. Restart the servers hosting Connections.


    Change the password for the mail administrative user

    If mail is configured to be sent from a dedicated mail server that requires authentication and update the credentials associated with it, you can change the password associated with mail.

    This is an optional procedure.

    1. Log into the IBM websphere Application Server Integrated Solutions Console, and then click Resources > Mail > Mail Sessions.

    2. Select Cell scope, and then click the session with the mail/notification JNDI name.

    3. In the Outgoing Mail Properties section, change the value in the Password field, verify the changed password, and then apply and save your changes.

    4. Restart the servers hosting Connections.


    Manage users

    As employees come and go from your organization, the corporate directory changes, and there are some steps that you, as the administrator, must take to make sure that those changes are reflected in the product by keeping the Connections membership tables up-to-date with the changes that occur in your corporate directory.

    If the Profiles application is installed, when you inactivate a user or make changes to user data, such as change a person's last name or email address in the Profiles database, that change is automatically pushed out to the membership and login tables of the other Connections applications.

    If Profiles is not installed in your deployment, you must apply the changes to the membership tables for each application separately. The only way to update user data in the membership tables for the other applications is through a set of administrative synchronization commands.


    User life cycle details

    Connections can identify whether people in the directory are active, meaning current employees or inactive, meaning were once listed in the directory, but have since left the company. Users who are inactive can be kept in the product membership and login tables, rather than being removed from the product databases entirely.

    The ability to identify a person as inactive or active both conserves the data the inactive user created and makes it possible for inactive employees to return to the organization and regain access to their previously created data.

    This feature implements the following behavior:

    • In searches and membership selection fields, only active people are displayed by default.

    • Useful data that people no longer in the company contributed to Connections applications does not have to be removed; it can remain for use by others, but the product user interface reflects the fact that the contributing user is currently inactive.

    • People who return to the company can be reactivated and can regain access to their old data.

    • Support is available to search for inactive people specifically.


    Manage users when the Profiles application is installed

    Manage users is easier if the Profiles application is installed and you accept the default configuration in which the Profiles directory service extension is used to retrieve data from the Profiles database instead of retrieving it from the LDAP directory. Starting with version 3, when you make changes to user status and data in the Profiles database, the changes are automatically propagated to the other application databases.

    You can use one of the following methods to update user data in the Profiles database:

    • Profiles Administrative API
    • Profiles administrative commands

    • IBM Tivoli Directory Integrator scripts


    Manage user data using the Profiles Administration APIs

    Use the Profiles Administration APIs to synchronize data between the Profiles database and the corporate directory. You can use the APIs as an alternative to running IBM Tivoli Directory Integrator scripts to initiate changes.

    See Profiles Administration API for more details.


    Manage user data using Profiles administrative commands

    Use administrative commands to manage Profiles users by setting their status to inactive.

    The commands in this topic are provided only as a last resort to allow the administrator to modify the data associated with a specific user in the Profiles and application databases. User data is normally automatically updated from the repository using the IBM Tivoli Directory Integrator scripts or the Profiles Administration API. The commands to update, activate, and inactivate users can introduce discrepancies between the application databases and the repository if not used carefully. It is very strongly advised that you check the data of the user in the repository prior to using these commands to avoid introducing discrepancies.

    These commands should not be used to propagate directory ID changes. If the Profiles database contains an updated directory ID for a user, it will not be able to identify that user to other component applications that contain an earlier version. These commands can be useful for propagating other profile updates. If profiles in other applications remain out of synch after TDI or admin API commands have been issued, see Synchronize user data using administrative commands.

    Install and configure the IBM HTTP Server before attempting to synchronize data between the Profiles database and other application databases.

    See Configure IBM HTTP Server for details.

    You can manage users in Profiles to allow for situations in which employees leave the organization.

    For example, you can set a user's status to inactive, which allows you to reuse the associated email address and login details for new employees. You can also reactivate a user's status in situations where the user leaves the organization temporarily.

    For example, if a profile owner goes on sabbatical or personal leave, you can set his status to inactive and then reactivate the user's status when he returns.

    When you set a user's status to inactive, that user's name is displayed in italic, gray text in membership lists, and their name is not returned in searches of the company directory. The inactive user's name no longer displays when you use type-ahead, and the person no longer receives email notifications from Connections.

    1. Start the wsadmin client...

        WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you try to run will not execute properly.

    2. Start the Profiles Jython script interpreter.

      1. Access the Profiles configuration files:

        execfile("profilesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Use the following commands to manage the user life cycle:


      Profiles user life-cycle commands

      Command Description
      ProfilesService.inactivateUser(String user_email_addr) Inactivates the user with the specified email address.

      After you run this command, the user is no longer active in the system. The email address is removed from all member tables and the status of the user changes from active (0) to inactive (1). All the user's login values are removed from the login tables and the login values associated with the user in the PROFILE_LOGIN table are removed. An event is created in which Profiles propagates these changes to the member and login tables of all installed applications to make sure the user's information is updated consistently across the application databases. The status of inactive users can be reactivated at a later time using the ProfilesService.activateUserByUserId command.

      For example:

        ProfilesService.inactivateUser("john.smith@example.com")

      ProfilesService.inactivateUserByUserId(String userID) Inactivates the user with the specified user ID. This command has the same behavior as the ProfilesService.inactivateUser command, except that it takes a user ID instead of an email address as an argument.

      After you run this command, the user is no longer active in the system. The email address is removed from all member tables and the status of the user changes from active (0) to inactive (1). All the user's login values are removed from the login tables and the login values associated with the user in the PROFILE_LOGIN table are removed. An event is created in which Profiles propagates these changes to the member and login tables of all installed applications to make sure the user's information is updated consistently across the application databases. The status of inactive users can be reactivated at a later time using the ProfilesService.activateUserByUserId command.

      The userID parameter is defined in the profiles-config.xml file by the lconnUserIdField tag. The default value is guid, which is stored in Prof_guid in the profiles database. The values for Prof_guid must match the values for UserID.

      For example:

        ProfilesService.inactivateUserByUserId("ec8a89c0-f41d-102c-9b60-f225bc6c4af4")

      ProfilesService.activateUserByUserId(String user_external_id, updated_properties_list) Activates the user with the specified external ID with new properties, which are passed as parameters using updated_properties_list. The default status of any user in Connections is active.

      The user_external_id parameter is the unique ID defined in the profiles-config.xml file by the lconnUserIdField tag. The default value is guid, which is stored in Prof_guid in the Profiles database.

      The valid properties for updated_properties_list are:

      • email
      • loginId. The value stored in the PROF_LOGIN field in the EMPLOYEE table.
      • logins. The list of logins stored in the PROFILE_LOGIN table.
      • displayName
      • directoryId (guid). The value stored in the PROF_GUID field in the EMPLOYEE table.
      You should specify at least one of the properties that will allow the user to log in, and it must be specified using a name-value pair.

      The status change and all property updates are propagated to all the installed Connections applications.

      Examples:

        ProfilesService.activateUserByUserId("ec8a89c0-f41d-102c-9b60-f225bc6c4af4", email="jsmith@example.com", loginId="jsmith")

        ProfilesService.activateUserByUserId("ec8a89c0-f41d-102c-9b60-f225bc6c4af4", email="ajretired1@example.com", logins=["alanjones1","ajonesRetired1"])

        ProfilesService.activateUserByUserId("ec8a89c0-f41d-102c-9b60-f225bc6c4af4", email="speters_Retired1@example.com")

      ProfilesService.updateUser(String user_email_addr, updated_properties_list) Replace the existing properties for the user with the specified email address with new properties, which are passed as parameters using updated_properties_list.

      The valid properties for updated_properties_list are:

      • email
      • displayName
      • directoryId (guid). The value stored in the PROF_GUID field in the EMPLOYEE table.
      • loginId. The value stored in the PROF_LOGIN field in the EMPLOYEE table.
      • logins. The list of logins stored in the PROFILE_LOGIN table. The list must be passed using the format: ["login1", "login2"]
      The properties are all optional and they must be specified using name-value pairs. The updated values are pushed out to all the applications in Connections using a platform command.

      For example, the following command updates the email address and the login for the user john.smith@example.com.

        ProfilesService.updateUser("john.smith@example.com", email="update_email@example.com", loginId="updated_login")

      The following command replaces the existing list of logins with the new one, ("login1", "login2").

        ProfilesService.updateUser("john.smith@example.com", logins=["login1, "login2"])

      ProfilesService.updateUserByUserId(String userID, updated_properties_list) Replace the existing properties for the user with the specified user ID with new properties, which are passed as parameters using updated_properties_list. This command has the same behavior as the ProfilesService.updateUser command, but it takes a user ID instead of an email address as an argument.

      The valid properties for updated_properties_list are:

      • email
      • displayName
      • directoryId (guid). The value stored in the PROF_GUID field in the EMPLOYEE table.
      • loginId. The value stored in the PROF_LOGIN field in the EMPLOYEE table.
      • logins. The list of logins stored in the PROFILE_LOGIN table. The list must be passed using the format: ["login1", "login2"]
      The properties are all optional and they must be specified using name-value pairs. The updated values are pushed out to all the applications in Connections using a platform command.

      The userID parameter is defined in the profiles-config.xml file by the lconnUserIdField tag. The default value is guid, which is stored in Prof_guid in the profiles database. The values for Prof_guid must match the values for UserID.

      For example:

        ProfilesService.updateUserByUserId("ec8a89c0-f41d-102c-9b60-f225bc6c4af4", email="update_email@example.com", loginId="updated_login")

      ProfilesService.swapUserAccessByUserId(String userToActivate, String userToInactivate) Associates the following properties of the external ID assigned to the person returning to the organization with the external ID used by the person before leaving the organization:

      • email
      • uid. The value stored in the PROF_UID field in the EMPLOYEE table.
      • guid. The value stored in the PROF_GUID field in the EMPLOYEE table.
      • loginId. The value stored in the PROF_LOGIN field in the EMPLOYEE table.
      • logins. The list of logins stored in the PROFILE_LOGIN table. The list must be passed using the format: ["login1", "login2"]
      The displayName property is not changed; it is assumed to be the same.

      Users can have access to the data associated with one or the other ID only. When you swap IDs to give a person access to the data associated with an old ID, he loses access to any data he created using the new ID. Run this command soon after the user returns to the organization to limit the amount of new data he can create and subsequently lose access to as a result of the swap.

      The following parameters are required.

      Parameters:

        userToActivate
        Current user ID of the person before leaving the organization and had his user state set to inactivate. Data that was created by this person and that is associated with this ID exists in the Lotus Connections databases and you want the person to be able to regain access to it.

        userToInactivate
        New user ID that was assigned to the person upon his return to the organization.

      Example: ProfilesService.swapUserAccessByUserId("DRcuidk001retired13","DRcuidk001rehired25") These changes are propagated across all the installed applications in Connections.

      ProfilesService.publishUserData(String user_email_addr) Publishes an update command to all the Connections applications for the user with the specified email address.

      The command publishes the data that is currently stored for the user in the Profiles database (email, displayName, logins, directoryId). If one of the applications misses an update event for some reason and the incorrect email address or name is displaying for a user, for example, you can use this command to force all the applications to resynchronize their data.

      For example:

        ProfilesService.publishUserData("john.smith@example.com")

      ProfilesService.publishUserDataByUserId(String userID) Publishes an update command to all the Connections applications for the user with the specified user ID. This command has the same behavior as the ProfilesService.publishUserData command, except that it takes a user ID instead of an email address as an argument.

      The command publishes the data that is currently stored for the user in the Profiles database (email, displayName, logins, directoryId). If one of the applications misses an update event for some reason and the incorrect email address or name is displaying for a user, for example, you can use this command to force all the applications to resynchronize their data.

      The userID parameter is defined in the profiles-config.xml file by the lconnUserIdField tag. The default value is guid, which is stored in Prof_guid in the profiles database. The values for Prof_guid must match the values for UserID.

      For example:

        ProfilesService.publishUserDataByUserId("ec8a89c0-f41d-102c-9b60-f225bc6c4af4")


    Manage user data using Tivoli Directory Integrator scripts

    There are a number of scenarios in which you might want to synchronize changes between the Profiles database and the LDAP directory, using IBM Tivoli Directory Integrator.

    When you want to update user information in the Profiles database, the model typically used is to update the information in the LDAP directory and then synchronize the changes back to the Profiles database.

    For example, if your organization has taken over a new division, you can add new employees to Profiles by importing their details into the LDAP directory and then synchronizing the changes to the Profiles database. One way to keep your profiles data synchronized with changes to the LDAP directory is to use the sync_all_dns task.

    For more information, see Synchronize LDAP directory changes with Profiles.

    However, there might be instances in which your organization wants to allow users to update their information directly in the Profiles database.

    For example, if users want to update their personal cell phone details, as administrator, you might allow them to make the changes in Profiles themselves. These changes must be synchronized back to the LDAP directory from Profiles. To start the synchronization process, you need to define values for the DSML server-related properties in profiles_tdi.properties and then run the appropriate process_draft_updates script.

    For more information, see Synchronize user data between Profiles and LDAP.

    Although it is not expected to be a frequent occurrence, there might also be instances in which you want to change your LDAP directory. In this scenario, you can run scripts that are provided with Connections to synchronize the user information used in Profiles with the user information stored in your new LDAP directory.

    For more information, see Updating Profiles when changing LDAP directory.

    Related information is available in the IBM Tivoli Directory Integrator solutions for Connections real-world scenarios wiki article.


    Synchronize source changes such as LDAP with Profiles

    As administrator, you need to synchronize changes from your LDAP directory to the Profiles database to ensure that your organizational information is kept up-to-date. Use the sync_all_dns task to keep your profiles data synchronized with changes to the LDAP directory. It is recommended that you run this task on a regular basis.

    If your LDAP directory has a data size limitation, consider using the source_ldap_iterate_with_filter property set to true when synchronizing changes from the LDAP directory back to the Profiles database. This property replaces the sync_all_dns_forLarge and collect_dns_iterate scripts used in earlier releases.

    Profiles is the repository for information about the people in your organization within Connections. Typically, this data is retrieved from an LDAP or other corporate source which is the master copy. When data changes in the source, you will want these updates reflected in Profiles and throughout Connections.

    For example, if an employee moves department or leaves the company, or if your organization has taken over another division and you want to import new hires into the Profiles database, you update the LDAP directory and then synchronize the changes to the Profiles database.

    For data sources, such as LDAP, the sync_all_dns command can be used to take changes from the source and apply them to the Profiles database. To keep the Profiles database in a close synchronized state with your LDAP directory, run this task nightly or at another frequency that suits you. During synchronization, the entries in the Profiles database are compared to the mapped values from the source. Updates are then applied to existing records, new records are added, and no longer found records are removed based on configuration settings. Because this task performs a complete comparison of the search scope with the Profiles database, be sure to allow sufficient time for it to run. As with the initial data population, the mapping values configured in map_dbrepos_from_source.properties are compared to determine if an update is needed. If you configure extension attributes, that information is also compared and synchronized.

    The sync_all_dns task creates temporary files that are used during the synchronization process so you need to allocate sufficient disk space. Location of these files and whether to delete or retain them after synchronization using the sync_updates_working_directory=sync_updates and sync_updates_clean_temp_files=false properties.

    If you are troubleshooting a problem, you should change the sync_updates_clean_temp_files=false setting to false to retain the temporary files for diagnosis.

    In addition to the temporary files, the following files in the TDI solution directory record the changes made during synchronization. When set to true, the sync_updates_show_summary_only property shows only the records that need to be changed, but does not make the changes.

    See Understanding how the sync_all_dns task works for more information.

    • employee.adds
    • employee.delete
    • employee.error
    • employee.skip
    • employee.update

    Like the other IBM Tivoli Directory Integrator tasks, the sync_all_dns command has its own log file that shares the same name as the task. You can check the log to see whether the task finishes successfully, and look for error information if necessary. You can also check the ibmdi.log file. This file is a system log that records detailed information about the task when it is run. All the Tivoli Directory Integrator log files are located in the TDI\logs folder.

    To synchronize LDAP directory changes with Profiles, perform the following steps.

    1. In addition to the general Tivoli Directory Integrator configuration properties, you can set the following properties in profiles_tdi.properties to control the synchronization process.

      For more information about Tivoli Directory Integrator configuration properties, see Tivoli Directory Integrator solution properties for Profiles.

      With the exception of sync_delete_or_inactivate, these properties can only be used with the sync_all_dns task; they cannot be used with the process_tds_changes and process_ad_changes commands.

      Option Description
      perform_deletion_for_sync Controls whether the specified delete action is performed as part of the sync_all_dns task. Set this property to true when you want to delete or mark as inactive those users who are no longer in the Profiles database.

      The command checks the value of the property and acts using the following logic:

      • If perform_deletion_for_sync=false then perform neither the delete nor the inactivate action.

      • If perform_deletion_for_sync=true then look at the sync_delete_or_inactivate property.
      • Based on the value of the sync_delete_or_inactivate property (either delete or inactivate), perform the specified action.
      source_ldap_iterate_with_filter This configuration should be used if the size of the data to be retrieved from LDAP exceeds the search limit from the LDAP.

      For example, if your search parameters would return 250K records but your LDAP only allows 100K to be returned at a time, this parameter must be used.

      If the data is too large, an LDAP size limit exceeded error message is generated. To configure this mechanism, see the Populating a large user set topic.

      When set to true, this specifies that the default iterations assembly line use the collect_ldap_dns_generator.js file to iterate over a set of LDAP search bases and filters. The cconfig setting replaces the sync_all_dns_forLarge and collect_dns_iterate scripts used in earlier releases.

      The default value is false.

      This parameter is not configurable when using the population wizard.

      sync_check_if_remove Specifies the name of an optional custom delete hook assembly line. By default, the assembly line's name is set to sync_all_dns_check_if_remove.

      For more information about this property, see Customizing the logic used for the delete operation.

      The sync_updates_double_check property must also be set to use this functionality.

      sync_delete_or_inactivate Controls what happens to a user record when the delete action is performed. The value must be either delete or inactivate and is case sensitive. By default, the property is set to inactivate so that users are not deleted. The inactive state is propagated to all the other Connections applications.

      This property cannot be used with the sync_all_dns, process_tds_changes, and process_ad_changes commands.

      For more information about this property, see Customizing the logic used for the delete operation.

      For information about automating the delete user or inactivate user process, see Using supplied scripts to delete inactive users based on inactivity length.

      sync_updates_clean_temp_files When set to true, this property deletes temporary files after the synchronization process is completed.
      sync_updates_double_check Uses the custom deletion-checking assembly line that is defined in the sync_check_if_remove property to perform a double check. The logic of the default double-check assembly line is to match on the distinguishedName mapping (usually $dn). If that match fails, the user is assumed to no longer be in the LDAP directory and is deleted.
      sync_updates_hash_field This property is used to match a record in the Profiles database with the corresponding record in the source. Choose a value that will not change, so that the match will remain intact between the source and the Profiles database.

      If the value in this field in the source changes, the match will be broken and unintended actions may take place, for example the existing database information for this person could be deleted if the corresponding match in the source is no longer accessible.

      The supported values for this field are guid, uid, and email.

      If the value of the hash field in the source has changed, you must set this property to a different value that has not changed.

      For example, if you have not changed the value of email, you can set it to email.

      The default value is uid.

      sync_updates_hash_partitions Number of partitions to divide the temporary files into. The default of 10 is sufficient in most cases. If the file size gets too large, this value can be increased.
      sync_updates_show_summary_only When set to true, this property shows only the records that need to be changed, but does not make the changes.
      sync_updates_working_directory The directory where the working files are stored. The path can be relative to the Tivoli Directory Integrator solution directory or an absolute path.

    2. If you are storing data from multiple LDAP branches in the same database, and you want to keep these areas synchronized with the LDAP directory, then you also need to synchronize them separately or distinctly. To accomplish this task, you can set the following properties in profiles_tdi.properties:

      These properties can only be used with the sync_all_dns task; they cannot be used with the process_tds_changes and process_ad_changes commands.

      Option Description
      sync_source_url_enforce=true Synchronizes only those records that have a matching URL. When set to true, it limits the scope of the set of data in the database and skips the records that do not match the source URL. When set to false, it deletes the records that do not match the source URL. The default value is false.
      sync_source_url_override=true Update the source_url field if it doesn't match when the employee is being updated.
      sync_store_source_url=true Stores the source LDAP URL in the prof_source_url field in the database. The source LDAP URL is needed to determine the source of the data to correctly synchronize it.

      When storing the sync_store_source_url property in the Profiles database, the data format of prof_source_url in the Profiles database is as follows:

        ldap://{hostname}:port/ldap_search_base?ldap_search_filter

    3. When the sync_all_dns task is performed, it generates a lock file in the Tivoli Directory Integrator solution directory to prevent other customers from starting another sync_all_dns process in the same Tivoli Directory Integrator solution. The name of the lock file is sync_all_dns.lck. When the sync_all_dns process has finished successfully, the lock file is automatically deleted. However, if the process did not complete, the lock file won't be deleted. In this case, you can delete it yourself, or run the clearLock.sh or clearLock.bat command, located in the Tivoli Directory Integrator solution directory.

    4. Process changes using one of the following options:

      • AIX or Linux:

        chmod +x sync_all_dns.sh
        ./sync_all_dns.sh

        Windows:

        sync_all_dns.bat

      • IBM i:

        sync_all_dns.sh


    Example employee tables

    This sample employee table illustrates results from a scenario in which you have pulled users A, B, and C from ldap_branch1 and users X, Y, and Z from ldap_branch2.


    Example employee table correlating initial employee UID and DN property values

    uid distinguishedName (DN)
    A ldap_branch1
    B ldap_branch1
    C ldap_branch1
    X ldap_branch2
    Y ldap_branch2
    Z ldap_branch2

    To synchronize the ldap_branch2 users, set the following properties:

    • source_ldap_url=ldap_branch2
    • sync_store_source_url=true
    • sync_source_url_enforce=true
    • sync_source_url_override=false

    By setting these properties, you get updates for the ldap_branch2 users X, Y, and Z, but not for users A, B, and C. Updates are not provided for users A, B, and C because their PROF_SOURCE_URL does not match the Tivoli Directory Integrator property source_ldap_url. When you set sync_source_url_enforce to true, the script skips users A, B, and C. When you set sync_source_url_enforce to false, users A, B, and C are deleted from the database.

    To move the ldap_branch1 users to another branch of the LDAP directory , ldap_branch3, set the following properties:

    • source_ldap_url=ldap_branch3
    • sync_store_source_url=true
    • sync_source_url_enforce=true
    • sync_source_url_override=true
    This configuration retrieves the users from ldap_branch3, and finds users A, B, and C but not users X, Y, and Z. It matches users A, B, and C because the hash field is the same. The synchronization updates in the Profiles database are shown in the following table:


    Example employee table correlating changed employee UID and DN property values

    uid distinguishedName (DN)
    A ldap_branch3
    B ldap_branch3
    C ldap_branch3
    X ldap_branch2
    Y ldap_branch2
    Z ldap_branch2


    Synchronize IBM Tivoli Directory Server and Microsoft Active Directory LDAP changes

    To keep your profiles synchronized with your LDAP directory, use the generic sync_all_dns command. However, if your LDAP directory is IBM Tivoli Directory Server or Microsoft Active Directory, you can use the process_tds_changes or process_ad_changes commands.

    The process_tds_changes and process_ad_changes commands do not support synchronizing multiple LDAP directories or multi-branch LDAP directories. If you have populated your profiles database with data from multiple locations, running the process_tds_changes and process_ad_changes commands applies changes related to the current LDAP directory only.

    To synchronize Tivoli Directory Server and Microsoft Active Directory LDAP directory changes with Profiles, perform the following steps.

    1. Update the change log properties in profiles_tdi.properties so that the changes to the LDAP directory can be reflected back to the Profiles database.

      The change log properties are the set of properties that begin with <LDAP_type>_changelog_*.

    2. Process changes using one of the following options:

      • For Tivoli Directory Server, use the following script to process changes made to the LDAP directory and have those changes made to the corresponding records in your database repository:

        • IBM AIX or Linux:

          chmod +x process_tds_changes.sh
          ./process_tds_changes.sh

          Windows:

          process_tds_changes.bat

        • IBM i:

          chmod +x process_tds_changes.sh
          process_tds_changes.sh

      • For Microsoft Active Directory, use the following script to process changes made after the initial population:

        • AIX or Linux:

          chmod +x process_ad_changes.sh

          ./process_ad_changes.sh

          Windows:

          process_ad_changes.bat

        • IBM i:

          chmod +x process_ad_changes.sh

          process_ad_changes.sh

    3. The process_tds_changes task keeps track of the changelog number in a persistent field. If your LDAP directory is reset, you can do one of the following:

      • Delete the changelog number value using the following script:

        • AIX or Linux:

          chmod +x reset_changelog_state.sh

          ./reset_changelog_state.sh

          Windows:

          reset_changelog_state.bat

        • IBM i:

          chmod +x reset_changelog_state.sh

          reset_changelog_state.sh

      • Set a particular value using the following script and passing it the count value to set:

        • AIX or Linux:

          chmod +x set_changelog_count.sh

          ./set_changelog_count.sh

          Windows:

          set_changelog_count.bat

        • IBM i:

          chmod +x set_changelog_count.sh

          set_changelog_count.sh


    Synchronize user data between Profiles and the LDAP directory

    To update profiles data, you typically update the LDAP directory first and then synchronize the changes to the Profiles database. However, there are some cases where you might want to allow users to make their own changes to their profiles, and these changes need to be written from the Profiles database back to the LDAP directory.

    Be sure to install and configure the IBM HTTP Server before attempting to synchronize data between the Profiles database and the LDAP server.

    See Configure IBM HTTP Server for more information.

    You can ensure that data in the LDAP directory is kept current by synchronizing any changes made to the Profiles directory back to the LDAP server.

    For example, users in your organization might need to update their cell phone details in Profiles. They cannot change the LDAP directory directly and, as administrator, you can allow them to make the changes directly in Profiles. These changes need to be reflected back to the LDAP directory using the drafting process.

    The draft table stores values that you edit and which you specify using the draftableAttribute element in the profiles-config.xml file.

    For example: 

    <profileDataModel>
   <!-- =================================================================================== -->
   <!-- This section is used to define attributes that are updated via the drafting process -->
   <!-- In most deployments you should never edit the config for this section.   -->
   <!-- Example: <draftableAttribute>displayName</draftableAttribute>  -->
   <!-- Example: <draftableExtensionAttribute extensionIdRef="tieline"/>  -->
   <!-- =================================================================================== -->
   <draftableAttribute>telephoneNumber</draftableAttribute>
</profileDataModel>
    The Profiles database is updated immediately with the specified values.

    You must configure a Directory Services Markup Language (DSML) server service to receive the update requests. The Profiles application does not provide this service because each implementation of an LDAP server is unique.

    To synchronize changes between the draft table and the LDAP server, you must run a script that initializes a daemon process that monitors the Profiles database for updates and, when one is made, formats the update as a DSML request and transmits it to a configured DSML server.

    To synchronize changes from the Profiles database back to your LDAP directory....

    1. Define values for the DSML server-related properties in profiles_tdi.properties.

      The DSML server-related properties are the properties with names that begin with...

      • monitor_changes_
      • dsml_server_

      Typically, update the following properties:

      • monitor_changes_dsml_server_url
      • monitor_changes_dsml_server_username
      • monitor_changes_dsml_server_password

    2. After providing values for the necessary properties, start the synchronization server process:

      • IBM AIX or Linux:

        chmod +x process_draft_updates.sh

        ./process_draft_updates.sh

        Windows:

        process_draft_updates.bat

      • IBM i:

        chmod +x process_draft_updates.sh

        process_draft_updates.sh

      The process_draft_update script tracks the database change record number in a persistent field. Your task cannot run successfully in the following situations:

      • You recreate the Profiles database after you have already run the IBM Tivoli Directory Integrator Solution at least once.

      • You clear the content of the CHG_EMP_DRAFT and EMP_DRAFT tables manually.

      In such situations, reset the persistent field and run the script again. You can reset the persistent field by performing one of the following steps:

      • Delete the database change record number value using the following script:

        • AIX or Linux:

          chmod +x reset_draft_iterator_state.sh

          ./reset_draft_iterator_state.sh

          Windows:

          reset_draft_iterator_state.bat

        • IBM i:

          chmod +x reset_draft_iterator_state.sh

          reset_draft_iterator_state.sh

      • Set a particular value using the following script and pass it the count value to set:

        • AIX or Linux:

          chmod +x set_draft_iterator_count.sh

          ./set_draft_iterator_count.sh

          Windows:

          set_draft_iterator_count.bat

        • IBM i:

          chmod +x set_draft_iterator_count.sh

          set_draft_iterator_count.sh


    Understanding how the sync_all_dns process works

    Use the sync_all_dns process to keep your profiles data synchronized with changes to the LDAP directory.

    The sync_all_dns process is a long running process comprised of multiple phases. As each phase of the sync_all_dns process runs, console output indicates current progress. The number of records in the LDAP source, and in the Profiles database, enable you to estimate the running time of the process.

    The properties mentioned in this topic reside in profiles_tdi.properties.

    Temporary files are created during synchronization and stored in the directory denoted by the property...

      sync_updates_working_directory=sync_updates

    By default, the temporary files are deleted at the end of synchronization. To keep the files or need to troubleshoot problems, set...

      sync_updates_clean_temp_files=false

    to ensure that the temporary files are not deleted.


    Phase 1

    The first phase processes the database. Progress is output every 10,000 records including a timestamp.

    Example: 

    CLFRN1275I: Begin to hash records in database.
CLFRN0028I: 20120806100604 Iterations: 10000.
CLFRN1269I: Finish hash records in database


    Phase 2

    The second phase processes the source with the same progress indicators as Phase 1.

    Example: 

    CLFRN1271I: Begin to hash records in source repository.
CLFRN0028I: 20120806110738 Iterations: 10000.
CLFRN0028I: 20120806110937 Iterations: 20000.
CLFRN0028I: 20120806111137 Iterations: 30000.
CLFRN1273I: Finish hash records in source repository


    Phase 3

    The third phase performs a comparison between the data retrieved in Phase 1 and 2.

    Example: 

    **********
CLFRN1268I: After processing partition 0, 3,772 records added to creates.ldiff; 1,947 records added to deletes.dbids.
**********
CLFRN1268I: After processing partition 1, 3,823 records added to creates.ldiff; 1,951 records added to deletes.dbids.
**********
...
**********

    This comparison determines if an operation should occur on a particular record from the LDAP source or from the Profiles database.

    Because the operation is not complete at this point in the processing, the numbers listed in this phase do not always match the final phase numbers.

    The processing is delimited by the number of partitions specified by the sync_updates_hash_partitions=10 property.

    The creates.ldiff and deletes.dbids files included in this example are stored in the location specified by the property...

      sync_updates_working_directory=sync_updates


    Phase 4

    The fourth phase performs the configured delete operation using the deletes.dbids file from Phase 3 for input.

    Example: 

    CLFRN1270I: Begin processing the data to be deleted or inactivated.
CLFRN0028I: 20120806122644 Iterations: 10000.
CLFRN1272I: Finish processing the data to be deleted or inactivated

    The operation is determined by the following properties:

    • sync_delete_or_inactivate=delete – Determines the action to be performed if a record is no longer found in the source LDAP but is present in the Profiles database.

      To perform additional processing during this phase, you can create and configure a custom delete option.

      See Customizing the logic used for the delete operation for details.

    • sync_updates_double_check=true
    • sync_check_if_remove={name-of-your-adapter.xml}:/AssemblyLines/{name-of-your-custom-delete-al}


    Phase 5

    The fifth phase performs the add or update operations, using the create.ldiffs file from Phase 3 for input.

    Example: 

    CLFRN1276I: Begin processing the data to be added.
CLFRN0028I: 20120806124006 Iterations: 10000.
CLFRN0028I: 20120806124513 Iterations: 20000.
CLFRN0028I: 20120806125021 Iterations: 30000.
CLFRN1274I: Finish processing the data to be added


    Summary phase

    A summary is displayed at the end of the sync_all_dns process.

    Example:

      CLFRN0037I: After synchronization, added or modified records is 37971, deleted or inactivated record s is 19551, unchanged records 0, and failure records is 0.

    Lists of the users for each of the operations are stored in the following files in the solution directory. You can examine these files when the synchronization process has completed. These files are not considered temporary and are not removed at the end of the synchronization process.

    • employee.adds – These records were added to the database
    • employee.delete – These records were deleted or inactivated in the database
    • employee.error – There was an error processing these records
    • employee.skip – These records were not changed in the database
    • employee.updates – These records were updated in the database


    Update Profiles when changing LDAP directory

    When you need to change to a new LDAP directory, you must synchronize the user data stored in profiles with the information in your new LDAP directory. You can run a command that synchronizes the information in the Profiles database with the user information stored in your new LDAP deployment.

    You must ensure that the values of either the uid or the email address in the existing data source match those in the new deployment LDAP directory. If neither of these properties have matching values, you cannot use the scripts provided with Connections to synchronize the IDs.

    To use the scripts provided with Connections to synchronize the IDs and update Profiles:

    1. Open profiles_tdi.properties from the IBM Tivoli Directory Integrator directory on the system that hosts the Profiles application in a text editor, and edit the following properties to match the values of the corresponding properties in the LDAP system:

      • source_ldap_url
      • source_ldap_user_login
      • source_ldap_user_password
      • source_ldap_search_base
      • source_ldap_search_filter
      • source_ldap_use_ssl

      For more information about these properties and how they are used, see Tivoli Directory Integrator properties.

    2. Ensure that the guid property in the map_dbrepos_from_source.properties file is set to the appropriate value for your environment:

      • IBM Tivoli Directory Server:

          guid=ibm-entryUuid

      • IBM Lotus Domino Directory:

          guid={function_map_from_dominoUNID}

      • Microsoft Active Directory:

          guid={function_map_from_objectGUID}

      • Sun Java System Directory Server:

          guid=nsuniqueid

      • eNovelle System Directory Server:

          guid={unction_map_from_GUID}

    3. Identify a database attribute to synchronize with – either uid, guid or email – with the same value per member in the old LDAP deployment as in the new, and then set the sync_updates_hash_field property in profiles_tdi.properties to this attribute. The names of the LDAP attributes are immaterial.

      For example:

        sync_updates_hash_field=uid

    4. Synchronize the data so that the values from the new LDAP deployment are updated in the Profiles database by running the following script:

      • IBM AIX or Linux:

          chmod +x sync_all_dns.sh
          ./sync_all_dns.sh

        Windows:

            sync_all_dns.bat

        • IBM i:

            sync_all_dns.sh

        For more information about the properties that you can set when synchronizing LDAP data with Profiles, see Synchronize LDAP directory changes with Profiles.


    Delete or inactivate users in the Profiles database

    You can use an IBM Tivoli Directory Integrator assembly line command to delete or inactivate users in the Profiles database.

    You can use the delete_or_inactivate_employees assembly line command to delete specific users from the Profiles database or set their status to inactive.

    To delete or inactivate specific users from the Profiles database:

    1. Create a text file named delete_or_inactivate_employees.in that contains the distinguished names and user IDs for the users to delete from the database. Use the following format to represent a user: 

      $dn:user_dn
uid:user_uid
      where:

      • user_dn corresponds to the PROF_SOURCE_UID in the Profiles database.
      • user_uid corresponds to the PROF_UID in the Profiles database.

      When deleting multiple users, there must be a period separator (.) between each entry. The "." must be added after the row containing the user's UID. If the separator is omitted, an error occurs when you use the delete command to delete the users from the database.

      Do not add a space after the colon and before the value. Here is an example of an entry from the delete_or_inactivate_employees.in file: 

      $dn:cn=Amy Jones3,cn=Users,l=WestfordFVT,st=Massachusetts,c=US,ou=Lotus,o=Software Group,dc=ibm,dc=com
uid:Amy Jones3
      When loading multiple users, there must be a period separator between each entry.

      For example: 

      $dn:cn=Amy Jones3,cn=Users,l=WestfordFVT,st=Massachusetts,c=US,ou=Lotus,o=Software Group,dc=ibm,dc=com
uid:Amy Jones3
.
$dn:cn=Amy Jones8,cn=Users,l=WestfordFVT,st=Massachusetts,c=US,ou=Lotus,o=Software Group,dc=ibm,dc=com
uid:Amy Jones8

    2. Place the file in the Tivoli Directory Integrator location specified for your deployment.

      For more information, see Configure Tivoli Directory Integrator.

    3. To delete the users from the database, run either...

      • delete_or_inactivate_employees.sh
      • delete_or_inactivate_employees.bat

      The following table shows the properties that are used by the command and their default values. These properties can be found in profiles_tdi.properties.

      The file path is relative to the TDI solution directory.


      Properties used with the delete_or_inactivate_employees command

      Property Description
      delete_or_inactivate_employees_simple_file File that you created in Step 1, which lists the people to be deleted or inactivated. The default value is delete_or_inactivate_employees.in.
      sync_delete_or_inactivate Specifies whether to delete or inactivate the people listed in the file specified using the delete_or_inactivate_employees_simple_file property. The options are:

        delete
        Removes the user from the Profiles database and, if the user exists in member or login tables for any of the other applications, deletes the user from those applications. The person’s email address is removed, all login values associated with the person are removed, and the photo and pronunciation files associated with the employee are deleted from the photo and pronunciation tables. You cannot add deleted users back into the directory and you cannot recover any data that they created after you delete them.

        inactivate
        Set the person's status to inactive. Unlike deleting people, when you inactivate people, you can reinstate them later if necessary.

        See Managing user data using Profiles administrative commands for more details. Any data created by the inactive person is preserved. An inactive person is identifiable in the product user interface because the person's name is greyed out, but information they contributed, to a community or forum, for example, is retained. An inactive person’s name is not included in searches and membership selection fields.

      The default value is inactivate.

      The inactivation of the person is propagated to the member and login tables for all the applications.


    Customize the logic used for the delete operation

    You can customize the delete logic to use when deleting users from the Profiles database.

    Connections provides a plug-in point for defining and using custom IBM Tivoli Directory Integrator (TDI) assembly lines that contain their own delete logic as part of the sync_all_dns task. This delete logic is used to identify when a user needs to be deleted from the Profiles database. An assembly line named sync_all_dns_check_if_remove, which checks whether a user should be deleted, is provided by default. You can add custom delete logic without making changes to the existing profiles_tdi.xml file.

    1. Configure your development environment for creating a delete logic script by following the steps in the topic, Setting up your development environment.

    2. Define an assembly line that contains your delete logic in the file. Your assembly line must return one of the following values:

      • remove. Specifies that the current entry should be added to the delete list.
      • updated. Specifies that the current entry should be updated, not deleted.
      These values are case-sensitive.

      Return the value as follows:

      1. Retrieve the checkResult attribute field from the work object into your assembly line. The attribute name is case-sensitive.

      2. Set your checking result to the value of the checkResult attribute.

      For example: 

      checkingResult = work.getAttribute("checkResult");
checkingResult.setValue("updated");

      For more information about how to create an assembly line, see the Create your first assembly line topic in the TDI product documentation.

    3. Use the publish feature to export the assembly line as a Tivoli Directory Integrator adapter.

      1. Right-click the assembly line in the Navigator and select Publish.

      2. Enter the name of the adapter in the Package ID field.

      3. Specify the following directory in the File Path field, and then click Finish.

        profiles_tdisoln/packages

    4. Add a reference to the profiles property store to your adapter files by running the fixup_tdi_adapters.sh or fixup_tdi_adapters.bat command.

      This reference is required to use the Profiles Tivoli Directory Integrator adapter. Even if you do not believe that your adapter file requires access to the profiles property store, there is no penalty for adding the reference so it is strongly advised that you run this command regardless.

    5. Open profiles_tdi.properties from the following location:

      tdisol.tar|zip/tdisol/TDI

    6. Set the following properties in the file:

        sync_updates_double_check
        Specifies whether your checking assembly line is used. When set to true, your deletion-checking assembly line is used. When set to false, the checking operation is not performed. The default value is false.

        For example:

          sync_updates_double_check=true

        sync_check_if_remove
        Specifies the name of your checking assembly line:

          sync_check_if_remove=name_of_your_adapter_xml_file:/AssemblyLines/name_of_your_assemblyline

        By default, the assembly line's name is set to sync_all_dns_check_if_remove.

        For example, if you publish the assembly line with the file name deleteCheckRoutines and the assembly line is example_check_if_user_really_deleted, use the following statement to set this property:

          sync_check_if_remove=deleteCheckRoutines:/AssemblyLines/example_check_if_user_really_deleted

        sync_delete_or_inactivate
        Controls what happens to a user record when the delete action is performed. This property can be set to one of the following values:

        • delete. Specifies that the user record is deleted.
        • inactivate. Specifies that the user record is inactivated.

          The inactive status is propagated to the member and login tables for all the applications. An event is generated for each of the following: Activities, Blogs, Bookmarks, Communities, Files, Forums, Profiles, Wikis, and News (which includes both Home page and Search). These events inactivate the user in every application by removing the user from the login tables and setting the user's status to 1 in all member tables.

        These values are case-sensitive so type them with care. The default value is inactivate.

        For example:

          sync_delete_or_inactivate=inactivate

    7. Save your changes to profiles_tdi.properties.


    Manage users when the Profiles application is not installed

    If the Profiles application is not installed, you must manage changes to user status and data in each application database independently. The only way to update user data in the databases for the other applications is through a set of administrative synchronization commands.

    These commands can also be used on Connections deployments that do have Profiles installed to resolve situations where an application's membership database table needs to be corrected.


    Synchronize user data using administrative commands

    Synchronize user data between the Connections application membership tables and the configured directory for the deployment.

    Each Connections application has its own database with membership tables containing a users external ID and user data related to that application. These databases must be synchronized with the configured directory in the deployment. The configured directory is typically the Profiles database in deployments where Profiles is installed and Profiles integration is enabled. If Profiles is not installed or is installed but Profiles integration is not enabled, then the configured directory is the corporate LDAP directory.

    The commands documented in this topic synchronize user data between the application databases and the configured directory in your environment. They also log entries in the application_name\UlcSyncCmd.log file that reports updated data items.

    When Profiles is installed, you should not generally use these commands. Profiles automatically synchronizes its user data with the application databases. Also, there is a set of Profiles administration commands for synchronizing in that environment. However, you can use these commands to resolve situations where an application database needs to be corrected.

    For example, if synchronization occurs for all but one application and you have a mismatch in that application’s database.

    Many of the synchronization commands have a matching preview command that shows you what the synchronization command would do if you ran it.

    For example, the command...

      FilesMemberService.previewSyncAllMembersByExtId

    ...generates a log showing what the command...

      FilesMembersService.syncAllMemberByExtId

    ...would do if you ran it. This can be useful when mismatches are suspected. The logs are located in the standard logging directory for the server, for example where the cluster’sSystemOut.log file is located, and the name is application_name\UlcSyncCmd.log. Output is appended if the log file already exists.

    You should run preview versions of commands before running the actual commands. When you are sure the command will do what you want, run the actual command.

    The following commands, identified by the leading wsadmin> parameter, update the Communities membership database.

    1. Initialize the Communities commands and then preview what the synchronize all command would do. 

      wsadmin>execfile("communitiesAdmin.py")
wsadmin>CommunitiesMemberService. previewSyncAllMembersByExtId({"updateOnEmailLoginMatch":
"true", "verbose "true"}
UpDt ExtId: f1a8d8c0-a59b-1030-85a9-c32c2f3a2ad1XX Name: Jane Doe has a superseded external ID,
and would have been updated: New ExtId: f1a8d8c0-a59b-1030-85a9-c32c2f3a2ad1
[2012-08-07 14:50:54] Additional application possibly-stale member data: Email:
jane_doe@us.acme.com Logins: [Doe, jane_doe@us.acme.com, Jane Doe]
[2012-08-07 14:50:54] Directory service basic user data: Display name: Jane Smith Update External id: f1a8d8c0-a59b-1030-85a9-c32c2f3a2ad1
[2012-08-07 14:50:54] Directory service email and logins: Email: sTestuser5@janet.iris.com
Logins: [Smith, Jane Smith, jane_doe@us.acme.com]

      The command reveals that the user’s external ID in Communities is obsolete.

    2. Run the following command to update the user’s external ID.

      Note that the preview sync all users command has been replaced by the more specific sync by email. You could use the syncAllMembersByExtId() parameter associated with the preview but it is best to use the most specific command. 

      wsadmin>CommunitiesMemberService.syncMemberExtIdByEmail("jane_doe@us.acme.com ")

CLFWY0263I: The synchronize command found that active member Jane Smith [current external id:
f1a8d8c0-a59b-1030-85a9-c32c2f3a2ad1XX, application id 6a716827-5fc8-438a-beb2-777f6f5d96df]
could not be matched via external id, but could be matched via login or email to external id
f1a8d8c0-a59b-1030-85a9-c32c2f3a2ad1.  The member was updated because this action was enabled by the command

    Only use the commands in this topic to synchronize user data in the following situations:

    • Profiles is not installed or Profiles integration is disabled.

    • You have just migrated from an earlier version of Connections.

    • You want to synchronize data for a specific application or a specific person in a specific application.

    • You want to determine if any application member data is out of sync with the configured directory.


    Administrative commands

    Use the following commands to update the identifying data and state (active or inactive) of the users listed in the application database, except for Profiles where you would use Tivoli Directory Integrator (TDI) to synchronize users in the Profiles database with a source LDAP database.

    The use of square brackets indicates that the enclosed parameters are optional; the square brackets are not part of the command line.

    The application_name variable represents the name of the application. The following options are available:

    • Activities
    • Blogs

    • Dogear (Bookmarks)
    • Communities
    • Files
    • Forums
    • News (Home page, News repository, and Search applications share the same database, so running synchronization against News applies to all three areas)
    • Wikis
    • Metrics

      application_nameMemberService.syncAllMembersByExtId( {"updateOnEmailLoginMatch": ["true" | "false"] } )

      This checks to see if the external ID found in the member database table is present in the configured directory as follows:

      • If the external ID is present, then the command gets the display name, email address, and login names from the configured directory and updates the application database tables with the values from the directory, if they are different. This refresh update operation is not logged to the output file.

      • If a match for the user's external ID is not found in the directory, then the command uses the email address and login names contained in the application database tables to continue to search for the user in the configured directory. When none of the credentials match the user is inactivated. How the command works when a match on the login names or email address is found differs depending on the parameter you specified with the command:

        Parameter: updateOnEmailLoginMatch: String. Options are true or false. The default is false.

          true
          Specifies that when a match is found in the configured directory based on the login names or email address of the user, the external ID in the application database is automatically updated with the external ID in the configured directory.

          false
          Specifies that when a match is found in the configured directory based on the login names or email address of the user, the external ID in the application database is written to the application_nameUIcSyncCmd.log file. You can manually make the update after confirming that the change should be made.

      • If a match for the user's external ID is not found in the configured directory, nor is a match found for the user's email address and login names, then the state of the user is changed to inactive in the application database.

      When none of the credentials match, the Boolean (true or false) parameter is ignored; the user is always inactivated

      application_nameMemberService.previewSyncAllMembersByExtId( {"updateOnEmailLoginMatch": ["true" | "false" ][, “multiLine ["true" | "false"] ] [, “verbose ["false" | "true"] ] }] )

      The preview command reports the action the corresponding syncAllMembersByExtId command would take (or not take) depending on the updateOnEmailLoginMatch parameter value. The results are placed in the application_nameUlcSyncCmd.log file.

      There are two optional parameters, multiLine and verbose, both of which take a Boolean string value. The default value is true for multiLine and false for verbose. If multiLine is true, each action report is broken into multiple short lines to make it easier to read. If multiline is false, each action report is a single line for ease of searching the file programmatically, for example with a grep utility. If verbose is false, only out of sync results are reported independent of the value of updateOnEmailLoginMatch. This includes members that would simply be refreshed. A member is refreshed if the member is active and the external ID is a match, but the display name, email, or the logins don’t match. If verbose is true, all members are reported, including active and inactive members.

      The format of each reported action is timestamp, action code, action data and action message. The code is a four letter code, listed at the end of this section. At the end of the file five numbers are reported. These are also explained at the end of this section. At the very end of the file is a number that is the total actionable items found.

      application_nameMemberService.syncMemberByExtId("currentExternalId"[, {"newExtId "id-string" [, "allowExtIdSwap ["true" | "false"] ] } ] )

      This determines whether the user identified by the first parameter, which is an eternal ID, should be is active or inactive by checking the configured directory for the external ID. The main purpose of this command is to reactivate a user.

      This is a complicated command that should be used carefully, particularly when swap is allowed.

      You can perform the following tasks with this command:

      • When only currentExternalId parameter is provided, the intent is to correct the state information for that user in the application database.

        Parameters:

          currentExternalId
          String. Unique external ID that represents a user. The command looks for this external ID in the application member table. If it does not find the ID, an error is generated. If the member is found, but is currently defined as inactive, an attempt is made to activate the member. To do so, the command looks up whether the member exists in the configured directory, and if so, then the member is activated in the application member table and the associated display name, email and login values for that member are restored. When this action is taken, the update is logged in the applicationUIcSyncCmd.log file. If the member is found and is currently defined as "active" in the application database, the code first looks up currentExternalId in the configured directory. If currentExternalId is not found, the command attempts to find the member by email or login value. If this succeeds, the external ID is updated along with a refresh of display name, email, and logins, and the change is logged. If this does not succeed, then the user is inactivated and the change is logged.
        Example:

          CommunitiesMemberService.syncMemberByExtId("F8E59CA4-7FE1-4195-AA96-A49CE5F8E17F")

      • When multiple parameters are provided, the intent is to activate the user identified by currentExternalId with the identity of the user defined by the newExtId. This command might be used when a user has application content, such as a Community, on the server but then leaves the company. The user is removed from the LDAP and the user's state is set to inactive in the application database tables. However, if that person is rehired by the company, the person is added back into LDAP and is assigned a new external ID. For this person to gain access to their old content, you can use the following command to swap their external IDs.

        Parameters:

          currentExternalId
          String. Unique ID that represents a user.

          newExtId
          To confirm changes made . String. If you provide this parameter:

          1. The same person is being represented by two different external IDs: the currentExternalId is in the application database where the member is marked as inactive and the newExtId, is stored in the configured directory.

          2. The newExtId updates that person’s external ID in the application database and the person is marked active.

          Only use this command when you are sure that the two IDs represent the same person.

          allowExtIdSwap
          To confirm changes made . String. Accepts the values true or false. The default value is false. Specifies whether to swap the new and current ID of the user in the two records that represent the same person. This parameter is only needed if the user was previously employed by the organization and existed in the application member tables with the current ID, departed the organization, and was given a new ID upon returning. After that person logs in to an application for the first time with their new ID, the new ID is added to the application member tables. If you want this new user to have access to the content that she created previously using the current ID, provide this parameter and set it to true. However, be sure to run this command soon after the person returns because once the IDs are swapped, the user is not able to access any new content that she created using the new ID, just her previous content. You cannot merge the data associated with the current and new IDs. If you provide this parameter and set it to false, an error message is displayed in the wsadmin client that indicates that the command could not complete because the newExtId already exists.
        Example:

          CommunitiesMemberService.syncMemberByExtId("7d71d8b2-7de511df-80b6c81b-5330ca0e", {"newExtId": "7d71d8b3-7de511df-80b6c81b-5330ca0e", "allowExtIdSwap": "true"})

      application_nameMemberService.inactivateMemberByEmail("email-address")

      This marks the person identified by email-address as inactive in the application's membership database tables, for example it changes the state of the specified user to inactive. In addition, the email address and login names for this user are removed from the application's database tables. The user's external ID and Display Name are not modified. The command also writes a status message to the application_nameUlcSyncCmd.log file indicating that the user has been deactivated.

      Parameter:

        email-address
        String. Email address of the user you want to mark as inactive in the application membership database tables.

      application_nameMemberService.inactivateMemberByExtId("externalID")

      This marks the person identified by external ID as inactive in the application's membership database tables. This command changes the state of the specified user to inactive. In addition, the email address and login names for this user are removed from the application's database tables. The user's external ID and Display Name are not modified. The command also writes a status message to the application_nameUlcSyncCmd.log file indicating that the user has been deactivated.

      Parameter:

        externalID
        String. Unique ID that represents the user you want to mark as inactive in the application membership database tables.

      application_nameMemberService.getMemberExtIdByEmail("email")

      This retrieves the external ID of the person identified in the email parameter and returns it to the wsadmin console. The external ID returned from this command can be used as input to some of the other wsadmin commands that require the user's external ID as an input parameter.

      Parameter:

        email
        String. Email address of the user whose external ID you want to retrieve.
      Example:

      • Command

          wsadmin>CommunitiesMemberService.getMemberExtIdByEmail("userB@example.com")

      • Result:

          510b99c0-0101-102e-8923-f78755f7e0ed

      application_nameMemberService.getMemberExtIdByLogin("login")

      This retrieves the external ID of the person identified in the login parameter and returns it to the wsadmin console. The external ID returned from this command can be used as input to some of the other wsadmin commands that require the user's external ID as an input parameter.

      Parameter:

        login
        String. Login name of the user whose external ID you want to retrieve.
      Example:

      • Command

          wsadmin>CommunitiesMemberService.getMemberExtIdByLogin("User A")

      • Result:

          806edb40-e8ba-102e-91cd-d74ea1c96b51


    Additional administrative commands

    The following commands were available in previous releases. Some have been updated to enable you to change the user state of a person from active to inactive or inactive to active. You might want to use these commands in the following cases:

    • To synchronize a batch of users from a file based on their login names and emails instead of external IDs.

    • To synchronize a particular user by login name or email, instead of by external ID.
    The application_name variable represents the name of the application. The following options are available:

    • Activities
    • Blogs

    • Dogear (Bookmarks)
    • Communities
    • Files
    • Forums
    • News (Home page, News repository, and Search applications share the same database. Running the synchronization command against News applies to all three areas.)
    • Wikis

    The application_nameMemberService.syncAllMemberExtIds() command was deprecated in version 3.

      application_nameMemberService.syncBatchMemberExtIdsByEmail("emailFile" [, {"allowInactivate ["true" | "false"] } ] )

      The command application_nameMemberService.syncBatchMemberExtIds(filename) was deprecated in version 2.5. Use this command or the syncBatchMemberExtIdsByLogin(loginFile) command instead.

      This synchronizes a list of users contained in the specified text file. The text file must define one email address per line. If a match is found, for example the email address identifies a member, the command retrieves the external ID in the application member table and looks it up in the configured directory. If the external ID is found, then the user's display name and any additional login names are refreshed if needed, so that they match those in the configured directory. The refresh operation is not logged.

      If the external ID is not found in the configured directory, then a synchronize operation is performed based on the email and login values and the user's external ID in the member table is updated with the external ID in the configured directory. Also, the user's display name, and any additional login names are refreshed. Each user that is synchronized by this operation is logged in the log file. If the user cannot be found in the configured directory by any means (external ID, login names, or email) then the user may be inactive. The command can do one of two things in this situation, depending on whether the following allowInactivate input parameter is set to true or false.

      Parameters:

        emailFile
        String. Path and name of text file that contains one entry per line of user email addresses (jdoe@example.com).

        allowInactivate
        String. Options are true or false. Specify one of these values to allow changes to the state of the user.
        If true, the user is inactivated in the member table of the application database if there is no match. The user's email and login names are deleted from the table and the state flag is set to inactive.
        If false or null, the user is not made inactive. Instead, a log message is written to the log file.

      For example

        ActivitiesMemberService.syncBatchMemberExtIdsByEmail("c:/foo/bar/my_sync_file.txt", { "allowInactivate":"true"})

      application_nameMemberService.previewSyncBatchMemberExtIdsByEmail("emailFile"[, { "allowInactivate ["true" | "false"] [, "multiLine ["true" | "false"] ] [, "verbose ["true" | " false"] ] } ] )

      See the description of preview commands under the previewSyncAllMembersByExtId() command at the beginning of this section. Note that the default value for the verbose parameter is true.

      application_nameMemberService.syncBatchMemberExtIdsByLogin("loginFile" [, {"allowInactivate ["true" | "false"] } ] )

      The command application_nameMemberService.syncBatchMemberExtIds(filename) was deprecated in version 2.5. Use this command or the application_nameMemberService.syncBatchMemberExtIdsByEmail(emailFile) command instead.

      This synchronizes a list of users contained in the specified text file. The text file must define one login name per line. For each login name, if a match is found the command checks the external ID in the application member table against the value in the configured directory to see if it matches. If the external ID matches, then the user's email address and display name and any additional login names are refreshed if needed so that they match those in the configured directory. The refresh operation is not logged.

      If the external ID is not found in the configured directory, then a synchronize operation is performed based on the email and login values and the user's external ID in the member table in the application database is updated with the external ID in the configured directory. Also, the user's email, display name, and any additional login names are refreshed. Each user that is synchronized by this operation is logged in the log file. If the user cannot be found in the configured directory by any means (external ID, login names, or email) then the user may be inactive. The command can do one of two things in this situation, depending on whether the allowInactivate input parameter is set to true or false (see the following explanation of the two flags).

      Parameters:

        loginFile
        String. Path and name of a text file that contains one user login name entry per line.

        allowInactivate
        String. Options are true or false. Specify one of these values to allow changes to the state of the user.
        If true, the user is inactivated in the member table of the application database if there is no match. The user's email and login names are deleted from the table and the state flag is set to inactive.
        If false or null, the user is not made inactive. Instead, a log message is written to the log file.
      This command does not return anything.

      For example

        ActivitiesMemberService.syncBatchMemberExtIdByLogin("c:/foo/bar/login_sync_file.txt", { "allowInactivate":"false"})

      application_nameMemberService.previewSyncBatchMemberExtIdsByLogin("loginFile" [, { "allowInactivate ["true" | "false"] [, "multiLine ["true" | "false"] ] [, "verbose ["true" | " false"] ] } ] )

      See the description of preview commands under the previewSyncAllMembersByExtId() command at the beginning of this section. Note that the default value for the verbose parameter is true.

      application_nameMemberService.syncMemberExtIdByEmail("email" [, { "allowInactivate ["true" | "false"] } ])

      The command application_nameMemberService.syncMemberExtId(java.lang.String key) was deprecated in version 2.5. Use this command or the syncMemberExtIdByLogin(java.lang.String loginName) command instead.

      This synchronizes the member record in the application member table identified by the member's email address parameter. If a match is found, for example the email address identifies a member, the command retrieves the external ID in the application member table and looks it up in the configured directory. If the external ID is found, then the user's email address and display name and any additional login names are refreshed as needed so that they match those in the configured directory. The refresh operation is not logged.

      If the external ID is not found in the configured directory, then a synchronize operation is performed based on the email and login values and the user's external ID in the member table is updated with the external ID in the configured directory. Also, the user's email, display name, and any additional login names are refreshed. Each user that is synchronized by this operation is logged in the log file. If the user cannot be found in the configured directory by any means (external ID, login names, or email) then the user may be inactive. The command can do one of two things in this situation, depending on whether the allowInactivate input parameter is set to true or false (see the following explanation of the two flags).

      Parameters:

        email
        String. A user's email address.

        allowInactivate
        String. Options are true or false. Specify one of these values to allow changes to the state of the user.
        If true, the user is inactivated in the member table of the application database if there is not match. The user's email and login names are deleted from the table and the state flag is set to inactive.
        If false or null, the user is not made inactive. Instead, a log message is written to the log file.

      For example

        ActivitiesMemberService.syncMemberExtIdByEmail("jdoe@example.com", {"allowInactivate":"false"})

      application_nameMemberService.previewSyncMemberExtIdByEmail("emailAddr" [, { "allowInactivate ["true" | "false"] [, "multiLine ["true" | "false"] ] [, "verbose ["true" | " false"] ] } ] )

      See the description of preview commands under the previewSyncAllMembersByExtId() command at the beginning of this section. Note that the default value for the verbose parameter is true.

      application_nameMemberService.syncMemberExtIdByLogin("name" [, {"allowInactivate": ["true" | "false"] } ])

      The command application_nameMemberService.syncMemberExtId(java.lang.String key) was deprecated in version 2.5. Use this command or the application_nameMemberService.syncMemberExtIdByEmail(java.lang.String emailAddress) command instead.

      This synchronizes the member record in the application member table identified by the user login name parameter. If a match is found, for example the email address identifies a member, the command retrieves the external ID in the application member table and looks it up in the configured directory. If the external ID is found, then the user's email address and display name and any additional login names are updated so that they match those in the configured directory. The refresh operation is not logged.

      If the external ID is not found n the configured directory, then a synchronize operation is performed and the user's external ID in the member table is updated with that of the external ID in the configured directory. Also, the user's email, display name, and any additional login names are refreshed. Each user that is synchronized by this operation is logged in the log file. If the user cannot be found in the configured directory by any means (external ID, login names, or email) then the user may be inactive. The command can do one of two things in this situation, depending on whether the allowInactivate input parameter is set to true or false.

      Parameters:

        name
        String. User login name.

        allowInactivate
        String. Options are true or false. Specify one of these values to allow changes to the state of the user.
        If true, the user is inactivated in the member table of the application database if there is not match. The user's email and login names are deleted from the table and the state flag is set to inactive.
        If false or null, the user is not made inactive. Instead, a log message is written to the log file.

      For example

        ActivitiesMemberService.syncMemberExtIdByLogin("jdoe", {"allowInactivate":"true"})

      To understand the ‘preview’ version of the command see the explanation of preview under the previewSyncAllMembersByExtId() command at the beginning of this section. Note that the default value for the verbose parameter is true.

      application_nameMemberService.previewSyncMemberExtIdByLogin("name"[, { "allowInactivate ["true" | "false"] [, "multiLine ["true" | "false"] ] [, "verbose ["true" | " false"] ] } ])

      See the description of preview commands under the previewSyncAllMembersByExtId() command at the beginning of this section. Note that the default value for the verbose parameter is true.


    Sample user management scenarios

    The following scenarios address some of the common tasks involved in managing user data within an organization.

    User management commands allow the administrator to push LDAP changes from Profiles to the other applications so that as data in Profiles is added and updated, these changes can be easily captured and propagated to the rest of Connections. An extension hook to IBM Tivoli Directory Integrator is also provided, allowing administrators to add custom logic for determining if a user has left the system or has been affected by a human resources action that might prevent Tivoli Directory Integrator from being able to match their old employee record with their new employee record. Examples of such actions typically include users moving from part-time to full-time or transferring from one country to another.


    Improving directory synchronization

    Use this procedure to help keep track of users as they transition from part-time to full-time or from one country to another and enable your IBM Tivoli Directory Integrator solution to handle actions that could otherwise lead to orphaned user data.

    To strengthen your Tivoli Directory Integrator (TDI) scripts, your organization must maintain data in the LDAP directory that allows you to connect the old employee record with the new employee record.

    Certain HR-related actions can result in orphaned user data by causing the value in the uid field in the LDAP directory to change. Tivoli Directory Integrator uses the uid field to synchronize data so any action that changes the value of the field will cause the user to appear as a completely new user to the Tivoli Directory Integrator scripts. Examples of HR actions that can have this effect include moving users from part-time to full-time or from one country to another country.

    To strengthen your Tivoli Directory Integrator solution, define and use a custom assembly line that specifies the delete logic to use to identify when a user needs to be deleted from the Profiles database.

    1. Configure your development environment for creating a delete logic script by following the steps in the topic, Setting up your development environment.

    2. Define an assembly line that contains your delete logic in the file. Your assembly line must return one of the following values:

      • remove. Specifies that the current entry should be added to the delete list.
      • updated. Specifies that the current entry should be updated, not deleted.
      These values are case-sensitive.

      Return the value as follows:

      1. Retrieve the checkResult attribute field from the work object into your assembly line. The attribute name is case-sensitive.

      2. Set your checking result to the value of the checkResult attribute.

      For example:

        checkingResult = work.getAttribute("checkResult");
        checkingResult.setValue("updated");

      For more information about how to create an assembly line, see the Create your first assembly line topic in the TDI product documentation.

    3. Use the publish feature to export the assembly line as a Tivoli Directory Integrator adapter.

      1. Right-click the assembly line in the Navigator and select Publish.

      2. Enter the name of the adapter in the Package ID field.

      3. Specify the following directory in the File Path field, and then click Finish.

        profiles_tdisoln/packages

    4. Add a reference to the profiles property store to your adapter files by running the fixup_tdi_adapters.sh or fixup_tdi_adapters.bat command.

      This reference is required to use the Profiles Tivoli Directory Integrator adapter. Even if you do not believe that your adapter file requires access to the profiles property store, there is no penalty for adding the reference so it is strongly advised that you run this command regardless.

    5. Open profiles_tdi.properties from the following location:

      tdisol.tar|zip/tdisol/TDI

    6. Set the following properties in the file:

        sync_updates_double_check
        Specifies whether your checking assembly line is used. When set to true, your deletion-checking assembly line is used. When set to false, the checking operation is not performed. The default value is false.

        For example:

          sync_updates_double_check=true

        sync_check_if_remove
        Specifies the name of your checking assembly line:

          sync_check_if_remove=name_of_your_adapter_xml_file:/AssemblyLines/name_of_your_assemblyline

        By default, the assembly line's name is set to sync_all_dns_check_if_remove.

        For example, if you publish the assembly line with the file name deleteCheckRoutines and the assembly line is example_check_if_user_really_deleted, use the following statement to set this property:

          sync_check_if_remove=deleteCheckRoutines:/AssemblyLines/example_check_if_user_really_deleted

        sync_delete_or_inactivate
        Controls what happens to a user record when the delete action is performed. This property can be set to one of the following values:

        • delete. Specifies that the user record is deleted.
        • inactivate. Specifies that the user record is inactivated.

          The inactive status is propagated to the member and login tables for all the applications. An event is generated for each of the following: Activities, Blogs, Bookmarks, Communities, Files, Forums, Profiles, Wikis, and News (which includes both Home page and Search). These events inactivate the user in every application by removing the user from the login tables and setting the user's status to 1 in all member tables.

        These values are case-sensitive so type them with care. The default value is inactivate.

        For example:

          sync_delete_or_inactivate=inactivate

    7. Save your changes to profiles_tdi.properties.


    Use the LDAP directory as the user directory

    Edit configuration property settings to disable Connections directory service extensions.

    Be sure that you have configured the LDAP directory properly before you configure it to be the user directory.

    See Setting up federated repositories for more details.

    Connections directory service extensions are protocols that propagate Profiles data between the applications. When the directory service extension is enabled, you can use the Profiles database to store user information instead of having to access the LDAP directory for each request. If you install the Profiles application, the Profiles database is set up to be the user directory for Connections by default. If you decide to use the LDAP directory as the user directory instead, you can disable the Profiles directory service extension.

    When you disable the Profiles directory service extension, LDAP services handle authentication, group membership search, and all user profiles queries except browser based searches requested within the Profiles application.

    1. Start the wsadmin client

        cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you try to run will not execute properly.

    2. Use the wsadmin client to access and check out the Connections configuration files.

      1. Access the Connections configuration file: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out Connections configuration files:

        LCConfigService.checkOutConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

        • When you specify a path to the working directory on a system that is running Microsoft Windows, use a forward slash for the directory.

          For example: "C:/temp".

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

        • cell_name is the name of the WAS cell that hosts the Connections application. To get cell name: print AdminControl.getCell()

          This input parameter is case-sensitive.

    3. Use the following command to disable the Profiles directory service extension

        LCConfigService.updateConfig("profiles.directory.service.extension.enabled","false")

    4. After making changes, check the configuration files back in and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying common configuration property changes for information about how to save and apply your changes.


    Use the Profiles database as the user directory

    Edit configuration property settings to enable Connections directory service extensions.

    You only need to perform this task if you did not install the Profiles application initially and now want to install Profiles and set its database as the user directory for Connections.

    Connections directory service extensions are protocols that propagate Profiles data between the applications. When the directory service extension is enabled, you can use the Profiles database to store user information instead of having to access the LDAP directory for each request. If you install the Profiles application, the Profiles database is set up to be the user directory for Connections by default.

    When you set the Profiles database to be the user directory, only authentication and group membership search requests are sent to LDAP; the Profiles directory handles all user profile search requests

    1. Start the wsadmin client

        cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you try to run will not execute properly.

    2. Use the wsadmin client to access and check out the Connections configuration files.

      1. Access the Connections configuration file: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out Connections configuration files:

        LCConfigService.checkOutConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

        • When you specify a path to the working directory on a system that is running Microsoft Windows, use a forward slash for the directory.

          For example: "C:/temp".

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

        • cell_name is the name of the WAS cell that hosts the Connections application. To get cell name: print AdminControl.getCell()

          This input parameter is case-sensitive.

    3. Use the following command to enable the Profiles directory service extension

        LCConfigService.updateConfig("profiles.directory.service.extension.enabled","true")

    4. After making changes, check the configuration files back in and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying common configuration property changes for information about how to save and apply your changes.

    Enable single sign-on between all the applications.

    For more information, see the Enabling single sign-on between all applications topic.


    Groups

    Content owners can use LDAP groups to control access to resources in the Communities, Activities, Files, and Wikis applications. For this reason, it is important to consider the effect that updating LDAP groups will have on the existing membership of these resources.

    For example, if a user is given access to content in Connections through group membership and is then removed from that group, they might still receive email notifications and activity stream updates relating to that content until they log into the relevant application that contains the content. When the user logs in, access controls are updated to reflect current group membership and any following subscriptions to content that is no longer accessible are removed.

    For more information about how group access works in different applications, refer to the help for the Communities, Activities, Files, and Wikis applications.


    Customize the deployment

    Perform optional tasks to customize your Connections deployment.


    Hiding email addresses

    Configure Connections to prevent email addresses from being displayed in the product to protect the privacy of users.

    Test notifications to ensure that your mail servers are set up correctly. Edit notification-config.xml to define a valid email address for the global administrator and alternative addresses for the different types of notifications that are sent by each application.

    For more information, see Defining valid administrator email address.

    Do not configure Connections to hide email addresses if you are using any of the Connections extensions. Extensions such as the Connections Plug-in for Notes or Connections Plug-in for Sametime, require addresses to be exposed because they rely on email addresses to identify users.

    For more information, see the Extending section of the product documentation for a list of available Connections extensions.

    When you prevent emails from displaying, email addresses are hidden in the following places:

    • Members fields. When you begin to type a name into a name field, a list of options is displayed. By default, this list is composed of email addresses. If you configure Connections to hide email addresses, the list is composed of display names instead.
    • URLs. Email addresses are often sent as parameters in URLs. This setting prevents the email address from being used in URLs. A customer ID is used instead.
    • Notifications. Connections sends email notifications in response to various user actions.

      For example, when you add members to an activity, they receive email notifications rthat inform them about the activity. Other notifications are generated automatically by the server.

      For example, automatic notifications are sent to activity owners to warn them that an activity will be marked complete because of lack of use. When you indicate that you do not want to expose email addresses, notifications appear to originate from the administrator email address. In addition, the email addresses of the recipients are added to the BCC field of the notification.

    • Profiles business card. The email address that usually is displayed in business cards is not displayed nor.
    Note to programmers: If you configure Connections to keep email addresses private, you cannot use the email parameter to represent a person in GET requests for Atom feeds. Instead, you must use the userid parameter.

    To hide email addresses:

    1. Open a command prompt and then change to the following directory on WAS that hosts Connections:

      • AIX or Linux:/opt/IBM/Connections/ConfigEngine

      • IBM i: /QIBM/ProdData/IBM/Connections/ConfigEngine

        Windows:C:\IBM\Connections\ConfigEngine

    2. Run the script that configures Connections to hide email addresses:

      • AIX or Linux: ./ConfigEngine.sh action-hide-email > /tmp/hide_email.log 2>&1

      • IBM i: ConfigEngine.sh action-hide-email > /tmp/hide_email.log 2>&1
      • Windows: ConfigEngine.bat action-hide-email > D:/hide_email.log 2>&1

      For example, on the Windows operating system:ConfigEngine.bat action-hide-email > D:/hide_email.log 2>&1

    3. Remove email address references from user profiles.

      For more information, see Configure advanced search.

    4. Restart the server.


    Exposing email addresses

    Allow email addresses to be displayed in Connections.

    Complete this task only if you configured Connections to prevent email addresses from being displayed.

    For more information, see Hiding email addresses.

    If you configured Connections to prevent email addresses from being displayed but now you want to allow email addresses to be displayed, complete this task.

    1. cd following directory on WAS that hostsConnections:

      • AIX or Linux: /opt/IBM/Connections/ConfigEngine

      • IBM i: /QIBM/ProdData/IBM/Connections/ConfigEngine

        Windows: C:\IBM\Connections\ConfigEngine

    2. Enter the following command to run the script that configures Connections to display email addresses on each WebSphere Application Server profile to which you installed an application:

      • AIX or Linux:./ConfigEngine.sh action-expose-email > /tmp/expose_email.log 2>&1

      • IBM i:ConfigEngine.sh action-expose-email > /tmp/expose_email.log 2>&1

        Windows:ConfigEngine.bat action-expose-email > D:/expose_email.log 2>&1

      For example, on Windows:

      ConfigEngine.bat action-expose-email > D:/expose_email.log 2>&1

    3. Add the email address references that were removed from user profiles. Follow the steps in the topic Configuring advanced search.

    4. Restart the servers.


    Enable users to set a language preference

    By default, the Connections user interface (UI) is displayed in the language identified in the locale settings of the web browser being used. You can set it up to allow users to explicitly select the language in which the product is displayed.

    Before you begin this procedure, determine which subset of supported languages you want to support. For a full list of the languages that are supported by Connections, see Supported languages.

    After performing this procedure, users can select a language from the language selector in the product's menu bar.

    You can also use this configuration to force the user interface to be displayed in only a single language.

    For example, to display the user interface in French only, you can use the following settings: enabled=true, defaultLanguage=fr, and make sure that no language elements are defined.

    To enable users to set their language preference:

    1. Start the wsadmin client

        cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you try to run will not execute properly.

    2. Use the wsadmin client to access and check out the Connections configuration files.

      1. Access the Connections configuration file: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out Connections configuration files:

        LCConfigService.checkOutConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

          When you specify a path to the working directory on a system that is running Microsoft Windows, use a forward slash for the directory.

          For example: "C:/temp".

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

      3. cell_name is the name of the WAS cell that hosts the Connections application. To get cell name: print AdminControl.getCell()

        This input parameter is case-sensitive.

    3. Navigate to the working directory specified in the previous step and open LotusConnections-config.xml in a text editor.

    4. Find the <languageSelector> element, and then make the following changes:

      1. Change the value of the enabled attribute from false to true.

      2. By default, the defaultLanguage attribute is blank and the product user interface is displayed in the language specified as the preferred language by each user's web browser. You can use the defaultLanguage attribute to define a fallback language in which to display the user interface if the preferred language is not one that is supported by Connections. The language specified here is displayed in the language selector in the product's navigation bar. Language using the exact strings listed in the following example.

        Use the language code iw to specify Hebrew.

      3. The default cookie name is lcLang. To change it, specify a name in the cookieName attribute.

      4. No cookie domain is used by default, but you can specify a domain by adding the domain name of your deployment as the value of the cookieDomain attribute. The domain name must be a valid, fully qualified domain name of the server where the cookie resides.

        For example: .acme.com. Note that the domain name begins with a period (.). When you provide this value for the cookie domain property, you enable the language setting to work across multiple servers, such as both profiles.acme.com and activities.acme.com.

      5. By default, the cookie persists for the duration of the web browser session. To create a persistent cookie that has an expiry date of ten years from the date it was created, set the usePermanentCookie to true.

      6. Within the <languageSelector> element, add one <language> element for each language that you want users to be able to select from the language selector list in the product menu bar. Include a lang attribute that specifies the ISO country code associated with the language. Provide the language name as it should be displayed in the list as the value of the language element. Specify non-Latin characters in JavaScript-escaped unicode format. You can only specify languages that the product supports. For a list of languages, see Supported languages.

        Also, remove any of the language elements that are included in the languageSelector element by default if you do not want them to be displayed from the drop-down list of language options in the product menu bar. They are English, French, Chinese, and Arabic.

        For example: 

        
<languageSelector   enabled="true"   defaultLanguage=""   cookieName="conxnsCookie"
 cookieDomain=".acme.com"   usePermanentCookie="true">
  <language lang="en">English</language>
  <language lang="zh">\u4e2d\u6587\uff08\u7b80\u4f53\uff09</language>
  <language lang="zh_tw">\u4e2d\u6587 (\u7e41\u9ad4)</language>
  <language lang="ja">\u65e5\u672c\u8a9e</language>
  <language lang="ko">\ud55c\uad6d\uc5b4</language>
  <language lang="fr">Fran\u00e7ais</language>
  <language lang="de">Deutsch</language>
  <language lang="it">Italiano</language>
  <language lang="es">Espa\u00f1ol</language>
  <language lang="pt_br">Portugu\u00eas (Brasil)</language>
  <language lang="cs">\u010ce\u0161tina</language>
  <language lang="da">Dansk</language>
  <language lang="nl">Nederlands</language>
  <language lang="fi">suomi</language>
  <language lang="el">\u0395\u03bb\u03bb\u03b7\u03bd\u03b9\u03ba\u03ac</language>
  <language lang="hu">Magyar</language>
  <language lang="no">Norsk (Bokm\u00e5l)</language>
  <language lang="pl">polski</language>
  <language lang="pt">Portugu\u00eas (Portugal)</language>
  <language lang="ru">\u0420\u0443\u0441\u0441\u043a\u0438\u0439</language>
  <language lang="sl">slovenščina</language>
  <language lang="sv">Svenska</language>
  <language lang="tr">T\u00fcrk\u00e7e</language>
  <language lang="iw">\u05e2\u05d1\u05e8\u05d9\u05ea</language>
  <language lang="ar">\u200f\u0627\u0644\u0639\u0631\u0628\u064a\u0629\u200f</language>
  <language lang="ca">Catal\u00e0</language>
  <language lang="kk">\u049a\u0430\u0437\u0430\u049b\u0448\u0430</language>
  <language lang="th">\u0e44\u0e17\u0e22</language>



        </languageSelector>
        The following table identifies the languages based on the lang property value:


        Language code values

        Lang property value Language
        ar Arabic
        ca Catalan
        cs Czech
        da Danish
        de German
        en English
        el Greek
        es Spanish
        fi Finnish
        fr French
        hu Hungarian
        it Italian
        iw Hebrew
        ja Japanese
        kk Kazakh
        ko Korean
        nl Dutch
        no Norwegian
        pl Polish
        pt Portuguese
        pt_br Brazilian Portuguese
        ru Russian
        sl Slovenian
        sv Swedish
        th Thai
        tr Turkish
        zh Simplified Chinese
        zh_tw Traditional Chinese

    5. Save your changes to LotusConnections-config.xml.

    6. After making changes, check the configuration files back in and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying common configuration property changes for information about how to save and apply your changes.


    Change application URLs

    Change the context root of URLs that point to Connections applications.

    Change the context roots of the applications before you map the applications to IBM HTTP Server or before you edit the IBM HTTP Server configuration file for any other reason.

    This task is optional.

    The web address for an Connections application contains a default context root value. You can change this context root to conform to corporate policies that limit where server applications can be deployed and how they can be addressed.

    For example, the Blogs application is available from host_server/blogs by default. You can change that base address to host_server/IBMConnectionsBlogs to differentiate it from any other blogging service or to conform to corporate guidelines.

    To change the context root of an application:

    1. Log in to WAS Integration Solutions Console.

    2. Expand Applications > Application Types and then select WebSphere enterprise applications.

    3. Click the name of the server that hosts the application to administer and then click Context Root For Web Modules.

    4. Edit the values in the Context Root column of the table. The paths must begin with a forward slash (/) and must not contain spaces.

      Do not specify a single forward slash (/) as the full context root. That specification prevents applications from retrieving Atom feeds properly. Using the default application context ("/") is not supported.

    5. Click OK and then click OK from the server properties page to save the change.

    6. Start the wsadmin client

        cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you try to run will not execute properly.

    7. Update the Connections configuration file to reflect this context root change. Use the wsadmin client to access and check out the file.

      1. Access the Connections configuration file: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out Connections configuration files:

        LCConfigService.checkOutConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

          When you specify a path to the working directory on a system that is running Microsoft Windows, use a forward slash for the directory.

          For example: "C:/temp".

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

        • cell_name is the name of the WAS cell that hosts the Connections application. To get cell name: print AdminControl.getCell()

          This input parameter is case-sensitive.

    8. Update the value of the href prefix by

      LCConfigService.updateConfig("<web_module_name.href.prefix", "new_context_root_value")

      where:

        web_module_name
        Name of the web module for the application. Each application has one or more web modules. Select from the following options:


        Application web modules

        Application or Service name Web modules
        Activities activities
        Blogs blogs
        Communities communities
        Dogear dogear
        Files files
        Forums forums
        Home page homepage, news
        Metrics metrics
        Mobile mobile
        Moderation moderation
        Profiles personTag, profiles
        Search search
        Wikis wikis

        new_context_root_value
        Value that you defined for the application's web UI context root in Step 4.

      For example, to change the context root of the Profiles applications:

      LCConfigService.updateConfig("profiles.href.prefix","/contacts") LCConfigService.updateConfig("personTag.href.prefix","/contacts")

    9. Save your changes to LotusConnections-config.xml.

    10. Check in the file in in the same wsadmin session in which you checked it out.

      For more information, see Applying common configuration property changes.

    11. (Files and Wikis only) Perform the following steps:

      1. Check out the Files and Wikis configuration files.

        For more information, see Changing configuration property values in the Administering Files and Administering Wikis sections of the product documentation.

      2. Locate the following property: 

        <security>
   <logout href="/files/ibm_security_logout" />
</security>

      3. Change it to the following content: 

        <security>
   <logout href="new_context_root_value>/ibm_security_logout" />
</security>

    12. Update existing links be selecting one of the following options:

      • Update the old links manually.
      • Redirect requests to links:

        Use this option only if the old and new context roots are defined on the same IBM HTTP Server.

        1. Open the httpd.conf file from the following directory:

          AIX: /usr/IBM/HTTPServer/conf
          IBM i: /www/HTTPServer_name/conf

          Linux: /opt/IBM/HTTPServer/conf

          Windows: C:\IBM\HTTPServer\conf

        2. Uncomment the following line or add it if it is not present: LoadModule rewrite_module modules/mod_rewrite.so

        3. Add redirection rules for each application for both HTTP and secure HTTP. The following content is an example of redirection rules added for the Blogs application:

          Listen 0.0.0.0:443 <VirtualHost *:443> RewriteEngine on RewriteRule /blogs/(.*) https://<your_host_server>/LotusConnectionsBlogs/$1 [R,L] ServerName <your_host_server> SSLEnable </VirtualHost> SSLDisable RewriteEngine on RewriteRule /blogs/(.*) http://<your_host_server>/LotusConnectionsBlogs/$1 [R,L]

        4. Save and close the httpd.conf file and then restart the IBM HTTP Server.

    13. Regenerate the plugin-cfg.xml file:

      1. Open WAS admin console and expand...

          Servers | Server Types | Web servers

      2. Select the check box next to the IBM HTTP Server name.

        For example: webserver1.

      3. Click Generate Plug-in.

      4. If necessary, click Propagate Plug-in to copy the plugin-cfg.xml file from the local directory to the remote system.

    14. Restart IBM HTTP Server.

    15. Delete the search index. By default, the indexing task runs every 15 minutes and rebuilds the index if you deleted it.

      For more information, see Deleting the index.

    16. Update any non-browser clients to point to the new URL.

      See the client documentation for the required steps.

    17. Run the BlogsAdminService.fixBrokenUrls command to fix the absolute URLs that are used by embedded images and attachments in Blogs.

      For more information, see Replacing URLs in Blogs.

    18. Consider creating a landing page for the old URL that redirects to the new URL.


    Add Sametime awareness though the Sametime client

    If you have an IBM Sametime 8.5.2 client or later and the Profiles application deployed, you can enable Sametime awareness in Connections.

    This is an optional configuration.

    When you enable Sametime awareness in Connections, a person's online status is indicated by a set of icons and an associated status message that is available from the person's profile and business card. Sametime awareness tells you whether the person is available to chat, busy in a meeting, or away from their computer.

    You must have the following software enabled to be able to add Sametime awareness to Connections:

    • IBM Sametime 8.5.2 or later stand-alone client.

      Alternatively, you can use Sametime embedded in Notes if the Notes client version is Notes 8.5 or later.

    • When using Sametime 8.5 or later the following limitations apply:

      • Users defined in the Sametime directory must have the same email address as the users defined in the Profiles directory.

    • The Profiles application of Connections must be deployed.

    SSL support: If you have configured the product to send traffic over SSL, Sametime awareness can be retrieved over SSL for the following Sametime clients:

    • IBM Sametime 8.5 or later standalone client
    • Notes 8.5.1 or later embedded client

    For more information about enabling SSL for Sametime, refer to the documentation provided with the Sametime SDK, which is available from the following web site: http://www.ibm.com/developerworks/lotus/downloads/toolkits.html

    After downloading the toolkit, the ConnectWebApiDevguide.pdf documentation can be found in the sdk/client/connectWebApi/doc directory.

    1. Start the wsadmin client...

        cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you try to run will not execute properly.

    2. Edit the profiles-config.xml file to indicate to enable awareness.

      Start the wsadmin client. Use the following commands to access and check out the Profiles configuration files:

      1. Access the Profiles configuration files:

        execfile("profilesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Profiles configuration files:

        ProfilesConfigService.checkOutConfig("working_directory", "cell_name" where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes (/) to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command does not complete successfully.

        • cell_name is the name of the WAS cell hosting the Profiles application. This argument is required. It is also case-sensitive. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example:

        • AIX or Linux:

            ProfilesConfigService.checkOutConfig("/opt/prof/temp","Cell01")

          Windows:

            ProfilesConfigService.checkOutConfig("c:/prof/temp","Cell01")

        • IBM i

            ProfilesConfigService.checkOutConfig("/temp","Cell01")

    3. From the temporary directory to which you checked out the configuration files, open the profiles-config.xml file in a text editor.

    4. Find the <sametimeAwareness> element, and then set the enabled attribute equal to true, specify web addresses for the href and ssl_href attributes, and specify which input type should be used for identifying the person: an email address or a user ID.

      For example... 

        
<sametimeAwareness enabled="true"   
                   href="http://localhost:59449/stwebapi"    
                   ssl_href="http://localhost:59449/stwebapi"   
                   sametimeInputType="email" />

      If Connections is configured to hide email addresses, define the user ID as the input type by setting the sametimeInputType attribute equal to uid.

      For example: 

      
<sametimeAwareness enabled="true"   
                   href="http://localhost:59449/stwebapi"    
                   ssl_href="http://localhost:59449/stwebapi"   
                   sametimeInputType="uid" />

    5. If you have configured the product to send traffic over SSL, edit the ssl_href attribute to specify the web address with the HTTPS protocol.

      For example... 

        
<sametimeAwareness enabled="true"   
                      href="http://localhost:59449/stwebapi"    
                      ssl_href="https://localhost:59669/stwebapi"   
                      sametimeInputType="email" />
      Do not make this change for releases earlier than Sametime 8.5 or the Notes 8.5.1 embedded client or awareness will stop working properly.

    6. Save and close the profiles-config.xml file.

    7. Check in the changed configuration files using the following wsadmin client command...

        ProfilesConfigService.checkInConfig()

    8. To exit the wsadmin client, type exit at the prompt.

    9. If you are using a Sametime client that is embedded in a version of Notes later than 8.0.2 (IFR1), configure Notes to display awareness information because it is disabled by default.:

      1. Exit the Notes client.

      2. Open the plugin_customization.ini file in a text editor.

        By default, the plugin_customization.ini file is stored in the following directory:

          C:\notes_install_directory\framework\rcp

      3. Search for the com.ibm.collaboration.realtime.webapi/startwebContainer property. If it is set to false, set it equal to true. If you do not find it, add the property using the follow syntax...

          com.ibm.collaboration.realtime.webapi/startwebContainer=true

      4. Save and close the plugin_customization.ini file.

    10. Stop and restart WAS hosting the Profiles application.

    11. Start the stand-alone Sametime client or Notes client in which Sametime is embedded.

      It is not recommended that you run more than one Sametime client on a single machine at one time. If awareness does not seem to be enabled in Connections, make sure you do not have an earlier version of the Sametime client running on your machine. If you do, stop the clients and be sure to restart the Sametime Connect 8.0.1 client or the Sametime client embedded in Notes 8.0.2 (IFR1) or later before restarting any other clients.

    12. Confirm that this procedure worked by accessing one of the Connections applications, and then opening a person's business card. It may take a few seconds for the person's awareness information to display the first time.


    Add Sametime awareness through the Sametime server

    If you have an IBM Sametime Proxy server configured in your enterprise and have the Profiles application deployed, you can enable presence awareness and simple chats in Connections.

    This is an optional configuration.

    You must have the following software enabled to be able to add presence awareness to Connections:

    Complete the following procedures before attempting to enable awareness.

    When you enable presence awareness using the Sametime Proxy server, a person's online status is indicated by a set of icons and an associated status message that is available from the person's profile and business card. Presence awareness tells you whether the person is available to chat, busy in a meeting, or away from their computer. In addition to seeing a person's availability, you can carry on a chat with that person even when no Sametime client is installed.

    SSL support: If you have configured the product to send traffic over SSL, presence awareness can be retrieved over SSL.

    For more information about enabling SSL for Sametime, refer to the documentation provided with the Sametime SDK, which is available from the following web site: http://www.ibm.com/developerworks/lotus/downloads/toolkits.html

    After downloading the toolkit, the documentation can be found at sdk/client/connectWebApi/doc/ConnectWebApiDevguide.pdf.

    1. Start the wsadmin client...

        cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you try to run will not execute properly.

    2. Use the wsadmin client to access and check out the Connections extension configuration files.

      1. Access the Connections configuration file: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out LotusConnections-config.xml...

          LCConfigService.checkOutConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command does not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To get cell name, from wsadmin:print AdminControl.getCell()

        For example:

        • AIX or Linux:LCConfigService.checkOutConfig("/opt/temp","Cell01")

          Windows:LCConfigService.checkOutConfig("c:/temp","Cell01")

        • IBM i:LCConfigService.checkOutConfig("/temp","Cell01")

    3. From the directory you specified as the working directory in the previous step, open LotusConnections-config.xml in a text editor, and then find the sametimeProxy service section: 

      <sloc:serviceReference enabled="false" 
    isConnectClient="false" 
    serviceName="sametimeProxy" 
    ssl_enabled="false">
<sloc:href>
<sloc:hrefPathPrefix/>
<sloc:static href="admin_replace" ssl_href="admin_replace"/>
<sloc:interService href="admin_replace"/>
</sloc:href>
</sloc:serviceReference>

    4. Specify the attributes according to the following example: 

      <sloc:serviceReference enabled="true" 
    isConnectClient="true" serviceName="sametimeProxy" 
    ssl_enabled="true"><sloc:href><sloc:hrefPathPrefix/>
<sloc:static href="http://sametimeProxyServer.enterprise.example.com" 
    ssl_href="https://sametimeProxyServer.enterprise.example.com:9444"/>
<sloc:interService href="https://sametimeProxyServer.enterprise.example.com:9444"/>
</sloc:href>
</sloc:serviceReference>
      Where:

      • sloc:serviceReference enabled="true" displays the Sametime action bar in Connections and connects to Sametime via the specified Sametime Proxy server.
      • ssl_enabled="true" connects to the Sametime proxy server on the secure port.
      • isConnectClient="true" automatically connects to Sametime via the UIM client, rather than the Sametime Proxy server.

    5. If your Connections environment is configured to a reverse proxy but the Sametime server is not, add isExternal attribute to the configuration as shown in following example. This flag is set so that the Sametime proxy server URLs are not overwritten by the dynamic host URLs. 

      
<sloc:serviceReference enabled="true" 
                       isConnectClient="true" 
                       serviceName="sametimeProxy" 
                       ssl_enabled="true"><sloc:href> 
                       <sloc:hrefPathPrefix/> 

                        <sloc:static href="http://sametimeProxyServer.enterprise.example.com" 
                        ssl_href="https://sametimeProxyServer.enterprise.example.com:9444" 
                        isExternal="true"/> 
                         <sloc:interService href="https://sametimeProxyServer.enterprise.example.com:9444"/> 
                         </sloc:href> '
</sloc:serviceReference>

    6. Save and close LotusConnections-config.xml.

    7. To check in the changed configuration files

        LCConfigService.checkInConfig(working_directory,cell_name)

    8. After making updates, deploy the changes

        synchAllNodes()

    9. To exit the wsadmin client, type exit at the prompt.

    10. Stop and restart all of the Connections application servers.

    11. Confirm that this procedure worked by accessing one of the Connections applications, and then opening a person's business card. It may take a few seconds for the person's presence information to display the first time. If you can start a chat with the person, then enabling awareness through the proxy server was successfully completed.


    Disable applications

    You might decide to disable an application temporarily for maintenance or if, for example, you are deploying the product and the application is not yet ready for use.

    Only perform this task when you want to disable an application temporarily. To remove an application from your deployment permanently, perform the steps described in the topic, Removing applications.

  • Do not disable applications that are used by all of the other applications, such as the News or Search applications.

    When you disable or remove an application, all references to that application are removed from the user interface.

    1. Open the Integrated Solutions Console of the IBM WebSphere Application Server that is hosting the application.

    2. Expand Applications > Application Types, and then select WebSphere enterprise applications.

    3. Click the name of the application to disable.

    4. Click Target specific application status.

    5. Select the check box next to the cluster name, and then click Disable Auto Start.

    6. Click Save to save your changes.

    7. Click Apply, and then click OK.

    8. Start the wsadmin client

        cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you try to run will not execute properly.

    9. Remove the link to the application from the navigation bar by editing the Connections configuration file.

      1. Access the Connections configuration file: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out Connections configuration files:

        LCConfigService.checkOutConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

          When you specify a path to the working directory on a system that is running Microsoft Windows, use a forward slash for the directory.

          For example: "C:/temp".

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

        • cell_name is the name of the WAS cell that hosts the Connections application. To get cell name: print AdminControl.getCell()

          This input parameter is case-sensitive.

    10. To see a list of the properties and their current settings

        LCConfigService.showConfig()

    11. Enter the following commands:

        LCConfigService.updateConfig("application_name.enabled", "false")
        LCConfigService.updateConfig("application_name.ssl.enabled", "false")

      where application_name is the name of the application that you are disabling.

    12. After making changes, check the configuration files back in and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying common configuration property changes for information about how to save and apply your changes.

    13. Stop and then restart WAS clusters.


    Disable microblogging

    You can remove microblogging functionality from your deployment by disabling the microblogging service reference in LotusConnections-config.xml. Microblogging is enabled by default in Connections.

    To edit configuration files, you must use the wsadmin client.

    Disable the microblogging service in LotusConnections-config.xml automatically removes all the features provided by the service. The options that enable users to post status updates are removed from the product user interface, and the indexing process associated with the microblogging service is also disabled.

    When you disable microblogging:

    • Users cannot post status updates in Connections

    • Users cannot post messages to other users' profiles or to communities
    • Status updates cannot be searched from the Search user interface

    Existing status updates are not removed from the user interface, and are still visible in the Home page, Profiles, and Communities applications.

    To disable microblogging in your deployment....

    1. Use the wsadmin client to access and check out the Connections configuration files:

      1. Access the Connections configuration file: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out Connections configuration files:

        LCConfigService.checkOutConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

          When you specify a path to the working directory on a system that is running Microsoft Windows, use a forward slash for the directory.

          For example: "C:/temp".

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

      3. cell_name is the name of the WAS cell that hosts the Connections application. To get cell name: print AdminControl.getCell()

        This input parameter is case-sensitive.

    2. To list the current configuration settings and values:

      LCConfigService.showConfig()

    3. To disable microblogging capabilities across Connections...

        LCConfigService.updateConfig("microblogging.enabled","false")

    Check the configuration files back in in the same wsadmin session in which you checked them out.

    For more information, see the Applying common configuration property changes topic.


    Disable the social analytics service

    The social analytics widgets help users to discover how they are connected to other users and content, and suggest network contacts and content that might interest them. The social analytics service is enabled by default.

    To edit configuration files, you must use the wsadmin client.

    Disable the social analytics service automatically removes all the features provided by the service, including the social analytics widgets that are available in Profiles, Communities, and the Home page. The indexing process associated with the social analytics service is also disabled.

    When you disable the social analytics service, the following widgets are removed from the user interface:

    • Do You Know (Profiles)
    • Recommendations (Communities)
    • Recommendations (Home page)
    • Who Connects Us? (Profiles)
    • Things in Common (Profiles)

    You disable the social analytics service using wsadmin to set the sand.enabled and sand.ssl.enabled properties in LotusConnections-config.xml to false.

    For more information about changing common configuration properties, see Changing common configuration property values. 

    <sloc:serviceReference serviceName="sand"          enabled="false"
        ssl_enabled="false">
        <sloc:href>
            <sloc:hrefPathPrefix>/news/common/sand</sloc:hrefPathPrefix>
        <sloc:static href="admin_replace" ssl_href="admin_replace"/>
        </sloc:href>
    </sloc:serviceReference>

    To disable the social analytics service....

    1. Use the wsadmin client to access and check out the Connections configuration files:

      1. Access the Connections configuration file: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out Connections configuration files:

        LCConfigService.checkOutConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

          When you specify a path to the working directory on a system that is running Microsoft Windows, use a forward slash for the directory.

          For example: "C:/temp".

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

        • cell_name is the name of the WAS cell that hosts the Connections application. To get cell name: print AdminControl.getCell()

          This input parameter is case-sensitive.

    2. To list the current configuration settings and values:

      LCConfigService.showConfig()

    3. To disable the social analytic services...

        LCConfigService.updateConfig("sand.enabled","false")
        LCConfigService.updateConfig("sand.ssl.enabled","false")

    Check the configuration files back in in the same wsadmin session in which you checked them out.

    For more information, see the Applying common configuration property changes topic.


    Add or removing sections from the help system's table of contents

    If you installed a subset of the Connections applications, remove the help files associated with the applications that you did not install from the help table of contents. If you add an application, or install Connections Mail, you can add that product's help to the table of contents.

    This procedure is not required.

    The help system enables users to navigate from the help for one application to another application by providing a table of contents that lists each application as a separate section and includes help topics within the section. However, if you choose to install only a subset of the available applications, you must manually remove the other help sections from the help system table of contents after installing the product or users see help for applications to which they do not have access. You can also add help if you add an application.

    1. Start the wsadmin...

        cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you try to run will not execute properly.

    2. Access the Connections configuration files:

        execfile("connectionsConfig.py")

    3. Enter the following command to specify which applications you want to include in the help system's table of contents:

      To add an extra application to the existing help, you still need to list all the applications for which you are already providing help. Only the help files for applications that you list as parameters in the LCConfifigHelp.setHelp command will appear in the table of contents.

        LCConfigHelp.setHelp("temp_directory","application_name","application_name")

      ...where...

      • temp_directory is the name of a temporary directory on your system. The directory you specify can be any directory, but it must exist before you enter the command. When you enter the command, an XML file called helpData.xml is added to this directory and is used by the command.

        AIX, Linux, and IBM i only: The directory must grant write permissions or the command does not complete successfully.

      • application_name is the name of the application whose help section you want to include in the table of contents. List each application name separated by commas. The options are:

        • activities
        • blogs
        • bookmarks
        • communities
        • files
        • forums
        • homepage
        • profiles
        • wikis
        • icmail
        • ibmdocs

      For example, if you installed all the applications except Wikis and Connections Mail, you can run the following command to include all sections but Wikis and Connections Mail in the help system...

        LCConfigHelp.setHelp("c:/temp","activities","blogs","bookmarks","communities","files","forums","homepage","profiles")

    4. To force the table of contents in the help system to reflect the change, stop the help application, and delete the temporary help directory on each node where help runs.

      For example, delete the following directory:

      C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp\node-name\cluster-name\Help.

      This directory is recreated when the application restarts.


    Results

    When a user opens the product help system, the table of contents lists only those sections that you wanted it to include.

    If a help topic links to a topic in a section that you have removed from the help system, the link text continues to be displayed, but returns an error when clicked.


    Administer Activities

    For example, if you have limited disk space, you can specify smaller maximum file upload sizes or decrease the interval of time after which unused activities are marked complete. To gauge how many people are using the product and to what extent, you can collect statistics and retrieve metrics on usage. You can also perform tasks such as synchronizing members IDs between the Activities database and the LDAP server and enabling virus scanning.


    Change Activities configuration property values

    Configuration settings control how and when various Activities operations take place. You can edit the settings to change the ways that activities behave.

    Configure Activities using scripts accessed with the wsadmin client. These scripts use the AdminConfig object available in WebSphere Application Server wsadmin client to interact with the Activities configuration file. Changes to Activities configuration settings require node synchronization and a restart of the Activities server before they take effect.


    Related tasks:

  • Start wsadmin


    Check out the Activities configuration files

    You can edit the Activities configuration files in two ways: using wsadmin or by editing the configuration XML files directly. In both cases, you must first check out the configuration files and later check them back in using the wsadmin client.

    1. Start wsadmin:

        cd WAS_HOME/profiles/Dmgr01/bin
        ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

    2. Access and check out the Activities configuration files.

        execfile("activitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Check out the Activities configuration file:

        ActivitiesConfigService.checkOutConfig("working_directory","cell_name")

      ...where...

      • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

        AIX, IBM i and Linux: The directory must grant write permissions or the command will not run successfully.

      • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

      For example:

      • AIX/Linux:

          ActivitiesConfigService.checkOutConfig("/opt/act/temp","Cell01")

      • IBM i:

          ActivitiesConfigService.checkOutConfig("/act/temp","Cell01")

        Windows:

          ActivitiesConfigService.checkOutConfig("c:/act/temp","Cell01")

  • To find out the current value of a property, you can list the current configuration settings and values...

      ActivitiesConfigService.showConfig()

  • Some properties must be edited using the wsadmin client; others can only be edited by editing the configuration XML file directly.

    To change an Activities configuration setting, do one of the following command:

    • To edit a property using the wsadmin client:

        ActivitiesConfigService.updateConfig("property","value")

      where property is one of the editable Activities configuration properties and value is the new value with which you want to set that property.

      See Activities configuration properties for a complete list of editable properties.

      For example:

        ActivitiesConfigService.updateConfig("activeContentFilter.enabled", "true")

    • To edit the value of a property in a configuration file directly, from the temporary directory to which you checked it out, open the file in a text editor, and then make your changes.

    After making changes, check the configuration files back in and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

    See Applying property changes for details.


    Activities configuration properties

    Edit Activities configuration properties to change the default behavior of the activities that are created by users.


    Filter active content

      activeContentFilter.enabled

      When enabled prevents the addition of active content (JavaScript, for example) in any text input field.

      This property accepts the following String values: true or false.

      Disabling this filter introduces vulnerability to cross-site scripting (XSS) and other types of malicious attacks.

      For more information, see Securing applications from malicious attack.


    Schedule Activities statistics collection

      jobs.30MinStats.enabled
      Specifies whether to run the job that saves statistics for Activities to disk every 30 minutes. This property accepts the following String values: true or false.

      jobs.30MinStats.interval
      Frequency with which to run the scheduled job. This property accepts a chronological expression that is specified as a String.

      jobs.DailyStats.enabled
      Specifies whether to run the job that saves statistics for Activities to disk daily. This property accepts the following String values: true or false.

      jobs.DailyStats.interval
      Frequency with which to run the scheduled job. This property accepts a chronological expression that is specified as a String.

      jobs.DatabaseRuntimeStats.enabled
      Specifies whether to run the job that periodically collects database statistics for Activities. This property accepts the following String values: true or false.

      jobs.DatabaseRuntimeStats.interval
      Frequency with which to run the scheduled job. This property accepts a chronological expression that is specified as a String.


    Complete activities that are not being used

      jobs.AutoComplete.autoCompletionPeriod
      Specifies the time period in days that an activity must be inactive before it is automatically completed. This property accepts a number value that is specified as a String.

      jobs.AutoComplete.enabled
      Specifies whether to run the job that automatically completes inactive activities. This property accepts the following String values: true or false.

      jobs.AutoComplete.interval
      Frequency with which to run the job that automatically completes inactive activities. This property accepts a chronological expression that is specified as a String.*

      jobs.AutoComplete.prenotification
      Specifies whether an activity owner is notified before an inactive activity is automatically completed. This property accepts the following String values: true or false.


    Empty the Activities trash on a schedule

      jobs.TrashAutoPurge.daysRetention
      Specifies how many days to retain deleted data before it is purged. This property accepts a number value that is specified as a String.

      jobs.TrashAutoPurge.enabled
      Specifies whether to run the job that permanently removes content from the Activities trash. This property accepts the following String values: true or false.

      jobs.TrashAutoPurge.interval
      Frequency with which to run the scheduled job. This property accepts a chronological expression that is specified as a String.*


    Customize content stores

      objectStore.id

      This property cannot be modified by the Administrator with the ActivitiesConfigService.updateConfig command. It is configured initially during installation, and its value is displayed with the ActivitiesConfigService.showConfig command.

      This property displays a String value of filesystem, which cannot be changed.

      objectStore.maxConcurrentDownloads

      Specifies the number of threads that are simultaneously dedicated to servicing file download requests in the Activities server.

      This property accepts a number value that is specified as a String.

    The following list identifies the Activities configuration properties that you can edit.


    Purge events log

      jobs.EventLogPurgeJob.enabled
      Specifies if this task runs.

      jobs.EventLogPurgeJob.interval
      Specifies when this task runs.

      jobs.EventLogPurgeJob.maxNumberOfDeletionPerCall
      Specifies the maximum number of entries that are deleted at one time.

      jobs.EventLogPurgeJob.retentionInDays
      Specifies how old an entry must be before it can be deleted.


    Apply property changes in Activities

    After you have edited the Activities configuration properties, check the changed configuration file in, and restart the servers to apply the changes.

    Perform the check in in the same wsadmin session in which you checked out the files.

    1. Check in the changed configuration property keys using the following wsadmin client command...

        ActivitiesConfigService.checkInConfig()

    2. Update the value of the version stamp configuration property in LotusConnections-config.xml to force users' browsers to pick up this change

    3. To exit the wsadmin client, type exit at the prompt.

    4. Stop and restart the server hosting the Activities application.


    Change the save frequency of entries

    Edit configuration property settings to change how frequently work in activity entries is automatically saved.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    As users create or edit entries, their work is automatically saved every 5 minutes, unless you change the interval. If users leave an entry in an unsaved state when they accidentally close their browser, the next time they log in, a notification appears in the My Activities view reminding them that they have an unsaved entry. Autosave is not meant for backing up. This feature is provided to help you recover from unexpected events.

    To change how frequently their work is automatically saved...

    1. Check out the Activities configuration files.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Activities configuration ...

          ActivitiesConfigService.checkOutConfig("working_directory","cell_name")

        ...where...

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, IBM i and Linux: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To determine cell name, run wsadmin command:

            print AdminControl.getCell()

        For example:

        • AIX/Linux:

            ActivitiesConfigService.checkOutConfig("/opt/act/temp","Cell01")

        • IBM i:

            ActivitiesConfigService.checkOutConfig("/act/temp","Cell01")

          Windows:

            ActivitiesConfigService.checkOutConfig("c:/act/temp","Cell01")

    2. From the temporary directory to which you just checked out the oa-config.xml file, open the file in a text editor.

    3. Edit the elements in the file to set how frequently entries are automatically saved. The save interval is in minutes.

        <Autosave interval="5"/>

      Delete this element does not turn off the autosave feature. If you delete the element, entries are saved at the default interval of 5 minutes.

    4. Save and close the oa-config.xml file.

    5. After editing, check the configuration files back in. You must do so in the same wsadmin session in which you checked them out for the changes to take effect. You must also restart the server.

      See Applying property changes for details.

    6. After restarting the Activities server, review WAS SystemOut.log file to ensure that the Activities application was able to initialize with the modified configuration.


    Run Activities administrative commands

    Use administrative commands to perform tasks that manipulate Activities content.

    Administrative commands interact with the Activities application and its resources through scripts. These scripts use the AdminControl object available in WebSphere Application Server wsadmin tool to interact with the Activities server. Each script uses managed Java beans (MBeans) to get and set server administration properties.

    Unlike with configuration properties, when you use these commands to change server administration properties, you do not have to check out any files nor restart the server for the changes to take effect. You do, however, need to understand a bit about how to manipulate Java objects. When you perform server operations using the commands, the activities, member information, and access level information are represented as hash tables. Many of the commands, in fact, return a vector of hash tables that represent Activities resources. Commands you can use to perform tasks, such as deleting, archiving, and restoring activities, all take parameters formatted as vectors of hash tables.

    See Narrowing down results for some tips on how to retrieve a distinct set of activities or other resources that you can then pass to commands that perform server tasks.

    When an administrative command is invoked, a SOAP request is made to the Activities application. The number of seconds that the wsadmin client waits for a response to a SOAP request is specified in the com.ibm.SOAP.requestTimeout property specified in the soap.client.props file in the following directory: {WAS_HOME}\profiles\{PROFILE_NAME}\properties. If an Activities command takes longer to complete than the value of the property...

      com.ibm.SOAP.requestTimeout

    ...an error is displayed on the wsadmin console, and any value returned from the invoked method is lost. The Activities command continues to be processed by the Activities application, but the connection that the Activities application had to the client that invoked it is gone. This detail is important to note because some Activities commands take a long time to run.

    For example, in a system with a large number of Activities, the commands...

      ActivityService.fetchActivities()

    ...can take a long time to complete. You can monitor the status of these operations by scanning the SystemOut.log file for success and failure messages.

    To increase the time interval that passes before a request fails, set com.ibm.SOAP.requestTimeout in soap.client.props. This property is a configuration property, so after editing the property, restart the server for the change to take effect.


    Activities administrative commands

    Use administrative commands to run administrative tasks on the server. The following sections define the administrative commands used when working with Activities. The MemberService and ActivityService commands are described in the first two sections because they are the most commonly used services. The remaining sections describe the remaining services in alphabetic order.


    ActivitiesMemberService

    • The ActivitiesMemberService is the same as the MemberService. MemberService was deprecated in version 2.5.

    • The ActivitiesMemberService.updateMemberExtId(java.lang.String oldId, java.lang.String newId) command was deprecated in version 2.5.

    • The ActivitiesMemberService.syncAllMemberExtIds() and ActivitiesMemberService.updateMember(java.util.Hashtable pb) commands were deprecated in version 3.

      ActivitiesMemberService.fetchCommunitiesByName (java.lang.String name)

      Return a list of communities with names that begin with the specified string. This command returns a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one community.

      Parameters:

        name
        The name of a community. You can provide the first word or words and any communities with names that begin with that word or words is returned.

        For example, "Sales community".

      This command was added in version 2.5.

      ActivitiesMemberService.fetchMemberByEmail(java.lang.String mail)

      Return a member identified by the supplied email address. This command returns a java.util.Hashtable object that describes the member.

      Parameters:

        mail
        A member's email address specified as a String value.

        For example, "paul_smith@example.com".

      ActivitiesMemberService.fetchMemberById(java.lang.String id)

      Return a member identified by the supplied Activities ID. The member can be either an individual user or a group. The returned value is a java.util.Hashtable object that describes the member.

      Parameters:

        id
        The member's unique ID as issued by the Activities application. Specify the ID as a String value.

        For example, "ACF1093191092345B4DB336C9B5BF9000055".

      ActivitiesMemberService.fetchMemberByLogin(java.lang.String name)

      Return a member whose login name is an exact match of the supplied login name. The returned value is a java.util.Hashtable object that describes the member. This command does not return groups.

      Parameters:

        name
        The login name specified as a String value.

        For example, "Paul Smith".

      ActivitiesMemberService.fetchMemberByName(java.lang.String name)

      Return a member whose name is an exact match of the supplied name. This command returns both users and groups. The returned value is a java.util.Hashtable object that describes the member.

      Parameters:

        name
        The member or group name specified as a String value.

        For example, "Paul Smith".

      ActivitiesMemberService.fetchMembers(java.lang.String filter)

      Return a set of members whose names match the string you specify. Each member can be either an individual user or a group. The set is returned as a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one member.

      Parameters:

        filter
        Search query string; indicate a wildcard using an asterisk (*). The string is case insensitive.

      For example, the following command returns any user or group whose name ends with "Smith"...

        ActivitiesMemberService.fetchMembers("*Smith")

      ActivitiesMemberService.getMemberExtIdByEmail("email")

      See Synchronize user data using administrative commands.

      ActivitiesMemberService.getMemberExtIdByLogin("login")

      See Synchronize user data using administrative commands.

      ActivitiesMemberService.inactivateMemberByEmail("email")

      See Synchronize user data using administrative commands.

      ActivitiesMemberService.inactivateMemberByExtId("externalID")

      See Synchronize user data using administrative commands.

      ActivitiesMemberService.syncAllMembersByExtId({"updateOnEmailLoginMatch": ["true" | "false"] } )

      See Synchronize user data using administrative commands.

      ActivitiesMemberService.syncAllMemberExtIds()

      This command was deprecated in version 3.

      See Synchronize user data using administrative commands for information about the new and updated synchronization commands you can use instead.

      ActivitiesMemberService.syncBatchMemberExtIdsByEmail("emailFile" [, {"allowInactivate ["true" | "false"] } ])

      See Synchronize user data using administrative commands.

      ActivitiesMemberService.syncBatchMemberExtIdsByLogin("loginFile" [, {"allowInactivate ["true" | "false"] } ])

      See Synchronize user data using administrative commands.

      ActivitiesMemberService.syncMemberByExtId("currentExternalId" [, { "newExtId "id-string", [ { "allowExtIdSwap ["true" | "false"] ] } ])

      See Synchronize user data using administrative commands.

      ActivitiesMemberService.syncMemberExtIdByEmail("email" [, {"allowInactivate" : ["true" | "false"] } ])

      See Synchronize user data using administrative commands.

      ActivitiesMemberService.syncMemberExtIdByLogin("name" [, {"allowInactivate" : ["true" | "false"] } ])

      See Synchronize user data using administrative commands.


    ActivityService

      ActivityService.deleteActivities (java.util.Vector activities)

      Moves the specified activities to the Trash view. Activities in the Trash view can be restored as long as they are restored before the trash is emptied. Return a java.util.Vector; each object in the vector is a java.util.Hashtable that describes one activity that could not be deleted. A returned empty vector indicates complete success.

      Parameters:

        activities
        Vector of hash tables describing the activities to be deleted.

        For example, joesactivities.

      ActivityService.exportSyncedResourceInfo (filePath,eventType)

      Writes a report that lists all of the community activities and identifies their associated communities. The file is saved to the directory path that you specify.

      Parameters:

        filePath
        Full directory path in which to store the file that is returned by the command. Include the file name in the file path and use forward slashes.

        For example: "C:/temp/activity_output.xml"

        eventType
        Type of synchronization events to report about. The only supported value for this parameter is community. Specify this value as a singular community and in lower case.

      For example: ActivityService.exportSyncedResourceInfo("C:/temp/activity_output.xml","community")

      You can use this command to restore backed up data.

      See Comparing remote application data with the Communities database for more details.

      ActivityService.fetchActivities()

      List all the activities, except those that are in the Trash view.

      Return a java.util.Vector object. Each object in the vector is a java.util.Hashtable object that describes one activity.

      ActivityService.fetchActivitiesByCommunityExId (java.lang.String communityUUID)

      Gets a list of the community activities associated with a specific community. Return a java.util.Vector; each object in the vector is a java.util.Hashtable that describes a community activity.

      Parameters:

        communityUUID
        The unique ID of the community.

        For example, "f29b4e8e-6fad-44f4-9fca-58c46f29c38d".

        To find out the unique ID of a community, use ActivitiesMemberService.fetchCommunitiesByName to retrieve the community of interest, and then get the value of the externalId key of that community from the hashtable.

      This command was added in version 2.5.

      ActivityService.fetchActivitiesByDate(java.lang.String dateType, java.lang.String beginTime, java.lang.String endTime, java.lang.String lastUUID)

      List activities created or modified between a date range. The maximum number of activities in the returned list is 50. To obtain all of the activities that match the criteria if the number is greater than 50, call this method in a loop providing the UUID of the 50th activity from the previous list as the lastUUID parameter. Return a java.util.Vector object. Each object in the vector is a java.util.Hashtable object that describes one activity.

      Parameters:

        dateType
        Date field of interest. Options are created and modified.

        beginTime
        Start timestamp of the range, using a yyyy.mm.dd format.

        endTime
        Finish timestamp of the range, using a yyyy.mm.dd format.

        lastUUID
        Unique ID of the last activity retrieved from a previous call of this command. Specify empty double quotes if you expect less than 50 activities in the response, or if you are running this command for the first time.

      For example, the following command gets the first set of 50 activities created from 1 Mach 2008 through 31 March 2008:

        ActivityService.fetchActivitiesByDate("created","2008.03.01","2008.03.31","")

      This command does not return activity templates created during the specified date range. This command does include in the activities that it returns any activities present in the Trash view created during the specified date range.

      ActivityService.fetchActivityById(java.lang.String activityId)

      Get the activity identified by the given universal identifier. Return a java.util.Hashtable object that describes the activity.

      Parameters:

        activityId
        Unique identifier of the activity.

        For example, "3F9G09219392F4733F40F82A4E8D5F000083".

      ActivityService.fetchActivitiesByMember(java.util.Hashtable member)

      List activities to which the specified member has access, except those that are in the Trash view. This command does not return community activities. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one activity. It does not provide any results if the specified member is a group or a community.

      Parameters:

        member
        java.util.Hashtable object representing the member returned from the MemberService object.

        For example, jane.

      ActivityService.fetchActivitiesByOwner(java.util.Hashtable member)

      List activities owned by the specified member, except those that are in the Trash view. This command does not return community activities either. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one activity.

      Parameters:

        member
        java.util.Hashtable object representing the owner returned from the MemberService object.

        For example, paul_smith.

      ActivityService.fetchActivitiesCreatedByMember(java.util.Hashtable member)

      List activities created by the specified member, except those that are in the Trash view. This command does not return community activities. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one activity.

      Parameters:

        member
        java.util.Hashtable object representing the member returned from the MemberService object.

        For example, paul_smith.

      ActivityService.fetchCompletedActivities()

      List all completed activities in the service, which are activities that have been marked complete and are displayed in the Completed view. Completed activities are not included in the Trash view; it is not until a completed activity is deleted that it is moved to the Trash view.

      Return a java.util.Vector object. Each object in the vector is a java.util.Hashtable object that describes one activity.

      ActivityService.fetchDeletedActivities()

      List all deleted activities in the service. These are activities that are currently in the Trash view.

      Returns a java.util.Vector object. Each object in the vector is a java.util.Hashtable object that describes one activity.


    AccessControlService

    You cannot use the AccessControlService commands to fetch, set, or delete access to community activities.

    See Communities administrative commands for information about the command you can use to add a person to a community.

      AccessControlService.deleteAccess(java.util.Vector activities, java.util.Vector members)

      Removes access privileges to the specified activities for the specified members. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one activity whose access could not be deleted. A returned empty vector indicates success.

      Parameters:

        activities
        Vector of hash tables representing the activities whose access will be modified.

        For example, joesactivities.

        members
        Vector of hash tables representing the members returned from the MemberService object.

      AccessControlService.fetchAccess(java.util.Hashtable activity)

      List all of the members that have access to the specified activity. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one entry, either a user or group, in the access list. The elements returned in the Hashable are:

      • displayName
      • email: Returns for members only, not groups.
      • externalId
      • loginNames: Returns for members only, not groups.
      • memberId
      • memberType
      • role
      • staticProfile

      Parameters:

        activity
        Hash table representing the activity.
      The following code is an example of what is returned by this command:

      [{memberId=675G09219107D9BB025252223E2BC9000001, displayName=Amy Jones, loginNames=[Amy Jones, ajones@acme.com], staticProfile=false, externalId=3AB586F4-A4D2-43C8-92DB-2DC3B2291803, email=ajones@acme.com, memberType=person, role=owner}, {memberId=D76G0921910768409A3F871F14596C000088, displayName=Amy Jacobs, loginNames=[Amy Jacobs, ajacobs@acme.com], staticProfile=false, externalId=DE1D832B-1024-43B1-A12C-F1B643C2B6A2, email=ajacobs@acme.com, memberType=person, role=reader}, {memberId=812G09219107D9BB025252223E2BC900000A, displayName=ajonesgroup, staticProfile=false, externalId=41565591-1A33-4F9B-88D9-335D96BFB3B2, memberType=group, role=reader}]

      AccessControlService.setMembersAccess(java.util.Vector activities, java.util.Vector members)

      Set the specified members as members with author access to the specified activities. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one activity whose access could not be modified. A returned empty vector indicates success.

      Parameters:

        activities
        Vector of hash tables representing the activities whose access will be modified.

        members
        Vector of hash tables representing the members returned from the MemberService object.

      In 2.5, this command named changed from setMemberAccess to setMembersAccess.

      AccessControlService.setOwnerAccess(java.util.Vector activities, java.util.Hashtable owner)

      Set the specified member as an owner of the specified activities. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one activity whose access could not be modified. A returned empty vector indicates success.

      Parameters:

        activities
        Vector of hash tables representing the activities whose access will be modified.

        owner
        Hash table representing the member returned from the MemberService object.

      AccessControlService.setOwnersAccess(java.util.Vector activities, java.util.Vector owners)

      Set the specified members as owners of the specified activities. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one activity whose access could not be modified. A returned empty vector indicates success.

      Parameters:

        activities
        Vector of hash tables representing the activities whose access will be modified.

        owners
        Vector of hash tables representing the members to whom you want to give owner access.

      This command was added in version 2.5.

      AccessControlService.setReadersAccess(java.util.Vector activities, java.util.Vector members)

      Set the specified members as readers of the specified activities. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one activity whose access could not be modified. A returned empty vector indicates success.

      Parameters:

        activities
        Vector of hash tables representing the activities whose access will be modified.

        members
        Vector of hash tables representing the members returned from the MemberService object.

      In 2.5, this command named changed from setReaderAccess to setReadersAccess.

      AccessControlService.syncAllCommunityShares()
      Update the Activities data store to reflect changes made to the name or access level of a community. If the community no longer exists, the membership of the activity is updated to remove the community.

      This command was added in version 3.


    ActivitiesConfigService

      ActivitiesConfigService.checkOutConfig("working_directory", "cell_name")

      Checks Activities configuration files out to a temporary directory.

        working_directory
        Temporary working directory to which the configuration files are copied. The files are kept in this working directory while you make changes to them. When you specify a path to the working directory on a system running Microsoft Windows, use a forward slash for the directory.

        For example: "C:/temp".

        AIX, IBM i, and Linux: The working directory must grant write permissions or the command will not run successfully.

        cell_name
        Name of the WAS cell hosting the Lotus Connections application. To get cell name, from wsadmin...

          print AdminControl.getCell()

      For example:

      • AIX/Linux:

          ActivitiesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

      • IBM i:

          ActivitiesConfigService.checkOutConfig("/temp","Cell01")

      • Windows:

          ActivitiesConfigService.checkOutConfig("c:/temp","Cell01")

      ActivitiesConfigService.showConfig()
      Display the current configuration settings. Check out the configuration files with ActivitiesConfigService.checkOutConfig before running ActivitiesConfigService.showConfig.

      ActivitiesConfigService.updateConfig("property_name", "new_value")
      Updates configuration properties.

        property_name

        See Activities configuration properties for configuration properties and descriptions.

        new_value
        The new value for the property. Acceptable values for properties can be restricted, for example to either true or false.

        See Activities configuration properties for configuration properties and descriptions.

      ActivitiesConfigService.checkInConfig()

      Checks in Activities configuration files. Run from the wsadmin command processor.


    ActivitiesScheduler

      ActivitiesScheduler.getTaskDetails(java.lang.String taskName)

      Get the list attributes of the named task. Return a java.util.Hashtable object that contains the attributes.

      Parameters:

        taskName
        Name of the task specified as a String value.

        For example:

        • "30MinStats"
        • "ActivityAutoCompleteJob"
        • "DailyStats"
        • "DatabaseRuntimeStats"
        • "TrashAutoPurgeJob"
        • "EventLogPurgeJob"

      ActivitiesScheduler.pauseSchedulingTask(java.lang.String taskName)

      Suspends scheduling of a task. Has no effect on currently running tasks. Return a 1 to indicate that the task has been paused. Paused tasks remain paused until you explicitly resume them, even if the server is stopped and restarted.

      Parameters:

        taskName
        Name of the task specified as a String value.

        For example:

        • "30MinStats"
        • "ActivityAutoCompleteJob"
        • "DailyStats"
        • "DatabaseRuntimeStats"
        • "TrashAutoPurgeJob"
        • "EventLogPurgeJob"

      ActivitiesScheduler.resumeSchedulingTask(java.lang.String taskName)

      Resumes the start of a paused task. Return a 1 to indicate that the task has been resumed.

      Parameters:

        taskName
        Name of the task specified as a String value.

        For example:

        • "30MinStats"
        • "ActivityAutoCompleteJob"
        • "DailyStats"
        • "DatabaseRuntimeStats"
        • "TrashAutoPurgeJob"
        • "EventLogPurgeJob"


    ArchiveService

      ArchiveService.createActivities(java.lang.String directory, java.util.Vector activities)

      Creates new activities from the previously exported activities specified by the vector. If an activity being imported with this command already exists, a second activity is created. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one activity that could not be created. A returned empty Vector indicates success.

      Parameters:

        directory
        Directory on the file system from which to import the activities.

        For example, "C:/AllExports".

        activities
        Vector of hash tables; each hash table describes an Activity to be created.

        For example, allexports.

      ArchiveService.deleteActivities(java.lang.String directory, java.util.Vector activities)

      Delete the previously exported activities specified by the vector from the specified directory. Use this command to delete activities from the archive repository, not from the Activities server or database. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one activity that could not be deleted. A returned empty vector indicates success.

      Parameters:

        directory
        Archive directory on the file system from which to delete the activities.

        For example, "C:/AllExports".

        activities
        Vector of hash tables; each hash table describes an activity to be deleted.

        For example, janesactivities.

      ArchiveService.exportActivities(java.lang.String directory, java.util.Vector activities)

      Export the activities specified by the Vector into the specified directory; this method will overwrite an activity if it already exists in the specified directory. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one activity that could not be exported. A returned empty Vector indicates success.

      Parameters:

        directory
        Directory on the file system to which to export the activities.

        For example, "C:/temp/zips".

        activities
        Vector of hash tables; each hash table describes an activity to be exported.

        For example, activities.

      ArchiveService.fetchActivities(java.lang.String directory)

      List all archived activities in the specified directory. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object describing an archived activity in the directory.

      Parameters:

        directory
        Directory on the file system that contains the archived activities.

        For example, "C:/AllExports".

      ArchiveService.fetchActivitiesByMember(java.lang.String directory , java.util.Hashtable member)

      List all archived activities in the specified directory to which the specified member has access. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object describing an archived activity in the directory. This command does not return community activities.

      Parameters:

        directory
        Directory on the file system that contains the archived activities.

        For example, "C:/AllExports".

        member
        Hash table representing the members returned from the MemberService object.

        For example, paul_smith.

      Do not use this command to fetch activities that were exported from a different deployment of Connections. This commands uses the member ID to find the activities, and member IDs are not persisted across different deployments. Only use this command to collect activities when you are importing the activities to the same server from which they were exported. If you are importing the activities to a different server, use the ArchiveService.fetchActivities(directory) command instead.

      ArchiveService.fetchActivitiesByOwner(java.lang.String directory , java.util.Hashtable member)

      List all archived activities in the specified directory owned by the specified member. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable objects describing an archived activity in the directory. This command does not return community activities.

      Parameters:

        directory
        Directory on the file system that contains the archived activities.

        For example, "C:/AllExports".

        member
        Hash table representing the owners of archived activities returned from the MemberService object.

        For example, paul_smith.

      Do not use this command to fetch activities that were exported from a different deployment of Connections. This commands uses the member ID to find the activities, and member IDs are not persisted across different deployments. Only use this command to collect activities when you are importing the activities to the same server from which they were exported. If you are importing the activities to a different server, use the ArchiveService.fetchActivities(directory) command instead.

      ArchiveService.fetchActivitiesCreatedByMember(java.lang.String directory, java.util.Hashtable member)

      List all archived activities in the specified directory created by the specified member. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object describing an archived activity in the directory. This command does not return community activities.

      Parameters:

        directory
        Directory on the file system that contains the archived activities.

        For example, "C:/AllExports".

        member
        Hash table representing the member who created the archived activities returned from the MemberService object.

        For example, jane.

      Do not use this command to fetch activities that were exported from a different deployment of Connections. This commands uses the member ID to find the activities, and member IDs are not persisted across different deployments. Only use this command to collect activities when you are importing the activities to the same server from which they were exported. If you are importing the activities to a different server, use the ArchiveService.fetchActivities(directory) command instead.

      ArchiveService.importActivities(java.lang.String directory, java.util.Vector activities)

      Import the activities specified by the Vector whose archives are located in the specified directory into the Activities application. This method overwrites an activity if it already exists. Return a java.util.Vector object; each object in the vector is a java.util.Hashtable object that describes one activity that could not be imported. A returned empty Vector indicates success.

      Parameters:

        directory
        Directory on the file system from which to import the activities.

        For example, "c:/temp/zips".

        activities
        Vector of hash tables; each hash table describes an activity to be imported.

        For example, activitiesToImport.


    ListService

      ListService.filterActivitiesByName(inList, toMatch)

      Filter or narrow down a list of activities matching certain criteria. Useful for locating a subset of activities that can then be used as input for a subsequent command. A typical example is creating a list of activities for export. Return a list of activities whose Title field matches the pattern criteria.

      Parameters:

        inList
        Previously fetched list of activities.

        toMatch
        Java regular expression pattern representing match criteria. This pattern is used to search the title of the activity. The pattern must match the full name and is case sensitive. You can use the following keys:

        • Period (.) matches any character.
        • Plus sign (+) matches one or more instances of the previous character.

          For example, .+ matches all sequences of one or more characters.

        • Asterisk (*) matches zero or more instances of the previous character.

          For example, * matches all sequences of characters.

        • [chars] matches any one character within the brackets ([]).

          For example, [Gg] matches either an upper or lower case G.

        • [A-Z] matches a range of characters.

      Example... 

        execfile("activitiesAdmin.py")

# Fetch all activities and save 
# to variable named "all"

all=ActivityService.fetchActivities()

# From the list of all activities,
# Extract activities whose name  
# begins with "Sales"

sales=ListService.filterActivitiesByName(all,"Sales.*")

# Activities in "all" that begin  
# with "Sales" are saved in the 
# variable named "sales". The  
# variable "sales" can be used as  
# input for other commands, such  
# as the command to export  
# activities. The following command 
# will export all the activities  
# whose name begins with "Sales" to 
# the /opt/foo folder.

ArchiveService.exportActivities(
 "/opt/foo", "Sales.*")


    StatisticsService

      StatisticsService.fetchStatistic(java.lang.String key)

      Gets a server statistic.

      Return a java.lang.Integer or java.util.Hashtable object containing statistic data defined using the following keys:

        invocations
        Number of times the function has been invoked.

        total
        Total amount of time that is consumed by this operation.

        minimum
        Minimum amount of time that a single invocation lasted.

        maximum
        Maximum amount of time that a single invocation lasted.

        average
        Average amount of time that a single invocation lasted.

      The list of available statistics for your server can be found at: http://yourservername.company.com/activities/service/html/serverstats

      Use any of the statistics listed in this table as input to this command. The statistics listed as Stop Watch Statistics are similar to parent statistics and, when you use one of them as the key, it returns a hash table containing statistics for invocations, total, minimum, maximum, and average.

      Parameters:

        key
        Name of the statistic to be returned specified as a String value.

      StatisticsService.fetchStatistics()

      Gets all system statistics. Return a java.util.Hashtable object with server statistics data.


    TrashCollectionService

      TrashCollectionService.fetchTrash()

      Gets all of the objects that are currently in the Trash view. Return a java.util.Vector object that contains a set of hash tables; each hash table describes an object in the trash.

      TrashCollectionService.purgeTrash(java.util.Vector trashVector)

      Permanently removes the objects in the trashVector parameter from the Activities application. Return a java.util.Vector of java.util.Hashtables object; each hash table describes an object in the trash that could not be purged.

      Parameters:

        trashVector
        A vector of hash tables; each hash table describes an object in the trash to be purged (obtained using the TrashCollectionService.fetchTrash command).

      TrashCollectionService.undeleteTrash(java.util.Vector trashVector)

      Restores previously deleted objects from the Trash view. Returns a java.util.Vector object that contains java.util.Hashtable objectss; each Hashtable describes an object in the trash that could not be restored from the trash.

      Parameters:

        trashVector
        A vector of hash tables; each hash table describes an object in the trash to be restored (obtained using the TrashCollectionService.fetchTrash command).

    Related tasks:

  • Get a list of activities


    Example: Activities administrative session

    The following sample is a typical Activities administrative session. Reference this example to see how various administrative commands are used. 

        EXAMPLE OF USING ACTIVITIES AdmgrINISTRATIVE COMMANDS
# 
     The following example adds two new members to existing activities.
# User manager@company.com will be added to all activities where user  
# employee1@company.com is a member. This user will be added with "owner"
# access to those activities. Next, user employee2@company.com will be 
# added as a member to all activities that employee1@company.com has access 
# to, but with "author" access.

# Create a member object by using their email and assign the value that is returned
# to a variable.

wsadmin>employee1=ActivitiesMemberService.fetchMemberByEmail("employee1@company.com")
wsadmin>employee2=ActivitiesMemberService.fetchMemberByEmail("employee2@company.com")
wsadmin>manager=ActivitiesMemberService.fetchMemberByEmail("manager@company.com")

# Call the ActivityService to fetch all activities that employee1 is a member of.

wsadmin>activities=ActivityService.fetchActivitiesByMember(employee1)

# Call AccessControlService to add 'manager' to all of 'employee1' activities as  
# new owner 
wsadmin>AccessControlService.setOwnerAccess(activities,manager)

# Call the AccessControlService to add 'employee2' to all of 'employee1'  
# activities as a new member (with author access).  Because the 
# AccessControl.setMembersAccess command is expecting the second argument  
# (member to be added) to be a "vector", the first 3 commands convert the value  
# that is stored in the variable "employee2" from a "Hashtable"
# into a "Vector" and stores the new vector in the variable "newMembers".

wsadmin>from java.util import Vector
wsadmin>newMembers=Vector()
wsadmin>newMembers.add(employee2)
wsadmin>AccessControlService.setMembersAccess(activities,newMembers)



# Export all activities of which a person is a member to location "c:/temp/zips".
# Create a member object by using their email and assign it to the variable  
# "member".
wsadmin>member=ActivitiesMemberService.fetchMemberByEmail("employee@company.com")

# Call the ActivityService to fetch all of the standard activities and assign the 
# result to the variable "activities".

wsadmin>activities=ActivityService.fetchActivitiesByMember(member)

# Call export to export their activities to the given directory 
wsadmin>ArchiveService.exportActivities("c:/temp/zips",activities)



# Import all activities from the archives in a directory  
# From a previous export, locate the directory of activity zip files to import,  
# and type:
wsadmin>activitiesToImport=ArchiveService.fetchActivities("c:/temp/zips")

# Call the ArchiveService to import the activities. If they already exist in the 
# system, the activities are overwritten.

wsadmin>ArchiveService.importActivities("c:/temp/zips",activitiesToImport)


# Create new activities from the previously exported archives in a directory 
# From a previous export, locate the directory of activity zip files to import,  
# and type:
wsadmin>activitiesToImport=ArchiveService.fetchActivities("c:/temp/zips")

# Alternatively, if it's preferable not to overwrite existing activities, call
# 'createActivities' instead to create copies. Notice, this command will generate  
# new UUIDs for all the imported activities.

wsadmin>ArchiveService.createActivities("c:/temp/zips",activitiesToImport)


    Get a list of activities

    List the activities that you can manipulate programmatically. You can retrieve a list of all activities or filter the list by viewing activities that are associated with a specific member.

    To run administrative commands, use the wsadmin client and check out the Activities configuration file.

    To check out the configuration file, use execfile("activitiesAdmin.py"). If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file with a local file path, pick the node where the file is stored.

    For more information about using the wsadmin client, see Start wsadmin .

    • Use the following commands to get a list of activities and entries.

        ActivityService.fetchActivities()
        List all of the activities that are created by users except those activities in the trash.

        ActivityService.fetchDeletedActivities()
        List deleted activities. Deleted activities were moved to the Trash view, but are not permanently deleted yet. After the Trash view is purged, these activities are permanently deleted.

        ActivityService.fetchCompletedActivities()
        List activities that are marked Completed.

        ActivityService.fetchActivitiesByDate(java.lang.String dateType, java.lang.String beginTime, java.lang.String endTime, java.lang.String lastUUID)
        List activities created or modified within a specified date range, including those activities in the Trash. This command does not return activity templates created during the specified date range.

        • dateType: Date field of interest. Options are created and modified.
        • beginTime: Start of date range.
        • endTime: End of date range.
        • lastUUID: Unique ID of the last activity that is retrieved from a previous call of this command. Specify empty double quotation marks if you expect less than 50 activities in the response, or if you are running this command for the first time.

        Dates are specified in the yyyy.mm.dd format.

        For example, the following command gets the first set of 50 activities created from 1 March 2008 through 31 March 2008:

          ActivityService.fetchActivitiesByDate("created","2008.03.01","2008.03.31","")

        ActivityService.fetchActivityById(java.lang.String uuid)
        List an activity with a specified universal identifier.

        You can find the universal identifier of an activity by using other fetch commands. The hash table of an activity includes an activityID, such as activityId=3F9G09219392F4733F40F82A4E8D5F000083.

        For example:

          ActivityService.fetchActivityById("3F9G09219392F4733F40F82A4E8D5F000083")

    • Use the following commands to return a list of activities that are filtered by member.

      1. Retrieve member information for the user whose activities you are interested in using MemberService.fetchMemberByName.

          variable=MemberService.fetchMemberByName(java.lang.String member)

        For example:

          jane=MemberService.fetchMemberByName("Jane Fairfax")

      2. Filter the activity list.

          ActivityService.fetchActivitiesCreatedByMember(java.util.Hashtable member)
          List activities that are created by the member.

          For example:

            ActivityService.fetchActivitiesCreatedByMember(jane)

          ActivityService.fetchActivitiesByMember(java.util.Hashtable member)
          List activities to which the member has access.

          ActivityService.fetchActivitiesByOwner(java.util.Hashtable member)
          List activities which the member owns.

      Results from fetchActivitiesByMember() and fetchActivitiesByOwner() do not include community activities.

    For information about how filter the list of results into a smaller subset, see Narrowing down results.


    Related tasks:


    Narrowing down results

    Use standard Java code or the filtering command provided by the ListService object to retrieve a subset of activities or entries on which you would like to perform an operation.

    1. When you use a command to retrieve a set of resources, use a variable to store the returned data.

      For example, the following code stores the objects returned from the fetchTrash() command, which are formatted as a java.util.Vector of hash tables that represent activities and entries in the Trash view, in the alltrash variable...

        alltrash=TrashCollectionService.fetchTrash()

    2. Do one of the following:

      • Use the ListService.filterActivitiesByName() command to narrow down the results that you stored in the alltrash variable.

        For example, the following command finds only those activities in the alltrash variable that have an activity name that begins with "AJ78" and stores them in the myactivity variable:

          myactivities=ListService.filterActivitiesByName(alltrash, "AJ78.*")

      • Use standard Java to parse the returned vector of hash tables and collect a subset of them in the myactivities variable.

    3. Pass the variable containing the subset of resources to operate on into the command.

      For example, to restore the collected subset of activities that are currently in the Trash view, you could use the following command...

        TrashCollectionService.undeleteTrash(myactivities)


    Related

  • Get a list of activities


    Manage activity membership

    Use administrative commands to change member access levels and synchronize member IDs.

    When the name of a group that is used in an activity is renamed in LDAP, the old group name still appears on the Members page of the activity.


    Retrieve member information

    Learn about the administrative commands that display the members of an activity. You can retrieve either a single member or a list of members.

    To run administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    1. Access the Activities configuration file...

        execfile("activitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    2. Use any of the fetch member commands that are part of the ActivitiesMemberService to display activity members.

        ActivitiesMemberService.fetchMembers(java.lang.String name)
        Return a list of members or groups whose names match the search criteria.

        ActivitiesMemberService.fetchMemberByName(java.lang.String name)
        Retrieve information about a member or group by passing in their name.

        ActivitiesMemberService.fetchMemberByLogin(java.lang.String name)
        Retrieve information about a member by passing in their login.

        ActivitiesMemberService.fetchMemberByEmail(java.lang.String mail)
        Retrieve information about a member by passing in their email address.

        ActivitiesMemberService.fetchMemberById(java.lang.String id)
        Retrieve information about a member or group by passing in their unique member ID.


    Example

    Use the following examples of the fetch commands to retrieve member lists.

      ActivitiesMemberService.fetchMembers(java.lang.String name)

      This command returns a vector of hash tables. Each hash table represents a member or group.

      • ActivitiesMemberService.fetchMembers("Jane Fairfax")

        Returns the following vector, which contains a single hash table: 

        [{memberId=FBFG092191072384B4DB336C9B5BF9000043, displayName=Jane Fairfax,  loginNames=[jfairfax@acme.com, Jane Fairfax], 
   staticProfile=false,  externalId=3901C921-E104-40BC-8AAA-C947146C8F68, email=jfairfax@acme.com,  memberType=person}]

      • ActivitiesMemberService.fetchMembers("Acme*")

        This command uses a wildcard character to fetch all members or groups that begin with the word Acme. It returns the following vector, which contains two hash tables: one for Acme Sales and one for Acme Marketing. 

        [{memberId=0BEG7F00000145EAB17F33E66924AA00009D, displayName=Acme Marketing,
 staticProfile=false, externalId=46b4a55a-47ae-4e29-ae8c-03c42d83f1cc,   memberType=group}
{memberId=7DG09218G7F00000145EAB17F33E669007, displayName=Acme Sales,   
    staticProfile=false, externalId=12c4c66a-44aa-4e31-ae44-01c42c83f1ab,   memberType=group}]

      ActivitiesMemberService.fetchMemberByName(java.lang.String name)
      ActivitiesMemberService.fetchMemberByName("Paul Smith")

      This command returns a hash table that contains information for the one member that matched the name that is passed in as a parameter. 

      {memberId=ACF1093191092345B4DB336C9B5BF9000055, displayName=Paul Smith,   
    loginNames=[paul_smith@acme.com, Paul Smith], 
    staticProfile=false,   externalId=12345678-ABCD-44BC-8BBB-C947146C8F12, email=paul_smith@acme.com,
 memberType=person}

      ActivitiesMemberService.fetchMemberByLogin(java.lang.String name)
      ActivitiesMemberService.fetchMemberByLogin("Paul Smith")

      This command returns a that represents Paul Smith. 

      {memberId=FBFG092191072384B4DB336C9B5BF9000043, displayName=Paul Smith,  i
    loginNames=[paul_smith@acme.com, Paul Smith], 
    staticProfile=false,  externalId=3901C921-E104-40BC-8AAA-C947146C8F68,  
    email=paul_smith@acme.com, memberType=person}

      ActivitiesMemberService.fetchMemberByEmail(java.lang.String mail)
      ActivitiesMemberService.fetchMemberByEmail("paul_smith@acme.com")

      This command returns a hash table that contains information for the member that matched the name that is passed in as a parameter. 

      {memberId=ACF1093191092345B4DB336C9B5BF9000055, displayName=Paul Smith,   
    loginNames=[paul_smith@acme.com, Paul Smith], 
    staticProfile=false,   
    externalId=12345678-ABCD-44BC-8BBB-C947146C8F12, 
    email=paul_smith@acme.com,
 memberType=person}

      ActivitiesMemberService.fetchMemberById(java.lang.String id)
      ActivitiesMemberService.fetchMemberById("ACF1093191092345B4DB336C9B5BF9000055")

      This command returns a hash table for the user that matches the member ID. In this example, the member ID represents Paul Smith. 

      {memberId=ACF1093191092345B4DB336C9B5BF9000055, displayName=Paul Smith,   
loginNames=[paul_smith@acme.com, Paul Smith], staticProfile=false,   
externalId=12345678-ABCD-44BC-8BBB-C947146C8F12, email=paul_smith@acme.com,
 memberType=person}

    For information about updating the data that is associated with a member, see Managing users.

    There are other administrative commands that use java.util.Hashtable as a parameter. You can save the member information that is returned from the previous commands as a java.util.Hashtable variable. Then, you can use this value in another administrative command, such as ActivityService.fetchActivitiesByMember(java.util.Hashtable member).

    Related tasks:

  • Start wsadmin


    Manage member access to activities

    Use administrative commands to change the level of access that members have to one or more activities.

    To run administrative commands, you must use the wsadmin client.

    You cannot use the AccessControlService commands to fetch, set, or delete access to community activities.

    See Communities administrative commands for information about the commands you can use to add a person to a community.

    1. Access the Activities configuration file...

        execfile("activitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    2. Find the hash table identifier for the activity or activities for which you want to edit the access levels. Fetch the ActivityID from the output by running the following command.

        ActivityService.fetchActivities()

    3. Identify the activity or activities to edit from the returned list.

      For more information, see Getting a list of activities.

      For example: 

      ActivityService.fetchActivities()
         ActivityService.fetchDeletedActivities()
         ActivityService.fetchCompletedActivities()
         ActivityService.fetchActivitiesByDate(java.lang.String dateType, java.lang.String beginTime,
                     java.lang.String endTime, java.lang.String lastUUID)
         ActivityService.fetchActivityById(java.lang.String uuid)
         ActivityService.fetchActivitiesCreatedByMember(java.util.Hashtable member)
         ActivityService.fetchActivitiesByMember(java.util.Hashtable member)
         ActivityService.fetchActivitiesByOwner(java.util.Hashtable member)

    4. Enter the following commands to see the current access levels of the members of a single activity: 

      ActivityService.fetchActivityById(java.lang.String uuid)
AccessControlService.fetchAccess( java.util.Hashtable activity)

      For example:

        myactivities=ActivityService.fetchActivityById(bb34202c-74a4-4f12-97a5-baad003ba021)
        AccessControlService.fetchAccess(myactivities)

    5. Create a variable that contains information about one or more people to whom you would like to grant access to the activities.

      • If you are defining the owner of an activity, save the member information as a hash table variable. The setOwnerAccess command expects the member parameter to be provided in hash table format. To do so, use the following command:

          ActivitiesMemberService.fetchMemberByName(java.lang.String name)

        For example:

          jane=ActivitiesMemberService.fetchMemberByName("Jane Fairfax")

      • If you are granting author or reader access, save the member information as a vector variable. The setMemberAccess and setReaderAccess commands expect the member parameter to be provided in vector format. A vector can represent one person or multiple people. A vector contains one or more hash tables. Each hash table contains information for a single person. To save member information as a vector variable, use the following command:

          ActivitiesMemberService.fetchMembers(java.lang.String filter)

        For example...

          allFairfaxes=ActivitiesMemberService.fetchMembers("*Fairfax")

        or

          frank=ActivitiesMemberService.fetchMembers("Frank Fairfax")

    6. Use the following commands to make the access level changes to make:

      • To grant many people owner-level access to one or more activities:

          AccessControlService.setOwnersAccess( java.util.Vector activities, java.util.Hashtable owner)

      • To grant one person owner-level access to one or more activities:

          AccessControlService.setOwnerAccess( java.util.Vector activities, java.util.Hashtable owner)

        For example:

          AccessControlService.setOwnerAccess(myactivities,jane)

      • To grant one person or many people author-level access to one or more activities:

          AccessControlService.setMembersAccess(java.util.Vector activities, java.util.Vector members)

        For example:

          AccessControlService.setMembersAccess(activities,allFairfaxes)

      • To grant one person or many people reader-level access to one or more activities:

          AccessControlService.setReadersAccess(java.util.Vector activities, java.util.Vector members)

        For example:

          AccessControlService.setReadersAccess(activities,frank)

      • To deny access to a set of members:

          AccessControlService.deleteAccess(java.util.Vector activities, java.util.Vector members)


    Related

  • Start wsadmin
  • Get a list of activities


    Manage uploaded files

    There are many ways to include files in an activity. Files can be uploaded and stored in an activity. To avoid uploading files into an activity, add a link in the activity that points to a file stored in a Linked Library or Files. You can also limit the maximum size of files that can be uploaded, add a content store to an activity, or move a content store.


    Set limits on uploaded files

    Edit configuration property settings to limit the types of files that can be uploaded into Activities. You can also set the maximum size of an uploaded file and the number of server threads concurrently dedicated to downloading files from Activities to clients.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    The Activities content store is used to store files that users upload to their activities.

    1. Check out the Activities configuration files.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Activities configuration ...

          ActivitiesConfigService.checkOutConfig("working_directory","cell_name")

        ...where...

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, IBM i and Linux: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To determine cell name, run wsadmin command:

            print AdminControl.getCell()

        For example:

        • AIX/Linux:

            ActivitiesConfigService.checkOutConfig("/opt/act/temp","Cell01")

        • IBM i:

            ActivitiesConfigService.checkOutConfig("/act/temp","Cell01")

          Windows:

            ActivitiesConfigService.checkOutConfig("c:/act/temp","Cell01")

    2. From the temporary directory to which you just checked out the oa-config.xml file, open the file in a text editor.

    3. Edit the elements in the <objectStore> section of the file to set limits on the files that can be uploaded.

      • To prevent users from being able to upload files of a specific type to Activities, add a <sizeLimits> element block to the <objectStore> section. For each file type to disable, create a <limit> element. Set the mimeFilenameRegex attribute of the <limit> element equal to the file extension of the file type to prevent users from uploading. Set the value of the limit element to 0.

        For example, the following element prevents users from being able to upload executable files: 

        <sizeLimits>
   <limit mimeFilenameRegex=".*\.exe">0</limit>
</sizeLimits>

        When you specify a value for the mimeFilenameRegex attribute, you are specifying a regular expression. Regular expressions are normally case-sensitive, and in the 1.0.x releases were treated as such. With release 2.0, the filter was enhanced so it is not case-sensitive.

        For example, if you specify <limit mimeFilenameRegex=".*\.exe">, the tool filters any files with a .exe extension regardless of the case in which the letters EXE are specified.

      • To limit the size of files that are uploaded to the content store, modify the value of the <limit> element for the entry with the .* extension. New maximum size value in bytes.

        For example, the following property setting specifies that all files must be smaller than 10.5 MB:

          <limit mimeFilenameRegex=".*">10500000</limit>

      • To limit the number of threads that are allowed to concurrently respond to requests to download files from the content store, edit the value of <max-concurrent-downloads>.

        For example, the following property setting enables the server to allow a maximum of 10 downloads at the same time... 

        <max-concurrent-downloads>10</max-concurrent-downloads>

    4. To remove a file upload limitation, delete the <limit> element that represents the file type to allow users to upload.

    5. To enable unlimited simultaneous downloads, remove the <max-concurrent-downloads> element.

    6. Save and close the oa-config.xml file.

    7. After you make changes, check in the configuration file. Check the file in in the same wsadmin session in which you checked it out for the changes to take effect. You must also restart the server.

      See Applying property changes for details.

    8. After you restart the Activities server, review WAS SystemOut.log file to ensure that the Activities application was able to initialize with the modified configuration.


    Example

    The following lines of XML provide an example of oa-config.xml file content that describes a <sizelimit> configuration. In this example, files with .exe, .sh, .bat, and .oa extensions cannot be uploaded to Activities. Also, the maximum file size of an uploaded file is 10 MB and the number of concurrent downloads is limited to 5. 

    <sizeLimits>
       <limit mimeFilenameRegex=".*\.exe">0</limit>
       <limit mimeFilenameRegex=".*\.bat">0</limit>
       <limit mimeFilenameRegex=".*\.sh">0</limit>
       <limit mimeFilenameRegex=".*\.oa">0</limit>
       <limit mimeFilenameRegex=".*">10485760</limit>
</sizeLimits>

<max-concurrent-downloads>5</max-concurrent-downloads>


    Related

  • Check out the Activities configuration files
  • Apply property changes in Activities


    Define multiple content stores for Activities

    The Activities content store stores the content, like files, that users add to their activities. The location of the content store can be defined during or after installation. You can configure Activities to use a content store that is different from the one defined during installation. Define more content stores if the current disk space on your system reaches capacity, or if you expand your infrastructure to add a drive. Adding a content store enables you to take advantage of the enhanced content store implementation that was introduced in version 4.

    Use the wsadmin client to edit configuration files. For details, see Starting the wsadmin client.

    The <store> element that contains the default attribute set to true is the active content store for Activities. The active content store is where activity content that users upload is saved to. All older content stores are read-only. Updates to files in the read-only stores are written to the active store.

    With release 4, the Java object used define the content store changed. The new implementation provides the following enhancements:

    • Resources from one activity are distributed and stored across multiple directories. In previous releases, the resources were all stored in subdirectories of a single directory. The new method helps to prevent busy implementations from reaching the maximum number of allowed subdirectories.

      For example, a directory on an EXT2 or EXT3 file system or Journal File System (JFS) and JFS2 on AIX allows for a maximum of 32K subdirectories. When the maximum number of subdirectories is reached, the administrator must add a content store to the deployment.

    • The new implementation uses a unique identifier to name the file, instead of using the file name that is given by the person who uploads the file. File metadata such as its mime type and user-defined name, is stored separately. As a result, someone with access to the disk cannot view the file without doing so through the product user interface.

    1. Check out the Activities configuration files.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Activities configuration ...

          ActivitiesConfigService.checkOutConfig("working_directory","cell_name")

        ...where...

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, IBM i and Linux: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To determine cell name, run wsadmin command:

            print AdminControl.getCell()

        For example:

        • AIX/Linux:

            ActivitiesConfigService.checkOutConfig("/opt/act/temp","Cell01")

        • IBM i:

            ActivitiesConfigService.checkOutConfig("/act/temp","Cell01")

          Windows:

            ActivitiesConfigService.checkOutConfig("c:/act/temp","Cell01")

    2. Go to the temporary directory that contains the checked out oa-config.xml file. Open oa-config.xml in a text editor.

    3. Copy the existing <store> to use as a template for the new content store.

    4. Paste a copy of the new <store> after the current <store>.

    5. Make the original content store inactive by changing the value of the default attribute to false. You must retain the original store to prevent data that was saved to the original store from becoming inaccessible. Removing the original content store can adversely affect existing activities.

    6. Make the new content store active by setting the value of the default attribute to true.

      Only one <store> can have a default attribute that is set to true. When you set the default attribute of a content store to true, new content is saved to that content store. Existing content remains in the old content store and is read-only.

    7. Modify the new <store> to point to the new file system location.

        <id>
        Activities relies on this element to map to the content store configuration. Do not change the value of the <id> element after the system is in use. Specify a unique name for the file system. The maximum character limit for <id> is 32 characters.

        root.directory property
        Specify the file path of the new file system location.

        • Use the Universal Naming Convention (UNC) format to set the file path to a network share directory.

          For example, \\server_name\share_name.

        • Use the WAS environment variable that defines the file store location.

          For example: ${ACTIVITIES_CONTENT_DIR}. Using a variable to define the directory location makes it easier to change the value of the content store path information later.

        Specify the same value on each node to which you install Activities.

    8. Save and close the oa-config.xml file.


    Example

    The following sample shows two content stores. The second <store> is the active store and is where new content or revisions of existing content are uploaded to. It uses the new implementation. The first content store uses the old implementation and is inactive. The two implementations can coexist, but should reside in a mapped disk location that is separate from each other. 

    <store default="false"    
       class="com.ibm.openactivities.objectstore.filesystem.FileSystemObjectStore">

    <id>filesystem</id>
    <property name="use.historic">false</property>
    <property name="root.directory">
     \\enterprise.server\LotusConnections\Data\activities\content
    </property>

</store>
<store    default="true"    class="com.ibm.openactivities.objectstore.filesystem.ContentStore">
    <id>filesystem2</id>
    <property name="use.historic">false</property>
    <property name="root.directory">${ACTIVITIES_CONTENT_DIR}</property>
</store>

    Check in the updated configuration files. The check-in must be done in the same wsadmin session in which you checked them out for the changes to take effect.

    See Applying property changes for details. Restart the Activities server and review WAS SystemOut.log file to ensure that the Activities application was able to initialize with the modified configuration. .


    Related

  • Move the content store
  • Apply property changes in Activities
  • Start wsadmin


    Move the content store

    You can change the location of the content store used by the Activities application from the location defined at installation time. You might want to change the location of the content store if you augment your infrastructure and there is a new drive with more disk space available, for example.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    The Activities content store is used to store files and other content that users add to their activities. To change the location of the content store after installing Activities, you can do so by performing the steps in this procedure. To maintain the existing content store, you can create a new content store in addition to the existing one.

    See Defining multiple content stores for more information.

    To move the content store:

    1. The location of the content store is defined in the oa-config.xml file using one of the following formats:

      • File path to a network share directory in Universal Naming Convention (UNC) format.

        For example: \\server_name\share_name. Specify the same directory on each node to which Activities is installed.

      • WAS environment variable which contains the file path information.

        For example: ${ACTIVITIES_CONTENT_DIR}

    2. If the file path is defined in UNC format only: You must edit the oa-config.xml configuration file.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Activities configuration ...

          ActivitiesConfigService.checkOutConfig("working_directory","cell_name")

        ...where...

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, IBM i and Linux: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To determine cell name, run wsadmin command:

            print AdminControl.getCell()

        For example:

        • AIX/Linux:

            ActivitiesConfigService.checkOutConfig("/opt/act/temp","Cell01")

        • IBM i:

            ActivitiesConfigService.checkOutConfig("/act/temp","Cell01")

          Windows:

            ActivitiesConfigService.checkOutConfig("c:/act/temp","Cell01")

      3. From the temporary directory to which you just checked out the oa-config.xml file, open the file in a text editor.

      4. Find the existing <store> element, which defines the current content store location. Edit the following property of the <store> element to point to the new directory location:

          root.directory property
          Edit the value of the property to reflect the file path of the new file system location.

        Do not change the value of the <id> element. Activities relies on the <id> element to map to the content store configuration.

      5. Save and close the oa-config.xml file.

      6. After making changes, check the configuration files back in and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

        See Applying property changes for details.

    3. If the file path is defined using a WAS environment variable: Edit the value of the variable:

      1. Use an administrator ID, log into the WAS admin console associated with the profile to which you installed Activities.

      2. Expand Environment, and then click WebSphere Variables.

      3. Find the ACTIVITIES_CONTENT_DIR environment variable from the list, and then edit its value.

      4. Save, and then apply your changes

    4. Copy the content store data from the old content store location to the new location.

    5. Restart the Activities application.

    6. After restarting the Activities server, review WAS SystemOut.log file to ensure that the Activities application was able to initialize with the modified configuration.

    7. After the content store is successfully copied to the new location, you can remove the original content store.


    Related

  • Define multiple content stores for Activities


    Back up Activities data

    Activities stores data in both a database and the file system. You should backup both sets of data on a regular basis.

    1. From WAS admin console, stop the Activities application or cluster.

    2. Back up the OPNACT database according to the database documentation provided by your database vendor.

      Backup the database before backing up the content store on the file system.

    3. Backup the directory on the file system that contains the Activities data according to the documentation provided by your file system vendor. To determine the location of the Activities directory, get the value of the ACTIVITIES_CONTENT_DIR WebSphere Application Server variable for the relevant server by completing the following steps:

      1. Open WAS admin console.

      2. Select Environment > WebSphere Variables.

      3. Click Show filter function.

      4. Ensure that WebSphere Variables displays in the Filter dropdown menu.

      5. Enter ACTIVITIES_CONTENT_DIR into the Search term(s) text box and click Go. A variable called ACTIVITIES_CONTENT_DIR displays in the search results. Take a note of the value of this variable as the index location for the relevant server.

    4. Restart the Activities application or cluster.


    Related

  • Compare remote application data with the Communities database


    Restore Activities data

    You can restore Activities data to a previously backed up version.

    This procedure assumes that you have been backing up the Activities database and content store on a regular basis.

    1. From WAS admin console, stop the Activities application or cluster.

    2. Stop the Search service or cluster.
    3. Restore the OPNACT database from the latest backed up version according to the database documentation provided by your database vendor.

      Restore the database before restoring the content store on the file system.

    4. Restore the data in the directory on the file system that contains the Activities data according to the documentation provided by your file system vendor.

    5. Delete the Connections index. Refer to the instructions in the Deleting the index topic.

    6. Restart the Search application or cluster.

    7. Restart the Activities application or cluster.

    8. If you have any community activities, you must perform some additional step to make sure that the Activities database and Communities database are synchronized with the same activities data.

      To do so, complete the steps described in the Comparing remote application data with the Communities database topic.


    Related

  • Compare remote application data with the Communities database


    Integrate Activities with IBM Lotus Quickr

    After you have finished collaborating with your team on a file in an activity, you can publish the finished product to an IBM Lotus Quickr library to share it with a larger group or to store the file.


    Enable users to publish file attachments to Lotus Quickr

    Edit the configuration property settings of Activities to allow users to publish file attachments from an activity to an IBM Lotus Quickr library.

    Before you can complete this procedure, you must have Lotus Quickr deployed in your environment and know the fully qualified domain names of all the Lotus Quickr servers that you want users to be able to publish to.

    Decide which type of authentication to use between the Activities and Lotus Quickr servers, and perform any required prerequisite tasks to support the authentication type that you decide to use. You must choose between the following options:

      Single sign-on
      By default, the Activities application assumes that single sign-on (SSO) is configured between the Activities server and the Lotus Quickr servers. As a result, when Activities users select the Lotus Quickr servers that they want to publish file attachments to, they are not prompted for user names and passwords. To support this functionality, you must first enable SSO with Lotus Quickr.

      See Enabling single sign-on with Lotus Quickr.

      Basic authentication
      If for some reason you do not want to or cannot set up SSO between the Activities and Lotus Quickr servers, Activities users are prompted for a user name and password when they try to publish file attachment to Lotus Quickr. To ensure that those credentials are not sent unprotected over HTTP, you must take the following steps:

      • Configure Connections to force traffic on the Activities server to be sent over a secure channel.

        See Forcing traffic to be sent over SSL.

      • Specify HTTPS as the protocol for the servers that you define in Step 4.

      • Do not perform Step 5.

      • Perform Step 6.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    1. Check out the Activities configuration files.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Activities configuration ...

          ActivitiesConfigService.checkOutConfig("working_directory","cell_name")

        ...where...

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, IBM i and Linux: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To determine cell name, run wsadmin command:

            print AdminControl.getCell()

        For example:

        • AIX/Linux:

            ActivitiesConfigService.checkOutConfig("/opt/act/temp","Cell01")

        • IBM i:

            ActivitiesConfigService.checkOutConfig("/act/temp","Cell01")

          Windows:

            ActivitiesConfigService.checkOutConfig("c:/act/temp","Cell01")

    2. From the temporary directory to which you checked out the Activities configuration file, open the oa-config.xml file in a text editor.

    3. Set the enabled attribute of the <PublishFile> element to true.

    4. Create one <server> element for each Lotus Quickr server to support. In the server element, specify the fully qualified domain name of the Lotus Quickr server to allow users to publish files to. Include the port number.

      For example: 

      <PublishFile enabled="true" allowCustomServers="false" requireSSO="true">
      <server>http://quickr.example.com:8085</server>
      <server>http://quickr.southwest.example.com:8080</server>
</PublishFile>
      If the Quickr serves are protected by TAM, use the junction name in the URL.

      For example: 

      <PublishFile enabled="true" allowCustomServers="false" requireSSO="true">
      <server>http://TAM.quickr.example.com:8085/Quickr_junction</server>
      <server>http://TAM.quickr.southwest.example.com:8080/Quickr_junction</server>
</PublishFile>
      If you are not setting up single sign-on between the Activities and Lotus Quickr servers, specify the servers using the HTTPS protocol.

      For example: 

      <PublishFile enabled="true" allowCustomServers="false" requireSSO="false">
      <server>https://quickr.example.com:8085</server>
      <server>https://quickr.southwest.example.com:8080</server>
</PublishFile>
      The first server that you specify in the list becomes the default server that is displayed in the Server field in the dialog box from which the user selects the Lotus Quickr library to which to publish a file. If a user selects a different Lotus Quickr server from the Server field, that server becomes the default.

    5. If, instead of specifying a finite list of servers that users can save files to, you want users to be able to save files to any Lotus Quickr server hosted within a specific domain, set the allowCustomServers attribute to true .

      For example: 

      <PublishFile enabled="true" allowCustomServers="true" requireSSO="true">
</PublishFile>

      Perform this step only if you are setting up SSO between the Activities and Lotus Quickr servers. Keeping the value of this attribute set to false prevents users from typing in server names that specify the HTTP protocol instead of HTTPS.

    6. If you decide to not set up SSO between the Activities and Lotus Quickr servers, change the value of the requireSSO attribute to false.

      For example: 

      <PublishFile enabled="true" allowCustomServers="false" requireSSO="false">
        <server>https://quickr.example.com:8085</server>
        <server>https://quickr.southwest.example.com:8080</server>
</PublishFile>

      When you make this change, you must perform the steps necessary to force the Activities server traffic to be sent over SSL.

      See Forcing traffic to be sent over SSL.

    7. Save and close the oa-config.xml file.

    8. After making changes, check the configuration files back in and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes for details.


    Related

  • Check out the Activities configuration files
  • Apply property changes in Activities


    Define a list of supported Lotus Quickr servers

    After the Activities server is configured to allow file attachments to be published to IBM Lotus Quickr, you must provide a list of the supported Lotus Quickr servers to the proxy server. The proxy server can now complete access requests that are made to one of the supported Lotus Quickr servers. Follow these steps if you want users to be able to publish files from an Activity entry to a Lotus Quickr library.

    Lotus Quickr must be deployed in your enterprise before you can complete this procedure. You must also have administrative access to WAS to which Activities is installed.

    Create custom properties for the QuickrWhitelistProvider so that Activities can access a Lotus Quickr server. When you upgrade a stand-alone deployment that is configured to integrate Lotus Quickr and a network deployment, re-create the custom properties for the provider on the cluster's cell. The custom properties must be redefined because they are lost when you federate the node into a cluster.

    To publish Activities to Lotus Quickr Domino, you must add both the Lotus Quickr server and a Quickr Junction to the QuickrWhitelistProvider. This configuration is required if both Connections and Lotus Quickr Domino server are protected by Tivoli Access Manager.

    1. Go to WAS admin console for the server that is hosting the deployment manager.

    2. Expand Resources > Resource Environment, and then click Resource Environment Providers.

    3. Click QuickrWhitelistProvider from the list, and then click Custom properties.

    4. Create one custom property for each Lotus Quickr server to enable users to publish documents to. To create a custom property, enter values in the following fields:

        name
        Create a property name that begins with the term allow.

        For example: allowQuickrPrimary.example.com

        value
        Specify the fully qualified domain name of the Lotus Quickr server or its IP address. Do not specify the protocol or any port numbers.

        To enable users to publish files to several servers within a specific domain, specify the parent domain in this field. You must start the string with a period (.).

        For example, if you were to specify .acme.com, the proxy would allow the file to be published to all of the servers that are available from subdomains of acme.com. If you want users to be able to type in a server that is hosted within this domain, set the allowCustomServers attribute of the <PublishFile> element to true in the oa-config.xml file.

        The provider does not convert IP addresses to domain names nor the other way around. If the server is requested using both identifiers, create two properties. Create one property that specifies the domain name in the value field and another property that specifies the IP address in the value field.

    Create custom properties for the QuickrWhitelistProvider for each server that you defined in the oa-config.xml file. These servers were defined when you completed the procedure: Enabling users to publish file attachments to Lotus Quickr.


    Manage trash

    Use administrative commands and edit configuration property settings to move activities and entries to the Trash view, empty the trash, restore activities and entries from the Trash view, mark inactive activities complete, and perform other trash management tasks.


    Complete activities that are not being used

    Edit configuration property settings to disable the removal of inactive activities from the My Activities view, to change the amount of time an activity must be inactive before it is marked complete by the server, or to disable the warning notification that is sent to activity owners before an activity is marked complete.

    When an activity is marked complete, it moves from the My Activities view to the Completed view. The default interval is 90 days. Before starting this procedure, determine the amount of time to allow an idle activity to remain in the active views before it is marked complete and moved to the Completed view.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    If email notifications are enabled, Activities warns the owner of an activity that has not been modified in the specified time frame that the activity will be marked complete. This allows the owner to modify the activity to keep it active and prevent it from being marked complete. You can enable and disable this email notification application. If you do not want to automatically move activities into the Completed view, you can also disable this job.

    To remove an activity that is not being used:

    1. Check out the Activities configuration files.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Activities configuration ...

          ActivitiesConfigService.checkOutConfig("working_directory","cell_name")

        ...where...

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, IBM i and Linux: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To determine cell name, run wsadmin command:

            print AdminControl.getCell()

        For example:

        • AIX/Linux:

            ActivitiesConfigService.checkOutConfig("/opt/act/temp","Cell01")

        • IBM i:

            ActivitiesConfigService.checkOutConfig("/act/temp","Cell01")

          Windows:

            ActivitiesConfigService.checkOutConfig("c:/act/temp","Cell01")

    2. Display the current configuration settings

        ActivitiesConfigService.showConfig()

      From the returned list, look at the current values of the settings that begin with jobs.AutoComplete and determine which property values you want to change:

        jobs.AutoComplete.autoCompletionPeriod
        Number of days of inactivity that must pass before an activity is automatically marked complete. Specify the value in days. The default value is 90.

        jobs.AutoComplete.prenotification
        Defines whether or not to send an email to the activity owners to warn them that the activity will be marked complete if no modifications are made to it. This property accepts the following values: true or false. The default value is true. This setting requires that email notifications are enabled.

    3. To change the property values...

        ActivitiesConfigService.updateConfig(property, value)

      For example:

        ActivitiesConfigService.updateConfig("jobs.AutoComplete.autoCompletionPeriod","100") ActivitiesConfigService.updateConfig("jobs.AutoComplete.prenotification","false")

    4. If you decide to notify activity owners, you can change the number of days warning they are given by changing the interval at which the job runs. If the job is scheduled to run once a month, the owners get a month's notice that their activity will be marked complete. If it runs weekly, they get a week's notice.

      To change the interval of the job, edit the value of the jobs.AutoComplete.interval property. The default value is 0 0 23 ? * SAT, which specifies that the job should run weekly at 11 PM on Saturday.

      For information about how to format this value, see Scheduling tasks.

      Use the following command to edit this property:

        ActivitiesConfigService.updateConfig("jobs.AutoComplete.interval", value)

      where value is a time interval.

      For example: "0 30 4 ? * SAT"

    5. To prevent the auto completion job from running altogether, you can use the following command to disable the job...

        ActivitiesConfigService.updateConfig("jobs.AutoComplete.enabled", "false")

    6. After making changes, check the configuration files back in and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes for details.


    Example

    When making configuration changes to the ActivityAutoCompleteJob scheduled job, you are modifying settings in the oa-config.xml file. The following XML sample of oa-config.xml file content defines a job that runs weekly (Saturdays at 11 PM) and marks complete any activities on the server that have not been modified in 100 days. Because prenotification is set to false, the activity owners will not get an email notification that the activities will be marked complete. The ActivityAutoCompleteJob task sets the last updated by field in the Activities interface to Activities Administrator. 

    <scheduledTasks>
  <!-- cluster scoped jobs -->
     <!-- ActivityAutoCompleteJob - weekly on Sat at 11pm  -->
  <task name="ActivityAutoCompleteJob"     
        description="Automatically mark unmodified activities as completed"
        interval="0 0 23 ? * SAT"     
        startby=""     
        enabled="false"     
        scope="cluster"     
        type="class"
        targetName="com.ibm.openactivities.jobs.AutoCompleteJobWS"     
        mbeanMethodName=""     
        serverName="unsupported" >
    <args>
      <property name="autoCompletionPeriod">100</property>
      <property name="prenotification">false</property>
    </args>
  </task>
  ...
</scheduledTasks>


    Related

  • Check out the Activities configuration files
  • Apply property changes in Activities
  • Manage the scheduler


    Delete activities

    Use administrative commands to move one or more activities to the Trash view.

    To run administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    1. Start the Activities Jython script interpreter.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    2. If you have not yet created a variable that contains the activities you want to delete, create one. You can get a list of activities in hash table format by using one of the fetchActivities commands.

      See Activities administrative commands for a full list.

      For example, if a person leaves the organization and you want to delete all of the activities that he owns, you can perform the following steps to narrow down the activities to delete:

      1. Get a hash table of information related to a specific user...

          variable=ActivitiesMemberService.fetchMemberByName(java.lang.String member)

        For example:

          joe=ActivitiesMemberService.fetchMemberByName("Joe Jacobs")

      2. Retrieve the activities that a specific person owns...

          variable=ActivityService.fetchActivitiesByOwner(java.util.Hashtable member)

        For example:

          joesactivities=ActivityService.fetchActivitiesByOwner(joe)

    3. Enter the following command to delete the activity or activities...

        ActivityService.deleteActivities(java.util.Vector activities)

      ...where you specify the activity or activities to delete as the activities parameter.

      For example:

        ActivityService.deleteActivities(joesactivities)


    Related

  • Start wsadmin


    Restore deleted activities

    Use an administrative command to restore activities that were moved to the Trash view. After an activity is moved to the Trash view, and before the Trash is purged from the system, the activity can be preserved if it is restored.

    You do not need to check the configuration file in and out nor restart the server when using administrative commands.

    To run administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    1. Start wsadmin client

    2. Start the Activities Jython script interpreter.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Get a list of the activities and entries currently in the Trash view by entering the following command...

        TrashCollectionService.fetchTrash()

    4. Identify the activity or entry to restore from the returned list.

      See Narrowing down results for more information.

    5. Enter the following command to restore the activity or entry...

        TrashCollectionService.undeleteTrash( java.util.Vector trashVector)

      ...where you specify the activity or entry to restore as the trashVector parameter.


    Example

    Here is an example where all activities are deleted that start with a_activities, a_activities1, a_activities2, ....

      Trash=TrashCollectionService.fetchTrash()
      myactivities=ListService.filterActivitiesByName(Trash, "a_act.*")
      TrashCollectionService.undeleteTrash(myactivities)


    Related

  • Start wsadmin


    Empty the Activities trash on a schedule

    Edit configuration property settings to set up a schedule on which to permanently delete the activities and entries that have been moved to the Trash view.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    Activities that are deleted are moved to the Trash view and can be restored from the Trash view. You can schedule the permanent deletion of activities and entries after a time interval that you specify. When the scheduled job runs, the activities and entries in the Trash view are permanently deleted from the system. Items that are purged from the Trash view are not recoverable.

    To schedule the permanent removal of activities or entries from the Trash view:

    1. Check out the Activities configuration files.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Activities configuration ...

          ActivitiesConfigService.checkOutConfig("working_directory","cell_name")

        ...where...

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, IBM i and Linux: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To determine cell name, run wsadmin command:

            print AdminControl.getCell()

        For example:

        • AIX/Linux:

            ActivitiesConfigService.checkOutConfig("/opt/act/temp","Cell01")

        • IBM i:

            ActivitiesConfigService.checkOutConfig("/act/temp","Cell01")

          Windows:

            ActivitiesConfigService.checkOutConfig("c:/act/temp","Cell01")

    2. Display the current Activities configuration settings using the following command...

        ActivitiesConfigService.showConfig()

      From the returned list, look for the settings that begin with jobs.TrashAutoPurge; these control trash deletion. Determine which property values you want to change:

        jobs.TrashAutoPurge.daysRetention
        Number of days after which you would like activities and their entries removed from the Trash view. Specify the value in days. The default value is 90.

        Do not set this value to 0. When it is set to 0, activities and their entries are not removed from the Trash view.

        jobs.TrashAutoPurge.interval
        Frequency with which the job to check for expired content runs.

        See Scheduling tasks for information about the format to use to specify the interval. The default value is 0 0 2 ? * SUN, which specifies that the job should run weekly at 2 AM on Sunday.

    3. To change the property values...

        ActivitiesConfigService.updateConfig(property, value)

      For example:

        ActivitiesConfigService.updateConfig("jobs.TrashAutoPurge.daysRetention", "100")
        ActivitiesConfigService.updateConfig("jobs.TrashAutoPurge.interval", "0 15 10 L * ?")

      The 0 15 10 L * ? value schedules the job to run at 10:15 AM on the last day of every month.

    4. To prevent the trash purge job from running altogether, you can use the following commands to disable the jobs...

        ActivitiesConfigService.updateConfig("jobs.TrashAutoPurge.enabled", "false")

    5. After making changes, check the configuration files back in and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes for details.


    Example

    When making configuration changes to the TrashAutoPurge scheduled job you are modifying settings in the oa-config.xml file.

    The following sample oa-config.xml file segment removes content from the Trash view after 100 days and runs the job to check for expired content at 10:15 AM on the last day of every month. 

    <scheduledTasks>
    <!-- cluster scoped jobs -->
    <task name="TrashAutoPurgeJob"                           
          description="Permanently removes Activities Trash"
          interval="0 15 10 L * ?"                          
          startby=""                          
          enabled="true"                          
          scope="cluster"                          
          type="class"
          targetName="com.ibm.openactivities.jobs.TrashAutoPurgeJobWS"                          
          mbeanMethodName=""                           
          serverName="unsupported" >
         <args>
               <property name="trashRetentionInDays">100</property>
         </args>
    </task>          
...
<scheduledTasks>


    Related

  • Check out the Activities configuration files
  • Apply property changes in Activities
  • Manage the scheduler


    Purge specific activities or entries from the trash

    Use an administrative command to permanently delete a specific activity or entry by removing it from the Trash view.

    You do not need to check the configuration file in and out nor restart the server when using administrative commands.

    To run administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    1. Start the Activities Jython script interpreter.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    2. Get a list of the activities and entries currently in the Trash view by entering the following command...

        TrashCollectionService.fetchTrash()

    3. Identify the activity or entry to delete from the returned list.

      See Narrowing down results for more information.

    4. Enter the following command to delete the activity or entry...

        TrashCollectionService.purgeTrash( java.util.Vector trashVector)

      ...where you specify the activity or entry to delete as the trashVector parameter.


    Related

  • Start wsadmin


    Monitoring statistics and metrics

    Use the Activities statistics gathering application to monitor operations, product usage, and to make configuration adjustments when necessary.

    Activities enables you to monitor statistics in the following ways:

    • Edit configuration settings to change the schedule on which statistics are collected and to define which statistics are collected.
    • Retrieve statistics from a spreadsheet or by using administrative commands.
    • Retrieve statistics from a web page.


    Related

  • Start wsadmin


    Activity statistics

    Activities provides a variety of statistics used to monitor operations and make configuration adjustments when necessary.


    Use statistics

    Activities maintains sets of statistics that keep track of usage information. The values for these statistics, and the change in value between the last sample and the current one are maintained in text files. The statistics collected, the frequency with which they are collected, and the text file names all have default settings. You can change the configuration to collect fewer statistics or to change the collection frequency.

    Available statistics include:

    • Number of activities and activity members
    • Number of times that a service was accessed
    • Response times for services

    Activities runs scheduled tasks that save current statistics values. The jobs are defined in the oa-config.xml file. You can edit this file to change the time intervals of the jobs or to change the start times of the jobs.

    Activities runs the following scheduled jobs:

      DatabaseRuntimeStats
      Runs once per hour by default. Its function is to query the Activities database for database related statistics, such as the number of Activities, or number of members.

      30MinStats
      Runs once every half hour by default. Its function is to maintain the current values of the Activities statistics specified in the <stats> element of oa-config.xml to disk.

      DailyStats
      Runs once a day at 11:00 AM by default. Its function is to maintain the current values of the Activities statistics specified in the <stats> element of oa-config.xml to disk.

    By default, the statistics jobs capture some standard statistics that are defined in the oa-config.xml file. You can edit this file to collect the statistics that best suit your implementation. Activities saves the collected data into files whose names are composed by combining the job name with the following names:

      AddedData.txt
      Collects the number of bytes of data added to the system.

      Average.txt
      Collects the average time required to process a request to a particular Activities service in milliseconds.

      ContentStore.txt
      Collects the content store activity: uploads, downloads, and deletions.

      Counts.txt
      Collects the number of times that a particular service was accessed.

      Current.txt
      Collects information about aspects of the currently running system.

      Events.txt
      Collects the number of errors being reported by the system.

      Totals.txt
      Collects the number of objects in the system.

    For example, the 30MinStats scheduled job maintains files named 30MinStatsAddedData.txt, 30MinStatsAverage.txt, and so on. The DailyStats job maintains files named DailyStatsAddedData.txt, DailyStatsAverage.txt, an so on. Additionally, each file maintained by Activities has an associated delta file that tracks the difference between the previous value of the statistic and the current value.

    For example: Delta30MinStatsAddedData.txt and DeltaDailyStatsAddedData.txt. There are also average delta files, which track the average time required to process the requests within the collection interval. These are named as follows: Delta30MinStatsAverage.txt and DeltaDailyStatsAverage.txt.

    Statistics text files use a comma separated value (CSV) format. This format enables you to import the files into a spreadsheet, and then compute and chart the values.

    All of the files into which Activities stores data are in the directory referenced by the ACTIVITIES_STATS_DIR WebSphere Application Server variable. The files for the statistics for each server are located in the ACTIVITIES_STATS_DIR/{nodeName}/{serverName} directory. To edit the variable, access the websphere Application Server Integrated Solutions Console, navigate to Environment > WebSphere Variables, and search in the server scope. You can view the current value of the ACTIVITIES_STATS_DIR variable and modify it, if necessary.


    The statistics and what they measure

    The following tables list the statistics available and describe what each statistic represents.


    Statistics in jobName Totals.txt file

    Statistic Description
    activities.data.totals.activities Number of activities in the database.
    activities.data.totals.entries Number of activity entries (for example standard entries, to-do items) in the database.
    activities.data.totals.members Number of activity members in the database.


    Statistics in jobName Current.txt file

    Statistic Description
    activites.requests.concurrent.max Maximum number of simultaneous requests processed by the Activities application since the application was started.
    activities.service.eventqueue.entries.current Current number of events waiting to be processed.
    activities.users.active.current Number of users that have accessed the Activities application within the last five minutes.
    activities.users.active.max Maximum number of users that have accessed the Activities application within a five minute window since the application was started.


    Statistics in jobName Events.txt file

    Statistic Description
    activities.fatals Number of fatal errors reported by the Activities application since the application was started.
    activities.errors Number of non-fatal errors reported by the Activities application since the application was started.
    activities.warnings Number of warnings reported by the Activities application since the application was started.
    activities.service.virus.scan.found.count Number of viruses removed from content by the virus scanning software configured for the Activities application since the application was started. If virus scanning is not enabled, then zeros (0) are collected for this statistic.
    activities.service.acf.badcontent.found Number of instances of active content removed by the Activities application since the application was started. If active content filtering is not enabled for Activities, then zeros (0) are collected for this statistic.


    Statistics in jobName Average.txt file (Average time in milliseconds required to process a request to a particular Activities service

    Statistic Description
    activities.service.db.totals.Average Average time to complete a database request.
    activities.service.api.totals.Average Average time to complete a service request.
    activities.service.directoryprofile.totals.Average Average time to complete a directory lookup request.
    activities.service.smtp.totals.Average Average time to deposit mail to the SMTP server. If SMTP is not enabled, then zeros (0) are collected for this statistic.
    activities.service.trash.totals.Average Average time to purge an activity or activity entry from the trash.


    Statistics in jobName Counts.txt file

    Statistic Description
    activities.service.db.totals.Count Number of database requests made since the application was started.
    activities.service.api.totals.Count Number of service requests made since the application was started.
    activities.service.directoryprofile.totals.Count Number of directory lookups made since the application was started.
    activities.service.smtp.totals.Count Number of SMTP requests made since the application was started. If SMTP is not enabled, then zeros (0) are collected for this statistic.
    activities.service.trash.totals.Count Number of activities or activity entries purged from the trash since the application was started.


    Statistics in jobName AddedData.txt file

    Statistic Description
    activities.service.contentstore.filesystem.upload.bytes Number of bytes added to the content store by uploaded files.


    Statistics in "jobName"ContentStore.txt file

    Statistic Description
    activities.service.contentstore.filesystem.upload.Count Number of files uploaded to Activities since the application was started.
    activities.service.contentstore.filesystem.download.Count Number of files downloaded from Activities since the application was started.
    activities.service.contentstore.filesystem.remove.Count Number of files removed from Activities since the application was started.


    Examples of Activities configuration files

    The following example demonstrates the data that Activities collects by default: 

    <stats>
    <!--  Specify where statistics files should be kept.           -->         
    <statsDirectory/>${ACTIVITIES_STATS_DIR}</statsDirectory>         
        <stat>
          <fields>
            <field>dates</field>             
        <field>activities.data.totals.activities</field>             
        <field>activities.data.totals.entries</field>             
        <field>activities.data.totals.members</field>           
        </fields>
         
        <file>Totals.txt</file>           
        <samples>144</samples>         
        </stat>
       
        <stat>
         
        <fields>
           
        <field>dates</field>             
        <field>activities.requests.concurrent.max</field>             
        <field>activities.service.eventqueue.entries.current</field>             
        <field>activities.users.active.current</field>             
        <field>activities.users.active.max</field>           
        </fields>
         
        <file>Current.txt</file>           
        <samples>144</samples>         
        </stat>
       
        <stat>
          <fields>
           
        <field>dates</field>             
        <field>activities.fatals</field>             
        <field>activities.errors</field>             
        <field>activities.warnings</field>           
        </fields>
         
        <file>Events.txt</file>           
        <samples>144</samples>         
        </stat>
       
        <stat>
         
        <fields>
           
        <field>dates</field>             
        <field>activities.service.db.totals.Average</field>             
        <field>activities.service.api.totals.Average</field>             
        <field>activities.service.directoryprofile.totals.Average</field>             
        <field>activities.service.smtp.totals.Average</field>             
        <field>activities.service.trash.totals.Average</field>           
        </fields>
         
        <file>Average.txt</file>           
        <samples>144</samples>         
        </stat>
       
        <stat>
         
        <fields>
           
        <field>dates</field>             
        <field>activities.service.db.totals.Count</field>             
        <field>activities.service.api.totals.Count</field>             
        <field>activities.service.directoryprofile.totals.Count</field>             
        <field>activities.service.smtp.totals.Count</field>             
        <field>activities.service.trash.totals.Count</field>           
        </fields>
         
        <file>Counts.txt</file>           
        <samples>144</samples>         
        </stat>
       
        <stat>
         
        <fields>
           
       
        <field>dates</field>             
        <field>
              activities.service.contentstore.filesystem.upload.bytes
           
        </field>           
        </fields>
          <file>AddedData.txt</file>           
        <samples>144</samples>         
        </stat>
        <stat>
            <fields>
                <field>dates</field>
                <field>
                  activities.service.contentstore.filesystem.upload.Count
                </field>
                <field>
                  activities.service.contentstore.filesystem.download.Count
                </field>
                <field>
                  activities.service.contentstore.filesystem.remove.Count
                </field>
            </fields>
            <file>ContentStore.txt</file>
            <samples>144</samples>
        </stat>
      </stats>


    Define which statistics to collect

    Edit configuration property settings to define the statistics that are collected by the server.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    The Activities server collects a specific set of statistics by default. You can change what is collected to better suit the needs of your environment.

    For example, Activities collects statistics on SMTP server performance. If you are not using an SMTP server, you can prevent its performance from being monitored. For a complete list of the statistics that are collected by Activities by default, see Activities statistics.

    To define which statistics are collected by the server:

    1. Check out the Activities configuration files.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Activities configuration ...

          ActivitiesConfigService.checkOutConfig("working_directory","cell_name")

        ...where...

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, IBM i and Linux: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To determine cell name, run wsadmin command:

            print AdminControl.getCell()

        For example:

        • AIX/Linux:

            ActivitiesConfigService.checkOutConfig("/opt/act/temp","Cell01")

        • IBM i:

            ActivitiesConfigService.checkOutConfig("/act/temp","Cell01")

          Windows:

            ActivitiesConfigService.checkOutConfig("c:/act/temp","Cell01")

    2. From the temporary directory to which you checked out the Activities configuration file, open the oa-config.xml file in a text editor, and look for the <stat> element block.

    3. Make any of the following edits:

      • To stop collecting data on a specific field, remove the <field> element that represents the value that you are not interested in collecting.

      • To change the name of the text file created to store the statistical data, edit the attribute of the <file> element.

      • To change the number of versions of results that are maintained from the default value of the 144, edit the <samples> element.

    4. After making your edits, save and close the oa-config.xml file.

    5. After making changes, check the configuration files back in and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes for details.


    Related

  • Check out the Activities configuration files
  • Apply property changes in Activities


    Schedule Activities statistics collection

    Edit configuration property settings to change the frequency and duration of the jobs that collect server statistics.

    To edit configuration files, use the wsadmin client.

    1. Check out the Activities configuration files.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Activities configuration ...

          ActivitiesConfigService.checkOutConfig("working_directory","cell_name")

        ...where...

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, IBM i and Linux: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To determine cell name, run wsadmin command:

            print AdminControl.getCell()

        For example:

        • AIX/Linux:

            ActivitiesConfigService.checkOutConfig("/opt/act/temp","Cell01")

        • IBM i:

            ActivitiesConfigService.checkOutConfig("/act/temp","Cell01")

          Windows:

            ActivitiesConfigService.checkOutConfig("c:/act/temp","Cell01")

    2. Display the current configuration settings

        ActivitiesConfigService.showConfig()

      From the returned list, look at the current values of the settings that begin with jobs.30MinStats, jobs.DailyStats, and jobs.DatabaseRuntimeStats to determine which property values, if any, you want to change:

    3. You can change the property values...

        ActivitiesConfigService.updateConfig(property, value)

      For example:

      • To change the frequency with which the 30MinStats job runs from every 30 minutes to every 10 minutes, edit the value of the interval attribute using the following command. The default value is 0 0/30 * * * ? which specifies that the job should run every 30 minutes.

          ActivitiesConfigService.updateConfig("jobs.30MinStats.interval", "0 0/10 * * * ?")

        If you change the frequency to something other than 30 minutes, keep in mind that the job name will still be 30MinStats and could lead to some confusion.

      • To change the start time of the DailyStats job from 11 AM to 1 AM, edit the value the interval attribute using the following command. The default value is 0 0 11 * * ? which specifies that the job should run daily at 11 AM.

          ActivitiesConfigService.updateConfig("jobs.DailyStats.interval", "0 0 1 * * ?")

      • To change the frequency with which the DatabaseRuntimeStats job runs from once every hour to once every 45 minutes, edit the value of the interval attribute using the following command. The default value is 0 0 * * * ?, which specifies that the job should run once every hour, on the hour.

          ActivitiesConfigService.updateConfig("jobs.DatabaseRuntimeStats.interval", "0 0/45 * * * ?")

      For information about how to format the value of the interval attribute, see Scheduling tasks.

    4. To prevent the statistics collection job from running altogether, you can use the following commands to disable the jobs...

        ActivitiesConfigService.updateConfig("jobs.30MinStats.enabled", "false")
        ActivitiesConfigService.updateConfig("jobs.DailyStats.enabled", "false")
        ActivitiesConfigService.updateConfig("jobs.DatabaseRuntimeStats.enabled", "false")

    5. After making changes, check the configuration files back in and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes for details.


    Example

    <scheduledTasks>

    <!-- DatabaseRuntimeStats - every hour  -->

    <task name="DatabaseRuntimeStats"           
          description="Actvities Database Statistics Collector Service"
          interval="0 0 * * * ?"           
          startby=""           
          enabled="true"           
          scope="cluster"           
          type="class"
          targetName="com.ibm.openactivities.jobs.DatabaseStatisticsCollectorJobWS"           
          mbeanMethodName=""           
          serverName="unsupported" >
    </task>

    <!-- local scoped jobs -->
    <!-- DailyStats - every day @ 11 am -->

    <task name="DailyStats"           
          description="Activities Daily Statistic Collector Service"
          interval="0 0 11 * * ?"           
          startby=""           
          enabled="true"           
          scope="local"           
          type="class"           
          targetName="com.ibm.openactivities.jobs.StatsPersistJobWS"           
          mbeanMethodName=""           
          serverName="unsupported" >
    </task>

    <!-- 30MinStats - every 30 min  -->
    <task name="30MinStats"           
          description="Activities 30 Minute Statistic Collector Service"
          interval="0 0/30 * * * ?"           
          startby=""           
          enabled="true"           
          scope="local"            
          type="class"
          targetName="com.ibm.openactivities.jobs.StatsPersistJobWS"           
          mbeanMethodName=""           
          serverName="unsupported" >
    </task>

</scheduledTasks>


    Purge the Activities log

    By default, the Activities events log is purged daily at 2 AM. By modifying the EventLogPurgeJob task, you can specify the time that the log is purged and set the properties that define which entries can be deleted. Deleting old events helps maintain performance and keeps the log from becoming too large. Limiting the size of the event log table limits the database storage needed.

    To edit configuration files, use the wsadmin client.

    Customize how the log is purged by specifying the maxNumberOfDeletionPerCall and retentionInDays in the activities configuration file. Use maxNumberOfDeletionPerCall to set the maximum number of entries that are deleted at one time. Use retentionInDays to set how old an entry must be before it can be deleted.

    1. Use the wsadmin client to access and check out the Activities configuration file.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Activities configuration ...

          ActivitiesConfigService.checkOutConfig("working_directory","cell_name")

        ...where...

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, IBM i and Linux: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To determine cell name, run wsadmin command:

            print AdminControl.getCell()

        For example:

        • AIX/Linux:

            ActivitiesConfigService.checkOutConfig("/opt/act/temp","Cell01")

        • IBM i:

            ActivitiesConfigService.checkOutConfig("/act/temp","Cell01")

          Windows:

            ActivitiesConfigService.checkOutConfig("c:/act/temp","Cell01")

    2. Display the current Activities configuration settings.

      Use the command ActivitiesConfigService.showConfig() to display a list of properties. Find the following properties from the EventLogPurgeJob task:

        maxNumberOfDeletionPerCall
        The maximum number of log entries to delete per scheduled call. By default, 1000 entries are deleted each time that a purge runs. If invalid values are entered, the default value is used instead. If this value is blank, the default value is used.

        retentionInDays
        The minimum age of the entries to be deleted. By default, entries older than 365 days are deleted. The minimum value that is allowed for this property is 90 days. If a number less than 90 is entered, then the value that is used is the default of 90 days.

    3. Change the property values with the following command...

        ActivitiesConfigService.updateConfig(property, value)

      For example:

        ActivitiesConfigService.updateConfig("jobs.EventLogPurgeJob.maxNumberOfDeletionPerCall", "2000")
        ActivitiesConfigService.updateConfig("jobs.EventLogPurgeJob.retentionInDays", "365")

    4. Change the time that the task is run by editing the value of the interval attribute. Use the following command...

        ActivitiesConfigService.updateConfig(property, value)

      For example, the following example sets the interval to 0 0 11 * * ?, which runs the purge at 11 AM.

        ActivitiesConfigService.updateConfig("jobs.EventLogPurgeJob.interval", "0 0 11 * * ?")

    5. Before the changes can take effect, check in the configuration file. The configuration file must be checked in in the same wsadmin session in which you checked it out.

      See Applying property changes for details.


    Example

    When you are making these configuration changes, you are modifying settings in the oa-config.xml file.

    The following sample oa-config.xml file segment purges the Activities log 

    <scheduledTasks>
...

<!-- EventLogPurgeJob - every day @ 2 AM -->
        <task name="EventLogPurgeJob" description="Permanently removes Activities Event Log"
              interval="0 0 2 * * ?" startby=""
              enabled="true" scope="cluster" type="class"
              targetName="com.ibm.openactivities.jobs.EventLogPurgeJobWS"
              mbeanMethodName="" serverName="unsupported" >
              <args>

                   <!-- The maximum number of log entries to delete per scheduled call (default 1000). Adjust this as needed. -->
                   <property name="maxNumberOfDeletionPerCall">1000</property>

                   <!-- The number of days that event log entries are retained. 
                        
     For example, only delete entries older than                          
                        now - X days. (default 365)                          
                        Must be equal to or greater than 90. 
                        Values less than 90 it are ignored and 90 is used. -->

                   <property name="retentionInDays">365</property>

              </args>
        </task>
...         <scheduledTasks>

    To prevent the log from being purged, disable this task. If this task is disabled, the log file will keep increasing in size. This size increase might cause the database server to run out of disk space. To disable the log purge, set enabled to false using the following command.

      ActivitiesConfigService.updateConfig("jobs.EventLogPurgeJob.enabled", "false")


    Manage the scheduler

    Use administrative commands to manage scheduled tasks in Activities.

    To run administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    Activities uses the WAS scheduling service for performing regular managed tasks.

    For more information about how the scheduler works, see Scheduling tasks.

    To manage a task:

    1. Start the Activities Jython script interpreter.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    2. Administer the Activities scheduler service.

        ActivitiesScheduler.getTaskDetails(java.lang.String taskName)
        Return information about the scheduled task specified by taskName. Specify one of the following jobs:

        • "30MinStats"
        • "ActivityAutoCompleteJob"
        • "DailyStats"
        • "DatabaseRuntimeStats"
        • "TrashAutoPurgeJob"
        • "EventLogPurgeJob"

        The values returned are server time, next scheduled run time, status (SCHEDULED, RUNNING, SUSPENDED), and task name. When the task has been paused, then the status parameter shows as SUSPENDED instead of SCHEDULED. SUSPENDED means that the task is not scheduled to run.

        For example:

          ActivitiesScheduler.getTaskDetails("TrashAutoPurgeJob")

        The resulting output looks similar to the following:

          currentServerTime=Fri Jan 22 14:13:52 EST 2010, nextFireTime= Fri Jan 22 14:21:00 EST 2010, status=SCHEDULED, taskName=TrashAutoPurgeJob}

        ActivitiesScheduler.pauseSchedulingTask(java.lang.String taskName)
        Temporarily pauses the specified task and stops it from running.

        When you pause a scheduled task, the task remains in the suspended state even after you stop and restart Activities or the IBM WebSphere Application Server. You must run the ActivitiesScheduler.resumeSchedulingTask(String taskName) command to get the task running again.

        If the task is currently running, it continues to run but is not scheduled to run again. If the task is already suspended, this command has no effect.

        For example:

          ActivitiesScheduler.pauseSchedulingTask("TrashAutoPurgeJob")

        When a task is paused, a status message similar to the following is written to the SystemOut.log file:

          [2/10/10 15:28:26:354 EST] 00000659 ActivitiesNot I CLFWY0134I: Activities scheduled task 'TrashAutoPurgeJob' fired event 'TaskNotificationInfo.SUSPENDED'

        When the task is paused successfully, a 1 is returned to the wsadmin client. When the task is not paused successfully, a 0 is returned.

        ActivitiesScheduler.resumeSchedulingTask(java.lang.String taskName)
        If the task is suspended, puts the task in the scheduled state. If the task is not suspended, this command has no effect.

        When a task is resumed, it does not run immediately; it runs at the time when it is next scheduled to run.

        For example:

          ActivitiesScheduler.resumeSchedulingTask("TrashAutoPurgeJob")

        Resuming a paused task causes the following status message to be written to the SystemOut.log file:

          2/10/10 15:49:12:198 EST] 00000633 ActivitiesNot I CLFWY0134I: Activities scheduled task 'TrashAutoPurgeJob' fired event 'TaskNotificationInfo.RESUMED'

        When the task is resumed successfully, a 1 is returned to the wsadmin client. When the task is not resumed successfully, a 0 is returned.


    Related


    Export activities

    Use administrative commands to export activities.

    To transfer standard activity content from one system to another, you can export the activities to an external directory and then import them to the new system. This does not apply to community activities. You can only import community activities to the same deployment from which they were exported.

    See Importing activities for information on importing.

    To run administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    The data associated with the Activities application is stored in more than one place. For standard activities the activities and the member information associated with them are stored in the Activities database tables. For community activities, the activities themselves are stored in the Activities database tables and the member information is stored in the Communities database tables. For both activity types, any file attachments that are added to activities are stored in the content store on the file system. When you run the export process to export activities, it collects the data from all of these locations and stores it in one ZIP file per activity. To export activities:

    1. Start the Activities Jython script interpreter.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        The command in this procedure writes information to a file. If prompted to specify a service to connect to, specify the node where the file to write to is stored.

    2. Use one of the following commands to get a list of activities to export:

      • To get a list of all the activities from the Activities server and save them as a java.util.Vector variable that you can pass to the export command:

          variable=ActivityService.fetchActivities()

        For example:

          allexports=ActivityService.fetchActivities()

      • To filter the activities to export to a subset of activities created within a specific time period:

          variable=ActivityService.fetchActivitiesByDate(java.lang.String dateType, java.lang.String beginTime, java.lang.String endTime, java.lang.String lastUUID)

        For example, to get all of the activities created in September:

          sept=ActivityService.fetchActivitiesByDate("created", "2008.09.01", "2008.09.30", "")

        This command does not return activity templates created during the specified date range, but does include in the activities that it returns any activities present in the Trash view created during the specified date range.

      • To filter the activities to export to a subset based on their members:

        1. Identify the member of interest and save the member information to a variable

            variable=MemberService.fetchMemberByName(java.util.Hashtable member)

          For example:

            john=MemberService.fetchMemberByName("John Smith")

        2. To retrieve a subset of activities created by the member and save it to variable:

            variable=ActivityService.fetchActivitiesCreatedByMember(java.util.Hashtable member)

          For example:

            johnsactivities=ActivityService.fetchActivitiesCreatedByMember(john)

          Alternatively, you can create the following subsets of activities. Note that these commands only return standard activities; they do not return community activities:

          • To get a list of all the standard activities to which the member has access:

              variable=ActivityService.fetchActivitiesByMember(java.util.Hashtable member)

          • To get a list of all the standard activities that the member owns:

              variable=ActivityService.fetchActivitiesByOwner(java.util.Hashtable member)

      • To get a list of community activities to export:

        1. Search by name for the community that owns the activities to export

            ActivitiesMemberService.fetchCommunitiesByName(java.lang.String name)

          For example:

            communities=ActivitiesMemberService.fetchCommunitiesByName("sales")

        2. From the list of communities returned, find the community of interest and make a note of its unique ID.

        3. Pass that unique ID into the following command to write the activities associated with the community to a java.util.Vector variable that you can later pass to the export command:

            ActivityService.fetchActivitiesByCommunityExId(java.lang.String communityUuid)

          For example:

            communityActivitiesToExport=ActivityService.fetchActivitiesBy communityExId( "f29b4e8e-6fad-44f4-9fca-58c46f29c38d")

    3. Export activities...

        ArchiveService.exportActivities(java.lang.String export_directory, java.util.Vector activities)

      ...where...

      • export_directory is the directory path in which you want the activities which are exported as ZIP files to be stored. This directory must exist on the server that you were prompted to provide after running the execfile command to access the activitiesAdmin.py file.

      • activities is the java.util.Vector variable created to define the activities to export.

      For example:

        ArchiveService.exportActivities("c:/ActivitiesExports",allexports)

      or to export only John's activities:

        ArchiveService.exportActivities("c:/ActivitiesExports",johnsactivities)

      or to export only the activities created in September:

        ArchiveService.exportActivities("c:/ActivitiesExports",sept)

      or to export the community activities:

        ArchiveService.exportActivities("c:/ActivitiesExports",communityActivitiesTo export)


    Results

    If the export is successful, one ZIP file is created in the export repository for each activity being exported, and the wsadmin client returns an empty set of brackets. If one of the activities cannot be exported, information about it is returned to the wsadmin client's command line. Refer to the SystemOut.log file to find log messages that are written to it from the export process.


    Related

  • Start wsadmin
  • Get a list of activities


    Import activities

    Use administrative commands to import activities that you exported.

    You can import only activities that you exported from the Activities application.

    See Exporting activities.

    To run administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    1. Start the Activities Jython script interpreter.

      1. Access the Activities configuration file...

          execfile("activitiesAdmin.py")

        The command in this procedure reads information from a file. If prompted to specify a service to connect to, specify the node where the file to read from is stored.

    2. Do one of the following actions:

      • Import the activities that you exported and save them as a java.util.Vector variable:

          variable=ArchiveService.fetchActivities(java.lang.String export_directory)

        ...where export_directory is the file path, including the drive and subdirectory, on the local server where the previously exported ZIP files are located. When specifying a path separator, use the forward slash rather than backslash even on Microsoft Windows systems.

        For example:

          allexports=ArchiveService.fetchActivities("C:/AllExports")

      • Filter the activities that you exported into a subset based on a member:

      1. To identify a subset of activities created by a specific member...

          variable=MemberService.fetchMemberByName(java.util.Hashtable member)

        For example:

          jane=MemberService.fetchMemberByName("Jane Doe")

      2. To retrieve a subset of activities created by the member from the repository of exported activities and save it to variable:

        Do not use these member-based commands to fetch activities that were exported from a different deployment of Connections. These commands use the member ID to find the activities, and member IDs are not persisted across different deployments. Use these commands only to collect activities when you are importing the activities to the same server from which they were exported. If you are importing the activities to a different server, use the ArchiveService.fetchActivities(directory) command instead.

          variable=ArchiveService.fetchActivitiesCreatedByMember(java.lang.string export_directory,java.util.Hashtable member)

        For example:

          janesactivities=ArchiveService.fetchActivitiesCreatedByMember("C:/AllExports",jane)

        Alternatively, you can create the following subsets of activities. Note that these commands only return standard activities; they do not return community activities.

        • To retrieve a subset of standard activities to which a specific member has access from the repository of exported activities and save it to a variable:

            variable=ArchiveService.fetchActivitiesByMember(java.lang.string export_directory,java.util.Hashtable member)

        • To retrieve a subset of standard activities that a specific member owns from the repository of exported activities and save them to a variable:

            variable=ArchiveService.fetchActivitiesByOwner(java.lang.string export_directory,java.util.Hashtable member)

    3. Only perform this step if you want to delete a subset of the activities. You might want to perform this step if an employee has exited the company and you want to remove the activities that she owns from the collection before you import them.

      To delete a set of activities from the collection of exported activities:

        ArchiveService.deleteActivities(java.lang.String export_directory, java.util.Vector subset_of_activities)

      where subset_of_activities is the java.util.Vector variable created to define a subset of activities that you retrieved from the export directory and to permanently delete.

      For example, to remove Jane's activities from the collection of exported activities, you could use the following command:

        ArchiveService.deleteActivities("C:/AllExports",janesactivities)

    4. Use one of the following commands to import the activities:

      For community activities, the community from which the activity was created must exist on the server to which you are importing the activities. If it does not, an error is returned when you attempt to import the activities. The associated community is identified by its communityUUID which is not persisted across different deployments, so you can only include community activities in the activities to be imported when you are importing them to the same server from which they were exported.

      • If you do not want to overwrite any of the activities currently on the server and would rather create an additional copy of an activity if you are importing one that already exists, use this command:

          ArchiveService.createActivities(java.lang.String export_directory, java.util.Vector activities)

        where activities is the java.util.Vector variable created to define the activities that you retrieved from the export directory and to import into the Activities application.

        For example:

          ArchiveService.createActivities("C:/AllExports",allexports)

        or to import only Jane's activities:

          ArchiveService.createActivities("C:/AllExports",janesactivities)

      • Import the activities from the export repository.

        If the activities being imported already exist on the Activities server, the ones on the server will be overwritten during the import.

          ArchiveService.importActivities(java.lang.String export_directory, java.util.Vector activities)

        where activities is the java.util.Vector variable created to define the activities that you retrieved from the export directory and to import into the Activities application.

        For example:

          ArchiveService.importActivities("C:/AllExports",allexports)

        or to import only Jane's activities:

          ArchiveService.importActivities("C:/AllExports",janesactivities)


    Results

    If the import is successful, one activity is created from each ZIP file in the export repository and the wsadmin client returns an empty set of brackets. If one of the activities cannot be imported, information about it is returned to the wsadmin client's command line. Refer to the SystemOut.log file to find log messages that are written to it from the import process.


    Related

  • Start wsadmin


    Administer Blogs

    Administer site-wide settings for Blogs from either the Blogs user interface or via the wsadmin client.

    You can make site-wide changes to Blogs from the Administration link in the Blogs user interface, or via commands using the wsadmin client. Unlike other Connections applications, Blogs does not use an XML file to store configuration settings. Blogs configuration information is stored in, and accessed from, the Blogs application database. As a result, a configuration change is reflected in real-time, and does not require a restart of the Blogs server.

    The following topics describe administering blogs from the UI or from the wsadmin client.


    Administer Blogs from the user interface

    Make site-wide changes on your Blogs server from the Blogs user interface.

    As the Blogs administrator, you can make site-wide changes to the blogs for your organization directly from the Blogs user interface.

    To do so you must browse to the Blog site using a URL similar to: http://BlogServerName/blogs. Once the site opens, login as an Administrative user. After login, click the Administration tab. This page allows you to make site-wide configuration changes.

    From this location you can:

    • Specify settings for the Blogs home page

    • Specify settings for what blog creators can do – for example, whether they can apply custom themes or specify trackback links

    • Administer users.
    • Manage the cache


    Configure an administrator for Blogs

    By default, a wsadmin account is set to administer Blogs. Use this procedure to designate a Blogs administrator that you specify.

    Connections administrators must be dedicated users. Their only purpose should be application administration.

    Only a Blogs administrator can configure a Blogs Homepage blog, which is required for Blogs.

    See Managing the Homepage blog.

    You can also create administrators to managing application content.

    See the topic Administering application content.

    Create administrators in WAS admin console.

    To configure administrative access to an application:

    1. From WAS admin console, select Applications > Application Types > WebSphere enterprise applications.

    2. Find and click the link to the application to configure.

      For example, click Blogs.

    3. Click the Security role to user/group mapping link.

    4. To map a user to the administrative role, select the check box for the admin role and then click Map Users.

    5. In the Search String box, type the name of the person whom you would like to set as an administrator, and then click Search. If the user exists in the LDAP directory, it is found and displayed in the Available list.

    6. Select the name from the Available box, and then move it into the Selected column.

    7. Repeat Steps 4 and 5 to add more users to the administrative role.

    8. Click OK.

    9. From the Enterprise Applications > Blogs > Security role to user/group mapping page, click OK, and then click Save to save the changes.

    10. Synchronize and restart all your WebSphere Application Server instances.


    Manage the Blogs Homepage blog

    The Blogs Homepage blog serves as the main page for your Blogs deployment and has some special considerations.

    When you deploy Blogs, a Blogs Homepage blog with the theme Blogs Homepage theme is created to serve as the entry point for the blogs site. This type of blog is only available to an administrator. You can edit settings for this blog, such as the name or how many entries to display, on the Configuration tab of the Administration page. You can also customize the theme of the Homepage blog to change the look for the blog.

    For example, you can change colors or add a logo to make it more consistent with your organization’s branding elements.


    Specify site-wide setting for Blogs

    Specify site-wide setting for all blogs in your organization.

    Sets you specify for the site control what users are allowed to do when they create or use blogs. You must be logged in as an administrator to change site-wide settings.

    1. From the Blogs home page, click the Administration tab.

      You must be logged in as an administrator to see the Administration tab.

    2. Click the Configuration link.

    3. Modify any of the following settings for the site:


      Site-wide settings for Blogs

      Set Description Default values
      Site name (for Blogs Homepage and feed) Specify the full name for the main page of the site. This name will also be used in feeds. Blogs
      Blog title (shown in site banner) The blog title is displayed in the site banner. Blogs
      Site description (for Blogs Homepage and feed) Enter a description that describes the purpose of the Blogs site. <blank>
      Handle of blog to serve as Blogs Homepage The handle is a short name used in the URL for the Blogs site. The Homepage Blog is created automatically when Blogs is installed. The theme for this blog is Blogs Homepage Theme. You can customize the look of this theme from the Blogs Homepage Theme page. homepage
      Enable active content filtering When enabled, unsafe HTML is removed from Blog posts. Active content filtering does not scan attached files. Be sure to scan files before uploading. Disabling introduces vulnerability to malicious cross-site scripting (XSS) attacks. Enabled
      Automatic save when editing (minutes) This option is to allow automatically save unsaved entries to prevent data loss. For new entries and draft entries, Blogs will save the current content in the editor every # minutes according to this setting.

      Make sure the autosave interval is less than the interval set for user session timeout or you will get an error notification that autosave failed.

      		15
      Number of entries to display in Blogs Homepage This setting controls the maximum number of public blog entries that will be listed on the Blogs Homepage. 25
      Max number of entries to allow per page The maximum number of blog entries that will be listed on the blog site. If there are more than the specified number of entries to display, Previous / Next links are provided on the list for navigation. 50
      Number of entries to provide in newsfeeds The maximum number of feeds that will be available to a feed reader at any given time. 50
      Allow blog comments Allows any authenticated user to post a comment in response to a blog entry. Enabled
      Allow blog trackbacks (Inbound) Allows entries from other blogs to be posted to a blog on this site. Enabled
      Allow blog trackbacks (Outbound) Allows blog entries to be posted as comments in other blogs. Enabled
      Email notification of comments Allows blog entry creators to receive notifications when a new comment has been posted to their entries. Rather than periodically checking their blog for new comments, the entry creator automatically receives an email. If comments for the blog are moderated, an email is sent to the blog entry creator when a new comment is posted. In addition to enabling this setting, mail must also be configured during installation.

      See the Configuring Blogs topic in the Installation section for details on configuring mail service.

      If you enable this application, blog owners can still turn it off for their blogs, but if it is disabled, blog owners do not see an option for email notification of comments.

      		Disabled
      Enable file uploads Allow a blog owner to upload files to be used on their blog. By default, Active Content Filtering scans file attachments that have a HTML, HTM or JS file extension. Be sure to scan files with other file extensions before uploading them. Enabled
      Allowed extensions A comma-separated list of the file types that are allowed to be uploaded. If this field is blank, all file extensions are allowed. Separate extensions with commas. jpg,jpeg,gif,png
      Forbidden extensions A comma separated list of file types that are not allowed to be uploaded. <blank>
      Max file size (MB) Maximum size of an uploaded file. 1.00 MB
      Max directory size (MB) Maximum storage space allocated per blog for uploading files. 4.00 MB
      Allow custom themes There are several templates provided that can be used to set the look of a blog. Allowing blog owners to customize themes lets them modify the templates of an existing theme to create a unique customized theme. We recommend you leave this option disabled. Disabled

    4. After making your changes, click Save to save your settings. You do not need to restart Blogs to see the configuration changes.

    5. To customize the look and layout of your Blogs site, click Blogs Homepage Theme and edit the template files that make up the theme for the Blogs Homepage. You should be comfortable editing HTML files and cascading style sheets (CSS files) to modify a blog theme. For details about how to customize a theme, including a description of the standard theme files, see the topic Customizing a blog theme.


    Manage a community blog

    After you add a blog to a community, you can manage the blog from either the community or from the My Blogs page of the Blogs application. However, you can only manage membership from the community.

    If you are editing the settings for a community blog, you can manage all settings except for membership and theme. If you choose Settings for a community blog, and click the Authors tab, you will be directed back to the community to manage the membership with one of these options:

    • You can change membership for this blog, go to Members page for the community.

    • You can change a member's role, go to the Edit Community form.
    Community blog membership is tied to the community membership, so you must manage it from the community. When you first create a community blog, all members of the community are granted author access by default. Depending on your community, you might want to change the access level for your members. Note that access is always community-wide. Community owners are always blog owners and have full access to post entries as well as to manage the blog and its users. All other community members can have one of the following roles:


    Community blog roles

    Role Description
    Author Allows user to post entries, but not to manage the blog. Users with this role can also edit and delete other users' entries.
    Draft Allows user to save draft entries only.
    Viewer Allows users to read blog posts but not to contribute to the blog.

    In addition to managing access to the community blog, you can also hide blog activity or delete the blog from the community.

    1. To edit basic information about the blog, click Edit from the action menu for the Blogs widget.

      1. Edit any of the basic information about the blog, such as its title or description.

      2. Change whether all community members will have author, draft, or viewer membership.

      3. Choose whether comments will be moderated. Moderated comments are saved into a draft state until you approve them for posting to the blog.

    2. To add or remove a blog member, you need to add or remove that person from the community membership. You can do this on the community's Members page.

    3. To expand the widget content, select Maximize from the action menu. To collapse the widget content, select Minimize from the action menu.

    4. To hide the blog, choose Hide from the action menu and confirm to temporarily remove the blog from the community. When you are ready to resume blog activity, click Customize and add the blog back from the Hidden section of the content palette. All content is restored.

    5. To delete the blog and all of its content, choose Delete from the action menu and confirm to permanently remove the blog.

    6. To refresh the community blog and see all of the latest activity, choose Refresh from the action menu.


    Administer Blogs users

    As the site administrator, you can directly manage a user's blog.

    You can select a user and view or edit their blogs. You have the control to remove objectionable material from your site or make changes to any blog on your site.

    1. From the Blogs home page, click the Administration tab.

    2. Click the Administer Users link.

    3. Type or select a user name and click the Edit button.

    4. Do any of the following:

      • Click a blog name to open the blog.

      • Click New Entry to add an entry to a blog.

      • Click Edit Entries to view and manage entries for the blog.

      • Click Manage to view and edit the settings for the blog or delete blogs.

    5. Click Return to Administer Users when you are done on this page.


    Monitoring the Blogs cache information

    The Blogs cache page is a central place where you can monitor the caches for your site.

    You can view information about the caches or clear the caches for your site.

    1. From the Blogs home page, click the Administration tab.

    2. Click the Cache info link. Information is displayed about each cache.

    3. Click Clear if you want to clear a cache.


    Administer Blogs using the wsadmin client

    As an alternative to modifying the Blogs site settings from the Blogs user interface via the Administration tab, you can also modify settings using the wsadmin client.

    Blogs site-wide configuration information is stored in the Blogs database, rather than in an XML file. Therefore, you do not need to check out (or check in) the Blogs site-wide configuration file because any configuration changes you make are written directly into the database.

    You use the BlogConfigService.showConfig and BlogsConfigService.updateConfig commands to view and make site-wide configuration changes to Blogs configuration settings. Changing a Blogs site-wide configuration setting from the wsadmin command session requires the following procedures:

    1. Start the wsadmin client......

        cd WAS_HOME\profiles\Dmgr01\bin

      where

      For example, on Windows:

        C:\IBM\WebSphere\AppServer\profiles\Dmgr01\bin

      Or, on IBM i:

        qibm/userdata/websphere/appserver/v8/nd/profiles/dmgr/bin

      Run the following command to Start wsadmin from this specific directory because the Jython files for the product are stored here. If you try to start the client from a different directory, then the execfile() command that you subsequently call to initialize the administration environment for an Connections component does not work correctly.

      See the topic Starting the wsadmin client.

    2. Start the Blogs Jython script interpreter:

        execfile("blogsAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. To view the current values of the editable configuration property keys for Blogs and note its output. The following output is a sample; your output may differ. 

      BlogsConfigService.showConfig()

Blogs configuration properties:
    ACFEnabled = true
    CustomThemeAllowed = false
    EditingPollInterval = 15
    InboundTrackBacksEnabled = True
    OutboundTrackBacksEnabled = True
    SiteDescription =
    SiteFrontPageweblogHandle = home     SiteName = Blogs Home     SiteNewsFeedsDefaultEntries = 30
    SitePagesMaxEntries = 30
    SiteShortName = Blogs Home     UploadsDirMaxSize = 4.0
    UploadsEnabled = true
    UploadsFileMaxSize = 1.0
    UploadsTypesAllowed = jpg,jpeg,gif,png,
    UploadsTypesForbid =
    UsersCommentsEmailNotify = true
    UsersCommentsEnabled = true
    UsersModerationRequired = false

    The following tables list the commands available for changing Blogs configuration settings. To change a setting, enter the appropriate property and a new value into the following command:

      BlogsConfigService.updateConfig("[property]", "[value]")

    where:

    • [property] is a valid blogs configuration setting
    • [value] is the new value for the setting.
    Example: wsadmin>BlogsConfigService.updateConfig("EditingPollInterval", "20")

    Configuration updates take effect immediately and do not require a server restart.


    General site properties

    Option Type Description UI Field Equivalent
    SiteName String Update the name of the site (displayed on the front page) Site Name
    SiteShortName String Update the name used for the page tab in browsers Short name
    SiteDescription String Update the site description (used on the front page) Site Description
    SiteFrontPageweblogHandle String Update the handle of the blog home page Handle of blog to serve as frontpage blog
    ACFEnabled String Turns on / off the Active Content Filter (The Active Content Filter removes unsafe HTML from Blog posts that could be used for a XSS attack.) Valid values are: true or false. Enable active content filtering
    EditPollInterval Integer Automatically saves content in the editor when a user is creating an entry or a comment. Set this to the number of minutes between saves. Automatic save when editing (minutes)


    Blog rendering properties

    Option Type Description UI Field
    SitePagesMaxEntries Integer Maximum number of posts that a blog can have on its home page Max number of entries to allow per page
    SiteNewsFeedsDefaultEntries Integer Maximum number of posts that can be in a blogs feed Number of entries to provide in newsfeeds


    Comment and trackback properties

    Option Type Description UI Field
    UsersCommentsEnabled String Turns on and off the ability to add any comments in the site. Valid values are: true or false. Allow blog comments
    TrackBacksEnabled String Turns on and off the ability to add any trackbacks across the site. Valid values are: true or false. Allow blog trackbacks
    UsersCommentsEmailNotify String Whether users can get email notifications when comments are added to their blog. Valid values are: true or false. Email notification of comments
    UsersModerationRequired String Indicates whether comments always require moderation before being added to a blog. Valid values are: true or false. Require comment moderation for all blogs


    Upload capability properties

    Option Type Description UI Field
    UploadsEnabled String If enabled, file uploads are allowed for this site. Valid values are: true or false. Enable File Uploads
    UploadsTypesAllowed String Comma delimited list of allowed file type extensions. Only files with these extensions are allowed to be uploaded Allowed Extensions
    UploadsTypesForbid String Comma delimited list of file type extensions that are not permitted. Files with these extensions are not allowed to be uploaded. Forbidden Extensions
    UploadsFileMaxSize Double Maximum file size that can be uploaded by any user Max File Size (MB)
    UploadsDirMaxSize Double Maximum size of total uploaded file directory for a given blog Max Directory Size (MB)


    Theme property

    Option Type Description UI Field
    CustomThemeAllowed String Determines if custom themes are allowed. Valid values are: true or false. Allow Custom Themes


    Specify an administrator email address for Blogs notifications

    Edit configuration property settings to change the administrator email address for notifications. This is the address used to send system notifications, such as notifications sent to users who have posted inappropriate content.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    By default, automatic notifications are sent from a generic email address, such as blogs-admin@example.com. If Connections is configured so that email addresses are not displayed, you can set a global sender email address for all notification templates, as described in the topic Defining a valid global sender email address. If email addresses are displayed, the global sender is ignored. In either case, you should add a specific administrator email address that has access rights to send mail for several notification templates that are used in the workflows for managing content that is flagged as inappropriate. Some of the messages sent automatically instruct the recipient that they can respond to the administrative user email address from which the notification was sent. If you do not edit the default email address, the recipient gets a delivery failure notification when they try to respond to the automatic email.

    To specify an administrator email address for managing flagged content:

    1. Check out the notification-config.xml file

        LCConfigService.checkOutNotificationConfig("<temp_dir>","<cell_name>")

      where temp_dir is a temporary directory and cell_name is the WAS cell where you installed Blogs.

    2. From the temporary directory to which you checked out notification-config.xml, open it in a text editor.

    3. Search for the <source name="Blogs" string to find the section that defines the notification settings for the Blogs application.

    4. To configure an administrative email address for handling flagged content in a blog, add or change the value of the sender attribute to a legitimate email address in the <type> elements that have the following name attribute values:

      • confirmflagged
      • notifyflagged
      • notifyquarantined
      • notifyedit

      For example: 

      <type name="notifyFlagged" notificationType="MODERATION">
     <channel name="email" enabled="true">
      <property name="sender">moderation-admin@example.com</property>
        <property name="ftl">notifyflagged.ftl</property>
     </channel>
    <channel name="event" enabled="true">
     <property name="eventName">moderation.notification.notifyflagged</property>
     <property name="transformerClass">com.ibm.lotus.connections.core.notify.channels.event.ModerationNotificationEventTransformer</property>
    </channel>
        </type>

    5. Save and close notification-config.xml.

    6. Check in the configuration :

        LCConfigService.checkInNotificationConfig("<temp_dir>", "<cell-name>")

    7. Restart the Blogs server for the changes to take effect.


    Change the blog handle

    Run a command to change your blog handle. The blog handle displays in the URL for your blog.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    1. Start the wsadmin client following the steps in Administering Blogs using the wsadmin Client.

    2. Start the Blogs Jython script interpreter...

        execfile("blogsAdmin.py")

    3. Replace the blog handle...

        BlogsAdminService.renameWeblogHandle("<old_handle>", "<new_handle>")

      where old_handle is the blog handle that need to be replaced, and wherenew_handle is the new handle for the blog.


    Replace URLs in Blogs

    Run a command to replace URLs in your Blogs deployment to correct broken links.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    There are cases where a collection of URLs in a Blogs deployment will break.

    For example, if a user changes from one deployment to another and the host name changes from lc95.cn.ibm.com to lc96.cn.ibm.com, all the URLs that use the form http://lc95.cn.ibm.com/xxx will break. Use this command to update URLs in the following places:

    • Entry and comment content, including the URL for an image source, links to web pages, and video sources.
    • Trackback URLs in comments.
    • Links in the content of an autosaved entry or comment.

    1. Start the wsadmin client following the steps in Administering Blogs using the wsadmin Client.

    2. Start the Blogs Jython script interpreter...

        execfile("blogsAdmin.py")

    3. Run the following command to fix broken URLs in entries and comments...

        BlogsAdminService.fixBrokenUrls(<replacePattern>, <replaceValue>)
      where <replacePattern is the pattern of the part of the URLs that need to be replaced, and wherereplaceValue is the string to correct the URLs.

      For example...

        BlogsAdminService.fixBrokenUrls("http://example.com:9082/blogs", "http://example.com:9080/blogs")
      changes URLs with the form http://example.com:9082/blogs/xxx to http://example.com:9080/blogs/xxx.


    Restore a Community Blog after a Communities database failure

    If the Communities database fails and is restored from a backup, you can restore the Blogs widget and delete any orphaned data.

    When the Communities application experiences a database failure that involves restoring to a backup without replaying the transaction log to the point of failure, the remote data, such as the data associated with a community blog, needs to be restored as well. You can follow a number of steps to ensure a consistent data state for communities and their associated remote applications. You may need to run an admin command to restore community blogs. Restoring a blog will restore the content. If there is any orphaned data, you use another command to delete the orphaned data. The process for recovering remote application data such as a blog after a Communities database failure, is described in the topic Recovering from a database failure.


    Moderate blog content

    Monitor and control the content of blogs using the moderation tools.

    Moderation allows you to review and manage content so that you can approve content before it gets published or you can review published content and remove content you find inappropriate.

    If the Moderation service is installed and enabled, then Blogs are moderated from a central interface, along with content from forums and community files. In that case, the Blogs moderation page is unavailable and notification is disabled. If the Moderation service is not enabled, you can moderate Blogs content from a page in the Blogs interface.


    Who manages moderation?

    As a Connections administrator, you control how moderation is managed. These are the types of users involved in moderation:

    • All users can:

      • Flag published content that is inappropriate
      • Submit content for review.
      • View their own submitted, rejected, or published content.

      • Edit their own published content.

    • Moderators can:

      • Approve or reject submitted content or comments

      • Provide an explanation to the author when rejecting content
      • View and directly edit submitted content or comments

      • Remove published content from the site.
      • Send a message to the author about submitted content or comment

    • Moderators and Content Reviewers can:

      • Dismiss content or comments flagged by end users

      • Provide an explanation to the author when quarantining content
      • View and directly edit published content or comments
      • Quarantine published content so it is no longer available to site users
      • View how many users have flagged a piece of content
      • View the names of users who have flagged a piece of content
      • Sort by update date

    • Administrators can:

      • Enable or disable moderation for content before it is published and after it is published.

      • Assign the moderator role to users so they can moderate content.

      • Set up categories and route which moderators see what flagged content.


    Moderate Blog comments

    Configure content moderation to enforce it at the site level, or leave it as an option for blog owners.

    There are three ways to enable comment moderation.

    • Comment moderation can be forced at the site level so that all comments posted require the blog owner's review and approval before they are posted. When enforced at the site level, the option to enable it is not available to the blog owner.

    • Comment moderation can also be optional by choosing not to force at the site level, and instead allowing each blog owner to select the option to moderate comments posted to their blog. Blog owners can specify comment moderation for the their blog from the My Blogs page by clicking Settings and checking Moderate comments on the page for general settings.

    • You can configure content moderation in the contentreview-config.xml file. If you enable pre-moderation, that is, moderation for content that has not yet been published in the blog, the setting will override both the site-wide and the individual blog settings. To disable comment moderation in this case, you would have to disable the pre-moderation (contentApproval) setting in the contentreview-config.xml file and disable the site-wide setting for comment moderation. For details, see the topic Managing content moderation and flagged content.

    If you are enforcing comment moderation, follow the steps in the topic Specifying an administrator email address for Blogs notification to edit configuration property settings to change the administrator email address. Moderated comment notifications will be addressed from this email address. By default, notifications are sent from a generic email address, such as blogs-admin@example.com. Edit the property to change this to a legitimate administrator email address that has access rights to send mail. Follow these steps to enforce comment moderation at the site level.

    1. Login as Site Administrator and go to the Administration tab.

    2. In the Comment and Trackback Settings section of the Configuration page, check Require comment moderation for all blogs.

    3. Click Save. No restart is required.


    Moderated content states for blogs

    When blog content is moderated, it can be in a variety of states before and after being published.

    The state that content is in dictates where it is in the pre-moderation or post-moderation workflow and controls whether the content is available to users or unavailable because it has not been approved or is in quarantine.


    Content states before publication

    Blog content that requires review and approval before it is published can be in one of the following states:

    • Pending (Require approval): The moderator can approve or reject the content.

    • Active (Published)
    • Rejected


    Content states after publication

    Content that has already been published but requires review, for example, if it was flagged as inappropriate, can be in one of the following states:

    • Awaiting decision: The content is in an active state but it may be flagged for review. The moderator can dismiss flags or quarantine the content.
    • Quarantined: The content is unavailable to end users. The moderator can restore the content or return the content to the author.

    • Returned to Author: (Blog only) Authors can edit and resubmit the content for review.

    • Approved: The content is published.


    Example

    This is an example of how moderation might work for a site where moderation is required and you have assigned a user (ModeratorA) the moderator role.

    • ModeratorA logs into Blogs and navigates to the Moderation page.
    • She navigates to the “Require Approval” page where she sees a list of content submitted by users that need to be reviewed. She sees some spam comments which she selects and deletes.
    • ModeratorA sees a blog entry submission that is unrelated to the purpose of the blog. She suspects that the author may have accidentally posted to the wrong blog. She rejects the content and notifies the author that the submitted post is unrelated to the topic of the blog.

    • There are some new blog posts from regular members that she quickly scans and approves. The approved posts are now published and visible to other users.
    • She finds a blog entry that refers to several internal project code names used within her company. She returns the entry back to the author and asks for the code names to be replaced with the actual product names.
    • Finally, ModeratorA reviews the moderated comments. She finds several comments made by public users that contain inappropriate language, so she deletes them.


    Manage moderated blog entries and comments

    Centrally manage blog entries and comments for a moderated blog before the content is published to a blog, or when the published content is updated.

    If moderation is enabled for Blogs, moderators can review and approve comments and entries from a central location. You can configure who can review and approve content through the J2EE moderator role in the WAS admin console. All users assigned the J2EE moderator role can manage entries and comments for all blogs on the site. You can also configure who can review and approve content with a setting in the contentreview-config.xml file as follows:

    • If ownerModerate=true in contentreview-config.xml, all owners can moderate the blogs they own.

    • If ownerModerate=false in contentreview-config.xml, only users assigned the J2EE moderator role can manage entries and comments for all blogs on the site.

    1. From the Blogs home page, click the Moderation tab.

    2. Click the Entry Approval or the Comment Approval link in the navigation pane to review entries or comments. The following tabbed views let you review and manage content:

      • All displays all entries or comments for the site.
      • Require Approval display entries or comments awaiting your action.
      • Published displays all entries or comments published to a blog.
      • Rejected displays all entries or comments not approved for publishing to a blog.

    3. To filter the list of entries or comments in any of the views, do one of the following and then press Filter.

      • Enter a tag and click the search icon to search for contents associated with that tag.

      • Enter a start and end date to display content entered in that range.

    4. From the Require Approval tab, select one or more item and choose an action:

      • Publish makes the content available in the blog.
      • Reject moves the content to the Rejected state. The blog owner or the author of the entry or comment can edit the content and resubmit for approval.

      • Delete permanently removes the content from the blog.


    Manage flagged content for a blog

    Review published blog content that has been flagged as inappropriate and take action on flagged entries and comments.

    When a blog entry or comment is flagged by a user, it is marked for review and it displays on the Flagged Entries or Flagged Comments page of the Moderation tab. The Flagged Entries and Flagged Comments pages let an authorized moderator view the history and state of flagged entries or comments, and take action on them.

    The workflow described in this topic requires that valid email addresses are configured for the reviewers and that email notifications are enabled for your Blogs deployment.

    When a user flags a blog entry or comment as inappropriate, it sets in motion a workflow for reviewing and resolving the issue. The workflow goes as follows:

    1. Notification is sent to the moderator that an entry or comment has been flagged. The notification includes information about the person flagging the content, a justification for the action, and a link to the entry. The entry or comment is posted to the Flagged Entries or Flagged Comments page in the Moderation interface for viewing and managing flagged content. For Blogs, notification is also sent to the person who flagged the entry that the content is being reviewed.

      There is a setting in the contentreview-config.xml file which determines whether notification is sent to a moderator or content reviewer as following:

      • If issueCategorization is disabled, then notification is sent to all the moderators.

      • If issueCategorization is enabled, then the notification will only be sent to the reviewers defined under each issue category, but if reviewer information is not provided, the notification will still be sent to all the moderators.

    2. The moderator reviews the content and acts on it.

    3. If the reviewer does not think the content is inappropriate, the flag is dismissed and the content remains in the blog. The entry is moved from the Awaiting Decision panel to the Dismissed panel.

    4. If the content is considered inappropriate, the reviewer quarantines the posting, which means it is removed from the blog and placed in a quarantined state. In this case, the author is notified. The posting appears on the Quarantined panel.

    5. A moderator can send entries back to the author to update the content. Entries that have been returned display in the Returned to Author panel.

    6. If the author resubmits the content, it is listed in the Reposted area so the moderator can review the updated content. If the content is acceptable, the reviewer can dismiss the flag so that the content can be published to the blog.

    If Blogs is configured so that email notification is disabled, the automatic notifications used for this workflow are disabled. The following activities would require manual intervention:

    • When an entry is flagged as inappropriate, the reviewers will not receive email indicating there is a potentially offensive posting. Also, the person who flagged the message as inappropriate will not receive a confirmation email that the post they found offensive is being reviewed. Reviewers will have to periodically visit the Flagged Entries or Flagged Comments pages of the Moderation interface to see what entries need action and then manually send confirmation notification messages to the user who flagged the entry.

    • If the reviewer quarantines a blog entry, or returns the entry to the author to be edited, the blog owner will not receive email notifications. The reviewer will have to manually send a notification message to the blog owner.

    If your organization includes people with no email, the automatic notifications used for this workflow are disabled. The following activities would require manual intervention:

    • If a reviewer has no email, when an entry or comment is flagged as inappropriate, the reviewer will not receive email indicating there is a potentially offensive posting. Reviewers will have to periodically visit the Flagged Entries or Flagged Comments pages of the Moderation interface to see what entries need action and then manually send confirmation notification messages to the user who flagged the entry.

    • If the blog owner has no email, and the reviewer quarantines a blog entry, or returns the entry to the author to be edited, the blog owner will not receive email notifications. The reviewer will have to manually send a notification message to the blog owner.

    • If the person who flagged the message as inappropriate has no email, the person will not receive a confirmation email that the post they found offensive is being reviewed.

    Follow these steps to review flagged content and take action.

    1. Click the Moderation tab from Blogs.

    2. Click Flagged Entries or Flagged Comments in the navigation pane. Content awaiting decisions are displayed along with information on who flagged the content and why.
    3. Review a flagged entry and choose one of these actions:

      Option Description
      Quarantine This option turns the post in question to a draft and removes it to a quarantine area so it is not available to blog readers. This option prompts you to send notification to the posting author explaining your reason for removing the post and providing a link so the author can revise the content. If the author revises the content and resubmits it to the blog, that entry appears in the Reposted panel so the reviewer can see it and make sure it is appropriate as revised.
      Dismiss Flag Dismiss the flag. The post remains in the blog.
      Delete Permanently remove the entry or comment.

    4. View content that you have acted on by choosing one of the following tabs:

      • Quarantined

      • Returned to Author (Entries only)
      • Reposted (Entries only)
      • Dismissed
      You can review those posts or move them back into the Awaiting Decision category to take a different action.


    Change the location of the Blogs File Upload directory

    Change default directories for the File Upload directory from the IBM websphere Application Server (WAS) administrator console.

    By default, the File Upload directory is stored in the Connections data directory under Blogs. This variable is stored in WAS variables. You can change the location of the file upload directory by updating WAS variable.

    To change the location:

    1. Launch WAS admin console.

    2. Select Environment > WebSphere variables.

    3. Select BLOGS_CONTENT_DIR from the list of WebSphere variables.

    4. Specify the directory on the server used for file uploads in the Value field and click Apply. This should be a shared drive when deployed in a cluster.

      For example, BLOGS_CONTENT_DIR = C:/IBM/Connections/Data/blogs/upload.

    5. Click OK.

    6. Restart the Blogs server for your changes to take effect.

    If you change the location of the File Upload directory, make sure you copy any content from the default directory to the new location.


    Blogs field limits

    This topic lists character input limits for key Blogs fields.


    Limits

    The field limits are listed for single-byte languages. They will vary for multi-byte languages.

    For example, a field that holds a text string up to 255 characters in a single-byte language might hold a text string up to only 128 characters in a double-byte language. The length may also vary based on the database type.

    For example, the length limit for a blog name is 255 bytes in DB2 and Oracle, and 255 characters in SQL server. The following limits are based on DB2.

    Field Character input limit
    Blog name 255 characters
    Blog handle 30 characters
    Blog description 255 characters
    Entry title 255 characters
    Link name You can enter and store up to 255 characters, but only the first 30 will display in the user interface.
    Link description The first 255 characters entered into the field will be saved.


    Extend the list of allowable file types for blogs

    Extend the list of possible file types that users could upload to a blog.

    When a file is uploaded to a blog, the mime type specified in the content type in the http request header must match a mime type available for the Java Virtual Machine (JVM) so that the correct file extension is applied. By default, the Java Virtual Machine (JVM) supports a default set of mime types that map the most common types of content to the correct file extensions. You can extend the list so that users can upload files of types that are not specified in the default list. After you extend the list you must specify that the file type is allowable as an upload. Follow these steps to extend the list and make a new file type allowable for uploads:

    1. Use a text editor, open the file mime.types in the directory C:\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\t2homdevNode01Cell\Blogs.ear\blogs.war\META-INF. The file only includes comments: 

      # Copyright IBM Corp.  2009  All Rights Reserved.    #

# comments begin with a '#'
# the format is <mime type> <space separated file extensions>
# for example: (without the 
# comment mark)
# text/plain txt text TXT
# this would map file.txt, file.text, and file.TXT to 
# the mime type "text/plain"

    2. Add the mime types you want users to be able to upload.

      For example, to support the upload of Microsoft Excel files, add the mime type application/vnd.ms-excel xls XLS. Blogs would then be able to recognize that file type and assign the XLS file extension.

    3. Save the file and restart the Blogs server.

    4. From the Blogs interface, choose the Administration tab.

    5. On the Configuration page, make sure that Enable File Uploads is enabled.

    6. Add the new file extension to the Allowed Extensions field.

    Your users will now be able to upload files of the type you specified.


    Configure blog hits and visits

    Understand how blog hits and visits are calculated and how you can modify the way each count is done.

    If you are trying to gather data on how many times a blog entry is accessed, you can consider two metrics:

    • Visits count the total number of times a blog entry is accessed, including clicks from another page in the same blog. The visit count displays.
    • Referrer hits also count how many times a blog entry is accessed, but provides more information about where the hits come from. To view referrer hits, choose Settings for a blog, then click Referrers.

    Starting with Connections 3.0, hits and visits are counted the same way. This is a change from the way hits were counted in previous releases. To revert to the old behavior, where referrer hits are not counted if they come from another page in the same blog, modify the roller.properties file as follows:

    1. Edit the roller.properties file from this location: IBM\WebSphere\AppServer\profiles\<profile_name>\installedApps\<cell_name>\Blogs.ear\blogs.war\WEB-INF\classes

    2. Set referrer.ignoreSelfReferer to true.

    3. Save your changes and restart the Blogs server for changes to take effect.

    if you modify roller.properties, the counts for visits and hits will differ.


    Referrer hits

    Referrer hits are divided into:

    • Direct hits with no referrer information available
    • URL hits with referrer information available

    Direct hits increment the hit tally under these circumstances:

    • A blog entry is created

    • A blog or blog entry is accessed via a link from an e-mail message

    • The user enters the blog or blog entry URL directly into a browser

    • The blog or blog entry link is selected from a Web page, but the referring server does not send the referrer information

    • The blog or blog entry is accessed via a link in a feed reader

    • The blog or blog entry is accessed via a link embedded in a bookmark

    URL hits increment the hit tally under these circumstances:

    • A blog or blog entry is selected from within Connections

    • A blog or blog entry is accessed via a link from a Web page that sends referrer information


    Visits

    The count for visits counts the number of times a blog entry is accessed. The count is displayed in the blogs Web UI and is used to measure popularity and other metrics.

    Starting with Connections 3.0, anyone clicking a blog or entry will increase its visit count, even it is the blog author accessing the content. In prior releases, the count was not increased if the click came from the blog or entry author.

    To revert to the previous behavior, where visits are not counted if they come from the author, modify the roller.properties file as follows:

    1. Edit the roller.properties file from this location: IBM\WebSphere\AppServer\profiles\<profile_name>\installedApps\<cell_name>\Blogs.ear\blogs.war\WEB-INF\classes

    2. Set hitcount.ignoreSelfClick to true.

    3. Save your changes and restart the Blogs server for changes to take effect.


    Caching

    The way the blog pages are cached in the browser may contribute to a temporary inaccuracy in the visit count visible in the UI. The visit count is not refreshed until the web page cache expires and the page is reloaded from the application server. Under some circumstance this may require an update to some of the blog content that will cause page to reload.


    Behavior when cache proxy is enabled

    If the user is using a cache proxy and has specified CacheMaxExpire with a specific time period, a page will be served via the cache proxy within this time period without checking the host server. Since the request is not processed by the application server there is no way to count it, so neither the referrer or visit count is incremented.

    Prior to Connections 3.0, the behavior when a cache proxy was in use was as follows: when a request was processed by the application server and the request header contained "If-Modified-Since", the server checked for updates. If there were no updates, a return code of 304/SC_NOT_MODIFIED was issued and the visit count remained the same. This is one case where the referrer count increased, but the visit count did not. This rule can be useful so that when a user keeps refreshing the page without clearing the cache, the visit count is not increased. The exception is the author's own hit where the server returns a 200 code even when there are no new entries. This is actually a flaw that authors can exploit by logging in and refreshing the page to increase the visit count to their own blog entry. In current implement, referrer count and visit count will be increased even in the 304 response case.

    To revert to the previous behavior, modify the roller.properties file as follows:

    1. Edit the roller.properties file from this location: IBM\WebSphere\AppServer\profiles\<profile_name>\installedApps\<cell_name>\Blogs.ear\blogs.war\WEB-INF\classes

    2. If the user does not want the visit count to be increased if page is served from browser side cache (304 not modified), set hitcount.ignore304 to true. The default value of this configuration is false.

    3. If the user does not want referrer counts to be increased if page is served from browser side cache (304 not modified), set referrer.ignore304 to true. The default value of this configuration is false.

    4. Save your changes and restart the Blogs server for changes to take effect.


    Behavior when cache proxy is not enabled

    When cache proxy is not enabled and Ctrl-refresh is used, the request to the server will not include "If-Modified-Since" in the request header. As a result the user will see the visit count increase. This happens because the server will interpret the request as if there is no cache and will issue return code 200 with the latest data.


    Understanding blog likes, comments, and visits

    This topic describes how the Most Liked, Most Commented, and Most Visited statistics are calculated and why the counts may differ between those found in the widgets and those found in the main page.

    If you are viewing either the list of blogs or the list of blog entries from the Public Blogs page, you can view the lists of most liked, most commented, and most visited blogs or entries in sidebar widgets. You can also view these statistics for each blog or entry in the main page. There may be times when the information in the main page does not match the information in the sidebar widgets because of the way each count is calculated.


    Calculating liked, commented, and visited statistics for blog entries

    The statistics for the Most Liked, Most Commented, and Most Visited widgets and the Likes/Votes, Comments, and Visits statistics that display in the main page are calculated in slightly different ways.

    For example, the Most Liked widget displays the most likes in the last 30 days, regardless of when the entry was published. The list of latest entries in the main page only displays entries published in the last 30 days, so the most liked entry in that list may not match the most liked entry in the widget.

    • The Likes/Votes, Comments, and Visits count for an individual entry is calculated as follows:

      • Only those entries that were published within the past 30 days are displayed. You can configure the period for what entries to display by changing the value of the homepage.since property in the roller.properties file.

      • The count displayed under each entry is for overall likes, comments, or visits.

      • You can sort the list of entries by overall likes, comments, or visits.

    • The count for an entry in the Most Liked or Most Commented widget is calculated as follows:

      • Entries display according to how many likes or comments they received in the last 30 days, regardless of when the entries were published. Likes or comments older than 30 days are disregarded.

      • You can configure the period for calculating likes by changing the value of the homepage.mostRecommendedSince property in the roller.properties file.

      • You can configure the period for calculating comments by changing the value of the homepage.mostCommentedSince property in the roller.properties file.

    • The count for an entry in the Most Visited widget is calculated as follows:

      • The visit count is only listed for entries that have been published or updated in the last 30 days.

      • The visit count is a cumulative count, not just visits in the last 30 days.

      • You can configure the period for what entries display by changing the value of the homepage.mostVisitedSince property in the roller.properties file.


    Calculating liked, commented, and visited statistics for blogs

    Just as with blog entries, the blog statistics for the Most Liked, Most Commented, and Most Visited widgets and the corresponding statistics that display in the main page are calculated in slightly different ways.

    For example, the Most Liked widget displays the most likes in the last 30 days, regardless of when the blog was created. The list of blogs in the main page only displays blogs published in the last 30 days, so the most liked blog in that list may not match the most liked blog in the widget.

    • The Liked, Commented, and Visited counts for an individual blog are calculated as follows:

      • All blogs display in the main page, regardless of when they were published.

      • The count displayed for each blog is for overall likes, comments, or visits.

    • The count for blogs in the Most Liked or Most Commented widget is calculated as follows:

      • Blogs display according to how many likes or comments they received in the last 30 days, regardless of when the blogs were published. Likes or comments older than 30 days are disregarded.

      • You can configure the period for calculating likes by changing the value of the homepage.mostRecommendedSince property in the roller.properties file.

      • You can configure the period for calculating comments by changing the value of the homepage.mostCommentedSince property in the roller.properties file.

    • The count for a blog in the Most Visited widget is calculated as follows:

      • The visit count is only listed for blogs that have been published or updated in the last 30 days.

      • The visit count is a cumulative count, not just visits in the last 30 days.

      • You can configure the period for what entries display by changing the value of the homepage.mostVisitedSince property in the roller.properties file.


    The effects of caching on statistics

    The cache and refresh processes can also contribute to a difference in what displays in the Most Liked widget and the likes listed in the main page of blogs or entries. The widget cache is updated every 10 minutes. This interval is not configurable. If there are no new blog entries or new blogs, the Public Blogs page is cached and will not be updated, and the user will see that the counts do not match. This is due to a "if-not-modified" cache control on the Public Blogs page.


    Update a property in the roller.properties file

    Follow these steps to update a property in the roller.properties file:

    1. Edit the roller.properties file from this location: IBM\WebSphere\AppServer\profiles\<profile_name>\installedApps\<cell_name>\Blogs.ear\blogs.war\WEB-INF\classes

    2. Edit the values for the configuration properties you want to change.

    3. Save your changes and restart the Blogs server for changes to take effect.


    Administer Bookmarks

    You configure and administer Bookmarks using scripts accessed using the wsadmin client. Changes to Bookmarks configuration settings require a restart of the Bookmarks server before they take effect. Changes made using administrative commands take effect immediately.

    There are two ways you can update your Bookmarks environment:

    • Configuration settings: These settings control various configurable applications within Bookmarks. They require a server restart to take effect, and they all have the following form: DogearCellConfig.<command_name>(<arguments>) .

    • Administrative commands: These commands control various aspects of the Bookmarks environment and community users. They do not require a server restart to take effect, and they take the following form: <service_name>Service.<command_name, arguments>.

    When you make configuration changes, you use scripts to check out the Bookmarks configuration file, make changes, and then check the file back in.

    When you use administrative commands to control the operation of a Bookmarks server, no file checkout is necessary and your changes take effect immediately.


    Run Bookmarks administrative commands

    Run administrative commands from the wsadmin command line to directly interact with Bookmarks. You do not have to check out files or restart the server for changes to take effect.

    To run administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    Administrative commands require you to start the wsadmin command line processor. From there, you run Jython scripts to administer the Bookmarks application. These config-admin scripts get and set properties using the AdminConfig object (wsadmin) available in WebSphere Application Server to interact with the Bookmarks server. Unlike with configuration properties, when you use administrative commands to change server administration properties, you do not have to check out any files nor restart the server. Your changes take effect immediately.

    When executing the MBean commands, if the command encounters an input that is not valid, such as a missing quote or incorrect file path, the following exception can be returned in the wsadmin console:

      com.ibm.ws.scripting.ScriptingException com.ibm.ws.scripting.ScriptingException: javax.management.RuntimeMBeanException: resetTasks

    To determine what went wrong, you can examine the SystemOut.log file. It should show an exception entered as a result of the Mbean command responsible for the exception.

    To change Bookmarks administrative settings:

    1. Start the wsadmin client

        cd WAS_HOME/profiles/Dmgr01/bin
        ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

    2. Start the Bookmarks Jython script interpreter:

        execfile("dogearAdmin.py")


    Use administrative commands

    The commands described here manipulate managed Java beans (MBeans) to make changes to various operational data on a Bookmarks server.

    To run administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    These commands are tools you can use to control various aspects of the Bookmarks environment and its users. These commands do not require a file check out or a server restart to take effect.

    These commands are case-sensitive and take the following form...

      DogearMemberService.<command_name>(<arguments>)
      LinkService.<command_name>(<arguments>)
      URLService.<command_name>(<arguments>)

    1. To update the Bookmarks database - If there is an LDAP change that requires member IDs in the Bookmarks database to be updated, you must use the DogearMemberService command.

      For example, if users are migrated to a new LDAP or a user is removed and re-entered in the LDAP and their unique identifier changes, these users will not be able to login to Bookmarks until the user record is updated with the DogearMemberService MBean. The following methods are available to make these database changes:

        DogearMemberService.syncAllMembersByExtId(boolean)

        See Synchronize user data using administrative commands for details.

        DogearMemberService.syncMemberByExtId(newExternalID, oldExternalID)

        See Synchronize user data using administrative commands for details.

        DogearMemberService.syncAllMemberExtIds()

        See Synchronize user data using administrative commands for details.

        DogearMemberService.syncMemberExtIdByEmail(emailAddr)

        See Synchronize user data using administrative commands for details.

        DogearMemberService.syncMemberExtIdByLogin(loginName)

        See Synchronize user data using administrative commands for details.

        DogearMemberService.syncBatchMemberExtIdsByEmail(emailFile)

        See Synchronize user data using administrative commands for details.

        DogearMemberService.syncBatchMemberExtIdsByLogin(loginFile)

        See Synchronize user data using administrative commands for details.

    2. To remove offensive content - When you need to delete offensive or unwanted links from the database, you use the LinkService command. You can delete links in two ways - using the UID (which can be obtained by right-clicking on the bookmark, click on "Copy link location" and pasting into a text editor, and then copying the 36 alphanumeric characters (the UID) that occur after "link=") or, alternately, by using the email address of the person that created the link and URL of the link.

        LinkService.deleteLinkByUID('[UID]')

        Delete a single bookmark matching the UID specified.

        [UID] is the UID of the bookmark.

        When creating the text file, enter one UID per line.

        There should be no output in wsadmin console if successful.

        Example...

          LinkService.deleteLinkByUID("0A5G09219578A357F378C607680F7600000B")

        LinkService.deleteLinkByUIDBatch('[fileName]')

        Delete a list of bookmarks matching the UIDs specified.

        [fileName] is the name of a text file containing the uids to be deleted. You must create this text file and save it in a local directory (local to the server where you are running the wsadmin processor).

        There should be no output in wsadmin console. Be sure to check logs as UIDs that were not successfully deleted will be logged.

        Example...

          LinkService.deleteLinkByUIDBatch("/opt/Bookmarks/badlinks.txt")

        LinkService.deleteLinkByPersonURL('[email]', '[href]')

        Delete a single bookmark matching the email and URL specified.

        [email] is the address of the person who created the bookmark.

        [href] is the URL of the bookmark you want to delete. It is important to input the exact href including the protocol.

        There should be no output in the wsadmin console if successful.

        Example:

          LinkService.deleteLinkByPersonURL("jane_doe@acme.com","http://bad.url.com)

        LinkService.deleteLinkByPersonURLBatch('[fileName]')

        Deletes multiple bookmarks matching specified email addresses and URLs.

        [fileName] is the filename containing the addresses and URL to be deleted. You must create this text file and save it in a local directory (local to the server where you are running the wsadmin processor).

        This file must be formatted with [email] <space> [href] on each line.

        For example, a single line would look as follows:

        email@ibm.com http://www.theurl.com

        Note the single whitespace character between the address and the URL.

        [email] is the email address of the person with the bookmark.

        [href] is the URL of the bookmark. It is important to input the exact href including the protocol.

        There should be no output in the wsadmin console. Be sure to check logs as addresses and URLs matching the bookmark that was not successfully deleted will be logged.

        Example:

          LinkService.deleteLinkByPersonURLBatch("c:/Bookmarks/delete.txt")

        LinkService.deleteLinksByURL('[href]')

        Delete all bookmarks (public and private) matching the URL specified. Those bookmarks will be marked as deleted in the database waiting for the search indexer to detect them and update the index.

        [href] is the URL of the bookmark you want to delete. It is important to input the exact href including the protocol.

        There should be no output in the wsadmin console if successful.

        Example:

          LinkService.deleteLinksByURL("http://bad.url.com")

        LinkService.deleteLinksbyURLBatch('[fileName]')

        Deletes multiple bookmarks matching specified URLs.

        [fileName] is the filename containing the URLs to be deleted. Separate URLS with line breaks. You must create this text file and save it in a local directory (local to the server where you are running the wsadmin processor).

        There should be no output in the wsadmin console. Be sure to check logs as bookmarks matching specified URLs that are not successfully deleted will be logged.

        Example:

          LinkService.deleteLinksbyURLBatch("c:/Bookmarks/delete_links.txt")

    3. To manage IP ranges - UrlService commands are used when the internal IP ranges of a company change. These commands operate on the Bookmarks database and can recalculate whether an existing link is internal or not, based on the IP ranges that are updated using the DogearCellConfig.addIpRange or DogearCellConfig.removeIpRange commands.

      Also, it is a good idea to delete the contents of the Favicons subdirectory. The "favicons" that appear next to each Bookmarks link are cached in the favicon directory, and if you delete the contents of this directory, the icons that appear next to each link will be updated.

      After making IP range configuration updates you need to restart Bookmarks for changes to take effect. Then you must run these commands to process URL changes. UrlService commands include:

        UrlService.reprocessIntranetAddress('[href]')

        [href] is exact URL whose intranet range is to be reprocessed .

        Example Usage: UrlService.reprocessIntranetAddress ('http://www.ibm.com')

        There should be no output in wsadmin console if successful.

        UrlService.reprocessIntranetAddressBatch('[fileName]')

        [fileName] is the name of the file containing URLs to be recalculated.

        You must create this text file and save it in a local directory (local to the server where you are running the wsadmin processor).

        This command expects a file with URLs to be recalculated on each line. Enter a single URL on each line of the file.

        There should be no output in wsadmin console. Be sure to check logs as URLs that were not successfully updated will be logged.

        Example: 

        UrlService.reprocessIntranetAddressBatch(/opt/test.txt")

        UrlService.reprocessIntranetAddresses()

        This command should be used if there have been no major changes to the network topology and the only goal is to process an update to the configured intranet IP ranges.

        This command reprocesses the intranet status of all Bookmarks URLs by comparing a locally cached version of its IP address to the intranet IP ranges provided in the Bookmarks cell-level configuration document.

        This command is much quicker than UrlService.recalculateIPAddresses , which not only checks the current intranet settings but also regathers the IP address for every URL in the database.

        There should be no output in wsadmin console. Be sure to check logs as URLs that were not successfully updated will be logged.

        Example: 

        UrlService.reprocessIntranetAddresses()

        UrlService.recalculateIPAddress('[href]')

        [href] is exact URL whose intranet range is to be recalculated.

        Example Usage: 

        UrlService.recalculateIPAddress('http://www.ibm.com')

        If you are only re-validating the intranet status of URLs because of a change to intranet IP tables, then UrlService.reprocessIntranetAddress('[href]') should be invoked.

        There should be no output in wsadmin console if successful.

        Example: 

        UrlService.recalculateIPAddress("http://www.ibm.com")

        UrlService.recalculateIPAddressesBatch('[fileName]')

        [fileName] is the name of the file containing URLs to be recalculated.

        This command expects a file with the URLs to be recalculated on each line. Enter a single URL on each line of the file.

        If you are only re-validating the intranet status of URLs because of a change to intranet IP tables, then UrlService.reprocessIntranetAddressesBatch('[fileName]') should be invoked.

        There should be no output in wsadmin console. Be sure to check logs as URLs that were not successfully updated will be logged.

        Example: 

        UrlService.recalculateIPAddressBatch("c:/Bookmarks/recalc.txt")

        UrlService.recalculateIPAddresses()

        This command recalculates the IP addresses of all the URLs in the database. It works by updating the locally cached copy of the IP address for each URL.

        Run this command can be time consuming for large sized databases. For each URL in the database, this command will connect to and validate the IP address from the DNS. It takes an average of 8 minutes per 500 URLs, depending on the speed of the network connection.

        If you are simply re-validating the intranet status of URLs because of a change to intranet IP tables, use the UrlService.reprocessIntranetAddresses() command to speed the process.

        There should be no output in wsadmin console. Be sure to check logs as URLs that were not successfully updated will be logged.

        Example: 

        UrlService.recalculateIPAddresses()

        UrlService.notifyBrokenURLOwners('<broken_URL>', '<replace_URL>')

        This command will find all owners of a single URL and send them an email notification. To confirm changes made ly, you can supply a <replace_URL> as the suggested substitute URL for the broken URL.

        [broken_URL] is a plain text string that represents the broken URL.

        [replace_URL] is a plain text string that is the suggested substitute URL for the broken URL.

        Example: 

        wsadmin>UrlService.notifyBrokenURLOwners('http://www.example.com','http://w3.example2.com')
        This command will find all users who bookmarked http://www.example.com (either public or private bookmarks) and send them email notifications. In the notification, it will suggest that bookmark owners replace the old URL with the new one http://www.example2.com.

        UrlService.batchNotifyBrokenURLOwners('<repository_file>')

        This command will iterate all the broken URL and substitute URL pairs in the given <repository_file> and send email notifications to all the bookmark owners of the broken URLs in the file. In the notification, you can provide the corresponding <replace_URL> as the suggested substitute URL for the broken URL.

        [repository_file] is a local file path that contains the broken URLs and their suggested substitute URLs. Each pair of original URL and substitute URL should be placed in one line and separated by either white spaces or tabs.

        Example: 

        UrlService.batchNotifyBrokenURLOwners('c:/brokenurls.txt')

        This command will load the URL pairs in c:\brokenurls.txt and send email notifications to users who bookmarked those URLs. For each broken URL, Bookmarks will send an email notification.

        UrlService.replaceURLWithURL('original_URL_str', 'replace_URL_str', 'log_file')
        Specify a single URL and a replacement URL and make an immediate update. Specify the URL to be replaced and a string that specifies the replacement URL.
        Enter a local file path for the log file used log any messages that result from running the command. The file will be created if it does not exist; otherwise, new log data is appended to the data in the existing file.
        The exact match command finds the bookmarks with the specified URL and updates them to the specified replacement URL. The command runs immediately. Example: 

        UrlService.replaceURLs('c:/output.txt', 'c:/log.txt')

        UrlService.findURLsToReplace('<base>', '<URL_pattern>', '<replace_str>', '<output_file>', '<log_file>')
        Use a pattern with wildcards to find and replace multiple URLs. The URLs that match the pattern are written to a file, along with the specified replacement URL. Log messages are printed to c:\log.txt. Once you verify the pairs, you run a second command to upload the file and perform the updates.
        This command scans the Bookmarks database to URLs with associated bookmarks that match the given <URL_pattern> and then calculates the replacement URLs based on the <replace_str>. The command does not update the matched URLs in the Bookmarks. Scan results are saved in <output_file> so you can check the matched URLs and their replacement URLs to verify that the pairs are what you want. If not, you can manually edit the file to add, remove, or update the URL pairs. The command runs as a backend task in the system
        Example: 

        UrlService.findURLsToReplace('mycompany', 'w3/.mycompany/.com', 'www.mycompany.com', 'c:/output.txt', 'c:/log.txt')
        This command scans all URLs containing the string 'mycompany' and matches them against the regular expression pattern "w3/.mycompany/.com". The "w3.mycompany.com" in the matching URLs will be replaced by "www.mycompany.com". The matched URLs and the replacement URLs are printed into c:\output.txt file. Log messages are printed to c:\log.txt.

        UrlService.replaceURLs('<input_file>', '<log_file>')
        Upload a file containing URLs to find and the replacement URLs. Parameters: original_URL_str A plain text string that specifies the URL to be replaced. You can use the output file of the findURLsToReplace command as the input here. URLs are updated unless a bookmark for the replacement URL already exists. Those are skipped to avoid creating duplicate bookmarks. Log messages are printed to c:\log.txt.
        For example: 

        UrlService.replaceURLs('c:/output.txt','c:/log.txt')
        This command loads the URL pairs in the file c:\output.txt and updates all the bookmarks on the specified original URLs to the replacement URLs. Log messages are printed to c:\log.txt.


    Access the Bookmarks configuration file

    To make configuration changes to a Bookmarks deployment you must first access the Bookmarks configuration file.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    Configuration files are XML-formatted files that store configuration information. The file dogear-config-cell.xml stores properties that affect Bookmarks, such as determining thresholds for displaying active tag, person, and link data. Follow these steps to access one of the Bookmarks configuration files:

    1. Start the wsadmin client

        cd WAS_HOME/profiles/Dmgr01/bin
        ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

    2. Start the Bookmarks Jython script interpreter by entering the following command: 

      execfile("dogearAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. To change properties, check out the configuration file, dogear-config-cell.xml, with the following command: 

      DogearCellConfig.checkOutConfig( "<working_directory>", "<cell_name>")
      where:

      • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

        AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

      • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To determine cell name, run wsadmin command: 

        print AdminControl.getCell()

      For example:

      • AIX/Linux: 

        DogearCellConfig.checkOutConfig("/opt/dogear/temp","DogearCell01")

        Windows: 

        DogearCellConfig.checkOutConfig("c:/dogear/temp","DogearCell01")

      • IBM i: 

        DogearCellConfig.checkOutConfig("/dogear/temp","DogearCell01")
      This command should print out this message: Bookmarks Cell Level configuration file successfully checked out.

    4. To view a list of the valid Bookmarks configuration settings and their current values: DogearCellConfig.showConfig()

    5. To change a Dogear configuration setting: DogearCellService .updateConfig("[property]", "[value]") where [property] is one of the editable Dogear properties and [value] is the new value to apply to the property.

      For example: 

      DogearCellService.updateConfig("favIconService.favicon.queuesize", "50")

    After making changes, check the configuration files back in and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

    See Applying property changes for details.


    Bookmarks configuration properties

    Configuration settings control various configurable applications within Bookmarks. They require a Bookmarks application or server restart to take effect.


    Configuration properties

    The following table lists the configuration settings that you can check out and modify for the dogear-config-cell.xml file.

    Configuration property Description
    activeContentFilter.enabled Enables/disables the active content filter for the Rich Text descriptions on bookmarks. The default value is "true" and can be set to "false" if you wish not to filter active content.
    bookmark.openInNewWindow Controls the window behavior when users click on a bookmark. When the value is True, clicking a bookmark will open the URL in a new window. When False, the bookmark opens in the same window.
    brokenURL.notifyAllOwners Turns on or off the display of an option on the broken URL form that allows users to notify all other users who bookmarked a broken link. If the option is enabled, the user is also notified about how many other users will be notified about the broken URL before the notification mail is sent. The default is "False" which means the option is not displayed on the Broken URL form.
    brokenURL.notifyAdmin If set to True, the Bookmarks administrator (defined as the dogear-admin in notification-config.xml) receives a copy of each notification email for a broken link. Set this property to false to suppress the notification.
    favicon.ajaxproxy.intranet.enabled If set to True, Bookmarks will load the intranet bookmark favicons via the AJAX proxy; if set to False it will load bookmark favicons via direct network access.
    favIconService.favicon.directory Determines where the favicon image caches will be stored on the file system. This will be located on the local file system of each node machine.

    Although you can change this setting in the configuration file, the recommended approach is to set this location from the websphere Application Server administrator console.

    For more information, see the topic "Changing the location of the favicon cache or full-text index."

    favIconService.favicon.maxAge Small (fav) icons are displayed to end users next to each bookmark. Bookmarks downloads and caches these icons from the hosts servers for each URL. This setting determines length of time (in days) an icon remains cached locally before an updated copy is retrieved.
    favIconService.favicon.maxSize Small (fav) icons are displayed to end users next to each bookmark. Bookmarks downloads and caches these icons from the hosts servers for each URL. This setting provides a cap (in KB) on the size of the cached icon to control image file size. The default is 6 KB.
    favIconService.favicon.queuesize Starting from Connections 2.5, the request to update the favicon of a specific webpage will be handled by a scheduled task running at the server. Such requests will be put in the task queue and be consumed when the favicon is updated. This setting defines the maximum size of the requests the task queue can contain. When the queue is full, new requests will be discarded until the requests in queue are consumed. The default is 100.
    favIconService.favicon.start Provides the time (in minutes) the favicon task will start after Bookmarks service starts. The default is 5 minutes.
    linkPurgingTask.lpTask.interval Provides the interval (in minutes) of 2 purging task rounds. The default is 60 minutes.
    linkPurgingTask.lpTask.purgeDeleted When a user deletes a bookmark (a link), it will be marked as deleted bookmark. The bookmark record will be kept for a specific period in order to let search indexer to update the index. This setting provides the number of days a deleted bookmark will be kept in Bookmarks database before being purged out. The default is 30 days.
    linkPurgingTask.lpTask.start Provides the time (in minutes) the bookmark purging task will start after Bookmarks service starts. The default is 15 minutes.
    linkThresholds.countInterval.useCountCache When the cache is enabled, it will be updated after being used for specific times. The default is 10.
    linkThresholds.maxInclude.popularLinks Provides a maximum number of links that will get included in the popular link algorithm. If there are more links that are eligible to be included based on the other settings, the algorithm will take the most recent links that fall within this cap. This is to ensure consistent performance over peak times. The default value is 2000 links.
    linkThresholds.minLinkCount.useCountCache The total number of bookmarks showed on the UI will be cached after the total number of bookmarks exceeds a specific number. The default is 100,000.
    linkThresholds.minURLCount.useCountCache The total number of URLs showed on the UI will be cached after the total number of URLs exceeds a specific number. The default is 10,000.
    linkThresholds.sinceWhen.inboxLinks Determines age (in days) a link may be to get included in a user's watchlist. Smaller values will result in better performance. The default is 20 days.
    linkThresholds.sinceWhen.mostvisitedLinks Determines age (in days) a link may be to get included in the Most Visited section. The default is 30 days.
    linkThresholds.sinceWhen.popularLinks Determines the age (in days) a link may be to get included in the popular link algorithm. This value is used in conjunction with the other popular link settings to determine what bookmarks are included on the "Popular" bookmarks tab. Smaller values result in better performance. The default is 30 days.
    personThresholds.maxInclude.activePerson Provides a maximum number of bookmarks (and the associated people) that are included in the active person list algorithm. If more entries are eligible to be included in this calculation based on the other settings, the algorithm will take the people associated with the most recent links that fall within this cap. This is to ensure consistent performance over peak times. The default value is 1500 bookmarks.
    personThresholds.minCount.activePerson Provides a minimum number of bookmarks a user must have within the active time window to be considered for the active person list. People that have less bookmarks than this threshold will not be included in the list on the All and Popular bookmark views. This value is used in conjunction with the other active person threshold settings to determine who is included in the active person list. The default is 5 bookmarks.
    personThresholds.sinceWhen.activePerson Determines age (in days) a bookmark may be to have the associated person included in the active person list on the All and Popular bookmark views. This value is used in conjunction with the other active person threshold settings to determine who is included in the active person list. Smaller values will result in better performance. The default is 30 days.
    tagThresholds.maxInclude.activeTags Provides a maximum number of tags that will get included in the active tag algorithm. If there are more tags that are eligible to be included in this calculation based on the other settings, the algorithm will take the most recent tags that fall within this cap. This is to ensure consistent performance over peak times. The default value is 4000 tags.
    tagThresholds.minCount.activeTags Provides a minimum number of occurrences for a tag within the active time window for it to show in the Active Tag cloud. Tags that occur less than this threshold within the active time window will not show in the Active Tag cloud on the All and Popular bookmark views. This value is used in conjunction with the other active tag threshold settings to determine what is included in the tag cloud. The default is 1 tag.
    tagThresholds.sinceWhen.activeTags Determines age (in days) a link may be to have its tags included in the Active Tag cloud shown on the All and Popular bookmark views. This value is used in conjunction with the other active tag threshold settings to determine what is included in the tag cloud. Smaller values will result in better performance. The default is 30 days.
    useRichTextEditorInBookmarklet Configure the 4-in-1 bookmark form to use a rich text editor for the Description field rather than the plain text editor that is enabled by default.


    Apply property changes

    After you have edited the Bookmarks configuration properties, check the changed configuration file in, and restart the servers to apply the changes.

    Perform the check in in the same wsadmin session in which you checked out the files.

    1. Check in the changed configuration property keys using the following wsadmin client command: 

      DogearCellConfig.checkInConfig( "<working_directory>", "<cell_name>")

    2. Update the value of the version stamp configuration property in LotusConnections-config.xml to force users' browsers to pick up this change

    3. To exit the wsadmin client, type exit at the prompt.

    4. Stop and restart the server hosting the Bookmarks application.


    Filter active content

    The active content filter prevents a user from embedding malicious content in Bookmarks input fields. You configure Bookmarks settings using scripts accessed using the wsadmin client. These scripts use the AdminConfig object available in WebSphere Application Server Admin (wsadmin) to interact with the Bookmarks configuration file. Changes to Bookmarks configuration settings require node synchronization and a restart of the Bookmarks server before they take effect.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    Bookmarks provides a filter that prevents users from using rich text descriptions with malicious scripts that are executed when other users visit bookmarks. You can disable this filter to provide richer options for content in any Bookmarks text input field.

    Disable this filter introduces vulnerability to XSS and other types of malicious attack.

    See Securing applications from malicious attack for additional information.

    1. Start wsadmin

    2. Access the Bookmarks configuration file

    3. To configure the active filter for Bookmarks, set the following property:

      Option Description
      activeContentFilter.enabled Boolean. true/false.

      Enables/disables the active content filter for the Rich Text descriptions on bookmarks. The default value is "true" and can be set to "false" if you wish not to filter active content.

      Disabling the active content filter is not recommended as it will allow end users to create Rich Text Descriptions with malicious scripts that might be executed when other users visit bookmarks.

    4. See Applying property changes for information about how to save and apply your changes.


    Change view and link thresholds

    Use these configuration settings to change view and link thresholds for a Bookmarks deployment.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    You can manage a variety of configuration settings for thresholds for links and tags in a Bookmarks deployment. Most of the settings can be configured by checking out the configuration file, modifying it, and checking it back in.

    1. Access the Bookmarks configuration file

    2. Update the following configuration properties. The keys for changing view thresholds and the values the key can accept are as follows:

      Option Description
      linkPurgingTask.lpTask.interval Integer.

      Provides the interval (in minutes) of 2 purging task rounds. The default is 60 minutes.

      linkPurgingTask.lpTask.purgeDeleted Integer.

      When a user deletes a bookmark (a link), it will be marked as deleted bookmark. The bookmark record will be kept for a specific period in order to let search indexer to update the index. This setting provides the number of days a deleted bookmark will be kept in Bookmarks database before being purged out. The default is 30 days.

      linkPurgingTask.lpTask.start Integer.

      Provides the time (in minutes) the bookmark purging task will start after Bookmarks service starts. The default is 15 minutes.

      linkThresholds.sinceWhen.popularLinks Integer.

      Determines the age (in days) a link may be to get included in the popular link algorithm. This value is used in conjunction with the other popular link settings to determine what bookmarks are included on the "Popular" bookmarks tab. Smaller values result in better performance. The default is 30 days.

      linkThresholds.maxInclude.popularLinks Integer.

      Provides a maximum number of links that will get included in the popular link algorithm. If there are more links that are eligible to be included based on the other settings, the algorithm will take the most recent links that fall within this cap. This is to ensure consistent performance over peak times. The default value is 2000 links.

      linkThresholds.sinceWhen.inboxLinks Integer.

      Determines age (in days) a link may be to get included in a user's watchlist. Smaller values will result in better performance. The default is 20 days.

      linkThresholds.sinceWhen.mostvisitedLinks Integer.

      Determines age (in days) a link may be to get included in the Most Visited section. The default is 30 days.

      linkThresholds.minLinkCount.useCountCache Integer.

      The total number of bookmarks showed on the UI will be cached after the total number of bookmarks exceeds a specific number. The default is 100,000.

      linkThresholds.minURLCount.useCountCache Integer.

      The total number of URLs showed on the UI will be cached after the total number of URLs exceeds a specific number. The default is 10,000.

      linkThresholds.countInterval.useCountCache Integer.

      When the cache is enabled, it will be updated after being used for specific times. The default is 10.

      tagThresholds.sinceWhen.activeTags Integer.

      Determines age (in days) a link may be to have its tags included in the Active Tag cloud shown on the All and Popular bookmark views. This value is used in conjunction with the other active tag threshold settings to determine what is included in the tag cloud. Smaller values will result in better performance. The default is 30 days.

      tagThresholds.minCount.activeTags Integer.

      Provides a minimum number of occurrences for a tag within the active time window for it to show in the Active Tag cloud. Tags that occur less than this threshold within the active time window will not show in the Active Tag cloud on the All and Popular bookmark views. This value is used in conjunction with the other active tag threshold settings to determine what is included in the tag cloud. The default is 1 tag.

      tagThresholds.maxInclude.activeTags Integer.

      Provides a maximum number of tags that will get included in the active tag algorithm. If there are more tags that are eligible to be included in this calculation based on the other settings, the algorithm will take the most recent tags that fall within this cap. This is to ensure consistent performance over peak times. The default value is 4000 tags.

      personThresholds.sinceWhen.activePerson Integer.

      Determines age (in days) a bookmark may be to have the associated person included in the active person list on the All and Popular bookmark views. This value is used in conjunction with the other active person threshold settings to determine who is included in the active person list. Smaller values will result in better performance. The default is 30 days.

      personThresholds.minCount.activePerson Integer.

      Provides a minimum number of bookmarks a user must have within the active time window to be considered for the active person list. People that have less bookmarks than this threshold will not be included in the list on the All and Popular bookmark views. This value is used in conjunction with the other active person threshold settings to determine who is included in the active person list. The default is 5 bookmarks.

      personThresholds.maxInclude.activePerson Integer.

      Provides a maximum number of bookmarks (and the associated people) that are included in the active person list algorithm. If more entries are eligible to be included in this calculation based on the other settings, the algorithm will take the people associated with the most recent links that fall within this cap. This is to ensure consistent performance over peak times. The default value is 1500 bookmarks.

    3. See Applying property changes for information about how to save and apply your changes.


    Configure favicons and changing the default favicon

    Use these settings to configure favicons or replacing the default favicon for a Bookmarks deployment.

    Icons for bookmarks give users a visual guide to different bookmarks. You can manage many of the settings for how bookmark icons display in your deployment.

    Connections supplies a default icon for bookmarks that are not associated with an icon. When you bookmark a page that does not have an icon associated with it, the default icon, default.gif, is placed in the favorite folder where the Bookmarks service is installed.

    For example, C:\Program files\IBM\Connections\Data\dogear\favorite on a Windows installation.

    To customize the default icon for your Connections deployment, replace the default.gif file with the one you want to use. To revert to the default, delete the default.gif file and the Bookmarks service will recreate the default file the next time a default icon is requested.

    To edit configuration files that control configurable settings for bookmark icons, use the wsadmin client.

    See Start wsadmin for details.

    Follow these steps to configure settings for favicons.

    1. Access the Bookmarks configuration file

    2. To update configuration properties enter the appropriate property into the following command: 

      DogearCellConfig.updateConfig(‘[property]', ‘[value]')

      where: [property] is a valid cell-level configuration setting [value] is the new value for the setting.

      For example: wsadmin>DogearCellConfig.updateConfig('favIconService.favicon.maxAge','60') The properties for changing favicons and the values the properties can accept are as follows:

      Option Description
      favIconService.favicon.maxAge Integer.

      Small (fav) icons are displayed to end users next to each bookmark. Bookmarks downloads and caches these icons from the hosts servers for each URL. This setting determines length of time (in days) an icon remains cached locally before an updated copy is retrieved.

      Default is 90 days.

      favIconService.favicon.maxSize Integer.

      Small (fav) icons are displayed to end users next to each bookmark. Bookmarks downloads and caches these icons from the hosts servers for each URL. This setting provides a cap (in KB) on the size of the cached icon to control image file size. The default is 6 KB.

      favIconService.favicon.directory

      String.

      Although you can change this setting in the configuration file, the recommended approach is to set this location from the websphere Application Server administrator console.

      For more information, see the topic "Changing the location of the favicon cache or full-text index."

      Determines where the favicon image caches will be stored on the file system. This will be located on the local file system of each node machine.

      favIconService.favicon.queuesize Integer.

      Starting from Connections 2.5, the request to update the favicon of a specific webpage will be handled by a scheduled task running at the server. Such requests will be put in the task queue and be consumed when the favicon is updated. This setting defines the maximum size of the requests the task queue can contain. When the queue is full, new requests will be discarded until the requests in queue are consumed. The default is 100.

      favIconService.favicon.start Integer.

      Provides the time (in minutes) the favicon task will start after Bookmarks service starts. The default is 5 minutes.

      favicon.ajaxproxy.intranet.enabled Boolean

      If set to True, Bookmarks loads bookmark favicons via the AJAX proxy; if False, favicons are loaded via direct network access.

    3. See Applying property changes for information about how to save and apply your changes.


    Change the location of the favicon cache

    Change the default directory for the favicon cache from the IBM websphere Application Server (WAS) administrator console.

    By default, the favicon cache is stored in the Connections data directory under Bookmarks. The variable is stored in WAS variables. You can change the location of the favicon cache by updating WAS variable. To change the locations:

    Follow these steps to change the default directory of the favicon cache or the full-text index.

    1. Launch WAS admin console.

    2. Select Environment > WebSphere variables.

    3. Select DOGEAR_FAVICON_DIR from the list of WebSphere variables.

    4. Enter a new location for the variable in the Value field and click Apply.

    5. Click OK.

    6. Restart the Bookmarks server for your changes to take effect.


    Determine whether a site is an internet or intranet site

    Establish a URL pattern in a Bookmarks configuration file to indicate whether a site is an internet or an intranet site.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    Enter a URL pattern for your intranet sites in a configuration file to differentiate between internet and intranet sites.

    1. Access the Bookmarks configuration file

    2. Configure the URL pattern for your intranet sites, using the following format: 

      <privateIntranetAllocationTable>
    <ipRange from="8.0.0.0" to="8.247.255.255" />
    <ipRange from="9.0.0.0" to="9.0.255.255" />
    <ipRange from="128.38.0.0" to="128.38.255.255" />
    <ipRange from="131.105.0.0" to="131.105.255.255" />
    <ipRange from="151.125.0.0" to="151.125.255.255" />
    <ipRange from="159.46.0.0" to="159.46.255.255" />
    <urlPattern>http://localhost:.*</urlPattern>      
    <urlPattern>http://.*\.aaabiz\.com.*</urlPattern>
</privateIntranetAllocationTable>

      Use a regular expression to specify each <urlPattern> tag. The regular expression must be a Java RE. You can add multiple <urlPattern> expressions inside <privateIntranetAllocationTable>.

    3. Restart the server.

    4. Use wsadmin commands to update the Bookmarks configuration with the new URL ranges.

      1. Open a command window and start the wsadmin command line tool as described in the topic, Starting the wsadmin client.

      2. Enter the wsadmin command UrlService.recalculateIPAddresses() to update the IP addresses. The exact time depends on the number of URL records in your database. Repeat this update operation each time you edit the URL patterns.


    Denoting sites as intranets

    You can make changes to configuration settings to denote a Bookmarks site as an intranet. Changes to Bookmarks configuration settings require node synchronization and a restart of the Bookmarks server before they take effect.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    Follow these steps to denote a site as an intranet.

    1. Access the Bookmarks configuration file

    2. IP ranges are used to identify bookmarks located on your corporate intranet. As you expand or change your intranet topology, use these settings to incorporate changes into Bookmarks.

      If you had previously configured a value for IntranetAllocation.ipRange, when you run the DogearCellConfig.showConfig() command, one or more IntranetAllocation.ipRange settings will appear.

      For example: 

      privateIntranetAllocationTable from 0.0.00.00 to 0.00.00.1
privateIntranetAllocationTable from 1.1.11.11 to 1.101.0.1
privateIntranetAllocationTable from 2.2.22.20 to 2.202.0.2
privateIntranetAllocationTable from 3.3.33.30 to 3.303.0.3
privateIntranetAllocationTable from 4.4.44.40 to 4.404.0.4

      This represents the various IP ranges of web sites in the corporate intranet. This setting is used to determine if a site is internal or external. Internal sites are represented by an intranet favicon.

      You might need to update this value after initially installing Bookmarks with no IP ranges or if you want to add a range after installation. This might be the case due to a corporate merger or acquisitions that result in added or deleted IP ranges.

      Any change to IP ranges will require an update to the intranet settings of bookmarks in the database.

      See the topic Assigning URLs to intranet sites for more information.

      The following commands allow the administrator to either add or remove ipRanges.

        DogearCellConfig.addIpRange('intranetAllocation.ipRange', ['from_range'], ['to_range'])

        Strings. This command will add an additional IP Range.

        [from_range] = the starting IP address of this range

        [to_range] = the ending IP address of this range

        Example: 

        DogearCellConfig.addIpRange('intranetAllocation.ipRange','2.2.22.20','2.202.0.2')

        DogearCellConfig.removeIpRange('intranetAllocation.ipRange', ['from_range'], ['to_range]')

        Strings. This command will delete an existing IP Range.

        [from_range] = the starting IP address of this range

        [to_range] = the ending IP address of this range

        Example: 

        DogearCellConfig.removeIpRange( 'intranetAllocation.ipRange','2.2.22.20','2.202.0.2')

        DogearCellConfig.clearIpRanges('intranetAllocation.ipRange')

        String.

        Clears all IP ranges recorded in the configuration settings

        Example: 

        DogearCellConfig.clearIpRanges('intranetAllocation.ipRange')

    3. See Applying property changes for information about how to save and apply your changes.


    Assign URLs to intranet sites

    Use the URLService commands to assign URLs to intranet sites for your Bookmarks deployment. These commands do not require a file check out or a server restart to take effect. However, after making IP range configuration updates you need to restart Bookmarks for changes to take effect. Then you must run these commands to process URL changes.

    Use the UrlService commands when the internal IP ranges of your company change. These commands operate on the Bookmarks database and can recalculate whether an existing link is internal or not, based on the IP ranges that are updated using the DogearCellConfig.addIpRange or DogearCellConfig.removeIpRange commands. After making changes, it is a good idea to delete the contents of the Favicons subdirectory. The "favicons" that appear next to each Bookmarks link are cached in the favicon directory, and if you delete the contents of this directory, the icons that appear next to each link will be updated.

    1. See the topic Running Bookmarks administrative commands for information on using administrative commands.

    2. Use the following form for the URLService command: 

      URLService.<command_name>(<arguments>)
    3. UrlService commands include:

        UrlService.reprocessIntranetAddress('[href]')

        [href] is exact URL whose intranet range is to be reprocessed .

        Example Usage: UrlService.reprocessIntranetAddress ('http://www.ibm.com')

        There should be no output in wsadmin console if successful.

        UrlService.reprocessIntranetAddressBatch('[fileName]')

        [fileName] is the name of the file containing URLs to be recalculated.

        You must create this text file and save it in a local directory (local to the server where you are running the wsadmin processor).

        This command expects a file with URLs to be recalculated on each line. Enter a single URL on each line of the file.

        There should be no output in wsadmin console. Be sure to check logs as URLs that were not successfully updated will be logged.

        Example: 

        UrlService.reprocessIntranet AddressBatch(/opt/test.txt")

        UrlService.reprocessIntranetAddresses()

        This command should be used if there have been no major changes to the network topology and the only goal is to process an update to the configured intranet IP ranges.

        This command reprocesses the intranet status of all Bookmarks URLs by comparing a locally cached version of its IP address to the intranet IP ranges provided in the Bookmarks cell-level configuration document.

        This command is much quicker than UrlService.recalculateIPAddresses , which not only checks the current intranet settings but also regathers the IP address for every URL in the database.

        There should be no output in wsadmin console. Be sure to check logs as URLs that were not successfully updated will be logged.

        Example: 

        UrlService.reprocessIntranet Addresses()

        UrlService.recalculateIPAddress('[href]')

        [href] is exact URL whose intranet range is to be recalculated.

        Example Usage: 

        UrlService.recalculateIPAddress('http://www.example.com')

        If you are only re-validating the intranet status of URLs because of a change to intranet IP tables, then UrlService.reprocessIntranetAddress('[href]') should be invoked.

        There should be no output in wsadmin console if successful.

        Example: 

        UrlService.recalculateIPAddress("http://www.example.com")

        UrlService.recalculateIPAddressesBatch('[fileName]')

        [fileName] is the name of the file containing URLs to be recalculated.

        This command expects a file with the URLs to be recalculated on each line. Enter a single URL on each line of the file.

        If you are only re-validating the intranet status of URLs because of a change to intranet IP tables, then UrlService.reprocessIntranetAddressesBatch('[fileName]') should be invoked.

        There should be no output in wsadmin console. Be sure to check logs as URLs that were not successfully updated will be logged.

        Example: 

        UrlService.recalculateIPAddressesBatch("c:/Bookmarks/recalc.txt")

        UrlService.recalculateIPAddresses()

        This command recalculates the IP addresses of all the URLs in the database. It works by updating the locally cached copy of the IP address for each URL.

        Run this command can be time consuming for large sized databases. For each URL in the database, this command will connect to and validate the IP address from the DNS. It takes an average of 8 minutes per 500 URLs, depending on the speed of the network connection.

        If you are simply re-validating the intranet status of URLs because of a change to intranet IP tables, use the UrlService.reprocessIntranetAddress() command to speed the process.

        There should be no output in wsadmin console. Be sure to check logs as URLs that were not successfully updated will be logged.

        Example: 

        UrlService.recalculateIPAddresses()


    Manage links

    As the Bookmarks administrator, you can remove broken or unwanted links, and configure what behavior is available to users for managing broken links.


    Manage notification for broken links

    Configure what behavior is available from the Broken URL form. You configure Bookmarks settings using scripts accessed using the wsadmin client. These scripts use the AdminConfig object available in WebSphere Application Server Admin (wsadmin) to interact with the Bookmarks configuration file. Changes to Bookmarks configuration settings require node synchronization and a restart of the Bookmarks server before they take effect.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    When a user takes action to remove or correct a broken link, they can remove the link from their own bookmarks. You can configure whether the user can notify all other users about the broken link so they can also take action. The default is to enable the option, but, if you are administering a large deployment, you may want to turn this option off to stop notification mail from going to large groups. You can also turn on or off an option that notifies you each time a broken URL notification is sent, giving you the opportunity to correct or remove the link. Again, you may want to disable this option if the mail volume is excessive.

    Disable this filter introduces vulnerability to XSS and other types of malicious attack.

    See Securing applications from malicious attack for additional information.

    1. Start wsadmin

    2. Access the Bookmarks configuration file

    3. To edit a property using the wsadmin client: DogearCellService .updateConfig("property", "value") where property is one of the following properties and value is the new value with which you want to set that property.

        brokenURLService.brokenURL.notifyAllOwners

        Boolean. true/false.

        Enables/disables an option on the Broken URL form to Send notification to all users who bookmarked this so that other users can also take action on a broken URL.

        If the notification option is enabled (True) then, after a user selects the notification option, this notification message displays: Notification will be sent to {x} people. If this option is disabled (False), the option to notify all bookmark owners is not visible and only the current owner of the bookmark is notified.

        brokenURLService.brokenURL.notifyAdmin

        Boolean. true/false.

        Enables/disables an option to notify the Bookmarks administrator each time a Broken URL notification is sent to one or more users.

        If the notification option is disabled, the Bookmarks administrator is not notified of broken links.

    4. See Applying property changes for information about how to save and apply your changes.


    Replace URLs in bookmarks

    Run a command to replace URLs in bookmarks to correct broken links.

    To edit configuration files, use the wsadmin client.

    See Start wsadmin for details.

    There may be times when you want to update the URLs for a collections of bookmarks.

    For example, when a web site changes its host name permanently, you will want to update all of the associated bookmarks with the new host name.

    For example, if http://site1.mycompany.com is changed to be http://site2.mycompany.com, run this replace URL command to update all bookmarks on http://site1.mycomapny.com.

    The new URL may already be bookmarked by some users who also bookmarked the original URL. In those cases, you can not simply update the bookmark to the new URL as the Bookmarks application does not allow a user to have two or more valid bookmarks to the same URL. The IDs of those duplicated bookmarks will be saved to a file that you specify. You can either leave those duplicated bookmarks in the application or run LinkService.deleteLinkByURLBatch('<file>') to delete them from the application.

    When you run this command you can replace URLs in the following ways:

    • Specify a single URL and a replacement URL and make an immediate update.

    • Use a pattern with wildcards to find and replace multiple URLs. The URLs that match the pattern are written to a file, along with the specified replacement URL. Once you verify the pairs, you run a second command to upload the file and perform the updates.
    • Upload a file containing URLs to find and the replacement URLs.

    1. See the topic Running Bookmarks administrative commands for information on using administrative commands.

    2. Use the following form for the UrlService command: 

      UrlService.<command_name>(<parameters>)

    3. Replace an existing URL with a new URL you specify: 

      UrlService.replaceURLs('original_URL_str', 'replace_URL_str', 'log_file')

      Parameters:

        original_URL_str
        A plain text string that specifies the URL to be replaced

        replace_URL_str
        A plain text string that specifies the replacement URL

        log_file
        A local file path used log any messages that result from running the command. The file will be created if it is not exist; otherwise, new log data is appended to the data in the existing file.

      The exact match command finds the bookmarks with the specified URL and updates them to the specified replacement URL. The command runs immediately.

      Example: 

      wsadmin>UrlService.replaceURLs('http://www.mysite.com', 'http://www.mycompany.com', 'c:\\log.txt')
      This command searches for the URL ’http://www.mysite.com’ and replaces each instance with ’http://www.mycompany.com’. Log messages are printed to c:\log.txt.

    4. To find URLs to replace and write them to a file, enter this command: 

      UrlService.findURLsToReplace('<base>', '<URL_pattern>', '<replace_str>', '<output_file>', '<log_file>')

      Parameters:

        base
        Aplain text string used limit the number of URLs to be scanned. Only those URLs containing <base> string are scanned.

        URL_pattern
        AJava-style regular expression used match URLs

        replace_str
        Plain text string used replace the found pattern in the matched URL

        output_file
        Local file path used to store the matched URLs and their replacement URLs. The file will be created if it does not exist and will be appended if it already exists.

        log_file
        Local file path used log any messages that result from running the command. The file will be created if it does not exist; otherwise, new log data is appended to the data in the existing file.

      This command scans the Bookmarks database to URLs with associated bookmarks that match the given <URL_pattern> and then calculates the replacement URLs based on the <replace_str>. The command does not update the matched URLs in the Bookmarks. Scan results are saved in <output_file> so you can check the matched URLs and their replacement URLs to verify that the pairs are what you want. If not, you can manually edit the file to add, remove, or update the URL pairs. The command runs as a backend task in the system

      Example: 

      wsadmin>UrlService.findURLsToReplace('mycompany', 'w3\\.mycompany\\.com', 'www.mycompany.com', 'c:\\output.txt', 'c:\\log.txt')

      This command scans all URLs containing the string 'mycompany' and matches them against the regular expression pattern "w3\\.mycompany\\.com". The "w3.mycompany.com" in the matching URLs will be replaced by "www.mycompany.com". The matched URLs and the replacement URLs are printed into c:\output.txt file. Log messages are printed to c:\log.txt.

    5. To replace the URLs based on the contents of a file, enter this command: 

      UrlService.replaceURLs('<input_file>', '<log_file>')

      Parameters:

        input_file
        A text file that specifies pairs of the URL to be replaced and the replacement URL.

        log_file
        A local file path used log any messages that result from running the command. The file will be created if it does not exist; otherwise, new log data is appended to the data in the existing file.

      Specify an input file which contains the original URLs and the replacement URLs. You can use the output file of the findURLsToReplace command as the input here. URLs are updated unless a bookmark for the replacement URL already exists. Those are skipped to avoid creating duplicate bookmarks. Log messages are printed to c:\log.txt.

      Example: 

      wsadmin>UrlService.replaceURLs('c:\\output.txt', 'c:\\log.txt')
      This command loads the URL pairs in the file c:\output.txt and updates all the bookmarks on the specified original URLs to the replacement URLs. Log messages are printed to c:\log.txt.


    Delete unnecessary links

    Use these commands to delete unnecessary links for your Bookmarks deployment – for example, to remove offensive content. These commands do not require a file check out or a server restart to take effect.

    Use the LinkService command to remove links from a Bookmarks database. You can delete links in these ways:

    • Provide the link UID (which you can obtain by right-clicking on the bookmark, clicking "Copy link location" and pasting into a text editor, and then copying the 36 alphanumeric characters (the UID) that occur after "link=").

    • Provide the email address of the person that created the link and URL of the link.

    • Provide a single URL or a text file containing multiple URLs to delete all links associated with the specified URLs.

    Before you delete links, you can send a notification email to bookmark owners to let them know when the link will be deleted.

    1. See the topic Running Bookmarks administrative commands for information on using administrative commands.

    2. Use the following form for the LinkService command: 

      LinkService.<command_name>(<arguments>)

    3. You can delete links in two ways - using the UID (which you can obtain by right-clicking on the bookmark, clicking "Copy link location" and pasting into a text editor, and then copying the 36 alphanumeric characters (the UID) that occur after "link=") or, alternately, by using the email address of the person that created the link and URL of the link.

        LinkService.deleteLinkByUID('[UID]')

        Delete a single bookmark matching the UID specified.

        [UID] is the UID of the bookmark.

        When creating the text file, enter one UID per line.

        There should be no output in wsadmin console if successful.

        Example: 

        LinkService.deleteLinkByUID("0A5G09219578A357F378C607680F7600000B")

        LinkService.deleteLinkByUIDBatch('[fileName]')

        Delete a list of bookmarks matching the UIDs specified.

        [fileName] is the name of a text file containing the UIDs to be deleted. You must create this text file and save it in a local directory (local to the server where you are running the wsadmin processor).

        There should be no output in wsadmin console. Be sure to check logs as UIDs that were not successfully deleted will be logged.

        Example: 

        LinkService.deleteLinkByUIDBatch("/opt/Bookmarks/badlinks.txt")

        If you are using DB2 as your database, you can create the batch file for deleting all of the bookmarks associated with a user this way:

        1. Open the DB2 Control Center.

        2. From the command editor, connect to the Bookmarks database.
        3. Get the user's person ID from the person table: select person_id from dogear.person where email='someEmail@company.com'
        4. Get the user's bookmark link IDs: select link_id from dogear.link where person='personId'
        5. Based on the results returned, highlight a group of bookmark links. We suggest 100 to 200 links at a time.

        6. Click on Selected and Export.

        7. Make sure the option No character delimiter is selected and export to a text file on your file system

        8. Run the LinkService.deleteLinkByUIDBatch command with the file created.

        LinkService.deleteLinkByPersonURL('[email]', '[href]')

        Delete a single bookmark matching the email and URL specified.

        [email] is the address of the person who created the bookmark.

        [href] is the URL of the bookmark you want to delete. It is important to input the exact href including the protocol.

        There should be no output in the wsadmin console if successful.

        Example: 

        LinkService.deleteLinkByPersonURL("jane_doe@acme.com","http://bad.url.com")

        LinkService.deleteLinkByPersonURLBatch('[fileName]')

        Deletes multiple bookmarks matching specified email addresses and URLs.

        [fileName] is the filename containing the addresses and URL to be deleted. You must create this text file and save it in a local directory (local to the server where you are running the wsadmin processor).

        This file must be formatted with [email] <space> [href] on each line.

        For example, a single line would look as follows:

        email@ibm.com http://www.theurl.com Note the single whitespace character between the address and the URL.

        [email] is the email address of the person with the bookmark.

        [href] is the URL of the bookmark. It is important to input the exact href including the protocol.

        There should be no output in the wsadmin console. Be sure to check logs as addresses and URLs matching the bookmark that was not successfully deleted will be logged.

        Example: 

        LinkService.deleteLinkByPersonURLBatch("c:/Bookmarks/delete.txt")

        LinkService.deleteLinksByURL('[href]')

        Delete all bookmarks (public and private) matching the URL specified. Those bookmarks will be marked as deleted in the database waiting for the search indexer to detect them and update the index.

        [href] is the URL of the bookmark you want to delete. It is important to input the exact href including the protocol.

        There should be no output in the wsadmin console if successful.

        Example: 

        LinkService.deleteLinksByURL("http://bad.url.com")

        LinkService.deleteLinksByURLBatch('[fileName]')

        Deletes multiple bookmarks matching specified URLs.

        [fileName] is the filename containing the URLs to be deleted. Separate URLS with line breaks. You must create this text file and save it in a local directory (local to the server where you are running the wsadmin processor).

        There should be no output in the wsadmin console. Be sure to check logs as bookmarks matching specified URLs that are not successfully deleted will be logged.

        Example: 

        LinkService.deleteLinksByURLBatch("c:/Bookmarks/delete_links.txt")

        UrlService.notifyBrokenURLOwners('<broken_URL>', '<replace_URL>')

        This command will find all owners of a single URL and send them an email notification. To confirm changes made ly, you can supply a <replace_URL> as the suggested substitute URL for the broken URL.

        [broken_URL] is a plain text string that represents the broken URL.

        [replace_URL] is a plain text string that is the suggested substitute URL for the broken URL.

        Example: 

        UrlService.notifyBrokenURLOwners('http://www.example.com','http://w3.example2.com')
        This command will find all users who bookmarked http://www.example.com (either public or private bookmarks) and send them email notifications. In the notification, it will suggest that bookmark owners replace the old URL with the new one http://www.example2.com.

        UrlService.batchNotifyBrokenURLOwners('<repository_file>')

        This command will iterate all the broken URL and substitute URL pairs in the given <repository_file> and send email notifications to all the bookmark owners of the broken URLs in the file. In the notification, you can provide the corresponding <replace_URL> as the suggested substitute URL for the broken URL.

        [repository_file] is a local file path that contains the broken URLs and their suggested substitute URLs. Each pair of original URL and substitute URL should be placed in one line and separated by either white spaces or tabs.

        Example: 

        UrlService.batchNotifyBrokenURLOwners('c:\\brokenurls.txt')

        This command will load the URL pairs in c:\brokenurls.txt and send email notifications to users who bookmarked those URLs. For each broken URL, Bookmarks will send an email notification.


    Restrict link redirects

    You can restrict link redirects to allow users to directly access URLs. This is an optional configuration change.

    To restrict link redirects check out LotusConnections-config.xml, open it in an editor and add some elements, and then check it back in.

    Restriction: If you implement this configuration change, links to external sites will be direct, rather than be redirected from Bookmarks, but links within Connections will not work.

    1. Start wsadmin:

        cd WAS_HOME/profiles/Dmgr01/bin
        ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

    2. Use the wsadmin client to access and check out the Connections configuration files:

      1. Access the Connections configuration file: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out the Connections configuration files:

        LCConfigService.checkOutConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command does not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To get cell name, from wsadmin:print AdminControl.getCell()

        For example:

        • AIX or Linux:LCConfigService.checkOutConfig("/opt/temp","Cell01")

          Windows:LCConfigService.checkOutConfig("c:/temp","Cell01")

        • IBM i:

          LCConfigService.checkOutConfig("/temp","Cell01")

    3. Open LotusConnections-config.xml in an editor, and then add the following content: 

      <properties>
     <genericProperty name="dogear.link.noredirect">true</genericProperty>
</properties>

    4. Open LotusConnections-config.xml in a web browser to make sure you did not introduce any errors. XML files that are well formed display in a web browser; if there are errors, the web browser reports that an error was encountered. Fix an errors before proceeding.

    5. Check the configuration files back in in the same wsadmin session in which you checked them out.

      1. Update the value of the version stamp configuration property to force users' browsers to pick up this change.

        Increment the value of the versionStamp property:

          LCConfigService.updateConfig("versionStamp","gmt_timestamp")

        Where gmt_timestamp is the GMT time. You can specify an empty string for the time stamp or provide a GMT value string. When you specify an empty string, the client calculates the current GMT time and updates the version stamp with that value. If you choose to provide the time, specify it using the following format:

          yyyyMMdd.HHmmss

        ...specify the time in GMT. It is best to provide an empty string and let the client format the time stamp.

        For example:

        LCConfigService.updateConfig("versionStamp","")

      2. To check in the changed configuration property files:

          LCConfigService.checkInConfig()

      3. After making updates, deploy the changes:

          synchAllNodes()

    6. Stop and restart all of the Connections application servers.


    Specify a list of fonts and colors users can use for bookmark lists

    To limit the allowable fonts users can use when embedding bookmarks in a web page to to a list you specify, create a white list. If a white list is enabled, only the fonts specified can be used to display a list of bookmarks in a web page.

    To create a white list for fonts and colors, edit the embedStyle property in the dogear-config-cell.xml file.

    To edit configuration files that control configurable settings for bookmark icons, use the wsadmin client.

    See Start wsadmin for details.

    1. Access the Bookmarks configuration file

    2. To update configuration properties enter the appropriate property into the following command:

        DogearCellConfig.updateConfig(‘[property]', ‘[value]')

      where: [property] is a valid cell-level configuration setting [value] is the new value for the setting.

    3. Change the value of embedStyle enabled from false to true.

    4. Specify the font families and font colors you want to allow for the bookmark list.

      For example: 

      <!--The embed snippet CSS white list    -->
      <embedStyle enabled="false">
        <!-- font family white list-->
        <stringProperty name="font.familyList">Times,Arial,Times New Roman,Verdana,Helvetica,Geneva</stringProperty>
        <!-- font color white list-->
        <stringProperty name="font.colorList">red,blue,green,yellow,orange,black,white,gold,snow</stringProperty>
      </embedStyle>

    5. Save your changes.

    6. See Applying property changes for information about how to save and apply your changes.


    Results

    Users who embed bookmarks in a web page will be limited to the font families and colors in this list. If a user specifies a font family or color not on the list, the font and color will default to a font and color on the list.


    Manage multiple Bookmark buttons

    If you are creating bookmarks on more than one server, you may have to rename your Bookmarks browser buttons to avoid conflicts.

    When you install an Add Bookmark button to your browser toolbar, it is associated with a particular server.

    To create bookmarks for Bookmarks deployments on more than one server, install an Add Bookmark button for each server. You may find, however, that if you click ButtonA to create a bookmark on ServerA, then click ButtonB to create a bookmark on ServerB, you will create another bookmark for ServerA instead. If this happens, follow these steps to rename the second Add Bookmark button to a unique name.

    1. Right-click the button you want to rename.

    2. Choose properties.

    3. Enter a new name.

    4. Click OK to save the button with the new name.


    Administer Communities

    You configure and administer Communities using scripts accessed using the IBM WebSphere Application Server wsadmin client.

    You can update the Communities environment in two ways:

    • Configuration settings. Modify these settings to control various configurable applications within Communities. When you make configuration changes, you use scripts to check out the Communities configuration file, make changes, and then check the file back in. A server restart is required for your changes to take effect.

    • Administrative commands: Use these commands to control various aspects of the Communities environment and community users. Administrative commands do not require a server restart to take effect.


    Run Communities administrative commands

    Jython scripts are used to administer the Communities application. These scripts allow the administrator to view Communities data and perform administrative tasks for Communities.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    Administrative commands interact with the Communities application and its resources through scripts. These scripts use the AdminControl object available in the IBM WebSphere Application Server wsadmin tool to interact with the Communities server. Each script uses managed Java beans (MBeans) to perform administrative tasks.

    If an error occurs when you are executing the MBean commands, you can examine the SystemOut.log file to determine what went wrong.

    Unlike with configuration properties, when you use administrative commands you do not have to check out any files or restart the server. The commands are executed and take effect immediately.

    To run Communities administrative commands:

    1. Start the wsadmin client:

        cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter

        execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. See Communities administrative commands for a complete list of administrative commands for the Communities application.


    Communities administrative commands

    Use the commands that are listed to administer Communities. No file checkout or server restart is needed when you use these commands. The following sections define the commands used when you work with Communities.

    See also Synchronizing user data using administrative commands for information about how to synchronize user data between the Connections application membership tables and the configured directory for the deployment.


    CommunitiesListService commands

      CommunitiesListService.filterListByApp(List list, String filter)

      Return a new list containing only the communities where the application type matches the regular expression filter. Examples of applications include IBM Lotus Quickr Wiki, and Lotus Quickr Teamspace.

      Depending on how the list is returned, you can filter an application from:

      • All links, when the list is returned by the ManagedAppService.fetchAllLink command.

      • A specific community, when the list is returned by the CommunitiesService.fetchCommByName command.

      • The communities that a specific user is a member or owner of, when the list is returned by the CommunitiesService.fetchCommByMember command.

      The following example gets a list of all the communities that the specified user is a member or owner of, and then gets a list of all the links associated with that user. The filter command then filters that list by the application name specified. A list of communities associated with the specified application is returned. 

      wsadmin>bymember=CommunitiesService.fetchCommByMember("users_email_address")
wsadmin>links=ManagedAppService.fetchLinkByComm(bymember)
wsadmin>CommunitiesListService.filterListByApp(links,"application_name")

      CommunitiesListService.filterListById(List list, String filter)

      Return a new list containing only the communities and subcommunities whose ID matches the regular expression filter.

      For example: 

      wwsadmin>all=CommunitiesService.fetchAllComm()
wsadmin>CommunitiesListService.filterListById(all, "c6a2c680-5933-4efa-9a14-be1723445d30")
      This example returns a list of all the communities and subcommunities and then filters the results by ID to list only the communities and subcommunities where the ID matches the one specified.

      CommunitiesListService.filterListByName(List list, String filter)

      Return a new list containing only the communities and subcommunities whose names match the regular expression filter.

      For example: 

      wsadmin>allComm=CommunitiesService.fetchAllComm()
wsadmin>CommunitiesListService.filterListByName(allComm,"My Community Name")
      This example returns a list of all communities and subcommunities using the fetchAllComm command (command is set to a variable that will be used in the next command) and then filters the results to get the information for a particular community or subcommunity.

      CommunitiesListService.filterListByType(List list, String filter)

      Return a new list containing only the communities and subcommunities whose type (private, public, or publicInviteOnly) matches the regular expression filter.

      For example: 

      wsadmin>commByMember=CommunitiesService.fetchCommByMember("jane_smith@company.com")
wsadmin>CommunitiesListService.filterListByType(commByMember,"publicInviteOnly")
      This example retrieves a list of all the communities and subcommunities for a particular user (in this case Jane Smith) and then filters that list to display all the user's communities and subcommunities that are publicInviteOnly. The fetch command is set to a variable that will be used in the listService command.


    CommunitiesMemberService commands

      CommunitiesMemberService.getMemberExtIdByEmail("email")

      See Synchronize user data using administrative commands for details.

      CommunitiesMemberService.getMemberExtIdByLogin("login")

      See Synchronize user data using administrative commands for details.

      CommunitiesMemberService.inactivateMemberByEmail("email")

      See Synchronize user data using administrative commands for details.

      CommunitiesMemberService.inactivateMemberByExtId("externalID")

      See Synchronize user data using administrative commands for details.

      CommunitiesMemberService.syncAllMembersByExtId( {"updateOnEmailLoginMatch": ["true" | "false"] } )

      See Synchronize user data using administrative commands for details.

      CommunitiesMemberService.syncBatchMemberExtIdsByEmail("emailFile" [, {"allowInactivate ["true" | "false"] } ])

      See Synchronize user data using administrative commands for details.

      CommunitiesMemberService.syncBatchMemberExtIdsByLogin("loginFile" [, {"allowInactivate ["true" | "false"] } ])

      See Synchronize user data using administrative commands for details.

      CommunitiesMemberService.syncMemberByExtId("currentExternalId"[, {"newExtId "id-string" [, "allowExtIdSwap ["true" | "false"] ] } ] )

      See Synchronize user data using administrative commands for details.

      CommunitiesMemberService.syncMemberExtIdByEmail("email" [, { "allowInactivate" : ["true" | "false"] } ])

      See Synchronize user data using administrative commands for details.

      CommunitiesMemberService.syncMemberExtIdByLogin("name" [, { "allowInactivate" : ["true" | "false"] } ])

      See Synchronize user data using administrative commands for details.


    CommunitiesQEventService commands

      CommunitiesQEventService.clearQueuedEventByEventId(String eventId)

      Clears queued life-cycle replay events with the specified event ID, where eventId is a string. The events are removed from the queue and are not processed.

      The return value is the number of events that were cleared.

      For example: 

      CommunitiesQEventService.clearQueuedEventsByEventId("2d93497d-065a-4022ae25-a4b52598d11a")

      CommunitiesQEventService.clearQueuedEventsByRemoteAppDefId(String remoteAppDefId)

      Clears queued life-cycle replay events with the specified associated application ID, where remoteAppDefId is one of the following: Activities, Blog, IdeationBlog, Files, Forum, Wiki, and StatusUpdates. The application IDs are case sensitive and must be entered as indicated in this documentation.

      The return value is the number of events that were cleared.

      For example: 

      CommunitiesQEventService.clearQueuedEventsByRemoteAppDefId("Wiki")

      CommunitiesQEventService.clearQueuedEventsByResourceId(String resourceType, String resourceId)

      Clears queued life-cycle replay events with the specified resource ID, where resourceType and resourceId are both strings. The events are removed from the queue and are not processed.

      The resourceType parameter is always set to "community". The resourceId parameter is a value that can be obtained using one of the CommunitiesQEventService.viewQueuedEvents commands.

      The return value is the number of events that were cleared.

      For example: 

      CommunitiesQEventService.clearQueuedEventsByResourceId("community", "e952cf0c-a86c-4e26-b1e0-f8bf40a75804")

      CommunitiesQEventService.clearQueuedEventsByResourceType(String resourceType)

      Clears queued life-cycle replay events with the specified resource type, where resourceType is a string. The events are removed from the queue and are not processed.

      The resourceType parameter is always "community".

      The return value is the number of events that were cleared.

      For example: 

      CommunitiesQEventService.clearQueuedEventsByResourceType("community")

      CommunitiesQEventService.retryQueuedEventsByRemoteAppDefId(String remoteAppDefId)

      Retries queued life-cycle replay events with the specified associated application ID, where remoteAppDefId is one of the following: Activities, Blog, IdeationBlog, Files, Forum, Wiki, and StatusUpdates. The application IDs are case sensitive and must be entered as indicated in this documentation.

      The return value is either 1 or 0. 1 indicates success; 0 indicates failure.

      For example: 

      CommunitiesQEventService.retryQueuedEventsByRemoteAppDefId("Wiki")

      CommunitiesQEventService.retryQueuedEventsByResourceId(String resourceType, String resourceId)

      Retries queued life-cycle replay events with the specified resource type and resource ID, where resourceType and resourceId are both strings.

      The resourceType parameter is always set to "community". The resourceId parameter is a value that can be obtained using one of the CommunitiesQEventService.viewQueuedEvents commands.

      The return value is either 1 or 0. 1 indicates success; 0 indicates failure.

      For example: 

      CommunitiesQEventService.retryQueuedEventsByResourceId("community", "e952cf0c-a86c-4e26-b1e0-f8bf40a75804")

      CommunitiesQEventService.retryQueuedEventsByResourceType(String resourceType)

      Retries queued life-cycle replay events with the specified resource type, where resourceType is a string. The value of resourceType is always "community".

      The return value is either "retry succeed" or 0. 0 indicates failure.

      For example: 

      CommunitiesQEventService.retryQueuedEventsByResourceType("community")

      CommunitiesQEventService.viewQueuedEventsByRemoteAppDefId(String remoteAppDefId, HashMap lastEvent, int maxRows)

      List the queued life-cycle replay events associated with the specified remote application ID, where:

      • remoteAppDefId is one of the following: Activities, Blog, IdeationBlog, Files, Forum, Wiki, and StatusUpdates. The application IDs are case sensitive and must be entered as indicated in this documentation.
      • lastEvent specifies the last row of the previous batch. This is a HashMap object. To obtain the first batch, specify None.
      • maxRows is the number of rows to be retrieved and viewed with a single command. Use maxRows when there is a large number of rows, 200, for example, to break up both the database reads and the display into batches.

      This command returns a HashMap that is the last viewed row. When there are no more rows, the value None is returned. This makes it straightforward to loop over all rows a few at a time.

      For example:

        CommunitiesQEventService.viewQueuedEventsByRemoteAppDefId("Blog", None, 100)

      To display all queued events of remoteAppDefId type Activities in batches of 10, when there are 200 entries, you might code in Jython:

        lastRow = CommunitiesQEventService.viewQueuedEventsByRemoteAppDefId("Activities", None, 10) while (lastRow != None) lastRow = CommunitiesQEventService. viewQueuedEventsByRemoteAppDefId("Activities", lastRow, 10)

      CommunitiesQEventService.viewQueuedEventsByResourceId(String resourceType, String resourceId, HashMap lastEvent, int maxRows)

      List the queued life-cycle replay events with the specified resource type and resource ID, where:

      • resourceType is the string "community".
      • resourceId is the communityUuid. This is a string.
      • lastEvent is a HashMap object.
      • maxRows is the number of rows to be retrieved and viewed with a single command. Use maxRows when there is a large number of rows, 200, for example, to break up both the database reads and the display into batches.

      This command returns a HashMap, which is the last viewed row. When there are no more rows, the value None is returned. This makes it straightforward to loop over all rows a few at a time.

      For example: 

      CommunitiesQEventService.viewQueuedEventsByResourceId("community", "e952cf0c-a86c-4e26-b1e0-f8bf40a75804", None, 100)

      For example, you might use the following Jython code to display all queued events of resourceType "community" and resourceId b46300c7-7837-4ba3-b26b-3fcf67a75bba, in batches of 10 when there are 200 entries: 

      lastRow = CommunitiesQEventService.viewQueuedEventsByResourceId("community", "b46300c7-7837-4ba3-b26b-3fcf67a75bba", None, 10)
while (lastRow != None)
lastRow = CommunitiesQEventService.viewQueuedEventsByResourceId("community", "b46300c7-7837-4ba3-b26b-3fcf67a75bba", None, 10)

      CommunitiesQEventService.viewQueuedEventsByResourceType(String resourceType, HashMap lastEvent, int maxRows)

      List the queued life-cycle replay events with the specified resource type, where:

      • resourceType is the string "community".
      • lastEvent specifies the last row of the previous batch. This is a HashMap object. To obtain the first batch, specify None.
      • maxRows is the number of rows to be retrieved and viewed with a single command. Use maxRows when there is a large number of rows, 200, for example, to break up both the database reads and the display into batches.

      For example: 

      CommunitiesQEventService.viewQueuedEventsByResourceType("community", None, 100)

      This command returns a HashMap that is the last viewed row. When there are no more rows, the value None is returned. This makes it straightforward to loop over all rows a few rows at a time.

      For example, you might use the following Jython code to display all queued events of resourceType community in batches of 10 when there are 200 events: 

      lastRow = CommunitiesQEventService.viewQueuedEventsByResourceType("community", None, 10)
while (lastRow != None)
lastRow = CommunitiesQEventService.viewQueuedEventsByResourceType("community", lastRow, 10)

      CommunitiesQEventService.viewQueuedEventsSummary()

      Lists a summary of all of the life-cycle replay events that are currently queued for processing.


    CommunitiesRemoteAppService commands

      CommunitiesRemoteAppService.resyncRemoteAppsforCommunity("communityUuid")

      See Synchronize remote application data with the communities database for details.

      CommunitiesRemoteAppService.resyncRemoteAppsForCommunityAndWidget("communityUuid", "widgetDefId")

      See Synchronize remote application data with the communities database for details.

      CommunitiesRemoteAppService.resyncRemoteAppsForAllCommunities("widgetDefId")

      See Synchronize remote application data with the communities database for details.

      CommunitiesRemoteAppService.restartResyncRemoteAppsForAllCommunities("lastCommunityUuid", "widgetDefId")

      See Synchronize remote application data with the communities database for details.


    CommunitiesScheduler commands

      CommunitiesScheduler.getTaskDetails(String taskName)

      Return information about the scheduled task specified by taskName. The task names are LifecycleRetryQueuedEvents and EventLogCleanup.

      The values returned in the HashMap are the next scheduled fire time, server time, status (SCHEDULED, RUNNING, SUSPENDED), and task name. SUSPENDED means that the task is not scheduled to run.

      For example: 

      CommunitiesScheduler.getTaskDetails("LifecycleRetryQueuedEvents")

      CommunitiesScheduler.pauseSchedulingTask(String taskName)

      Puts the task in the suspended state. When you pause a scheduled task, that task remains in the suspended state even after you stop and restart Communities or WAS. The task names are LifecycleRetryQueuedEvents and EventLogCleanup. Run the CommunitiesScheduler.resumeSchedulingTask command to get the scheduled task running again.

      If the task is currently running when you use this command, the task continues to run but is not scheduled to run again. If the task is already suspended, this command has no effect.

      The return value is either 1 or 0. 1 indicates success; 0 indicates failure.

      For example: 

      CommunitiesScheduler.pauseSchedulingTask("LifecycleRetryQueuedEvents")

      CommunitiesScheduler.resumeSchedulingTask(String taskName)

      If the task is suspended, puts the task in the scheduled stated. If the task is not suspended, this command has no effect. The task names are LifecycleRetryQueuedEvents and EventLogCleanup.

      The return value is either 1 or 0. 1 indicates success; 0 indicates failure.

      For example: 

      CommunitiesScheduler.resumeSchedulingTask("LifecycleRetryQueuedEvents")


    CommunitiesService commands

      CommunitiesService.addAlternateOwner(String directoryUuid, String alternateDirectoryUuid, Boolean removeOriginal)

      Adds the user with the specified alternateDirectoryUuid as an owner to every community and subcommunity owned by the user with the specified directoryUuid (external ID).

      Parameters:

        directoryUuid
        A string that specifies the directory UUID (external ID) of an existing community or subcommunity owner.

        alternateDirectoryUuid
        A string that specifies the directory UUID (external ID) of the person who you want to add as the alternate owner.

        removeOriginal
        A Boolean value that determines whether the person specified using the directoryUuid (external ID) parameter is removed from the membership of their communities and subcommunities. When set to true, the user with the specified directoryUuid is removed from their community and subcommunity membership. When set to false, the user with the specified directoryUuid remains listed as an owner of their communities and subcommunities.

      For example:

        CommunitiesService.addAlternateOwner("193F1CE8-E10A-4B9A-B933-C8ECD6C072E4", "EC8A89C0-F41D-102C-9B60-F225BC6C4AF4", "true")

      To obtain the value to use for the directoryUuid and alternateDirectoryUuid parameters, you can use the following command: 

      CommunitiesMemberService.getMemberExtIdByEmail("email_address")

      In following example, for any community (or subcommunity) where Paul Smith is an owner, user Alice Lee is added to the membership list with owner access, and Paul Smith is removed from the membership list: 

      wsadmin>CommunitiesMemberService.getMemberExtIdByEmail("paul_smith@example.com")
510b99c0-0123-1010-8989-f78755f7e0ed
wsadmin>
wsadmin>CommunitiesMemberService.getMemberExtIdByEmail("alice_lee@example.com")
510b99c0-0101-102e-8934-f78755f7e0ed
wsadmin>
wsadmin>CommunitiesService.addAlternateOwner("510b99c0-0123-1010-8989-f78755f7e0ed", "510b99c0-0101-102e-8934-f78755f7e0ed", "true")

      CommunitiesService.addMembersToCommunityByEmail(String communityName, Integer memberRole, List emailAddresses)

      Adds members to an existing community or subcommunity.

      When you use this command to add owners or members to a subcommunity, the users that you are adding must belong to the parent community in order for them to be added to the subcommunity.

      You cannot exceed the maximum number of members limit specified in the explicitMembershipEntityLimit property of the communities-config.xml file.

      See Communities configuration properties.

      You use this command in two steps. First, create a comma-separated list of users (using their email addresses) to add to an existing community or subcommunity and assign this list to a variable. This variable is then used as input into the addMembersToCommunity command.

      Note that communityName is a string and must be enclosed in quotation marks ("). This parameter is case-sensitive, so be sure to specify the name of the community or subcommunity exactly.

      memberRole. Valid settings are 0 (member) or 1 (owner). Do not enclose this setting in quotation marks.

      For example: 

      wsadmin>threemembers=["alex_jones@example.com", "mary_smith@example.com", "paul_henderson@example.com"]
wsadmin>CommunitiesService.addMembersToCommunityByEmail("Ski Club Community",0,threemembers)

      When you use this command, if the community or subcommunity name that you provide as input to the command is not unique, an error similar to the following displays: 

      WASX7015E: Exception running command: "CommunitiesService.addMembersToCommunityByEmail("My community",0,threemembers)"; exception information:
 javax.management.RuntimeMBeanException
java.lang.IllegalArgumentException: java.lang.IllegalArgumentException: CLFRM0091E: Multiple communities found with name: My community
      When you see an error like the previous one, instead of entering the name of the community or subcommunity in the command, you must enter the UUID instead.

      For example: 

      wsadmin>CommunitiesService.addMembersToCommunityByEmail("5742c4c8-0010-4e6e-abdb-65015e8a22e1", 0,threemembers)
      You can obtain the UUID for a community or subcommunity by doing one of the following:

      • Use a browser, open the community or subcommunity that you want and copy the UUID from the URL.

      • Run the CommunitiesService.fetchAllComm() wsadmin command to fetch all communities and subcommunities on the server. Copy the UUID from the output.

      CommunitiesService.addMembersToCommunityByMemberUuid(String communityName, Integer memberRole, List UUID of member)

      Adds members to an existing community or subcommunity. Use this command when you want to add users to a community's membership list, but they don't have an email address. The users that you are adding must belong to the parent community in order for them to be added to the subcommunity.

      The member's UUID is the external LDAP identifier for a specific user. Use one of the following commands to return the user's external ID for use in the previous command:

      • CommunitiesMemberService.getMemberExtIdByEmail("email")
      • CommunitiesMemberService.getMemberExtIdByLogin("login")

      You cannot exceed the maximum number of members limit specified in the explicitMembershipEntityLimit property of the community-config.xml file.

      See Communities configuration properties.

      You use this command in two steps. First, create a comma-separated list of users (using their UUID, the external LDAP ID) to add to an existing community or subcommunity and assign this list to a variable. This variable is then used as input into the addMembersToCommunity command.

      Note that communityName is a string and must be enclosed in quotation marks ("). This parameter is case-sensitive, so be sure to specify the name of the community or subcommunity exactly.

      memberRole: Valid settings are 0 (member) or 1 (owner). Do not enclose this setting in quotation marks.

      For example: 

      wsadmin>onemember=["84b4897d-b4f8-4d95-9621-50bcaa2fd3ca"]
wsadmin>CommunitiesService.addMembersToCommunityByMemberUuid("Ski Club Community",0,onemember)
      The onemember parameter is the extid(user).

      When you use this command, if you get an error telling you that the community or subcommunity name is not unique, instead of entering the name of the community or subcommunity in the command input, enter the UUID instead.

      You can obtain the UUID for a community or subcommunity by doing one of the following:

      • Use a browser, open the community or subcommunity that you want and copy the UUID from the URL.

      • Run the CommunitiesService.fetchAllComm() wsadmin command to fetch all communities and subcommunities on the server. Copy the UUID from the output.

      CommunitiesService.createCommunityWithEmail(String community name, String ownerName, int memberRole, String dsmlFile)

      Creates a public community whose membership list is initialized from a Directory Services Markup Language (DSML) file exported from the LDAP directory.

      The DSML file must be local to the system running the script. The script parses the DSML file and extracts the mail values. These values are used to populate the membership list of the community.

      For more information about how to create DSML files from your LDAP directory, see http://www.dsmltools.org/.

      A typical mail attribute in a DSML file looks like the following: 

      <attr   name="mail">
 <value>john_doe@example.com</value>
</attr>

      The command takes the following parameters:

        communityName
        A string value that specifies the name of the community that you are creating.

        ownerName
        A string value that specifies the name of the new community's owner. Enter the email address of the user who will be the owner of the community.

        memberRole
        An integer that specifies the role of the users added to the new community. This property can be set to 0 to specify the member role or 1 to specify the owner role. Do not enclose this setting in quotation marks.

        dsmlFile
        A string value that specifies that name of the DSML file containing the mail values used to populate the community membership.

      In the following example, a community named AJ's Community is created with Ann Jones as the community owner/creator. The command parses the file /opt/myDSML.xml, looks for each of the mail attributes, and then adds those email addresses to the new community with member access. 

      CommunitiesService.createCommunityWithEmail("AJ's Community", "ann_jones@example.com", 0, "/opt/myDSML.xml")

      This command only creates parent communities; it cannot be used to create subcommunities.

      This command creates a public community by default. To change the visibility of the community, the community owner must edit the community from the user interface and change the access level to moderated or restricted as needed.

      CommunitiesService.createCommunityWithLoginName(String communityName, String ownerName, int memberRole, String dsmlFile)

      Creates a public community whose membership list is initialized from a DSML file exported from the LDAP directory.

      The DSML file must be local to the system running the script. The script parses the DSML XML file and extracts the login name values. These values are used to populate the membership list of the community.

      For more information about how to create DSML files from your LDAP directory, see http://www.dsmltools.org/.

      The command takes the following parameters:

        communityName
        A string value that specifies the name of the community that you are creating.

        ownerName
        A string value that specifies the name of the new community's owner. Enter the loginName of the user who will be the owner of the community.

        memberRole
        An integer that specifies the role of the users added to the new community. This property can be set to 0 to specify the member role or 1 to specify the owner role. Do not enclose this setting in quotation marks.

        dsmlFile
        A string value that specifies the name of the DSML file containing the loginName values used to populate the community membership.

      In the following example, a community named AJ's Community is created with Ann Jones as the community owner/creator. The command parses the file /opt/myDSML.xml and looks for each of the login attributes and adds those login names to the new community with member access. 

      CommunitiesService.createCommunityWithLoginName("AJ's Community", "ann_jones", 0, "/opt/myDSML.xml")
      Notes:

      • This command only creates parent communities; it cannot be used to create subcommunities.
      • This command creates a public community by default. To change the visibility of the community, the community owner must edit the community from the user interface and change the access level to moderated or restricted as needed.

      CommunitiesService.fetchAllComm()

      Return a vector of hash maps of all communities and subcommunities. There is no way to distinguish from the information returned whether the object is a community or subcommunity. Do not run CommunitiesService.fetchAllComm() on large deployments because it loads all communities into memory at once. Instead, run CommunitiesService.fetchBatchComm().

      CommunitiesService.fetchBatchComm(batchSize, priorLastCommunityId)

      Return a portion of an ordered list of UUIDs for all communities. The command does not return any details about the communities. It returns only the UUIDs.

      The command takes the following parameters:

        batchSize
        Uses an integer to indicate how many communities you want returned.

        priorLastCommunityId
        Enter the UUID of the last community enclosed by double quotation marks. If you don't have a community id to enter, use either None or "". If you enter CommunitiesService.fetchBatchComm(5, None), the command returns the GUID for the first five communities.

      The following example fetches a batch of two communities.  None indicates that it starts with the first community. 

      wsadmin>CommunitiesService.fetchBatchComm(2, None)
fetchBatchComm request processed
[3302c2fa-e16f-4a52-8685-b56c1435d742, 3e457e81-c9d9-4a20-a71a-6cc336673fab]

      CommunitiesService.fetchCommById(string communityUUID)

      Return the community or subcommunity with the specified UUID.
      You can obtain the UUID for a community or subcommunity by doing one of the following:

      • Use a browser, open the community or subcommunity that you want and copy the UUID from the URL.

      • Run the CommunitiesService.fetchAllComm() wsadmin command to fetch all communities and subcommunities on the server. Copy the UUID from the output.

      For example: 

      wsadmin>CommunitiesService.fetchCommById("59d8e5a7-ba0e-488f-8bcd-1f79a994e419")
[{createdBy=[Andy Jones, 2BC32FEF-E736-4C81-986C-30780C5EF8C3], lastMod=6/18/09 3:09:02 PM EDT, description= Community of developers working on JAVA projects in our company.  This is a community to share ideas., name=JAVA Developers community, uuid=59d8e5a7-ba0e-488f-8bcd-1f79a994e419, memberSize=6, type=publicInviteOnly, tags=[developers, java], created=6/18/09 3:08:48 PM EDT, lastModBy=[Andy Jones, 2BC32FEF-E736-4C81-986C-30780C5EF8C3]}]
wsadmin>

      CommunitiesService.fetchCommByMemberEmail(String email)

      Return all the communities and subcommunities that the user of the specified email address is a member of. There is no way to distinguish from the information returned whether the object is a community or subcommunity.

      For example: 

      CommunitiesService.fetchCommByMember("john_doe@company.com")

      CommunitiesService.fetchCommByMemberUuid(String uuid)

      Return all the communities and subcommunities that the user with the specified UUID is a member of. There is no way to distinguish from the information returned whether the object is a community or subcommunity.

      For example: 

      CommunitiesService.fetchCommByMemberUuid("193F1CE8-E10A-4B9A-B933-C8ECD6C072E4")

      The Member's UUID is the External LDAP identifier for a specific user. Use one of the following commands to return the user's external ID for use in this command.

      • CommunitiesMemberService.getMemberExtIdByEmail("email")
      • CommunitiesMemberService.getMemberExtIdByLogin("login")

      CommunitiesService.fetchCommByName(String name)

      Return the community or subcommunity with the specified name.

      There is a maximum of one community in the list, but that list can be used in the other methods that use a list input. If no match is found, the list will be empty.

      For example: 

      wsadmin>CommunitiesService.fetchCommByName("Test Community")

      If the name of the community or subcommunity that you enter in this command is not unique, the command fails with an error. If the command fails, use the following command instead: 

      CommunitiesService.fetchCommById(string communityUUID)

      CommunitiesService.fetchMember(List list)

      Return the input list of communities or subcommunities with an additional property for each community that is the member list for that community.

      This command is run in two steps. First, generate a list of data to input into the fetchMember command and assign the list to a variable. The variable is then used as input into the fetchMember command.

      For example: 

      wsadmin>allComm=CommunitiesService.fetchCommByName("Test Community")
wsadmin>CommunitiesService.fetchMember(allComm)

      CommunitiesService.fetchReference(List list)

      Adds references (feeds and bookmarks) to communities or subcommunities in the list passed into this command and returns a new list with references.

      This command is run in two steps. First, use the fetchCommByName command to gather the list of communities and assign the list to a variable. The variable is then used as input into the fetchReference command.

      For example: 

      wsadmin>allComm=CommunitiesService.fetchCommByName("Test Community")
wsadmin>CommunitiesService.fetchReference(allComm)

      The results that are returned include any feeds or bookmarks for a community or subcommunity. The name that the user enters when creating the feed or bookmark is also displayed as part of the reference information.

      For example: reference=[[Cooking, http://www.cuisineathome.com]]

      Here are sample results from running the command: 

      {createdBy=alex_jones@MyCompany.com, lastMod=2/22/08  8:43:48 AM EST, description=Community with one bookmark one feed,  name=Jones Community, uuid=3395f15e-bde7-4151-80ed-ed538d12d00e,  memberSize=2, reference=[[CNN, http://www.cnn.com], [Ghirardelli  Chocolate, http://www.ghirardelli.com]], type=publicInviteOnly,  tags=[chocolate], created=2/22/08 8:42:53 AM EST, lastModBy=
bsmith@MyCompany.com}

      CommunitiesService.listComm(List list)

      Prints the information associated with the communities or subcommunities in the list input to the wsadmin command window in an easy-to-read format. The data printed includes community name, UUID, type, who created it, creation date, last person who modified it, date of last modification, membership list size, and description. If the list includes members, then this command also prints the membership list. If the list includes references, the command also prints the reference information.

      This command is run in two steps. First, generate the data to input into the listComm command and assign the list to a variable. The variable is then used as input into the listComm command.

      For example: 

      wsadmin>byMember=CommunitiesService.fetchCommByMember("jane_doe@company.com")
wsadmin>CommunitiesService.listComm(byMember)

      CommunitiesService.listCommToFile(List list, String filename)

      Prints the information associated with the communities or subcommunities in the list input to the specified file using an easy-to-read format. The directory to which the file is to be output must already exist. The data printed includes community name, UUID, type, who created it, creation date, last person who modified it, date of last modification, membership list size, and description. If the list includes members, then this command also prints the membership list. If the list includes references, the command also prints the reference information.

      This command is run in two steps. First, generate the data to input into the listCommToFile command and assign the list to a variable. The variable is then used as input into the listCommToFile command.

      For example: 

      wsadmin>byMember=CommunitiesService.fetchCommByMember("jane_doe@company.com")
wsadmin>CommunitiesService.listCommToFile(bymember,"/temp/CommMembers.txt")

      CommunitiesService.removeAllMembershipByDirectoryUuid(String directoryUuid)

      Removes the specified user from any communities and subcommunities to which they belong.

      The command takes a single parameter:

        directoryUuid
        A string that specifies the directory UUID (external ID) of the user whose membership you want to remove.

      If the user is the last owner of a community or subcommunity, they are not removed, and the community or subcommunity is included in the return value for this call. The command returns a vector of hash maps of all the communities and subcommunities where the user was not removed because they are the last owner.

      To obtain the directory UUID to use as input into this command, use one of the following commands. Both commands return the user's external ID.

      • CommunitiesMemberService.getMemberExtIdByEmail("email")
      • CommunitiesMemberService.getMemberExtIdByLogin("login")

      For example: 

      CommunitiesService.removeAllMembershipByMemberUuid("91b3897d-b4f8-4d05-3621-50bcaa22d300")

      CommunitiesService.removeMembersFromCommunityByEmail(String communityName, List emailAddresses)

      Removes members from an existing community or subcommunity. Members are identified in a list by their email addresses.

      You can remove both owners and members, but you cannot remove the last active owner. You can remove members from a subcommunity, but you cannot remove owners from a subcommunity.

      If an email address in the list does not match any member email address in the community then the command fails and none of the members in the list are removed from the community.

      You use this command in two steps. First, create a comma-separated list of users (using their e-mail addresses) who you want to remove from an existing community or subcommunity, and assign this list to a variable.

      For example: 

      wsadmin>threemembers=["alex_jones@example.com", "mary_smith@example.com", "paul_henderson@example.com"]
      Then, use this variable as input into the removeMembersFromCommunity command.

      For example: 

      wsadmin>CommunitiesService.removeMembersFromCommunityByEmail("Ski Club Community",threemembers)
      Note that communityName is a string and must be enclosed in quotation marks ("). This parameter is case-sensitive so be sure to specify the name of the community or subcommunity exactly.

      CommunitiesService.removeMembersFromCommunityByMemberUuid(String communityName, List UUID of member)

      Removes members from an existing community or subcommunity. Members are identified in a list by their external ID. Use this command when you want to remove users from a community's membership list, but they do not have an email address.

      You can remove both owners and members, but you cannot remove the last active owner. You can remove members from a subcommunity, but you cannot remove owners from a subcommunity.

      If a UUID in the list does not match any member UUID in the community then the command fails and none of the members in the list are removed from the community.

      To obtain the directory UUID to use as input for this command, use one of the following commands. Both commands return the user's external ID.

      • CommunitiesMemberService.getMemberExtIdByEmail("email")
      • CommunitiesMemberService.getMemberExtIdByLogin("login")

      You use this command in two steps. First, create a comma-separated list of users (using their UUID, the external LDAP ID) who you want to remove from an existing community or subcommunity and assign this list to a variable.

      For example: 

      wsadmin>onemember=["84b4897d-b4f8-4d95-9621-50bcaa2fd3ca"]
      Then, use this variable as input in to the removeMembersFromCommunityByMemberUuid command.

      For example: 

      wsadmin>CommunitiesServiceg.removeMembersFromCommunityByMemberUuid("Ski Club Community", onemember)
      Note that communityName is a string and must be enclosed in quotation marks ("). This parameter is case-sensitive so be sure to specify the name of the community or subcommunity exactly.

      CommunitiesService.updateCommunityName(String communityName, String newName)

      Allows you to update an existing community or subcommunity name where:

      • communityName refers to the existing community or subcommunity name, which must be specified exactly.
      • newName is the new name of the community or subcommunity.

      Both communityName and newName must be enclosed in double quotes (").

      For example: 

      CommunitiesService.updateCommunityName("JDs Community", "JDs New Name")

      When you use this command, if you get an error telling you that the community or subcommunity name is not unique, enter the UUID instead.

      You can obtain the UUID for a community or subcommunity by doing one of the following:

      • Use a browser, open the community or subcommunity that you want and copy the UUID from the URL.

      • Run the CommunitiesService.fetchAllComm() wsadmin command to fetch all communities and subcommunities on the server. Copy the UUID from the output.

      CommunitiesService.updateCommunityDescription(String communityName, String newDescription)

      Allows you to update (overwrite) the description field in an existing community or subcommunity. Any existing description is overwritten by the new text that you enter into this command.

      Both communityName and newDescription must be enclosed in double quotes.

      For example: 

      CommunitiesService.updateCommunityDescription("Ski Community",  "The purpose of this community is to bring together people interested in skiing.")

      CommunitiesService.removeReferencesByUri(String communityName, List referenceURIs)

      Allows you to remove all references to one or more existing bookmarks (URIs) from a specified community or subcommunity.

      The command requires a two-step process: First, create a comma-separated list of the bookmarks (URIs) to remove. These URIs are saved to a variable and this variable is used as input for the removeReferencesByUri command.

      Because the URIs are specified as a list, each URI must be enclosed in double quotes and separated by commas. All URIs must be enclosed within brackets. The URI that is listed must match exactly the URI that is saved in the community or subcommunity, otherwise the command fails.

      The communityName parameter is a string and must be enclosed in double quotes (").

      For example: 

      wsadmin>delete=["http://valid1.url.com", "http://valid2.url.com", "http://valid3.url.com"]
wsadmin>CommunitiesService.removeReferencesByUri("Ski Club Community",delete)

      CommunitiesService.removeTagsFromCommunity(String communityName, List tagNames)

      Allows you to remove tags from an existing community or subcommunity. This command is a two-step process. First, create a comma-separated list of the tags to remove. This list of tags is saved to a variable and the variable is used as input for the removeTagsFromCommunity command.

      You can remove tags on a community or subcommunity, but you cannot remove tags associated with bookmarks or feeds within a community.

      Because the tags are specified as a list, each tag must be enclosed in double quotes and separated by commas. All tags must be enclosed within brackets.

      The communityName parameter is a string and must be enclosed in double quotes.

      For example: 

      wsadmin>tags=["snowboard", "mountain"]
wsadmin>CommunitiesService.removeTagsFromCommunity("Ski Club Community", tags)


    ManagedAppService commands

      ManagedAppService.addLinkProperty(Link link, String key, String value)

      Adds or updates the key property for the specified link.

      Add or updating the key property for a link is a multi-step process.

      For example: 

      wsadmin>link=ManagedAppService.fetchLinkByApp("application name")
wsadmin>link2=link.get(0)
// link2=link.elementAt(0) would work as well
wsadmin>ManagedAppService.addLinkProperty(link2,"NewKey","NewValue")

      ManagedAppService.checkInConfig(String "app")

      Checks in the configuration file for the specified application.

      ManagedAppService.checkOutConfig(String "app", String "working directory", String "cell name")

      Checks out the configuration file for the specified application.

      The working directory must be a directory that already exists.

      ManagedAppService.configHelp(String "app")

      Prints the help messages for the configuration settings that can be set for the specified application.

      ManagedAppService.createLink(List comList, String appName)

      Creates a link to the managed application for each community in the community list comList. Depending on how comList is returned, a link can be created for the following:

      • All communities, when comList is returned by a fetchAllComm command

      • A specific community, when comList (with a single element) is returned by a fetchCommByName command

      • The communities that a specific user is a member or owner of, when comList is returned by the fetchCommByMemberEmail or fetchCommByMemberUuid command

      The first step is to create a list of communities using one of the CommunitiesService fetch commands mentioned previously. When executing the command to fetch the community list, assign the command to a variable. The variable, which contains the output of the fetch command, is used as input for the createLink command. Also, the application name is a string so it must be enclosed in quotes.

      ManagedAppService.deleteLink(List linkList)

      Removes the links between a community (or communities) and an application (or applications) from the specified list of links. Application properties are deleted from the elements in linkList when the application is removed.

      This is a three-step process:

      1. Create a list of the communities that will have their links deleted.

      2. Create a list of the link information for the list of communities generated in step a.

      3. Run the deleteLink command. When executing steps and b, set the command to a variable. The output of the commands is used as input in the next command.

      For example: 

      wsadmin>commbyname=CommunitiesService.fetchCommByName("community name")
wsadmin>linkbycomm=ManagedAppService.fetchLinkByComm(commbyname)
wsadmin>ManagedAppService.deleteLink(linkbycomm)
      This example deletes links for a specific community.

      ManagedAppService.deleteLinkProperty(Link link, String key)

      Removes the key property for the applications in the list.

      This is a multi-step process.

      For example: 

      wsadmin>link=ManagedAppService.fetchLinkByApp("application name")
wsadmin>link2=link.get(0)
// link2=link.elementAt(0) would work as well
wsadmin>ManagedAppService.deleteLinkProperty(link2,"NewKey")

      ManagedAppService.fetchAllLink()

      Return a list of all the links configured on the server.

      ManagedAppService.fetchLinkByApp(String appName)

      Return a list of all the links associated with the specified application.

      The application name is a string and must be enclosed in quotes.

      ManagedAppService.fetchLinkByComm(List comList)

      Return a list of all the links associated with the specified communities.

      This is a two-step process. The first step is to create a list of communities for which you want to get link information. This is done using the CommunitiesService fetch commands. Lists can be created for all communities, a specific community, or the communities that the specified user is a member or owner of. Set the fetch command to a variable. The output from this command is used as input in the fetchLinkByComm command.

      For example: 

      wsadmin>allcomm=CommunitiesService.fetchAllComm()
wsadmin>ManagedAppService.fetchLinkByComm(allcomm)
      This example retrieves the link information for all communities.

      ManagedAppService.fetchLinkByCommApp(List comList, String appName)

      For each community in the list, returns the link associated with the type.

      This is a two-step process. The first step is to create a list of communities for which you want to get the link information. This is done using the CommunitiesService fetch command. Lists can be created for all communities, a specific community, or the communities that the specified user is a member or owner of. Set the fetch command to a variable. The output from this command is used as input in the fetchLinkByCommApp command.

      ManagedAppService.fetchProperty(List linkList)

      Return a list of the properties set for each link in the list.

      The input for this command is a list of links. In the following example, the first step retrieves a list of all the links on the server. The command is set to a variable. The output from the fetch command is the input for the fetchProperty command. 

      wsadmin>links=ManagedAppService.fetchAllLink()
wsadmin>ManagedAppService.fetchProperty(links)

      ManagedAppService.listApp()

      List the names and current enabled status of all the applications installed on the Communities server.

      Change the configuration settings of an application does not change the status reported by this command unless the server is restarted.

      ManagedAppService.listLink(List linkList)

      Display the links specified in the list in a readable format on the screen. The command prints properties for the links if the linkList argument was obtained with the fetchProperties command.

      The following example lists all the links in a more easily readable format. The first step is to create the list of links. Set the command to a variable. The variable is used as input in the listLink command. 

      wsadmin>links=ManagedAppService.fetchAllLink()
wsadmin>ManagedAppService.listLink(links)

      ManagedAppService.listLinkToFile(List linkList, String fileName)

      Prints the links specified in the list in a readable format to a file. The command prints properties for the links if the linkList argument was obtained with the fetchProperties command.

      The specified path must already exist. The only difference between this command and ManagedAppService.listLink is that a path and file name to which the data is output needs to be specified. 

      wsadmin>links=ManagedAppService.fetchAllLink()
wsadmin>ManagedAppService.listLinkToFile(links,"/temp/data.txt")

      ManagedAppService.showConfig(String "app")

      List the configuration settings for the specified application. This command also displays the settings that can be configured.

      ManagedAppService.updateConfig(String "app", String "property", String "value")

      Updates a specific property in the configuration file for the specified application.

      Each application has its own set of configuration properties. The listApp method lists the properties for an application.

      ManagedAppService.updateFeedURI(Link link, String URI)

      Update the feed URI for this link.

      Update the feed URI is a multi-step process. The first step is to fetch the community, the next step is to get the link to the feed the URI is to be updated on, and then issue the command to update the URI.

      In the following example, it is assumed that the community either has a single link, or that is has multiple links and the first one in the list is the one (index 0) to update. If a community has multiple links, you need to be careful to select the correct one. 

      wsadmin>byname=CommunitiesService.fetchCommByName("<community name>")
wsadmin>bycomm=ManagedAppService.fetchLinkByComm(byname)
wsadmin>ManagedAppService.updateFeedURI(bycomm.elementAt(0),"http://<new URI>")

      ManagedAppService.updateMainURI(Link link, String URI)

      Update the main URI for this link.

      Update the main URI is a multi-step process. The first step is to get the community. Then you retrieve the link the main URI is updated on, and run the command to update the URI.

      For example: 

      wsadmin>byname=CommunitiesService.fetchCommByName("<community name>")
wsadmin>bycomm=ManagedAppService.fetchLinkByComm(byname)
wsadmin>ManagedAppService.updateMainURI(bycomm.elementAt(0),"http://<new URI>")


    Change Communities configuration property values

    Configuration settings control how and when various Communities operations take place. You can edit the settings to change the ways that communities behave.

    To edit configuration files, you use the wsadmin client.

    Configure Communities using scripts accessed with the wsadmin client. These scripts use the AdminConfig object available in WAS wsadmin client to interact with the Communities configuration file. Changes to Communities configuration settings require node synchronization and a restart of the Communities server before they take effect.

    To change Communities configuration settings:

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Start the Communities Jython script interpreter.

      1. Access the Communities configuration files: 

        execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Communities configuration :

        CommunitiesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        CommunitiesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. To view a list of the valid Communities configuration settings and their current values:

      CommunitiesConfigService.showConfig() Here is some sample output from the CommunitiesConfigService.showConfig() command: 

      activeContentFilter.enabled = true
        descriptionSummary.size = 300
        explicitMembershipEntityLimit = 100000
        group.enabled = true
        group.membershipCache.maximumAgeOnLoginInSeconds = 120
        group.membershipCache.maximumAgeOnRequestInSeconds = 120
        handle.enabled = true
        pagingSupport.communityListTags.pageSize = 75
        pagingSupport.dbNameTypeAhead.pageSize = 50
        pagingSupport.defaultPageSize = 10
        pagingSupport.ldapNameSearch.pageSize = 50
        pagingSupport.memberNameTypeAhead.pageSize = 15
        pagingSupport.tagNameTypeAhead.pageSize = 10
        show.startCommunity.To.Unauthenticated = true
        task.EventLogCleanup.enabled = true
        task.EventLogCleanup.interval = 0 30 0-23/3 ? * *
        task.LifecycleRetryQueuedEvents.enabled = true
        task.LifecycleRetryQueuedEvents.interval = 0 1 0-23/3 ? * *

    4. To change a Communities configuration setting:

      CommunitiesConfigService.updateConfig("property", "value") where property is one of the editable Communities configuration properties and value is the new value with which you want to set that property.

      See Communities configuration properties for a complete list of editable properties.

      For example: 

      CommunitiesConfigService.updateConfig("descriptionSummary.size", "500")

    5. After updating the Communities properties with new values, use the CommunitiesConfigService.showConfig() command to display the list of properties and their updated values. These are the values that will be checked in with the CommunitiesConfigService.checkInConfig() command.

    6. Repeat step 3 for each property setting to change.

    You must check the configuration files back in after making changes, and they must be checked in in the same wsadmin session in which they were checked out for the changes to take effect.

    See Applying property changes for details.


    Communities configuration properties

    Configuration properties control various features within Communities and also help in the optimization of server performance. They require a Communities application or server restart to take effect. You can check out and modify the following configuration properties in the communities-config.xml file. The properties are listed in alphabetical order.

      activeContentFilter.enabled

      When enabled, this property prevents the addition of active content (JavaScript) in any text input field.

      This property takes a Boolean value: true or false.

      Disable this filter introduces vulnerability to cross-site scripting (XSS) and other type of malicious attacks.

      See Securing applications from malicious attack for additional information.

      descriptionSummary.size

      This property determines the maximum number of characters in a community description to display in the Public Communities or My Communities view. It gets this information through the seedlist.

      This property takes an integer value.

      explicitMembershipEntityLimit

      This property determines the maximum number of members that a community can contain. This limit is the total number of people and groups added to a community. It does not count the number of people contained in a group towards this limit. The limit only applies to adding new members. If the limit is reduced, Connections does not remove people from communities to accommodate the decreased limit.

      This property takes an integer value. The default value is 100000. Values greater than 100000 are not supported.

      Decrease the number to improve performance.

      group.enabled

      Enables or disables the ability to add groups to communities. When owners click Add Members, they can choose to add Groups in the Members field.

      This property accepts the following values: true or false.

      group.membershipCache.maximumAgeOnLoginInSeconds

      When a user logs in, this property determines the maximum age of a group membership cache in seconds.

      The value must be 0 or greater.

      group.membershipCache.maximumAgeOnRequestInSeconds

      Determines the maximum age of a group membership cache in seconds across requests for a user

      The value must be 0 or greater.

      pagingSupport.communityListTags.pageSize

      Used by API calls that request tags. If you do not specify the count parameter in the API call, then the value listed in pagingSupport.communityListTags.pageSize is used.

      This property takes an integer value.

      pagingSupport.dbNameTypeAhead.pageSize

      Determines the maximum number of matching names to display in the type-ahead suggestion field when users start typing the names of people to add to a community. These names are retrieved from the SNCOMM.MEMBERPROFILE database table.

      This property takes an integer value.

      pagingSupport.defaultPageSize

      This property determines the maximum number of community bookmarks and feed lists displayed on a page. The default value is 10.

      This property takes an integer value.

      Decrease the number to speed paging.

      pagingSupport.ldapNameSearch.pageSize

      Determines the maximum number of LDAP users returned when users click Search Directory to search the LDAP directory for a name when adding members to a community.

      pagingSupport.memberNameTypeAhead.pageSize

      Determines the maximum number of users displayed by the type-ahead application when users click Search Directory to search the LDAP directory for a name when adding members to a community.

      pagingSupport.tagNameTypeAhead.pageSize

      Determines the maximum number of tags displayed by the type-ahead application when users add new tags to a community.

      show.StartCommunity.To.Unauthenticated

      When enabled, this property displays the Start a community button to unauthenticated users.

      This property takes a Boolean value: true or false.

      task.EventLogCleanup.enabled

      Enables or disables the event log cleanup task.

      This property accepts the following values: true or false.

      task.EventLogCleanup.interval

      Specifies the interval at which the event log cleanup task runs.

      This parameter is specified using Cron format.

      For more information about using the Cron format, see Scheduling tasks.

      When you change the interval property, the new schedule is registered the next time that Communities is started on any server in the Communities cluster (if there is one).

      task.LifecycleRetryQueuedEvents.enabled

      Enables or disables the life-cycle retry queued events task.

      This property accepts the following values: true or false.

      task.LifecycleRetryQueuedEvents.interval

      Specifies the interval at which the life-cycle retry queued events task runs.

      This parameter is specified using Cron format.

      For more information about using the Cron format, see Scheduling tasks.

      When you change the interval property, the new schedule is registered the next time that Communities is started on any server in the Communities cluster (if there is one).


    Apply property changes in Communities

    After you have edited the Communities configuration properties, check the changed configuration file in, and restart the servers to apply the changes.

    See Communities configuration properties for information about the properties that you can edit.

    1. Check in the changed configuration property keys using the following wsadmin client command:

      CommunitiesConfigService.checkInConfig()

      The checkin must be done in the same wsadmin session as the checkout.

    2. Update the value of the version stamp configuration property in LotusConnections-config.xml to force users' browsers to pick up this change

      See Required post-customization step

    3. To exit the wsadmin client, type exit at the prompt.

    4. Restart the Communities application.


    Create and populating communities

    Create and populate a community using scripts accessed using the wsadmin command-line tool. The administrative commands for creating communities do not require a server restart to take effect, and no file checkout is necessary.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    You can use wsadmin commands to create a community and populate it with a set of members based on user login name or email address.

    The communities created using the following commands allow public access. However, community owners can edit the communities from the Communities user interface after they are created and change the access level to moderated or restricted as needed.

    To create and populate a new community....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Start the Communities Jython script interpreter.

      1. Access the Communities configuration files: 

        execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Use the following commands to create a community and populate it with a set of members:

        CommunitiesService.createCommunityWithEmail(String community name, String ownerName, int memberRole, String dsmlFile)

        Creates a public community whose membership list is initialized from a Directory Services Markup Language (DSML) file exported from the LDAP directory.

        The DSML file must be local to the system running the script. The script parses the DSML file and extracts the mail values. These values are used to populate the membership list of the community.

        For more information about how to create DSML files from your LDAP directory, see http://www.dsmltools.org/.

        A typical mail attribute in a DSML file looks like the following: 

        <attr   name="mail">
 <value>john_doe@example.com</value>
</attr>

        The command takes the following parameters:

          communityName
          A string value that specifies the name of the community that you are creating.

          ownerName
          A string value that specifies the name of the new community's owner. Enter the email address of the user who will be the owner of the community.

          memberRole
          An integer that specifies the role of the users added to the new community. This property can be set to 0 to specify the member role or 1 to specify the owner role. Do not enclose this setting in quotation marks.

          dsmlFile
          A string value that specifies that name of the DSML file containing the mail values used to populate the community membership.

        In the following example, a community named AJ's Community is created with Ann Jones as the community owner/creator. The command parses the file /opt/myDSML.xml, looks for each of the mail attributes, and then adds those email addresses to the new community with member access. 

        CommunitiesService.createCommunityWithEmail("AJ's Community", "ann_jones@example.com", 0, "/opt/myDSML.xml")
        Notes:

        • This command only creates parent communities; it cannot be used to create subcommunities.
        • This command creates a public community by default. To change the visibility of the community, the community owner must edit the community from the user interface and change the access level to moderated or restricted as needed.

        CommunitiesService.createCommunityWithLoginName(String communityName, String ownerName, int memberRole, String dsmlFile)

        Creates a public community whose membership list is initialized from a DSML file exported from the LDAP directory.

        The DSML file must be local to the system running the script. The script parses the DSML XML file and extracts the login name values. These values are used to populate the membership list of the community.

        For more information about how to create DSML files from your LDAP directory, see http://www.dsmltools.org/.

        The command takes the following parameters:

          communityName
          A string value that specifies the name of the community that you are creating.

          ownerName
          A string value that specifies the name of the new community's owner. Enter the loginName of the user who will be the owner of the community.

          memberRole
          An integer that specifies the role of the users added to the new community. This property can be set to 0 to specify the member role or 1 to specify the owner role. Do not enclose this setting in quotation marks.

          dsmlFile
          A string value that specifies the name of the DSML file containing the loginName values used to populate the community membership.

        In the following example, a community named AJ's Community is created with Ann Jones as the community owner/creator. The command parses the file /opt/myDSML.xml and looks for each of the login attributes and adds those login names to the new community with member access. 

        CommunitiesService.createCommunityWithLoginName("AJ's Community", "ann_jones", 0, "/opt/myDSML.xml")
        Notes:

        • This command only creates parent communities; it cannot be used to create subcommunities.
        • This command creates a public community by default. To change the visibility of the community, the community owner must edit the community from the user interface and change the access level to moderated or restricted as needed.


    Manage membership in Communities

    Use administrative commands to add and remove community members. You can also disable the Add Members button if you do not want community owners to add people to communities without their consent, or disable the invitations feature if you do not want to allow people to invite others to join their community.

    When users import people using the Members widget in Communities, user names in an email address cannot contain special characters.

    For example, user_name in this email address cannot contain any special characters: user_name@example.com.

    When the name of a group that is used in a community is renamed in LDAP, the old group name still appears on the Members page of the community. The new group name does not appear in the community, until a member of that group logs in and accesses Communities.

    When you delete a group from the LDAP Directory, and that group has been used by communities for membership, the deleted group still appears in the Members page of the community with member access. The group members no longer have member access to the community due to the group deletion, and the deleted group cannot be added to other communities.

    An activity that is part of a community maintains a cache of Community users. That cache expires after 10 minutes. If the community membership of a user changes, and that user is also a member of a community activity, then membership change is only visible after the cache expires.


    Add owners and members to a community

    Use scripts accessed using the wsadmin command-line tool to add owners and members to existing communities. You can only add individuals to a community; you cannot add a group to a community. There is no limit on the number of members that you can add to a community.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details. The administrative commands for adding owners and members to a community do not require a server restart to take effect, and no file checkout is necessary.

    You can also use the following commands to add owners and members to subcommunities.

    The config-admin Jython scripts that get and set properties use the implicit AdminConfig object available in IBM WebSphere Application Server Admin (wsadmin) to interact with the Communities server. If an error occurs when you are using the following MBean commands, you can determine what went wrong by examining the SystemOut.log file.

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Use the following commands to add additional members or owners to an existing community or subcommunity.

        CommunitiesService.addMembersToCommunityByEmail(String communityName, Integer memberRole, List emailAddresses)

        Adds members to an existing community or subcommunity.

        When you use this command to add owners or members to a subcommunity, the users that you are adding must belong to the parent community in order for them to be added to the subcommunity.

        You cannot exceed the maximum number of members limit specified in the explicitMembershipEntityLimit property of the communities-config.xml file.

        See Communities configuration properties.

        You use this command in two steps. First, create a comma-separated list of users (using their email addresses) to add to an existing community or subcommunity and assign this list to a variable. This variable is then used as input into the addMembersToCommunity command.

        Note that communityName is a string and must be enclosed in quotation marks ("). This parameter is case-sensitive, so be sure to specify the name of the community or subcommunity exactly.

        memberRole. Valid settings are 0 (member) or 1 (owner). Do not enclose this setting in quotation marks.

        For example: 

        wsadmin>threemembers=["alex_jones@example.com", "mary_smith@example.com", "paul_henderson@example.com"]
wsadmin>CommunitiesService.addMembersToCommunityByEmail("Ski Club Community",0,threemembers)

        When you use this command, if the community or subcommunity name that you provide as input to the command is not unique, an error similar to the following displays: 

        WASX7015E: Exception running command: "CommunitiesService.addMembersToCommunityByEmail("My community",0,threemembers)"; exception information:
 javax.management.RuntimeMBeanException
java.lang.IllegalArgumentException: java.lang.IllegalArgumentException: CLFRM0091E: Multiple communities found with name: My community
        When you see an error like the previous one, instead of entering the name of the community or subcommunity in the command, you must enter the UUID instead.

        For example: 

        wsadmin>CommunitiesService.addMembersToCommunityByEmail("5742c4c8-0010-4e6e-abdb-65015e8a22e1", 0,threemembers)
        You can obtain the UUID for a community or subcommunity by doing one of the following:

        • Use a browser, open the community or subcommunity that you want and copy the UUID from the URL.

        • Run the CommunitiesService.fetchAllComm() wsadmin command to fetch all communities and subcommunities on the server. Copy the UUID from the output.

        CommunitiesService.addMembersToCommunityByMemberUuid(String communityName, Integer memberRole, List UUID of member)

        Adds members to an existing community or subcommunity. Use this command when you want to add users to a community's membership list, but they don't have an email address. The users that you are adding must belong to the parent community in order for them to be added to the subcommunity.

        The member's UUID is the external LDAP identifier for a specific user. Use one of the following commands to return the user's external ID for use in the previous command:

        • CommunitiesMemberService.getMemberExtIdByEmail("email")
        • CommunitiesMemberService.getMemberExtIdByLogin("login")

        You cannot exceed the maximum number of members limit specified in the explicitMembershipEntityLimit property of the community-config.xml file.

        See Communities configuration properties.

        You use this command in two steps. First, create a comma-separated list of users (using their UUID, the external LDAP ID) to add to an existing community or subcommunity and assign this list to a variable. This variable is then used as input into the addMembersToCommunity command.

        Note that communityName is a string and must be enclosed in quotation marks ("). This parameter is case-sensitive, so be sure to specify the name of the community or subcommunity exactly.

        memberRole: Valid settings are 0 (member) or 1 (owner). Do not enclose this setting in quotation marks.

        For example: 

        wsadmin>onemember=["84b4897d-b4f8-4d95-9621-50bcaa2fd3ca"]
wsadmin>CommunitiesService.addMembersToCommunityByMemberUuid("Ski Club Community",0,onemember)
        The onemember parameter is the extid(user).

        When you use this command, if you get an error telling you that the community or subcommunity name is not unique, instead of entering the name of the community or subcommunity in the command input, enter the UUID instead.

        You can obtain the UUID for a community or subcommunity by doing one of the following:

        • Use a browser, open the community or subcommunity that you want and copy the UUID from the URL.

        • Run the CommunitiesService.fetchAllComm() wsadmin command to fetch all communities and subcommunities on the server. Copy the UUID from the output.


    Add an alternate owner to communities

    Use scripts accessed using the wsadmin command-line tool to designate an alternate owner for the communities and subcommunities owned by a specific user.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details. The administrative command for adding an alternate community owner does not require a server restart to take effect, and no file checkout is necessary.

    If a community owner needs to transfer or share ownership of their communities and subcommunities, for example if they are going on sabbatical or leaving the organization, you can add another user as an alternate owner of those communities and subcommunities. When you assign an alternate owner to the communities and subcommunities owned by a particular user, you can choose to leave the existing owner in their role as owner, or remove them from the community and subcommunity membership.

    To add an alternate owner to the communities and subcommunities owned by a specific user....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Use the following command:

        CommunitiesService.addAlternateOwner(String directoryUuid, String alternateDirectoryUuid, Boolean removeOriginal)

        Adds the user with the specified alternateDirectoryUuid as an owner to every community and subcommunity owned by the user with the specified directoryUuid (external ID).

        Parameters:

          directoryUuid
          A string that specifies the directory UUID (external ID) of an existing community or subcommunity owner.

          alternateDirectoryUuid
          A string that specifies the directory UUID (external ID) of the person who you want to add as the alternate owner.

          removeOriginal
          A Boolean value that determines whether the person specified using the directoryUuid (external ID) parameter is removed from the membership of their communities and subcommunities. When set to true, the user with the specified directoryUuid is removed from their community and subcommunity membership. When set to false, the user with the specified directoryUuid remains listed as an owner of their communities and subcommunities.

        For example: 

        CommunitiesService.addAlternateOwner("193F1CE8-E10A-4B9A-B933-C8ECD6C072E4", "EC8A89C0-F41D-102C-9B60-F225BC6C4AF4", "true")

        To obtain the value to use for the directoryUuid and alternateDirectoryUuid parameters, you can use the following command: 

        CommunitiesMemberService.getMemberExtIdByEmail("email_address")

        In the following example, for any community (or subcommunity) where Paul Smith is an owner, user Alice Lee is added to the membership list with owner access, and Paul Smith is removed from the membership list: 

        wsadmin>CommunitiesMemberService.getMemberExtIdByEmail("paul_smith@example.com")
510b99c0-0123-1010-8989-f78755f7e0ed
wsadmin>
wsadmin>CommunitiesMemberService.getMemberExtIdByEmail("alice_lee@example.com")
510b99c0-0101-102e-8934-f78755f7e0ed
wsadmin>
wsadmin>CommunitiesService.addAlternateOwner("510b99c0-0123-1010-8989-f78755f7e0ed", "510b99c0-0101-102e-8934-f78755f7e0ed", "true")


    Remove members from communities

    Use administrative commands to remove specified users from the membership of their communities and subcommunities.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details. The administrative commands for removing members from communities and subcommunities do not require a server restart to take effect and no file checkout is necessary.

    When employees leave your organization or no longer require access to communities for some other reason, you can remove them from the membership of communities and subcommunities. You can remove specified community members based on their email address or name.

    To remove a specified user from the membership of a community or subcommunity....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Use one of the following commands:

        CommunitiesService.removeAllMembershipByDirectoryUuid(String directoryUuid)

        Removes the specified user from any communities and subcommunities to which they belong.

        The command takes a single parameter:

          directoryUuid
          A string that specifies the directory UUID (external ID) of the user whose membership you want to remove.

        If the user is the last owner of a community or subcommunity, they are not removed, and the community or subcommunity is included in the return value for this call. The command returns a vector of hash maps of all the communities and subcommunities where the user was not removed because they are the last owner.

        To obtain the directory UUID to use as input into this command, use one of the following commands. Both commands return the user's external ID.

        • CommunitiesMemberService.getMemberExtIdByEmail("email")
        • CommunitiesMemberService.getMemberExtIdByLogin("login")

        For example: 

        CommunitiesService.removeAllMembershipByMemberUuid("91b3897d-b4f8-4d05-3621-50bcaa22d300")

        CommunitiesService.removeMembersFromCommunityByEmail(String communityName, List emailAddresses)

        Removes members from an existing community or subcommunity. Members are identified in a list by their email addresses.

        You can remove both owners and members, but you cannot remove the last active owner. You can remove members from a subcommunity, but you cannot remove owners from a subcommunity.

        If an email address in the list does not match any member email address in the community then the command fails and none of the members in the list are removed from the community.

        You use this command in two steps. First, create a comma-separated list of users (using their e-mail addresses) who you want to remove from an existing community or subcommunity, and assign this list to a variable.

        For example: 

        wsadmin>threemembers=["alex_jones@example.com", "mary_smith@example.com", "paul_henderson@example.com"]
        Then, use this variable as input into the removeMembersFromCommunity command.

        For example: 

        wsadmin>CommunitiesService.removeMembersFromCommunityByEmail("Ski Club Community",threemembers)
        Note that communityName is a string and must be enclosed in quotation marks ("). This parameter is case-sensitive so be sure to specify the name of the community or subcommunity exactly.

        CommunitiesService.removeMembersFromCommunityByMemberUuid(String communityName, List UUID of member)

        Removes members from an existing community or subcommunity. Members are identified in a list by their external ID. Use this command when you want to remove users from a community's membership list, but they do not have an email address.

        You can remove both owners and members, but you cannot remove the last active owner. You can remove members from a subcommunity, but you cannot remove owners from a subcommunity.

        If a UUID in the list does not match any member UUID in the community then the command fails and none of the members in the list are removed from the community.

        To obtain the directory UUID to use as input for this command, use one of the following commands. Both commands return the user's external ID.

        • CommunitiesMemberService.getMemberExtIdByEmail("email")
        • CommunitiesMemberService.getMemberExtIdByLogin("login")

        You use this command in two steps. First, create a comma-separated list of users (using their UUID, the external LDAP ID) who you want to remove from an existing community or subcommunity and assign this list to a variable.

        For example: 

        wsadmin>onemember=["84b4897d-b4f8-4d95-9621-50bcaa2fd3ca"]
        Then, use this variable as input in to the removeMembersFromCommunityByMemberUuid command.

        For example: 

        wsadmin>CommunitiesServiceg.removeMembersFromCommunityByMemberUuid("Ski Club Community", onemember)
        Note that communityName is a string and must be enclosed in quotation marks ("). This parameter is case-sensitive so be sure to specify the name of the community or subcommunity exactly.


    Disable the ability to add members to a community

    You can disable the functionality that allows community owners to add members to a community on a deployment-wide basis, so that instead new members must always be invited to join a community.

    To update configuration files, use the wsadmin client.

    See Start wsadmin for details.

    Disable the ability to add members to a community means that community owners can no longer add people to a community without their consent. Instead, people must be invited to join a community, and they must accept the invitation to become a member. This functionality is useful when you want users in your organization to actively choose to become part of a community.

    When you disable the functionality for adding members to a community, the Add Members button no longer displays on the Members page.

    With this configuration, users can still join a public community. The Join this community link still appears in public communities, and if a users click it they get added to the community as a member. In Moderated communities, the Request to Join This Community link: still appears. If a community owner agrees to add the user, the user receives an email invitation to join the community. The requesting user must then accept the invitation and then becomes a member of the community. Under the default configuration, the owner can directly add that requesting user.

    Under this configuration, groups cannot be added to a community. There is no support for inviting groups.

    To disable the functionality for adding members to a community....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Start the Communities Jython script interpreter.

      1. Access the Communities configuration files: 

        execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Communities configuration : 

        CommunitiesConfigService.checkOutPolicyConfig("working_directory", "cell_name")

        ...where...

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command: 

          print AdminControl.getCell()

        For example: 

        CommunitiesConfigService.checkOutPolicyConfig("/opt/my_temp_dir", "CommCell01")

    3. Navigate to the working directory specified in the previous step and open the communities-policy.xml file using a text editor.

    4. Comment out or remove the add.others action for each community type from the following section of code: 

      <comm:permission class="com.ibm.tango.auth.permission.CommunityMembershipPermission"     communityType="public" action="add.others, remove.others, define.roles" />
<comm:permission class="com.ibm.tango.auth.permission.CommunityMembershipPermission"     communityType="publicInviteOnly" action="add.others, remove.others, define.roles" />
<comm:permission class="com.ibm.tango.auth.permission.CommunityMembershipPermission"     communityType="private" action="add.others, remove.others, define.roles" />
      For example: 

      <comm:permission class="com.ibm.tango.auth.permission.CommunityMembershipPermission"     communityType="public" action="remove.others, define.roles" />
<comm:permission class="com.ibm.tango.auth.permission.CommunityMembershipPermission"     communityType="publicInviteOnly" action="remove.others, define.roles" />
<comm:permission class="com.ibm.tango.auth.permission.CommunityMembershipPermission"     communityType="private" action="remove.others, define.roles" />

      You can find the section with these statements within the larger block of grant statements for the owner.

    5. Save your changes and then close the communities-policy.xml file.

    6. Check in the updated policy file 

      CommunitiesConfigurationService.checkInPolicyConfig("working-directory", "cell-name")

    7. Synchronize your changes across all nodes and then restart the Communities application.


    Limiting the membership size of communities

    You can limit the maximum number of members that a community can contain.

    To limit community membership size, edit the explicitMembershipEntityLimit property in the Communities configuration file using the wsadmin client.

    The maximum number of members that a community can contain includes the total number of both people and groups added to a community. It does not count the number of people contained in a group towards this limit. The limit only applies to adding new members. If the limit is reduced, Connections does not remove people from communities to accommodate the reduced limit. The member limit property takes an integer value. The default value and the maximum supported value is 100000. You can decrease the number to improve performance.

    You configure the size limit using scripts accessed with the wsadmin client. These scripts use the AdminConfig object available in WAS wsadmin client to interact with the Communities configuration file. Changes to these Communities configuration settings require node synchronization and a restart of the Communities server before they take effect.

    To limit the maximum number of members that a community can contain:

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Start the Communities Jython script interpreter.

      1. Access the Communities configuration files: 

        execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Communities configuration :

        CommunitiesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        CommunitiesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. To change the member limit property:

      CommunitiesConfigService.updateConfig("explicitMembershipEntityLimit", "value") where value is the new membership limit.

      For example: 

      CommunitiesConfigService.updateConfig("explicitMembershipEntityLimit", "500")

    You must check the configuration files back in after making changes, and they must be checked in in the same wsadmin session in which they were checked out for the changes to take effect.

    See Applying property changes in Communities for details.


    Manage communities when all owners are inactive

    Use scripts accessed using the wsadmin command-line tool to add more owners to communities when all of the existing owners are inactive. You can only add individual owners to a community; you cannot add an owner group to a community.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details. The administrative commands for adding more owners to a community do not require a server restart to take effect, and no file checkout is necessary.

    The config-admin Jython scripts that get and set properties use the implicit AdminConfig object available in IBM WebSphere Application Server Admin (wsadmin) to interact with the Communities server. If an error occurs when you are using the following MBean commands, you can determine what went wrong by examining the SystemOut.log file.

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Use the following commands to add more owners to a community when all existing owners are inactive.

        CommunitiesService.addMembersToCommunityByEmail(String communityName, Integer memberRole, List emailAddresses)

        Adds owners to an existing community.

        You use this command in two steps. First, create a comma-separated list of users (using their email addresses) to add to an existing community and assign this list to a variable. This variable is then used as input into the addMembersToCommunity command.

        Note that communityName is a string and must be enclosed in quotation marks ("). This parameter is case-sensitive, so be sure to specify the name of the community exactly.

        memberRole. Valid settings are 0 (member) or 1 (owner). You must set this to 1 (owner) to add more owners. Do not enclose this setting in quotation marks.

        For example: 

        wsadmin>threeowners=["alex_jones@example.com", "mary_smith@example.com", "paul_henderson@example.com"]
wsadmin>CommunitiesService.addMembersToCommunityByEmail("Ski Club Community",1,threeowners)

        When you use this command, if the community name that you provide as input to the command is not unique, an error similar to the following displays: 

        WASX7015E: Exception running command: "CommunitiesService.addMembersToCommunityByEmail("My community",1,threeowners)"; exception information:
 javax.management.RuntimeMBeanException
java.lang.IllegalArgumentException: java.lang.IllegalArgumentException: CLFRM0091E: Multiple communities found with name: My community
        When you see an error like the previous one, instead of entering the name of the community in the command, you must enter the UUID instead.

        For example: 

        wsadmin>CommunitiesService.addMembersToCommunityByEmail("5742c4c8-0010-4e6e-abdb-65015e8a22e1", 1,threeowners)
        You can obtain the UUID for a community by doing one of the following:

        • Use a browser, open the community that you want and copy the UUID from the URL.

        • Run the CommunitiesService.fetchAllComm() wsadmin command to fetch all communities and subcommunities on the server. Copy the UUID from the output.

        CommunitiesService.addMembersToCommunityByMemberUuid(String communityName, Integer memberRole, List UUID of member)

        Adds members to an existing community. Use this command when you want to add owners to a community's membership list, but they don't have an email address.

        The member's UUID is the external LDAP identifier for a specific user. Use one of the following commands to return the user's external ID for use in the previous command:

        • CommunitiesMemberService.getMemberExtIdByEmail("email")
        • CommunitiesMemberService.getMemberExtIdByLogin("login")

        You use this command in two steps. First, create a comma-separated list of users (using their UUID, the external LDAP ID) to add to an existing community and assign this list to a variable. This variable is then used as input into the addMembersToCommunity command.

        Note that communityName is a string and must be enclosed in quotation marks ("). This parameter is case-sensitive, so be sure to specify the name of the community or subcommunity exactly.

        memberRole: Valid settings are 0 (member) or 1 (owner). You must set this to 1 (owner) to add more owners. Do not enclose this setting in quotation marks.

        For example: 

        wsadmin>oneowner=["84b4897d-b4f8-4d95-9621-50bcaa2fd3ca"]
wsadmin>CommunitiesService.addMembersToCommunityByMemberUuid("Ski Club Community",1,oneowner)

        When you use this command, if you get an error telling you that the community name is not unique, instead of entering the name of the community in the command input, enter the UUID instead.


    Manage community content

    You can enable the active content filter to prevent users from embedding malicious content in text input fields. You can also use administrative commands to update or remove inappropriate information in fields to which you do not have owner access.

    You can also configure a Global Administrator. The Global Administrator has administrative privileges on Communities and all Connections applications. The Global Administrator can use a browser to access any Community and can remove or edit inappropriate content.

    For more information about Global Administrators, see Administering application content and Administering community content.


    Remove unwanted or inappropriate content

    Use administrative commands to update or remove inappropriate information stored in the Communities database.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    The following commands can also be used to remove unwanted or inappropriate content from subcommunities.

    You can edit basic community information using wsadmin commands.

    For example, you can change a community's name, update a community's description, and remove tags or bookmarks from a community.

    The following commands can only be used to manage community content. To remove data from the applications that can be integrated with Communities, such as Activities, Blogs, Files, and Wikis, you need to refer to the application documentation for each specific application.

    See the links at the end of this topic for more information.

    When you use the commands, if the community name that you provide as input to the command is not unique, an error similar to the following displays: 

    WASX7015E: Exception running command: "CommunitiesService.updateCommunityDescription("My community", "updated by wsadmin cmd")"; exception information:
 javax.management.RuntimeMBeanException
java.lang.IllegalArgumentException: java.lang.IllegalArgumentException: CLFRM0091E: Multiple communities found with name: My community
    When you see an error like this, instead of entering the name of the community in the command, you must enter the UUID of the community instead.

    For example: 

    wsadmin>CommunitiesService.updateCommunityDescription("5742c4c8-0010-4e6e-abdb-65015e8a22e1", "updated first by wsadmin cmd")

    You can obtain the UUID for a community or subcommunity by doing one of the following:

    • Use a browser, open the community or subcommunity that you want and copy the UUID from the URL.

    • Run the CommunitiesService.fetchAllComm() wsadmin command to fetch all communities and subcommunities on the server. Copy the UUID from the output.

    To control community content using Communities administrative commands....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Use the following commands to make changes to content in various fields of a community or subcommunity to which you do not have owner access. You can use the commands to remove unwanted or inappropriate content.

        CommunitiesService.updateCommunityName(String communityName, String newName)

        Allows you to update an existing community or subcommunity name where:

        • communityName refers to the existing community or subcommunity name, which must be specified exactly.
        • newName is the new name of the community or subcommunity.

        Both communityName and newName must be enclosed in double quotes (").

        For example: 

        CommunitiesService.updateCommunityName("JDs Community", "JDs New Name")

        When you use this command, if you get an error telling you that the community or subcommunity name is not unique, enter the UUID instead.

        You can obtain the UUID for a community or subcommunity by doing one of the following:

        • Use a browser, open the community or subcommunity that you want and copy the UUID from the URL.

        • Run the CommunitiesService.fetchAllComm() wsadmin command to fetch all communities and subcommunities on the server. Copy the UUID from the output.

        CommunitiesService.updateCommunityDescription(String communityName, String newDescription)

        Allows you to update (overwrite) the description field in an existing community or subcommunity. Any existing description is overwritten by the new text that you enter into this command.

        Both communityName and newDescription must be enclosed in double quotes.

        For example: 

        CommunitiesService.updateCommunityDescription("Ski Community",  "The purpose of this community is to bring together people interested in skiing.")

        CommunitiesService.removeReferencesByUri(String communityName, List referenceURIs)

        Allows you to remove all references to one or more existing bookmarks (URIs) from a specified community or subcommunity.

        The command requires a two-step process: First, create a comma-separated list of the bookmarks (URIs) to remove. These URIs are saved to a variable and this variable is used as input for the removeReferencesByUri command.

        Because the URIs are specified as a list, each URI must be enclosed in double quotes and separated by commas. All URIs must be enclosed within brackets. The URI that is listed must match exactly the URI that is saved in the community or subcommunity, otherwise the command fails.

        The communityName parameter is a string and must be enclosed in double quotes (").

        For example: 

        wsadmin>delete=["http://valid1.url.com", "http://valid2.url.com", "http://valid3.url.com"]
wsadmin>CommunitiesService.removeReferencesByUri("Ski Club Community",delete)

        CommunitiesService.removeTagsFromCommunity(String communityName, List tagNames)

        Allows you to remove tags from an existing community or subcommunity. This command is a two-step process. First, create a comma-separated list of the tags to remove. This list of tags is saved to a variable and the variable is used as input for the removeTagsFromCommunity command.

        You can remove tags on a community or subcommunity, but you cannot remove tags associated with bookmarks or feeds within a community.

        Because the tags are specified as a list, each tag must be enclosed in double quotes and separated by commas. All tags must be enclosed within brackets.

        The communityName parameter is a string and must be enclosed in double quotes.

        For example: 

        wsadmin>tags=["snowboard", "mountain"]
wsadmin>CommunitiesService.removeTagsFromCommunity("Ski Club Community", tags)


    Protecting against malicious active content

    The active content filter prevents users from embedding malicious content in Communities input fields.

    To edit configuration files, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    Communities provides a filter that prevents users from using rich text descriptions with malicious scripts that are started when other users visit Communities. You can disable this filter to provide richer options for content in any Communities text input field.

    Disable this filter introduces vulnerability to cross-site scripting (XSS) and other types of malicious attack.

    See Securing applications from malicious attack for additional information.

    To configure the active content filter....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Start the Communities Jython script interpreter.

      1. Access the Communities configuration files: 

        execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Communities configuration :

        CommunitiesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        CommunitiesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. To check the current setting of the active content filter property:

      CommunitiesConfigService.showConfig() Look for the following property in the output that displays: 

      activeContentFilter.enabled = true

    4. To change the value of the active content filter property:

      CommunitiesConfigService.updateConfig("property", "value")

      ...where

      • property is one of the editable Communities configuration properties.
      • value is the new value with which you want to set that property.

      The following table displays information regarding the active content filter property and the type of data that you can enter for it.


      The active content filter property

      Property Description
      activeContentFilter.enabled When enabled, this property prevents the addition of active content (JavaScript, for example) to any Community text input field.

      This property takes a Boolean value: true or false.

      For example: 

      CommunitiesConfigService.updateConfig("activeContentFilter.enabled", "false")

    5. After making changes, check the configuration files back in, and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes in Communities for information about how to save and apply your changes.


    Moderate the content in a community

    When moderation is enabled for the Blogs, Forums, and Files applications, global moderators or community moderators can review community blog, forum, and file content before it is posted to a community, and manage content after it is added to a community.

    If premoderation is enabled for your deployment, when users contribute the following types of content to a community, that content does not display until it is approved by the global moderator or a community moderator.

    • Blog entries and comments
    • File content and comments

    • Forum posts
    You can enable premoderation for one, two, or all three types of content.

    When postmoderation is enabled, the global moderator or community moderator can review community content that has been flagged as inappropriate and the reason given for flagging it. They can then determine whether the content should be removed or the flag dismissed. You can enable postmoderation for one, two, or all three types of content.

    As administrator, you can enable moderation for communities in the contentreview-config.xml.

    For more information about how to configure moderation settings, see Managing content moderation and flagged content.

    When moderation is enabled, the following users can review and manage community content:

      Global moderators
      User assigned the global-moderator J2EE role can review and manage community content from the global moderation interface, which is accessed using the Moderation link in the application menu bar. The link is only visible to logged-in users who have been assigned the J2EE global-moderator role.

      For more information about assigning roles, see Roles.

      Community moderators
      When owner moderation is enabled, community owners can access moderation options for their community by logging into Connections, opening the community, and then clicking Moderation in the community navigation. Community moderators can only manage the content of communities that they own, and they can only do so from the community moderation interface; they cannot access the global moderation interface.

      You can specify whether owner moderation is enabled by changing the value of the ownerModerate setting in the contentreview-config.xml file.

      For more information, see Managing content moderation and flagged content.

    In addition to the global moderation interface and the communities moderation interface, public moderation APIs are available to allow third-party developers to moderate community forum content and community file content.

    For more information, refer to the Forums API section of the Connections 4 API Documentation.


    Allow non-community members to comment in forums

    Allow users who are not community members to comment in forums in public or moderated communities.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    By editing settings in the forum-config.xml file, you can allow users who are not community members to comment in forums in public or moderated communities.

    To allow users who are not community members to comment in forums in public or moderated communities:

    1. cd WAS_HOME/profiles/Dmgr01/bin

    2. Start the Forums Jython script interpreter.

      1. Access the Forums configuration files: 

        execfile("forumsAdmin.py")

        If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

      2. Check out the Forums configuration files by

        ForumsConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the XML and XSD configuration files are copied. The files are kept in this working directory while you modify them.

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

        • cell_name is the name of the WAS cell that hosts the Connections applications. This argument is required. It is also case-sensitive, so type it with care. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example:

        ForumsConfigService.checkOutConfig("/opt/my_temp_dir", "ForumCell01")

    3. Open the forum-config.xml file with a text editor.

    4. Edit the enableNonMembercontributor element in the deployment section of the file. The default value is false.

      For example, to set the value to true, edit the file as follows:

      <deployment enableCategory="false" enableLotusLive="false" enableNonMemberContributor="true"/>

    5. Save your changes and close the forum-config.xml file.

    6. Check in the configuration files in the same wsadmin session in which you checked them out.

      For information about how to save and apply your changes, see Applying property changes in Forums.


    Configure the size of the community description summary

    Use configuration settings to set the maximum size of a community description summary.

    To edit configuration files, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    The community description summary displays on the Public Communities and My Communities pages.

    To set the size of the community description summary....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Start the Communities Jython script interpreter.

      1. Access the Communities configuration files: 

        execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Communities configuration :

        CommunitiesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        CommunitiesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. To change the size of the community description summary:

      CommunitiesConfigService.updateConfig("property", "value") where

      • property is one of the editable Communities configuration properties.
      • value is the new value with which you want to set that property.

      The following table displays information regarding the community description summary property and the type of data that you can enter for it.


      The community description summary property

      Property Description
      descriptionSummary.size Determines maximum size in characters of a community description summary.

      This property takes an integer value.

      For example: 

      CommunitiesConfigService.updateConfig("descriptionSummary.size", "40")

    4. After making changes, check the configuration files back in, and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes in Communities for information about how to save and apply your changes.


    Configure display settings

    Use configuration settings to control the display of data in the Communities application.

    To edit configuration files, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    To configure display settings for Communities....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Start the Communities Jython script interpreter.

      1. Access the Communities configuration files: 

        execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Communities configuration :

        CommunitiesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        CommunitiesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. To view the current configuration settings use this command:

      CommunitiesConfigService.showConfig()

      After updating any of the configuration settings, you can use this command again to display your updates.

    4. To change display settings for Communities:

      CommunitiesConfigService.updateConfig("property", "value")

      where:

      • property is one of the editable Communities configuration properties.
      • value is the new value with which you want to set that property.

      For example: 

      CommunitiesConfigService.updateConfig("pagingSupport.defaultPageSize", "15")

      The following table displays the valid properties that can be updated, and additional information regarding each property and the type of data that you can enter.


      Data display properties

      Property Description
      pagingSupport.communityListTags.pageSize Determines the maximum number of tags displayed on the I’m an Owner, I’m a Member, I’m Following, I’m Invited, and Public Communities views.

      This property takes an integer value.

      For example: 

      CommunitiesConfigService.updateConfig("pagingSupport.communityListTags.pageSize", "75")
      pagingSupport.dbNameTypeAhead.pageSize Determines the maximum number of matching names to display in the type-ahead suggestion field when users start typing the names of people to add to a community. These names are retrieved from the SNCOMM.MEMBERPROFILE database table.

      This property takes an integer value.

      For example: 

      CommunitiesConfigService.updateConfig("pagingSupport.dbNameTypeAhead.pageSize", "50")
      pagingSupport.defaultPageSize Determines the maximum number of entries to display on Communities bookmarks and feeds lists pages. The default value is 10. Decrease the number to speed paging.

      This property takes an integer value.

      For example: 

      CommunitiesConfigService.updateConfig("pagingSupport.defaultPageSize", "25")
      pagingSupport.ldapNameSearch.pageSize Determines the maximum number of LDAP users returned when users click Search Directory to search the LDAP directory for a name when adding members to a community.

      For example: 

      CommunitiesConfigService.updateConfig("pagingSupport.ldapNameSearch.pageSize", "50")
      pagingSupport.memberNameTypeAhead.pageSize Determines the maximum number of users displayed by the type-ahead feature when users click Search Directory to search the LDAP directory for a name when adding members to a community.

      For example: 

      CommunitiesConfigService.updateConfig("pagingSupport.memberNameTypeAhead.pageSize", "15")
      pagingSupport.tagNameTypeAhead.pageSize Determines the maximum number of tags displayed by the type-ahead feature when users add new tags to a community.

      For example: 

      CommunitiesConfigService.updateConfig("pagingSupport.tagNameTypeAhead.pageSize", "10")

    5. After making changes, check the configuration files back in, and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes in Communities for information about how to save and apply your changes.


    Maximum number of communities to display in user views

    You can add a configuration setting to LotusConnections-config.xml to increase the maximum number of communities that can be displayed in the personalized user views.

    The personalized user views available in the Communities application include the following options: I'm an Owner, I'm a Member, I'm Following, and I'm Invited. By default, up to 1000 communities can be displayed in these personalized views. You can increase this limit by adding a setting to the Connections configuration file that specifies the maximum Lucene clause length to apply.

    To increase the maximum number of communities that can be displayed in the personalized user views:

    1. Start wsadmin:

        cd WAS_HOME/profiles/Dmgr01/bin
        ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

    2. Use the wsadmin client to access and check out the Connections configuration files:

      1. Access the Connections configuration file: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out the Connections configuration files:

        LCConfigService.checkOutConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command does not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To get cell name, from wsadmin:print AdminControl.getCell()

        For example:

        • AIX or Linux:

          LCConfigService.checkOutConfig("/opt/temp","Cell01")

          Windows:

          LCConfigService.checkOutConfig("c:/temp","Cell01")

        • IBM i:

          LCConfigService.checkOutConfig("/temp","Cell01")

    3. Use a text editor, open the LotusConnections-config.xml from the local directory to which you checked it out.

    4. Add the following section to the end of the file, before the closing </config> element, replacing the default 1024 with the new limit to specify: 

      <properties>
 <genericProperty name="luceneMaxClauseCount">1024</genericProperty>
</properties>

    5. Save your changes and close LotusConnections-config.xml.

    6. To check in the changed configuration property files: 

      LCConfigService.checkInConfig()

      Perform the check in in the same wsadmin session in which you checked out the files.

    7. After making updates, deploy the changes: 

      synchAllNodes()

    8. To exit the wsadmin client, type exit at the prompt.

    9. Stop and restart all the Connections application servers.


    Hiding the Start a community button from unauthenticated users

    You can prevent unauthenticated users from creating communities by hiding the Start a Community button.

    To edit configuration files, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    When users are logged in to Communities, the Start a Community button displays only when users have permissions to create a community. When users are not logged in, it is not possible to determine their level of access. However, as administrator, you can enable or disable the display of the button globally for all anonymous users by configuring the show.startCommunity.To.Unauthenticated property in the Communities configuration file.

    Users must have the community-creator role in order to create communities.

    For more information about this role, see Roles.

    To configure the show.startCommunity.To.Unauthenticated property....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Start the Communities Jython script interpreter.

      1. Access the Communities configuration files: 

        execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Communities configuration :

        CommunitiesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example:

          CommunitiesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. To check the current setting of the property:

      CommunitiesConfigService.showConfig() Look for the following property in the output that displays:

        show.startCommunity.To.Unauthenticated.enabled = true

    4. To change the value of the show.startCommunity.To.Unauthenticated property:

      CommunitiesConfigService.updateConfig("property", "value")

      ...where

      • property is one of the editable Communities configuration properties.
      • value is the new value with which you want to set that property.

      The following table displays information regarding the show.startCommunity.To.Unauthenticated property and the type of data that you can enter for it.


      The show.startCommunity.To.Unauthenticated property

      Property Description
      show.startCommunity.To.Unauthenticated When enabled, this property displays the Start a Community button to unauthenticated users.

      This property takes a Boolean value: true or false.

      For example: 

      CommunitiesConfigService.updateConfig("show.startCommunity.To.Unauthenticated", "false")

    5. After making changes, check the configuration files back in, and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes in Communities for information about how to save and apply your changes.


    Disable the Public Communities view in Communities

    You can control whether the Public Communities view is available in your organization's deployment of Communities by editing settings in the communities-config.xml file.

    To edit configuration files, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    You can disable the Public Communities view so that users can only see the restricted communities that they belong to.

    1. Use the wsadmin client to access and check out the Communities configuration files.

      1. Access the Communities configuration files: 

        execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Communities configuration :

        CommunitiesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        CommunitiesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    2. Open communities-config.xml in a text editor.

    3. To disable the Public Communities view, add the following lines after the <comm:tagCloud> element and before the <comm:communityHandle> element: 

      <!-- Community Page Configuration -->
<comm:communityPages>
<comm:item name="publicCommunities" value="disabled"/>
</comm:communityPages>

    4. Save your changes.

    5. After making changes, check the configuration files back in, and you must do so in the same wsadmin session in which you checked them out for your configuration changes to take effect. You must also stop and restart the Communities server.

      See Applying property changes in Communities for information about how to save and apply your changes.


    Results

    The disabled page no longer displays in the Communities user interface. If a user tries to navigate to the page by entering its URL directly into the address bar, a message indicating that the page has been disabled displays.


    Enable and disable the community unique web address option

    Enable or disable the community owners ability to create a unique web address for their community.

    To update configuration files, use the wsadmin client.

    See Start wsadmin for details.

    When this option is enabled, the ability to create a unique community web address is provided in the Communities user interface when users create or edit a community or subcommunity. Community members can then use the web address to navigate directly to the community or subcommunity. This feature is enabled by default.

    To enable or disable the community unique web address, you need to update the communityHandle settings in the communities-config.xml file.

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Start the Communities Jython script interpreter.

      1. Access the Communities configuration files: 

        execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Communities configuration :

        CommunitiesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        CommunitiesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. Navigate to the working directory specified in the previous step and open the communities-config.xml file using a text editor.

    4. To configure the unique web address, set the value of the enabled property for the communityHandle to true or false as needed.

      For example, to disable the unique community web address: 

      <comm:communityHandle enabled="false" />

    5. After making changes, check the configuration files back in, and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes in Communities for information about how to save and apply your changes.


    Enable community feeds

    The Connections AJAX proxy is configured to allow cookies, headers or mime types, and all HTTP actions to be exchanged among the Connections applications. However, access to arbitrary URLs is prevented by default.

    To enable users to add feeds with external URLs to communities, you need to update the AJAX proxy configuration file by following the procedure outlined in the topic, Configuring the AJAX proxy.

    For detailed information about how to enable feeds in communities, see step 4.


    Work with managed applications

    Use the ManagedAppService commands to manage the applications that can be installed on community servers, such as IBM Lotus Quickr.


    Administer managed applications

    Communities supports integration with several applications such as IBM Lotus Quickr. You can use managed application commands to administer these applications when they are installed on community servers.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    You use the createLink method to create an association between a list of communities (typically a list of 1) and a managed application. This association between a community and a managed application is called a link.

    You use the various fetch methods to obtain a list of hash maps that represents a link (list with 1 element) or links. This list of links can be assigned to a variable and used as input in other commands to change link settings.

    To administer the managed applications configured on community servers....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Administer managed applications:

        ManagedAppService.listApp()

        List the names and current enabled status of all the applications installed on the Communities server.

        Change the configuration settings of an application does not change the status reported by this command unless the server is restarted.

        ManagedAppService.createLink(List comList, String appName)

        Creates a link to the managed application for each community in the community list comList. Depending on how comList is returned, a link can be created for the following:

        • All communities, when comList is returned by a fetchAllComm command

        • A specific community, when comList (with a single element) is returned by a fetchCommByName command

        • The communities that a specific user is a member or owner of, when comList is returned by the fetchCommByMemberEmail or fetchCommByMemberUuid command

        The first step is to create a list of communities using one of the CommunitiesService fetch commands mentioned previously. When executing the command to fetch the community list, assign the command to a variable. The variable, which contains the output of the fetch command, is used as input for the createLink command. Also, the application name is a string so it must be enclosed in quotes.

        ManagedAppService.deleteLink(List linkList)

        Removes the links between a community (or communities) and an application (or applications) from the specified list of links. Application properties are deleted from the elements in linkList when the application is removed.

        This is a three-step process:

        1. Create a list of the communities that will have their links deleted.

        2. Create a list of the link information for the list of communities generated in step a.

        3. Run the deleteLink command. When executing steps and b, set the command to a variable. The output of the commands is used as input in the next command.

        For example: 

        wsadmin>commbyname=CommunitiesService.fetchCommByName("community name")
wsadmin>linkbycomm=ManagedAppService.fetchLinkByComm(commbyname)
wsadmin>ManagedAppService.deleteLink(linkbycomm)
        This example deletes links for a specific community.

        ManagedAppService.fetchAllLink()

        Return a list of all the links configured on the server.

        ManagedAppService.fetchLinkByComm(List comList)

        Return a list of all the links associated with the specified communities.

        This is a two-step process. The first step is to create a list of communities for which you want to get link information. This is done using the CommunitiesService fetch commands. Lists can be created for all communities, a specific community, or the communities that the specified user is a member or owner of. Set the fetch command to a variable. The output from this command is used as input in the fetchLinkByComm command.

        For example: 

        wsadmin>allcomm=CommunitiesService.fetchAllComm()
wsadmin>ManagedAppService.fetchLinkByComm(allcomm)
        This example retrieves the link information for all communities.

        ManagedAppService.fetchLinkByApp(String appName)

        Return a list of all the links associated with the specified application.

        The application name is a string and must be enclosed in quotes.

        ManagedAppService.fetchLinkByCommApp(List comList, String appName)

        For each community in the list, returns the link associated with the type.

        This is a two-step process. The first step is to create a list of communities for which you want to get the link information. This is done using the CommunitiesService fetch command. Lists can be created for all communities, a specific community, or the communities that the specified user is a member or owner of. Set the fetch command to a variable. The output from this command is used as input in the fetchLinkByCommApp command.

        ManagedAppService.fetchProperty(List linkList)

        Return a list of the properties set for each link in the list.

        The input for this command is a list of links. In the following example, the first step retrieves a list of all the links on the server. The command is set to a variable. The output from the fetch command is the input for the fetchProperty command. 

        wsadmin>links=ManagedAppService.fetchAllLink()
wsadmin>ManagedAppService.fetchProperty(links)

        ManagedAppService.listLink(List linkList)

        Display the links specified in the list in a readable format on the screen. The command prints properties for the links if the linkList argument was obtained with the fetchProperties command.

        The following example lists all the links in a more easily readable format. The first step is to create the list of links. Set the command to a variable. The variable is used as input in the listLink command. 

        wsadmin>links=ManagedAppService.fetchAllLink()
wsadmin>ManagedAppService.listLink(links)

        ManagedAppService.listLinkToFile(List linkList, String fileName)

        Prints the links specified in the list in a readable format to a file. The command prints properties for the links if the linkList argument was obtained with the fetchProperties command.

        The specified path must already exist. The only difference between this command and ManagedAppService.listLink is that a path and file name to which the data is output needs to be specified. 

        wsadmin>links=ManagedAppService.fetchAllLink()
wsadmin>ManagedAppService.listLinkToFile(links,"/temp/data.txt")

        ManagedAppService.updateMainURI(Link link, String URI)

        Update the main URI for this link.

        Update the main URI is a multi-step process. The first step is to get the community. Then you retrieve the link the main URI is updated on, and run the command to update the URI.

        For example: 

        wsadmin>byname=CommunitiesService.fetchCommByName("<community name>")
wsadmin>bycomm=ManagedAppService.fetchLinkByComm(byname)
wsadmin>ManagedAppService.updateMainURI(bycomm.elementAt(0),"http://<new URI>")

        ManagedAppService.updateFeedURI(Link link, String URI)

        Update the feed URI for this link.

        Update the feed URI is a multi-step process. The first step is to fetch the community, the next step is to get the link to the feed the URI is to be updated on, and then issue the command to update the URI.

        In the following example, it is assumed that the community either has a single link, or that is has multiple links and the first one in the list is the one (index 0) to update. If a community has multiple links, you need to be careful to select the correct one. 

        wsadmin>byname=CommunitiesService.fetchCommByName("<community name>")
wsadmin>bycomm=ManagedAppService.fetchLinkByComm(byname)
wsadmin>ManagedAppService.updateFeedURI(bycomm.elementAt(0),"http://<new URI>")

        ManagedAppService.addLinkProperty(Link link, String key, String value)

        Adds or updates the key property for the specified link.

        Add or updating the key property for a link is a multi-step process.

        For example: 

        wsadmin>link=ManagedAppService.fetchLinkByApp("application name")
wsadmin>link2=link.get(0)
// link2=link.elementAt(0) would work as well
wsadmin>ManagedAppService.addLinkProperty(link2,"NewKey","NewValue")

        ManagedAppService.deleteLinkProperty(Link link, String key)

        Removes the key property for the applications in the list.

        This is a multi-step process.

        For example: 

        wsadmin>link=ManagedAppService.fetchLinkByApp("application name")
wsadmin>link2=link.get(0)
// link2=link.elementAt(0) would work as well
wsadmin>ManagedAppService.deleteLinkProperty(link2,"NewKey")


    Change configuration settings for managed applications

    Communities supports integration with a number of applications, including different types of IBM Lotus Quickr places. Use the ManagedAppService commands to display and update properties for these applications, which can (optionally) be installed on community servers.

    To edit configuration files, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    To set properties for the managed applications configured on Communities servers....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Use the following command to retrieve a list of the managed applications on your Communities server: 

      ManagedAppService.listApp()
      Depending on the managed applications that you have installed on your server, something similar to the following is returned: 

      wsadmin>ManagedAppService.listApp()
QuickrPortalTeamspace true
QuickrPortalWiki true

    4. Use the following command to get a Help list of the configuration settings that can be used for any specified application: 

      ManagedAppService.configHelp(String "app")
      For example: 

      wsadmin>ManagedAppService.configHelp("QuickrPortalWiki")
Setting Description
PortalWiki:resourceBundleName resourceBundleName for translated strings
PortalWiki:contentFeedLink name of the contentFeedLink
PortalWiki:name placeTypeName
PortalWiki:enabled Enable place type PortalWiki:server server PortalWiki:publicRole role for public PortalWiki:ownersRole role for Community owners PortalWiki:membersRole role for Community members
PortalWiki:managedApplicationTypeID managed Application Type ID PortalWiki:placeTemplate place template name

    5. Check out the Communities configuration : 

      ManagedAppService.checkOutConfig(String "app", String "working_directory", String "cell_name")

      ...where...

      • app is the name of the managed application, which you can obtain via the ManagedAppService.listApp() command.

      • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

      • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. It is also case-sensitive, so type it with care.

      For example: 

      wsadmin>ManagedAppService.checkOutConfig("QuickrPortalWiki", "c:/TempDir", "LCCell01")

    6. To view a list of the current properties and their values for the checked-out managed application: 

      ManagedAppService.showConfig(String "app")
      For example: 

      wsadmin>ManagedAppService.showConfig("QuickrPortalWiki")
      Here is an example of what you might see after running this command: 

      wsadmin>ManagedAppService.showConfig("QuickrPortalWiki")

 Configuration properties:
        PortalWiki:resourceBundleName = com.ibm.lconn.comm.quickr.resources.QuickrWikiResources
        PortalWiki:contentFeedLink = wikis         PortalWiki:name = PortalWiki
        PortalWiki:enabled = true
        PortalWiki:server = DefaultServer
        PortalWiki:publicRole = Readers
        PortalWiki:ownersRole = Managers         PortalWiki:membersRole = Editors
        PortalWiki:managedApplicationTypeID = QuickrPortalWiki
        PortalWiki:placeTemplate = Team Wiki

    7. To change a managed application configuration setting, use the following command: 

      ManagedAppService.updateConfig(String "app", String "property", String "value")

      ...where...

      • app is the name of the managed application.
      • property is one of the managed application configuration properties that can be edited.
      • value is the new value with which you want to set that property.

      The following commands that can be used to configure managed applications:

        ManagedAppService.checkOutConfig(String "app", String "working directory", String "cell name")

        Checks out the configuration file for the specified application.

        The working directory must be a directory that already exists.

        ManagedAppService.showConfig(String "app")

        List the configuration settings for the specified application. This command also displays the settings that can be configured.

        ManagedAppService.updateConfig(String "app", String "property", String "value")

        Updates a specific property in the configuration file for the specified application.

        Each application has its own set of configuration properties. The listApp method lists the properties for an application.

        ManagedAppService.checkInConfig(String "app")

        Checks in the configuration file for the specified application.

        ManagedAppService.configHelp(String "app")

        Prints the help messages for the configuration settings that can be set for the specified application.

    8. Repeat the previous step once for each property setting to change.

    9. Use the ManagedAppService.showConfig command to display the updated settings in the working directory before you check them in.

    10. When you have finished updating the managed application settings to save and apply your changes: 

      ManagedAppService.checkInConfig(String "app")

    Before your changes can take effect, you need to stop and restart the Communities server.


    Manage the Communities catalog

    The Communities catalog enables you to display content from IBM Lotus Quickr places in the Communities application.

    Sources are connections to servers or clusters that contain Quickr places. The servers publish metadata about their communities and places, and sources collect that metadata in an index. Community metadata then displays in lists of communities in the I'm an Owner, I’m a Member, I’m Following I’m Invited and Public Communities views. By default metadata is collected automatically on a schedule, but you can control collections for each source.

    Only places metadata is collected, not the actual community or place content.


    Configure the Communities catalog administrator role

    To add sources and manage the Communities catalog, you must be a catalog administrator.

    You can configure the catalog administrator role by assigning the admin role in the IBM WebSphere Application Server Integrated Solutions Console to the users or group to perform catalog management. Mapping a user to this role lets the user see the Administration link in the Communities navigation.

    1. Log in to the WAS admin console.

    2. Click Application > Application Types > Websphere Enterprise Applications > Communities.

    3. Select Security role to user/group mapping.

    4. Find the admin role.

    5. Add the users or group to administer the Communities catalog, and then click Save.


    Add sources to the Communities catalog

    Add sources to make IBM Lotus Quickr places available to users in the Communities catalog.

    To add sources, you must log in to Connections as the catalog administrator.

    For more information, see Configure the Communities catalog administrator

    Sources are connections to servers or clusters that contain Quickr places. The servers publish metadata about their communities and places, and sources collect that metadata in an index. Community metadata then displays in lists of communities in the I'm an Owner, I’m a Member, I’m Following I’m Invited and Public Communities views. By default metadata is collected automatically on a schedule, but you can control collections for each source.

    Only places metadata is collected, not the actual community or place content.

    To add sources to the Communities catalog....

    1. Click any option under Communities and then select Administration from the navigation sidebar.

    2. Click Add Source.

    3. Enter the name by which the source is identified in the Name field.

    4. In the User field, enter the name of the administrator that is used in authentication.

    5. In the Password field, enter the password that the administrator uses for authentication.

    6. Enter the address of the server that provides the seedlist in Server URL field.

    7. Type of place metadata to be indexed, like Lotus Quickr for WebSphere Portal Places.
    8. View the

      Seedlist URL field. The seedlist URL is the URL composed automatically by concatenating the server URL and the known seedlist postfixes. In most Connections and Quickr installations, the composed URL is correct and there is no need to change it. If you do need to change it, click Change URL.

    9. Select how frequently this source is crawled for new data to collect in the Collect every field, and then click OK.

    For information about managing Communities catalog sources, see Managing Communities catalog sources.


    Manage Communities catalog sources

    Perform management tasks for the Communities catalog using the options available from the administrative user interface.

    To perform management tasks for the Communities catalog, you must log in as the catalog administrator.

    For more information about this role, see Configure the Communities catalog administrator.

    In clustered environments, Communities catalog administration is on the primary node. If you see a message that says that the primary node is not available, your can switch the catalog administration to a secondary node.

    1. Log in to Connections as the catalog administrator.

    2. Click any option under Communities and then select Administration from the navigation sidebar.

    3. Perform one or more of the following tasks:

      • To see the number of items (communities or places), see the Number of items column.

      • To see the status of a source (available or not) see the Status column.

      • To edit a source, click Edit Details.

      • To manage source metadata collection, click More actions and then perform any of the following tasks:

        • To have this source crawled for new data to collect now, select Collect Data.

        • To delete the metadata for the source from the index, select Clear Data.

        • To disable future scheduled metadata collections, select Disable Schedule. This action stops future collections, but does not delete existing metadata from the index.


    Add Connections nodes to the Communities catalog

    You can add Connections nodes to an existing catalog in Communities. Whenever the main node stops operating, another node can automatically start collecting data.

    When you add Connections nodes to an existing Communities catalog, you must be sure that you disable scheduled metadata collections.

    1. Log in to Connections as catalog administrator.

      See Configure the Communities catalog administrator for information about how to configure this role.

    2. Go to Communities and select Administration from the navigation sidebar.

    3. Disable source metadata collection by selecting More actions > Disable Schedule. This action stops future collections but does not delete existing metadata from the index.

    4. Copy the catalog index folder from an existing node to the new node by following these steps:

      1. Log in to the Integrated Solutions Console and click Servers > Clusters > WebSphere application server clusters.

      2. Click cluster_name, where cluster_name is the name of the catalog cluster.

      3. In the Additional Properties area, expand Cluster members and then click Details.

      4. In the table of cluster members, make a note of the nodes that host the cluster members.

      5. The catalog index folder should be copied from an existing node to the new node.

        See Configure Communities catalog settings for more information.

        The following path is an example only and might be different on your operating system:

        • AIX or Linux: /opt/IBM/Connections/DataLocal/catalog/index/Places
        • Windows: C:\IBM\Connections\data\local\catalog\index\places

        • IBM i: /QIBM/ProdData/IBM/Connections/data/local/catalog/index/Places

    5. To enable source metadata collection, select More actions > Enable Schedule.


    Configure Communities catalog settings

    Follow these instructions to configure the catalog index folder and the catalog shared replication folder.

    You need both a catalog index folder and a catalog shared replication folder when you add Connections nodes to an existing catalog. The catalog index folder stores the actual index. You need one of these for each server. The catalog shared replication folder stores the changes that have been recently made to the index. You need one shared replication folder for each server cluster.

    One node builds the index, stores it locally and saves a copy to the shared folder. The other nodes pick up the built index. Additional incremental indexes save the delta to the shared folder where other Communities nodes can pick up the change and merge it into their local copy.

    1. Log in to the WAS admin console.

    2. Expand Environment and select Websphere Variables.

    3. Change CATALOG_INDEX_DIR to the location of the local catalog index folder.

    4. Change CATALOG_REPLICATION_DIR to change the location of the shared replication folder. All nodes need access to this shared folder.

    5. Click Save.


    Restore the Communities catalog index

    If the Communities catalog index becomes corrupt or is not being refreshed properly, you can delete the existing index data to rebuild the index.

    The IBM WebSphere Application Server variables CATALOG_INDEX_DIR and CATALOG_REPLICATION_DIR define the location of the catalog index directory and the replication directory respectively. If there are issues with the existing catalog index, you can restore it by deleting the contents of these directories. The catalog index is rebuilt when the next scheduled crawl takes place.

    1. Log in to Connections as the catalog administrator.

    2. Go to Communities and select Administration from the navigation sidebar to open the Communities Catalog Administration page.

    3. Disable all the crawlers listed on the page by selecting More actions > Disable Schedule for each crawler.

    4. Find the value of the CATALOG_REPLICATION_DIR and CATALOG_INDEX_DIR WebSphere Application Server variables.

      1. Log in to the WebSphere Integrated Solutions Console.

      2. Expand Environment and select Websphere Variables.

      3. Look for the CATALOG_REPLICATION_DIR and CATALOG_INDEX_DIR variables and make a note of their respective locations.

    5. Navigate to the location specified by the CATALOG_REPLICATION_DIR variable and delete the contents of the directory.

    6. Navigate to the location specified by the CATALOG_INDEX_DIR variable and delete the contents of the directory.

    7. Return to the Communities Catalog Administration page and enable all the crawlers.


    Administer widgets and remote applications

    You can extend your community to include various components or applications. These applications are contained within the community as widgets. You can administer widget lifecycle events to ensure that changes are synchronized between the Communities server and the servers hosting the widgets.

    Communities has several widgets that are automatically added when the community is first created. These widgets include the Bookmarks, Files, Forums, Status Updates, Recent Updates, and Members widgets. The Bookmarks, Files, Status Updates, and Forums widgets are added by default, but can be removed or hidden. The Recent Updates and Members widgets are default widgets, and cannot be removed or hidden. In addition, community owners can optionally add the Activities, Blogs, IdeationBlog, Events, Feeds, Subcommunities, Media Gallery, Related Communities, and Wiki widgets. Of these widgets, the Activities, Blogs, IdeationBlog, Files, Forums, Status Updates, and Wiki widgets are affected by lifecycle events.

    When you create a community and add a widget to it, such as the Activities widget, any activities added to the community are owned by the community. Only members of the community can access those activities and, if the community's membership changes, or if the community is deleted, then the Activities widget must be updated with those changes. Provided that the Communities server and the widget (Activities, in this example) server are both up and running, these changes are applied to the widget immediately.

    However, if the widget server is down for some reason, the changes need to be synchronized when the server is back up and fully running again. If an event cannot be pushed out to the widget server, the event is queued in a Communities database table, LC_EVENT_REPLAY. The IBM WebSphere Application Server scheduler attempts to push queued events to the widget server's event handler on a scheduled basis until it is successful. When multiple events are queued for a single widget, the events are tried in consecutive order, with the oldest events tried first. You can use the CommunitiesQEventService commands to manually administer queued events when there is a problem with WAS scheduler and you don't want to wait for the next scheduled retry task to run.

    For more information about these commands, see Administering community queued events.

    Changes are only pushed from Communities to the Activities, Blogs, IdeationBlog, Files, Forums, Status Updates (News), and Wiki applications. Changes to these applications are not pulled into Communities. The changes that are pushed out to the widget servers include the following:

    • Membership changes.

      For example, when users are added, removed, or when membership roles are changed.

    • Community privacy setting changes.

      For example, when a community is changed from public to private and vice versa.

    • Widget addition or removal.

      For example, when the activities, blog, files, and wiki widgets are added to or removed from a community.

    • Updates to community information.

      For example, changes to the community name, description, or tags.

    • Community deletion.

    The widgets-config.xml file contains a section for each of the widgets available in Communities. Each widget section contains configuration settings for the widget's life cycle and lists the events that correspond to the widget.

    For more information about this file, see Using widgets-config.xml for Communities.


    Use widgets-config.xml for Communities

    The widgets-config.xml files contains configuration settings for each of the widgets supported by Communities and Profiles. To update settings in the file, check the file out and, after making changes, check the file back in the same wsadmin session as the checkout for the changes to take effect.

    To edit configuration files, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    The widgets-config.xml file defines the widgets available for use in Communities and specifies the life-cycle events associated with each widget. You can edit configuration settings in this file to perform various tasks.

    For example, if you want to make custom widgets available, you define the widgets in this file. You also need to edit settings in this file if you want to specify a different system user for managing widget life-cycle events.

    For more information, see Specifying different system users for widget life-cycle events.

    To configure settings in widgets-config.xml for Communities....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Check out widgets-config.xml

      CommunitiesConfigService.checkOutWidgetsConfig("working_directory", "cell_name")

      where:

      • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them. When specifying the path to a working directory or temporary directory where the checked out files are to be placed, use a forward slash as the path separator, even for Microsoft Windows systems.

      • cell_name is the name of the WAS cell hosting the Communities application. This argument is required. It is also case-sensitive, so type it with care.

      For example: 

      CommunitiesConfigService.checkOutWidgetsConfig("C:/tmp2","MyCell01")

    4. Navigate to the temporary directory where you saved widgets-config.xml.

      Open this file in a text editor and find the section that pertains to Communities. The configuration settings for Communities appear following the section that begins with <resource type="community" . Make the required changes.

    5. Apply your changes by doing the following:

      1. Check in the updated widgets-config.xml file

        CommunitiesConfigService.checkInWidgetsConfig("working_directory", "cell_name")

        For example: 

        CommunitiesConfigService.checkInWidgetsConfig("C:/tmp2","MyCell01")

      2. To exit the wsadmin client, type exit at the prompt.

      3. Restart the Communities application using WAS admin console.


    Add custom widgets to Communities

    Extend the functionality of the Communities application by adding custom widgets. To make the widgets available for use in Communities, you need to configure the widgets in the widget definition file, widgets-config.xml.

    You can use custom widgets to bring additional functionality to the Communities application. Making custom widgets available gives community owners greater control and flexibility over the content of a community. The widgets must use the iWidget specification, which uses technology based on JavaScript, XML, HTML, and CSS. The widget files are stored on an HTTP server. The widgets can be bundled as EAR applications and deployed on IBM WebSphere Application Server. They can also be hosted in LAMP, .NET, and other environments.

    You need to register the widgets developed by iWidget developers to make them available for use in Connections. You do this by configuring the widget attributes defined by the iWidget developer in widgets-config.xml.

    You can add three types of custom widget to Connections:

      Mandated
      This type of widget exists in every community and cannot be removed or hidden. Mandated widgets can exist outside a community, for example, they can show up in a search results page. This type of widget can be placed in any of the three columns on the overview page. Mandated widgets can also be placed in the first column under the tag cloud in Communities. In Communities, the Recent Updates and Members widgets are mandated widgets.

      Added by default
      Displays by default, but can be removed or hidden. Can be moved to a different location. In Communities the Forums, Bookmarks, Files, and Status Updates widgets are all added by default.

      To confirm changes made
      This type of widget is not included by default. To confirm changes made widgets can be added, removed, hidden, and moved by community owners.
    Any widget can be used as a mandated, default, or optional widget.


    Enable custom widgets for Communities

    To make custom widgets available for use in Communities, configure the widgets in the Communities section of the widget definition file, widgets-config.xml.

    To edit configuration files, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    The widgets-config.xml file is used by the Communities and Profiles applications and contains settings for both applications. Your changes must be made in the Communities section of the file.

    The widgets-config.xml file contains information about widget definitions, widget attributes, widget location, default widget templates, and page definitions. Custom widget attributes are defined by the widget developer but, as administrator, you need to configure the widgets by adding a <widgetDef> element containing the appropriate attributes for each widget in the widget configuration file.

    You can integrate a custom widget as part of Connections and you can also integrate the widget as an external application. To integrate the widget inside the Connections application, your widget must provide a full page mode. To integrate the widget externally, you must use a navBarLink attribute to register a navigation link along with your widget configuration information. You should also include the community inline business card in the external application to allow community members to navigate back to the community.

    For more information, see Integrating the Communities business card.

    To configure a custom widget for use in Communities, complete the following steps.

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Check out widgets-config.xml

      CommunitiesConfigService.checkOutWidgetsConfig("working_directory", "cell_name")

      where:

      • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them. When specifying the path to a working directory or temporary directory where the checked out files are to be placed, use a forward slash as the path separator, even for Microsoft Windows systems.

      • cell_name is the name of the WAS cell hosting the Communities application. This argument is required. It is also case-sensitive, so type it with care.

      For example: 

      CommunitiesConfigService.checkOutWidgetsConfig("C:/tmp2","MyCell01")

    4. Open the widgets_config.xml file and define the custom widget by specifying a resource type of community and adding a <widgetDef> element using the following attributes and parameters:


      Widget configuration attributes and parameters

      Attribute Description Required
      defId The widget name. The defId attribute is also used as a title or a resource bundle key. Yes
      primaryWidget Specifies that the widget displays in the center column of the page. The default value is true.

      The value of primaryWidget must be true for Library widgets in Communities.

      		No
      description Description of the widget that displays in the widget palette. This attribute uses the custom string framework.

      For information about how to add a string containing the widget description, see Adding custom strings for widgets and other specified scenarios.

      		No
      category The category in which the widget is placed in the widget palette. This attribute uses the custom string framework.

      For information about how to add a string that specifies the widget category, see Adding custom strings for widgets and other specified scenarios.

      		No
      requires Specifies which Connections applications are required for the widget to function. The XML attribute values must match the serviceReference values in LotusConnections-config.xml. No
      url Location of the widget descriptor. This XML attribute can be parameterized with substitution variables. Yes
      modes Specifies the modes that are supported by the custom widget. Possible modes include:

      • view. This mode enables the widget to display on the community overview page page.
      • search. This mode integrates the widget into a community's search results page. Each widget displays as a separate tab on the page.
      • fullpage. This mode integrates the widget into the navigation bar. When users click the widget link in the navigation bar, the widget displays in a full page view in the community.
      • edit. This mode enables the Edit menu option in the widget's action menu, allowing community owners to edit the preferences of the widget inline, directly from the community's Overview page. The widget is also integrated in to the Edit Community page as a separate tab.
      		No
      uniqueInstance Specifies whether the widget supports multiple instances on the same page. The default value is false. No
      resourceOwnerWidget Specifies whether the widget should be seen only by the community owners or profile owner. Set this to true or false as required. No
      navBarLink Specifies the URL to an external application. A link to this URL is added to the navigation bar when the widget is part of the community. The URL can contain substitution variables. No
      helpLink Specifies the URL to an HTML file containing help documentation for the widget. The help opens in a pop-up window. This parameter can contain subvariables. It can also be parameterized with substitution variables. No
      showInPalette Specifies if the widget should be displayed in the content palette. No
      loginRequired Specifies that the widget displays only when users are logged in. No
      bundleRefId The resource bundle reference ID that is defined in LotusConnections-config.xml. This ID is used to determine the bundle strings for the widget category, widget description, and widget title.

      For more information about adding custom strings for widgets, see Adding custom strings for widgets and other specified scenarios.

      		No


      The page element

      Attribute Description
      pageId Contains the pageId for the page that Communities uses to render the widget layout.

      This attribute takes a string value. Possible values include communityOverview, allCommunities, and myCommunities.


      The widget instance element

      Attribute Description
      uiLocation Defines the location of the widget on the page. You can set this to col1, col2, or col3.

      This attribute takes a string value.

      defIdRef Defines the widget definition to which the instance is bound.

      This attribute takes a string value.

      When adding custom strings using the resource bundle loader, the value of the category, description, and widgetDef attributes in the <widgetDef> element are used as the resource key for your custom bundle.

      For more information about adding custom strings for widgets, see Adding custom strings for widgets and other specified scenarios.

      For example: 

      <config id="widgets">
    <resource type="profile">
    .....
    </resource>
    <resource type="community">
        <widgets>
          <definitions>
            <widgetDef defId="HelloWorld"                  
                       primaryWidget="false" modes="view fullpage edit search"                   
                       url="{contextRoot}/comm.widgets/helloWorld/HelloWorld.xml?version={version}"/> 
                       <!-- XML attribute with substitution variables -->
          </definitions>
          <layout resourceSubType="default">
              <page pageId="communityOverview"> 
                <!-- page definitions and the mandated widgets assigned to them-->
                <widgetInstance uiLocation="col3" defIdRef="Members"/> 
                   <!-- mandated widget UI location: possible values: col1, col2, col3 -->
              </page>
              <page pageId="allCommunities"/> <!-- All Communities Page: only col1 is supported-->
          </layout>
        </widgets>      </resource>
    .....
</config>
      The url, navBarLink, and item or @value XML attributes can be parameterized using substitution variables.

      For more information about the substitution variables used, see Communities widget configuration variables.

    5. To specify that a widget is opened by default, add it to the <template> element.

      For example: 

      <templates> <!-- default template will be used to display the default widgets -->    
  <template id="default">
    <widgetInstance instanceId="StatusUpdates1" defIdRef="StatusUpdates" uiLocation="col2statusposts"/>
    <widgetInstance instanceId="ForumInstance1" defIdRef="Forum" uiLocation="col2"/>
    <widgetInstance instanceId="BookmarksInstance1" defIdRef="Bookmarks" uiLocation="col2"/>
    <widgetInstance instanceId="FilesInstance1" defIdRef="Files" uiLocation="col2"/>
  </template>
</templates>

    6. Apply your changes by doing the following:

      1. Check in the updated widgets-config.xml file

        CommunitiesConfigService.checkInWidgetsConfig("working_directory", "cell_name")

        For example: 

        CommunitiesConfigService.checkInWidgetsConfig("C:/tmp2","MyCell01")

      2. To exit the wsadmin client, type exit at the prompt.

      3. Restart the Communities application using WAS admin console.

    If you are adding widgets that are hosted on third-party servers, then you might need to update your proxy configuration.

    For more information on configuring the Ajax proxy for Communities, see Configure the AJAX proxy for a specific application.


    Communities widget configuration variables

    The following table lists the configuration variables that can be used for the url, navBarLink, helpLink, and item or @value attributes when configuring a third-party widget for integration with Communities. The @value attribute refers to the value attribute in the item of the itemSet configuration elements in widgets-config.xml.


    Communities widget configuration variables

    Variable Description
    resourceId The communityUuid of the community in use.
    lastMod The timestamp for the last time that the community was updated.
    userid Connections user ID of the logged-in user. This variable is returned as undefined if the user is not logged in.
    email The email address of the logged-in user. This variable is returned as undefined if the user is not logged in.
    version The timestamp form, versionStamp, in LotusConnections-config.xml. This is updated on customizations and upgrades to ensure that static content URLs are updated.
    lang The language parameter.
    contextRoot The context root of the application.

    For example: /communities

    communitiesSvcRef The service reference for the Communities application, as defined in LotusConnections-config.xml.

    For example: http://localhost:9080/communities

    profilesSvcRef The service reference for the Profiles application, as defined in LotusConnections-config.xml.

    For example: http://localhost:9080/profiles

    dogearSvcRef The service reference for the Bookmarks application, as defined in LotusConnections-config.xml.

    For example: http://localhost:9080/dogear

    blogsSvcRef The service reference for the Blogs application, as defined in LotusConnections-config.xml.

    For example: http://localhost:9080/blogs

    activitiesSvcRef The service reference for the Activities application, as defined in LotusConnections-config.xml.

    For example: http://localhost:9080/activities


    Specify different system users for widget life-cycle events

    Specify a system user to manage widget life-cycle events that overrides the default authentication alias created at installation time.

    To edit widgets-config.xml in step 2, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    When you install Connections, the installation wizard automatically creates an authentication alias named connectionsAdmin alias that holds the user ID and password for the system user that is used for every event posting in Connections. You can override this alias to specify different system users to manage widget life-cycle events for Communities.

    Widget life-cycle events are used to notify widget content providers of changes in the community that contains the widget.

    For example, if a community owner adds the Blog widget to a community, whenever changes are made to the community, widget life-cycle events notify the Blogs application of those changes.

    To specify a different system user for widget life-cycle POSTs, you must first create a J2C authentication alias and then update widgets-config.xml to use this new alias. After performing these tasks, you need to map the user in the aliases to the widget-admin role.

    1. To create an J2C authentication alias for Communities, complete the following steps:

      1. From the IBM WebSphere Application Server Integrated Solutions Console, expand Security, and then select Global security.

      2. In the Authentication area, expand Java Authentication and Authorization Service, and click J2C authentication data.

      3. Click New.

      4. Enter an alias name, user ID, and password. For clarity, use an alias name that follows the syntax widgetservice nameAlias, where service name is the name of the application for which you want to create the alias.

        For example, widgetBlogsAlias.

      5. Click OK.

      6. Repeat steps 1.c- 1.e for each application for which you want to define a new alias.

      7. Click Save, and then click Save again.

    2. Update widgets-config.xml to use the new alias.

      1. Start the wsadmin client:

          WAS_HOME/profiles/Dmgr01/bin

        You must start the client from this directory or subsequent commands that you enter do not execute correctly.

      2. Start the Communities Jython script interpreter 

        execfile("communitiesAdmin.py")

        If you are asked to select a server, you can select any server.

      3. Check out widgets-config.xml

        CommunitiesConfigService.checkOutWidgetsConfig(“working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

        • cell_name is the name of the WAS cell hosting the Communities application. This argument is required. It is also case-sensitive, so type it with care.

        For example: 

        CommunitiesConfigService.checkOutWidgetsConfig("C:\\tmp2","JRDESKTOP1Node01Cell")

      4. Navigate to the temporary directory where you saved widgets-config.xml, and open the file in a text editor.

      5. Change the remoteHandlerAuthenticationAlias attribute in the life-cycle element for the widgetDef (widget definition) corresponding to the application that is to be changed. Be sure to include the full name of the alias, which is likely to include a nodename prefix.

        For example: 

        <widgetDef defId="Blog" 
           requires="blogs" 
           modes="view edit search" 
           url="{contextRoot}/blogs/blogsWidget.jsp?version={version}"
           navBarLink="{blogsSvcRef}/{resourceId}" description="blogsDescription" uniqueInstance="true"
           helpLink="{contextRoot}/help/doc/{lang}/community_blog_frame.html">

    <itemSet>
        <item name="communitiesBaseUrl" value="{communitiesSvcRef}" />
            <item name="blogsBaseUrl" value="{blogsSvcRef}" />
            <item name="profilesBaseUrl" value="{profilesSvcRef}" />
            <item name="atomFeedUrl" value="{blogsSvcRef}/atom/blogs?commUuid={resourceId}" />
            <item name="atomPubUrl" value="{blogsSvcRef}/api/blogs?commUuid={resourceId}" />
        <item name="searchUrl" 
           value="{blogsSvcRef}/atom?search={searchTerm}&amp;commUuid={resourceId}&amp;ps=5&amp;page=0&amp;sortby=0&amp;order=desc&amp;lang=en" />
    </itemSet>
    <lifecycle remoteHandlerURL="{blogsInterSvcRef}/roller-ui/BlogsWidgetEventHandler.do"                   
               remoteHandlerAuthenticationAlias="connectionsAdmin">
       <event>remote.app.added</event>         
       <event>remote.app.removed</event>         
       <event>community.visibility.changed</event>         
       <event>community.prepare.delete</event>         
       <event>remote.app.transfer</event>
      </lifecycle>                                             
</widgetDef>

      6. Repeat step 2.e for each application that has a new alias.

      7. Apply your changes by doing the following:

        1. Check in the updated widgets-config.xml file

          CommunitiesConfigService.checkInWidgetsConfig(“working_directory", "cell_name")

          For example: 

          CommunitiesConfigService.checkInWidgetsConfig("C:\\tmp2","JRDESKTOP1Node01Cell")

        2. To exit the wsadmin client, type exit at the prompt.

        3. Restart the Communities application using WAS admin console.

    3. Map the user in the alias to the widget-admin role.

      Note that for Activities, the user mapped to the widget-admin role must also be mapped to the person role.

      For more information, see Roles.

      1. From WAS admin console, select Applications > Application types, select WebSphere enterprise applications, and then select the application to configure.

      2. Click Security role to user/group mapping in the Detail Properties area.

      3. Locate the widget-admin role in the Role column, and then click Look up users to look up a user or Look up groups to look up a group.

      4. In the Search String field, type the name of the person or group to assign to this role and click Search.

        If the user or group exists in the LDAP directory, it is returned and displayed in the Available list.

      5. Select the user or group name from the Available list, and then move it into the Selected column by clicking the arrow.

      6. Repeat steps 3.d and 3.e to add additional people or groups.

      7. Repeat steps 3.c through 3.f to define access levels and assign people to any other aliases that you created.

      8. Click OK.

      9. From the Enterprise Applications > <application> > Security role to user/group mapping page, click OK, and then click Save to save the change

    4. Restart all of your WebSphere Application Server instances to make use of the new configuration.


    Administer community queued events

    Use the CommunitiesQEventService commands to administer the life-cycle events that occur within a community.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    When a community member makes a change in a community, for example, if they add a new application to the community or change the privacy level of the community, remote applications can choose to be notified of this change by an event. If the remote application is unavailable or is otherwise unable to process the event, the event is stored in a queue. When the IBM WebSphere Application Server scheduler runs the LifeCycleRetryQueuedEvents task, the event is processed. However, if, for some reason, you don't want to wait for the scheduled task, you can manage these queued events manually by running the CommunitiesQEventService commands.

    To administer the queued events associated with a community....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Administer queued events.

      • To retrieve a list of the events currently queued for processing, use the following commands:

          CommunitiesQEventService.viewQueuedEventsSummary()

          Lists a summary of all of the life-cycle replay events that are currently queued for processing.

          CommunitiesQEventService.viewQueuedEventsByResourceType(String resourceType, HashMap lastEvent, int maxRows)

          List the queued life-cycle replay events with the specified resource type, where:

          • resourceType is the string "community".
          • lastEvent specifies the last row of the previous batch. This is a HashMap object. To obtain the first batch, specify None.
          • maxRows is the number of rows to be retrieved and viewed with a single command. Use maxRows when there is a large number of rows, 200, for example, to break up both the database reads and the display into batches.

          For example: 

          CommunitiesQEventService.viewQueuedEventsByResourceType("community", None, 100)

          This command returns a HashMap that is the last viewed row. When there are no more rows, the value None is returned. This makes it straightforward to loop over all rows a few rows at a time.

          For example, you might use the following Jython code to display all queued events of resourceType community in batches of 10 when there are 200 events: 

          lastRow = CommunitiesQEventService.viewQueuedEventsByResourceType("community", None, 10)
while (lastRow != None)
lastRow = CommunitiesQEventService.viewQueuedEventsByResourceType("community", lastRow, 10)

          CommunitiesQEventService.viewQueuedEventsByResourceId(String resourceType, String resourceId, HashMap lastEvent, int maxRows)

          List the queued life-cycle replay events with the specified resource type and resource ID, where:

          • resourceType is the string "community".
          • resourceId is the communityUuid. This is a string.
          • lastEvent is a HashMap object.
          • maxRows is the number of rows to be retrieved and viewed with a single command. Use maxRows when there is a large number of rows, 200, for example, to break up both the database reads and the display into batches.

          This command returns a HashMap, which is the last viewed row. When there are no more rows, the value None is returned. This makes it straightforward to loop over all rows a few at a time.

          For example: 

          CommunitiesQEventService.viewQueuedEventsByResourceId("community", "e952cf0c-a86c-4e26-b1e0-f8bf40a75804", None, 100)

          For example, you might use the following Jython code to display all queued events of resourceType "community" and resourceId b46300c7-7837-4ba3-b26b-3fcf67a75bba, in batches of 10 when there are 200 entries: 

          lastRow = CommunitiesQEventService.viewQueuedEventsByResourceId("community", "b46300c7-7837-4ba3-b26b-3fcf67a75bba", None, 10)
while (lastRow != None)
lastRow = CommunitiesQEventService.viewQueuedEventsByResourceId("community", "b46300c7-7837-4ba3-b26b-3fcf67a75bba", None, 10)

          CommunitiesQEventService.viewQueuedEventsByRemoteAppDefId(String remoteAppDefId, HashMap lastEvent, int maxRows)

          List the queued life-cycle replay events associated with the specified remote application ID, where:

          • remoteAppDefId is one of the following: Activities, Blog, IdeationBlog, Files, Forum, Wiki, and StatusUpdates. The application IDs are case sensitive and must be entered as indicated in this documentation.
          • lastEvent specifies the last row of the previous batch. This is a HashMap object. To obtain the first batch, specify None.
          • maxRows is the number of rows to be retrieved and viewed with a single command. Use maxRows when there is a large number of rows, 200, for example, to break up both the database reads and the display into batches.

          This command returns a HashMap that is the last viewed row. When there are no more rows, the value None is returned. This makes it straightforward to loop over all rows a few at a time.

          For example: 

          CommunitiesQEventService.viewQueuedEventsByRemoteAppDefId("Blog", None, 100)

          Thus, to display all queued events of remoteAppDefId type Activities in batches of 10, when there are 200 entries, you might code in Jython: 

          lastRow = CommunitiesQEventService.viewQueuedEventsByRemoteAppDefId(“Activities”, None, 10)
while (lastRow != None)
lastRow = CommunitiesQEventService. viewQueuedEventsByRemoteAppDefId(“Activities”, lastRow, 10)

      • Use the following commands to retry events that have failed to process. After running one of these commands, run the CommunitiesQEventService.viewQueuedEventsByResourceType command to make sure the queue is empty. In some rare cases it may be necessary to run a retryQueuedEvents command multiple times to process and remove all events:

          CommunitiesQEventService.retryQueuedEventsByResourceType(String resourceType)

          Retries queued life-cycle replay events with the specified resource type, where resourceType is a string. The value of resourceType is always "community".

          The return value is either "retry succeed" or 0. 0 indicates failure.

          For example: 

          CommunitiesQEventService.retryQueuedEventsByResourceType("community")

          CommunitiesQEventService.retryQueuedEventsByResourceId(String resourceType, String resourceId)

          Retries queued life-cycle replay events with the specified resource type and resource ID, where resourceType and resourceId are both strings.

          The resourceType parameter is always set to "community". The resourceId parameter is a value that can be obtained using one of the CommunitiesQEventService.viewQueuedEvents commands.

          The return value is either 1 or 0. 1 indicates success; 0 indicates failure.

          For example: 

          CommunitiesQEventService.retryQueuedEventsByResourceId("community", "e952cf0c-a86c-4e26-b1e0-f8bf40a75804")

          CommunitiesQEventService.retryQueuedEventsByRemoteAppDefId(String remoteAppDefId)

          Retries queued life-cycle replay events with the specified associated application ID, where remoteAppDefId is one of the following: Activities, Blog, IdeationBlog, Files, Forum, Wiki, and StatusUpdates. The application IDs are case sensitive and must be entered as indicated in this documentation.

          The return value is either 1 or 0. 1 indicates success; 0 indicates failure.

          For example: 

          CommunitiesQEventService.retryQueuedEventsByRemoteAppDefId("Wiki")

      • Use the following commands to clear the queue of events waiting to be processed.

        For example, if your organization has communities that have activities associated with them and you uninstall the Activities application from your deployment, you need to purge Activities events so that they aren't perpetually retried. Use these commands with care.

          CommunitiesQEventService.clearQueuedEventsByResourceType(String resourceType)

          Clears queued life-cycle replay events with the specified resource type, where resourceType is a string. The events are removed from the queue and are not processed.

          The resourceType parameter is always "community".

          The return value is the number of events that were cleared.

          For example: 

          CommunitiesQEventService.clearQueuedEventsByResourceType("community")

          CommunitiesQEventService.clearQueuedEventsByResourceId(String resourceType, String resourceId)

          Clears queued life-cycle replay events with the specified resource ID, where resourceType and resourceId are both strings. The events are removed from the queue and are not processed.

          The resourceType parameter is always set to "community". The resourceId parameter is a value that can be obtained using one of the CommunitiesQEventService.viewQueuedEvents commands.

          The return value is the number of events that were cleared.

          For example: 

          CommunitiesQEventService.clearQueuedEventsByResourceId("community", "e952cf0c-a86c-4e26-b1e0-f8bf40a75804")

          CommunitiesQEventService.clearQueuedEventsByRemoteAppDefId(String remoteAppDefId)

          Clears queued life-cycle replay events with the specified associated application ID, where remoteAppDefId is one of the following: Activities, Blog, IdeationBlog, Files, Forum, Wiki, and StatusUpdates. The application IDs are case sensitive and must be entered as indicated in this documentation.

          The return value is the number of events that were cleared.

          For example: 

          CommunitiesQEventService.clearQueuedEventsByRemoteAppDefId("Wiki")

          CommunitiesQEventService.clearQueuedEventByEventId(String eventId)

          Clears queued life-cycle replay events with the specified event ID, where eventId is a string. The events are removed from the queue and are not processed.

          The return value is the number of events that were cleared.

          For example: 

          CommunitiesQEventService.clearQueuedEventsByEventId("2d93497d-065a-4022ae25-a4b52598d11a")


    Example

    Here are some examples of queued event commands and their output.

    viewQueuedEventsSummary() 

    wsadmin>CommunitiesQEventService.viewQueuedEventsSummary()
App Def Id        Number        Events            Earliest Created
Activities        1             2009-03-28        11:56:44.453
Blog              1             2009-03-28        11:56:44.453
Files             2             2009-03-28        11:56:44.453
Forum             1             2009-03-28        11:56:44:453
Wiki              2             09-03-28          11:56:44.453

{NumEvents=2, RemoteAppDefId=Wiki, EarliestCreated=2009-03-28 11:56:44.453}
wsadmin>

    viewQueuedEventsByResourceType 

    wsadmin>CommunitiesQEventService.viewQueuedEventsByResourceType("community", None, 100)
Remote App   Resource Id                           Event Type                     Event Id
Blog         e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.visibility.changed   47362aa9-dfd7-43d4-bf42-3b069b0cbbbf
Files        e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.updated              7685892-d8a8-4563-a433-1392b8b58e01
Forum        e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.updated              1ab5492-d1a5-4114-0334-98882b8b58e01
Wiki         e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.updated              dccb0a7d-d6d4-4daa-9c03-6658a57631d0
Activities   e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.visibility.changed   3a4f2d84-8d7f-4a40-bc3c-36e02e9bb97b
Files        e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.visibility.changed   92c9f965-a8a3-481e-a0d4-0fdb856bb875
Forum        e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.visibility.changed   0325f966-f843-4065-6044-bddb856bb876
Wiki         e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.visibility.changed   ff635551-c59e-4ee7-b10f-0ca6e210c318

{ResourceId=e952cf0c-a86c-4e26-b1e0-f8bf40a75804, 
 ManAppDefId=Wiki, ResourceType=1, 
 Inserted=2009-03-28 15:57:26.000, 
 EventId=ff635551-c59e-4ee7-b10f-0ca6e210c318, 
 EventType=community.visibility.changed, 
 InsertedLong=1238270246000}
wsadmin>

    viewQueuedEventsByRemoteDefAppId 

    wsadmin>CommunitiesQEventService.viewQueuedEventsByRemoteAppDefId("Activities", None, 100)
Resource Type Id  Resource Id                           Event Type                    Event Id
1                 e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.visibility.changed  3a4f2d84-8d7f-4a40-bc3c-36e02e9bb97b

{ResourceId=e952cf0c-a86c-4e26-b1e0-f8bf40a75804, 
 RemAppDefId=Activities, ResourceType=1, 
 Inserted=2009-03-28 15:57:25.873, 
 EventId=3a4f2d84-8d7f-4a40-bc3c-36e02e9bb97b, 
 EventType=community.visibility.changed, 
 InsertedLong=1238270245873}

    viewQueuedEventsByRemoteAppDefId 

    wsadmin>CommunitiesQEventService.viewQueuedEventsByRemoteAppDefId("Wiki", None, 100)
Resource Type Id   Resource Id                           Event Type                    Event Id
1                  e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.updated             dccb0a7d-d6d4-4daa-9c03-6658a57631d0
1                  e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.visibility.changed  ff635551-c59e-4ee7-b10f-0ca6e210c318

{ResourceId=e952cf0c-a86c-4e26-b1e0-f8bf40a75804, 
 RemAppDefId=Wiki, ResourceType=1, 
 Inserted=2009-03-28 15:57:26.000, 
 EventId=ff635551-c59e-4ee7-b10f-0ca6e210c318, 
 EventType=community.visibility.changed, 
 InsertedLong=1238270246000}
wsadmin>

    viewQueuedEventsByRemoteAppDefId 

    wsadmin>CommunitiesQEventService.viewQueuedEventsByRemoteAppDefId("Blog", None, 100)
Resource Type Id      Resource Id                               Event Type
1                     e952cf0c-a86c-4e26-b1e0-f8bf40a75804      community.visibility.changed
        Event Id
        47362aa9-dfd7-43d4-bf42-3b069b0cbbbf

{ResourceId=e952cf0c-a86c-4e26-b1e0-f8bf40a75804, 
 RemAppDefId=Blog, 
 ResourceType=1, 
 Inserted=2009-03-28 15:57:21.450, 
 EventId=47362aa9-dfd7-43d4-bf42-3b069b0cbbbf, 
 EventType=community.visibility.changed, 
 InsertedLong=1238270241450}
wsadmin>

    viewQueuedEventsByResourceId 

    wsadmin>CommunitiesQEventService.viewQueuedEventsByResourceId("community", "e952cf0c-a86c-4e26-b1e0-f8bf40a75804", None, 100)
Remote App  Resource Id                           Event Type                    Event Id
Blog        e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.visibility.changed  47362aa9-dfd7-43d4-bf42-3b069b0cbbbf
Files       e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.updated             f7685892-d8a8-4563-a433-1392b8b58e01
Forum       e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.updated             1ab5492-d1a5-4114-0334-98882b8b58e01
Wiki        e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.updated             dccb0a7d-d6d4-4daa-9c03-6658a57631d0
Activities  e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.visibility.changed  3a4f2d84-8d7f-4a40-bc3c-36e02e9bb97b
Files       e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.visibility.changed  92c9f965-a8a3-481e-a0d4-0fdb856bb875
Forum       e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.visibility.changed  0325f966-f843-4065-6044-bddb856bb876
Wiki        e952cf0c-a86c-4e26-b1e0-f8bf40a75804  community.visibility.changed  ff635551-c59e-4ee7-b10f-0ca6e210c318

{ResourceId=e952cf0c-a86c-4e26-b1e0-f8bf40a75804, 
 ManAppDefId=Wiki, ResourceType=1, 
 Inserted=2009-03-28 15:57:26.000, 
 EventId=ff635551-c59e-4ee7-b10f-0ca6e210c318, 
 EventType=community.visibility.changed, 
 InsertedLong=1238270246000}
wsadmin>


    Configure the widget life-cycle retry schedule

    Communities uses the IBM WebSphere Application Server scheduler to run a scheduled task that processes events in the widget life-cycle event queue. You can configure the frequency with which this task runs by editing settings in the communities-config.xml file.

    To edit configuration files, you must use WAS wsadmin client.

    See Start wsadmin for details.

    To configure the widget life-cycle retry schedule, you need to edit settings in the communities-config.xml file. You can define the interval at which the task runs and specify when the scheduler starts the task. The interval property is configured with a Cron schedule.

    For more information about WAS scheduler and the Cron schedule, see Scheduling tasks.

    To configure the LifecycleRetryQueuedEvents task, complete the following steps.

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Start the Communities Jython script interpreter.

      1. Access the Communities configuration files: 

        execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Communities configuration :

        CommunitiesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        CommunitiesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. To view the current configuration settings:

      CommunitiesConfigService.showConfig()

      After updating any of the configuration settings, you can use this command again to display your updates.

    4. To change display settings for Communities:

      CommunitiesConfigService.updateConfig("property", "value")

      where:

      • property is one of the editable Communities configuration properties.
      • value is the new value with which you want to set that property.

      The following table displays the LifecycleRetryQueuedEvents properties that can be updated, and additional information regarding each property and the type of data that you can enter.


      LifecycleRetryQueuedEvents properties

      Property Description
      task.LifecycleRetryQueuedEvents.enabled Enables or disables the life-cycle retry queued events task.

      This property accepts the following values: true or false.

      For example: 

      CommunitiesConfigService.updateConfig("task.LifecycleRetryQueuedEvents.enabled", "true")
      task.LifecycleRetryQueuedEvents.interval Specifies the interval at which the life-cycle retry queued events task runs.

      This property is specified in Cron format.

      For more information about using the Cron format, see Scheduling tasks.

      When you change the interval property, the new schedule is registered the next time that Communities is started on any server in the Communities cluster (if there is one).

      For example: 

      CommunitiesConfigService.updateConfig("task.LifecycleRetryQueuedEvents.interval", "0 1 0-23/1 ? * *")

    5. After making changes, check the configuration files back in, and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes in Communities for information about how to save and apply your changes.


    Recover from a database failure

    When Communities or another Connections application experiences a database failure that involves restoring to a backup without replaying the transaction log to the point of failure, you can follow a number of steps to ensure a consistent data state for communities and their associated remote applications.

    The Communities application provides the option of adding extended functionality by adding widgets. Some of the available widgets are internal to the Communities application, for example, the Bookmarks, Members, and Feeds widgets. Other widget types are applications that are external to Communities - these are the Activities, Blog, Files, Forums, Ideation Blog, Media Gallery, Status Updates and Wiki widgets.

    Communities is tightly integrated with the external widget data. However, when you perform backups of your databases, you might back up Communities database data on a different schedule than the other applications' database data. If a disaster occurs, for example, if the Activities database fails and you need to restore from a backup of the Activities database that is two days old, after the Activities database restore, the Communities database is now more up-to-date than the Activities database. Any changes that were made to the Activities widgets in Communities in the past two days are lost and the two database are no longer synchronized.

    You might also need to remove orphaned community microblog data as part of the community widget life-cycle disaster recovery process. A microblog is a message posted to a community activity stream. Microblogs display in the aggregated list of events, along with other type of events when users select the Recent Updates view. Users can display microblogs exclusively by selecting the Status Updates view.

    Use the information in the following topics to help you to restore the Communities and external widget data to a synchronized state following a database disaster.


    Recover remote Connections applications

    Use the CommunitiesSchedulerService.resumeSchedulingTask command and other commands to recover Connections application databases or the Communities database.

    To enter administrative commands, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    After you restart a failed Communities database or another Connections application database from a backup. You must ensure that data is correctly synchronized between the Communities database and the remote application databases.

    You need to recover data only if the remote databases that you recovered from backup are older or newer than the Communities database.

    To recover an Connections application database that integrates with Communities after a database failure....

    1. After the remote database is recovered from a backup, but before general access is recovered, temporarily disable access to the Communities application. You must also temporarily disable access to any other integrating applications that are impacted by the failure. This step must be done only at the IBM HTTP Server because the IBM WebSphere Application Server must be running to keep wsadmin commands available for the remaining recovery steps. Here is a suggested approach to disabling access:

      1. Create an HTML document to notify users of the server maintenance. The maintenance page informs users that the product is temporarily unavailable because of scheduled maintenance work. Use the following ErrorDocument statements to point to the maintenance page:

        • ErrorDocument 401 /upgrading.htm
        • ErrorDocument 403 /upgrading.htm

      2. Add the following element to the IBM HTTP Server configuration file, httpd.conf, to block all unauthorized IP addresses from the server and send the user to the upgrading.htm page. The httpd.conf file is stored in the following directory by default:

        • AIX: /usr/IBM/HTTPServer/conf
        • Linux: /opt/IBM/HTTPServer/conf

          Windows: C:\IBM\HTTPServer\conf

        • IBM i: /www/HTTPServer_name/conf

        You must have an Allow element for every WebSphere Application Server in your deployment. 

        <Location / >
Order Deny,Allow
Deny from all Allow from <your.ip.address>
Allow from <ip.of.each.machine.in.deployment>
</Location>

      3. Restart the IBM HTTP Server.

    2. Temporarily stop the processing of past failed replay events by running the CommunitiesScheduler.pauseSchedulingTask("LifecycleRetryQueuedEvents") command.

      For more information about this command, see Managing Communities scheduled tasks.

    3. Clear out the replay event queue (because these events might no longer be applicable to the current application state), take the following steps:

      1. Start the wsadmin client:

          WAS_HOME/profiles/Dmgr01/bin

        You must start the client from this directory or subsequent commands that you enter will run incorrectly.

      2. Enter the following command to start the Communities Jython script interpreter: 

        execfile("communitiesAdmin.py")

      3. Do one of the following:

        1. If the Communities application did not fail and any of the remote applications had a data loss failure, clear only the affected queue or queues. Enter the following command:

          CommunitiesQEventService.clearQueuedEventsByRemoteAppDefId("remoteAppDefId")

          Where remoteAppDefId is one of the following:


          Remote application definition IDs

          Application remoteAppDefId
          Activities Activities
          Blogs Blog
          Files Files
          Forums Forum
          Ideation Blog IdeationBlog
          News

          Data is stored in the Homepage database

          		StatusUpdates

          RecentUpdates

          Wikis Wiki

        2. If the Communities application has a data loss, clear the replay event queue for all remote applications. Enter the following command on the Communities admin console:

          CommunitiesQEventService.clearQueuedEventsByResourceType("community")

        For more information about the CommunitiesQEventService commands, see Administering community queued events.

    4. Before you enter the exportSyncedResourceInfo command, initialize the application's wsadmin environment by running the appropriate execfile("<application_name>Admin.py") command.

    5. Enter the exportSyncedResourceInfo command that is listed in the following table for each affected application. If Communities failed, then all the applications are affected. Each service generates an XML file that shows the current state of associated remote applications. Use this report in the next step to validate against the current state of the Communities database.

      This step does not apply when you are restoring Libraries remote applications.


      The exportSyncedResourceInfo commands

      Application Command
      Activities ActivityService.exportSyncedResourceInfo(String filePath, String eventType)

      For example: 

      execfile("activitiesAdmin.py")
ActivityService.exportSyncedResourceInfo("/temp-dir/activitiesOutput.xml", "community")
      Blogs BlogsAdminService.exportSyncedResourceInfo(String FullFilePath, String ContainerType, String BlogType)

      The BlogType parameter is optional when you are exporting content for a blog. When you are exporting content for a blog, you can optionally specify Blog as the value for this parameter. For an Ideation Blog, you must specify a value of IdeationBlog.

      For example, to export content for a blog: 

      execfile("blogsAdmin.py")
BlogsAdminService.exportSyncedResourceInfo("/temp-dir/blogsOutput.xml", "community")

      or 

      execfile("blogsAdmin.py")
BlogsAdminService.exportSyncedResourceInfo("/temp-dir/blogsOutput.xml", "community", "Blog")

      To export content for an Ideation Blog: 

      execfile("blogsAdmin.py")
BlogsAdminService.exportSyncedResourceInfo("/temp-dir/IdeationblogsOutput.xml", "community", "IdeationBlog")
      Files FilesLibraryService.exportSyncedResourceInfo(String filePath, String eventType)

      For example: 

      execfile("filesAdmin.py")
FilesLibraryService.exportSyncedResourceInfo("/temp-dir/filesOutput.xml", "community")
      Forums ForumsService.exportSyncedResourceInfo(String filePath, String eventType)

      For example: 

      execfile("forumsAdmin.py")
ForumsService.exportSyncedResourceInfo("/temp-dir/forumsOutput.xml", "community")
      News NewsMicroBloggingService.exportSyncedResourceInfo (String filePath, String eventType)

      For example: 

      execfile("newsAdmin.py")
NewsMicrobloggingService.exportSyncedResourceInfo("/temp-dir/newsOutput.xml", "community")
      Wikis WikisLibraryService.exportSyncedResourceInfo (String filePath, String eventType)

      For example: 

      execfile("wikisAdmin.py")
WikisLibraryService.exportSyncedResourceInfo("/temp-dir/wikisOutput.xml", "community")

      For more information about the exportSyncedResourceInfo commands, see Comparing remote application data with the Communities database.

    6. Generate an HTML report for each remote application export by running the following wsadmin command against each XML file:

      CommunitiesRemoteAppService.generateSyncReports("syncedResourceInfoFilepath", "outputDirPath") The output file created by the application-specific exportSyncedResourceInfo commands from the previous step is used as input for the generateSyncReports command. This command generates two files, communityDifferences and orphanedRemoteApplications, in a localized HTML format.

      For more information about this command, see Generating a synchronization report.

      This step does not apply when you recover Libraries remote applications.

    7. Resume the processing of past failed events:

      CommunitiesSchedulerService.resumeSchedulingTask("LifecycleRetryQueuedEvents")

      For more information about this command, see Managing scheduled tasks.

    8. Validate setting up and re-enabling the HTTP server for user access. Do this validation by removing the Location and ErrorDocument statements that you added in step 1.

    9. Contact the community owners of all the communities that are listed in the communityDifferences file.

      To ensure that the applications are synchronized, community owners can toggle the community privacy settings after any required data scrubbing is complete. Community owners can temporarily modify the community settings.

      For example, they can set a community's access to restricted, save it, and then change the access back to public. They can then save it again to alert all remote applications that the community's content is publicly visible.

      To synchronize the current state of communities with the remote application, run the CommunitiesRemoteAppService.resyncRemoteAppsForCommunity commands.

      For more information about these commands, see Synchronize remote application data with the Communities database.

      If you are restoring Libraries remote applications, you can decide to attempt to synchronize individual communities only if users report problems. Alternatively, you can synchronize the current state of Communities to FileNet. If the only data loss occurred on FileNet and not in the Communities database, then you must synchronize the current state of Communities to FileNet. Enter the CommunitiesRemoteAppService.resyncRemoteAppsForCommunity commands to synchronize Communities.

    10. To ensure that data is correctly synchronized when files or folders are shared with communities from the Files application, and those communities do not contain the Files widget: 

      FilesDataIntegrityService.syncAllCommunityShares()

      If the name or the access level of a community changes, the command updates the Files data store to reflect those changes.

      For example, if the community is now public but the access level of a file or folder is private, these files or folders are no longer shared with the community. If the community no longer exists, the shared files or folders still exist in the Files application. The file owners or folder owners still own and have full access to that content even though it is no longer shared.

    11. To ensure that data is correctly synchronized when communities are added to activities as activity members: AccessControlService.syncAllCommunityShares(). If the name or the access level of the community changes, the command updates the Activities data store to reflect those changes. If the community no longer exists, the membership of the activity is changed, removing the community.

    12. For each remote application listed in the orphanedRemoteApplications file, perform one of the following steps:

      • To retain the data, enter the CommunitiesRemoteAppService.assignRemoteApp command to assign the application to a relevant community. This community might be the same community as before if only the widget is missing from the community. If the entire community and its membership are lost on data recovery, it might be a new community.

        For more information about the CommunitiesRemoteAppService.assignRemoteApp command, see Assigning orphaned remote applications to a community.

      • To delete orphaned data from the remote application, enter the commands that are described in Deleting orphaned data.


    Compare remote application data with the Communities database

    Use the exportSyncedResourceInfo commands to return a report of all the communities that an application has interacted with. The information in these reports can help you to synchronize remote application data with the Communities database after a system crash that includes data loss.

    To use wsadmin commands, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    Communities can integrate with the Activities, Blogs, Files, Forums, News, and Wikis applications as remote applications. As part of recovering from an incomplete database restore operation, you can run the CommunitiesRemoteAppService commands for each remote application that is listed in the orphanedRemoteApplications report because it is missing its containing community or only its widget in a containing community. Alternatively, you can delete any orphaned data from the remote applications.

    For more information about deleted orphaned data, see Deleting orphaned data.

    To resolve inconsistencies between remote applications and communities....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Use the wsadmin client to access the configuration files for the remote application to synchronize with Communities.

      • To access the Activities configuration file: 

        execfile("activitiesAdmin.py")

      • To access the Blogs configuration file: 

        execfile("blogsAdmin.py")

      • To access the Files configuration file: 

        execfile("filesAdmin.py")

      • To access the Forums configuration file: 

        execfile("forumsAdmin.py")

      • To access the News configuration file: 

        execfile("newsAdmin.py")

      • To access the Wikis configuration file: 

        execfile("wikisAdmin.py")

    3. To generate a report of all communities that a remote application has interacted with, use the application-specific version of the following command:

      application_nameService.exportSyncedResourceInfo(file_path, event_type)

      where

      • application_name is the application that is affected by the system crash.
      • file_path is a string that specifies the absolute path to the file name. The path can only contain forward slashes.

        For example, "c:/temp/community_output.xml".

      • event_type is a string value that specifies the event type "community". An error is returned if this is set to anything other than "community".

      In clusters, when you run the command from the deployment manager, the path and file are created on the server running the specified application. In clusters where multiple nodes are running the specified application, you are asked to choose a server to connect to and run the command on, and then the path and file are created on that server.

      Depending on which application or applications you are correcting, choose from the following commands:

      • Activities:

        ActivityService.exportSyncedResourceInfo(filePath,eventType) For example: 

        execfile("activitiesAdmin.py")
ActivityService.exportSyncedResourceInfo("/temp-dir/activitiesOutput.xml", "community")
      • Blogs:

        BlogsAdminService.exportSyncedResourceInfo(filePath, containerType, blogType)

        For example, to export content for a blog: 

        execfile("blogsAdmin.py")
BlogsAdminService.exportSyncedResourceInfo("/temp-dir/blogsOutput.xml", "community")
        or 

        execfile("blogsAdmin.py")
BlogsAdminService.exportSyncedResourceInfo("/temp-dir/blogsOutput.xml", "community", "Blog")
        To export content for an Ideation Blog: 

        execfile("blogsAdmin.py")
BlogsAdminService.exportSyncedResourceInfo("/temp-dir/IdeationblogsOutput.xml", "community", "IdeationBlog")
      • Files:

        FilesLibraryService.exportSyncedResourceInfo(filePath, eventType)

        For example: 

        execfile("filesAdmin.py")
FilesLibraryService.exportSyncedResourceInfo("/temp-dir/filesOutput.xml", "community")
      • Forums:

        ForumsService.exportSyncedResourceInfo(filePath, eventType)

        For example: 

        execfile("forumsAdmin.py")
ForumsService.exportSyncedResourceInfo("/temp-dir/forumsOutput.xml", "community")
      • News:

        NewsMicrobloggingService.exportSyncedResourceInfo(filePath, eventType)

        For example: 

        execfile("newsAdmin.py")
NewsMicrobloggingService.exportSyncedResourceInfo("/temp-dir/newsOutput.xml", "community")
      • Wikis:

        WikisLibraryService.exportSyncedResourceInfo(filePath, eventType)

        For example: 

        execfile("wikisAdmin.py")
WikisLibraryService.exportSyncedResourceInfo("/temp-dir/wikisOutput.xml", "community")

      If the Communities database fails, all remote applications are affected and you need to run each of the application-specific commands.

    The export XML files are used in the steps covered in the next topic to generate a report of how the information differs from the current state of the Communities application.

    For more information, see Generating a synchronization report.


    Generate a synchronization report

    Use the CommunitiesRemoteAppService.generateSyncReports command to generate HTML reports that help to identify data inconsistencies between communities and their remote applications.

    You need to export synchronized resource information by following the steps in the topic, Comparing remote application data with the Communities database.

    To use wsadmin commands, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    The CommunitiesRemoteAppService.generateSyncReports command generates two HTML reports that can help you to identify data inconsistencies between communities and their remote applications, communityDifferences.html and orphanedRemoteApplications.html. The communityDifferences.html report lists the differences in the information recorded in different application databases.

    For example, the Communities database might record that the privacy level of a community is set to public, but the Blogs application might record the community type as restricted. The orphanedRemoteApplications.html file lists the remote applications for which there is either no associated community or whose associated community is missing the orphaned datas widget.

    The Wikis_communityDifferences.html reports might indicate that there are differences for community moderation fields. In Connections 4.0, these differences have no impact on the operation of Wikis and do not require immediate attention. It is recommended, however, that these differences are addressed since they might be meaningful in a future release.

    To generate a synchronization report....

    1. Verify that you completed Comparing remote application data with the Communities database and then continue to the next step.

    2. Run the following command to generate the report:

      CommunitiesRemoteAppService.generateSyncReports(String syncedResourceInfoFilepath, String outputDirPath) Where:

      • syncedResourceInfoFilepath is the full path and file name of the output XML file that was generated using the exportSyncedResource command. (

        For more information about this command, see Comparing remote application data with the Communities database.) Use forward slashes as the path separator.

        For example, c:/temp-dir/activitiesOutput.xml on Microsoft Windows or /opt/temp-dir/blogsOutput.xml on Linux, AIX, or IBM i.

      • outputDirPath is the full path to the subdirectory where you want to create the two output files that are generated from this command. You must use forward slashes; not backslashes as the path separator.

        For example, c:/temp-dir on Microsoft Windows or /opt/temp-dir on Linux, AIX, or IBM i.

      For example: 

      CommunitiesRemoteAppService.generateSyncReports("c:/temp-dir/activitiesOutput.xml", "c:/temp-dir")
      Using the sample command previously shown, the two output files, Activities_communityDifferences.html and Activities_orphanedRemoteApplications.html, are created in the c:/temp-dir subdirectory.

    3. Repeat step 3 for each remote application where you want to restore data.

      Potentially, you might need to run the command seven times, once for each remote application (Activities, Blogs, Files, Forums, Ideation Blogs, Status Updates, and Wikis) that is integrated with Communities.

    4. Check the application_orphanedRemoteApplications.html files. To keep the data identified in those files, follow the steps in the topic Assigning orphaned data to a new community.

      To delete the data, follow the steps in the topic Deleting orphaned data.

    5. Check the application_communityDifferences.html files. Contact the community owners for all the communities listed in the file. To ensure that the applications are synchronized, community owners can toggle the community privacy settings after any required data scrubbing has been completed. Community owners can temporarily modify the community settings.

      For example, they can set a community's access to restricted, save it, change the access back to public, and then save it again to alert all remote applications that the community's content should be publicly visible.


    Assign orphaned remote applications to a community

    Use the CommunitiesRemoteAppService.assignRemoteApp command to assign remote applications that have been orphaned following a database failure to a new community or reinsert the widget into an existing community.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    To assign orphaned remote applications to a community, you must first run the CommunitiesRemoteAppService.generateSyncReports command. This command generates an <remoteAppDefId>_orphanedRemoteApplications.html file that contains a list of orphaned remote applications, along with each application's objectIdentifyingId and oldCommunityUuuid. These two values are needed as input to the command for assigning orphaned remote applications to a community, CommunitiesRemoteAppService.assignRemoteApp.

    For more information about using the generateSyncReports command, see Generating a synchronization report.

    You can use the CommunitiesRemoteAppService commands when recovering from an incomplete database restore. If, after the restore process, you find that orphaned remote applications remain, use the assignRemoteApp wsadmin command to assign these applications to new communities or find their previously associated community and add their widget again with the existing data.

    You cannot assign an orphaned widget to a community that already contains that type of widget.

    For example, if you have an orphaned Activities widget, when you use the assignRemoteApp wsadmin command to assign it to a community, that community must not have an Activities widget already added to it. If the community already contains an Activities widget, the command will fail with an exception in the SystemOut.log file. The same is true for the other types of widgets that you can add to a community, that is, the Blogs, Files, Forums, IdeationBlog, Status Updates, and Wiki widgets. By default all new communities contain the Files, Forums, and Status Updates widgets. If the user is reassigning orphaned Files, Forums, or SU widgets to this new community, you must remove those widgets from the new community before you issue this command.

    To assign an orphaned widget to a new community or existing community....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Use the following command to assign orphaned widgets to new communities. Repeat the command for each orphaned remote application.

      CommunitiesRemoteAppService.assignRemoteApp("remoteAppDefId", "objectIdentifyingId", "oldCommunityUuid", "newCommunityUuid", "uiLocation")

      The command takes the following parameters:


      Parameters for the CommunitiesRemoteAppService.assignRemoteApp command

      Parameter Description
      remoteAppDefId The remote application's identifier: Activities, Blog, Files, Forum, IdeationBlog, StatusUpdates, or Wiki.
      objectIdentifyingId Provided as part of the synchronization report generated by the generateSyncReports command.

      For more information about the generateSyncReports command, see Generating a synchronization report.

      This ID is specific to the remote application and is used to uniquely identify the orphaned resource.

      oldCommunityUuid Provided as part of the synchronization report generated by the generateSyncReports command.

      For more information about the generateSyncReports command, see Generating a synchronization report.

      This ID is a character string often found in the URL of a community page, for example, 6dd8815a-890e-4742-8261-e98e51362bb0. This ID represents that of the community that the orphaned resource was previously associated with.

      newCommunityUuid This ID represents the new community to which to assign the orphaned remote application. If the old community still exists but is missing the remote application's widget, you can provide the same value as the oldCommunityUuid. If the old community is gone, you can create a new community and provide its ID as this value. After creating a new community, look in the URL for the following pattern (/html/communityview?communityUuid=6dd8815a-890e-4742-8261-e98e51362bb0). Its ID can be extracted form the communityUuid parameter value following the equal sign.
      uiLocation With the exception of the Status Updates widget, the remote applications only support col2 as a user interface location; this value must always be used. col2 is a string and must always be enclosed in quotation marks: "col2".

      For the Status Updates widget, col2statusposts must be used. col2statusposts is a string and must always be enclosed in quotation marks: "col2statusposts".

      For example: 

      CommunitiesRemoteAppService.assignRemoteApp("Forum", "b307369e-7e60-403b-b850-206a28d6c19e", "b307369e-7e60-403b-b850-206a28d6c19e", "a307376f-3g20-523c-a320-921c28d6c19e", "col2")
      The command returns the following output to the wsadmin console when the assignment completes successfully: 

      Assignment succeeded


    Delete orphaned data

    Delete orphaned data from remote applications following a system crash or database failure.

    To use wsadmin commands, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    When you run the CommunitiesRemoteAppService.generateSyncReports command following a system crash or database failure, the command generates two reports, one of which is the orphanedRemoteApplications report. This report lists all the remote applications that have been orphaned as a result of the failure.

    As part of your backup and restore operation, you can run the CommunitiesRemoteAppService.assignRemoteApp command for each remote application listed in the orphanedRemoteApplications report to reassociate each instance with a community. For some of the orphaned resources, you might choose to delete the data from the remote applications. The following instructions explain how to delete any orphaned resources that you don't want associated with a community.

    To delete orphaned data from a remote application....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Use the wsadmin client to access the configuration files for the remote application from which you want to delete the orphaned data.

      • To access the Activities configuration file: 

        execfile("activitiesAdmin.py")

      • To access the Blogs or Ideation Blog configuration file: 

        execfile("blogsAdmin.py")

      • To access the Files configuration file: 

        execfile("filesAdmin.py")

      • To access the Forums configuration file: 

        execfile("forumsAdmin.py")

      • To access the News configuration file: 

        execfile("newsAdmin.py")

      • To access the Wikis configuration file: 

        execfile("wikisAdmin.py")

    3. To delete the orphaned data, use one of the following commands:

      • Activities:

        ActivityService.deleteActivities(vector activities)

        The Activities widget can contain multiple activities associated with a single community. You can use the oldCommunityId as an identifier to query for a vector of all orphaned activities and delete them.

        Use the following commands to generate the vector, and then delete the orphaned activities.

        commact=ActivityService.fetchActivitiesByCommunityExId("oldCommunityUuid")

        wsadmin>ActivityService.deleteActivities(commact)

        where oldCommunityUuid comes from the orphanReport.

      • Blogs and Ideation Blogs:

        BlogsAdminService.deleteWeblog("weblogId") Each orphaned blog and Ideation Blog has its blog ID in the report labeled as an Object Identifying Id.

      • Files:

        FilesLibraryService.delete("libraryId") Each orphaned files library has its library ID in the report labeled as an Object Identifying Id.

      • Forums:

        ForumsService.deleteForums(Vector Hashtable)

        The Forums widget can contain multiple forums associated with a single community. You can use the forum name to query for a vector of forums and delete them.

        Use the following commands to generate the vector, and then delete the orphaned forums.

        commforums=ForumsService.fetchForumsByName("forumName")

        wsadmin>ForumsService.deleteForums(commforums)

      • News:

        NewsMicrobloggingService.deleteMicroblogs("communityId")

        This command removes all orphaned microblog and associated data for a community from the News repository.

      • Wikis:

        WikisLibraryService.delete("libraryId") Each orphaned files library has its library ID in the report labeled as an Object Identifying Id.


    Configure media galleries

    Media galleries are community widgets that display photos and videos. You must configure media galleries in your Connections deployment before community owners can add the widget to their communities.

    Perform the following tasks to configure media galleries:

    You can perform the following optional tasks to configure media galleries:

    • Create custom photo and video object types. You might want to create your own object types to give more advanced users the option of seeing photos or videos with additional detail or different information.

      For example, a media gallery with the default object type definition might meet the needs of a community of amateur photographers. But a community of professional photographers might require a media gallery that includes aperture and lighting data for each photograph.

      See Creating custom media gallery object types for more information.

    • Add a terms and conditions statement for users to agree to before they upload new files.

      See Adding terms and conditions to media galleries for more information.

    • Change the size of thumbnail preview images that display in the widget.

      For example, you might want to decrease the maximum size of preview images in the widget in the community overview page to allow more images to display. Or you might want to increase the maximum size if the thumbnail images are too small for your client.

      See Changing media gallery image sizes for more information.

    • Use a third-party video player instead of the default player.

      See Using a third-party video player in media galleries for more information.

    • Set default object type selection when adding a media gallery widget to a community. Users have three options: photos only, videos only, or photos and videos. Photos and videos is selected by default. You can change this to photos only or videos only.

      See Setting the object types available when adding a media gallery.

    • Set the media gallery file extensions that users are allowed to upload.

      See Setting allowed media gallery file extensions for more information.

    • Set maximum file sizes and maximum library sizes. Media gallery files are stored in Files application libraries. You might want to add limits to file and library sizes for various reasons, such as keeping file upload times reasonable and maintaining good application performance.

      See Setting a maximum size on files and Setting a maximum size on libraries for more information.

    • Number of seconds to wait before a timeout occurs that ends a file upload attempt. This setting is used by both the Library, Linked Library, and Media Gallery widgets.

      See Configure Linked Libraries for information about opening the appropriate configuration file and changing the uploadTimeout property.


    Create custom media gallery object types

    Create your own photo and video object types to customize the information provided with each media gallery file.

    You must create the XML documents that define CMIS object types for custom photo or video files before importing them.

    For information about creating custom object type definition documents, refer to the wiki article, Work with CMIS API object types.

    See Sample media gallery object types for samples of photo and video object type definitions used as templates.

    Users with media galleries must not switch from using an object type for photos to using it for videos.

    In multi-node clustered environments, you must add the XML definition documents to the computer on which the Connections Files application is installed, and then import them on that computer also.

    Object types defined for media galleries must use the following name space: 

    <cmis:localNamespace>http://www.ibm.com/xmlns/prod/sn/cmis/socialmedia</cmis:localNamespace>

    To assign new logical types to a property, add the type as the value of the localName element, and add http://www.ibm.com/xmlns/prod/sn/cmis/logicaltypes as the value of the localNamespace element.

    For example, the default photo object type looks like this: 

    <cmis:propertyStringDefinition>
    <cmis:id>751f89d5-068f-45c4-8e79-8ceb709feae2</cmis:id>
    <cmis:localName>mediaphotolocation</cmis:localName>
    <cmis:localNamespace>http://www.ibm.com/xmlns/prod/sn/cmis/logicaltypes</cmis:localNamespace>
    ..

    Name objects in the localName element clearly so that community owners know what object types to pick when adding media gallery widgets to their communities.

    Media galleries use the Connections Files service and the CMIS API to store, retrieve, and share photo and video files. Detailed documentation for the CMIS standard can be found at the Oasis CMIS website.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    To import new object types....

    1. On the server that the Files application is installed on, Start wsadmin.

    2. Start the Files Jython script interpreter 

      execfile("filesAdmin.py")

    3. Run the following command to import the object type definition document: 

      FilesObjectTypeService.importType("path_filename")
      where path_filename is the path and file name of the XML definition document.

    4. Restart the Files application.

    5. Run the following command to check that the new object type was imported. The command returns a list of all object types: 

      FilesObjectTypeService.browseTypes()

    6. If your definition adds new properties, add property labels and descriptions to the CMIS language property file.

      See Adding labels to media gallery fields.

    7. Add custom fields to display the new properties.

      See Creating fields for custom media gallery object types.


    Results

    Community owners can select the object type when they add media gallery widgets to their communities.

    See Adding a media gallery to your community.


    Sample media gallery object types

    Use these samples as a template for your own custom object type definitions.


    Photo object type

    <?xml version="1.0" encoding="UTF-8"?>
<cmisra:type   xsi:type="cmis:{http://docs.oasis-open.org/ns/cmis/core/200908/}cmisTypeDocumentDefinitionType"   xmlns:cmism="http://docs.oasis-open.org/ns/cmis/messaging/200908/"   xmlns:lcmis="http://www.ibm.com/xmlns/prod/sn/cmis"
 xmlns:cmis="http://docs.oasis-open.org/ns/cmis/core/200908/"
 xmlns:atom="http://www.w3.org/2005/Atom"   xmlns:app="http://www.w3.org/2007/app"   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"   xmlns:cmisra="http://docs.oasis-open.org/ns/cmis/restatom/200908/">
  <cmis:localName>mediaphoto</cmis:localName>
  <cmis:localNamespace>http://www.ibm.com/xmlns/prod/sn/cmis/socialmedia</cmis:localNamespace>
  <lcmis:displayNameKey>snmedia_photo_title_key</lcmis:displayNameKey>
  <cmis:queryName>snmedia:photo</cmis:queryName>
  <lcmis:descriptionKey>snmedia_photo_summary_key</lcmis:descriptionKey>
  <cmis:baseId>cmis:document</cmis:baseId>
  <cmis:parentId>snx:file</cmis:parentId>
  <cmis:creatable>true</cmis:creatable>
  <cmis:fileable>false</cmis:fileable>
  <cmis:queryable>true</cmis:queryable>
  <cmis:fulltextIndexed>false</cmis:fulltextIndexed>
  <cmis:includedInSupertypeQuery>true</cmis:includedInSupertypeQuery>
  <cmis:controllablePolicy>false</cmis:controllablePolicy>
  <cmis:controllableACL>false</cmis:controllableACL>
  <cmis:versionable>true</cmis:versionable>
  <cmis:contentStreamAllowed>required</cmis:contentStreamAllowed>
  <cmis:propertyStringDefinition>
    <cmis:localName>mediaphotolocation</cmis:localName>
    <cmis:localNamespace>http://www.ibm.com/xmlns/prod/sn/cmis/logicaltypes</cmis:localNamespace>
    <lcmis:displayNameKey>snmedia_photo_location_title_key</lcmis:displayNameKey>
    <cmis:queryName>snmedia:mediaphotolocation</cmis:queryName>
    <lcmis:descriptionKey>snmedia_photo_photolocation_summary_key</lcmis:descriptionKey>
    <cmis:propertyType>string</cmis:propertyType>
    <cmis:cardinality>single</cmis:cardinality>
    <cmis:updatability>readwrite</cmis:updatability>
    <cmis:inherited>false</cmis:inherited>
    <cmis:required>false</cmis:required>
    <cmis:queryable>true</cmis:queryable>
    <cmis:orderable>true</cmis:orderable>
    <cmis:openChoice>false</cmis:openChoice>
    <cmis:maxLength>64</cmis:maxLength>
  </cmis:propertyStringDefinition>
</cmisra:type>


    Video object type

    <?xml version="1.0" encoding="UTF-8"?>
<cmisra:type   xsi:type="cmis:{http://docs.oasis-open.org/ns/cmis/core/200908/}cmisTypeDocumentDefinitionType"   xmlns:cmism="http://docs.oasis-open.org/ns/cmis/messaging/200908/"   xmlns:lcmis="http://www.ibm.com/xmlns/prod/sn/cmis"
 xmlns:cmis="http://docs.oasis-open.org/ns/cmis/core/200908/"
 xmlns:atom="http://www.w3.org/2005/Atom"   xmlns:app="http://www.w3.org/2007/app"   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"   xmlns:cmisra="http://docs.oasis-open.org/ns/cmis/restatom/200908/">
  <cmis:localName>mediavideo</cmis:localName>
  <cmis:localNamespace>http://www.ibm.com/xmlns/prod/sn/cmis/socialmedia</cmis:localNamespace>
  <lcmis:displayNameKey>snmedia_video_title_key</lcmis:displayNameKey>
  <cmis:queryName>snmedia:video</cmis:queryName>
  <lcmis:descriptionKey>snmedia_video_summary_key</lcmis:descriptionKey>
  <cmis:baseId>cmis:document</cmis:baseId>
  <cmis:parentId>snx:file</cmis:parentId>
  <cmis:creatable>true</cmis:creatable>
  <cmis:fileable>false</cmis:fileable>
  <cmis:queryable>true</cmis:queryable>
  <cmis:fulltextIndexed>false</cmis:fulltextIndexed>
  <cmis:includedInSupertypeQuery>true</cmis:includedInSupertypeQuery>
  <cmis:controllablePolicy>false</cmis:controllablePolicy>
  <cmis:controllableACL>false</cmis:controllableACL>
  <cmis:versionable>true</cmis:versionable>
  <cmis:contentStreamAllowed>required</cmis:contentStreamAllowed>
  <cmis:propertyStringDefinition>
    <cmis:localName>mediavideoduration</cmis:localName>
    <cmis:localNamespace>http://www.ibm.com/xmlns/prod/sn/cmis/logicaltypes</cmis:localNamespace>
    <lcmis:displayNameKey>snmedia_video_duration_title_key</lcmis:displayNameKey>
    <cmis:queryName>snmedia:mediavideoduration</cmis:queryName>
    <lcmis:descriptionKey>snmedia_video_videoduration_summary_key</lcmis:descriptionKey>
    <cmis:propertyType>string</cmis:propertyType>
    <cmis:cardinality>single</cmis:cardinality>
    <cmis:updatability>readwrite</cmis:updatability>
    <cmis:inherited>false</cmis:inherited>
    <cmis:required>true</cmis:required>
    <cmis:queryable>true</cmis:queryable>
    <cmis:orderable>true</cmis:orderable>
    <cmis:openChoice>false</cmis:openChoice>
    <cmis:maxLength>64</cmis:maxLength>
  </cmis:propertyStringDefinition>
</cmisra:type>


    Create fields for custom media gallery object types

    Add fields to contain information about custom object type media gallery photos and videos. After creating fields, create labels for each field.

    To include your fields with photos and videos users upload to media galleries, you define the fields as "logical types" within a CMIS object type definition.

    For example, you can define a photo object type such that photos of that type display a search term field for users to type a search term and perform a search of the public IBM website. You can create a new object type or add custom logical types to existing definitions.

    After adding custom fields to an object type, create labels and descriptions to display with those fields.

    For example, for the search term field you might create the field title "Search term" and the description, "IBM search keyword."

    1. Create a JAR file that declares an OSGI extension that uses JavaScript to define your custom field. To see an example, download this sample JAR file by right-clicking the following link: com.ibm.lconn.mediagallery.web.resources.examples_1.0.0.jar

    2. Create a CMIS object type definition document that includes definitions for your custom logical types.

      For more information, refer to the wiki article, Work with CMIS API object types.

      In the localName element use the name of the logical type, for example searchTerm. In the localNamespace element use the following namespace: http://www.ibm.com/xmlns/prod/sn/cmis/logicaltypes

      For example, this photo object type definition includes definitions for search term, date and time fields: 

      <?xml version="1.0" encoding="UTF-8"?>
<cmisra:type   xsi:type="cmis:{http://docs.oasis-open.org/ns/cmis/core/200908/}cmisTypeDocumentDefinitionType"   xmlns:cmism="http://docs.oasis-open.org/ns/cmis/messaging/200908/"   xmlns:lcmis="http://www.ibm.com/xmlns/prod/sn/cmis"
 xmlns:cmis="http://docs.oasis-open.org/ns/cmis/core/200908/"
 xmlns:atom="http://www.w3.org/2005/Atom"   xmlns:app="http://www.w3.org/2007/app"   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"   xmlns:cmisra="http://docs.oasis-open.org/ns/cmis/restatom/200908/">
  <cmis:localName>photo2</cmis:localName>
  <cmis:localNamespace>http://www.ibm.com/xmlns/prod/sn/cmis/socialmedia</cmis:localNamespace>
  <lcmis:displayNameKey>photo2_title_key</lcmis:displayNameKey>
  <cmis:queryName>custom:photo2</cmis:queryName>
  <lcmis:descriptionKey>photo2_summary_key</lcmis:descriptionKey>
  <cmis:baseId>cmis:document</cmis:baseId>
  <cmis:parentId>snx:file</cmis:parentId>
  <cmis:creatable>true</cmis:creatable>
  <cmis:fileable>false</cmis:fileable>
  <cmis:queryable>true</cmis:queryable>
  <cmis:fulltextIndexed>false</cmis:fulltextIndexed>
  <cmis:includedInSupertypeQuery>true</cmis:includedInSupertypeQuery>
  <cmis:controllablePolicy>false</cmis:controllablePolicy>
  <cmis:controllableACL>false</cmis:controllableACL>
  <cmis:versionable>false</cmis:versionable>
  <cmis:contentStreamAllowed>required</cmis:contentStreamAllowed>
  <cmis:propertyStringDefinition>
    <cmis:localName>searchTerm</cmis:localName>
    <cmis:localNamespace>http://www.ibm.com/xmlns/prod/sn/cmis/logicaltypes</cmis:localNamespace>
    <lcmis:displayNameKey>photo1_string1_key</lcmis:displayNameKey>
    <cmis:queryName>custom:string1</cmis:queryName>
    <lcmis:descriptionKey>photo1_string1_summary_key</lcmis:descriptionKey>
    <cmis:propertyType>string</cmis:propertyType>
    <cmis:cardinality>single</cmis:cardinality>
    <cmis:updatability>readwrite</cmis:updatability>
    <cmis:inherited>false</cmis:inherited>
    <cmis:required>false</cmis:required>
    <cmis:queryable>true</cmis:queryable>
    <cmis:orderable>true</cmis:orderable>
    <cmis:openChoice>false</cmis:openChoice>
    <cmis:maxLength>64</cmis:maxLength>
  </cmis:propertyStringDefinition>
  <cmis:propertyDateTimeDefinition>
    <cmis:localName>date</cmis:localName>
    <cmis:localNamespace>http://www.ibm.com/xmlns/prod/sn/cmis/logicaltypes</cmis:localNamespace>
    <lcmis:displayNameKey>photo1_date2_key</lcmis:displayNameKey>
    <cmis:queryName>custom:date1</cmis:queryName>
    <lcmis:descriptionKey>photo1_date2_summary_key</lcmis:descriptionKey>
    <cmis:propertyType>datetime</cmis:propertyType>
    <cmis:cardinality>single</cmis:cardinality>
    <cmis:updatability>readwrite</cmis:updatability>
    <cmis:inherited>false</cmis:inherited>
    <cmis:required>false</cmis:required>
    <cmis:queryable>true</cmis:queryable>
    <cmis:orderable>true</cmis:orderable>
    <cmis:openChoice>false</cmis:openChoice>
  </cmis:propertyDateTimeDefinition>
  <cmis:propertyDateTimeDefinition>
    <cmis:localName>time</cmis:localName>
    <cmis:localNamespace>http://www.ibm.com/xmlns/prod/sn/cmis/logicaltypes</cmis:localNamespace>
    <lcmis:displayNameKey>photo1_time1_key</lcmis:displayNameKey>
    <cmis:queryName>custom:time1</cmis:queryName>
    <lcmis:descriptionKey>photo1_time1_summary_key</lcmis:descriptionKey>
    <cmis:propertyType>datetime</cmis:propertyType>
    <cmis:cardinality>single</cmis:cardinality>
    <cmis:updatability>readwrite</cmis:updatability>
    <cmis:inherited>false</cmis:inherited>
    <cmis:required>false</cmis:required>
    <cmis:queryable>true</cmis:queryable>
    <cmis:orderable>true</cmis:orderable>
    <cmis:openChoice>false</cmis:openChoice>
  </cmis:propertyDateTimeDefinition>
</cmisra:type>

    3. Add labels and descriptions to display your custom logical type information in the user interface.

      1. Open the com.ibm.lconn.files.strings.cmis_en.properties file to create text for browsers displaying English.

      2. Add key value pairs to define display text for the logical types. Typically you would create value pairs for the field name (the displayNameKey property) and description (the descriptionKey property).

        For example: 

        photo2_title_key=Custom Photo
photo2_summary_key=Description of custom photo photo1_string1_key=Search term
photo1_string1_summary_key=IBM search keyword
photo1_date2_key=Date taken
photo1_date2_summary_key=Date that photo was taken
photo1_time1_key=Time taken
photo1_time1_summary_key=Time that photo was taken

        See Adding labels to media gallery fields.

    4. Import the CMIS object type definition into Connections.

      See Creating custom media gallery object types.

    5. Restart the Files EAR file.

    6. Place the JAR file from step 1 on the Connections server in the provision\webresources directory and then restart the common EAR file.

      The provision directory is typically CONNECTIONS_HOME/data/shared/provision.


    Add labels to media gallery fields

    After creating fields for your custom media gallery object types, create labels for each field.

    This procedure describes the basic steps for adding property labels to the Connections interface in English. For details on adding and editing Connections labels, including editing in languages other than English, see Customizing product strings.

    1. On the Connections server, open the Files.ear/share.services.jar file, and navigate to com\ibm\lconn\files\strings. Copy the cmis.properties file.

    2. Paste the file into the following directory:

      customizationDir/strings

      where customizationDir refers to the base customization directory defined during installation. To determine the location of this directory, check the value of the CONNECTIONS_CUSTOMIZATION_PATH variable for your deployment.

    3. Rename the cmis.properties file to com.ibm.lconn.files.strings.cmis.properties.

    4. Add new property labels as key-value pairs.

    5. Restart the Files application.

    6. Clear your browser cache and check the results.

    7. To force the web browsers of all Connections users to refresh all cached content and display your changes, see step 6 in Customizing product strings.


    Set custom media gallery object types as default selections

    Set custom photo and video object types as the object types selected by default when a user adds a media gallery to their community.

    The Connections installation program sets the default photo and video object types shown when users add media galleries to their communities. If you create and import your own object types, you can make those the default object type selections instead.

    For example, when a user opens their community and clicks Community Actions > Customize and then adds a media gallery widget to the community, they see a dialog. The Photo Property Template and Video Property Template fields display the default object types: Social photo and Social video. You can change these to show your custom object types.

    The object types that you reference must exist. If you reference object types that you have not created and import yet, users will see an error.

    Perform the following steps to set the default selection object types:

    1. Check out and open widgets-config.xml.

      See Using widgets-config.xml for Communities for more information.

    2. To set the default photo type selection, specify the value attribute of the <item name="mg_photoType" value="ada30772-31fe-44bf-b8b4-dd7e4f072cd6" /> element to be the <cmis:id> value of your custom photo object type. The current value is the default photo object type.

    3. To set the default video type selection, specify the value attribute of the <item name="mg_videoType" value="ada30772-31fe-44bf-b8b4-dd7e4f072ad6" /> element to be the <cmis:id> value of your custom video object type. The current value is the default video object type.

    4. Check in widgets-config.xml.

      See Using widgets-config.xml for Communities for more information.


    Add terms and conditions to media galleries

    Make users agree to terms and conditions when they upload new photos or videos to media galleries. This task is optional.

    To add a terms and conditions agreement to the Media Gallery widget....

    1. Create a string bundle, for example, tc.properties.

      See Adding custom strings for widgets and other specified scenarios for more information.

    2. Create a new string properties file, for example, tc.properties. The file must contain a key-value pair with the string to use in your terms and conditions agreement.

      For example: 

      tc=These are the terms and conditions you must agree to before uploading a photo or video file

      To provide strings for different languages, create _language_code.properties files instead.

      For example, for a Spanish string, create tc_es.properties. The agreement will only be available to browsers set for Spanish.

    3. Create a JAR file that declares an OSGI extension. To see an example, download this sample JAR file by right-clicking the following link: com.ibm.lconn.mediagallery.web.resources.examples_1.0.0.jar

    4. Place your properties files in the _properties folder of the OSGI bundle JAR file.

    5. Add the following items to the Media Gallery widget definition in widgets-config.xml: 

      <item name="tc_bundle" value="my.custom.TermsConditions.messages" />
<item name="tc_key" value="tc" />
<item name="tc_checkbox" value="false" />

      ...where...

      • The tc_bundle value must be the name of the object that is set in the file, which is referenced by the bind attribute of the net.jazz.ajax.dojoModuleBinding in the OSGI bundle. In this case, the value is my.custom.TermsConditions.messages.

      • The value of tc_key is the key used in the properties file located in the _properties directory of the OSGI bundle jar, for example, com.ibm.lconn.mediagallery.web.resources.example.jar.

      • The value attribute of the tc_checkbox item is set to true or false. If it is set to true, users must select a check box in the agreement before they can access the media gallery.

      For information about updating widgets-config.xml, see Using widgets-config.xml for Communities.

    6. Place the JAR file from step 3 on the Connections server in the provision\webresources directory and then restart the common EAR file.

      The provision directory is typically CONNECTIONS_HOME/data/shared/provision.


    Change media gallery image sizes

    Set maximum sizes for photo and video file preview images in media galleries.

    For example, you might want to decrease the maximum size on preview images in the widget on the community Overview page to allow more images to display. Or increase the maximum size if the thumbnail images are too small for your client. This task is optional.

    Images that are larger than the specified container size are resized.

    For example, if the specified maximum size is 100x100 and a user uploads a 10x10 image, its size does not change. But if the user uploads a 150x150 image, it is resized to 100x100.

    The thumbnail image sizes set for media galleries must not be larger than the "large" image size set in the files-config.xml configuration properties file. Media galleries use Files properties to display images, and are constrained by Files image size values. As long as media gallery sizes are smaller than the largest Files size setting, the Media Gallery widget will scale its images down to that size. Therefore, if Files has a preview generation size of 100x100 as the largest possible, and the media gallery setting is 450x450, preview images are displayed at 100x100. However, if a media gallery size value is larger than the available Files rendition size values, then the media gallery will use a Files size value. This will crop the outer edges of the images.

    For information on Files rendition values, see Files configuration properties.

    You can change three maximum size properties:

    • The thumbnailview properties set maximum image sizes in the community overview page widget, and the list view in the application. The recommended range is 50x50 to 78x78.

    • The detailview properties set maximum image sizes in the preview dialog (which opens you click an image in a list view, for example), and the summary page (which opens when you click the image name in a list, for example). The recommended range is 200x200 to 600x600.

    • The galleryview properties set maximum image size in the gallery view in the application. The recommended range is 80x80 to 180x180.

    For example, to change the maximum image size in the preview dialog and summary page to 500x500, change the detailview width and height properties from 450 to 500.

    To configure photo sizes in the media gallery, check out the media-gallery-config.xml file, edit configuration properties, and then check the file back in.

    Size values outside of the recommended range for thumbnailview, galleryview, and detailview are not supported.

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Use the wsadmin client to access and check out the configuration file:

      1. Access the Connections configuration files: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out the media-gallery-config.xml configuration file:

        LCConfigService.checkOutMediaGalleryConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command does not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To get cell name, from wsadmin:print AdminControl.getCell()

        For example:

        • AIX or Linux:

          LCConfigService.checkOutMediaGalleryConfig("/opt/temp","Cell01")

          Windows:

          LCConfigService.checkOutMediaGalleryConfig("c:/temp","Cell01")

        • IBM i:

          LCConfigService.checkOutMediaGalleryConfig("/temp","Cell01")

    3. Open the media-gallery-config.xml file in a text editor.

    4. Edit the width and height values as measured in pixels: 

      ...
<thumbnailView width="73" height="73"/>
<galleryView width="120" height="120"/>
<detailView width="450" height="450"/>
...

    5. Save the media-gallery-config.xml file in UTF-8 format.

    6. Update the value of the version stamp to force users' browsers to pick up this change

      See Required post-customization step

    7. To check in the changed media-gallery-config.xml file: 

      LCConfigService.checkInMediaGalleryConfig("working_directory", "cell_name")

    8. After making updates, deploy the changes: 

      synchAllNodes()

    9. To exit the wsadmin client, type exit at the prompt.

    10. Stop and restart all of the Connections application servers.

    To troubleshoot, enable tracing for: com.ibm.lconn.media.renditions.*

    See the IBM WebSphere Application Server documentation for more information.


    Use a third-party video player in media galleries

    Use your preferred third-party video player to view media gallery video files.

    1. Create a JAR file that declares an OSGI extension. To see an example, download this sample JAR file by right-clicking the following link: com.ibm.lconn.mediagallery.web.resources.examples_1.0.0.jar

      For additional information about creating an IBM Websphere Application Server OSGi extension, refer to the WebSphere Application Server documentation about plugin.xml.

    2. In JavaScript, ensure that the following variable is set to the name of a constructor function (Dojo class) that will create an object with a single member function: 

      quickr.lw.config.media.videoPlayer
      For example: 

      myCustomVideoPlayer_playVideo = function (node, store, item, width, height) {

// Include dom code to render video player here

}

function myCustomVideoPlayer = function () {

// Initialize member variables if necessary

}

myCustomVideoPlayer.prototype.playVideo = myCustomVideoPlayer_playVideo

    3. Set the configuration variable to the name of your constructor: 

      quickr.lw.config.media.VideoPlayer = "myCustomVideoPlayer";

    4. Place the JAR file on the Connections server in the provision\webresources directory and then restart the common EAR file.

      The provision directory is typically CONNECTIONS_HOME/data/shared/provision.


    Set the object types available when adding a media gallery

    Set the default selection in the list of object types that users can choose from when adding a media gallery to their community.

    The object type selection determines whether the media gallery will contain photos only, videos only, or photos and videos. All three options are always available; this property only controls which one is selected by default.

    For example, if your media galleries will only display photos you could set the default to Photos only so that users won't have to select it when they add a media gallery to their community.

    When a user opens their community and clicks Community Actions > Customize, and then adds the Media Gallery widget to the community, they see a dialog. In the Use the media gallery to show section of that dialog, they can select the object types they want the media gallery to show: photos only, videos only, or both photos and videos. You can configure the default selection in this list.

    1. Check out and open widgets-config.xml.

      See Using widgets-config.xml for Communities for more information.

    2. Specify the value attribute of the <item name="mg_typesToShow" value="photos_and_videos" /> element to be one of the following:

      • photos_and_videos: The Photos and videos option will be selected by default.
      • photos: The Photos only option will be selected by default and the media gallery will only allow uploading and viewing of photos.
      • videos: The Videos only option will be selected by default and the media gallery will only allow uploading and viewing of videos.

    3. Check in widgets-config.xml.

      See Using widgets-config.xml for Communities for more information.


    Set allowed media gallery file extensions

    List of photo and video file extensions that users are allowed to upload to media galleries.

    The extensions in these lists by default are the only currently supported extensions.

    See the Supported media formats in Media Gallery technote for the official list of supported extensions.

    1. Check out and open widgets-config.xml.

      See Using widgets-config.xml for Communities for more information.

    2. To specify photo extensions, add or remove them from the value attribute of the <item name="validPhotoExts" value="jpg,jpeg,gif,png" /> element.

    3. To specify video extensions, add or remove them from the value attribute of the <item name="validVideoExts" value="mp4,mov,flv" /> element.

    4. Check in widgets-config.xml.

      See Using widgets-config.xml for Communities for more information.


    Change the media galleries image format

    You can change the format of thumbnail images that display in media galleries. The default format is JPG. JPG and PNG formats are supported, but to preserve the transparent areas of images you must use the PNG format.

    Perform the following steps to change the media galleries image format.

    1. Check out files-config.xml.

      For information about checking out and in files-config.xml, see Changing Files configuration property values

    2. Change the value of the format attribute in the small, medium, and large elements within the renditions element.

      For example: 

      <renditions enabled="true">
   <small format="JPG" width="100" height="100"/>
   <medium format="JPG" width="250" height="250"/>
   <large format="JPG" width="500" height="500"/>
</renditions>

      Do not change any height and width values, since these affect image sizes in areas of Connections outside of media galleries.

    3. Check in files-config.xml.

      See Changing Files configuration property values for more information.


    Media gallery widgets-config.xml definition

    Like all Connections widgets, the media gallery widget is defined in the widgets-config.xml configuration file. The definition contains some properties you can edit to customize media galleries, including the list of allowed file types: 

    <widgetDef defId="MediaGallery" bundleRefId="lc_clib" prerequisite="files" description="MediaGallery_description"
uniqueInstance="true" url="{webresourcesSvcRef}/web/quickr.lw/widgetDefs/MediaGalleryWidget_CMIS.xml?etag={version}"
helpLink="{helpSvcRef}/topic/com.ibm.lotus.connections.communities.help/media_gallery_frame.html"
modes="view edit fullpage" primaryWidget="false" iconUrl="{webresourcesSvcRef}/web/quickr.lw/images/mediaGalleryIcon.png">
<itemSet>
<item name="svcDocUrl" value="{filesSvcRef}/form/cmis/community/{resourceId}/owned/servicedoc" />
<item name="svcDocUrlAnon" value="{filesSvcRef}/form/anonymous/cmis/community/{resourceId}/owned/servicedoc" />
<item name="svcContext" value="{filesSvcRef}" />
<item name="rootCategory" value="library" />
<item name="category.folder" value="false" />
<item name="validPhotoExts" value="jpg,jpeg,gif,png" />
<item name="validVideoExts" value="mp4,mov,flv" />
<item name="widgetEnv" value="Connections" />
<item name="mg_typesToShow" value="photos_and_videos" />
<item name="mg_photoType" value="ada30772-31fe-44bf-b8b4-dd7e4f072cd6" />
<item name="mg_videoType" value="ada30772-31fe-44bf-b8b4-dd7e4f072ad6" />
<item name="mg_fileUrl" value="{contextRoot}/service/html/communityview?communityUuid={resourceId}#fullpageWidgetId={widgetId}&amp;file={objectTypeId}!{fileUuid}" />
</itemSet>
</widgetDef>

    You can optionally edit the following items:

    • In the validPhotoExts and validVideoExts items you can edit the list of allowed photo or video file extensions. The extensions in these lists by default are the only currently supported extensions.

      See the Supported media formats in Media Gallery technote for the official list of supported extensions.

      See Setting allowed media gallery file extensions.

    • In the mg_typesToShow item you can edit the default the default selection in the list of object types users can choose from when adding a media gallery to their community. The selection determines whether the media gallery will contain photos only, videos only, or photos and videos. All three options are always available; this property only controls which one is selected by default.

      For example, if your media galleries will only display photos you could set the default as photos only, and then users won't have to select it when they add a media gallery to their community.

      See Setting the object types available when adding a media gallery.

    • In the mg_photoType and mg_videoType items you can specify custom object types as the default templates selected when users create media galleries.

      See Setting custom media gallery object types as default selections.

    See Using widgets-config.xml for Communities for steps on checking widgets-config.xml out and in again.


    Manage Communities scheduled tasks

    Use the CommunitiesScheduler commands to administer the community event tasks performed by the IBM WebSphere Application Server scheduler. These administrative commands do not require a server restart to take effect, and no file checkout is necessary.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    Communities uses WAS scheduler to run the following scheduled tasks relating to community events.

    For more information about the scheduler, see Scheduling tasks.

      LifecycleRetryQueuedEvents
      Automatically retries sending life-cycle events to other applications when event processing fails, for example, when another application server is down.

      For more information about life-cycle events, see Administering widgets and remote applications.

      EventLogCleanup
      Removes old entries from the event log.

      For more information on the EventLogCleanup task, see Configure news event log clean-up.

    You can use the CommunitiesScheduler commands to retrieve details about these tasks, and manually pause and resume the tasks as needed.

    To administer the tasks performed by WAS scheduler, complete the following steps.

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Administer the Communities scheduler service:

        CommunitiesScheduler.getTaskDetails(String taskName)

        Return information about the scheduled task specified by taskName. The task names are LifecycleRetryQueuedEvents and EventLogCleanup.

        The values returned in the HashMap are the next scheduled fire time, server time, status (SCHEDULED, RUNNING, SUSPENDED), and task name. SUSPENDED means that the task is not scheduled to run.

        For example: 

        CommunitiesScheduler.getTaskDetails("LifecycleRetryQueuedEvents")

        CommunitiesScheduler.pauseSchedulingTask(String taskName)

        Puts the task in the suspended state. When you pause a scheduled task, that task remains in the suspended state even after you stop and restart Communities or WAS. The task names are LifecycleRetryQueuedEvents and EventLogCleanup. Run the CommunitiesScheduler.resumeSchedulingTask command to get the scheduled task running again.

        If the task is currently running when you use this command, the task continues to run but is not scheduled to run again. If the task is already suspended, this command has no effect.

        The return value is either 1 or 0. 1 indicates success; 0 indicates failure.

        For example: 

        CommunitiesScheduler.pauseSchedulingTask("LifecycleRetryQueuedEvents")

        CommunitiesScheduler.resumeSchedulingTask(String taskName)

        If the task is suspended, puts the task in the scheduled stated. If the task is not suspended, this command has no effect. The task names are LifecycleRetryQueuedEvents and EventLogCleanup.

        The return value is either 1 or 0. 1 indicates success; 0 indicates failure.

        For example: 

        CommunitiesScheduler.resumeSchedulingTask("LifecycleRetryQueuedEvents")


    Configure news event log clean-up

    Edit settings in the communities-config.xml file to define the interval at which the EventLogCleanup task runs.

    To edit configuration files, you must use the IBM WebSphere Application Server wsadmin client.

    See Start wsadmin for details.

    Communities has a database table called EVENTLOG. When certain predefined events occur in communities, those events are written to the table, which increases in size as more and more events are added. The EventLogCleanup task is used to clean up the EVENTLOG database table by removing events that are older than 30 days. When you install Connections, by default, the EventLogCleanup task is scheduled to run every day, every 3 hours, and to delete events older than 30 days. To modify the default schedule to run more or less frequently, you can do so by changing WAS Cron schedule for this task.

    For more information about WAS scheduler, see Scheduling tasks.

    To configure the EventLogCleanup task....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Start the Communities Jython script interpreter.

      1. Access the Communities configuration files: 

        execfile("communitiesAdmin.py")

        If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

      2. Check out the Communities configuration :

        CommunitiesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        CommunitiesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. To view the current configuration settings:

      CommunitiesConfigService.showConfig()

      After updating any of the configuration settings, you can use this command again to display your updates.

    4. To modify the setting for the scheduled task:

      CommunitiesConfigService.updateConfig("property", "value")

      where:

      • property is one of the editable Communities configuration properties.
      • value is the new value with which you want to set that property.

      The following table displays the EventLogCleanup property and provides additional information regarding the property and the type of data that you can enter for it.


      EventLogCleanup properties

      Property Description
      task.EventLogCleanup.enabled Enables or disables the event log cleanup task.

      This property accepts the following values: true or false.

      For example: 

      CommunitiesConfigService.updateConfig("task.EventLogCleanup.enabled", "true")
      task.EventLogCleanup.interval Specifies the interval at which the event log cleanup task runs. The parameter is specified in Cron format.

      For more information about using the Cron format, see Scheduling tasks.

      When you change the interval property, the new schedule is registered the next time that Communities is started on any server in the Communities cluster (if there is one).

      When you install Connections, the default setting for this task is 0 30 0-23/3 ? * *, which means that it will run every 3 hours at 30 minutes past the hour.

      In the following example, the EventLogCleanup task is set to run once every hour at 32 minutes past the hour. 

      CommunitiesConfigService.updateConfig("task.EventLogCleanup.interval", "0 32 0-23/1 ? * *")

    5. After making changes, check the configuration files back in, and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes in Communities for information about how to save and apply your changes.


    Configure the Events widget

    Configure the behavior of the community Events widgets by checking out the calendar-config.xml file and editing it directly.

    To access configuration files, use the wsadmin client.

    See Start wsadmin for details.

    Check out the calendar-config.xml file, edit configuration properties, and then check the file back in.

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter do not execute correctly.

    2. Use the wsadmin client to access and check out the configuration file:

      1. Access the Connections configuration files: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out the calendar-config.xml configuration file:

        LCConfigService.checkOutCalendarConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command does not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is case-sensitive, so type it with care. To get cell name, from wsadmin:print AdminControl.getCell()

        For example:

        • AIX or Linux:LCConfigService.checkOutCalendarConfig("/opt/temp","Cell01")

          Windows:LCConfigService.checkOutCalendarConfig("c:/temp","Cell01")

        • IBM i:

          LCConfigService.checkOutCalendarConfig("/temp","Cell01")

    3. Open calendar-config.xml in a text editor.

    4. Edit any of the following configuration properties:

      Option Description
      maxRepeatingCount Specifies the maximum number of instances of a repeating event. The default is 700.
      allowCommentsFromNonCommunityMember Specifies whether to allow all logged in users with access to the community to comment on the event. The default value is true. When the property is set to false, only community members can comment on the community events.
      icalFeed Specify the range of time for displaying events in a personal calendar. You can specify two values:

      • startFrom specifies how old in months an event can be.
      • endTo specifies how far in the future in months an event can be.
      The default value for startFrom is -6. The default value for endTo is 12.

    5. To check in the changed calendar-config.xml file: 

      LCConfigService.checkInCalendarConfig("working_directory", "cell_name")

    6. After making updates, deploy the changes: 

      synchAllNodes()

    7. To exit the wsadmin client, type exit at the prompt.

    8. Stop and restart all the Connections application servers.


    Retrieve and listing community data

    The community fetch commands return a Java vector of Java hash maps. No file checkout or server restart is required when using these commands.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    Java hash maps provide a useful mechanism for storing community data so that it can be quickly retrieved. You can use the community fetch commands to return a vector of hash maps that contain all the data for communities. The fetch commands return a list of communities. You then pass the lists to print commands to print data for specific communities.

    The following commands listed can also be used to retrieve information about subcommunities.

    To retrieve and list community data....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Use the following commands to return a list of communities and subcommunities.

      The commands display the following information about each community:

      • Display name and directory UUID of the user who last modified the community
      • Date and time when the community was created
      • List of tags associated with the community
      • Community visibility type (public, publicinviteonly, or private)
      • Community name

      • Total number of members in the community (including owners and members)
      • Date and time that the community was last modified
      • Community description
      • Display name and directory UUID of the user who created the community

      The following sample output shows the type of information that is returned from these commands. This information is for one community: 

      {lastModBy=[John Smith, 76982F24-BCC0-4D11-0083-242F9876C0BC], created=10/5/10 9:59:41 PM EDT, tags=[tag1, tag2, tag3], type=public, name=Marketing Community uuid=3e5ecf96-1cf8-4da4-b8bb-87d61e80299b, memberSize=12, lastMod=10/5/10 9:59:41 PM EDT, description=Community used by Marketing folks for brain storming strategies for new products., createdBy=[John Smith, 76982F24-BCC0-4D11-0083-242F9876C0BC]}

        CommunitiesService.fetchAllComm()

        Return a vector of hash maps of all communities and subcommunities. There is no way to distinguish from the information returned whether the object is a community or subcommunity. Do not run CommunitiesService.fetchAllComm() on large deployments because it loads all communities into memory at once. Instead, run CommunitiesService.fetchBatchComm().

        CommunitiesService.fetchCommById(string communityUUID)

        Return the community or subcommunity with the specified UUID.
        You can obtain the UUID for a community or subcommunity by doing one of the following:

        • Use a browser, open the community or subcommunity that you want and copy the UUID from the URL.

        • Run the CommunitiesService.fetchAllComm() wsadmin command to fetch all communities and subcommunities on the server. Copy the UUID from the output.

        For example: 

        wsadmin>CommunitiesService.fetchCommById("59d8e5a7-ba0e-488f-8bcd-1f79a994e419")
[{createdBy=[Andy Jones, 2BC32FEF-E736-4C81-986C-30780C5EF8C3], lastMod=6/18/09 3:09:02 PM EDT, description= Community of developers working on JAVA projects in our company.  This is a community to share ideas., name=JAVA Developers community, uuid=59d8e5a7-ba0e-488f-8bcd-1f79a994e419, memberSize=6, type=publicInviteOnly, tags=[developers, java], created=6/18/09 3:08:48 PM EDT, lastModBy=[Andy Jones, 2BC32FEF-E736-4C81-986C-30780C5EF8C3]}]
wsadmin>

        CommunitiesService.fetchCommByMemberEmail(String email)

        Return all the communities and subcommunities that the user of the specified email address is a member of. There is no way to distinguish from the information returned whether the object is a community or subcommunity.

        For example: 

        CommunitiesService.fetchCommByMember("john_doe@company.com")

        CommunitiesService.fetchCommByMemberUuid(String uuid)

        Return all the communities and subcommunities that the user with the specified UUID is a member of. There is no way to distinguish from the information returned whether the object is a community or subcommunity.

        For example: 

        CommunitiesService.fetchCommByMemberUuid("193F1CE8-E10A-4B9A-B933-C8ECD6C072E4")

        The Member's UUID is the External LDAP identifier for a specific user. Use one of the following commands to return the user's external ID for use in this command.

        • CommunitiesMemberService.getMemberExtIdByEmail("email")
        • CommunitiesMemberService.getMemberExtIdByLogin("login")

        CommunitiesService.fetchCommByName(String name)

        Return the community or subcommunity with the specified name.

        There is a maximum of one community in the list, but that list can be used in the other methods that use a list input. If no match is found, the list will be empty.

        For example: 

        wsadmin>CommunitiesService.fetchCommByName("Test Community")

        If the name of the community or subcommunity that you enter in this command is not unique, the command fails with an error. If the command fails, use the following command instead: 

        CommunitiesService.fetchCommById(string communityUUID)

        CommunitiesService.fetchMember(List list)

        Return the input list of communities or subcommunities with an additional property for each community that is the member list for that community.

        This command is run in two steps. First, generate a list of data to input into the fetchMember command and assign the list to a variable. The variable is then used as input into the fetchMember command.

        For example: 

        wsadmin>allComm=CommunitiesService.fetchCommByName("Test Community")
wsadmin>CommunitiesService.fetchMember(allComm)

        CommunitiesService.fetchReference(List list)

        Adds references (feeds and bookmarks) to communities or subcommunities in the list passed into this command and returns a new list with references.

        This command is run in two steps. First, use the fetchCommByName command to gather the list of communities and assign the list to a variable. The variable is then used as input into the fetchReference command.

        For example: 

        wsadmin>allComm=CommunitiesService.fetchCommByName("Test Community")
wsadmin>CommunitiesService.fetchReference(allComm)

        The results that are returned include any feeds or bookmarks for a community or subcommunity. The name that the user enters when creating the feed or bookmark is also displayed as part of the reference information.

        For example: reference=[[Cooking, http://www.cuisineathome.com]]

        Here are sample results from running the command: 

        {createdBy=alex_jones@MyCompany.com, lastMod=2/22/08  8:43:48 AM EST, description=Community with one bookmark one feed,  name=Jones Community, uuid=3395f15e-bde7-4151-80ed-ed538d12d00e,  memberSize=2, reference=[[CNN, http://www.cnn.com], [Ghirardelli  Chocolate, http://www.ghirardelli.com]], type=publicInviteOnly,  tags=[chocolate], created=2/22/08 8:42:53 AM EST, lastModBy=
bsmith@MyCompany.com}

    4. Use these commands to print the information that is generated by using the fetch commands.

        CommunitiesService.listComm(List list)

        Prints the information associated with the communities or subcommunities in the list input to the wsadmin command window in an easy-to-read format. The data printed includes community name, UUID, type, who created it, creation date, last person who modified it, date of last modification, membership list size, and description. If the list includes members, then this command also prints the membership list. If the list includes references, the command also prints the reference information.

        This command is run in two steps. First, generate the data to input into the listComm command and assign the list to a variable. The variable is then used as input into the listComm command.

        For example: 

        wsadmin>byMember=CommunitiesService.fetchCommByMember("jane_doe@company.com")
wsadmin>CommunitiesService.listComm(byMember)

        CommunitiesService.listCommToFile(List list, String filename)

        Prints the information associated with the communities or subcommunities in the list input to the specified file using an easy-to-read format. The directory to which the file is to be output must already exist. The data printed includes community name, UUID, type, who created it, creation date, last person who modified it, date of last modification, membership list size, and description. If the list includes members, then this command also prints the membership list. If the list includes references, the command also prints the reference information.

        This command is run in two steps. First, generate the data to input into the listCommToFile command and assign the list to a variable. The variable is then used as input into the listCommToFile command.

        For example: 

        wsadmin>byMember=CommunitiesService.fetchCommByMember("jane_doe@company.com")
wsadmin>CommunitiesService.listCommToFile(bymember,"/temp/CommMembers.txt")

    5. Use this command to iterate through a list of UUIDs for all communities.

        CommunitiesService.fetchBatchComm(batchSize, priorLastCommunityId)

        Return a portion of an ordered list of UUIDs for all communities. The command does not return any details about the communities. It returns only the UUIDs.

        The command takes the following parameters:

          batchSize
          Uses an integer to indicate how many communities you want returned.

          priorLastCommunityId
          Enter the UUID of the last community enclosed by double quotation marks. If you don't have a community id to enter, use either None or "". If you enter CommunitiesService.fetchBatchComm(5, None), the command returns the GUID for the first five communities.

        The following example fetches a batch of two communities.  None indicates that it starts with the first community. 

        wsadmin>CommunitiesService.fetchBatchComm(2, None)
fetchBatchComm request processed
[3302c2fa-e16f-4a52-8685-b56c1435d742, 3e457e81-c9d9-4a20-a71a-6cc336673fab]


    Filter community lists

    Use the CommunitiesListService commands to filter the information in community lists and to generate smaller lists containing more specific information.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    To filter community lists, perform the following steps.

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands that you enter will not execute correctly.

    2. Start the Communities Jython script interpreter 

      execfile("communitiesAdmin.py")

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

    3. Use the following commands to filter the information in community lists and generate new lists.

      The commands can also be used on application lists.

        CommunitiesListService.filterListByApp(List list, String filter)

        Return a new list containing only the communities where the application type matches the regular expression filter. Examples of applications include IBM Lotus Quickr Wiki, and Lotus Quickr Teamspace.

        Depending on how the list is returned, you can filter an application from:

        • All links, when the list is returned by the ManagedAppService.fetchAllLink command.

        • A specific community, when the list is returned by the CommunitiesService.fetchCommByName command.

        • The communities that a specific user is a member or owner of, when the list is returned by the CommunitiesService.fetchCommByMember command.

        The following example gets a list of all the communities that the specified user is a member or owner of, and then gets a list of all the links associated with that user. The filter command then filters that list by the application name specified. A list of communities associated with the specified application is returned. 

        wsadmin>bymember=CommunitiesService.fetchCommByMember("users_email_address")
wsadmin>links=ManagedAppService.fetchLinkByComm(bymember)
wsadmin>CommunitiesListService.filterListByApp(links,"application_name")

        CommunitiesListService.filterListByName(List list, String filter)

        Return a new list containing only the communities and subcommunities whose names match the regular expression filter.

        For example: 

        wsadmin>allComm=CommunitiesService.fetchAllComm()
wsadmin>CommunitiesListService.filterListByName(allComm,"My Community Name")
        This example returns a list of all communities and subcommunities using the fetchAllComm command (command is set to a variable that will be used in the next command) and then filters the results to get the information for a particular community or subcommunity.

        CommunitiesListService.filterListByType(List list, String filter)

        Return a new list containing only the communities and subcommunities whose type (private, public, or publicInviteOnly) matches the regular expression filter.

        For example: 

        wsadmin>commByMember=CommunitiesService.fetchCommByMember("jane_smith@company.com")
wsadmin>CommunitiesListService.filterListByType(commByMember,"publicInviteOnly")
        This example retrieves a list of all the communities and subcommunities for a particular user (in this case Jane Smith) and then filters that list to display all the user's communities and subcommunities that are publicInviteOnly. The fetch command is set to a variable that will be used in the listService command.

        CommunitiesListService.filterListById(List list, String filter)

        Return a new list containing only the communities and subcommunities whose ID matches the regular expression filter.

        For example: 

        wwsadmin>all=CommunitiesService.fetchAllComm()
wsadmin>CommunitiesListService.filterListById(all, "c6a2c680-5933-4efa-9a14-be1723445d30")
        This example returns a list of all the communities and subcommunities and then filters the results by ID to list only the communities and subcommunities where the ID matches the one specified.


    Integrate Communities with IBM Lotus Quickr

    Use the Connections Connector for Lotus Quickr to integrate Lotus Quickr places with communities.

    When you install the Connections Connector for Lotus Quickr, community members can use different types of Lotus Quickr places to organize and share project files, post comments to a blog, and work collaboratively on team documents.

    For information about how to install and perform administrative tasks for the connector, see Connections Connector for Lotus Quickr.


    Administer Files

    You administer Files using the wsadmin client to specify properties in a configuration file, or run administrative commands.

    You edit the configuration file to control how and when various Files operations take place. You use the administrative commands to perform tasks that manipulate Files content. Changes to the configuration file require node synchronization and a restart of the Files server before they take effect. Changes made using administrative commands take effect immediately.


    Change Files configuration property values

    Configuration properties control how and when various Files operations take place. You can edit the properties to change the ways that Files operates.

    To edit configuration files, you must use the wsadmin client.

    Configure Files using scripts accessed with the wsadmin client. These scripts use the AdminConfig object available in IBM WebSphere Application Server wsadmin client to interact with the Files configuration file. Changes to Files configuration settings require node synchronization and a restart of the Files server before they take effect.

    To edit Files configuration properties, complete the following steps:

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter.

      1. Access the Files configuration files: 

        execfile("filesAdmin.py")

        If you are asked to select a server, you can select any server.

      2. Check out the Files configuration :

        FilesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        FilesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. To view a list of the valid Files configuration settings and their current values:

      FilesConfigService.showConfig() Here is some sample output from the FilesConfigService.showConfig() command: 

      Files configuration properties:
    security.logout.href = /files/ibm_security_logout
    activeContentFilter.enabled = true
    cache.user.timeout = 43200000
    cache.http.publicContentMaxAgeInSecs = 604800
    db.dialect = DB2
    4. Some properties must be edited using the wsadmin client; others can only be edited by editing the configuration XML file directly.

      To change a Files configuration setting, do one of the following:

      • To edit a property using the wsadmin client: 

        FilesConfigService.updateConfig("property", "value")

        where property is one of the editable Files configuration properties and value is the new value with which you want to set that property.

        See Files configuration properties for a complete list of editable properties.

        For example: 

        FilesConfigService.updateConfig("file.versioning.enabled", "false")

      • To edit the value of a property in a configuration file directly, from the temporary directory to which you checked it out, open the file in a text editor, and then make your changes.

    5. Repeat step 4 for each single-value property setting to change.

    6. After updating the Files properties with new values, use the FilesConfigService.showConfig() command to display the list of properties and their updated values. These are the values that will be checked in with the FilesConfigService.checkInConfig() command.

    You must check the configuration files back in after making changes, and they must be checked in in the same wsadmin session in which they were checked out for the changes to take effect.

    See the topic Applying Files property changes for details.


    Files configuration properties

    Configuration properties control how and when various Files operations occur and help optimize performance.

    You can modify the following configuration properties in the files-config.xml file. After making changes to the file, restart the Files server to implement the changes.

    Note the following restrictions on the values allowed in the file:

    • All configuration properties (except those with multiple values) are required.
    • .enabled properties must have boolean values of either true or false.
    • Number values must be integers.

      activeContentFilter.enabled
      Does not apply to this release.

      api.indent.enabled

      Specifies whether the Files service API output is indented. This is false by default. To enable indentation, specify true.

      Enable this property to help with development and debugging. It is disabled by default because it does affect performance.

      cache.http.publicContentMaxAgeInSecs

      Maximum age of the public content cache before it is refreshed, in seconds. The public content cache stores static web resources, such as JavaScript and images. Decrease this value to show resource changes more quickly.

      The value must be greater than or equal to 0.

      You can force a resource update by opening the LotusConnections-config.xml common configuration properties file and setting the versionStamp property to any token. This token is included in most urls, so changing this token changes the url. Since urls are cached by path and cache header, the new url overrides the old url and refreshes the resources.

      For information, see Common configuration properties.

      Some resources, such as some images, do not use version stamps. If you edit those frequently, you can decrease the cache.http.publicContentMaxAgeInSecs value to show changes more quickly. If not, you can leave the value high and update the version stamp when you make changes.

      cache.http.publicFeedMaxAgeInSecs

      Maximum age of the public feed cache before it is refreshed, in seconds. Public feeds pass information to the Public Files view. You may want to raise this value in very large deployments (for example, over a million files) to avoid performance issues. It could also be decreased to have very up-to-date information in the public view. A value of 0 means no feeds are cached.

      The value must be greater than or equal to 0.

      cache.user.timeout

      Number of milliseconds user objects stay in the user information cache. The user information cache stores metadata about users, such as names and email addresses. Use this property to control the frequency of requests to the Files database for user information.

      The value must be greater than or equal to 1.

      If the value of a user's data changes in the background (when the update user task or commands for MemberSynch are executed) the cache is invalidated.

      db.dialect

      Reflects the current database type, typically specified during installation. Accepts the values DB2, Oracle, or SQL Server.

      directory.community.membershipCache.maximumAgeOnLoginInSeconds

      Number of seconds after a user logs in that community membership cache is refreshed. Only applicable if Community Files and Community Integration are enabled.

      The value must be greater than or equal to 0.

      Refreshing the cache is required for a user to have the same access as the community, but it affects performance. A short time before refresh means Files is more up-to-date, but performance may be slower. A long time before refresh may affect performance less, but users do not have immediate access to what the community can access.

      You can decrease the value here and then tell users that logging out and then in again is the best way to refresh the cache. This would allow you to increase the number of seconds in directory.community.membershipCache.maximumAgeOnRequestInSeconds so that frequent requests would not affect performance.

      directory.community.membershipCache.maximumAgeOnRequestInSeconds

      Number of seconds after an application request that the community membership cache is refreshed. Only applicable if Community Files and Community Integration are enabled.

      The value must be greater than or equal to 0.

      Refreshing the cache is required for a user to have the same access as the community, but it affects performance. A short time before refresh means Files is more up-to-date, but performance may be slower. A long time before refresh may affect performance less, but users do not have immediate access to what the community can access.

      If you decrease the value of directory.community.membershipCache.maximumAgeOnLoginInSeconds and then tell users that logging out and then in again is the best way to refresh the cache, you can increase this value to 10 or even 20 minutes, so that frequent requests will not affect performance.

      directory.group.membershipCache.maximumAgeOnLoginInSeconds

      Number of seconds after a user logs in that the group membership cache is refreshed. Only applicable if groups are enabled.

      The value must be greater than or equal to 0.

      Refreshing the cache is required for a user to have the same access as the group, but it affects performance. A short time before refresh means Files is more up-to-date, but performance may be slower. A long time before refresh may affect performance less, but users do not have immediate access to what the group can access.

      You can decrease the value here and then tell users that logging out and then in again is the best way to refresh the cache. This would allow you to increase the number of seconds in directory.group.membershipCache.maximumAgeOnRequestInSeconds so that frequent requests would not affect performance.

      directory.group.membershipCache.maximumAgeOnRequestInSeconds

      Number of seconds after an application request that the group membership cache is refreshed. Only applicable if groups are enabled.

      The value must be greater than or equal to 0.

      Refreshing the cache is required for a user to have the same access as the group, but it affects performance. A short time before refresh means Files is more up-to-date, but performance may be slower. A long time before refresh may affect performance less, but users do not have immediate access to what the group can access.

      If you decrease the value of directory.group.membershipCache.maximumAgeOnLoginInSeconds and then tell users that logging out and then in again is the best way to refresh the cache, you can increase this value to 10 or even 20 minutes, so that frequent requests will not affect performance.

      directory.typeaheadSearch.maximumResults

      Maximum number of names to display when a user searches for user or group names in a search field. Sets a maximum for both typeahead results and search results (when they click the search icon).

      The value must be greater than or equal to 1.

      If the value is very large, such as 1,000, and there are 1,000 or more matches, all names are returned and performance is greatly reduced. If the value is low, such as 10, users typing a generic name might not see all matches.

      download.modIBMLocalRedirect.enabled

      Specifies whether the IBM HTTP Server serves downloaded files instead of WAS redirect servlet.

      You can configure Connections to have the IBM HTTP Server download files. This is strongly recommended in production environments.

      If this property is set to true, also specify a URL in the download.modIBMLocalRedirect.hrefPathPrefix property. If the property is set to false, WAS redirect servlet downloads files.

      To see information and steps for configuring the IBM HTTP Server to download files, see Configure file downloads through the HTTP Server.

      download.modIBMLocalRedirect.hrefPathPrefix

      Path to the file system directory where Files data is stored. The file path should not include a trailing slash.

      This is only relevant if the download.modIBMLocalRedirect.enabled property is true.

      To see more information and steps for configuring the IBM HTTP Server to download files, see Configure file downloads through the HTTP Server.

      download.stats.logging.enabled

      Level of detail to log about file downloads. If true, the Files application logs detailed download statistics, including the names of authenticated users who download files, and the version they most recently downloaded. If false, the applications only log the number of times a file is downloaded.

      Specify true for a better user experience and auditing.

      emailNotification.addOnMediaDownload.enabled

      Specifies whether to send email notification to users who download a file when the file is edited.

      The download.stats.logging.enabled property must be true for this to work.

      file.attachment.maximumSizeInKb

      Does not apply to Files. Files does not have attachments, the value in this property will not affect the application.

      file.media.maximumSizeInKb

      Maximum size allowed for media, in kilobytes. In Files, media are files.

      The value must be greater than or equal to 1.

      This property is useful if you want a relatively large quota size for libraries, but you do not want users upload very large files, such as .iso files.

      After changing this value, the maximum size limit will not change for users until their browser cache is refreshed. You can force a refresh by running a command to update the product version stamp. see Required post-customization step for more information on forcing a browser cache refresh.

      file.page.maximumSizeInKb

      Does not apply to Files. Files does not have pages, the value in this property will not affect the application.

      file.restrictions.enabled

      Enables or disables the ability to restrict the types of files that users can upload in Files. Accepts the values true or false.

      To see information and steps for restricting file types, see Restricting file types in Files.

      file.restrictions.mode

      Set the mode for file extension restrictions. Accepts the values allow or deny. If the value is allow, then users can only upload files with extensions on the list, or change the extension of existing files to those on the list. If the value is deny, then users can only upload files with extensions not the list, or change the extension of existing files to those not the list.

      For example: 

      <file>
 ....
 <restrictions enabled="true" mode="allow">
  <extensions>
   <extension>odt</extension>
   <extension>odp</extension>
   <extension>ods</extension>
  </extensions>
 </restrictions>
</file>

      To see information and steps for restricting file types, see Restricting file types in Files.

      file.storage.rootDirectory

      Path to the file system directory where Files data is stored. This can be set during installation and be different for each node in a cluster. If a directory is specified in during installation this value (a variable by default) is populated by WAS. However, you can specify any directory.

      Connections looks for a files and a temp directory in this directory. If they are not there they are created. The temp directory stores data while the data is uploaded or virus scanned (if enabled). The files directory contains the binary data that must be backed up.

      For more information on backing up data, see Backing up Files data.

      file.versioning.enabled

      Specifies whether file versioning is allowed. Specify true or false.

      If false, the versioning interface does not display and the first version is always current. If you disable this after multiple versions of a file are created the latest version becomes the current and only version.

      Note that new versions are created only when content changes, not title or tags or other metadata.

      Specify false to simplify and reduce data storage.

      For more information, see Disabling file versioning.

      publicMedia.maximumResults

      Maximum number of files displayed in public views.

      For example, the default setting of 1000 means public views can only have 1000 files. Adjust this property to improve performance.

      The value must be greater than or equal to 100.

      renditions

      Specifies whether Files can generate previews for files types that can be displayed inline in areas as the activity stream, embedded experience gadget, and media gallery widget. Only JPEG, JPG, GIF, and PNG file types are available for preview. The generated previews can be in JPG (default) or PNG format.

      The following renditions enabled sample enables display of thumbnail images and specifies image format and size for each preview style: 

      <renditions enabled="true">
               <small format="JPG" width="100" height="100"/>
               <medium format="JPG" width="250" height="250"/>
              < large format="JPG" width="500" height="500"/>
           </renditions>

      For data existing before Connections 4.0, you can use the following scheduled task to enable and generate previews for supported file types. 

      <task name="RenditionDailyGeneration" interval="0 0 0 * * ?" enabled="true" type="internal"></task>

      scheduledTasks.DirectoryGroupSynch.args.maximumDataAgeInHours

      Specifies the number of hours that group information can remain in the Files database before the synchronization task can run on it. Does not run if groups are disabled.

      The value must be greater than or equal to 0.

      The synchronization task runs automatically in the background, synchronizing group names in the Files database with the Connections user directory. It queries the user directory with the directory ID and when it finds a match it synchronizes the group name.

      The task runs on any group information older than the value specified in the scheduledTasks.DirectoryGroupSynch.args.maximumDataAgeInHours property. It runs at a frequency specified in the scheduledTasks.DirectoryGroupSynch.interval property. It pauses between groups for the amount of time specified in the scheduledTasks.DirectoryGroupSynch.args.pauseInMillis property.

      scheduledTasks.DirectoryGroupSynch.args.pauseInMillis

      Number of milliseconds that the synchronization task should wait before updating the next group's information. Use this to add a small amount of time between synchronizing items in the queue to avoid overloading your user directory as the task runs. Does not run if groups are disabled.

      The value must be greater than or equal to 0.

      The synchronization task runs automatically in the background, synchronizing group names in the Files database with the Connections user directory. It queries the user directory with the directory ID and when it finds a match it synchronizes the group name.

      The task runs on any information older than the value specified in the scheduledTasks.DirectoryGroupSynch.args.maximumDataAgeInHours property. It runs at a frequency specified in the scheduledTasks.DirectoryGroupSynch.interval property. It pauses between groups for the amount of time specified in the scheduledTasks.DirectoryGroupSynch.args.pauseInMillis property.

      Zero is an acceptable value if the remote user directory can handle many simultaneous queries.

      scheduledTasks.DirectoryGroupSynch.enabled

      Enables or disables the synchronization task for groups. The default is true.

      The synchronization task runs automatically in the background, synchronizing group names in the Files database with the Connections user directory. It queries the user directory with the directory ID and when it finds a match it synchronizes the group name. If the group name is not found in the user directory, it is removed from the database.

      scheduledTasks.DirectoryGroupSynch.interval

      Frequency with which the synchronization task runs.

      This property accepts a chronological expression.

      The synchronization task runs automatically in the background, synchronizing group names in the Files database with the Connections user directory. It queries the user directory with the directory ID and when it finds a match it synchronizes the group name.

      The task runs on any group information older than the value specified in the scheduledTasks.DirectoryGroupSynch.args.maximumDataAgeInHours property. It runs at a frequency specified in the scheduledTasks.DirectoryGroupSynch.interval property. It pauses between groups for the amount of time specified in the scheduledTasks.DirectoryGroupSynch.args.pauseInMillis property.

      Adjust this property to speed up or slow down the process of synchronizing group information.

      scheduledTasks.FileActuallyDelete.args.softDeleteMinimumPendingTimeInMins

      Number of minutes that files must be in the pending deletion queue before the delete files task will delete them.

      For example, the default value of 720 means they will be deleted if they have been in the pending deletion queue 720 or more minutes.

      The value must be greater than or equal to 0.

      More pending time allows users to finish downloads of files added to the pending deletion queue. It also allows looser online back up policies.

      For example, for online backups that take less than this number of minutes you do not need to pause the file deletion task.

      For more information about pausing the file deletion task during backups, see Backing up Files data.

      scheduledTasks.FileActuallyDelete.enabled

      Enables or disables the delete files task. The default is true.

      The task deletes files if they are marked as pending deletion, and they are older than the value specified in the scheduledTasks.FileActuallyDelete.args.softDeleteMinimumPendingTimeInMins property.

      scheduledTasks.FileActuallyDelete.interval

      Frequency with which the delete files task runs.

      This property accepts a chronological expression.

      Files are deleted if they are marked as pending deletion, and they are older than the value specified in the scheduledTasks.FileActuallyDelete.args.softDeleteMinimumPendingTimeInMins property.

      scheduledTasks.MetricsDailyCollection.enabled

      Specifies whether to collect metrics. Specify true or false.

      See Files administrative commands for MetricService commands you can use to access metrics.

      The collection task runs near midnight in the server timezone, so all of the date-based metrics include data from most of a given day. Metrics entries only require a few kilobytes per day, so there is little performance impact to enabling them.

      scheduledTasks.MetricsDailyCollection.interval

      Frequency with which daily metrics collection task runs. Only the default is supported: the task can only run at midnight in the server timezone. Do not edit this property.

      scheduledTasks.TagUpdateFrequency.enabled

      Specifies whether to run the tag frequency update task. This task finds the most frequently used tags in public files updates the public files tag cloud.

      scheduledTasks.TagUpdateFrequency.interval

      Frequency with which the tag frequency update task runs. This task finds the most frequently used tags in public files and updates public tag clouds and the autocomplete lists that display when users type a tag name in the tag filter field.

      For example, it measures how often the tag human-resources is used in public files and updates the cloud and lists accordingly.

      This property accepts a chronological expression.

      Update tag frequency data is resource-intensive, so you may want to adjust this value as your deployment grows. In small deployments 60 minutes is appropriate. In large deployments, once per day is recommended. Only updating once per day in large deployments should not cause problems, since the 100 to 500 most-used tags do not change very often.

      This property only affects public tags. Tag clouds for one person's set of files are updated in real time and are not affected.

      scheduledTasks.SearchClearDeletionHistory.enabled

      Specifies whether to run the task. Specify true or false.

      scheduledTasks.SearchClearDeletionHistory.interval

      Frequency with which the task runs.

      This property accepts a chronological expression.

      scheduledTasks.RenditionDailyGeneration.enabled

      Specifies whether to run the rendition task. Specify true or false.

      scheduledTasks.RenditionDailyGeneration.interval

      Frequency with which the rendition task runs.

      This property accepts a chronological expression.

      search.seedlist.maximumIncrementalQuerySpanInDays

      Number of days that deletion records are saved before they are eligible to be deleted by the SearchClearDeletionHistory task.

      The value must be greater than or equal to 1.

      Files keeps records of deleted files. These records are eligible to be deleted by the SearchClearDeletionHistory task after the number of days specified in this property. The incremental search crawler needs these deletion records to update the search index. If the records are deleted before the incremental crawler reads them, updates will be incomplete. This is not allowed, so Files performs a full crawl instead of an incremental crawl. Full crawls delete the existing search index and create a new one, which is more time consuming than incremental crawls.

      To avoid frequent full crawls, set this value higher than the span of days between incremental crawls.

      For example, if incremental crawls happen every four days, set this value higher than 4. This ensures that incremental crawls capture all deletion records.

      search.seedlist.maximumPageSize
      Maximum number of items on search return page. The value must be greater than or equal to 100.

      security.inlineDownload.enabled

      Enables inline display of files. This is useful when you use the Files API to download and display active content, such as Adobe Flash (.swf) files, in your own HTML pages.

      By default, the Connections server passes Files application files to browsers with the header Content-Disposition: attachment. This means files display as attachments; when users click the attachment they are prompted to open or download the file. It also prevents embedding files. To embed files in your own HTML page using an <embed> tag, the content disposition must be inline. This affects active content, such as Adobe Flash (.swf), and HTML pages referenced with <iframe>.

      Configure a property in files-config.xml to change the content disposition from attachment to inline. Then set the inline parameter to true in your Files API download requests.

      See Displaying files inline.

      Files uses the attachment disposition for security reasons. Uploaded files could potentially contain malicious code that can exploit the cross-site scripting vulnerabilities of some browsers. If you switch to inline disposition, you should configure an alternate domain download for greater security.

      See Securing applications from malicious attack.

      Accepted values are true and false.

      security.logout.href

      Logout URL for single-sign on solutions that require their own logout page.

      If you are configuring Connections to work with Tivoli Access Manager, specify the following value: 

      /files/ibm_security_logout?logoutExitPage=<url>
      where <url> is the Tivoli Access Manager junction URL (this is usually the host name of the server).

      For more information, see Enabling single-sign on with IBM Tivoli Access Manager.

      You must use fully-qualified domain names in this configuration file. If you use an abbreviated name, secure communications between servers will fail.

      If you customize the contextroot for Files in WebSphere Application Server (WAS) and LotusConnections-config.xml, also change the contextroot in the security.logout.href value. Otherwise, users will be unable to log out.

      tagFilter
      Specifies the maximum number of tags to filter Files search results. The default is 3. A value greater than 10 is not recommended for performance reasons. Format is as follows: 

      <tagFilter maximumTags="5"/>

    For information on how to format the value of an interval attribute, see Scheduling tasks.


    Configure MIME types for Files

    You can assign MIME types to file extensions.

    To edit configuration files, you must use the wsadmin client.

    You can configure Files to assign a specific MIME type to files with specific extensions. Files with MIME types tell operating systems what applications to open them with, and what applications to display in file open windows. MIME types make it easier for users at a glance to know what type of data a file contains. Also, some applications do not download files that do not have a MIME type that they support.

    This configuration applies to files uploaded through the web user interface. The configuration is ignored if a third party application assigns MIME types to extensions using the API.

    You can also map extensions to icons.

    See the topic Customizing file type icons.

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter.

      1. Access the Files configuration files: 

        execfile("filesAdmin.py")

        If you are asked to select a server, you can select any server.

      2. Check out the Files configuration :

        FilesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        FilesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. Navigate to the working directory specified in Step 2b and open the mime-files-config.xml file. The contents look like this: 

      <mapping mimeType="..." mediaType="...">          <extension></extension>          <extension></extension>          ....  </mapping>

    4. In the mimeType attribute specify a mime type in standard format, for example text/plain. Each value must be unique compared with other mimeType values in other mapping elements, or an error is returned when you start the system.

      See the Internet Assigned Numbers Authority (IANA) web site for a list of MIME types.

      For example, using the <extension openFromWeb="true">jpg</extension> entry displays an Open this file button in the Files user interface for files that have the .jpg file extension. This allows users to directly open this file type in their in browser, provided that their browser supports this action. 

        <mapping mediaType="image" mimeType="image/jpeg">
    <extension>jpe</extension>
    <extension openFromWeb="true">jpeg</extension>
    <extension openFromWeb="true">jpg</extension>
  </mapping>
      In this example, files with an extension of .jpg will have mime-type of image/jpeg. The openFromWeb setting indicates whether this file can be opened directly in browser. This attribute only takes effect when security.inlineDownload.enabled is true.

    5. In each extension element specify the extensions to map to the MIME type. Each value must be unique compared with other extension elements in the configuration file, or an error is returned when you start the system.

    6. Apply the changes following steps in the Applying Files property changes.


    Example

    <mapping mimeType="text/plain" mediaType="">      <extension>txt</extension>    ....  </mapping>


    Related

  • How do I enable the mobile version?


    Apply Files property changes

    After you have edited the Files configuration properties, check the changed configuration file in, update the version stamp property, and restart the servers to apply the changes.

    For information about the properties that you can edit, see Files configuration properties. To apply Files property changes:

    1. Check in the changed configuration property keys using the following wsadmin client command: 

      FilesConfigService.checkInConfig()

    2. Update the value of the version stamp configuration property in LotusConnections-config.xml to force users' browsers to pick up this change

      See Required post-customization step

    3. To exit the wsadmin client, type exit at the prompt.

    4. Stop and restart the server hosting the Files application.


    Run Files administrative commands

    Use administrative commands to perform tasks that manipulate Files content.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    Administrative commands interact with the Files application and its resources through scripts. These scripts use the AdminControl object available in the IBM WebSphere Application Server wsadmin tool to interact with the Files server. Each script uses managed Java™ beans (MBeans) to get and set server administration properties.

    If an error occurs when you are executing the commands, you can examine the SystemOut.log file to determine what went wrong.

    To run Files administrative commands:

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter 

      execfile("filesAdmin.py")

    3. See Files administrative commands for a complete list of administrative commands for the Files application.


    Files administrative commands

    Use these commands to perform administrative tasks for Files. No file checkout or server restart is needed when using these commands.

    The following sections define administrative commands you can use when working with Files.

    See Administering Files for related information.

    Many commands ask for IDs as input parameters, such as library IDs, user IDs, policy IDs, and file IDs. You can use commands that take parameters you do know to return data including the ID you are looking for.

    For example, run FilesMemberService.getByEmail(string email) providing a user's email address and among the data returned is the user's ID. You can also find IDs using feeds.


    FilesConfigService

      FilesConfigService.checkOutConfig("working_directory", "cell_name")

      Checks Files configuration files out to a temporary directory. Run from the wsadmin command processor.

        working_directory
        Temporary working directory to which the configuration files are copied. The files are kept in this working directory while you make changes to them.

        cell_name
        Name of the WAS cell hosting the application. To get cell name, from wsadmin: 

        print AdminControl.getCell()

      For example:

      • AIX or Linux: 

        FilesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

        Windows: 

        FilesConfigService.checkOutConfig("c:/temp","Cell01")

      • IBM i: 

        FilesConfigService.checkOutConfig("/temp","Cell01")

      FilesConfigService.showConfig()
      Display the current configuration settings. Check out the configuration files with FilesConfigService.checkOutConfig() before running FilesConfigService.showConfig().

      FilesConfigService.updateConfig("quick_config_property", "new_value")
      Updates configuration properties.

        quick_config_property

        Property in the files-config.xml configuration file expressed as a quick config command.

        For example the quick config value for following property: 

        <security>
<logout href="/files/ibm_security_logout" />
</security>
        is this: 

        security.logout.href

        See Files configuration properties for configuration properties and descriptions.

        new_value
        The new value for the property. Property values can be restricted, for example to either true or false.

        See Files configuration properties for configuration properties and descriptions.

      For example, to set the scheduledTasks.MetricsDailyCollection.enabled property to false: 

      FilesConfigService.updateConfig("scheduledTasks.MetricsDailyCollection.enabled", "false")

      FilesConfigService.checkInConfig()

      Checks in Files configuration files. Run from the wsadmin command processor.


    FilesMemberService

      FilesMemberService.getById(string userId)

      Return information about a user specified by a user ID. The command only searches the Files database, so it only returns users who have logged in at least once.

      Parameters:

        id
        The user ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000. The following information is returned:

        • id: The user ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • name: The user's name in the database as of the date in directoryLastUpdate.
        • email: The user's email address.
        • isOrphan: Returns true if the user is in the database, but not the directory.
        • createDate: The date the user was added to the database.
        • lastVisit: The date of the user's last log in.
        • directoryLastUpdate: The last time the user's data was synchronized from the directory.
        • directoryGroupLastUpdate: The last time this user's group membership was synchronized from the directory.
        • communityLastUpdate: The last time this user's Community membership was synchronized.

      For example: 

      FilesMemberService.getById("2d93497d-065a-4022ae25-a4b52598d11a")

      FilesMemberService.getByExtId(string externalId)

      Return information about a user specified by an external directory ID. The command only searches the Files database, so it only returns users who have logged in at least once.

      Parameters:

        externalId
        A string value matching the user's external directory ID. This can be any parameter in the user directory that you have configured as the directory ID. The following user information is returned:

        • id: The user ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • name: The user's name in the database as of the date in directoryLastUpdate.
        • email: The user's email address.
        • isOrphan: Returns true if the user is in the database, but not the directory.
        • createDate: The date the user was added to the database.
        • lastVisit: The date of the user's last log in.
        • directoryLastUpdate: The last time the user's data was synchronized from the directory.
        • directoryGroupLastUpdate: The last time this user's group membership was synchronized from the directory.
        • communityLastUpdate: The last time this user's Community membership was synchronized.

      For example: 

      FilesMemberService.getByExtId("2d93497d-065a-4022ae25-a4b52598d11a")

      FilesMemberService.getByEmail(string email)

      Return information about a user specified by an email address. The command only searches the Files database, so it only returns users who have logged in at least once.

      Parameters:

        email
        The email address for the user. The following user information is returned:

        • id: The user ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • name: The user's name in the database as of the date in directoryLastUpdate.
        • email: The user's email address.
        • isOrphan: Returns true if the user is in the database, but not the directory.
        • createDate: The date the user was added to the database.
        • lastVisit: The date of the user's last log in.
        • directoryLastUpdate: The last time the user's data was synchronized from the directory.
        • directoryGroupLastUpdate: The last time this user's group membership was synchronized from the directory.
        • communityLastUpdate: The last time this user's Community membership was synchronized.

      For example: 

      FilesMemberService.getByEmail("john_doe@company.com")

      See Synchronize user data using administrative commands for details.

      FilesMemberService.syncAllMembersByExtId( {"updateOnEmailLoginMatch": ["true" | "false"] } )

      FilesMemberService.syncMemberByExtId("currentExternalId"[, {"newExtId "id-string" [, "allowExtIdSwap ["true" | "false"] ] } ] )

      FilesMemberService.inactivateMemberByEmail("email")

      FilesMemberService.inactivateMemberByExtId("externalID")

      FilesMemberService.getMemberExtIdByEmail("email")

      FilesMemberService.getMemberExtIdByLogin("login")

      FilesMemberService.syncBatchMemberExtIdsByEmail("emailFile" [, {"allowInactivate ["true" | "false"] } ] )

      FilesMemberService.syncBatchMemberExtIdsByLogin("loginFile" [, {"allowInactivate ["true" | "false"] } ] )

      FilesMemberService.syncMemberExtIdByEmail("email" [, { "allowInactivate ["true" | "false"] } ])

      FilesMemberService.syncMemberExtIdByLogin("name" [, {"allowInactivate": ["true" | "false"] } ])


    FilesLibraryService

      FilesLibraryService.getById(string libraryId)

      Return information about a single library specified by an id. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

      Parameters:

        libraryId
        The library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000. The following information is returned:

        • id: The library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • ownerUserId: The user id of the library owner in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • type: The type of library, for example, personal, community, or system.
        • label: A string of characters used to identify the library in a URL.
        • title: The library's title.
        • summary: A summary of library information.
        • size: The total size of the library binary data.
        • percentUsed: The percentage of the maximum allowable size used, according to the library's policy. Zero if not applicable.
        • maximumSize: The maximum size (in bytes) the library's policy allows. Zero for unlimited.
        • policyId: The id of the policy that sets a maximum limit (in bytes) on the library's size, in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • lastUpdate: The last time a significant user-driven update occurred to the metadata.
        • createDate: The library's creation date.
        • externalInstanceId: The widget id if the library is owned by a community.
        • externalContainerId: The community id if the library is owned by a community.
        • themeName: The theme the community owner has selected in communities. Returned for community libraries only.
        • orphan: The value is true if the library owner is no longer active. Returned for personal libraries only.

      For example: 

      FilesLibraryService.getById("2d93497d-065a-4022ae25-a4b52598d11a")

      FilesLibraryService.delete(string libraryId)

      Delete the library specified by the library ID, including all associated content. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

      Parameters:

        libraryID
        The library ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

      For example: 

      FilesLibraryService.delete("f0d01111-9b21-4dd8-b8be-8825631cb84b")

      FilesLibraryService.deleteBatch(string filePath)

      Deletes libraries specified in a text file. The file must contain a list with a single library ID per line in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000. You must create the file and save it in a directory local to the server where you are running the wsadmin processor. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

      Parameters:

        filePath
        The full path to the text file, as a string.

      For example: 

      FilesLibraryService.deleteBatch("C:/connections/delete_libraries.txt")

      FilesLibraryService.assignPolicy(string libraryId, string policyId)

      Assigns a policy to a library. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments. A policy sets a maximum size for a library.

      No message is printed if the task succeeds.

      Parameters:

        libraryId
        The library ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

        policyId
        The policy ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

      For example: 

      FilesLibraryService.assignPolicy("f0d01111-9b21-4dd8-b8be-8825631cb84b", "2d93497d-065a-4022ae25-a4b52598d11a")

      FilesLibraryService.assignPolicyBatch(string filePath)

      Assigns policies to libraries as specified in a text file. The file must contain a list of library-policy ID pairs, one pair per line, values separated by a comma.

      For example: libraryId, policyId. Extra whitespace is ignored. You must create this text file and save it in a directory local to the server where you are running the wsadmin processor.

      A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments. A policy sets a maximum size for a library.

      Parameters:

        filePath
        The full path to the text file, as a string.

      For example: 

      FilesLibraryService.assignPolicyBatch("C:/connections/assign_policies.txt")

      FilesLibraryService.getPersonalByOwnerId(string ownerUserId)

      Return information about the personal library of a specified owner. A personal library is a set of files owned by one person.

      Parameters:

        ownerId
        The user ID of the library owner, in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000. You can use FilesMemberService commands to find owner IDs. The following information is returned:

        • id: The library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • ownerUserId: The user ID of the library owner in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • type: The type of library, for example, personal, community, or system.
        • label: A string of characters used to identify the library in a URL.
        • title: The library's title.
        • summary: A summary of library information.
        • size: The total size of the library binary data.
        • percentUsed: The percentage of the maximum allowable size used, according to the library's policy. Zero if not applicable.
        • maximumSize: The maximum size (in bytes) the library's policy allows. Zero for unlimited.
        • policyId: The id of the policy that sets a maximum limit (in bytes) on the library's size, in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • lastUpdate: The last time a significant user-driven update occurred to the metadata.
        • createDate: The library's creation date.
        • externalInstanceId: The widget id if the library is owned by a community.
        • externalContainerId: The community id if the library is owned by a community.
        • orphan: The value is true if the library owner is no longer active. Returned for personal libraries only.

      For example: 

      FilesLibraryService.getPersonalByOwnerId("2d93497d-065a-4022ae25-a4b52598d11a")

      FilesLibraryService.browsePersonal(string sortOption, string sortAscending, int pageNumber, int itemsPerPage)

      Return a list of personal libraries, with information about each library. A personal library is a set of files owned by one person. The list includes libraries whose owners were removed from the user directory. All parameters have default values.

      Parameters:

        sortOption
        A string value that specifies how to sort the list. The default value is title, but you can use lastUpdate, size, createDate, or quotaPercentage.

        sortAscending
        A string value that specifies whether the list sorts in ascending alphabetical order. This depends on sortOption. If sortOption is title, then this value is true; if sortOption any other value, then this value is false.

        pageNumber
        The number of the page to display.

        For example, if you specify in the itemsPerPage parameter that each page will have 50 items, page 1 will contain items 1-50.

        itemsPerPage
        The maximum number of libraries to list per page. The default value is 20. The following information is returned:

        • id: The library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • ownerUserId: The user id of the library owner in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000..
        • type: The type of library, for example, personal, community, or system.
        • label: A string of characters used to identify the library in a URL.
        • title: The library's title.
        • summary: A summary of library information.
        • size: The total size of the library binary data.
        • percentUsed: The percentage of the maximum allowable size used, according to the library's policy. Zero if not applicable.
        • maximumSize: The maximum size (in bytes) the library's policy allows. Zero for unlimited.
        • policyId: The id of the policy that sets a maximum limit (in bytes) on the library's size, in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • lastUpdate: The last time a significant user-driven update occurred to the metadata.
        • createDate: The library's creation date.
        • externalInstanceId: The widget id if the library is owned by a community.
        • externalContainerId: The community id if the library is owned by a community.
        • orphan: The value is true if the library owner is no longer active. Returned for personal libraries only.

      For example: 

      FilesLibraryService.browsePersonal("title", "true", 1, 25)

      FilesLibraryService.browseCommunity(string sortOption, string sortAscending, int pageNumber, int itemsPerPage)

      Return a list of community libraries, with information about each library. A community library is a set of files owned by a community.

      Parameters:

        sortOption
        A string value that specifies how to sort the list. The default value is title, but you can use lastUpdate, size, createDate, or quotaPercentage.

        sortAscending
        A string value that specifies whether the list sorts in ascending alphabetical order. This depends on sortOption. If sortOption is title, then this value is true; if sortOption any other value, then this value is false.

        pageNumber
        The number of the page to display.

        For example, if you specify in the itemsPerPage parameter that each page will have 50 items, page 1 will contain items 1-50.

        itemsPerPage
        The maximum number of libraries to list per page. The default value is 20. The following information is returned:

        • id: The library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • ownerUserId: The user id of the library owner in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000..
        • type: The type of library, for example, personal, community, or system.
        • label: A string of characters used to identify the library in a URL.
        • title: The library's title.
        • summary: A summary of library information.
        • size: The total size of the library binary data.
        • percentUsed: The percentage of the maximum allowable size used, according to the library's policy. Zero if not applicable.
        • maximumSize: The maximum size (in bytes) the library's policy allows. Zero for unlimited.
        • policyId: The id of the policy that sets a maximum limit (in bytes) on the library's size, in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • lastUpdate: The last time a significant user-driven update occurred to the metadata.
        • createDate: The library's creation date.
        • externalInstanceId: The widget id if the library is owned by a community.
        • externalContainerId: The community id if the library is owned by a community.
        • themeName: The theme the community owner has selected in communities. Returned for community libraries only.

      For example: 

      FilesLibraryService.browseCommunity("title", "true", 1, 20)

      FilesLibraryService.browsePersonalOrphan(string sortOption, string sortAscending, int pageNumber, int itemsPerPage)

      Return a list of personal libraries whose owners were removed from the user directory. A personal library is a set of files owned by one person.

      Parameters:

        sortOption
        A string value that specifies how to sort the list. The default value is title, but you can use lastUpdate, size, createDate, or quotaPercentage.

        sortAscending
        A string value that specifies whether the list sorts in ascending alphabetical order. This depends on sortOption. If sortOption is title, then this value is true; if sortOption any other value, then this value is false.

        pageNumber
        The number of the page to display.

        For example, if you specify in the itemsPerPage parameter that each page will have 50 items, page 1 will contain items 1-50.

        itemsPerPage
        The maximum number of libraries to list per page. The default value is 20. The following information is returned:

        • id: The library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • ownerUserId: The user id of the library owner in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000..
        • type: The type of library, for example, personal, community, or system.
        • label: A string of characters used to identify the library in a URL.
        • title: The library's title.
        • summary: A summary of library information.
        • size: The total size of the library binary data.
        • percentUsed: The percentage of the maximum allowable size used, according to the library's policy. Zero if not applicable.
        • maximumSize: The maximum size (in bytes) the library's policy allows. Zero for unlimited.
        • policyId: The id of the policy that sets a maximum limit (in bytes) on the library's size, in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
        • lastUpdate: The last time a significant user-driven update occurred to the metadata.
        • createDate: The library's creation date.
        • externalInstanceId: The widget id if the library is owned by a community.
        • externalContainerId: The community id if the library is owned by a community.
        • orphan: The value is true if the library owner is no longer active. Returned for personal libraries only.

      For example: 

      FilesLibraryService.browsePersonalOrphan("title", "true", 1, 20)

      FilesLibraryService.getPersonalCount()

      Return the total number of personal libraries.

      FilesLibraryService.getCommunityCount()

      Return the total number of Community libraries.

      FilesLibraryService.getPersonalOrphanCount()

      Return the total number of personal libraries whose owners were removed from the user directory.

      FilesLibraryService.exportSyncedResourceInfo(string fullpathForOutput, string type)

      Return a report of all of the communities that the Files application has interacted with. After a system crash you can compare the report to the latest metadata in the Communities database to help synchronize and update any missing data.

      See the topic Comparing remote application data with the Communities database for more information.

      Note that in clusters, when you run the command from the deployment manager the path and file are created on the server running Files. In clusters where multiple nodes are running Files, you are asked choose a server to connect to and run the command on, and then the path and file are created on that server.

      Parameters:

        fullPathforOutput
        The full path location where you want the report, and the report filename, as a string in quotes. The report is an XML file. Use forward slashes ("/") in the path regardless of operating system.

        type
        This is always the string value, "community" (including quotes). An error is returned if this is anything except "community".

      For example: 

      FilesLibraryService.exportSyncedResourceInfo("c:/connections/sync/community_output.xml", "community")

      FilesLibraryService.getByExternalContainerId(string community_id)
      Return information about the community libraries available in the named Community.

      Parameters:

        community_id
        The community id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

      For example: 

      FilesLibraryService.getByExternalContainerId("003456bc-078d-e990-0450-x12345678900")


    FilesDataIntegrityService

      FilesDataIntegrityService.checkFiles(string extraFileDirectory)

      Checks the integrity of the binary files in the file system extra files directory against the metadata in the database; and stores extra files that were not found in the database.

      For more information see the topic Checking Files data integrity.

      Parameters:

        extraFileDirectory

        Directory in which to store binary files from the file system extra files directory that are not present in the database metadata. If the directory does not exist, the command creates it. If the directory cannot be created, or read or written to, an error is returned.

      For example: 

      FilesDataIntegrityService.checkFiles("C:/files_integrity")

      FilesDataIntegrityService.syncAllCommunityShares()
      Ensure that files that have been shared with communities from Files are correctly synchronized. If the name or the access level of a community has changed, the command updates the Files data store to reflect those changes. If the community no longer exists, the shared files still exist in the Files applications; the file owners still own and have full access to that content even though it is no longer shared.

      FilesDataIntegrityService.syncAllExternalReferences
      When a file is attached to a microblog, also referred to as a status update, the Files database maintains the association. The association is visible in the file’s Sharing tab as the message, This file is associated with one or more status updates. If needed, you can manually synchronize files with their associated status updates using the following procedure.

      1. Open the wasadmin console using the wsadmin -lang jython command.

      2. Run the commandexecfile("filesAdmin.jy").

      3. Run the command FilesDataIntegrityService.syncAllExternalReferences('microblog').


    FilesPrintService

      FilesPrintService.saveToFile(string object, string filePath, string append)

      Prints information returned by other commands to a file.

      Parameters:

        object

        A command with parameters that returns a Map or List<Map> Java object. You can use any of the following commands:

        • FilesMemberService.getById (returns a Map)
        • FilesMemberService.getByExtId (returns a Map)
        • FilesMemberService.getByEmail (returns a Map)
        • FilesLibraryService.getById (returns a Map)
        • FilesLibraryService.getPersonalByOwnerId (returns a Map)
        • FilesLibraryService.browsePersonal (returns a List<Map>)
        • FilesLibraryService.browseCommunity (returns a List<Map>)
        • FilesLibraryService.browsePersonalOrphan (returns a List<Map>)
        • FilesPolicyService.getById (returns a Map)
        • FilesPolicyService.browse (returns a List<Map>>)
        • FilesMetricsService.browsePersonal (returns a List<Map>)
        • FilesMetricsService.browseCommunity (returns a List<Map>)

        filePath
        A path to a file in which to save the object data. The data is saved in comma-separated value (.csv) format.

        append
        string whose default value is "true". Change to "false" to have the command overwrite the existing file instead of appending the data in the existing file.

      For example: 

      FilesPrintService.saveToFile(FilesLibraryService.browsePersonal("title", "true", 1, 25), "/opt/wsadmin/LibraryMap.csv")


    FilesScheduler

      FilesScheduler.pauseSchedulingTask(string taskName)

      Suspends scheduling of a task. Has no effect on currently running tasks. Return a 1 to indicate that the task has been paused. Paused tasks remain paused until you explicitly resume them, even if the server is stopped and restarted.

      Parameters:

        taskName
        Any one of these task names, as a string value:

        • DirectoryUserSynch
        • DirectoryGroupSynch
        • FileActuallyDelete

        • SearchClearDeletionHistory
        • MetricsDailyCollection
        • TagUpdateFrequency
        • RenditionDailyGeneration
         

      For example: 

      FilesScheduler.pauseSchedulingTask("DirectoryGroupSynch")

      FilesScheduler.resumeSchedulingTask(string taskName)

      Resumes the start of a paused task. Return a 1 to indicate that the task has been resumed.

      Parameters:

        taskName
        Any one of these task names, as a string value:

        • DirectoryUserSynch
        • DirectoryGroupSynch
        • FileActuallyDelete

        • SearchClearDeletionHistory
        • MetricsDailyCollection
        • TagUpdateFrequency
        • RenditionDailyGeneration

      For example: 

      FilesScheduler.resumeSchedulingTask("DirectoryGroupSynch")

      FilesScheduler.forceTaskExecution(string taskName, string executeSynchronously)

      Executes a task. Return a 1 to indicate that the task has been executed.

      Property settings in the files-config.xml configuration properties file specify whether tasks are enabled to run automatically, and how often. This command allows you to run tasks manually, for example if you disabled a task but want to run it occasionally.

      Parameters:

        taskName
        Any one of these task names, as a string value:

        • DirectoryUserSynch
        • DirectoryGroupSynch
        • FileActuallyDelete

        • SearchClearDeletionHistory
        • MetricsDailyCollection
        • TagUpdateFrequency
        • RenditionDailyGeneration

        executeSynchronously
        Takes the string values true or false. Specifying this value is not required; the default is false. If this value is false, then the task executes asynchronously, meaning if the taskId is valid the command returns immediately and the execution continues in the background. If this value is true, it the command does not return until the task completes.

      For example: 

      FilesScheduler.forceTaskExecution("DirectoryGroupSynch")

      FilesScheduler.getTaskDetails(string taskName)

      Displays status of a task. Returns detailed status message.

      Parameters:

        taskName
        Any one of these task names, as a string value:

        • DirectoryUserSynch
        • DirectoryGroupSynch
        • FileActuallyDelete

        • SearchClearDeletionHistory
        • MetricsDailyCollection
        • TagUpdateFrequency
        • RenditionDailyGeneration

      For example: 

      FilesScheduler.getTaskDetails("DirectoryGroupSynch")


    FilesPolicyService

      FilesPolicyService.add(string title, long maximumSize)

      Creates a policy with a specified title and maximum size. Policies set a maximum size limit on libraries.

      When a policy is created, an ID is created for it and returned to you. The ID is in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000. You must provide policy IDs as parameters when running other FilesPolicyService commands. Policies can be applied to libraries using the FilesLibraryService.assignPolicy or FilesLibraryService.assignPolicyBatch commands.

      A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

      Parameters:

        title
        The policy title. A required value.

        maximumSize

        The maximum size allowed, in bytes. Must be zero or greater. A value of zero means the size is unlimited.

        Numbers 2GB or greater are long literals, and you must add an "L" to the end of the number, for example a policy of 2GB must be 2147483648L.

      For example: 

      FilesPolicyService.add("My Policy", 2147483648L)

      FilesPolicyService.edit(string policyId, string title, long maximumSize)

      Edits the title and maximum size of a policy with a specified ID. If the ID is for a default policy, the title is not modified. Policies set a maximum size limit on libraries. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

      Parameters:

        policyID
        The policy ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

        title
        The policy title. A required value.

        maximumSize

        The maximum size allowed, in bytes. Must be zero or greater. A value of zero means the size is unlimited.

        Numbers 2GB or greater are long literals, and you must add an "L" to the end of the number, for example a policy of 2GB must be 2147483648L.

      For example: 

      FilesPolicyService.edit("2d93497d-065a-4022ae25-a4b52598d11a", "My Policy", 2147483648L)

      FilesPolicyService.getById(string policyId)

      Return information for a single policy specified by an ID. Policies set a maximum size limit on libraries. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

      Parameters:

        policyId
        The policy ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000. The following information is returned:

        • id: the ID
        • title: the policy title
        • maximumSize: the maximum size (in bytes) the library can be, or 0 for unlimited

      For example: 

      FilesPolicyService.getById("2d93497d-065a-4022ae25-a4b52598d11a")

      FilesPolicyService.browse(string sortOption, string sortAscending, int pageNumber, int itemsPerPage)

      Return a list of policies with ID, title, and maximum size information, as described for the FilesPolicyService.getById(id) command. Policies set a maximum size limit on libraries. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

      Parameters:

        sortOption
        A string value that specifies how to sort the list. The default value is title, but you can also use maximumSize.

        sortAscending
        A string value that specifies whether the list sorts in ascending alphabetical order. This depends on sortOption. If sortOption is title, then this value is true; if sortOption any other value, then this value is false.

        pageNumber
        The number of the page to return.

        For example, if the itemsPerPage value is 40, and pageNumber value is 2, the command returns items 41 to 80 (page 2) instead of 1 to 40 (page 1).

        itemsPerPage
        The maximum number of policies to list per page. The default value is 20.

      For example: 

      FilesPolicyService.browse("title", "true", 1, 25)

      FilesPolicyService.getCount()

      Return the total number of policies. Policies set a maximum size limit on libraries. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

      FilesPolicyService.editPersonalDefault(long maximumSize)

      Set the maximum size, in bytes, for the personal library default policy. The default policy is applied to all personal libraries that do not otherwise have a policy. It allows you to control library size as a way of controlling the amount of storage space used.

      A personal library is a set of files owned by one person. It includes all versions of the files, but does not include metadata such as comments.

      Parameters:

        maximumSize

        A number representing the maximum size allowed, in bytes, for libraries that the default policy is assigned to.

        Numbers 2GB or greater are long literals, and you must add an "L" to the end of the number, for example a policy of 2GB must be 2147483648L.

      For example: 

      FilesPolicyService.editPersonalDefault(2147483648L)

      FilesPolicyService.editCommunityDefault(long maximumSize)

      Set the maximum size, in bytes, for the community library default policy. The default policy is applied to all community libraries that do not otherwise have a policy. It allows you to control library size as a way of controlling the amount of storage space used.

      A community library is a set of files owned by a community. It includes all versions of the files, but does not include metadata such as comments.

      Parameters:

        maximumSize

        A number representing the maximum size allowed, in bytes, for community libraries that the default policy is assigned to.

        Numbers 2GB or greater are long literals, and you must add an "L" to the end of the number, for example a policy of 2GB must be 2147483648L.

      For example: 

      FilesPolicyService.editCommunityDefault(2147483648L)

      FilesPolicyService.delete(string policyId)

      Delete the policy specified by the policy ID. You cannot delete default policies or policies in use by any libraries.

        policyId
        The policy ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

      For example: 

      FilesPolicyService.delete("f0d01111-9b21-4dd8-b8be-8825631cb84b")


    FilesMetricsService

      FilesMetricsService.browsePersonal(string startDate, string endDate, string filePathWithFilterKeys)

      Returns metrics about personal libraries. The same metrics are provided for each day in a specified period. A personal library is a set of files owned by one person.

      If you do not specify dates, then the command uses the first available day with data for startDate, and the last available day with data for endDate.

      See the topic Files metrics for metrics and their descriptions.

      Parameters:

        startDate
        The start date for the period, in YYYY-MM-DD format. This date is included in the returns, for example a start date of "2012-01-15" will include metrics from January 15, 2012. The value must be in quotes.

        endDate
        The end date for the period, in YYYY-MM-DD format. This date is included in the returns, for example an end date of "2012-01-25" will include metrics to January 25, 2012. The value must be in quotes.

        filePathWithFilterKeys
        The full path to a text file in which each line contains a metric key. If you specify a file, only metrics listed in the file are returned. If you do not specify a file, all data is returned.

        For example, if the file lists these three keys, then only these metrics are returned: 

        files.metric.personal.user.count
files.metric.personal.user.created.today.count
files.metric.personal.user.login.count

      For example: 

      FilesMetricsService.browsePersonal("2012-01-01", "2012-01-10", "C:/connections/files/metrics.txt")

      FilesMetricsService.browseCommunity(string startDate, string endDate, string filePathWithFilterKeys)

      Returns metrics about community libraries. The same metrics are provided for each day in a specified period. A community library is a set of files owned by a community.

      If you do not specify dates, then the command uses the first available day with data for startDate, and the last available day with data for endDate.

      See the topic Files metrics for metrics and their descriptions.

      Parameters:

        startDate
        The start date for the period, in YYYY-MM-DD format. This date is included in the returns, for example a start date of "2012-01-15" will include metrics from January 15, 2012. The value must be in quotes.

        endDate
        The end date for the period, in YYYY-MM-DD format. This date is included in the returns, for example an end date of "2012-01-25" will include metrics to January 25, 2012. The value must be in quotes.

        filePathWithFilterKeys
        The full path to a text file in which each line contains a metric key. If you specify a file, only metrics listed in the file are returned. If you do not specify a file, all data is returned.

        For example, if the file lists these three keys, then only these metrics are returned: 

        files.metric.community.user.count
files.metric.community.user.created.today.count
files.metric.community.user.login.count

      For example: 

      FilesMetricsService.browseCommunity("2012-01-01", "2012-01-10", "C:/connections/files/metric_keys.txt")

      FilesMetricsService.savePersonalToFile(string filePath, string startDate, string endDate, string filePathWithFilterKeys, string append)

      Returns metrics about personal libraries and exports them to a local file. The same metrics are provided for each day in a specified period. A personal library is a set of files owned by one person.

      If you do not specify dates, then the command uses the first available day with data for startDate, and the last available day with data for endDate.

      See the topic Files metrics for metrics and their descriptions.

      Parameters:

        filePath
        Path to a file in which to export the metrics. Metrics are exported in comma separated value (CSV) format. If you specify a file name with a .csv extension, it is possible to open it as a spreadsheet.

        See Importing statistics and metrics into a spreadsheet.

        startDate
        The start date for the period, in YYYY-MM-DD format. This date is included in the returns, for example a start date of "2012-01-15" will include metrics from January 15, 2012. The value must be in quotes.

        endDate
        The end date for the period, in YYYY-MM-DD format. This date is included in the returns, for example an end date of "2012-01-25" will include metrics to January 25, 2012. The value must be in quotes.

        filePathWithFilterKeys
        The full path to a text file in which each line contains a metric key. If you specify a file, only metrics listed in the file are returned. If you do not specify a file, all data is returned.

        For example, if the file lists these three keys, then only these metrics are returned: 

        files.metric.personal.user.count
files.metric.personal.user.created.today.count
files.metric.personal.user.login.count

        append
        String whose default value is "true". Change to "false" to have the command overwrite the existing file instead of appending the data in the existing file.

      For example: 

      FilesMetricsService.savePersonalToFile("C:/connections/files/metrics.csv", "2012-01-01", "2012-01-10", "C:/connections/files/metric_keys.txt", "false")

      While the filePathWithFilterKeys parameter is optional you cannot leave it out completely, you must at least have empty quotes, for example: 

      FilesMetricsService.savePersonalToFile("C:/connections/files/metrics.csv", "2012-01-01", "2012-01-10", "", "false")

      FilesMetricsService.saveCommunityToFile(string filePath, string startDate, string endDate, string filePathWithFilterKeys, string append)

      Returns metrics about community libraries and exports them to a local file. The same metrics are provided for each day in a specified period. A community library is a set of files owned by a community.

      If you do not specify dates, then the command uses the first available day with data for startDate, and the last available day with data for endDate.

      See the topic Files metrics for metrics and their descriptions.

      Parameters:

        filePath
        Path to a file in which to export the metrics. Metrics are exported in comma separated value (CSV) format. If you specify a file name with a .csv extension, you can open it as a spreadsheet.

        See Importing statistics and metrics into a spreadsheet.

        startDate
        The start date for the period, in YYYY-MM-DD format. This date is included in the returns, for example a start date of "2012-01-15" will include metrics from January 15, 2012. The value must be in quotes.

        endDate
        The end date for the period, in YYYY-MM-DD format. This date is included in the returns, for example an end date of "2012-01-25" will include metrics to January 25, 2012. The value must be in quotes.

        filePathWithFilterKeys
        The full path to a text file in which each line contains a metric key. If you specify a file, only metrics listed in the file are returned. If you do not specify a file, all data is returned.

        For example: 

        files.metric.community.user.count
files.metric.community.user.created.today.count
files.metric.community.user.login.count

        append
        String whose default value is "true". Change to "false" to have the command overwrite the existing file instead of appending the data in the existing file.

      For example: 

      FilesMetricsService.saveCommunityToFile("C:/connections/files/metrics.csv", "2012-01-01", "2012-01-10", "C:/connections/files/metric_keys.txt", "false")

      FilesMetricsService.getAvailablePersonalRange()

      Return a string array where the first element is the first day data is available and the second element is the last day that data is available for personal libraries. Typically, the current day's data is not available until 12:01 A.M. the following day. A personal library is a set of files owned by one person.

      If metrics collection was disabled or did not occur because of some issue, there may be gaps in data available.

      FilesMetricsService.getAvailableCommunityRange()

      Return a string array where the first element is the first day data is available and the second element is the last day that data is available for community libraries. Typically, the current day's data is not available until 12:01 A.M. the following day. A community library is a set of files owned by a community.

      If metrics collection was disabled or did not occur because of some issue, there may be gaps in data available.


    FilesUtilityService

      FilesUtilService.filterListByString(List listOfMaps, string filterKey, string regexstringCriteria)

      Returns maps from a specified list that have a specified key matching a specified regular expression. Use this command to filter List<Map> java objects that are returned by any of the browse commands, such as FilesLibraryService.browsePersonal and FilesPolicyService.browse.

      A map is a list of key/value pairs, for example the FilesLibraryService.browsePersonal command returns a list of personal libraries. Each library in the list is a map with a set of keys, and each key is paired with a value. Every library has the same set of keys, but unique values. Values contain information about the library, such as its title and creation date.

      Parameters:

        listOfMaps
        A list of maps, for example the result of a command, such as FilesLibraryService.browsePersonal(parameters).

        filterKey
        A key in each map in the list, whose value is compared against the filter criteria.

        regexstringCriteria
        A regular expression represented as a string to match against the filterKey value.

        For example, "[0-9]+" to match only >= 1 numbers in a row.

      The command returns maps from the listOfMaps whose filterKey is the regexstringCriteria value.

      For example, this command shows only the returned maps whose title values match the expression "John*": 

      FilesUtilService.filterListByString(FilesLibraryService.browsePersonal("title", "true", 1, 25), "title", "John*")

      FilesUtilService.filterListByDate(list listOfMaps, string filterKey, expression)

      Returns maps from a specified list that have a specified key with a specified date. Use this command to filter List<Map> java objects that are returned by any of the browse commands, such as FilesLibraryService.browsePersonal and FilesPolicyService.browse.

      A map is a list of key/value pairs, for example the FilesLibraryService.browsePersonal command returns a list of personal libraries. Each library is a map with a set of keys, and each key is paired with a value. Every library has the same set of keys, but unique values. Values contain information about the library, such as its title and creation date.

      Parameters:

        listOfMaps
        A list of maps, for example the result of FilesLibraryService.browsePersonal(parameters).

        filterKey
        A key in each map in the list, whose value is compared against the filter criteria.

        expression
        A string of the form <operator> <date> where <date> is in yyyy-MM-dd format and <operator> is one of the following: > >= == <= <

      The command returns maps from the listOfMaps value whose filterKey value is the expression value.

      For example, this command shows only the returned maps whose creation date is on or later than January 1, 2012: 

      FilesUtilService.filterListByDate(FilesLibraryService.browsePersonal("title", "true", 1, 25), "createDate", "=2010-01-01")

      FilesUtilService.filterListByNumber(List listOfMaps, string filterKey, expression)

      Returns maps from a specified list that have a specified key with a specified number. Use this command to filter List<Map> java objects that are returned by any of the browse commands, such as FilesLibraryService.browsePersonal and FilesPolicyService.browse.

      A map is a list of key/value pairs, for example the FilesLibraryService.browsePersonal command returns a list of personal libraries. Each library is a map with a set of keys, and each key is paired with a value. Every library has the same set of keys, but unique values. Values contain information about the library, such as its title and creation date.

      Parameters:

        listOfMaps
        A list of maps, for example the result of FilesLibraryService.browsePersonal(parameters).

        filterKey
        A key in each map in the list, whose value is compared against the filter criteria.

        expression
        A string of the form <operator> <int> where <int> is an integer and <operator> is one of the following: > >= == <= <

      The command returns maps from the listOfMaps value whose filterKey value is the expression value.

      For example, this command shows only the returned maps whose percentUsed value (which reflects the percent of the library's available space that is currently used) is 20: 

      FilesUtilService.filterListByNumber(FilesLibraryService.browsePersonal("title", "true", 1, 25), "percentUsed", "==20")

      FilesUtilService.getFileById(string fileID)

      Return the file path location of the file identified by a provided file ID. Return a path even if the file is not in use.

      Use this command to find the location of any file stored in the shared file directory. This can be useful when restoring backup versions of data.

      See the topic Back up Files data for more information.

        fileID
        The ID of a file in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

      For example: 

      FilesUtilService.getFileById("2d93497d-065a-4022ae25-a4b52598d11a")


    FilesObjectTypeService

    Use these commands to import and export custom Content Management Interoperability Services (CMIS) object types, and delete or browse imported CMIS object types.

    See Files CMIS API in the API wiki for details.

      FilesObjectTypeService.importType("filePath")

      Imports an XML file defining a custom object type.

      The Files application must be restarted after an object type has been imported before the new object type can be accessed and used by the system.

      Parameters:

        filePath
        The path and name of the XML file containing the object type definition.

      For example: 

      FilesObjectTypeService.importType("C:/CMIS/object_types/objectType.xml")

      FilesObjectTypeService.exportType("filePath", "Id")

      Exports an XML file defining a custom object type.

      Parameters:

        filePath
        The path and name of the XML file containing the custom object type definition.

        Id
        The ID of the custom object type to be exported. Object type IDs are located in the object type's XML definition file.

      For example: 

      FilesObjectTypeService.exportType("C:/CMIS/object_types/objectType.xml", "f0d01111-9b21-4dd8-b8be-8825631cb84b")

      FilesObjectTypeService.deleteType("Id")

      Delete an imported custom object type.

      The Files application must be restarted after a custom object type has been deleted.

      Parameters:

        Id
        The ID of the custom object type to be deleted. Object type IDs are located in the object type's XML definition file.

      For example: 

      FilesObjectTypeService.deleteType("f0d01111-9b21-4dd8-b8be-8825631cb84b")

      FilesObjectTypeService.browseTypes()
      Lists all imported custom object types.


    Back up Files data

    Files stores data in both the database and a file system. This adds some complication in keeping the application available to users while backing up data.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    Files stores a large amount of data. If it were only stored in the database, maintenance and backups would be complex and costly.

    To prevent this, Files stores file metadata in the database, and stores the bulk of file data in binary files in a directory on a file system. You specify the directory during Connections installation, and you can find it at any time in the files-config.xml properties file, in the file.storage.rootDirectory element.

    The file.storage.rootDirectory element will contain either the path itself, or a WebSphere Application Server variable whose value is the path. If it contains a variable, you can find the path by opening WAS console, clicking Environment > WebSphere Variables, and finding the variable.

    For example, if the element's value is ${FILES_CONTENT_DIR}, find FILES_CONTENT_DIR in the console to find the path.

    See the topic Changing configuration property values for information on opening the files-config.xml file.

    File data is actually stored in unique directories below a storage_root_directory/files directory. Each file's data is stored in a sub-directory below /files, generated from the file's randomly generated UUID. Part of the UUID is used to create a directory with a number between 0 and 127. Another part is used to create another directory below that, with another number between 0 and 127, and the UUID itself is located in that directory.

    For example: 

    storage_root_directory/files/18/113/file_UUID

    Files are only written once, so their identities are clear if one is missing during a restore.

    This storage architecture means you must maintain consistency between the database and file system during backups. The simplest way to maintain consistency is to perform "off-line" backups, making the application inaccessible and then backing up both locations. But often you will want to perform "on-line" backups, keeping the application accessible. During an on-line backup, users can continue to add and delete content from the application.

    During on-line backups of Files, you must back up the database before the file system. The database enforces transactional integrity between the two locations. If you start the file system backup first, files added between the time the file system backup starts and the database backup later completes will be missing from the file system on restoration. Backing up the database first ensures that you capture all new files during backup.

    You must also stop a file deletion task from running during on-line backup. When a user deletes a file it is removed from the user interface, but the application actually adds it to a queue of files that must be deleted from the file system. This task runs regularly to delete the first item from the queue. Alternatively, you can increase the time files can sit in the queue before they are deleted, by adjusting the value in the scheduledTasks.FileActuallyDelete.args.softDeleteMinimumPendingTimeInMins property in files-config.xml. This could give you enough time to run incremental backups and make sure your archive is never missing data.

    For information on editing files-config.xml, see the topic Changing configuration property values.

    For information on the scheduledTasks.FileActuallyDelete.args.softDeleteMinimumPendingTimeInMins property see the topic Files configuration properties.

    To perform an on-line backup of Files complete the following steps:

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter 

      execfile("filesAdmin.py")

    3. Stop the task that deletes files from the queue with the following command: 

      FilesScheduler.pauseSchedulingTask("FileActuallyDelete")

    4. Back up the database according to the database documentation.

    5. Back up the file system in whatever way makes sense in your environment.

      For example, for small deployments you can just zip the system, or for large deployments you can use a tool like Tivoli Storage Manager.

    6. Start the task that deletes files from the queue with the following command: 

      FilesScheduler.resumeSchedulingTask("FileActuallyDelete")

    You can run a task that checks for inconsistencies between the database and the file system. It might be useful to compare database and file system images in a test environment before restoring them.

    See the topic Check Files data integrity for more information.


    Check Files data integrity

    The appropriate way to restore backed-up Files data is to restore versions of file system data and database data that match. You can check integrity between database data (metadata) and file system data (binary) by running the FilesDataIntegrityService.checkFiles command.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    The FilesDataIntegrityService.checkFiles command moves files found on the file system, but not in the database, to a file path location you specify in the command. You might want to delete these extra files, or back them up if you think you might need them for a future Files backup.

    Users cannot download files if they are missing from the database.

    Before running the FilesDataIntegrityService.checkFiles command, create the target path_to_extra_filesDirectory folder. This folder will be used to save unused files during the integrity check. Create the folder on the device from which you will run the command.

    If you are running the command on AIX, Linux, or IBM i ensure that you have correct write permissions enabled for the folder.

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter 

      execfile("filesAdmin.py")

    3. Check the integrity of data in the database and file system directory with the following command:

      On Microsoft Windows -- FilesDataIntegrityService.checkFiles("C:\path_to_extra_filesDirectory")

      On AIX or Linux -- FilesDataIntegrityService.checkFiles("/opt/path_to_extra_filesDirectory")

      On IBM i – FilesDataIntegrityService.checkFiles("/path_to_extra_filesDirectory")


    Synchronize Files data with Communities data

    As part of recovering from a database failure you must synchronize Files data with the data of communities Files has interacted with.

    See the Communities section Recovering from a database failure.


    Displaying files inline

    Configure Files to display files inline instead of as attachments. This is useful when you use the Files API to download and display active content, such as Adobe Flash (.swf) files, in your own HTML pages. Enable inline display by changing a configuration property in the files-config.xml file. Then set the inline parameter to true in your download requests.

    To edit configuration files, you must use the wsadmin client.

    By default, the Connections server passes Files application files to browsers with the header "Content-Disposition: attachment." This means files display as attachments; when users click the attachment they are prompted to open or download the file. It also prevents embedding files. To embed files in your own HTML page using an <embed> tag, the content disposition must be inline. This affects active content, such as Adobe Flash (.swf), and HTML pages referenced with <iframe>.

    Configure a property in files-config.xml to change the content disposition from attachment to inline. Then set the inline parameter to true in your Files API download requests.

    Files uses the attachment disposition for security reasons. Specifically, uploaded files could potentially contain malicious code that can exploit the cross-site scripting vulnerabilities of some browsers. If you switch to inline disposition, you should configure an alternate domain download for greater security.

    See Mitigating a cross site scripting attack.

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter.

      1. Access the Files configuration files: 

        execfile("filesAdmin.py")

        If you are asked to select a server, you can select any server.

      2. Check out the Files configuration :

        FilesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        FilesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. Change the content disposition to inline 

      FilesConfigService.updateConfig("security.inlineDownload.enabled", "true")

    4. You must check the configuration files back in after making changes, and they must be checked in in the same wsadmin session in which they were checked out for the changes to take effect.

      See the topic Applying Files property changes for details.

    5. Set the inline parameter to true in your download requests, for example: 

      http://<host>:<port>/files/form/anonymous/api/library/<library ID>/document/<file ID>/media/<FileName>.<ext>?inline=true

      See Downloading a file.


    Restrict file types in Files

    You can restrict the types of files that users can upload in Files.

    To edit configuration files, use the wsadmin client.

    You can create a list of denied file extensions and prevent users from uploading files with those extensions. You can also create a list of allowed file extensions and only allow users to upload files with those extensions.

    Restrict file types affects users uploading new files, or changing the extensions of existing files. Users cannot change existing files to a denied type. Existing documents with denied extensions are not affected.

    For example, if you deny the .xls extension, users cannot upload .xls files or change existing files to have the .xls extension. But existing .xls files are not affected, and users can still upload new versions of them.

    This is not intended as a security application. Files are not analyzed to determine their type, only the file name is read to allow or deny (with an error) the upload. This is only to help you restrict the types of files you store in your environment.

    Perform the following steps to restrict file types in Files:

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter.

      1. Access the Files configuration files: 

        execfile("filesAdmin.py")

        If you are asked to select a server, you can select any server.

      2. Check out the Files configuration :

        FilesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        FilesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. Open files-config.xml.

    4. In the <restrictions> element in the <file> section, specify the enabled attribute as true.

    5. In the <restrictions> element in the <file> section, specify the mode attribute as one of the following values:

      • A value of allow means the extensions in the list are the only ones allowed to be uploaded.

      • A value of deny means the extensions in the list are the only ones not allowed to be uploaded.

    6. In the <restrictions> element, add an <extensions> element, and within the <extensions> element add one or more <extension> elements, each containing a file extension to allow or deny.

    7. You must check the configuration files back in after making changes, and they must be checked in in the same wsadmin session in which they were checked out for the changes to take effect.

      See the topic Applying Files property changes for details.


    Example

    <file>
 ....
 <restrictions enabled="true" mode="allow">
  <extensions>
     <extension>odt</extension>
     <extension>odp</extension>
     <extension>ods</extension>
  </extensions>
 </restrictions>
</file>

    In this example, files with .odt, .odp, or .ods extensions are the only file types that users can upload.

    Use an empty <extension> element to allow or deny files without extensions, or with extensions that exceed the platform limit of 16 characters.


    Set a maximum size on files

    You can set maximum sizes for files in the files-config.xml properties file.

    To edit configuration files, you must use the wsadmin client.

    You may want to set maximum sizes on files to control the size of these individual objects within the larger library size setting.

    See the topic Setting maximum sizes on libraries for more information.

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter.

      1. Access the Files configuration files: 

        execfile("filesAdmin.py")

        If you are asked to select a server, you can select any server.

      2. Check out the Files configuration :

        FilesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example: 

        FilesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. To view the current configuration settings use the following command: 

      FilesConfigService.showConfig()

    4. To set a maximum size for files (in kilobytes): 

      FilesConfigService.updateConfig("file.media.maximumSizeInKb", "<number_of_kilobytes>")

      • It is recommended that the file maximum size be less than 2GB. Files larger than that are likely to reach browser or server limitations.

      • The file.page.maximumSizeInKb and file.attachment.maximumSizeInKb properties do not affect Files, since it has no attachments or pages.

    5. You must check the configuration files back in after making changes, and they must be checked in in the same wsadmin session in which they were checked out for the changes to take effect.

      See the topic Applying Files property changes for details.


    Set a maximum size on libraries

    Use FilesLibraryService commands to assign a policies to libraries. A library is a set of files owned by a person or community. A policy sets a maximum size for a library.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter 

      execfile("filesAdmin.py")

    3. Create a policy to specify the library size, using steps in the topic Working with policies.
    4. Run the following commands to set maximum sizes on libraries:

        FilesLibraryService.assignPolicy(string libraryId, string policyId)

        Assigns a policy to a library. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments. A policy sets a maximum size for a library.

        No message is printed if the task succeeds.

        Parameters:

          libraryId
          The library ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

          policyId
          The policy ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

        For example: 

        FilesLibraryService.assignPolicy("f0d01111-9b21-4dd8-b8be-8825631cb84b", "2d93497d-065a-4022ae25-a4b52598d11a")

        FilesLibraryService.assignPolicyBatch(string filePath)

        Assigns policies to libraries as specified in a text file. The file must contain a list of library-policy ID pairs, one pair per line, values separated by a comma.

        For example: libraryId, policyId. Extra whitespace is ignored. You must create this text file and save it in a directory local to the server where you are running the wsadmin processor.

        A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments. A policy sets a maximum size for a library.

        Parameters:

          filePath
          The full path to the text file, as a string.

        For example: 

        FilesLibraryService.assignPolicyBatch("C:/connections/assign_policies.txt")


    Work with Files policies

    Use the FilesPolicyService commands to add, edit, count, and return information about policies. You apply policies to libraries to set a maximum size on those libraries.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter 

      execfile("filesAdmin.py")
    3. Run the following commands to work with policies:

        FilesPolicyService.add(string title, long maximumSize)

        Creates a policy with a specified title and maximum size. Policies set a maximum size limit on libraries.

        When a policy is created, an ID is created for it and returned to you. The ID is in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000. You must provide policy IDs as parameters when running other FilesPolicyService commands. Policies can be applied to libraries using the FilesLibraryService.assignPolicy or FilesLibraryService.assignPolicyBatch commands.

        A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

        Parameters:

          title
          The policy title. A required value.

          maximumSize

          The maximum size allowed, in bytes. Must be zero or greater. A value of zero means the size is unlimited.

          Numbers 2GB or greater are long literals, and you must add an "L" to the end of the number, for example a policy of 2GB must be 2147483648L.

        For example: 

        FilesPolicyService.add("My Policy", 2147483648L)

        FilesPolicyService.edit(string policyId, string title, long maximumSize)

        Edits the title and maximum size of a policy with a specified ID. If the ID is for a default policy, the title is not modified. Policies set a maximum size limit on libraries. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

        Parameters:

          policyID
          The policy ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

          title
          The policy title. A required value.

          maximumSize

          The maximum size allowed, in bytes. Must be zero or greater. A value of zero means the size is unlimited.

          Numbers 2GB or greater are long literals, and you must add an "L" to the end of the number, for example a policy of 2GB must be 2147483648L.

        For example: 

        FilesPolicyService.edit("2d93497d-065a-4022ae25-a4b52598d11a", "My Policy", 2147483648L)

        FilesPolicyService.getById(string policyId)

        Return information for a single policy specified by an ID. Policies set a maximum size limit on libraries. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

        Parameters:

          policyId
          The policy ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000. The following information is returned:

          • id: the ID
          • title: the policy title
          • maximumSize: the maximum size (in bytes) the library can be, or 0 for unlimited

        For example: 

        FilesPolicyService.getById("2d93497d-065a-4022ae25-a4b52598d11a")

        FilesPolicyService.browse(string sortOption, string sortAscending, int pageNumber, int itemsPerPage)

        Return a list of policies with ID, title, and maximum size information, as described for the FilesPolicyService.getById(id) command. Policies set a maximum size limit on libraries. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

        Parameters:

          sortOption
          A string value that specifies how to sort the list. The default value is title, but you can also use maximumSize.

          sortAscending
          A string value that specifies whether the list sorts in ascending alphabetical order. This depends on sortOption. If sortOption is title, then this value is true; if sortOption any other value, then this value is false.

          pageNumber
          The number of the page to return.

          For example, if the itemsPerPage value is 40, and pageNumber value is 2, the command returns items 41 to 80 (page 2) instead of 1 to 40 (page 1).

          itemsPerPage
          The maximum number of policies to list per page. The default value is 20.

        For example: 

        FilesPolicyService.browse("title", "true", 1, 25)

        FilesPolicyService.getCount()

        Return the total number of policies. Policies set a maximum size limit on libraries. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

        FilesPolicyService.editPersonalDefault(long maximumSize)

        Set the maximum size, in bytes, for the personal library default policy. The default policy is applied to all personal libraries that do not otherwise have a policy. It allows you to control library size as a way of controlling the amount of storage space used.

        A personal library is a set of files owned by one person. It includes all versions of the files, but does not include metadata such as comments.

        Parameters:

          maximumSize

          A number representing the maximum size allowed, in bytes, for libraries that the default policy is assigned to.

          Numbers 2GB or greater are long literals, and you must add an "L" to the end of the number, for example a policy of 2GB must be 2147483648L.

        For example: 

        FilesPolicyService.editPersonalDefault(2147483648L)

        FilesPolicyService.editCommunityDefault(long maximumSize)

        Set the maximum size, in bytes, for the community library default policy. The default policy is applied to all community libraries that do not otherwise have a policy. It allows you to control library size as a way of controlling the amount of storage space used.

        A community library is a set of files owned by a community. It includes all versions of the files, but does not include metadata such as comments.

        Parameters:

          maximumSize

          A number representing the maximum size allowed, in bytes, for community libraries that the default policy is assigned to.

          Numbers 2GB or greater are long literals, and you must add an "L" to the end of the number, for example a policy of 2GB must be 2147483648L.

        For example: 

        FilesPolicyService.editCommunityDefault(2147483648L)

        FilesPolicyService.delete(string policyId)

        Delete the policy specified by the policy ID. You cannot delete default policies or policies in use by any libraries.

          policyId
          The policy ID in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

        For example: 

        FilesPolicyService.delete("f0d01111-9b21-4dd8-b8be-8825631cb84b")


    See Files library information

    Use FilesLibraryService commands to see information about libraries, such as its owner, type, and size. A library is a set of files owned by a person or community and stored in the database.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter 

      execfile("filesAdmin.py")
    3. Run the following commands to return information about libraries:

        FilesLibraryService.getById(string libraryId)

        Return information about a single library specified by an id. A library is a set of files owned by a person or community. It includes all versions of the files, but does not include metadata such as comments.

        Parameters:

          libraryId
          The library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000. The following information is returned:

          • id: The library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
          • ownerUserId: The user id of the library owner in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
          • type: The type of library, for example, personal, community, or system.
          • label: A string of characters used to identify the library in a URL.
          • title: The library's title.
          • summary: A summary of library information.
          • size: The total size of the library binary data.
          • percentUsed: The percentage of the maximum allowable size used, according to the library's policy. Zero if not applicable.
          • maximumSize: The maximum size (in bytes) the library's policy allows. Zero for unlimited.
          • policyId: The id of the policy that sets a maximum limit (in bytes) on the library's size, in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
          • lastUpdate: The last time a significant user-driven update occurred to the metadata.
          • createDate: The library's creation date.
          • externalInstanceId: The widget id if the library is owned by a community.
          • externalContainerId: The community id if the library is owned by a community.
          • themeName: The theme the community owner has selected in communities. Returned for community libraries only.
          • orphan: The value is true if the library owner is no longer active. Returned for personal libraries only.

        For example: 

        FilesLibraryService.getById("2d93497d-065a-4022ae25-a4b52598d11a")

        FilesLibraryService.getByExternalContainerId(string community_id)

        Return information about the community libraries available in the named Community.

        Parameters:

          community_id
          The community id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

        For example: 

        FilesLibraryService.getByExternalContainerId("003456bc-078d-e990-0450-x12345678900")

        FilesLibraryService.getPersonalByOwnerId(string ownerUserId)

        Return information about the personal library of a specified owner. A personal library is a set of files owned by one person.

        Parameters:

          ownerId
          The user ID of the library owner, in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000. You can use FilesMemberService commands to find owner IDs. The following information is returned:

          • id: The library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
          • ownerUserId: The user ID of the library owner in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
          • type: The type of library, for example, personal, community, or system.
          • label: A string of characters used to identify the library in a URL.
          • title: The library's title.
          • summary: A summary of library information.
          • size: The total size of the library binary data.
          • percentUsed: The percentage of the maximum allowable size used, according to the library's policy. Zero if not applicable.
          • maximumSize: The maximum size (in bytes) the library's policy allows. Zero for unlimited.
          • policyId: The id of the policy that sets a maximum limit (in bytes) on the library's size, in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
          • lastUpdate: The last time a significant user-driven update occurred to the metadata.
          • createDate: The library's creation date.
          • externalInstanceId: The widget id if the library is owned by a community.
          • externalContainerId: The community id if the library is owned by a community.
          • orphan: The value is true if the library owner is no longer active. Returned for personal libraries only.

        For example: 

        FilesLibraryService.getPersonalByOwnerId("2d93497d-065a-4022ae25-a4b52598d11a")

        FilesLibraryService.browsePersonal(string sortOption, string sortAscending, int pageNumber, int itemsPerPage)

        Return a list of personal libraries, with information about each library. A personal library is a set of files owned by one person. The list includes libraries whose owners were removed from the user directory. All parameters have default values.

        Parameters:

          sortOption
          A string value that specifies how to sort the list. The default value is title, but you can use lastUpdate, size, createDate, or quotaPercentage.

          sortAscending
          A string value that specifies whether the list sorts in ascending alphabetical order. This depends on sortOption. If sortOption is title, then this value is true; if sortOption any other value, then this value is false.

          pageNumber
          The number of the page to display.

          For example, if you specify in the itemsPerPage parameter that each page will have 50 items, page 1 will contain items 1-50.

          itemsPerPage
          The maximum number of libraries to list per page. The default value is 20. The following information is returned:

          • id: The library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
          • ownerUserId: The user id of the library owner in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000..
          • type: The type of library, for example, personal, community, or system.
          • label: A string of characters used to identify the library in a URL.
          • title: The library's title.
          • summary: A summary of library information.
          • size: The total size of the library binary data.
          • percentUsed: The percentage of the maximum allowable size used, according to the library's policy. Zero if not applicable.
          • maximumSize: The maximum size (in bytes) the library's policy allows. Zero for unlimited.
          • policyId: The id of the policy that sets a maximum limit (in bytes) on the library's size, in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
          • lastUpdate: The last time a significant user-driven update occurred to the metadata.
          • createDate: The library's creation date.
          • externalInstanceId: The widget id if the library is owned by a community.
          • externalContainerId: The community id if the library is owned by a community.
          • orphan: The value is true if the library owner is no longer active. Returned for personal libraries only.

        For example: 

        FilesLibraryService.browsePersonal("title", "true", 1, 25)

        FilesLibraryService.browseCommunity(string sortOption, string sortAscending, int pageNumber, int itemsPerPage)

        Return a list of community libraries, with information about each library. A community library is a set of files owned by a community.

        Parameters:

          sortOption
          A string value that specifies how to sort the list. The default value is title, but you can use lastUpdate, size, createDate, or quotaPercentage.

          sortAscending
          A string value that specifies whether the list sorts in ascending alphabetical order. This depends on sortOption. If sortOption is title, then this value is true; if sortOption any other value, then this value is false.

          pageNumber
          The number of the page to display.

          For example, if you specify in the itemsPerPage parameter that each page will have 50 items, page 1 will contain items 1-50.

          itemsPerPage
          The maximum number of libraries to list per page. The default value is 20. The following information is returned:

          • id: The library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
          • ownerUserId: The user id of the library owner in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000..
          • type: The type of library, for example, personal, community, or system.
          • label: A string of characters used to identify the library in a URL.
          • title: The library's title.
          • summary: A summary of library information.
          • size: The total size of the library binary data.
          • percentUsed: The percentage of the maximum allowable size used, according to the library's policy. Zero if not applicable.
          • maximumSize: The maximum size (in bytes) the library's policy allows. Zero for unlimited.
          • policyId: The id of the policy that sets a maximum limit (in bytes) on the library's size, in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
          • lastUpdate: The last time a significant user-driven update occurred to the metadata.
          • createDate: The library's creation date.
          • externalInstanceId: The widget id if the library is owned by a community.
          • externalContainerId: The community id if the library is owned by a community.
          • themeName: The theme the community owner has selected in communities. Returned for community libraries only.

        For example: 

        FilesLibraryService.browseCommunity("title", "true", 1, 20)

        FilesLibraryService.browsePersonalOrphan(string sortOption, string sortAscending, int pageNumber, int itemsPerPage)

        Return a list of personal libraries whose owners were removed from the user directory. A personal library is a set of files owned by one person.

        Parameters:

          sortOption
          A string value that specifies how to sort the list. The default value is title, but you can use lastUpdate, size, createDate, or quotaPercentage.

          sortAscending
          A string value that specifies whether the list sorts in ascending alphabetical order. This depends on sortOption. If sortOption is title, then this value is true; if sortOption any other value, then this value is false.

          pageNumber
          The number of the page to display.

          For example, if you specify in the itemsPerPage parameter that each page will have 50 items, page 1 will contain items 1-50.

          itemsPerPage
          The maximum number of libraries to list per page. The default value is 20. The following information is returned:

          • id: The library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
          • ownerUserId: The user id of the library owner in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000..
          • type: The type of library, for example, personal, community, or system.
          • label: A string of characters used to identify the library in a URL.
          • title: The library's title.
          • summary: A summary of library information.
          • size: The total size of the library binary data.
          • percentUsed: The percentage of the maximum allowable size used, according to the library's policy. Zero if not applicable.
          • maximumSize: The maximum size (in bytes) the library's policy allows. Zero for unlimited.
          • policyId: The id of the policy that sets a maximum limit (in bytes) on the library's size, in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.
          • lastUpdate: The last time a significant user-driven update occurred to the metadata.
          • createDate: The library's creation date.
          • externalInstanceId: The widget id if the library is owned by a community.
          • externalContainerId: The community id if the library is owned by a community.
          • orphan: The value is true if the library owner is no longer active. Returned for personal libraries only.

        For example: 

        FilesLibraryService.browsePersonalOrphan("title", "true", 1, 20)

        FilesLibraryService.getPersonalCount()

        Return the total number of personal libraries.

        FilesLibraryService.getCommunityCount()

        Return the total number of Community libraries.

        FilesLibraryService.getPersonalOrphanCount()

        Return the total number of personal libraries whose owners were removed from the user directory.

        FilesLibraryService.exportSyncedResourceInfo(string fullpathForOutput, string type)

        Return a report of all of the communities that the Files application has interacted with. After a system crash you can compare the report to the latest metadata in the Communities database to help synchronize and update any missing data.

        See the topic Comparing remote application data with the Communities database for more information.

        Note that in clusters, when you run the command from the deployment manager the path and file are created on the server running Files. In clusters where multiple nodes are running Files, you are asked choose a server to connect to and run the command on, and then the path and file are created on that server.

        Parameters:

          fullPathforOutput
          The full path location where you want the report, and the report filename, as a string in quotes. The report is an XML file. Use forward slashes ("/") in the path, even on Microsoft Windows computers.

          type
          This is always the string value, "community" (including quotes). An error is returned if this is anything except "community".

        For example: 

        FilesLibraryService.exportSyncedResourceInfo("c:/connections/sync/community_output.xml", "community")


    Filter lists returned by commands

    Use the FilesUtilService commands to filter lists of maps returned by browse commands.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    Many commands ask for IDs as input parameters, such as library IDs, user IDs, policy IDs, and file IDs. You can use commands that take parameters you do know to return data including the ID you are looking for.

    For example, run FilesMemberService.getByEmail(string email) providing a user's email address and among the data returned is the user's ID. You can also find IDs using feeds.

    See the Connections API documentation for information on getting ID information using feeds.

    Browse commands, such as FilesLibraryService.browsePersonal and FilesPolicyService.browse, return List<Map> java objects. A List<Map> object is a list of Map java objects. Maps are lists of key/value pairs.

    For example the FilesLibraryService.browsePersonal command returns a list of personal libraries. Each library in the list is a map with a set of keys, and each key is paired with a value. Every library has the same set of keys, but unique values. Values are information about the library, such as its title and creation date.

    You filter a list by specifying that it should only return maps that have a specified key with a specified string value, date value, or number value.

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter 

      execfile("filesAdmin.py")
    3. Run the following commands to filter a list of library maps:

        FilesUtilService.filterListByString(List listOfMaps, string filterKey, string regexstringCriteria)

        Returns maps from a specified list that have a specified key matching a specified regular expression. Use this command to filter List<Map> java objects that are returned by any of the browse commands, such as FilesLibraryService.browsePersonal and FilesPolicyService.browse.

        A map is a list of key/value pairs, for example the FilesLibraryService.browsePersonal command returns a list of personal libraries. Each library in the list is a map with a set of keys, and each key is paired with a value. Every library has the same set of keys, but unique values. Values contain information about the library, such as its title and creation date.

        Parameters:

          listOfMaps
          A list of maps, for example the result of a command, such as FilesLibraryService.browsePersonal(parameters).

          filterKey
          A key in each map in the list, whose value is compared against the filter criteria.

          regexstringCriteria
          A regular expression represented as a string to match against the filterKey value.

          For example, "[0-9]+" to match only >= 1 numbers in a row.

        The command returns maps from the listOfMaps whose filterKey is the regexstringCriteria value.

        For example, this command shows only the returned maps whose title values match the expression "John*": 

        FilesUtilService.filterListByString(FilesLibraryService.browsePersonal("title", "true", 1, 25), "title", "John*")

        FilesUtilService.filterListByDate(list listOfMaps, string filterKey, expression)

        Returns maps from a specified list that have a specified key with a specified date. Use this command to filter List<Map> java objects that are returned by any of the browse commands, such as FilesLibraryService.browsePersonal and FilesPolicyService.browse.

        A map is a list of key/value pairs, for example the FilesLibraryService.browsePersonal command returns a list of personal libraries. Each library is a map with a set of keys, and each key is paired with a value. Every library has the same set of keys, but unique values. Values contain information about the library, such as its title and creation date.

        Parameters:

          listOfMaps
          A list of maps, for example the result of FilesLibraryService.browsePersonal(parameters).

          filterKey
          A key in each map in the list, whose value is compared against the filter criteria.

          expression
          A string of the form <operator> <date> where <date> is in yyyy-MM-dd format and <operator> is one of the following: > >= == <= <

        The command returns maps from the listOfMaps value whose filterKey value is the expression value.

        For example, this command shows only the returned maps whose creation date is on or later than January 1, 2012: 

        FilesUtilService.filterListByDate(FilesLibraryService.browsePersonal("title", "true", 1, 25), "createDate", "=2010-01-01")

        FilesUtilService.filterListByNumber(List listOfMaps, string filterKey, expression)

        Returns maps from a specified list that have a specified key with a specified number. Use this command to filter List<Map> java objects that are returned by any of the browse commands, such as FilesLibraryService.browsePersonal and FilesPolicyService.browse.

        A map is a list of key/value pairs, for example the FilesLibraryService.browsePersonal command returns a list of personal libraries. Each library is a map with a set of keys, and each key is paired with a value. Every library has the same set of keys, but unique values. Values contain information about the library, such as its title and creation date.

        Parameters:

          listOfMaps
          A list of maps, for example the result of FilesLibraryService.browsePersonal(parameters).

          filterKey
          A key in each map in the list, whose value is compared against the filter criteria.

          expression
          A string of the form <operator> <int> where <int> is an integer and <operator> is one of the following: > >= == <= <

        The command returns maps from the listOfMaps value whose filterKey value is the expression value.

        For example, this command shows only the returned maps whose percentUsed value (which reflects the percent of the library's available space that is currently used) is 20: 

        FilesUtilService.filterListByNumber(FilesLibraryService.browsePersonal("title", "true", 1, 25), "percentUsed", "==20")

        FilesUtilService.getFileById(string fileID)

        Return the file path location of the file identified by a provided file ID. Return a path even if the file is not in use.

        Use this command to find the location of any file stored in the shared file directory. This can be useful when restoring backup versions of data.

        See the topic Back up Files data for more information.

          fileID
          The ID of a file in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

        For example: 

        FilesUtilService.getFileById("2d93497d-065a-4022ae25-a4b52598d11a")


    Print information returned by commands

    Use the FilesPrintService.saveToFile command to print information returned by other commands.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    This command prints Map or List<Map> java objects returned by any of the following commands:

    • FilesMemberService.getById (returns a Map)
    • FilesMemberService.getByExtId (returns a Map)
    • FilesMemberService.getByEmail (returns a Map)
    • FilesLibraryService.getById (returns a Map)
    • FilesLibraryService.getPersonalByOwnerId (returns a Map)
    • FilesLibraryService.browsePersonal (returns a List<Map>)
    • FilesLibraryService.browseCommunity (returns a List<Map>)
    • FilesLibraryService.browsePersonalOrphan (returns a List<Map>)
    • FilesPolicyService.getById (returns a Map)
    • FilesPolicyService.browse (returns a List<Map>)
    • FilesMetricService.browsePersonal (returns a List<Map>)
    • FilesMetricService.browseCommunity (returns a List<Map>)

    A List<Map> object is a list of Map java objects. Maps are lists of key/value pairs.

    For example the FilesLibraryService.browsePersonal command returns a list of personal libraries. Each library in the list is a map with a set of keys, and each key is paired with a value. Every library has the same set of keys, but unique values. Values are information about the library, such as its title and creation date.

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter 

      execfile("filesAdmin.py")

    3. Run the following command to print library information returned by other commands: 

      FilesPrintService.saveToFile(Object object, String filePath, String append)

      where object is a Map or List<Map> type of java object. You provide the command that returns the object, for example, FilesLibraryService.getPersonalByOwnerId(parameters), which returns a Map object.

      The filePath parameter is the location where you want the data printed in a comma-separated value (.csv) file.

      The append parameter determines whether to append the returned information to information in an existing file. If true (the default), returned information is appended, if false the file is overwritten.

      For example: 

      FilesPrintService.saveToFile(FilesLibraryService.browsePersonal("title","true",1,20), "/opt/wsadmin/LibraryMap.csv")

      In this example the command runs FilesLibraryService.browsePersonal with the given parameters, then prints the output to the LibraryMap.csv file. Because the append parameter remains at the default value of true, running the same command again will append the new data in the existing LibraryMap.csv. Here is an example of returned data printed to a file:

        "id", "createDate", "label", "lastUpdate", "maximumSize", "orphan", "ownerUserId", "percentUsed", "policyId", "size", "summary", "title", "type", "externalInstanceId", "externalContainerId" "ef8ed3e2-22c0-4f20-aa53-bdc6b262abbd", "2009-06-25 12:30:32.797", "5adff8c0-7d67-102c-8452-e2ebc3ec5536", "2009-06-25 12:30:32.797", "524288000", "false", "9ddb97f0-cea5-49fd-9158-06e45b01cd46", "0.0", "00000000-0000-0000-0000-000000000000", "0", "", "Amy Jones1", "personal", "", "" "30676b64-c792-46d1-9c21-bcea1f3350cf", "2009-06-25 16:23:23.354", "5b788f40-7d67-102c-8464-e2ebc3ec5536", "2009-06-25 16:23:23.354", "524288000", "false", "1c00bd59-20c1-48ea-857b-9c998670d715", "8.170700073242188E-5", "00000000-0000-0000-0000-000000000000", "42838", "", "Amy Jones10", "personal", "", "" "547b8f88-0cb9-4f84-95c2-382f235fe251", "2009-06-26 10:57:57.384", "5b788f40-7d67-102c-8468-e2ebc3ec5536", "2009-06-26 10:57:57.384", "524288000", "false", "a25fd14a-70d2-4978-b814-9e05f9b56503", "3.90625E-5", "00000000-0000-0000-0000-000000000000", "20480", "", "Amy Jones12", "personal", "", "" "605ff4d6-956a-446f-a393-4995057213c5", "2009-06-26 16:15:58.778", "5ca9bc40-7d67-102c-847c-e2ebc3ec5536", "2009-06-26 16:15:58.778", "524288000", "false", "5a79bd44-e5d1-4b4d-b51f-338eff519636", "3.1642913818359376E-6", "00000000-0000-0000-0000-000000000000", "1659", "", "Amy Jones23", "personal", "", "" "86aa4152-c661-4aae-ac7c-ca04da570715", "2009-06-25 17:29:16.162", "5ddae940-7d67-102c-849e-e2ebc3ec5536", "2009-06-25 17:29:16.162", "524288000", "false", "82252a4e-1355-4518-930c-983d7085ad6e", "2.63214111328125E-7", "00000000-0000-0000-0000-000000000000", "138", "", "Amy Jones40", "personal", "", "" "fb9f97fe-0c41-4276-96f0-f1c91478df68", "2009-06-25 11:52:22.843", "5e737fc0-7d67-102c-84b2-e2ebc3ec5536", "2009-06-25 11:52:22.843", "524288000", "false", "8daf28ad-f51e-4ef3-8990-283c9fd4574a", "0.0", "00000000-0000-0000-0000-000000000000", "0", "", "Amy Jones50", "personal", "", "" "179be703-7e44-45f5-9fa8-eeab1f46e896", "2009-06-25 18:17:38.639", "5f0c1640-7d67-102c-84c6-e2ebc3ec5536", "2009-06-25 18:17:38.639", "524288000", "false", "3a99634c-fd29-4966-ae6f-217472f5439c", "0.0", "00000000-0000-0000-0000-000000000000", "0", "", "Amy Jones60", "personal", "", ""


    Disable automatic email notification of file updates

    When an user downloads a file for the first time, Files sets a preference so that the user receives an email notification when the file is edited or commented on. The assumption is that users want to receive email about updates to the file. You can disable this notification using the files-config.xml file.

    To edit configuration files, you must use the wsadmin client.

    Email notifications can also be enabled or disabled for all applications.

    See the topic Enabling email notifications for information.

    1. Start the wsadmin client.

    2. Access the Files configuration :

        execfile("filesAdmin.py")

      Select a server if prompted.

    3. Check out the Files configuration :

      FilesConfigService.checkOutConfig("working_directory", "cell_name") where:

      • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

      • cell_name is the name of the WAS cell hosting the Connections application. To get cell name, from wsadmin:

          print AdminControl.getCell()

      For example:

      • AIX or Linux:

          FilesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

        Windows:

          FilesConfigService.checkOutConfig("c:/temp","Cell01")

      • IBM i:

          FilesConfigService.checkOutConfig("/temp","Cell01")

      To check out email templates with the configuration files you can add the includeEmailTemplates parameter, and set it to "true".

      For example:

        FilesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01", includeEmailTemplates = "true")
      You can edit the email that users receive by editing the templates.

      For information on email templates, see the topic Customizing email templates.

    4. To set the emailNotification.addOnMediaDownload.enabled property to false:

        FilesConfigService.updateConfig("emailNotification.addOnMediaDownload.enabled", "false")

    5. You must check the configuration files back in after making changes, and they must be checked in in the same wsadmin session in which they were checked out for the changes to take effect.

      See the topic Applying Files property changes for details.

      If you checked out the email templates, use FilesConfigService.checkInConfig(includeEmailTemplates = "true") to check them back in as well.


    Disable file versioning

    By default, when a user uploads a new version of a file it becomes the latest version, and all previous versions are kept. Users can see all versions of a file in the user interface. You can disable file versioning in the files-config.xml properties file.

    To edit configuration files, you must use the wsadmin client.

    Disable versioning can help control the size of data storage. When you disable versioning before users start using Files, only one version of a file is ever stored, and all updates are reflected in that version.

    However, you can disable versioning at any time. If there are already multiple versions of a file when you disable versioning, the latest version becomes the active version, and all future updates are reflected in that version. The older versions are hidden from the user interface, but still exist and take up space in the database. If a user reaches their space quota, you can delete these older versions by enabling versioning again and having the user open the file page, click the Versions tab, and delete versions.

    You can also perform a manual database update to remove all versions of files prior to the current ones. You would execute a delete statement on your database for the MEDIA_REVISION table, but you must specify a constraint that the column IS_CURRENT_REVISION = 0, as a record still exists for the current version.

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter.

      1. Access the Files configuration files:

          execfile("filesAdmin.py")

        If you are asked to select a server, you can select any server.

      2. Check out the Files configuration :

        FilesConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

          AIX, Linux, and IBM i only: The directory must grant write permissions or the command will not run successfully.

        • cell_name is the name of the WAS cell hosting the Connections application. This argument is required. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example:

          FilesConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

    3. To view the current configuration settings use the following command:

        FilesConfigService.showConfig()

    4. To set the file.versioning.enabled property to false:

        FilesConfigService.updateConfig("file.versioning.enabled", "false")

    5. You must check the configuration files back in after making changes, and they must be checked in in the same wsadmin session in which they were checked out for the changes to take effect.

      See the topic Applying Files property changes for details.


    Delete user files from the system

    Use the FilesLibraryService delete commands to delete user files.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    This topic focuses on deleting libraries (sets of files) belonging to inactive users. Inactive users are users who were removed from the corporate user directory. When that directory is synchronized with the Connections application directories, the users are marked inactive and their libraries are marked as "orphans."

    For information on synchronizing directories and inactive users, see the section Managing users.

    In the Files database context, a library is a set of files owned by a person or community. However, you should delete community libraries following steps in the topic Deleting orphaned data.

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter

        execfile("filesAdmin.py")

    3. Run this command to find out the total number of libraries whose owners were removed from LDAP:

        FilesLibraryService.getPersonalOrphanCount()

    4. Run this command to return a list of personal libraries whose owners were removed from the LDAP directory. Libraries belonging to inactive users are returned marked "orphaned":

        FilesLibraryService.browsePersonalOrphan(sortOption, sortAscending, pageNumber, itemsPerPage)

      where the sortOption parameter is a String value that specifies how to sort the list. The default value is title, but you can use lastUpdate, size, createDate, or quotaPercentage.

      The sortAscending parameter is a String value that specifies whether the list sorts in ascending alphabetical order. This depends on sortOption. If sortOption is title, then this value is true; if sortOption any other value, then this value is false.

      The pageNumber parameter is the number of the page to return.

      For example, if the itemsPerPage value is 40, and pageNumber value is 2, the command returns items 41 to 80 (page 2) instead of 1 to 40 (page 1).

      The itemsPerPage parameter is the maximum number of policies to list per page. The default value is 20.

      To print the results of this command to a text file, see the topic Printing information returned by commands.

    5. Run one of these commands to delete libraries:

      • Run this command to delete a single library:

          FilesLibraryService.delete(String libraryId)

        where libraryId is the library id in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000. The parameter is a String.

        Return a message that the library with the id was deleted, or a failure message if it is not found.

      • Run this command to delete multiple libraries:

          FilesLibraryService.deleteBatch(String filePath)

        where filePath is a String the full path to a text file containing a list with a single library id per line in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000. You must create the file and save it in a directory local to the server where you are running the wsadmin processor. The parameter is a String.

        Returns an exception and stops processing if any item is not found.


    Find the location of a stored file

    Use the FilesUtilService.getFileById command to locate a file stored in a directory on a file system.

    To use administrative commands, use the wsadmin client.

    See Start wsadmin for details.

    Files uploaded through the Connections Files component are stored on a shared file system, as described in the topic Installing Connections 4.5.

    This command can be useful when restoring backup versions of data.

    See the topic Backing up Files data for more information.

    1. Start the wsadmin client.

    2. Start the Files Jython script interpreter

        execfile("filesAdmin.py")
    3. Run the following command to locate a file stored in the file directory:

        FilesUtilService.getFileById("fileId")

      where fileID is the ID of a file stored in the database. The ID must be a string in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

      For example:

        FilesUtilService.getFileById("34f29f8a-8dc9-47f4-bffa-88e93215d4fb")

      The command returns the file path as a string, even if the file is not in use.


    Administer Forums

    Administer Forums by specifying properties in a configuration file or running administrative commands.

    You can edit the forum-config.xml file to control how and when various Forums operations take place. Use administrative commands to run tasks that manipulate Forums content. Changes to the configuration file require node synchronization and a restart of the Forums server before they take effect. Changes that are made by using administrative commands take effect immediately.


    Run Forums administrative commands

    Use the wsadmin client to administer the Forums application.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    Administrative commands interact with the Forums application and its resources through scripts. These scripts use the AdminControl object in the wsadmin client to interact with the Forums application. Each script uses Java beans (MBeans) for administrative tasks. For a complete list of editable administrative commands for the Forums application, see Forums administrative commands.

    If an error occurs when you are running the MBean commands, examine the SystemOut.log file to determine what went wrong.

    When you use these commands, you do not have to check the configuration file in and out, nor restart the Forums server, because the commands take effect immediately.

    To run Forums administrative commands:

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands fail.

    2. Start the Forums Jython script interpreter by

        execfile("forumsAdmin.py")

      If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.


    Forums administrative commands

    Use these commands run administrative tasks for Forums. No file checkout or server restart is needed when you use these commands. The following sections define the commands used when you are administering the Forums application.


    ForumsConfigService commands

      ForumsConfigService.checkOutConfig("working_directory", "cell_name")

      Checks out the Forums configuration files.

      Parameters:

        <working_directory>
        Temporary working directory to which the configuration files are copied. The files are kept in this working directory while you modify them.

        <cell_name>
        Name of the IBM WAS cell that hosts the Connections applications. If you do not know the cell name, type the following command in the wsadmin client:

          print AdminControl.getCell()

      For example:

      • AIX or Linux:ForumsConfigService.checkOutConfig("/opt/my_temp_dir", "CommCell01")

      • IBM i:ForumsConfigService.checkOutConfig("/temp","Cell01")

        Windows:ForumsConfigService.checkOutConfig("c:/temp","Cell01")

      ForumsConfigService.checkInConfig()

      Checks in the Forums configuration files. Run from the wsadmin command processor.

      ForumsConfigService.showConfig()
      Determine which property must be updated manually from the checkout command. The default Forums configuration properties are as follows:

      • activeContentFilter.enabled = true
      • discussThis = false
      • discussThis.targetBookmarklet = http://{server}/connections/bookmarklet
      • objectStore.allowUpload = true
      • task.TrashAutoPurgeJob.enabled = true
      • task.TrashAutoPurgeJob.interval = 0 0 2 ? * SUN
      • task.TrashAutoPurgeJob.trashRetentionInDays = 90


    ForumsMemberService commands

      ForumsMemberService.previewSyncAllMembersByExtId( {"updateOnEmailLoginMatch": ["true" | "false"[, “multiLine ["true" | "false"] ] [, “verbose” : ["false" | "true"] }] )

      For more information, see Synchronize user data using administrative commands.

      ForumsMemberService.previewSyncMemberExtIdByEmail("emailAddr" [, { "allowInactivate ["true" | "false"] [, "multiLine ["true" | "false"] ] [, "verbose ["true" | " false"] ] } ] )

      For more information, see Synchronize user data using administrative commands.

      ForumsMemberService.previewSyncMemberExtIdByEmail("emailAddr" [, { "allowInactivate ["true" | "false"] [, "multiLine ["true" | "false"] ] [, "verbose ["true" | " false"] ] } ] )

      For more information, see Synchronize user data using administrative commands.

      ForumsMemberService.getMemberExtIdByEmail("email")

      For more information, see Synchronize user data using administrative commands.

      ForumsMemberService.getMemberExtIdByLogin("login")

      For more information, see Synchronize user data using administrative commands.

      ForumsMemberService.inactivateMemberByEmail("email")

      For more information, see Synchronize user data using administrative commands.

      ForumsMemberService.inactivateMemberByExtId("externalID")

      For more information, see Synchronize user data using administrative commands.

      ForumsMemberService.syncAllMembersByExtId( {"updateOnEmailLoginMatch": ["true" | "false"] } )

      For more information, see Synchronize user data using administrative commands.

      ForumsMemberService.syncMemberByExtId("currentExternalId"[, {"newExtId" : "id-string" [, "allowExtIdSwap ["true" | "false"] ] } ] )

      For more information, see Synchronize user data using administrative commands.

      ForumsMemberService.syncMemberExtIdByEmail("email" [, { "allowInactivate" : ["true" | "false"] } ])

      For more information, see Synchronize user data using administrative commands.

      ForumsMemberService.syncMemberExtIdByLogin("name" [, {"allowInactivate": ["true" | "false"] } ])

      For more information, see Synchronize user data using administrative commands.


    ForumsScheduler commands

      ForumsScheduler.getTaskDetails(String taskName)

      Return information about the scheduled task, specified by taskName. Forums currently has a single managed task – TrashAutoPurgeJob.

      The values that are returned are server time, next scheduled run time, status (SCHEDULED, RUNNING, SUSPENDED), and task name. When the task is paused, then the status parameter shows as SUSPENDED instead of SCHEDULED. SUSPENDED means that the task is not scheduled to run.

      For example:

        ForumsScheduler.getTaskDetails("TrashAutoPurgeJob")

      The resulting output looks similar to the following example:

        {currentServerTime=Wed Feb 03 14:21:47 EST 2010, nextFireTime=Sun Feb 07 02:00:00 EST 2010, status=SCHEDULED, taskName=TrashAutoPurgeJob}

      ForumsScheduler.pauseSchedulingTask(String taskName)

      Temporarily pauses the specified task and stops it from running.

      When you pause a scheduled task, the task remains in the suspended state even after you stop and restart Forums or the IBM WebSphere Application Server. To resume the task, run the ForumsScheduler.resumeSchedulingTask(String taskName) command.

      If the task is running, it continues to run but is not scheduled to run again. If the task is already suspended, this command has no effect.

      For example:

        ForumsScheduler.pauseSchedulingTask("TrashAutoPurgeJob")
      When a task is paused, a status message similar to the following is written to the SystemOut.log file:

        [2/3/10 14:28:10:782 EST] 0000002f ForumsNotific I CLFWY0134I: Forums scheduled task 'TrashAutoPurgeJob' fired event 'TaskNotificationInfo.SUSPENDED'

      ForumsScheduler.resumeSchedulingTask(String taskName)

      If the task is suspended, puts the task in the scheduled state. If the task is not suspended, this command has no effect.

      When a task is resumed, it does not run immediately; it runs at the time when it is next scheduled to run.

      For example:

        ForumsScheduler.resumeSchedulingTask("TrashAutoPurgeJob")
      Resuming a paused task causes the following status message to be written to the SystemOut.log file: 

      [2/3/10 14:28:25:407 EST] 00000051 ForumsNotific I   CLFWY0134I: Forums scheduled task 'TrashAutoPurgeJob' fired event 'TaskNotificationInfo.RESUMED'


    ForumsService commands

      ForumsService.deleteForums(java.util.Vector forums)

      Moves the specified forums to the Trash view. Forums in the Trash view can be restored if they are restored before the trash is emptied. The command returns a java.util.Vector, where each object in the vector is a java.util.Hashtable that describes a forum that cannot be deleted. A returned empty vector indicates complete success.

      ForumsService.exportSyncedResourceInfo(java.lang.String filePath, java.lang.String eventType)

      Writes a report that lists all the community forums and identifies their associated communities. The file is saved to the directory path that you specify.

      You can use this command to restore backed-up data.

      For more information, see Comparing remote application data with the Communities database.

      Parameters:

        filePath
        A string that specifies the full directory path in which to store the file that is returned by the command. Include the file name in the file path and use forward slashes.

        For example, C:/temp/forum_output.xml.

        eventType
        Type of synchronization events to report about. The only supported value for this parameter is community. Specify this value as a singular community and in lowercase.

      For example: 

      ForumsService.exportSyncedResourceInfo("C:/temp/forum_output.xml","community")

      ForumsService.fetchForums()

      Lists forums by forumID, for example: 

      {forumID=7d53c588-4b34-4497-8556-6f253519891f}

      ForumsService.fetchForumsByName(java.lang.String forumName)

      Retrieves the forum with the specified name, for example: 

      ForumsService.fetchForumsByName("My Forum")

      ForumsService.filterInput(VectorinputVector, java.lang.String toMatch, java.lang.String attrName)

      Filters a source vector of forums to return a new vector that contains a map pair that matches the specified filter criteria.

      Parameters:

        inputVector
        The source vector that contains the map collection.

        toMatch
        A Java regular expression pattern that represents matching criteria. This pattern is used to search the attrName of the forums or entries. The pattern must match the full name and is case-sensitive. You can use the following keys:

        • Period (.) matches any character.
        • Plus sign (+) matches one or more instances of the previous character.

          For example, .+ matches all sequences of one or more characters.

        • Asterisk (*) matches zero or more instances of the previous character.

          For example, * matches all sequences of characters.

        • [chars] matches any one character within the square brackets ([]).

          For example, [Gg] matches either an upper or lowercase G.

        • [A-Z] matches a range of characters.

        attrName
        The key to filter in the map. Possible values include name and forumID. The default value is name.

      ForumsService.reCountAllForums()

      Recalculates the total number of forums in your organization.

      This command does not take any parameters.

      ForumsService.reCountForums(Vector forums)

      Recalculates the number of specified forums in your organization, where you specify the forums to recalculate as a vector variable that represents multiple forums.

      For example: 

      ForumsService.reCountForums(myforums)


    ForumsTopicsService commands

      ForumsTopicsService.fetchTopics()

      A list of all forum topics, except those topics that were moved to the trash.

      Return a java.util.Vector object. Each object in the vector is a java.util.Hashtable object that describes one forum topic.

      ForumsTopicsService.fetchTopicsByDate(String type, String begindate, String enddate)

      A list of forum topics created or modified in a specified date range. The maximum number of topics in the returned list is 50. If the number is greater than 50, call this method in a loop where the last UUID parameter is the UUID of the 50th topic from the previous list.

      Return a java.util.Vector object. Each object in the vector is a java.util.Hashtable object that describes one forum topic.

      Parameters:

        type
        Specifies the date type. The following values are valid:

        • created
        • modified

        begindate
        Start timestamp of the date range, which is specified in a yyyy.mm.dd format.

        enddate
        Finish timestamp of the date range, which is specified in a yyyy.mm.dd format.

      For example: 

      ForumsTopicsService.fetchTopicsByDate("created","2010.05.21","2010.05.22")

      ForumsTopicsService.fetchTopicsByDate("modified","2010.05.21","2010.05.22")

      ForumsTopicsService.fetchTopicsCreatedByMember(String extId, String type)

      A list of forum topics created by the specified member, except those topics that are in the trash.

      Return a java.util.Vector object. Each object in the vector is a java.util.Hashtable object that describes one forum topic.

      Parameters:

        extId
        The external ID of the specified member whose topics you want to retrieve.

        type
        The type of external ID specified. The following values are valid:

        • uuid
        • email

      For example: 

      ForumsTopicsService.fetchTopicsCreatedByMember("778CE573-78A5-2ECF-8525-7346003DB078","uuid")

      ForumsTopicsService.fetchTopicsCreatedByMember("ajones10@example.com","email")

      ForumsTopicsService.fetchTopicById(String topicuuid)

      A forum topic that is identified by the specified universal identifier.

      Return a java.util.Hashtable object that describes the forum topic.

      This command takes the following parameter:

        topicuuid
        The unique identifier of the forum topic.

      For example: 

      ForumsTopicsService.fetchTopicById("15279c53-7bb2-43dd-96ad-2eee2c7f10f8")

      ForumsTopicsService.deleteTopics(Vector forumtopics)

      Moves the specified forum topics to the trash. Forum topics in the Trash view can be restored if they are restored before the trash is emptied.

      Return a java.util.Vector. Each object in the vector is a java.util.Hashtable that describes a forum topic that cannot be deleted. A returned empty vector indicates complete success.

      This command takes the following parameter:

        forumtopics
        Vector of hash tables that describes the forum topics to be deleted.

      For example: 

      ForumsTopicsService.deleteTopics(janetstopics)

      ForumsService.reCountForumById(java.lang.String uuid)

      Recalculates the number of topics in a specific forum, where you specify the forum by its UUID.

      For example: 

      ForumsService.reCountForumById("778CE573-78A5-2ECF-8525-7346003DB078")

      ForumsTopicsService.reCountTopics(Vector topics)

      Recalculates the number of specified topics in your organization, where you specify the topics to recalculate as a vector variable that represents multiple topics.

      For example: 

      ForumsTopicsService.reCountTopics(mytopics)


    ForumsTrashService commands

      ForumsTrashService.fetchForumsTrash()

      Retrieves a list of the deleted forums currently in the trash

      ForumsTrashService.fetchTopicsTrash()

      Retrieves a list of the deleted forum topics currently in the trash.

      ForumsTrashService.fetchForumsTrashByDate(String modifySince)

      Retrieves a list of the forums that were deleted on a specific date.

      This command takes the following parameter:

        modifySince
        A string that specifies the date when the forum was deleted in yyyy.MM.dd format.

      ForumsTrashService.filterForumsByName(VectorinputVector, java.lang.String toMatch)

      Filters a source vector of forums to return a new vector that contains a map pair that matches the specified name filter criteria.

      Parameters:

        inputVector
        The source vector that contains the map collection.

        toMatch
        Java regular expression pattern that represents matching criteria. This pattern is used to search the name of the forums. The pattern must match the full name and is case-sensitive. You can use the following keys:

        • Period (.) matches any character.
        • Plus sign (+) matches one or more instances of the previous character.

          For example, .+ matches all sequences of one or more characters.

        • Asterisk (*) matches zero or more instances of the previous character.

          For example, * matches all sequences of characters.

        • [chars] matches any one character within the square brackets ([]).

          For example, [Gg] matches either an upper or lowercase G.

        • [A-Z] matches a range of characters.

      ForumsTrashService.purgeForumsTrash(vector hashtable)

      Purge the specified forums from the trash, where you specify the forums to delete by using the hashtable parameter.

      For example: 

      ForumsTrashService.purgeForumsTrash(forumtrash)

      ForumsTrashService.purgeTopicsTrash(vector hashtable)

      Purge the specified forum topics from the trash, where you specify the topics to delete by using the hashtable parameter.

      For example: 

      ForumsTrashService.purgeTopicsTrash(topictrash)

      ForumsTrashService.undeleteForumsTrash(vector hashtable)

      Restores a deleted forum or forums, where you specify the forum or forums to restore by using the hashtable parameter.

      For example: 

      ForumsTrashService.undeleteForumsTrash(forumsTrash)

      ForumsTrashService.undeleteTopicTrash(vector hashtable)

      Restores a deleted forum topic or topics, where you specify the topic or topics to restore by using the hashtable parameter.

      For example: 

      ForumsTrashService.undeleteTopicTrash(topictrash)


    Change Forums configuration property values

    Configuration settings control how and when various Forums operations take place.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    Configure Forums by using Jython scripts that are accessed by the wsadmin client. These scripts use the AdminConfig object in the wsadmin client to interact with the Forums configuration file. After you change Forums configuration settings, you must synchronize the nodes and restart the Forums application server.

    To change Forums configuration settings....

    1. cd WAS_HOME/profiles/Dmgr01/bin

    2. Start the Forums Jython script interpreter.

      1. Access the Forums configuration files: 

        execfile("forumsAdmin.py")

        If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

      2. Check out the Forums configuration files by

        ForumsConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the XML and XSD configuration files are copied. The files are kept in this working directory while you modify them.

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

        • cell_name is the name of the WAS cell that hosts the Connections applications. This argument is required. It is also case-sensitive, so type it with care. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example:

        ForumsConfigService.checkOutConfig("/opt/my_temp_dir", "ForumCell01")

    3. To view a list of the valid Forums configuration settings and their current values:

      ForumsConfigService.showConfig()

    4. To change a Forums configuration setting:

      ForumsConfigService.updateConfig("property", "value") where property is one of the editable Forums configuration properties and value is the new value of the property. For a complete list of editable properties, see Forums configuration properties.

      For example:

      ForumsConfigService.updateConfig("task.TrashAutoPurgeJob.trashRetentionInDays", "120")

    5. After you update the Forums properties with new values, use the ForumsConfigService.showConfig() command to display the list of properties and their updated values.

    6. Repeat step 3 for each property to change.

    Check in the configuration files in the same wsadmin session in which they were checked out.

    For more information, see Applying property changes.


    Forums configuration properties

    Configuration settings control configurable features within Forums and can also help to optimize the performance of the application server. When you change these settings, you mush restart the Forums application server. You can check out and modify the following properties in the forum-config.xml file. The properties are listed in alphabetical order.

      activeContentFilter.enabled

      When enabled, this property prevents the addition of active content (JavaScript) in any text input field.

      This property takes a Boolean value: true or false.

      Disable this property introduces vulnerability to cross-site scripting (XSS) and other type of malicious attacks.

      For more information, see Securing applications from malicious attack.

      For example: 

      ForumsConfigService.updateConfig("activeContentFilter.enabled","true")

      discussThis.enabled

      Users can click Bookmark or Discuss This on any Connections page to install a Discuss This button in their browser toolbar. When a user clicks the button, the content of the current page is added to a forum topic that the user selects.

      Use the discussThis.enabled property to enable a similar Discuss This button on every forum topic page. Users can click the button to post the topic as a new topic in a forum in a different Connections deployment. You can specify that deployment in the discussThis.internalHost property.

      For example, if you have two Connections deployments in your enterprise, A and B, you can allow forums users in Deployment A to post topics to Deployment B forums. To enable this feature, check out the forums-config.xml file in Deployment A and specify the address of the forums application in Deployment B. When users open a forum page in deployment A and clicks the Discuss This link, they can select the target forum on Deployment B from a pop-up dialog. If the users are not logged in to Deployment B, they are prompted to log in before they can post the new topic. Users must be members of the group that is mapped to the discussThis-user role on Deployment A (the default is Everyone).

      For more information about configuring the button, see Enabling forum topic posting in different deployments.

      This property takes a Boolean value: true or false. It is set to true by default.

      discussThis.targetBookmarklet

      Address of the forums application in a different Connections deployment. This property is required to enable the Discuss This feature in the discussThis.enabled property.

      For more information about configuring the button, see Enabling forum topic posting in different deployments.

      This property takes a server address, such as: http://servername.example.com:9081.

      objectStore.allowUpload

      Enables or disables the uploading of file attachments to forums.

      This property takes a Boolean value: true or false.

      For example: 

      ForumsConfigService.updateConfig("objectStore.allowUpload","false")

      task.TrashAutoPurgeJob.enabled

      Enables or disables the Purge Trash task.

      This property accepts the following values: true or false.

      For example: 

      ForumsConfigService.updateConfig("task.TrashAutoPurgeJob.enabled", "true")

      task.TrashAutoPurgeJob.trashRetentionInDays

      Specifies the number of days that deleted content remains in the database. The value must be set to 1 or greater. If the value is less than 1, the trash is not purged by this job. The default value is 90.

      For example: 

      ForumsConfigService.updateConfig("task.TrashAutoPurgeJob.trashRetentionInDays", "120")

      task.TrashAutoPurgeJob.interval

      Specifies the interval at which the Purge Trash task runs.

      When you change this property, the new schedule is registered the next time that Forums is started. If you use a Forums cluster, the change is propagated to all Forums application servers in the cluster.

      For example: 

      ForumsConfigService.updateConfig("task.TrashAutoPurgeJob.interval", "0 0/15 * * * ?")


    Apply property changes in Forums

    After you edit configuration properties, check the modified configuration file in and restart the servers to apply the changes.

    For information about the properties that you can edit, see Forums configuration properties.

    1. Check in the changed configuration property keys by using the following wsadmin client command:

      ForumsConfigService.checkInConfig()

      The checkin must be done in the same wsadmin session as the checkout.

    2. Update the value of the version stamp configuration property in LotusConnections-config.xml to force users' browsers to pick up this change. For more details, see Required post-customization step.

    3. To exit the wsadmin client, type exit at the prompt.

    4. Restart the Forums application server.


    Retrieve forum content

    Use administrative commands to retrieve lists of forums and forum topics. You can narrow down a list of forums to retrieve a specific subset of forums to administer.


    Get a list of forums

    Use administrative commands to retrieve lists of forums that you can subsequently manipulate programmatically.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands fail.

    2. Start the Forums Jython script interpreter by 

      execfile("forumsAdmin.py")

      If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

    3. Use the following commands to retrieve the forums:

        ForumsService.fetchForums()

        Lists forums by forumID, for example: 

        {forumID=7d53c588-4b34-4497-8556-6f253519891f}

        ForumsService.fetchForumsByName(java.lang.String forumName)

        Retrieves the forum with the specified name, for example: 

        ForumsService.fetchForumsByName("My Forum")


    Get a list of forum topics

    Use administrative commands to retrieve forum topics by date, by creator, or by topic UUID. When you use these commands, you do not have to check the Forums configuration file in and out, nor restart the Forums server.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    To retrieve forum content....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands fail.

    2. Start the Forums Jython script interpreter by 

      execfile("forumsAdmin.py")

      If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

    3. Use any of the following commands:

        ForumsTopicsService.fetchTopics()

        A list of all forum topics, except those topics that were moved to the trash.

        Return a java.util.Vector object. Each object in the vector is a java.util.Hashtable object that describes one forum topic.

        ForumsTopicsService.fetchTopicsByDate(String type, String begindate, String enddate)

        A list of forum topics created or modified in a specified date range. The maximum number of topics in the returned list is 50. If the number is greater than 50, call this method in a loop where the last UUID parameter is the UUID of the 50th topic from the previous list.

        Return a java.util.Vector object. Each object in the vector is a java.util.Hashtable object that describes one forum topic.

        Parameters:

          type
          Specifies the date type. The following values are valid:

          • created
          • modified

          begindate
          Start timestamp of the date range, which is specified in a yyyy.mm.dd format.

          enddate
          Finish timestamp of the date range, which is specified in a yyyy.mm.dd format.

        For example: 

        ForumsTopicsService.fetchTopicsByDate("created","2010.05.21","2010.05.22")

        ForumsTopicsService.fetchTopicsByDate("modified","2010.05.21","2010.05.22")

        ForumsTopicsService.fetchTopicsCreatedByMember(String extId, String type)

        A list of forum topics created by the specified member, except those topics that are in the trash.

        Return a java.util.Vector object. Each object in the vector is a java.util.Hashtable object that describes one forum topic.

        Parameters:

          extId
          The external ID of the specified member whose topics you want to retrieve.

          type
          The type of external ID specified. The following values are valid:

          • uuid
          • email

        For example: 

        ForumsTopicsService.fetchTopicsCreatedByMember("778CE573-78A5-2ECF-8525-7346003DB078","uuid")

        ForumsTopicsService.fetchTopicsCreatedByMember("ajones10@example.com","email")

        ForumsTopicsService.fetchTopicById(String topicuuid)

        A forum topic that is identified by the specified universal identifier.

        Return a java.util.Hashtable object that describes the forum topic.

        This command takes the following parameter:

          topicuuid
          The unique identifier of the forum topic.

        For example: 

        ForumsTopicsService.fetchTopicById("15279c53-7bb2-43dd-96ad-2eee2c7f10f8")


    Filter lists of forums

    Retrieve a subset of forums to administer.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    When you retrieve a list of forums, you can filter the list to find a forum with a specific name or ID.

    Use either the ForumsService.filterInput or ForumsTrashService.filterForumsByName command to retrieve a subset of forums.

    1. Use a variable to store the returned data when you use a fetch command.

      For example, the following code stores the objects that are returned from the fetchForumsTrash() command in the alltrash variable: 

      alltrash=ForumsTrashService.fetchForumsTrash()
      The objects are formatted as a java.util.Vector of hash tables that represent deleted forums in the Trash view.

    2. Use the following commands to narrow down the list of results that you stored in the variable:

        ForumsService.filterInput(VectorinputVector, java.lang.String toMatch, java.lang.String attrName)

        Filters a source vector of forums to return a new vector that contains a map pair that matches the specified filter criteria.

        Parameters:

          inputVector
          The source vector that contains the map collection.

          toMatch
          A Java regular expression pattern that represents matching criteria. This pattern is used to search the attrName of the forums or entries. The pattern must match the full name and is case-sensitive. You can use the following keys:

          • Period (.) matches any character.
          • Plus sign (+) matches one or more instances of the previous character.

            For example, .+ matches all sequences of one or more characters.

          • Asterisk (*) matches zero or more instances of the previous character.

            For example, * matches all sequences of characters.

          • [chars] matches any one character within the square brackets ([]).

            For example, [Gg] matches either an upper or lowercase G.

          • [A-Z] matches a range of characters.

          attrName
          The key to filter in the map. Possible values include name and forumID. The default value is name.

        ForumsTrashService.filterForumsByName(VectorinputVector, java.lang.String toMatch)

        Filters a source vector of forums to return a new vector that contains a map pair that matches the specified name filter criteria.

        Parameters:

          inputVector
          The source vector that contains the map collection.

          toMatch
          Java regular expression pattern that represents matching criteria. This pattern is used to search the name of the forums. The pattern must match the full name and is case-sensitive. You can use the following keys:

          • Period (.) matches any character.
          • Plus sign (+) matches one or more instances of the previous character.

            For example, .+ matches all sequences of one or more characters.

          • Asterisk (*) matches zero or more instances of the previous character.

            For example, * matches all sequences of characters.

          • [chars] matches any one character within the square brackets ([]).

            For example, [Gg] matches either an upper or lowercase G.

          • [A-Z] matches a range of characters.

      For example, the alltrash vector that is saved in step 1 has two maps as follows, each of which has one value pair, (key = "name", value=""): 

      alltrash={name=forum-1, name=forum-2}
      The following command filters the alltrash vector to get only those maps for which the value of the name key is forum-1. The maps are stored in a vector named vii. The default value of the third parameter is name. 

      vii=ForumsService.filterInput(alltrash, "forum-1")
      or 

      vii=ForumsTrashService.filterForumsByName(alltrash,"forum-1")
      The command returns the following vector: 

      vii={name=forum-1}

      In this example, you want to filter the results of the following source vector by forumID. 

      inputVector=ForumsService.fetchForums()

      ...where the inputVector vector has two maps, each of which has one value pair, (key = "forumID", value=""): 

      inputVector={forumID=00000-0001, forumID=00000-0002}
      The following command returns only the forum with the ID, 00000-0001: 

      vii = ForumsService.filterInput(inputVector,"00000-0001","forumID")
      The command returns the following vector: 

      vii={forumID=00000-0001}

    3. Pass the variable that contains the subset of resources to operate on into the command that you are using.

      For example, to restore the collected subset of forums that are stored in the vii variable, you might use the following command: 

      ForumsTrashService.undeleteForumsTrash(vii)


    Rectify the count of forums and forum topics

    Recalculate the count of forums and forum topics.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    When you use these commands, you do not have to check the configuration file in and out, nor restart the Forums server, because the commands take effect immediately.

    If an administration task in the Forums application fails, the total count of forums and forum topics that are displayed in the Forums user interface might be incorrect. You can use administrative commands to manually recalculate the count of forums and forum topics in your organization and ensure that the figures are up-to-date.

    To recalculate the number of forums and forum topics, complete the following steps.

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands fail.

    2. Start the Forums Jython script interpreter by 

      execfile("forumsAdmin.py")

      If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

    3. Run any of the following commands:

        ForumsService.reCountAllForums()

        Recalculates the total number of forums in your organization.

        This command does not take any parameters.

        ForumsService.reCountForums(Vector forums)

        Recalculates the number of specified forums in your organization, where you specify the forums to recalculate as a vector variable that represents multiple forums.

        For example: 

        ForumsService.reCountForums(myforums)

        ForumsService.reCountForumById(java.lang.String uuid)

        Recalculates the number of topics in a specific forum, where you specify the forum by its UUID.

        For example: 

        ForumsService.reCountForumById("778CE573-78A5-2ECF-8525-7346003DB078")

        ForumsTopicsService.reCountTopics(Vector topics)

        Recalculates the number of specified topics in your organization, where you specify the topics to recalculate as a vector variable that represents multiple topics.

        For example: 

        ForumsTopicsService.reCountTopics(mytopics)

    4. Use the following command to filter a vector result: 

      Vector vii=ForumsService.filterInput(VectorinputVector,java.lang.String toMatch,java.lang.String attrName)
      This command returns a new vector that contains a map pair to match the filter criteria.

      The command takes the following parameters:

        inputVector
        The source vector that contains the map collection.

        toMatch
        The value pattern that you are using to narrow down your results.

        attrName
        The key to be filtered in the map.

      For example, you might get a vector of forums by 

      inputVector=ForumsService.fetchForums()
      The inputVector vector contains two maps as follows: 

      inputVector = {name=forum-1,name=forum-2}
      Each map has one value pair: 

      (key = "name", value="")

      In this example, you want to filter the vector to retrieve the maps in which the value of the name key is forum-1 so you run the following command: 

      Vector vii=ForumsService.filterInput(inputVector,"forum-1","name")
      The vii vector variable now contains a single forum with a name key of forum-1: 

      vii = {name=forum-1}


    Moderate forums

    Enable a moderator to review and manage forum posts.

    When moderation is enabled for Forums, a designated moderator can review posts before they are published to a forum and manage posts after they are added to a forum. Forums moderation is supported for community forums and stand-alone forums.

    If premoderation is enabled for your deployment, when users create or reply to forum posts, the content that they add is not displayed until it is approved by a moderator. If postmoderation is enabled, the moderator can review content that is flagged as inappropriate and determine whether the content must be removed.

    As administrator, you can control who has permission to moderate forum content by using two scopes:

      Global moderation
      You can assign the global-moderator role for Forums to specified users.

      For more information about assigning roles, see Roles.

      Users who are assigned to the global-moderator role can see an additional Moderation link in the application menu bar when they are logged in to Connections. This link is visible only to global moderators. Clicking the link provides access to a global moderation interface where moderators can review and manage posts from stand-alone forums and community forums.

      For more information about moderating forum content from the global moderation interface, see Moderation overview.

      Community forum moderation
      Community forums can be moderated by community owners if owner moderation for Communities is enabled in the contentreview-config.xml file.

      For more information about how to configure owner-moderation settings, see Managing content moderation and flagged content.

      When owner moderation is enabled for Communities, community owners can review and manage the content of their community forums directly from the community by logging in to Connections and selecting Moderate Community from the Community Actions menu. Community owners can review content only in their own community forums.

      For more information about moderating content in community forums, see Moderating community content.

    In addition to the global moderation interface and the community forum moderation interface, public moderation APIs are available to allow third-party developers to moderate community forum content and community file content.

    For more information, refer to the Forums API section of the Connections 4 API Documentation.


    Manage forum trash

    Move forum content to the trash, empty the trash, restore forums and forum topics from the trash, and perform other trash management tasks for Forums.


    Move forums to the trash

    Use administrative commands to move one or more forums to the Trash view.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands fail.

    2. Start the Forums Jython script interpreter by 

      execfile("forumsAdmin.py")

      If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

    3. To move forums to the trash, generate a variable that contains the forums to delete:

      1. Create a variable that contains the forum or forums to delete. You can get a list of forums in hash table format by using one of the fetchForums() commands.

        For more information about the commands, see Getting a list of forums.

        For example: 

        variable=ForumsService.fetchForumsByName(java.lang.String forumName)

      2. Enter the following command to delete the forum or forums: 

        ForumsService.deleteForums(java.util.Vector forums)

        ...where the forums parameter specifies the forum or forums to delete. This parameter maps to the variable that you created in the previous step.

        For example, if a user leaves the organization and you want to delete a forum that was owned by thems: 

        obsoleteForum=ForumsService.fetchForumsByName("Joes Forum")
wsadmin>ForumsService.deleteForums(obsoleteForum)


    Delete topics from forums

    Remove unwanted or inappropriate topics from the Forums application.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    When you remove topics from a forum, the topics are soft-deleted.

    To remove forum topics from the database completely, you must purge the forum trash.

    For more information about purging the trash, see Purging forum trash on a schedule.

    To delete forum topics....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands fail.

    2. Start the Forums Jython script interpreter by 

      execfile("forumsAdmin.py")

      If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

    3. If you have not yet created a variable that contains the forum topics to delete, create one now. You can get a list of forum topics in hash table format by using one of the ForumsTopicsService fetch commands.

      For more information about these commands and how to use them, see Getting a list of forum topics.

      When a user leaves the organization and you want to delete the forum topics that they created to identify the forum topics to delete: 

      ForumsTopicsService.fetchTopicsCreatedByMember(String extId, String type)

      For example: 

      janetstopics=ForumsTopicsService.fetchTopicsCreatedByMember("ajones10@example.com","email")

      You can also fetch the topics by using the employee's member uuid.

      For example: 

      janetstopics=ForumsTopicsService.fetchTopicsCreatedByMember("778CE573-78A5-2ECF-8525-7346003DB078","uuid")

    4. Use the following command to delete forum topics:

        ForumsTopicsService.deleteTopics(Vector forumtopics)

        Moves the specified forum topics to the trash. Forum topics in the Trash view can be restored if they are restored before the trash is emptied.

        Return a java.util.Vector. Each object in the vector is a java.util.Hashtable that describes a forum topic that cannot be deleted. A returned empty vector indicates complete success.

        This command takes the following parameter:

          forumtopics
          Vector of hash tables that describes the forum topics to be deleted.

        For example: 

        ForumsTopicsService.deleteTopics(janetstopics)


    Restore deleted forum content

    Restore forum content from the trash.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    If you change your mind about deleting content from the Forums application, you can restore the content from the trash. Use the ForumsTrashService commands to restore deleted content from the trash with immediate effect.

    When you use these commands, you do not have to check the Forums configuration file in and out, nor restart the Forums server.

    To restore forum content that was deleted:

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands fail.

    2. Start the Forums Jython script interpreter by 

      execfile("forumsAdmin.py")

      If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

    3. Do one of the following.

      • To get a list of the deleted forums that are currently in the trash: 

        ForumsTrashService.fetchForumsTrash()

      • To get a list of the deleted forum topics that are currently in the trash: 

        ForumsTrashService.fetchTopicsTrash()

      • To get a list of forums that were deleted on a specific date, enter the following command: 

        ForumsTrashService.fetchForumsTrashByDate(String modifySince)

        ...where modifySince is a string that specifies the date when the forum was deleted in yyyy.MM.dd format.

        For example: 

        vari = ForumsTrashService.fetchForumsTrashByDate("2013.04.11")
        This command retrieves all the forums that were deleted on the 11th of April 2013 and uses a variable called vari to store the returned data.

    4. Identify the forums or forum topics to restore from the returned list. Use the following command to filter the forums by name:

        ForumsTrashService.filterForumsByName(VectorinputVector, java.lang.String toMatch)

        Filters a source vector of forums to return a new vector that contains a map pair that matches the specified name filter criteria.

        Parameters:

          inputVector
          The source vector that contains the map collection.

          toMatch
          Java regular expression pattern that represents matching criteria. This pattern is used to search the name of the forums. The pattern must match the full name and is case-sensitive. You can use the following keys:

          • Period (.) matches any character.
          • Plus sign (+) matches one or more instances of the previous character.

            For example, .+ matches all sequences of one or more characters.

          • Asterisk (*) matches zero or more instances of the previous character.

            For example, * matches all sequences of characters.

          • [chars] matches any one character within the square brackets ([]).

            For example, [Gg] matches either an upper or lowercase G.

          • [A-Z] matches a range of characters.

    5. To restore deleted contents:

        ForumsTrashService.undeleteForumsTrash(vector hashtable)

        Restores a deleted forum or forums, where you specify the forum or forums to restore by using the hashtable parameter.

        For example: 

        ForumsTrashService.undeleteForumsTrash(forumsTrash)

        ForumsTrashService.undeleteTopicTrash(vector hashtable)

        Restores a deleted forum topic or topics, where you specify the topic or topics to restore by using the hashtable parameter.

        For example: 

        ForumsTrashService.undeleteTopicTrash(topictrash)


    Example

    To identify the forums to restore from the trash, generate a variable that contains a list of forums and then filter that list by forum name:

    1. Create a variable that contains a list of forums in the trash. You can get a list of forums in hash table format by using one of the fetchForums commands: ForumsTrashService.fetchForumsTrash() or ForumsTrashService.fetchForumsTrashByDate(String modifySince).

      For example: 

      april4Trash = ForumsTrashService.fetchForumsTrashByDate("2011.04.11")
    2. Filter the list of forums to find the forum or forums to restore:

      For example, to find a forum with the name Forum1: 

      myForums = ForumsTrashService.filterForumsByName(april4Trash,"Forum1")
      Alternatively, you can filter the list of forums to find forums that have a name that begins with "Forum" and store the results in the myForums variable: 

      myForums = ForumsTrashService.filterForumsByName(april4Trash,"Forum.*")
    3. Restore the forum or forums by passing the variable to the undeleteForumsTrash command.

      For example: 

      ForumsTrashService.undeleteForumsTrash(myForums)


    Purge forum trash on a schedule

    Configure the schedule for purging Forums trash.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    Edit settings in the forum-config.xml file to configure the Forums trash purge schedule. You can define the interval at which the task runs by configuring the interval property, which uses a Cron schedule.

    The trash purge job is scheduled to run periodically to permanently remove content that is deleted from a forum from the trash. The Forums application uses WAS scheduling service for purging trash from Forums.

    For more information about the scheduler, see Scheduling tasks.

    To configure the TrashAutoPurgeJob task....

    1. cd WAS_HOME/profiles/Dmgr01/bin

    2. Start the Forums Jython script interpreter.

      1. Access the Forums configuration files: 

        execfile("forumsAdmin.py")

        If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

      2. Check out the Forums configuration files by

        ForumsConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the XML and XSD configuration files are copied. The files are kept in this working directory while you modify them.

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

        • cell_name is the name of the WAS cell that hosts the Connections applications. This argument is required. It is also case-sensitive, so type it with care. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example:

        ForumsConfigService.checkOutConfig("/opt/my_temp_dir", "ForumCell01")

    3. To view the current configuration settings:

      ForumsConfigService.showConfig()

      After you update configuration settings, you can use this command again to display your updates.

    4. To change configuration settings for Forums:

      ForumsConfigService.updateConfig("property", "value")

      where:

      • property is one of the editable Forums configuration properties.
      • value is the new value to specify for the property.
      The following table displays information about the TrashAutoPurgeJob property and the type of data that you can specify.


      TrashAutoPurgeJob properties

      Property Description
      task.TrashAutoPurgeJob.enabled Enables or disables the forum purge trash task.

      This property accepts the following values: true or false.

      For example: 

      ForumsConfigService.updateConfig("task.TrashAutoPurgeJob.enabled", "true")
      task.TrashAutoPurgeJob.trashRetentionInDays Specifies the number of days that deleted content remains in the database. The value must be set to 1 or greater. If the value is less than 1, the trash is not purged by this job. The default value is 90.

      For example: 

      ForumsConfigService.updateConfig("task.TrashAutoPurgeJob.trashRetentionInDays", "120")
      task.TrashAutoPurgeJob.interval Specifies the interval at which the purge trash task runs.

      When you change the interval property, the new schedule is registered the next time that Forums is started.

      For example: 

      ForumsConfigService.updateConfig("task.TrashAutoPurgeJob.interval", "0 0/15 * * * ?")

    5. Check the configuration files back in in the same wsadmin session in which you checked them out.

      For information about how to save and apply your changes, see Applying property changes in Forums.


    Purge specific forum content from the trash

    Use administrative commands to permanently delete a specific forum or forum topic by removing it from the trash.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    When you use these commands, you do not have to check the configuration file in and out, nor restart the Forums server, because the commands take effect immediately.

    To purge specific forum content from the trash....

    1. Start the wsadmin client:

        WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or subsequent commands fail.

    2. Start the Forums Jython script interpreter by 

      execfile("forumsAdmin.py")

      If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

    3. To get a list of the deleted forum content currently in the trashs:

        ForumsTrashService.fetchForumsTrash()

        Retrieves a list of the deleted forums currently in the trash

        ForumsTrashService.fetchTopicsTrash()

        Retrieves a list of the deleted forum topics currently in the trash.

        ForumsTrashService.fetchForumsTrashByDate(String modifySince)

        Retrieves a list of the forums that were deleted on a specific date.

        This command takes the following parameter:

          modifySince
          A string that specifies the date when the forum was deleted in yyyy.MM.dd format.
    4. Identify the forum or forum topic to purge from the trash.

      For more information about how to narrow down a list of forums, see Filtering lists of forums.

    5. To delete a specific forum or forum topic from the trash permanentlys.

        ForumsTrashService.purgeForumsTrash(vector hashtable)

        Purge the specified forums from the trash, where you specify the forums to delete by using the hashtable parameter.

        For example: 

        ForumsTrashService.purgeForumsTrash(forumtrash)

        ForumsTrashService.purgeTopicsTrash(vector hashtable)

        Purge the specified forum topics from the trash, where you specify the topics to delete by using the hashtable parameter.

        For example: 

        ForumsTrashService.purgeTopicsTrash(topictrash)


    Manage Forums scheduled tasks

    Use the ForumsScheduler administrative commands to manage the tasks that are scheduled for forums.

    To run administrative commands, you must use the wsadmin client.

    The Forums application uses the WAS scheduling service for running regular managed tasks.

    The Forums application has one managed task, the TrashAutoPurgeJob task, which removes deleted data from the Forums database.

    For more information about the TrashAutoPurgeJob task, see Purging forum trash. You can use the ForumsScheduler commands to pause and resume the TrashAutoPurgeJob task, and to retrieve information about the task. The scheduling information is contained in the forum-config.xml file. The SystemOut.log file also contains information about whether the scheduler is running and whether any scheduled tasks are running.

    To manage scheduled tasks for Forums....

    1. Start the wsadmin client:

          cd WAS_HOME\profiles\Dmgr01\bin

      You must start the client from this directory or subsequent commands fail.

    2. Start the Forums Jython script interpreter by 

      execfile("forumsAdmin.py")

      If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

    3. Administer the Forums scheduler service

        ForumsScheduler.getTaskDetails(String taskName)

        Return information about the scheduled task, specified by taskName. Forums currently has a single managed task – TrashAutoPurgeJob.

        The values that are returned are server time, next scheduled run time, status (SCHEDULED, RUNNING, SUSPENDED), and task name. When the task is paused, then the status parameter shows as SUSPENDED instead of SCHEDULED. SUSPENDED means that the task is not scheduled to run.

        For example: 

        ForumsScheduler.getTaskDetails("TrashAutoPurgeJob")

        The resulting output looks similar to the following example: 

        {currentServerTime=Wed Feb 03 14:21:47 EST 2010, nextFireTime=Sun Feb 07 02:00:00 EST 2010, status=SCHEDULED, taskName=TrashAutoPurgeJob}

        ForumsScheduler.pauseSchedulingTask(String taskName)

        Temporarily pauses the specified task and stops it from running.

        When you pause a scheduled task, the task remains in the suspended state even after you stop and restart Forums or the IBM WebSphere Application Server. To resume the task, run the ForumsScheduler.resumeSchedulingTask(String taskName) command.

        If the task is running, it continues to run but is not scheduled to run again. If the task is already suspended, this command has no effect.

        For example: 

        ForumsScheduler.pauseSchedulingTask("TrashAutoPurgeJob")
        When a task is paused, a status message similar to the following is written to the SystemOut.log file: 

        [2/3/10 14:28:10:782 EST] 0000002f ForumsNotific I   CLFWY0134I: Forums scheduled task 'TrashAutoPurgeJob' fired event 'TaskNotificationInfo.SUSPENDED'

        ForumsScheduler.resumeSchedulingTask(String taskName)

        If the task is suspended, puts the task in the scheduled state. If the task is not suspended, this command has no effect.

        When a task is resumed, it does not run immediately; it runs at the time when it is next scheduled to run.

        For example: 

        ForumsScheduler.resumeSchedulingTask("TrashAutoPurgeJob")
        Resuming a paused task causes the following status message to be written to the SystemOut.log file: 

        [2/3/10 14:28:25:407 EST] 00000051 ForumsNotific I   CLFWY0134I: Forums scheduled task 'TrashAutoPurgeJob' fired event 'TaskNotificationInfo.RESUMED'


    Manage file attachments in Forums

    You can manage space on the Forums application server by limiting the number of attachments that users can upload to a forum post. You can also edit configuration settings in the forum-config.xml file to prevent users from uploading file attachments.


    Set the maximum number of attachments

    Edit configuration property settings to configure the maximum number of files that can be uploaded to a single forum post.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    You can control space on the server by editing settings in the forum-config.xml file to limit the number of attachments that users can upload to a forum post.

    You can also use the <sizelimits> section of the forum-config.xml to set a file size limit per file extension type.

    To configure the maximum number of attachments that can be uploaded to a single post....

    1. cd WAS_HOME/profiles/Dmgr01/bin

    2. Start the Forums Jython script interpreter.

      1. Access the Forums configuration files: 

        execfile("forumsAdmin.py")

        If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

      2. Check out the Forums configuration files by

        ForumsConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the XML and XSD configuration files are copied. The files are kept in this working directory while you modify them.

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

        • cell_name is the name of the WAS cell that hosts the Connections applications. This argument is required. It is also case-sensitive, so type it with care. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example:

        ForumsConfigService.checkOutConfig("/opt/my_temp_dir", "ForumCell01")

    3. Open the forum-config.xml file using a text editor.

    4. Edit the <max-number-attachment-per-post> element in the <objectStore> section of the file to set the maximum number of attachments that can be uploaded per post.

      For example, to set the maximum number of attachments per post to 6, you edit the file as follows: 

      <objectStore>
...
   <max-number-attachment-per-post>6</max-number-attachment-per-post>
...
</objectStore>
      You can also set the file size limits per mime type using the <sizeLimits> setting.

    5. Save your changes and close the forum-config.xml file.

    6. After making changes, check the configuration files back in, and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes in Forums for information about how to save and apply your changes.


    Disable attachments

    Edit configuration property settings to prevent users from uploading file attachments to forums.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    By default, users can upload file attachments to forum topics, however you can disable this functionality by configuring a setting in the forum-config.xml file. If users have already uploaded file attachments to the Forums application and you subsequently disable this capability, the attachments are no longer visible in the user interface. The user interface options for adding and working with attachments are also hidden.

    To disable the upload of file attachments in Forums....

    1. cd WAS_HOME/profiles/Dmgr01/bin

    2. Start the Forums Jython script interpreter.

      1. Access the Forums configuration files:

          execfile("forumsAdmin.py")

        If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

      2. Check out the Forums configuration files by

        ForumsConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the XML and XSD configuration files are copied. The files are kept in this working directory while you modify them.

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

        • cell_name is the name of the WAS cell that hosts the Connections applications. This argument is required. It is also case-sensitive, so type it with care. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example:

        ForumsConfigService.checkOutConfig("/opt/my_temp_dir", "ForumCell01")

    3. Open the forum-config.xml file using a text editor.

    4. Change the value specified for the <allow-upload> property from true to false as follows:

        <allow-upload>false</allow-upload>

    5. Save your changes and close the forum-config.xml file.

    6. After making changes, check the configuration files back in, and you must do so in the same wsadmin session in which you checked them out for the changes to take effect.

      See Applying property changes for information about how to save and apply your changes.


    Enable topic posting in different deployments

    Enable users to take forum topics in one Connections deployment and post them to a different Connections deployment.

    Users can click Bookmark or Discuss This on any Connections page to install a Discuss This button in their browser toolbar. When a user clicks the button, the content of the current page is added to a forum topic that the user selects.

    Use the discussThis.enabled property to enable a similar Discuss This button on every forum topic page. Users can click the button to post the topic as a new topic in a forum in a different Connections deployment. You can specify that deployment in the discussThis.internalHost property.

    For example, if you have two Connections deployments in your enterprise, A and B, you can allow forums users in Deployment A to post topics to Deployment B forums. To enable this feature, check out the forums-config.xml file in Deployment A and specify the address of the forums application in Deployment B. When users open a forum page in deployment A and clicks the Discuss This link, they can select the target forum on Deployment B from a pop-up dialog. If the users are not logged in to Deployment B, they are prompted to log in before they can post the new topic. Users must be members of the group that is mapped to the discussThis-user role on Deployment A (the default is Everyone).

    1. On the Forums server in Connections deployment A, check out the forums-config.xml file.

      For more information, see Changing Forums configuration property values.

    2. To enable the feature, run the following command in the wsadmin client:

        ForumsConfigService.updateConfig("discussThis", "true")

    3. Specify the address of the forums application in deployment B:

        ForumsConfigService.updateConfig("discussThis.targetBookmarklet", "http://forums_appserver.enterprise.com:9081/connections/bookmarklet")

    4. Check in the forums-config.xml file.

    5. Restart the Forums application.


    Restrict topic editing

    You can restrict the editing of forum topics or replies to their creators. Only a user who created a topic or a reply can edit it.

    To restrict the editing of forum topics to the users who created them, you must add some elements to LotusConnections-config.xml. Then, edit the forum-policy.xml file, deleting any rows that contain edit_all_post.

    1. Start wsadmin:

        cd WAS_HOME/profiles/Dmgr01/bin
        ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port 8879

    2. Use the wsadmin client to access and check out the Connections configuration files:

      1. Access the Connections configuration file: execfile("connectionsConfig.py")

        If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

      2. Check out the Connections configuration files:

        LCConfigService.checkOutConfig("working_directory","cell_name")

        where:

        • working_directory is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you modify them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command does not run successfully.

        • cell_name is the name of the WAS cell that hosts the Connections applications. This argument is case-sensitive, so type it with care. To get cell name, from wsadmin:

          print AdminControl.getCell()

        For example:

        • AIX or Linux:LCConfigService.checkOutConfig("/opt/temp","Cell01")

        • IBM i:LCConfigService.checkOutConfig("/temp","Cell01")

          Windows:LCConfigService.checkOutConfig("c:/temp","Cell01")

    3. Open LotusConnections-config.xml in an editor, and then add the following content:

      <properties> <genericProperty name="forceContentEditOnlyByCreator">true</genericProperty> </properties>

    4. Open LotusConnections-config.xml in a web browser to make sure that you did not introduce any errors. XML files that are well formed display in a web browser; if there are errors, the web browser reports that an error was encountered. Fix any errors before proceeding.

    5. Check in the configuration files in the same wsadmin session in which you checked them out.

      1. Update the value of the version stamp configuration property to force users' browsers to pick up this change.

        Increment the value of the versionStamp property:

        LCConfigService.updateConfig("versionStamp","gmt_timestamp")

        Where gmt_timestamp is the GMT time.

        You can specify an empty string for the time stamp or provide a GMT value string. When you specify an empty string, the client calculates the current GMT time and updates the version stamp with that value. If you choose to provide the time, specify it using the following format:

          yyyyMMdd.HHmmss

        ...and specify the time in GMT. It is best to provide an empty string and let the client format the time stamp.

        For example:

          LCConfigService.updateConfig("versionStamp","")

        See Required post-customization step.

      2. To check in the changed configuration property files:

        LCConfigService.checkInConfig()

      3. Type the following command to deploy the changes:

        synchAllNodes()

      4. Do not exit the wsadmin client.

    6. In the wsadmin client, check out the forum-policy.xml file.

      For more information, see Editing configuration files.

    7. Open the forum-policy.xml file in an editor and delete any row that contains edit_all_post.

    8. Check in the forum-policy.xml file.

    9. Restart all of the Connections application servers.


    Allow non-community members to comment

    Allow users who are not community members to comment in forums in public or moderated communities.

    To run administrative commands, use the wsadmin client.

    For more information, see Start wsadmin.

    By editing settings in the forum-config.xml file, you can allow users who are not community members to comment in forums in public or moderated communities.

    To allow users who are not community members to comment in forums in public or moderated communities:

    1. Start the wsadmin client:

        cd WAS_HOME/profiles/Dmgr01/bin

      You must start the client from this directory or else subsequent commands that you enter might fail.

    2. Start the Forums Jython script interpreter.

      1. Access the Forums configuration files:

          execfile("forumsAdmin.py")

        If you are prompted to specify a service to connect to, enter 1 to select the first node in the list. Most commands can run on any node. If the command specifies a file by using a local file path, select the node where the file is stored.

      2. Check out the Forums configuration files by

        ForumsConfigService.checkOutConfig("working_directory", "cell_name")

        where:

        • working_directory is the temporary working directory to which the XML and XSD configuration files are copied. The files are kept in this working directory while you modify them.

          AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

        • cell_name is the name of the WAS cell that hosts the Connections applications. This argument is required. It is also case-sensitive, so type it with care. To determine cell name, run wsadmin command:

          print AdminControl.getCell()

        For example:

        ForumsConfigService.checkOutConfig("/opt/my_temp_dir", "ForumCell01")

    3. Open the forum-config.xml file with a text editor.

    4. Edit the enableNonMembercontributor element in the deployment section of the file. The default value is false.

      For example, to set the value to true, edit the file as follows:

      <deployment enableCategory="false" enableLotusLive="false" enableNonMemberContributor="true"/>

    5. Save your changes and close the forum-config.xml file.

    6. Check in the configuration files in the same wsadmin session in which you checked them out.

      For information about how to save and apply your changes, see Applying property changes in Forums.