Home

 

Assigning orphaned remote applications to a community

Use CommunitiesRemoteAppService commands 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 wsadmin. See Start wsadmin for details.

To assign orphaned remote applications to a community, first run the CommunitiesRemoteAppService.generateSyncReports command. This command generates an 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, and Wiki widgets.

To assign an orphaned widget to a new community or existing community...

  1. Start wsadmin so that you can access the Communities configuration files.

    1. Access the Communities configuration files:

      If you are asked to select a server, you can select any server.

  2. 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:


    Command parameters

    Parameter Description
    remoteAppDefId The remote application's identifier (that is, Wiki, Blog, Activities, or Files).
    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 The remote applications in the 2.5 release only support 'col2', This value must always be used.


Recovering from a database failure


Previous topic:

Generating a synchronization report


Next topic:

Delete orphaned data

 

Related tasks

Generating a synchronization report


+

Search Tips   |   Advanced Search