Home

 

Comparing remote application data with the Communities database

Use the exportSyncedResourceInfo commands to return a report of all the communities that a feature 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, use the IBM WebSphere Application Server wsadmin client. See Start the wsadmin client for details.


Communities can integrate with the Activities, Blogs, Files, and Wikis features 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. Use the wsadmin client to access the configuration files for the remote application that you want to synchronize with Communities.

    • To access the Activities configuration file, use one of the following commands:

    • To access the Blogs configuration file, use one of the following commands:

    • To access the Files configuration file, use one of the following commands:

    • To access the Wikis configuration file, use one of the following commands:

  2. To generate a report of all communities that a remote application has interacted with, use the feature-specific version of the following command:

    feature_nameService.exportSyncedResourceInfo(<file_path>, <event_type>)

    where

    • feature_name is the feature 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 feature. In clusters where multiple nodes are running the specified feature, 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 feature or features you are correcting, choose from the following commands:

    • Activities:

      ActivityService.exportSyncedResourceInfo(filePath,eventType)

      For example: 

        ActivitiesService.exportSyncedResourceInfo("/temp-dir/activitiesOutput.xml", "community")

  3. Blogs:

    BlogsAdminService.exportSyncedResourceInfo(filePath, eventType)

    For example: 

      BlogsAdminService.exportSyncedResourceInfo("/temp-dir/blogsOutput.xml", "community")

  4. Files:

    FilesLibraryService.exportSyncedResourceInfo(filePath, eventType)

    For example: 

      FilesLibraryService.exportSyncedResourceInfo("/temp-dir/filesOutput.xml", "community")

  5. Wikis:

    WikisLibraryService.exportSyncedResourceInfo(filePath, eventType)

    For example: 

      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 feature-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.


Recovering from a database failure


Previous topic:

Restore communities with remote applications


Next topic:

Generating a synchronization report

 

Related tasks

Delete orphaned data

Generating a synchronization report

Backing up Activities data

 

Related reference


Activities administrative commands

Wikis administrative commands

Files administrative commands

+

Search Tips   |   Advanced Search