Migrating TIBCO Enterprise Administrator Database from Earlier Version to Version 2.4.3

TIBCO Enterprise Administrator 2.4.3 requires a database migration if you are upgrading from an earlier version. This is due to H2 database version upgrades in recent TEA releases: from 1.3.176 to 2.2.224 in TEA 2.4.1, and from 2.1.210 to 2.2.224 in TEA 2.4.2. The migration steps will vary depending on your current TEA server version.

Migrating TIBCO Enterprise Administrator Database from Version 2.4.0 to Version 2.4.3

    Procedure
  1. Stop TEA server and all agents which were registered on 2.4.0 TEA.
  2. Take backup of <TEA_CONFIG_HOME>/ directory.

  3. Export 2.4.0 h2 files with 1.3.176 h2 jar.

    4. cd <TIBCO_HOME>/tea/2.4
    java -cp lib/h2-1.3.176.jar org.h2.tools.Script -url jdbc:h2:<TEA_CONFIG_HOME>/data/TEA -script tea.zip -options compression zip
    java -cp lib/h2-1.3.176.jar org.h2.tools.Script -url jdbc:h2:<TEA_CONFIG_HOME>/data/TEA-REALM -script tea-realms.zip -options compression zip

    Run ls command and verify these two files are created correctly: tea-realms.zip and tea.zip.

  4. Install 2.4.3 on top of 2.4.0 in same TIBCO HOME of 2.4.0.

  5. Import with latest h2 jars.

    6. cd <TIBCO_HOME>/tea/2.4
    cp tea.zip ../2.4.3
    cp tea-realms.zip ../2.4.3

    Create a new folder in TEA config home location

    Update tea.tra file of 2.4.3 with this new home - tibco.env.TEA_CONFIG_HOME=<TEA_CONFIG_HOME>/migratedDB.

    cd <TIBCO_HOME>/tea/2.4.3
    java -cp lib/h2-2.2.224.jar org.h2.tools.RunScript -script tea.zip -url "jdbc:h2:<TEA_CONFIG_HOME>/data/TEA;NON_KEYWORDS=KEY,VALUE" -options compression zip variable_binary
    java -cp lib/h2-2.2.224.jar org.h2.tools.RunScript -script tea-realms.zip -url "jdbc:h2:<TEA_CONFIG_HOME>/data/TEA-REALM;NON_KEYWORDS=KEY,VALUE" -options compression zip variable_binary

    Start 2.4.3 server and start agents also in 2.4.3 TEA folder.

    Verify that all the data created with 2.4.0 is intact and agents are registered and running successfully.

Migrating TIBCO Enterprise Administrator Database from Version 2.4.1 to Version 2.4.3

    Procedure

  1. Stop 2.4.1 TEA server and all agents which were registered on 2.4.1 TEA.

  2. Export 2.4.1 h2 files with 2.1.210 h2 jar:

    cd <TIBCO_HOME>/tea/2.4.1
    java -cp lib/h2-2.1.210.jar org.h2.tools.Script -url jdbc:h2:<TEA_CONFIG_HOME>/data/TEA -script tea.zip -options compression zip
    java -cp lib/h2-2.1.210.jar org.h2.tools.Script -url jdbc:h2:<TEA_CONFIG_HOME>/data/TEA-REALM -script tea-realms.zip -options compression zip

    Run ls command and verify these two files are created correctly: tea-realms.zip and tea.zip.

  3. Install 2.4.3 on top of 2.4.1 in same TIBCO HOME of 2.4.1.

  4. Import with latest h2 jars:

    cd <TIBCO_HOME>/tea/2.4
    cp tea.zip ../2.4.3
    cp tea-realms.zip ../2.4.3

    Create a new folder in TEA config home location.

    Update tea.tra file of 2.4.1 with this new home - tibco.env.TEA_CONFIG_HOME=<TEA_CONFIG_HOME>/migratedDB

    cd <TIBCO_HOME>/tea/2.4.3
    java -cp lib/h2-2.2.224.jar org.h2.tools.RunScript -script tea.zip -url "jdbc:h2:<TEA_CONFIG_HOME>/data/TEA;NON_KEYWORDS=KEY,VALUE" -options compression zip variable_binary
    java -cp lib/h2-2.2.224.jar org.h2.tools.RunScript -script tea-realms.zip -url "jdbc:h2:<TEA_CONFIG_HOME>/data/TEA-REALM;NON_KEYWORDS=KEY,VALUE" -options compression zip variable_binary

    Start 2.4.3 server and start agents also in 2.4.3 TEA folder.

    Verify that all the data created with 2.4.1 is intact and agents are registered and running successfully.

Migrating TIBCO Enterprise Administrator Database from Version 2.4.2 to Version 2.4.3

If you are already on TIBCO Enterprise Administrator 2.4.2, you must have already performed migration steps when upgrading to 2.4.2 or you must have a fresh 2.4.2 installation. Therefore, no additional database migration is required.