Activate File Sync in IBM Connections 5.5

In order to allow file sync in IBM Connections for the Connections Desktop Plugin and Mobile Devices, we need to modify the configuration of the Files and Mobile Application. To do that we will need to edit the “files-config.xml” and “mobile-config.xml” files, before making any changes to these files. I advise you to make a copy of them for Backup purposes, just in case something goes wrong you can check-in the original files and you are good to go again. In order to apply the configuration, we will also need to restart the Files and Mobile Application, there is no need to do this right away after making the configuration changes so you can do it in your regular maintenance window.

Enable File Sync within the Files Application

  • Login to the server where the WAS Deployment Manager is running.
  • Open the Command Prompt as Administrator and navigate to the bin directory of Deployment Manager.
    • <WAS_Installation_Root>\Appserver\Profiles\<DMGR_Profile>\bin
    • In my case that´s “d:\IBM\WebSphere\AppServer\profiles\ic-dmgr01\bin”
  • Initialize wsadmin Command Prompt by entering the following command:

Wsadmin –lang jython –username <Admin_Username> –password <password>

  •      Initialize Files App Administration.


  • Check out the “Files” Application Configuration files.

FilesConfigService.checkOutConfig(“working_directory”, “cell_name”)

Note: You can get the cell name by issuing the following command: “AdminControl.getCell()

Keep in mind that you will need to create the “working directory” before issuing the Check Out command, or else the command will fail. Even though we are working on a Windows OS we need to type the path to the working directory with slashes instead of backslashes.

  • Open the “files-config.xml” file, which we just checked out, with Notepadd++ or a similar text editor.
  • Search for “filesync”.
  • Set the parameter “fileSync enabled” from “false” to “true”.

  • Save the file.
  • Check the configuration files back in with the following command:


Check if the users, for whom you want to enable this feature, are mapped to the “filesync-user” role.

  • Log in to the ISC.
  • Navigate to “Applications –> Application Types –> WebSphere enterprise applications –> Files”.

2016-03-13 20_41_13-WebSphere Integrated Solutions Console

  • Click on “Security role to user/group mapping”.

2016-03-13 20_42_44-WebSphere Integrated Solutions Console

  • Check the “filesync-user” role.

Note: If you make any changes to the role, WebSphere will automaticaly restart the Files Application and you do not need to restart it manually.

  • Restart the Files Application if you haven´t made any changes to the “security role to user/group” mapping of the Application.

Enable Sync for Mobile Devices

Now that the files sync works for the IBM Connections Desktop plugin, let us go ahead and do the same for the mobile devices.

  • Initialize wsadmin Command Prompt.

Wsadmin –lang jython –username <Admin_Username> –password <password>

  • Initialize Files App Administration


  • Check out the Mobile Application Configuration Files by using the following Command:

MobileConfigService.checkOutConfig(“working_directory”, “cell_name”)

  • Open the “mobile-config.xml” file in a Text editor.
  • Search for “FileSync enabled” and set it to “true”.
  • Search for “FileDiff” and set it to “true”.

  • Save the file.
  • Check the configuration files back in with the following command:


  • Restart the Mobile Application.

Now you should be good to go. The mobile devices should be aware of the new functionality the next time they connect to the environment and the Desktop plugin will either pick up the change after the client restart or by manually right clicking the “house” symbol in a File Explorer and selecting “Check feature updates”.


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s