by Nick Lansdowne


Following a default installation of the the Netcool/OMNIbus v7.3.1 WebGUI component with a File Base repository, users are not automatically replicated to the ObjectServer. This prevents many of the WebGUI tools from working.

The synchronization process replicates user names and groups from file based or LDAP repositories to the ObjectServer. The synchronization is limited to users and groups that are assigned WebGUI roles.

The “Netcool/OMNIbus Installation and Deployment Guide” does document that a property in the file server.init must be updated to enable synchronization. However, further steps were required following my test installation, the full set of steps required was:

  • Delete the ObjectServer entry from the Federated Repository
  • Remove the ObjectServer entries from the Virtual Member Manager XML file
  • Update the server.init file
  • Restart the ObjectServer
These steps are detailed below.

Delete the ObjectServer Entry in the Federated Repository

Despite selecting for a file based repository the ObjectServer was still defined in the Federated repository. To remove this:
  • Login with the administrator credentials
  • Navigate to the page Settings->WebSphere Administrative Console
  • Click the button Launch WebSphere administrative console (this will open a new window/tab titled Integrated Solutions Console - ISC)
  • In the new ISC window, navigate to Settings->Global Security
  • Next to Federated Repositories click Configure…
  • In the table, check the NetcoolObjectServer repository and click Remove
  • Click Save and OK

Remove the ObjectServer from the VMM configuration

The Virtual Member Manager configuration file wimconfig.xml also includes a section for the ObjectServer that needs to be removed. Care must be taken when editing this file.
  • Back-up the file wimconfig.xml before opening in the ‘vi’ text editor:
cd /opt/IBM/tivoli/tipv2/profiles/TIPProfile/config/cells/TIPCell/wim/config
cp wimconfig.xml wimconfig.xml.original
vi wimconfig.xml
  • Remove the element for the ObjectServerAdapter, locate and delete the following lines:
 <config:repositories adapterClassName=""
        id="NetcoolObjectServer" supportPaging="false">
      <config:baseEntries name="o=netcoolObjectServerRepository"/>
      <config:CustomProperties name="password" value="<password>"/>
      <config:CustomProperties name="username" value="<username>"/>
      <config:CustomProperties name="host1" value="<hostname>"/> 
      <config:CustomProperties name="port1" value="<port>"/>

  • Save the update

Update the server.init file

As per the standard IBM documentation, the property “user.credentials.sync”  must be set to true. From a terminal session:
  • Open the server.init file in the ‘vi’ text editor:
cd /opt/IBM/tivoli/netcool/omnibus_webgui/etc
vi server.init
  • Edit the property “users.credentials.sync” and set to “true”:
  • Save the update

Restart the WebGUI and Tivoli Integrated Portal

Finally for the changes to apply, restart the TIP Server.
  • Stop the TIP:
$TIPHOME/bin/ server1 -username tipadmin -password XXXX
  • Start the TIP:
$TIPHOME/bin/ server1


For most enterprise environments WebGUI authentication will be against an LDAP server. User synchronization between the federated repository and the ObjectServer process is a vital function for enabling WebGUI users to interact with the ObjectServer and minimise administration tasks.

Interestingly, a similar test installation using the “Advanced” options and selecting the “File Based Repository” resulted in the user synchronization working without any changes. In this instance there were no ObjectServer references in the federated repository or VMM configuration file.

Twitter Feed

OrbData So proud to be Partnered with this global brand @ibm Putting Smart to Work!! #thinklondon #putsmarttowork


100 Longwater Avenue, Green Park, Reading, RG2 6GP, U.K.
+44 (0) 118 945 0130
This email address is being protected from spambots. You need JavaScript enabled to view it.

markerFind on Google Maps

About Us

Orb Data brings together People, Process and Technology to deliver the cornerstone of business success: the management of IT infrastructure. At our heart are our people. We have unrivalled experience, helping us to achieve an enviable reputation for excellence in project delivery. Because we’re independent, we identify actual issues and help organisations resolve them –from spec to deployment, and beyond –providing the right solution in terms of best of breed technology and support. We offer a refreshingly simple approach to the way we conduct business. We take pride in our abilities to provide first class solutions to business problems, and to conduct working relationships with honesty and integrity.

Follow Us On: