Skip to Content
Author's profile photo Alessandro Parolin

Understanding the Java Instance ID issue

First of all, let’s understand how a Java ID is generated.

Each SAP system Java contains the so-called box number, which is composed by 3 values: <SID> + <Instance Number> + <Hostname>. The Java ID is then generated from the box number. For sakes of demonstration, let S01 and S02 be two SAP systems as follows:

Information S01 S02
SID S01 S02
Instance Number JC01 JC02
Hostname System01 System02
Calculated Java ID ID184962 ID224865

The table above shows the information of each system and the ID they generated, which is stored at database level. Currently, each system should be working just fine.

If by any chance one decides to copy the database from S01 and restore it over S02 system (which by the way is not supported), what will happen is the following:

Information S01 S02
SID S01 S02
Instance Number JC01 JC02
Hostname System01 System02
Calculated Java ID ID184962 ID184962

The Java ID of S01 is now in the DB of system S02. Then, the box number of S02 no longer matches its Java ID, causing an inconsistency.

The same would happen if any of the parameters of the box numbers were changed in an unsupported way. Then, the ID would still be the same, but the box number and ID would no longer match.

Some tools, such as SWPM (during system copies) and SUM check if the Java ID is consistent with the box number. If it is not, the tools stop the procedure with an error. Currently, the only available solution to fix that is to perform a system copy of the system that is inconsistent. However, as already mentioned, SWPM checks the consistency of the IDs and it will fail. Therefore, to overcome this, one must:

  1. Start the system copy with SWPM;
  2. After the export of the Central Instance, edit file SOURCE.PROPERTIES located in the export directory;
  3. The source parameters must be adjusted to the ones that generated the current ID located in the Database. In this case, after the export, the following content will be present in SOURCE.PROPERTIES file:
    src.ci.sid=S02
    src.ci.instance.number=02
    src.ci.instance.name=JC02
    src.ci.host=System02
  4. However, as per the first table, the above information generates ID224865, which no longer exists in the DB. So, one must adapt it to:
    src.ci.sid=S01
    src.ci.instance.number=01
    src.ci.instance.name=JC01
    src.ci.host=System01
  5. After that, the installation of the target system can be started. During the target CI installation, Java Migration Toolkit will be executed to correctly adjust the IDs of the Java system. It will migrate the current one (ID184962), to the correct ID that matches the box number of the target system. This box number is composed by the values provided to SWPM during the target system installation.


The consistency check of the Java ID with the box number can be done by following the steps from SAP Note 1711300, see the entry from C5061069 Sep/20/2011. Even though this note is focused for DB2 for i, the consistency check procedure is independent of database.


In case of any issues, a Support Incident should be created under BC-INS-MIG component.



Assigned Tags

      6 Comments
      You must be Logged on to comment or reply to a post.
      Author's profile photo Henrique Girardi
      Henrique Girardi

      Very nice post! Thanks Alessandro!

      Author's profile photo Rafael Zanetti
      Rafael Zanetti

      Excellent post Alessandro. This is very helpful.

      Author's profile photo Eduardo Rezende
      Eduardo Rezende

      Nice blog!

      Author's profile photo Boris Zarske
      Boris Zarske

      Very helpful, thanks a lot!

      Author's profile photo Former Member
      Former Member

      Thanks for this Blog  🙂

      Author's profile photo Hans-Hendrik Weise
      Hans-Hendrik Weise

      For all who are interested and reading this, for a while now a new function has been introduced into the SWPM, part of the Software Logistics Toolset (SL Toolset). You will be able to correct the wrong instanceID's yourself with this service.

      Find more information in SAP Note https://launchpad.support.sap.com/#/notes/2259748