IBM Verify

 View Only

 How to move ISIM 10.0.0 to new servers?

Frank Tate's profile image
Frank Tate posted Sun April 27, 2025 01:14 PM

My client has an ISIM 10.0.0 (software stack) installation on RHEL 7.9, WAS 9.0.5.6, IBM Directory Server 6.4, and Oracle as the backend. They have a WebSphere cell consisting of two nodes with two clusters (ITIM_Application_Cluster and ITIM_Messaging_Cluster). Each node has two application servers running on it (timappX and timmsgX), and the deployment manager is running on one of the servers. This is a fairly large implementation, with over 10,000 services and almost 200,000 Person objects. Their corporate policies don't currently have an upgrade path from RHEL 7.9 to RHEL 9.5, so what they want to do is move the ITIM application to a new pair of servers running RHEL 9.5 (the current LDAP and Oracle will stay in place). Based on my testing so far, I think I have a better shot at getting them to change their policies than I have at actually pulling this off. 

So here's what I've tried so far in my lab, and the resources I've found online:

1. This link https://www.ibm.com/docs/en/sig-and-i/10.0.1?topic=migration-upgrade-identity-manager-version-100 describes moving an earler version installation to a new host at version 10.0.0. I tried these steps, and it failed, giving me a popup that read "No supported upgrade from version  to version 10.0.0. Click OK to exit installer.". (Yes, that message is verbatim, including the part where it doesn't show the 'from' version). 

2. The next thing I tried was to simply install ITIM 10.0.0 fresh, but point to the existing LDAP and Oracle. The first sign of possible failure came after the installer launched the Database Configuration tool. I entered the database information, and it asked me if I wanted to delete the existing tables. I clicked "No", and it then launched the Identity Manager System Configuration Tool (the one with the six tabs - General, Directory, Database, Logging, mail, UI, and Security). and the fields on the Database tab were all grayed out (could not be edited) and they had the default (incorrect for my install) information. After filling in the remainder of the tabs and clicking OK, I eventually got a popup stating "WasClusterConfigUtil.createMeDataSource failed." The install didn't complete, didn't create the necessary JDBC data source, etc. So it was a failure.

3. I found this article on moving a WAS Cell to a new server: https://www.ibm.com/docs/en/was-nd/9.0.5?topic=mpc-migrating-cells-new-host-machines-using-command-line-tool . However, one of the notes in that documentation is

"Avoid trouble: The Version 9.0 cell and node names must match the cell and node names in the previous configuration. If you create cells and nodes with new cell and node names, then the migration will fail." (Edited - included the wrong quote originally)

So that sounds like I would need to create new nodes and a new cell with the OLD node and cell names, which would reference the OLD hostnames, rather than the new hostnames. I don't like this plan very much, since this seems like it would be painful for the person behind me to support going forward.


Those are what I've tried. What I plan to try next is similar to #1 above, but using the 10.0.2 installer on the new servers, hoping that it will be able to upgrade from 10.0.0.


Does anyone have any specific guidance for MOVING ISIM 10.0.0 to a completely new WebSphere environment? 

Franz Wolfhagen's profile image
Franz Wolfhagen

For some reasons there is no documented way of moving your environment in case of new servers - but the procedure for migrating is the best option and will work IIRC with some (undocumented) tweaking. My best advice is to raise an IBM Support case and probably also involve IBM on this challenge as this will probably require some help from larger IBM team.

Under normal circumstances I would have recommended moving to IVIG V11 - but this is probably not an easy option due to the RDBMS being Oracle. The container version uses PostgreSQL (if the DB is container based) - but external Db2 is also an option - but that requires a move from Oracle which is always a challenge....

Frank Tate's profile image
Frank Tate

Thank you very much for the information, @Franz Wolfhagen . As always, it is much appreciated.

Frank Tate's profile image
Frank Tate

Tentatively I have some success! I followed the instructions in #1 in my original post, but then I installed 10.0.2, which DOES see that it can upgrade from 10.0.0. And so far it looks like a success. I need to do more testing, but this seems like it works so far.

So you CANNOT simply move version 10.0.0 to a new set of servers. However, if you move 10.0.0 to those servers, then upgrade to 10.0.2 on top of the install (before starting any application servers), that appears to work great.

Ali Malik Gürbüz's profile image
Ali Malik Gürbüz IBM Champion

Hello, 

I've never tried to achieve something like this but this is what comes to my mind. I would also install a fresh copy of WAS servers but instead of pointing out to old LDAP and Oracle DB, I would use empty fresh instances just for once, so the installation finishes as it should. Later, like in an event of LDAP IP or DB user password change, I would try to use runconfig.exe to switch to the already existing ldap and database. That should upgrade the data sources and ldap configurations, similar to the process mentioned here. https://www.ibm.com/docs/en/sim/7.0.2?topic=administration-passwords-system-users. Since the application installed in was is the same version (10.0) with your old Ldap/db's expected version runconfig's update should be able to point it to old infrastructure. If this doesnt work, and hosts names are buried elsewhere some dns name <-> ip changing is the next thing that I can think of.

Anyway,  I'm curious if your last approach worked without any issue. This is a big task, hope it works. 

Frank Tate's profile image
Frank Tate

I meant to update this but got busy.

My last approach DID work, with a tweak required. The steps I went through are:

  1. Install new WAS servers and configure clusters.
  2. Stop your old WAS servers.
  3. Clear the SIB. This is really important! You can actually clear it after you complete the install/upgrade, but you should do it at this point.
  4. Copy /opt/itim directory from old 10.0.0 dmgr server to new dmgr server, and the same for the second server.
  5. Run the 10.0.2 install on the new dmgr server. STOP when it brings up the Identity Manager System Configuration tool.
  6. Don't kill or exit the process, just don't move forward because you need to manually edit a file that was copied to the new server at some earlier point in the install. The file you need to edit is /opt/itim/config/was/deployEba.py. That script tries to delete the ITIM Service Center, and will error out and never install the service center if you don't do this step. Edit the script and delete the first "if" statement and the body of the if. The if statement is:

    if oldeba.find("noeba") < 0:
    ...

    Delete that line and the approximately 64 indented lines below it. They simply aren't needed. Copy/save the file.
  7. Once you've made the above change, continue verifying the values in the Identity Manager System Configuration tool and click Continue.
  8. The install will complete, and you'll have a brand new cluster with all of your old data.
  9. Start the ITIM application and the Service Center BLA.

In going through this, what I found is that the 10.0.2 installer WILL let you run in again over the top of an existing 10.0.2 install (as opposed to the 10.0.0 installer, which bombs out). So what this means is that if you wanted, you could first upgrade your system to 10.0.2, and then move it over if you wanted. However, you will still need to go through the steps above (including manually editing the deployEba.py script), but it would be an "upgrade, then move", which would allow you to do more apples-to-apples testing/validation after the fact.

Franz Wolfhagen's profile image
Franz Wolfhagen

Thanks for documenting the steps - I hope this will help others. 

I seems to remember I had related problems with the EBA installing IVIG 10 some years ago - there I solved it by installing it manually using the WAS console - probably not the best way as it would have been better to find the root cause so that others did not have to counter this problem - but alas time does not always allow deep diving into problems that you can fix....