Migrating TIBCO Enterprise Administrator Database from Earlier Version to Version 2.4.2

TIBCO Enterprise Administrator 2.4.2 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.

    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.2 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.1
    cp tea.zip ../2.4.2
    cp tea-realms.zip ../2.4.2

    Create a new folder in TEA config home location.

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

    cd <TIBCO_HOME>/tea/2.4.2
    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.2 server and start agents also in 2.4.2 TEA folder.

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