+

Search Tips   |   Advanced Search

Update the desktop plug-ins configuration data

Use a configuration tool to update the IBM Connections Desktop Plug-ins for Windows after you migrate from an IBM Connections 3.0.1.1 server to a Connections 4.x server, or to configure client support for some of the Connections components.

If we are using the IBM Connections Desktop Plug-ins for Windows and you switch from a Connections 3.0.1.1 server to a Connections 4.5 server, we must run a configuration tool to refresh the plug-in features. If not, you might experience some unexpected behavior. For example, file locking does not work properly and we cannot see the file locking details when we inspect the properties of a file.

We can also use the configuration tool to configure client support for Connections components. Perform this operation for each user account whenever you remove a component from or add a component to a Connections server. These are the components we can add or remove.

Component names are not case-sensitive.

Depending on how we are using the plug-ins, you might want to load a profile that customizes the branding for a deployment. For example, if we are connecting to an IBM SmartCloud server rather than to IBM Connections, we can load a profile that replaces the Connections string with IBM SmartCloud in some parts of the user interface, such as the tab name in the Microsoft Office ribbon

  1. Open a command window and navigate to the directory where the Connections Desktop Plug-ins for Windows is installed. For example...

      C:\IBM\Connections Desktop Plugins

  2. Enter DIConfig.exe for a 32-bit Windows system or DIConfig64.exe for a 64-bit Windows system, and specify any of the following options:

    -version version_number

    Specify either 3.0.1.1 or 4.5 to change the server version. For example,

      DIConfig.exe https://enterprise.myco.com -v4.5

    -addComponent component_name component_url component_url2

    Specify the component name and the component URL. For example,

      DIConfig.exe https://enterprise.myco.com -addComponent Activities https://enterprise.myco.com/activities

    If we are adding Bookmarks, specify the Bookmarks component as the first URL and the URL for the bookmarklet that controls the Add Bookmark browser button as the second. For example:

      DIConfig.exe https://enterprise.myco.com -addComponent Bookmarks https://enterprise.myco.com/dogear https://enterprise.myco.com/bookmarklet

    -removecomponent component_name

    Specify the component name to be removed from the configuration. For example,

      DIConfig.exe https://enterprise.myco.com -removeComponent Activities

    -smartCloudProfile

    Load a profile that replaces IBM Connections in top-level menus with IBM SmartCloud. For example,

      DIConfig.exe -smartCloudProfile

    This replaces IBM Connections with IBM SmartCloud as the name of the tab in the Microsoft Office ribbon, in the menus, and the Windows navigation pane.

    Reboot after you run this option.

    -defaultProfile

    If we loaded a different profile to customize the branding of the plug-in, load the default profile that displays IBM Connections in the Microsoft Office ribbon and menus. For example,

      DIConfig.exe -defaultProfile

    Replaces IBM SmartCloud with Connections as the name of the tab in the Microsoft Office ribbon, in the menus, and the Windows navigation pane.

    Reboot after you run this option.

    Run the DIConfig64.exe command results in registry settings getting updated in the HKEY_LOCAL_MACHINE\SOFTWARE\IBM\Social Connectors section for 32-bit software as well as the HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\Social Connectors section for 64-bit software. This is working as designed.

  3. Repeat steps 1-2 for each desktop user account configured to use the desktop plug-ins.


Parent topic:
IBM Connections Desktop Plug-ins for Windows